REST API for Oracle Fusion Cloud HCM

Update Learning Content

Often there is a need to update different types of learning content items in Oracle Learning Cloud. Instead of manually updating the content items one by one using the learning administrator pages in Oracle Learning Cloud, you can update the content automatically using the learningContentItems REST API. This API supports update of the following learning content types:

SCORM/AICC packages
Video files
PDF files
Web links

Update SCORM/AICC Learning Content

Follow these steps to update a SCORM/AICC learning content item in Oracle Learning Cloud.

Perform a PATCH operation on the learningContentItems resource to update the value of any editable attribute in the SCORM/AICC content item.
/hcmRestApi/resources/11.13.18.05/learningContentItems/<ContentId>
Perform a GET operation to retrieve and verify the updated learning content details.

A typical example is an organization that has purchased several SCORM courses from a vendor. The vendor later releases new versions of the courses and the organization wants these changes to reflect in their existing courses. The organization can use the learningContentItems REST service to update the courses in Oracle Learning Cloud.

Example URL

The following is the format of the resource URL.

PATCH

/hcmRestApi/resources/11.13.18.05/learningContentItems/<ContentId>

Example Request

The following is an example of the request body in JSON format.

{
  "Title" : "REST: SS 201710081350 Jefferson Updated",
  "Description" : "REST: SS 201710081350 Jefferson Desc Updated",
  "StartDate" : "2017-06-26",
  "EndDate" : "2018-06-25"
}

Example Response

The following is an example of the response body in JSON format.

{
  "ContentId" : 300100101142985,
  "Title" : "REST: SS 201710081350 Jefferson Updated",
  "FileName" : null,
  "ItemNumber" : "REST-201710081350-SCORM",
  "TrackingType" : "ORA_UNKNOWN",
  "Description" : "REST: SS 201710081350 Jefferson DescUpdated ",
  "StartDate" : "2017-06-26",
  "EndDate" : "2018-06-25",
  "UUID" : "92cfc80e-953b-449c-90a6-18afa401628f",
  "Status" : "ORA_CONT_INACTIVE",
  "URL" : null,
  "AuthToken" : null,
  "Location" : "scorm/FA.HCM.PER.HcmEngmtVideoShare-92cfc80e-953b-449c-90a6-18afa401628f_private/92cfc80e-953b-449c-90a6-18afa401628f.zip",
  "IngestionStatus" : "ORA_MED_TRANSCODING",
  "Operation" :"",
    "links":[8]
         0:  {...
            ...}
}

Update Video Learning Content

Follow these steps to update a video learning content item in Oracle Learning Cloud.

Perform a PATCH operation on the learningContentItems resource to update the value of any editable attribute in the video content item.
/hcmRestApi/resources/11.13.18.05/learningContentItems/<ContentId>
Perform a GET operation to retrieve and verify the updated learning content details.

A typical example is an organization that has a number of product videos that are being used in all its training courses. Once a year, the vendor updates the product videos with the latest information and the organization wants these changes to reflect in their training courses. The organization can use the LearningContentItems REST service to update the videos in Oracle Learning Cloud.

Example URL

The following is the format of the resource URL.

PATCH

/hcmRestApi/resources/11.13.18.05/learningContentItems/<ContentId>

Example Request

The following is an example of the request body in JSON format.

{
  "Title" : "REST: SS 201710091906 video_4_secs",
  "Description" : "REST: SS 201710091906 video_4_secs Desc",
  "StartDate" : "2017-06-15",
  "EndDate" : "2018-06-14"
}

Example Response

The following is an example of the response body in JSON format.

{
  "ContentId" : 300100101257750,
  "Title" : "REST: SS 201710091906 video_4_secs",
  "FileName" : "video_4_secs.mov",
  "ItemNumber" : "REST-201710091906",
  "TrackingType" : "ORA_CONTENT_VIDEO",
  "Description" : "REST: SS 201710091906 video_4_secs Desc",
  "StartDate" : "2017-06-15",
  "EndDate" : "2018-06-14",
  "UUID" : "e778388a-15f8-4261-9338-d3b702aa8323",
  "Status" : "ORA_CONT_INACTIVE",
  "URL" : null,
  "AuthToken" : null,
  "Location" : "src/FA.HCM.PER.HcmEngmtVideoShare-e778388a-15f8-4261-9338-d3b702aa8323_private/e778388a-15f8-4261-9338-d3b702aa8323.mov",
  "IngestionStatus" : "ORA_MED_TRANSCODING",
  "Operation" : "",
		 "links":[8]
         	0:  {...
           	 ...}
}

Update PDF Learning Content

Follow these steps to update a PDF learning content item in Oracle Learning Cloud.

Perform a PATCH operation on the LearningContentItems resource to update the value of any editable attribute in the PDF content item.
/hcmRestApi/resources/11.13.18.05/learningContentItems/<ContentId>
Perform a GET operation to retrieve and verify the updated learning content details.

A typical example is an organization that has a number of product specification sheets as PDF files that are being used in all its training courses. Once a year, the vendor updates these specification sheets with the latest info, and the organization wants these changes to reflect in their training. The organization can use the LearningContentItems REST service to update the PDF files in Oracle Learning Cloud.

Example URL

The following is the format of the resource URL.

PATCH

/hcmRestApi/resources/11.13.18.05/learningContentItems/<ContentId>

Example Request

The following is an example of the request body in JSON format.

{
  "Title" : "REST: SS 201710091949 TLearn Updated",
  "Description" : "REST: SS 201710091949 TLearn Desc Updated",
  "StartDate" : "2017-06-26",
  "EndDate" : "2018-06-25"
}

Example Response

The following is an example of the response body in JSON format.

{
  "ContentId" : 300100101257756,
  "Title" : "REST: SS 201710091949 TLearn Updated",
  "FileName" : null,
  "ItemNumber" : "REST-201710091949-PDF",
  "TrackingType" : "ORA_PDF",
  "Description" : "REST: SS 201710091949 TLearn Desc Updated",
  "StartDate" : "2017-06-26",
  "EndDate" : "2018-06-25",
  "UUID" : "60c5e47d-bc50-44c0-b6ed-736508eb73e8",
  "Status" : "ORA_CONT_ACTIVE",
  "URL" : "scorm/FA.HCM.PER.HcmEngmtVideoShare-60c5e47d-bc50-44c0-b6ed-736508eb73e8_private/60c5e47d-bc50-44c0-b6ed-736508eb73e8.pdf",
  "AuthToken" : null,
  "Location" : "scorm/FA.HCM.PER.HcmEngmtVideoShare-60c5e47d-bc50-44c0-b6ed-736508eb73e8_private/60c5e47d-bc50-44c0-b6ed-736508eb73e8.pdf",
  "IngestionStatus" : null,
  "Operation" : "",
		 "links":[8]
         	0:  {...
           	 ...}
}

Update Weblink Learning Content

Follow these steps to update a web link learning content item in Oracle Learning Cloud.

Perform a PATCH operation on the LearningContentItems resource to update the value of any editable attribute in the web link content item.
/hcmRestApi/resources/11.13.18.05/learningContentItems/<ContentId>
Perform a GET operation to retrieve and verify the updated learning content details.

Example URL

The following is the format of the resource URL.

PATCH

/hcmRestApi/resources/11.13.18.05/learningContentItems/<ContentId>

Example Request

The following is an example of the request body in JSON format.

{
  "Title" : "REST: SS 201710092052 WebLink leadership-skills Updated",
  "Description" : "REST: SS 201710092052 WebLink leadership-skills Desc Updated",
  "StartDate" : "2017-06-26",
  "EndDate" : "2018-06-25"
}

Example Response

The following is an example of the response body in JSON format.

{
   "ContentId" : 300100101257996,
   "Title" : "REST: SS 201710092052 WebLink leadership-skills Updated",
   "FileName" : null,
   "ItemNumber" : "REST-201710092052-WebLink",
   "TrackingType" : "ORA_AUTO",
   "Description" : "REST: SS 201710092052 WebLink leadership-skills Desc Updated",
   "StartDate" : "2017-06-26",
   "EndDate" : "2018-06-25",
   "UUID" : "5fec638b-7a52-43af-a322-49f21cc5f81c",
   "Status" : "ORA_CONT_ACTIVE",
   "URL" : "https://www.coursera.org/learn/leadership-skill",
   "AuthToken" : null,
   "Location" : null,
   "IngestionStatus" : null,
   "Operation" : "",
 			"links":[8]
         	0:  {...
           	 ...}
}