Method TakeOverTask

TakeOverTask(String, String, List<String>)

Forwards the current task of a process to the actual connected user and takeover users.

Declaration

ProcessContract TakeOverTask(string connectionId, string processId, List<string> takeoverUsers)

Parameters

Type	Name	Description
System.String	connectionId	The connection id to identify your connection. See also ConnectionId
System.String	processId	The process id. See also Id
System.Collections.Generic.List<System.String>	takeoverUsers	Users to takeover. See also >

Returns

Type	Description
ProcessContract	Process

Remarks

• You need "Change process" access right (01002078-38a7-11d8-a902-0050bf427e8f) for the protection domain. See also GetSecurityStore(String)
• Process status must be open.

Examples

POST http://YourServerName/InfoShare/Json/Process/TakeOverTask

Example for forwards the current task of a process to the actual connected user.

{
   "connectionId": "831ff0cd-6a36-4831-ae98-c66f54e8079b",
   "processId": "ce3fee52-a0df-e911-a949-00155d290a08",
   "takeoverUsers": ["2cd4ad99-bacf-e911-a939-00155d290a08"]
}

Response:

{
   "TakeOverTaskResult": {
     "AccessRightsEnumList": ["CheckOut", "EditProcess", "Delete"],
     "CheckOutStateEnum": "NotCheckedOut",
     "CheckOutUserId": "00000000-0000-0000-0000-000000000000",
     "Comments": [],
     "CompletedDate": null,
     "CompletedTasks": [{
       "Action": "Kontieren",
       "AssignedUserIds": ["2cd4ad99-bacf-e911-a939-00155d290a08"],
       "Comments": [],
       "CompletedDate": "2019-09-25T14:05:34",
       "CompletedUserIds": ["0100a003-38a7-11d8-a902-0050bf427e8f"],
       "CreatedDate": "2019-09-25T13:55:40",
       "CreatorId": "2cd4ad99-bacf-e911-a939-00155d290a08",
       "Description": "Account assignment",
       "DueDate": "2019-09-28T13:55:40",
       "Id": "10297328-9cdf-e911-a949-00155d290a08",
       "IntendedUserIds": [],
       "ReminderDate": "2019-09-25T13:55:40",
       "RequiresAllRecipients": false,
       "ShowCloseTaskDialog": false,
       "StatusEnum": "Complete",
       "TaskTemplateId": "92b13f55-e7b6-46ec-98b0-034d7ef5a8fe" }],
     "CreatedDate": "2019-09-25T13:55:40",
     "CurrentTask": {
       "Action": "Finanz",
       "AssignedUserIds": [],
       "Comments": [],
       "CompletedDate": null,
       "CompletedUserIds": [],
       "CreatedDate": "2019-09-25T14:05:34",
       "CreatorId": "2cd4ad99-bacf-e911-a939-00155d290a08",
       "Description": "Release by finance department",
       "DueDate": "2019-09-26T14:05:34",
       "Id": "76deda85-9ddf-e911-a949-00155d290a08",
       "IntendedUserIds": ["0100a003-38a7-11d8-a902-0050bf427e8f"],
       "ReminderDate": "2019-09-25T14:05:34",
       "RequiresAllRecipients": false,
       "ShowCloseTaskDialog": false,
       "StatusEnum": "Open",
       "TaskTemplateId": "a303e6f6-2c5c-42a8-bdb2-071cb928ae56" },
     "CustomProperties": [],
     "DocumentIds": ["6ba7a04c-a0df-e911-a949-00155d290a08"],
     "DueDate": "2019-09-27T14:25:28",
     "Id": "ce3fee52-a0df-e911-a949-00155d290a08",
     "Name": {
       "Values": [{
         "Culture": "de",
         "Text": "Rechnungen" }, {
         "Culture": "en",
         "Text": "Invoice" }] },
     "PluginStream": [],
     "PriorityEnum": "Normal",
     "ProcessTemplateId": "24a927d1-21d2-e911-a93c-00155d290a08",
     "Properties": [{
       "PropertyTypeId": "3ecaf07d-c1cf-e911-a939-00155d290a08",
       "Values": ["12564"] }, {
       "PropertyTypeId": "2cdacc4e-15d0-e911-a93a-00155d290a08",
       "Values": ["Rechnung"] }, {
       "PropertyTypeId": "01000a00-38a7-11d8-a902-0050bf427e8f",
       "Values": ["Invoice"] }, {
       "PropertyTypeId": "01000000-d596-485b-ace6-d64647a94277",
       "Values": ["0100a000-38a7-11d8-a902-0050bf427e8f"] }, {
       "PropertyTypeId": "01000031-38a7-11d8-a902-0050bf427e8f",
       "Values": ["2019-09-27T14:25:00"] }, {
       "PropertyTypeId": "01000037-38a7-11d8-a902-0050bf427e8f",
       "Values": ["Kontieren"] }, {
       "PropertyTypeId": "0100003b-38a7-11d8-a902-0050bf427e8f",
       "Values": ["0"] }, {
       "PropertyTypeId": "0100003e-38a7-11d8-a902-0050bf427e8f",
       "Values": ["92b13f55-e7b6-46ec-98b0-034d7ef5a8fe"] }],
     "ProtectionDomainId": "0100a000-38a7-11d8-a902-0050bf427e8f",
     "StatusEnum": "Open" }
   }

Exceptions

Type	Condition
ServiceException	The connection id {connectionId} isn't valid or has expired (10008)
ServiceException	No process found for processId {processId} (10015)
ServiceException	Operation {operationName} not allowed. Missing AccessOperationId {operationId}. (10114)
ServiceException	Process already closed (10115)
ServiceException	Verification code is needed: Verification code not yet verified (10152)