Create a task assignment
post
/fscmRestApi/resources/11.13.18.05/hedTaskAssignments
Request
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-
AssigneePartyId: integer
(int64)
Title:
Task Assignee Party IdentifierParty assigned to the task. -
AssociatedPartyId: integer
(int64)
Title:
Task Assignment Associated Party IdentifierParty identifier associated with the task. -
AttachmentDescription: string
Title:
Attachment DescriptionDescription of attachment. -
AttachmentFileContents: string
(byte)
Title:
Attachment File ContentsAttachment file. -
AttachmentFileName: string
Title:
Attachment File NameName of attachment file. -
AttachmentId: integer
(int64)
Title:
Attachment IdentifierUnique identifier for attachment. -
AttachmentMetadata: string
Title:
Attachment MetadataMaximum Length:4000Attachment metadata. -
AttachmentTitle: string
Title:
Attachment TitleTitle of attachment. -
DueDate: string
(date-time)
Title:
Task Assignment Due DateDue date. -
InstitutionId: integer
(int64)
Title:
Task Institution IdentifierUnique identifier for institution. -
InstitutionName: string
Title:
Task Institution NameMaximum Length:50Name of institution. -
NotifyAssignedFlag: boolean
Title:
Notify Assigned IndicatorMaximum Length:1Default Value:falseIndicates to the user whether the assignee should receive a communication when the task is assigned. -
NotifyCompletedFlag: boolean
Title:
Notify Completed IndicatorMaximum Length:1Default Value:falseIndicates to the user whether the assignee receives a communication upon completion of the task. -
NotifyDueFlag: boolean
Title:
Notify Due IndicatorMaximum Length:1Default Value:falseIndicates to the user whether the assignee receives a communication when the task is due. -
PurposeTypeCode: string
Title:
Purpose Type CodeMaximum Length:50Code for assignment purpose. -
ReassignmentFlag: boolean
Title:
Allow ReassignmentMaximum Length:1Default Value:falseAllow reassignment. -
SourceObjectCode: string
Title:
Business Process Source CodeMaximum Length:50Code for source object. -
SourceObjectId: integer
(int64)
Title:
Business Process Source IdentifierUnique identifier for source object. -
StarredFlag: boolean
Title:
Starred IndicatorMaximum Length:1Default Value:falseIndicates if the task instance is starred, which means the user has marked it as an important task to quickly locate later. -
StatusCode: string
Title:
Task Outcome Status CodeMaximum Length:30Default Value:ORA_HEY_STATUS_IN_PROGRESSStatus code. -
StatusSchemeId: integer
(int64)
Title:
Status Scheme IdentifierUnique identifier for status scheme. -
TaskId: integer
(int64)
Title:
Task IdentifierUnique identifier for the task.
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 : hedTaskAssignments-item-response
Type:
Show Source
object-
AssigneeEmail: string
Title:
Primary EmailRead Only:trueMaximum Length:320Preferred email of party assigned to the task. -
AssigneeFirstName: string
Title:
First NameRead Only:trueMaximum Length:150First name of party assigned to the task. -
AssigneeLastName: string
Title:
Last NameRead Only:trueMaximum Length:150Last name of party assigned to the task. -
AssigneeName: string
Title:
AssigneeRead Only:trueMaximum Length:450Name of party assigned to the task. -
AssigneePartyId: integer
(int64)
Title:
Task Assignee Party IdentifierParty assigned to the task. -
AssociatedPartyId: integer
(int64)
Title:
Task Assignment Associated Party IdentifierParty identifier associated with the task. -
AssociatedPersonFirstName: string
Title:
First NameRead Only:trueMaximum Length:150First name of party associated with the task. -
AssociatedPersonLastName: string
Title:
Last NameRead Only:trueMaximum Length:150Last name of party associated with the task. -
AssociatedPersonName: string
Title:
Associated PersonRead Only:trueMaximum Length:450Name of party associated with the task. -
AttachmentDescription: string
Title:
Attachment DescriptionDescription of attachment. -
AttachmentFileContents: string
(byte)
Title:
Attachment File ContentsAttachment file. -
AttachmentFileName: string
Title:
Attachment File NameName of attachment file. -
AttachmentFileURL: string
Title:
Attachment File URLRead Only:trueURL for attachment file. -
AttachmentId: integer
(int64)
Title:
Attachment IdentifierUnique identifier for attachment. -
AttachmentMetadata: string
Title:
Attachment MetadataMaximum Length:4000Attachment metadata. -
AttachmentTitle: string
Title:
Attachment TitleTitle of attachment. -
AttachmentUploadedFileContentType: string
Title:
Attachment Uploaded File Content TypeRead Only:trueContent type for attachment file. -
CategoryId: integer
(int64)
Title:
Task Category IdentifierRead Only:trueUnique identifier for task category. -
CategoryName: string
Title:
Category NameRead Only:trueMaximum Length:50Name of task category. -
ChecklistAssignmentId: integer
(int64)
Title:
Checklist Assignment IdentifierRead Only:trueUnique identifier for an instance of checklist assignment. -
ChecklistId: integer
(int64)
Title:
Checklist Setup IdentifierRead Only:trueUnique identifier for checklist setup. -
ChecklistName: string
Title:
Checklist NameRead Only:trueMaximum Length:50Name of checklist. -
CompleteFlag: boolean
Title:
Task CompleteRead Only:trueMaximum Length:1Default Value:falseIndicates whether the task is completed. -
CompletionDate: string
(date-time)
Title:
Task Completion DateRead Only:trueCompletion date. -
DaysUntilDue: integer
Title:
Days Until DueRead Only:trueNumber of days until the due date. -
DocumentTypeCode: string
Title:
Document Type CodeRead Only:trueMaximum Length:30Code for document type. -
DocumentTypeMeaning: string
Title:
Document Type MeaningRead Only:trueMaximum Length:80Meaning of document type. -
DueDate: string
(date-time)
Title:
Task Assignment Due DateDue date. -
EventDate: string
(date)
Title:
Event DateRead Only:trueEvent date. -
InstitutionId: integer
(int64)
Title:
Task Institution IdentifierUnique identifier for institution. -
InstitutionName: string
Title:
Task Institution NameMaximum Length:50Name of institution. -
InstructionText: string
Title:
Task Instruction TextRead Only:trueMaximum Length:255Instructions for the task. -
LastUpdateDate: string
(date-time)
Title:
Last Updated DateRead Only:trueLast updated date. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64Last updated by. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
NotifyAssignedFlag: boolean
Title:
Notify Assigned IndicatorMaximum Length:1Default Value:falseIndicates to the user whether the assignee should receive a communication when the task is assigned. -
NotifyCompletedFlag: boolean
Title:
Notify Completed IndicatorMaximum Length:1Default Value:falseIndicates to the user whether the assignee receives a communication upon completion of the task. -
NotifyDueFlag: boolean
Title:
Notify Due IndicatorMaximum Length:1Default Value:falseIndicates to the user whether the assignee receives a communication when the task is due. -
PurposeTypeCode: string
Title:
Purpose Type CodeMaximum Length:50Code for assignment purpose. -
PurposeTypeMeaning: string
Title:
Purpose TypeRead Only:trueMaximum Length:80Meaning of assignment purpose. -
ReassignmentFlag: boolean
Title:
Allow ReassignmentMaximum Length:1Default Value:falseAllow reassignment. -
RecipientId: integer
Title:
Recipient IdentifierRead Only:trueUnique identifier for recipient. -
SourceObjectCode: string
Title:
Business Process Source CodeMaximum Length:50Code for source object. -
SourceObjectDisplay: string
Title:
Source Object DisplayRead Only:trueDisplay label for source object. -
SourceObjectId: integer
(int64)
Title:
Business Process Source IdentifierUnique identifier for source object. -
SourceObjectMeaning: string
Title:
Business Process SourceRead Only:trueMaximum Length:80Meaning of source object. -
StarredFlag: boolean
Title:
Starred IndicatorMaximum Length:1Default Value:falseIndicates if the task instance is starred, which means the user has marked it as an important task to quickly locate later. -
StartDate: string
(date-time)
Title:
Task Start DateRead Only:trueStart date. -
StatusCode: string
Title:
Task Outcome Status CodeMaximum Length:30Default Value:ORA_HEY_STATUS_IN_PROGRESSStatus code. -
StatusMeaning: string
Title:
Task Outcome StatusRead Only:trueMaximum Length:80Meaning of status. -
StatusSchemeCode: string
Title:
Status Scheme CodeRead Only:trueMaximum Length:30Code for status scheme. -
StatusSchemeId: integer
(int64)
Title:
Status Scheme IdentifierUnique identifier for status scheme. -
StatusSchemeName: string
Title:
Status Scheme NameRead Only:trueMaximum Length:60Name of status scheme. -
StatusTypeCode: string
Title:
Status Type CodeRead Only:trueMaximum Length:30Code for status type. -
StatusTypeMeaning: string
Title:
Status Type MeaningRead Only:trueMaximum Length:80Meaning of status type. -
TaskAssignmentId: integer
(int64)
Title:
Task Assignment IdentifierRead Only:trueUnique identifier for an instance of task assignment. -
TaskAssignmentURL: string
Title:
Task Assignment URLRead Only:trueURL for task assignment. -
TaskDescription: string
Title:
Task DescriptionRead Only:trueMaximum Length:240Description of the task. -
TaskId: integer
(int64)
Title:
Task IdentifierUnique identifier for the task. -
TaskName: string
Title:
Task NameRead Only:trueMaximum Length:50Name of the task. -
TaskTypeCode: string
Title:
Task Type CodeRead Only:trueMaximum Length:30Code for task type. -
TaskTypeMeaning: string
Title:
Task Type MeaningRead Only:trueMaximum Length:80Meaning of task type. -
TokenFive: string
Title:
Token FiveRead Only:trueToken number 5 placeholder used in communication templates. -
TokenFour: string
Title:
Token FourRead Only:trueToken number 4 placeholder used in communication templates. -
TokenOne: string
Title:
Token OneRead Only:trueDefault Value:adf.object.getCommunicationToken(1)Token number 1 placeholder used in communication templates. -
TokenThree: string
Title:
Token ThreeRead Only:trueToken number 3 placeholder used in communication templates. -
TokenTwo: string
Title:
Token TwoRead Only:trueToken number 2 placeholder used in communication templates.
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.
Links
- academicInstitutionsLOV
-
The following properties are defined on the LOV link relation:
- Source Attribute: InstitutionName; Target Attribute: InstitutionName
- Display Attribute: InstitutionName
- purposeTypeCodesLOV
-
Parameters:
- finder:
ByLookupTypeFinder%3BLookupType%3DORA_HEY_TASK_PURPOSE_CODE%2CLookupCode%3D{PurposeTypeCode}
The following properties are defined on the LOV link relation:- Source Attribute: PurposeTypeCode; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- sourceObjectCodesLOV
-
Parameters:
- finder:
ByLookupTypeFinder%3BLookupType%3DORA_HEY_TASK_OBJECT_CODE%2CLookupCode%3D{SourceObjectCode}
The following properties are defined on the LOV link relation:- Source Attribute: SourceObjectCode; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- statusSchemesLOV
-
Parameters:
- finder:
ByCategoryAndInstitutionFinder%3BCategoryName%3D{CategoryName}%2CInstitutionName%3D{InstitutionName}
The following properties are defined on the LOV link relation:- Source Attribute: StatusSchemeCode; Target Attribute: StatusSchemeCode
- Display Attribute: StatusSchemeName
- finder:
- statusSchemesStatusesLOV
-
Parameters:
- finder:
ByStatusSchemeCodeFinder%3BStatusSchemeCode%3D{StatusSchemeCode}
The following properties are defined on the LOV link relation:- Source Attribute: StatusCode; Target Attribute: StatusCode
- Display Attribute: StatusMeaning
- finder: