Create an asset
post
/hcmRestApi/resources/11.13.18.05/digitalLearning/{digitalLearningUniqID}/child/content/{contentUniqID}/child/assets
Request
Path Parameters
-
contentUniqID(required): string
This is the hash key of the attributes which make up the composite key for the (content) resource and used to uniquely identify an instance of (content). The client should not generate the hash key value. Instead, the client should query on the (content) collection resource in order to navigate to a specific instance of (content) to get the hash key.
-
digitalLearningUniqID(required): string
This is the hash key of the attributes which make up the composite key for the (digitalLearning) resource and used to uniquely identify an instance of (digitalLearning). The client should not generate the hash key value. Instead, the client should query on the (digitalLearning) collection resource in order to navigate to a specific instance of (digitalLearning) to get the hash key.
Header Parameters
-
Effective-Of:
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:
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.
-
Upsert-Mode:
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
-
assetBinaries: array
Content Binaries
Title:
Content Binaries
Add, edit, view and delete attachments of the parent resource. Details include attached document identifier, file name, file URL, file title, and description. -
assetId: integer
(int64)
The unique identifier for the learning item asset, such as cover art or a trailer.
-
assetNumber: string
Maximum Length:
30
User-friendly number identifying the learning item asset, such as cover art or a trailer. -
learningItemId: integer
(int64)
Title:
Learning Item ID
The learning item identifier of the asset. -
primary: string
Indicates whether the asset is currently being used as the cover art or the trailer. Valid values are Y and N. The default value is Y.
-
relationshipType: string
Maximum Length:
30
Describes the relationship between the learning item asset and the learning item. Valid options are ORA_GENERATED and ORA_ADHOC. -
sourceURL: string
Maximum Length:
2000
Web link to the image source location. -
status: string
Maximum Length:
30
Status of the learning item asset. -
type(required): string
Maximum Length:
30
Indicates the type of learning asset, such as cover art or a trailer.
Nested Schema : Content Binaries
Type:
array
Title:
Content Binaries
Add, edit, view and delete attachments of the parent resource. Details include attached document identifier, file name, file URL, file title, and description.
Show Source
Nested Schema : digitalLearning-content-assets-assetBinaries-item-post-request
Type:
Show Source
object
-
AsyncTrackerId: string
Attribute provided by the Attachment UI components to support the upload of files.
-
AttachedDocumentId: integer
(int64)
Unique identifier of the attached document.
-
CategoryName: string
Title:
Category
Maximum Length:30
Category name of the attachment. This is a read-only attribute. - ContentRepositoryFileShared: boolean
-
DatatypeCode: string
Title:
Type
Maximum Length:30
Default Value:FILE
Attachment Type such as FILE or TEXT, or WEB_PAGE. -
Description: string
Title:
Description
Maximum Length:255
Description of the attachment. -
DmDocumentId: string
Maximum Length:
255
Surrogate identifier of the document attached. -
DmFolderPath: string
Maximum Length:
1000
The folder path from which the attachment is created. -
DmVersionNumber: string
Maximum Length:
255
Version number of the attachment. -
ErrorStatusCode: string
The error status code, if any, for the attachment.
-
ErrorStatusMessage: string
The error message, if any, for the attachment.
-
ExpirationDate: string
(date-time)
Expiration date of the attachment. This is a read-only attribute.
-
FileContents: string
(byte)
Title:
File Contents
Actual content of the attachment. -
FileName: string
Title:
File Name
Maximum Length:2048
Name of the attachment file. -
FileUrl: string
File URL of the attachment.
-
PostProcessingAction: string
Title:
PostProcessingAction
-
Title: string
Title:
Title
Title of the attachment. -
UploadedFileContentType: string
Content type of the uploaded file. This is a read-only attribute.
-
UploadedFileLength: integer
Title:
File Size
Size of the uploaded file. This is a read-only attribute. -
UploadedFileName: string
Name of the uploaded file. This is a read-only attribute.
-
UploadedText: string
Text uploaded in the attachment.
-
Uri: string
Maximum Length:
4000
URI of the attachment. This is a read-only attribute. -
Url: string
Maximum Length:
4000
URL of a web page type attachment.
Response
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 : digitalLearning-content-assets-item-response
Type:
Show Source
object
-
addedOnDate: string
(date-time)
Read Only:
true
Date when the learning item was added to the learning catalog. -
assetBinaries: array
Content Binaries
Title:
Content Binaries
Add, edit, view and delete attachments of the parent resource. Details include attached document identifier, file name, file URL, file title, and description. -
assetId: integer
(int64)
The unique identifier for the learning item asset, such as cover art or a trailer.
-
assetNumber: string
Maximum Length:
30
User-friendly number identifying the learning item asset, such as cover art or a trailer. -
highRenditionLink: string
Read Only:
true
Maximum Length:255
A link to the high rendition version of the learning cover art image. -
learningItemId: integer
(int64)
Title:
Learning Item ID
The learning item identifier of the asset. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
lowRenditionLink: string
Read Only:
true
Maximum Length:255
A link to the low rendition version of learning the cover art image. -
medRenditionLink: string
Read Only:
true
Maximum Length:255
A link to the medium rendition version of the learning cover art image. -
primary: string
Indicates whether the asset is currently being used as the cover art or the trailer. Valid values are Y and N. The default value is Y.
-
relationshipType: string
Maximum Length:
30
Describes the relationship between the learning item asset and the learning item. Valid options are ORA_GENERATED and ORA_ADHOC. -
sourceURL: string
Maximum Length:
2000
Web link to the image source location. -
status: string
Maximum Length:
30
Status of the learning item asset. -
type: string
Maximum Length:
30
Indicates the type of learning asset, such as cover art or a trailer.
Nested Schema : Content Binaries
Type:
array
Title:
Content Binaries
Add, edit, view and delete attachments of the parent resource. Details include attached document identifier, file name, file URL, file title, and description.
Show Source
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : digitalLearning-content-assets-assetBinaries-item-response
Type:
Show Source
object
-
AsyncTrackerId: string
Attribute provided by the Attachment UI components to support the upload of files.
-
AttachedDocumentId: integer
(int64)
Unique identifier of the attached document.
-
CategoryName: string
Title:
Category
Maximum Length:30
Category name of the attachment. This is a read-only attribute. - ContentRepositoryFileShared: boolean
-
CreatedBy: string
Read Only:
true
Maximum Length:255
User who created the attachment. -
CreatedByUserName: string
Read Only:
true
User name of the user who created the attachment. -
CreationDate: string
(date-time)
Read Only:
true
Date when the attachment was created. -
DatatypeCode: string
Title:
Type
Maximum Length:30
Default Value:FILE
Attachment Type such as FILE or TEXT, or WEB_PAGE. -
Description: string
Title:
Description
Maximum Length:255
Description of the attachment. -
DmDocumentId: string
Maximum Length:
255
Surrogate identifier of the document attached. -
DmFolderPath: string
Maximum Length:
1000
The folder path from which the attachment is created. -
DmVersionNumber: string
Maximum Length:
255
Version number of the attachment. -
DownloadInfo: string
Read Only:
true
JSON object represented as a string that contains information used to programmatically retrieve a file attachment. -
ErrorStatusCode: string
The error status code, if any, for the attachment.
-
ErrorStatusMessage: string
The error message, if any, for the attachment.
-
ExpirationDate: string
(date-time)
Expiration date of the attachment. This is a read-only attribute.
-
FileContents: string
(byte)
Title:
File Contents
Actual content of the attachment. -
FileName: string
Title:
File Name
Maximum Length:2048
Name of the attachment file. -
FileUrl: string
File URL of the attachment.
-
FileWebImage: string
(byte)
Title:
File Web Image
Read Only:true
Base64 encoded image file displayed in .png format when the source is a convertible image. -
LastUpdateDate: string
(date-time)
Title:
Last Update Date
Read Only:true
Date when attachment record was last updated. -
LastUpdatedBy: string
Title:
Last Updated By
Read Only:true
Maximum Length:255
Name of the user who last updated the attachment record. -
LastUpdatedByUserName: string
Read Only:
true
User name of the user who last updated the attachment. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
PostProcessingAction: string
Title:
PostProcessingAction
-
Title: string
Title:
Title
Title of the attachment. -
UploadedFileContentType: string
Content type of the uploaded file. This is a read-only attribute.
-
UploadedFileLength: integer
Title:
File Size
Size of the uploaded file. This is a read-only attribute. -
UploadedFileName: string
Name of the uploaded file. This is a read-only attribute.
-
UploadedText: string
Text uploaded in the attachment.
-
Uri: string
Maximum Length:
4000
URI of the attachment. This is a read-only attribute. -
Url: string
Maximum Length:
4000
URL of a web page type attachment. -
UserName: string
Read Only:
true
Maximum Length:255
User name of the person who uploaded the attachment.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object
-
href: string
Title:
hyperlink reference
The URI to the related resource. -
kind: string
Title:
kind
Allowed Values:[ "collection", "item", "describe", "other" ]
The kind of the related resource. -
name: string
Title:
name
The name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relation
Allowed 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.
Links
- ContentTrackingTypeLOVVO
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_WLF_CONTENT_TRACKING_TYPE
The following properties are defined on the LOV link relation:- Source Attribute: type; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- IsPrimaryLOVVA
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DYES_NO
The following properties are defined on the LOV link relation:- Source Attribute: primary; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- RelationshipTypeLOVVA
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_WLF_LC_RELATION_TYPE
The following properties are defined on the LOV link relation:- Source Attribute: relationshipType; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- assetBinaries
-
Parameters:
- assetsUniqID2:
$request.path.assetsUniqID2
- contentUniqID:
$request.path.contentUniqID
- digitalLearningUniqID:
$request.path.digitalLearningUniqID
Add, edit, view and delete attachments of the parent resource. Details include attached document identifier, file name, file URL, file title, and description. - assetsUniqID2: