maestro
latest
false
Guía de la API de Maestro
- API de CaseApp
- Solicitudes de CaseApp
Importante :
La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.
Puntos finales de la API para desencadenar tareas de casos ad-hoc a través de la API de CaseApp v3.
Desencadenar una tarea de caso ad-hoc
Desencadena una tarea desencadenada manualmente (ad-hoc), identificada por su nombre de plan de caso, en una instancia de Maestro Case en ejecución.
Publicar
{AutomationCloudURL}/{organizationName}/{tenantName}/pims_/api/v3/caseapp/instances/{instanceId}/tasks/trigger
Solicitar encabezados.
| Clave | Valor |
|---|---|
| Autorización | Portador |
| X-UIPATH-ClaveDeCarpeta | La clave de la carpeta de la instancia del caso |
Solicitar cuerpo
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Nombre de la tarea | String | Sí | El nombre de la tarea ad-hoc que se desencadenará, exactamente como se resuelve en el plan del caso. La coincidencia distingue entre mayúsculas y minúsculas. |
| Entrada de tarea | object | No | Un objeto JSON de forma libre reenviado palabra por palabra a la tarea desencadenada como carga útil anidada, por ejemplo, referencias de aprobación o datos de decisión. La plataforma no interpreta ni valida el esquema de esta carga útil, y no está vinculada a las entradas declaradas de la tarea. |
{
"taskName": "string",
"taskInput": {}
}
{
"taskName": "string",
"taskInput": {}
}
Código de respuesta
200 Correcto (cuerpo vacío)
Respuestas de error
| Código | Significado |
|---|---|
| 400 | Falta el cuerpo de la solicitud o no es válido. |
| 401 | La persona que llama no está autenticada. |
| 403 | La persona que llama carece del permiso necesario para esta tarea. |
| 404 | La instancia del caso no existe o no existe ninguna tarea ad-hoc con ese nombre en el plan del caso. Solo las tareas con un permiso "adhoc" condición de entrada son elegibles: otros nombres devuelven 404. |
| 500 | Se ha producido un error inesperado del servidor. |
Permisos
Requiere el permiso Cases.RunAdhocTasks, autorizado en el ámbito de la etapa propietaria de la tarea solicitada.
Cerrar una instancia de caso
Cierra una instancia de Maestro Case en ejecución.
Publicar
{AutomationCloudURL}/{organizationName}/{tenantName}/pims_/api/v3/caseapp/instances/{instanceId}/close
Solicitar encabezados.
| Clave | Valor |
|---|---|
| Autorización | Portador |
| X-UIPATH-ClaveDeCarpeta | La clave de la carpeta de la instancia del caso |
Códigos de respuesta
| Código | Significado |
|---|---|
| 200 | La instancia ha cambiado a Canceling. El trabajador completa el turno a Cancelled de forma asíncrona. Una instancia ya terminal devuelve su estado actual sin cambios. |
| 400 | La instancia ya ha alcanzado Completed y no se puede cancelar. |
| 401 | La persona que llama no está autenticada. |
| 403 | La persona que llama carece del permiso necesario para esta instancia. |
| 404 | El ID de instancia no se resuelve en una instancia de caso. |
Permisos
Requiere la concesión de perfil Cases.Close.