Method ForwardTask
ForwardTask(String, String, List<String>, ProcessContract)
Forwards the current task of a process to a new user list
Declaration
ProcessContract ForwardTask(string connectionId, string processId, List<string> assignedUserIds, ProcessContract process)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> | assignedUserIds | List of users which will retrieve the current task |
| ProcessContract | process | The process. See also ProcessContract |
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/ForwardTask
Example for forwards the current task of a process to a new user list.{
"connectionId": "831ff0cd-6a36-4831-ae98-c66f54e8079b",
"processId": "ce3fee52-a0df-e911-a949-00155d290a08",
"assignedUserIds": ["2cd4ad99-bacf-e911-a939-00155d290a08"]
"process": {
"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"
}, {
"Action": "Finanz",
"AssignedUserIds": ["2cd4ad99-bacf-e911-a939-00155d290a08"],
"Comments": [],
"CompletedDate": "2019-09-25T14:13:02",
"CompletedUserIds": ["0100a003-38a7-11d8-a902-0050bf427e8f"],
"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": [],
"ReminderDate": "2019-09-25T14:05:34",
"RequiresAllRecipients": false,
"ShowCloseTaskDialog": false,
"StatusEnum": "Complete",
"TaskTemplateId": "a303e6f6-2c5c-42a8-bdb2-071cb928ae56" }],
"CreatedDate": "2019-09-25T13:55:40",
"CurrentTask": {
"Action": "Complete process",
"AssignedUserIds": ["2cd4ad99-bacf-e911-a939-00155d290a08"],
"Comments": [],
"CompletedDate": null,
"CompletedUserIds": [],
"CreatedDate": "2019-09-25T14:13:07",
"CreatorId": "2cd4ad99-bacf-e911-a939-00155d290a08",
"Description": "",
"DueDate": "2019-09-27T13:55:39",
"Id": "3da88194-9edf-e911-a949-00155d290a08",
"IntendedUserIds": ["2cd4ad99-bacf-e911-a939-00155d290a08"],
"ReminderDate": "2019-09-25T14:13:07",
"RequiresAllRecipients": false,
"ShowCloseTaskDialog": false,
"StatusEnum": "Open",
"TaskTemplateId": "735b676a-4748-4f7a-a994-9ad0de6af0e8" },
"CustomProperties": [{
"CustomPropertyTypeEnum": "String",
"Name": "Bemerkung",
"Value": "keine Hinweise!" }],
"DocumentIds": ["27b61621-9cdf-e911-a949-00155d290a08"],
"DueDate": "2019-09-27T13:55:39",
"Id": "79247328-9cdf-e911-a949-00155d290a08",
"Name": {
"Values": [{
"Culture": "de",
"Text": "Rechnungen" }, {
"Culture": "en",
"Text": "Invoice" }] },
"PluginStream": [],
"PriorityEnum": "Normal",
"ProcessTemplateId": "24a927d1-21d2-e911-a93c-00155d290a08",
"Properties": [{
"PropertyTypeId": "01000000-d596-485b-ace6-d64647a94277",
"Values": ["0100a000-38a7-11d8-a902-0050bf427e8f"] }, {
"PropertyTypeId": "01000031-38a7-11d8-a902-0050bf427e8f",
"Values": ["2019-09-27T13:55:00"] }, {
"PropertyTypeId": "0100003c-38a7-11d8-a902-0050bf427e8f",
"Values": [""] }, {
"PropertyTypeId": "01000032-38a7-11d8-a902-0050bf427e8f",
"Values": ["1"] }, {
"PropertyTypeId": "01000037-38a7-11d8-a902-0050bf427e8f",
"Values": ["Complete process"] }, {
"PropertyTypeId": "01000038-38a7-11d8-a902-0050bf427e8f",
"Values": ["2019-09-27T13:55:00"] }],
"ProtectionDomainId": "0100a000-38a7-11d8-a902-0050bf427e8f",
"StatusEnum": "Open" }
}Response:
{
"ForwardTaskResult": {
"AccessRightsEnumList": [
"CheckOut",
"EditProcess",
"Delete",
"CancelCheckOut",
"DeleteDocumentFromProcess"
],
"CheckOutStateEnum": "NotCheckedOut",
"CheckOutUserId": "00000000-0000-0000-0000-000000000000",
"Comments": [],
"CompletedDate": null,
"CompletedTasks": [
{
"Action": "Aufgabe",
"AssignedUserCCIds": [],
"AssignedUserIds": [],
"Comments": [],
"CompletedDate": "2024-07-16T12:46:05",
"CompletedUserIds": [
"0100a003-38a7-11d8-a902-0050bf427e8f"
],
"CreatedDate": "2024-07-16T12:29:12",
"CreatorId": "0100a003-38a7-11d8-a902-0050bf427e8f",
"DeputyRepresentations": [],
"Description": "",
"DescriptionGlobal": {
"Values": [
{
"Culture": "de",
"Text": ""
}
]
},
"DueDate": "2024-07-16T12:29:12",
"Id": "9c87feac-6e01-4151-a4cf-7d29c9870cfa",
"IntendedUserIds": [],
"NameGlobal": {
"Values": [
{
"Culture": "de",
"Text": "Aufgabe"
}
]
},
"ReminderDate": "2024-07-16T12:29:12",
"RequiresAllRecipients": false,
"ShowCloseTaskDialog": false,
"StatusEnum": "Complete",
"TaskActionEnum": "Forwarded",
"TaskTemplateId": "3a01952b-c07d-4e16-9345-e25adee15c0c"
}
],
"CreatedDate": "2024-07-16T12:29:12",
"CurrentTask": {
"Action": "Aufgabe",
"AssignedUserCCIds": [],
"AssignedUserIds": [
"2164b2f5-ddd0-4255-9207-e0ab9f8c4e5b",
"040b898c-4a20-4407-8af5-802b7455710b"
],
"Comments": [],
"CompletedDate": null,
"CompletedUserIds": [],
"CreatedDate": "2024-07-16T12:46:07",
"CreatorId": "0100a003-38a7-11d8-a902-0050bf427e8f",
"DeputyRepresentations": [],
"Description": "",
"DescriptionGlobal": {
"Values": [
{
"Culture": "de",
"Text": ""
}
]
},
"DueDate": "2024-07-16T12:46:07",
"Id": "c5894383-d44f-4f41-81ff-9d232d84e338",
"IntendedUserIds": [],
"NameGlobal": {
"Values": [
{
"Culture": "de",
"Text": "Aufgabe"
}
]
},
"ReminderDate": "2024-07-16T12:46:07",
"RequiresAllRecipients": false,
"ShowCloseTaskDialog": false,
"StatusEnum": "Open",
"TaskActionEnum": "None",
"TaskTemplateId": "3a01952b-c07d-4e16-9345-e25adee15c0c"
},
"CustomProperties": [],
"Description": {
"Values": [
{
"Culture": "de",
"Text": "newProcessDescription"
}
]
},
"DocumentIds": [],
"DueDate": "2024-07-16T12:29:00",
"Id": "a00875ad-dc88-46a6-8130-5a6628a547a7",
"Name": {
"Values": [
{
"Culture": "de",
"Text": "Test_reminder"
},
{
"Culture": "en",
"Text": "Test_reminder"
}
]
},
"PluginStream": [],
"PriorityEnum": "Normal",
"ProcessTemplateId": "c00008a3-ea71-40ec-a08d-ff206aab64ff",
"Properties": [
{
"GlobalValues": [
{
"Values": [
{
"Culture": "de",
"Text": "Test_reminder"
},
{
"Culture": "en",
"Text": "Test_reminder"
}
]
}
],
"PropertyTypeId": "01000a00-38a7-11d8-a902-0050bf427e8f",
"Values": [
"Test_reminder"
]
},
{
"GlobalValues": [
{
"Values": [
{
"Culture": "de",
"Text": "Standardsicherheit"
},
{
"Culture": "en",
"Text": "Default security"
},
{
"Culture": "fr",
"Text": "Sécurité par défaut"
},
{
"Culture": "it",
"Text": "Sicurezza predefinita"
},
{
"Culture": "es",
"Text": "Seguridad predeterminada."
},
{
"Culture": "ja",
"Text": "デフォルトのセキュリティ"
},
{
"Culture": "pt",
"Text": "Segurança predefinida"
},
{
"Culture": "zh",
"Text": "默认安全性"
},
{
"Culture": "nl",
"Text": "Standaard beveiliging"
},
{
"Culture": "pl",
"Text": "Bezpieczeństwo domyślne"
}
]
}
],
"PropertyTypeId": "01000000-d596-485b-ace6-d64647a94277",
"Values": [
"0100a000-38a7-11d8-a902-0050bf427e8f"
]
},
{
"GlobalValues": [],
"PropertyTypeId": "01000031-38a7-11d8-a902-0050bf427e8f",
"Values": [
"2024-07-16T12:29:00"
]
},
{
"GlobalValues": [],
"PropertyTypeId": "0100003c-38a7-11d8-a902-0050bf427e8f",
"Values": [
""
]
},
{
"GlobalValues": [],
"PropertyTypeId": "01000032-38a7-11d8-a902-0050bf427e8f",
"Values": [
"1"
]
},
{
"GlobalValues": [
{
"Values": [
{
"Culture": "de",
"Text": "Aufgabe"
}
]
}
],
"PropertyTypeId": "01000037-38a7-11d8-a902-0050bf427e8f",
"Values": [
"Aufgabe"
]
},
{
"GlobalValues": [],
"PropertyTypeId": "01000038-38a7-11d8-a902-0050bf427e8f",
"Values": [
"2024-07-16T12:46:00"
]
},
{
"GlobalValues": [],
"PropertyTypeId": "01000039-38a7-11d8-a902-0050bf427e8f",
"Values": [
"2024-07-16T12:46:00"
]
},
{
"GlobalValues": [],
"PropertyTypeId": "0100003a-38a7-11d8-a902-0050bf427e8f",
"Values": [
"2024-07-16T12:46:00"
]
},
{
"GlobalValues": [
{
"Values": [
{
"Culture": "de",
"Text": "offen"
},
{
"Culture": "en",
"Text": "open"
},
{
"Culture": "fr",
"Text": "ouvert"
},
{
"Culture": "it",
"Text": "aperto"
},
{
"Culture": "es",
"Text": "abrir"
},
{
"Culture": "ja",
"Text": "未完了"
},
{
"Culture": "pt",
"Text": "em aberto"
},
{
"Culture": "zh",
"Text": "打开"
},
{
"Culture": "nl",
"Text": "open"
},
{
"Culture": "pl",
"Text": "otwarte"
},
{
"Culture": "tr",
"Text": "açık"
}
]
}
],
"PropertyTypeId": "0100003b-38a7-11d8-a902-0050bf427e8f",
"Values": [
"0"
]
},
{
"GlobalValues": [
{
"Values": [
{
"Culture": "de-DE",
"Text": "DCI administrator"
},
{
"Culture": "de",
"Text": "DCI administrator"
}
]
}
],
"PropertyTypeId": "0100103b-38a7-11d8-a902-0050bf427e8f",
"Values": [
"0100a003-38a7-11d8-a902-0050bf427e8f"
]
},
{
"GlobalValues": [
{
"Values": [
{
"Culture": "de-DE",
"Text": "lus"
},
{
"Culture": "de",
"Text": "lus"
}
]
},
{
"Values": [
{
"Culture": "de-DE",
"Text": "test"
},
{
"Culture": "de",
"Text": "test"
}
]
}
],
"PropertyTypeId": "0100103c-38a7-11d8-a902-0050bf427e8f",
"Values": [
"2164b2f5-ddd0-4255-9207-e0ab9f8c4e5b",
"040b898c-4a20-4407-8af5-802b7455710b"
]
},
{
"GlobalValues": [],
"PropertyTypeId": "fea1ac51-c547-4839-974b-e9e616e21fa4",
"Values": []
},
{
"GlobalValues": [
{
"Values": [
{
"Culture": "de-DE",
"Text": "DCI administrator"
},
{
"Culture": "de",
"Text": "DCI administrator"
}
]
}
],
"PropertyTypeId": "01000002-d596-485b-ace6-d64647a94277",
"Values": [
"0100a003-38a7-11d8-a902-0050bf427e8f"
]
},
{
"GlobalValues": [
{
"Values": [
{
"Culture": "de-DE",
"Text": "DCI administrator"
},
{
"Culture": "de",
"Text": "DCI administrator"
}
]
}
],
"PropertyTypeId": "01000005-d596-485b-ace6-d64647a94277",
"Values": [
"0100a003-38a7-11d8-a902-0050bf427e8f"
]
},
{
"GlobalValues": [],
"PropertyTypeId": "01000003-d596-485b-ace6-d64647a94277",
"Values": [
"a00875ad-dc88-46a6-8130-5a6628a547a7"
]
},
{
"GlobalValues": [],
"PropertyTypeId": "01000001-d596-485b-ace6-d64647a94277",
"Values": [
"2024-07-16T12:29:00"
]
},
{
"GlobalValues": [
{
"Values": [
{
"Culture": "de",
"Text": "Test_reminder"
},
{
"Culture": "en",
"Text": "Test_reminder"
}
]
}
],
"PropertyTypeId": "0100003d-38a7-11d8-a902-0050bf427e8f",
"Values": [
"c00008a3-ea71-40ec-a08d-ff206aab64ff"
]
},
{
"GlobalValues": [
{
"Values": [
{
"Culture": "de",
"Text": "Aufgabe"
}
]
}
],
"PropertyTypeId": "0100003e-38a7-11d8-a902-0050bf427e8f",
"Values": [
"3a01952b-c07d-4e16-9345-e25adee15c0c"
]
},
{
"GlobalValues": [],
"PropertyTypeId": "0100000a-38a7-11d8-a902-0050bf427e8f",
"Values": []
},
{
"GlobalValues": [],
"PropertyTypeId": "45672355-3b57-11d8-a902-0050bf427e8f",
"Values": []
}
],
"ProtectionDomainId": "0100a000-38a7-11d8-a902-0050bf427e8f",
"SessionCount": 20,
"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 | User not found {userId} (10047) |
| ServiceException | Verification code is needed: Verification code not yet verified (10152) |