Task Delegation APIs
- Alex Xie
Analytics
These APIs are only required when the OneList delegation feature is enabled. Delegation is a two-way sync between OneList and the source workflow system.
Get Delegations API
This API returns all the current and future delegations of the in-scope workflows from the source workflow system.
Input parameters:
For filtering delegation by workflow, scope/profile, optional
Return parameters:
List of delegations with the following mandatory information
Delegation record id - the unique delegation record id
Scope - the scope of the delegation, e.g. SAP delegation profile, the workflow name
Delegate form user id - the source system user id
Delegate to user id - the source system user id
Start date - the delegation start date and time with time zone information
End date - the delegation end date and time with time zone information
Optional attributes:
Workflow type - value for the delegation identification, e.g. delegation sub-system.
Save Delegations API
This API creates or updates the source workflow system delegation record.
Input parameters:
Delegation record id - the unique delegation record id, optional for create new delegation record.
Scope - the scope of the delegation, e.g. SAP delegation profile, the workflow name
Delegate form user id - the source system user id
Delegate to user id - the source system user id
Start date - the delegation start date and time with time zone information
End date - the delegation end date and time with time zone information
Workflow type - Optional, value for the delegation identification, e.g. delegation sub-system.
Return parameters:
Success or error messages
Delete Delegation API
This API deletes the delegation record.
Input parameters:
Delegation record id - the unique delegation record id, optional for create new delegation record.
Scope - optional, the scope of the delegation, e.g. SAP delegation profile, the workflow name
Return parameters:
Success or error messages