Aufgabenanforderungen

Abrufen von Aufgaben in einem Ordner

Mit dieser Anforderung können Sie alle Aufgaben in den klassischen Ordnern abrufen, auf die der Benutzer Zugriff hat.

Hinweis:

Dieser Endpunkt ruft nur Aktionen in klassischen Ordnern ab und ist in Zukunft veraltet.

Verwenden Sie die folgenden, um Aktionen unabhängig vom Ordnertyp abzurufen:

• odata/Tasks/UiPath.Server.Configuration.OData.GetTasksAcrossFolders
• odata/Tasks/UiPath.Server.Configuration.OData.GetTasksAcrossFoldersForAdmin

Abrufen

/odata/Tasks?$top=2

Anforderungsheader

Schlüssel	Wert
Autorisierung	Inhaber

Antwortcode

200 OK

Antworttext

{
  "@odata.context": "/odata/$metadata#Tasks",
  "@odata.count": 21,
  "value": [
    {
      "Title": "Performance Review",
      "Type": "FormTask",
      "Priority": "Medium",
      "Status": "Completed",
      "CreationTime": "2019-10-16T11:39:30.41Z",
      "TaskCatalogName": "Expecto Patronum",
      "OrganizationUnitId": 828,
      "IsCompleted": true,
      "Id": 63
    },
    {
      "Title": "Performance Review",
      "Type": "FormTask",
      "Priority": "Medium",
      "Status": "Completed",
      "CreationTime": "2019-10-16T11:40:24.88Z",
      "TaskCatalogName": "Expecto Patronum",
      "OrganizationUnitId": 828,
      "IsCompleted": true,
      "Id": 64
    }

Aufgabendetails abrufen

Mit dieser Anforderung können Sie Aufgabendetails gemäß TaskIdabrufen. Die TaskId muss in der Anforderung enthalten sein. Beispiel: /odata/Tasks(194).

Abrufen

/odata/Tasks(194)

Anforderungsheader

Schlüssel	Wert
Autorisierung	Inhaber

Antwortcode

200 OK

Antworttext

{
  "@odata.context": "/odata/$metadata#Tasks/$entity",
  "Title": "Verify Credentials",
  "Type": "FormTask",
  "Priority": "Critical",
  "Status": "Unassigned",
  "CreationTime": "2019-12-12T17:25:03.02Z",
  "TaskCatalogName": "Auth",
  "OrganizationUnitId": 828,
  "IsCompleted": false,
  "Id": 194
}

Zuweisen einer Aufgabe zu einem Benutzer

Mit dieser Anforderung können Sie einem Benutzer eine Aufgabe gemäß TaskId und UserIdzuweisen. Eine einzelne Anforderung kann die Zuweisung mehrerer Aufgaben an verschiedene Benutzer verarbeiten.

Posten

/odata/Tasks/UiPath.Server.Configuration.OData.AssignTasks

Anforderungsheader

Schlüssel	Wert
Autorisierung	Inhaber

Anforderungstext

{
"taskAssignments": 
[   
 {
      "TaskId": 194,
      "UserId": 52454
    }
]
}

Antwortcode

200 OK

Antworttext

{
    "@odata.context": "/odata/$metadata#Collection(UiPath.Orchestrator.Tasks.Dto.TaskAssignmentErrorResponse)",
    "value": [
        {
            "TaskId": 195,
            "UserId": 52454,
            "ErrorCode": 2400,
            "ErrorMessage": "Task is already assigned"
        }
    ]
}

Nicht zugewiesene Aufgaben

Mit dieser Anforderung können Sie die Zuweisung für eine oder mehrere Aufgaben basierend auf der bereitgestellten taskIds löschen.

Posten

/odata/Tasks/UiPath.Server.Configuration.OData.UnassignTasks

Anforderungsheader

Schlüssel	Wert
Autorisierung	Inhaber

Anforderungstext

{
  "taskIds": [
    194,177
  ]
}

Antwortcode

200 OK

Antworttext

{
    "@odata.context": "/odata/$metadata#Collection(UiPath.Orchestrator.Tasks.Dto.TaskAssignmentErrorResponse)",
    "value": [
        {
            "TaskId": 177,
            "UserId": null,
            "ErrorCode": 2400,
            "ErrorMessage": "This task is in completed state"
        }
    ]
}

Zurückgeben von Benutzern mit Anzeige- und Bearbeitungsberechtigungen für Aufgaben

Mit dieser Anforderung können Sie Benutzer mit Berechtigungen zum Anzeigen und Bearbeiten für Aufgaben abrufen. Die Ordner-ID muss in der Anforderung enthalten sein.

Abrufen

/odata/Tasks/UiPath.Server.Configuration.OData.GetTaskUsers(organizationUnitId=36886)

Anforderungsheader

Schlüssel	Wert
Autorisierung	Inhaber

Antwortcode

200 OK

Antworttext

{
  "@odata.context": "/odata/$metadata#UserLoginInfo",
  "@odata.count": 13,
  "value": [
    {
      "Name": "Harry",
      "Surname": "Potter",
      "UserName": "[e-mail]",
      "EmailAddress": "[e-mail]",
      "Id": 52454
    },
    {
      "Name": "Severus",
      "Surname": "Snape",
      "UserName": "severus.snape@uipath",
      "EmailAddress": "[e-mail]",
      "Id": 52917
    }

Delete Task

Mit dieser Anforderung können Sie eine oder mehrere Aufgaben anhand ihrer IDs löschen.

Posten

/odata/Tasks/UiPath.Server.Configuration.OData.DeleteTasks

Anforderungsheader

Schlüssel	Wert
Autorisierung	Inhaber

Anforderungstext

{
  "taskIds": [
     104177
  ]
}

Antwortcode

200 OK

Antworttext

{
    "@odata.context": "/odata/$metadata#Collection(UiPath.Orchestrator.Tasks.Dto.TaskAssignmentErrorResponse)",
    "value": [
        {
            "TaskId": 104177,
            "UserId": null,
            "ErrorCode": 2427,
            "ErrorMessage": "You do not have the required permissions to delete this action"
        }
    ]
}