1. Oracle Global Human Resources Cloud REST APIREST API for Oracle Fusion Cloud HCM
  2. Use Cases
  3. Learning Cloud
  4. Upload Learning Content

Upload Learning Content

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

  • SCORM/AICC packages
  • Video files
  • PDF files
  • Web links

Upload SCORM/AICC Learning Content

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

  1. Perform a POST operation on the learningContentItems resource to create metadata for the SCORM/AICC learning content item.

    /hcmRestApi/resources/11.13.18.05/learningContentItems

  2. Perform a POST operation to upload the SCORM/AICC package file to Oracle Learning Cloud.
  3. Perform a PATCH operation to initiate SCORM/AICC ingestion (IngestionStatus=ORA_MED_TRANSCODING) into Oracle Learning Cloud.
  4. Perform a GET operation to retrieve and verify the learning content details.

A typical example is an organization that has purchased 100 e-learning courses from a vendor and wants to deliver these courses in the SCORM format. The organization can use the learningContentItems REST service to upload the courses to Oracle Learning Cloud before offering them to learners.

Example URL

The following is the format of the resource URL.

POST

/hcmRestApi/resources/11.13.18.05/learningContentItems

Example Request

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

{
  "Title" : "REST: SS 201710081350 Jefferson",
  "FileName" : "JefferSonSCORM12.zip",
  "Description" : "REST: SS 201710081350 Jefferson Desc",
  "ItemNumber" : "REST-201710081350-SCORM",
  "TrackingType" : "ORA_SCORM_12",
  "StartDate" : "2017-06-15",
  "EndDate" : "2018-06-14"
}

Example Response

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

{
  "ContentId" : 300100101142985,
  "Title" : "REST: SS 201710081350 Jefferson",
  "FileName" : "JefferSonSCORM12.zip", 
  "ItemNumber" : "REST-201710081350-SCORM",
  "TrackingType" : "ORA_SCORM_12",
  "Description" : "REST: SS 201710081350 Jefferson Desc",
  "StartDate" : "2017-06-15",
  "EndDate" : "2018-06-14",
  "UUID" : "92cfc80e-953b-449c-90a6-18afa401628f",
  "Status" : "ORA_CONT_INACTIVE",
  "URL" : null,
  "AuthToken" : "X-Akamai-ACS-Action:action=upload&version=1&index-zip=1||X-Akamai-ACS-Auth-Data:5, 0.0.0.0, 0.0.0.0, 1507582333, 457024713, Oraclemedia||X-Akamai-ACS-Auth-Sign:7cQB5HotJLxYBh6X4o0mO3Dma47UGZ1TPG9xLMWUiz0=",
 "Location" : "scorm/FA.HCM.PER.HcmEngmtVideoShare-92cfc80e-953b-449c-90a6-18afa401628f_private/92cfc80e-953b-449c-90a6-18afa401628f.zip",
  "IngestionStatus" : "ORA_MED_NEW",
  "Operation" : null,
		"links":[8]
         0:  {...
            ...}
}

Upload Video Learning Content

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

  1. Perform a POST operation on the learningContentItems resource to create metadata for the video learning content item.

    /hcmRestApi/resources/11.13.18.05/learningContentItems

  2. Perform a POST operation to upload the video file to Oracle Learning Cloud.
  3. Perform a PATCH operation to initiate SCORM/AICC ingestion (IngestionStatus=ORA_MED_TRANSCODING) into Oracle Learning Cloud.
  4. Perform a GET operation to retrieve and verify the learning content details.

A typical example is an organization that has purchased 100 videos from a vendor. The organization can use the learningContentItems REST service to upload these videos to Oracle Learning Cloud before they are offered to learners.

Example URL

The following is the format of the resource URL.

POST

/hcmRestApi/resources/11.13.18.05/learningContentItems

Example Request

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

{
  "Title" : "REST: SS 201710091906 video_4_secs",
  "FileName" : "video_4_secs.mov",
  "Description" : "REST: SS 201710091906 video_4_secs Desc",
  "ItemNumber" : "REST-201710091906",
  "TrackingType" : "ORA_CONTENT_VIDEO",
  "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" : "X-Akamai-ACS-Action:action=upload&version=1||X-Akamai-ACS-Auth-Data:5, 0.0.0.0	, 	0.0.0.0, 1507601292, 604982616, Oraclemedia||X-Akamai-ACS-Auth-Sign:ktzX85LZYJvFYJbJ6pnSOoY8xBr9EynBw0B8hFg1+aE=",
	"Location" : "src/FA.HCM.PER.HcmEngmtVideoShare-e778388a-15f8-4261-9338-d3b702aa8323_private	/	e778388a-15f8-4261-9338-d3b702aa8323.mov",
  "IngestionStatus" : "ORA_MED_NEW",
  "Operation" : null,
			"links":[8]
         	0:  {...
           	 ...}
}

Upload PDF Learning Content

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

  1. Perform a POST operation on the learningContentItems resource to create metadata for the PDF learning content item.

    /hcmRestApi/resources/11.13.18.05/learningContentItems

  2. Perform a POST operation to upload the PDF file to Oracle Learning Cloud.
  3. Perform a GET operation to retrieve and verify the learning content details.

A typical example is an organization that has 100 product descriptions as PDF files and wants to use these files in their training. The organization can use the learningContentItems REST service to upload the PDF files to Oracle Learning Cloud.

Example URL

The following is the format of the resource URL.

POST

/hcmRestApi/resources/11.13.18.05/learningContentItems

Example Request

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

{
  "Title" : "REST: SS 201710091949 TLearn",
  "FileName" : "TLearn.pdf",
  "Description" : "REST: SS 201710091949 TLearn Desc",
  "ItemNumber" : "REST-201710091949-PDF",
  "TrackingType" : "ORA_PDF",
  "Status" : "ORA_CONT_ACTIVE",
  "StartDate" : "2017-06-15",
  "EndDate" : "2018-06-14"

Example Response

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

{
  "ContentId" : 300100101257756,
  "Title" : "REST: SS 201710091949 TLearn",
  "FileName" : "TLearn.pdf",
  "ItemNumber" : "REST-201710091949-PDF",
  "TrackingType" : "ORA_PDF",
  "Description" : "REST: SS 201710091949 video_4_secs Desc",
  "StartDate" : "2017-06-15",
  "EndDate" : "2018-06-14",
  "UUID" : "60c5e47d-bc50-44c0-b6ed-736508eb73e8",
  "Status" : "ORA_CONT_ACTIVE",
  "URL" : null,
  "AuthToken" : "X-Akamai-ACS-Action:action=upload&version=1||X-Akamai-ACS-Auth-Data:5, 0.0.0.0, 0.0.0.0, 1507604022, 2097491649, Oraclemedia||X-Akamai-ACS-Auth-Sign:6szYsIlcztab31lygNDWghM4pj/IVqBEG7JqTxaYQmg=",
  "Location" : "scorm/FA.HCM.PER.HcmEngmtVideoShare-60c5e47d-bc50-44c0-b6ed-736508eb73e8_private/60c5e47d-bc50-44c0-b6ed-736508eb73e8.pdf",
  "IngestionStatus" : null,
  "Operation" : null,
		 "links":[8]
         	0:  {...
           	 ...}
}

Upload Web Link Learning Content

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

  1. Perform a POST operation on the learningContentItems resources to create metadata for the web link learning content item.

    /hcmRestApi/resources/11.13.18.05/learningContentItems

  2. Perform a GET operation to verify the learning content details by performing a GET operation.

A typical example is an organization that has 100 product descriptions online and wants to use these product descriptions in their training. The organization can use the learningContentItems REST service to upload the web links for the product descriptions to Oracle Learning Cloud.

Example URL

The following is the format of the resource URL.

POST

/hcmRestApi/resources/11.13.18.05/learningContentItems

Example Request

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

{
  "Title" : "REST: SS 201710092052 WebLink leadership-skills",
  "Description" : "REST: SS 201710092052 WebLink leadership-skills Desc",
  "ItemNumber" : "REST-201710092052-WebLink",
  "TrackingType" : "ORA_AUTO",
  "URL" : "https://www.coursera.org/learn/leadership-skills",
  "Status" : "ORA_CONT_ACTIVE",
  "StartDate" : "2017-06-15",
  "EndDate" : "2018-06-14"
}

Example Response

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

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