Create an activity
post
/hcmRestApi/resources/11.13.18.05/learningEvents/{learningEventsUniqID}/child/activities
Request
Path Parameters
-
learningEventsUniqID(required): string
This is the hash key of the attributes which make up the composite key for the Learning Events resource and used to uniquely identify an instance of Learning Events. The client should not generate the hash key value. Instead, the client should query on the Learning Events collection resource in order to navigate to a specific instance of Learning Events to get the hash key.
Header Parameters
-
Effective-Of: string
This header accepts a string value. The string is a semi-colon separated list of
= . It is used to perform effective date range operations. The accepted parameters are RangeMode, RangeSpan, RangeStartDate, RangeEndDate, RangeStartSequence and RangeEndSequence. The parameter values are always strings. The possible values for RangeMode are SET_LOGICAL_START, SET_LOGICAL_END, END_DATE, SET_EFFECTIVE_START, SET_EFFECTIVE_END, REPLACE_CORRECTION, REPLACE_UPDATE, RECONCILE_CORRECTION, CORRECTION, RECONCILE_UPDATE, UPDATE, ZAP and DELETE_CHANGES. The possible values for RangeSpan are PHYSICAL_ROW_END_DATE and LOGICAL_ROW_END_DATE. The values for RangeStartDate and RangeEndDate have to be a string representation of a date in yyyy-MM-dd format. The value for RangeStartSequence and RangeEndSequence must be strings such that when parsed they yield positive integers. -
Metadata-Context: string
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version: string
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
-
Upsert-Mode: string
Contains one of the following values: true or false. If true, the server performs an Upsert operation instead of a Create operation. During an Upsert operation, the server attempts to find an existing resource that matches the payload. If a match is found, the server updates the existing resource instead of creating a new one. If not found or false (default), the server performs a Create operation. Note that the Upsert operation isn't supported for date-effective REST resources.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object-
activityId: integer
(int64)
Title:
Activity IDUnique identifier for the activity. -
activityNumber(required): string
Title:
Activity NumberMaximum Length:2000Friendly number identifying the activity. -
activityType: string
Title:
Activity TypeMaximum Length:30Default Value:ORA_ILT_ACTIVITYActivity type, such as Internal or External. -
adhocResources: array
Ad Hoc Resources
Title:
Ad Hoc ResourcesThe adhocResources resources captures the details of additional resources required for an instructor-led training, such as printers or whiteboards. -
classroomDetails: array
Classrooms
Title:
ClassroomsThe classrooms resource is a child of the completionDetails resource. It provides the classroom details for the instructor-led activities associated with instructor-led and blended offerings. -
classroomDisplayName: string
Title:
Classroom TitleMaximum Length:2000Display name of the activity classrooms. -
classrooms: string
Title:
ClassroomsList of activity classrooms. -
completionRule: string
Title:
Completion RuleMaximum Length:30Completion rule that determines how the content handles completions. It also determines if manager or learner confirmation is required. -
completionType: string
Maximum Length:
30Completion type for the activity, such as Mandatory or Optional. -
description: string
Title:
Activity DescriptionDescription for the activity. -
endDate: string
Title:
Activity End DateEnd date for the activity. -
expectedEffortInSeconds: number
Title:
Expected EffortsExpected effort needed by the learner to complete the learning item. -
externalDetailsURL: string
Title:
External Details URLMaximum Length:2000Details URL for the activity. -
instructorDetails: array
Instructors
Title:
InstructorsThe instructors resource is a child of the completionDetails resource. It provides the instructors associated with instructor-led and blended offerings. -
instructors: string
Title:
InstructorsList of activity instructors. - relatedMaterials: array Related Materials
-
startDate: string
Title:
Activity Start DateStart date for the activity. -
status(required): string
Title:
StatusMaximum Length:30Status for the activity -
timezone: string
Title:
Time ZoneMaximum Length:30Time zone for the activity -
title: string
Title:
TitleMaximum Length:250Title of the activity. -
virtualClassroomURL: string
Title:
Virtual Classroom URLMaximum Length:500Link to join the virtual classroom, if used in the ILT activity. Doesn't apply to any other types of activities.
Nested Schema : Ad Hoc Resources
Type:
arrayTitle:
Ad Hoc ResourcesThe adhocResources resources captures the details of additional resources required for an instructor-led training, such as printers or whiteboards.
Show Source
Nested Schema : Classrooms
Type:
arrayTitle:
ClassroomsThe classrooms resource is a child of the completionDetails resource. It provides the classroom details for the instructor-led activities associated with instructor-led and blended offerings.
Show Source
Nested Schema : Instructors
Type:
arrayTitle:
InstructorsThe instructors resource is a child of the completionDetails resource. It provides the instructors associated with instructor-led and blended offerings.
Show Source
Nested Schema : schema
Type:
Show Source
object-
resourceDescription: string
Maximum Length:
4000Description for the resource. -
resourceId: integer
(int64)
Unique identifier for the resource.
-
resourceName: string
Maximum Length:
100Display name of the resource. -
resourceNumber: string
Maximum Length:
30Friendly number for identifying a resource. -
resourceQuantity: number
Quantity for the resource.
Nested Schema : learningEvents-activities-classroomDetails-item-post-request
Type:
Show Source
objectNested Schema : learningEvents-activities-instructorDetails-item-post-request
Type:
Show Source
objectResponse
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : learningEvents-activities-item-response
Type:
Show Source
object-
activityId: integer
(int64)
Title:
Activity IDUnique identifier for the activity. -
activityNumber: string
Title:
Activity NumberMaximum Length:2000Friendly number identifying the activity. -
activityType: string
Title:
Activity TypeMaximum Length:30Default Value:ORA_ILT_ACTIVITYActivity type, such as Internal or External. -
adhocResources: array
Ad Hoc Resources
Title:
Ad Hoc ResourcesThe adhocResources resources captures the details of additional resources required for an instructor-led training, such as printers or whiteboards. -
attendanceConfirmationURL: string
Read Only:
trueMaximum Length:255Link to the page where the learner can confirm attendance for an activity. -
attendanceQRDownloadURL: string
Read Only:
trueMaximum Length:255Link to the page where the learner can download the QR code to confirm attendance for an activity. -
classroomDetails: array
Classrooms
Title:
ClassroomsThe classrooms resource is a child of the completionDetails resource. It provides the classroom details for the instructor-led activities associated with instructor-led and blended offerings. -
classroomDisplayName: string
Title:
Classroom TitleMaximum Length:2000Display name of the activity classrooms. -
classrooms: string
Title:
ClassroomsList of activity classrooms. -
completionRule: string
Title:
Completion RuleMaximum Length:30Completion rule that determines how the content handles completions. It also determines if manager or learner confirmation is required. -
completionType: string
Maximum Length:
30Completion type for the activity, such as Mandatory or Optional. -
description: string
Title:
Activity DescriptionDescription for the activity. -
endDate: string
Title:
Activity End DateEnd date for the activity. -
expectedEffortInSeconds: number
Title:
Expected EffortsExpected effort needed by the learner to complete the learning item. -
externalDetailsURL: string
Title:
External Details URLMaximum Length:2000Details URL for the activity. -
instructorDetails: array
Instructors
Title:
InstructorsThe instructors resource is a child of the completionDetails resource. It provides the instructors associated with instructor-led and blended offerings. -
instructors: string
Title:
InstructorsList of activity instructors. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. - relatedMaterials: array Related Materials
-
startDate: string
Title:
Activity Start DateStart date for the activity. -
status: string
Title:
StatusMaximum Length:30Status for the activity -
timezone: string
Title:
Time ZoneMaximum Length:30Time zone for the activity -
title: string
Title:
TitleMaximum Length:250Title of the activity. -
virtualClassroomURL: string
Title:
Virtual Classroom URLMaximum Length:500Link to join the virtual classroom, if used in the ILT activity. Doesn't apply to any other types of activities.
Nested Schema : Ad Hoc Resources
Type:
arrayTitle:
Ad Hoc ResourcesThe adhocResources resources captures the details of additional resources required for an instructor-led training, such as printers or whiteboards.
Show Source
Nested Schema : Classrooms
Type:
arrayTitle:
ClassroomsThe classrooms resource is a child of the completionDetails resource. It provides the classroom details for the instructor-led activities associated with instructor-led and blended offerings.
Show Source
Nested Schema : Instructors
Type:
arrayTitle:
InstructorsThe instructors resource is a child of the completionDetails resource. It provides the instructors associated with instructor-led and blended offerings.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : learningEvents-activities-adhocResources-item-response
Type:
Show Source
object-
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
resourceDescription: string
Maximum Length:
4000Description for the resource. -
resourceId: integer
(int64)
Unique identifier for the resource.
-
resourceName: string
Maximum Length:
100Display name of the resource. -
resourceNumber: string
Maximum Length:
30Friendly number for identifying a resource. -
resourceQuantity: number
Quantity for the resource.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object-
href: string
Title:
hyperlink referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Nested Schema : learningEvents-activities-classroomDetails-item-response
Type:
Show Source
object-
classroomDescription: string
Title:
Classroom DescriptionRead Only:trueMaximum Length:4000Description of the classroom. -
classroomId: integer
(int64)
Title:
Classroom IDRead Only:trueApplication-generated primary key for a classroom. -
classroomNumber: string
Title:
Classroom NumberRead Only:trueMaximum Length:30Friendly number for identifying a classroom. -
classroomTitle: string
Title:
Classroom TitleRead Only:trueMaximum Length:250Name of the classroom. -
contactPersonDisplayName: string
Title:
Contact Person Display NameRead Only:trueMaximum Length:240Display name for the person who's the classroom contact. -
contactPersonId: integer
(int64)
Title:
Contact Person IDRead Only:trueIdentifier for the person who's the classroom contact. -
contactPersonImageURL: string
Title:
Contact Person Image URLRead Only:trueMaximum Length:32Image URL for the person who's the classroom contact. -
contactPersonNumber: string
Title:
Contact Person NumberRead Only:trueMaximum Length:30Person number for the classroom contact person. -
contactPersonPrimaryEmailAddress: string
Title:
Contact Person Primary Email AddressRead Only:trueMaximum Length:60Primary email address of the person who's the classroom contact. -
contactPersonPrimaryPhoneNumber: string
Title:
Contact Person Primary Phone NumberRead Only:trueMaximum Length:240Primary phone number for the person who's the classroom contact. -
isPrimaryClassroom: string
Title:
Primary ClassroomRead Only:trueMaximum Length:1Indicates whether the classroom is a primary classroom. The default value is N. Valid values are Y and N. -
isPrimaryClassroomMeaning: string
Title:
Primary Classroom DescriptionRead Only:trueMaximum Length:4000Description of the value of the isPrimaryClassroom attribute. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
locationAddressLine1: string
Title:
Location Address Line 1Read Only:trueMaximum Length:240Location address line 1. -
locationAddressLine2: string
Title:
Location Address Line 2Read Only:trueMaximum Length:240Location address line 2. -
locationAddressLine3: string
Title:
Location Address Line 3Read Only:trueMaximum Length:240Location address line 3. -
locationCity: string
Title:
Location CityRead Only:trueMaximum Length:60City of the classroom. -
locationCountry: string
Title:
Location CountryRead Only:trueMaximum Length:60Country of the classroom. -
locationDisplayString: string
Title:
Location Display StringRead Only:trueMaximum Length:32Complete classroom address in the string format. -
locationLatitude: number
Title:
Location LatitudeRead Only:trueLatitude of the classroom. -
locationLongitude: number
Title:
Location LongitudeRead Only:trueLongitude of the classroom. -
locationName: string
Title:
Location NameRead Only:trueMaximum Length:240Location of the classroom. -
locationSingleLineString: string
Read Only:
trueMaximum Length:1732Location of the classroom expressed as a single line string. -
locationZipCode: string
Title:
Location ZIP CodeRead Only:trueMaximum Length:30Postal code of the location address.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : learningEvents-activities-instructorDetails-item-response
Type:
Show Source
object-
instructorId: integer
(int64)
Title:
Instructor IDRead Only:trueUnique identifier for the instructor. -
instructorNumber: string
Title:
Instructor NumberRead Only:trueMaximum Length:19Friendly number for identifying the instructor. -
isPrimaryInstructor: string
Title:
Primary InstructorRead Only:trueMaximum Length:1Indicates whether the person is the primary instructor. The default value is N. Valid values are Y and N. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
personDisplayName: string
Title:
InstructorRead Only:trueMaximum Length:240Display name for the instructor. -
personId: integer
(int64)
Title:
Instructor Person IDRead Only:trueIdentifier for the person who's the instructor. -
personImageURL: string
Title:
Instructor Image URLRead Only:trueMaximum Length:32Image URL for the instructor for the learning item. -
personNumber: string
Title:
Instructor Person NumberRead Only:trueMaximum Length:30Person number for the instructor. -
personPrimaryEmailAddress: string
Title:
Instructor Primary Email AddressRead Only:trueMaximum Length:60Primary Email address of the instructor for the learning item. -
personPrimaryPhoneNumber: string
Title:
Instructor Primary Phone NumberRead Only:trueMaximum Length:240Phone number of the instructor of the learning item. -
status: string
Read Only:
trueMaximum Length:30Status for the instructor.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- ActivityCompletionRuleLOVVA
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_WLF_EVENT_ACT_COMPL_RULE
The following properties are defined on the LOV link relation:- Source Attribute: completionRule; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- ActivityTypeLOVVA
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_WLF_EVENT_ACTIVITY_TYPE
The following properties are defined on the LOV link relation:- Source Attribute: activityType; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- CompletionTypeLOVVA
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_WLF_ACTIVITY_COMPLETION
The following properties are defined on the LOV link relation:- Source Attribute: completionType; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- adhocResources
-
Parameters:
- activitiesUniqID:
$request.path.activitiesUniqID - learningEventsUniqID:
$request.path.learningEventsUniqID
The adhocResources resources captures the details of additional resources required for an instructor-led training, such as printers or whiteboards. - activitiesUniqID:
- classroomDetails
-
Parameters:
- activitiesUniqID:
$request.path.activitiesUniqID - learningEventsUniqID:
$request.path.learningEventsUniqID
The classrooms resource is a child of the completionDetails resource. It provides the classroom details for the instructor-led activities associated with instructor-led and blended offerings. - activitiesUniqID:
- instructorDetails
-
Parameters:
- activitiesUniqID:
$request.path.activitiesUniqID - learningEventsUniqID:
$request.path.learningEventsUniqID
The instructors resource is a child of the completionDetails resource. It provides the instructors associated with instructor-led and blended offerings. - activitiesUniqID:
- relatedMaterials
-
Parameters:
- activitiesUniqID:
$request.path.activitiesUniqID - learningEventsUniqID:
$request.path.learningEventsUniqID
The relatedMaterials resource is used to add attachments to the learning parent resource, as well as to edit, view, and delete the attachments. Details include attached document ID, file name, file URL, file title, and description. - activitiesUniqID: