Solicitudes de tareas

Puntos finales de API para recuperar tareas en todos los tipos de carpetas, incluidas notas de obsolescencia para puntos finales de carpetas clásicas.

Recuperar tareas en una carpeta

Esta solicitud le permite recuperar todas las tareas en las carpetas clásicas a las que el usuario tiene acceso.

Nota:

Este punto final solo recupera acciones en carpetas clásicas y quedará obsoleto en el futuro. Utiliza los siguientes para recuperar acciones independientemente del tipo de carpeta:

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

Obtener

{AutomationCloudURL}/{organizationName}/{tenantName}/orchestrator_/odata/Tasks?$top=2

Solicitar encabezados.

Clave	Valor
Autorización	Portador

Código de respuesta

200 OK

Cuerpo de respuesta

{
  "@odata.context": "{AutomationCloudURL}/{organizationName}/{tenantName}/orchestrator_/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
    }

Recuperar detalles de la tarea

Esta solicitud te permite recuperar los detalles de la tarea según TaskId. El TaskId debe incluirse en la solicitud. Por ejemplo, {AutomationCloudURL}/{organizationName}/{tenantName}/orchestrator_/odata/Tasks(194)

Obtener

{AutomationCloudURL}/{organizationName}/{tenantName}/orchestrator_/odata/Tasks(194)

Solicitar encabezados.

Clave	Valor
Autorización	Portador

Código de respuesta

200 OK

Cuerpo de respuesta

{
  "@odata.context": "{AutomationCloudURL}/{organizationName}/{tenantName}/orchestrator_/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
}

Asignar una tarea a un usuario

Esta solicitud te permite asignar una tarea a un usuario, de acuerdo con TaskId y UserId. Una sola solicitud puede manejar la asignación de múltiples tareas a diferentes usuarios.

Publicar

{AutomationCloudURL}/{organizationName}/{tenantName}/orchestrator_/odata/Tasks/UiPath.Server.Configuration.OData.AssignTasks

Solicitar encabezados.

Clave	Valor
Autorización	Portador

Solicitar cuerpo

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

Código de respuesta

200 OK

Cuerpo de respuesta

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

Desasignar tareas

Esta solicitud le permite borrar la asignación para una o varias tareas según el taskIds proporcionado.

Publicar

{AutomationCloudURL}/{organizationName}/{tenantName}/orchestrator_/odata/Tasks/UiPath.Server.Configuration.OData.UnassignTasks

Solicitar encabezados.

Clave	Valor
Autorización	Portador

Solicitar cuerpo

{
  "taskIds": [
    194,177
  ]
}

Código de respuesta

200 OK

Cuerpo de respuesta

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

Devolver usuarios con permisos Ver y Editar en tareas

Esta solicitud te permite recuperar usuarios con permisos de ver y editar en tareas. El ID de carpeta debe incluirse en la solicitud.

Obtener

{AutomationCloudURL}/{organizationName}/{tenantName}/orchestrator_/odata/Tasks/UiPath.Server.Configuration.OData.GetTaskUsers(organizationUnitId=36886)

Solicitar encabezados.

Clave	Valor
Autorización	Portador

Código de respuesta

200 OK

Cuerpo de respuesta

{
  "@odata.context": "{AutomationCloudURL}/{organizationName}/{tenantName}/orchestrator_/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
    }

Eliminar una tarea

Esta solicitud le permite eliminar una o más tareas por sus ID.

Publicar

{AutomationCloudURL}/{organizationName}/{tenantName}/orchestrator_/odata/Tasks/UiPath.Server.Configuration.OData.DeleteTasks

Solicitar encabezados.

Clave	Valor
Autorización	Portador

Solicitar cuerpo

{
  "taskIds": [
     104177
  ]
}

Código de respuesta

200 OK

Cuerpo de respuesta

{
    "@odata.context": "{AutomationCloudURL}/{organizationName}/{tenantName}/orchestrator_/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"
        }
    ]
}