UiPath Documentation
maestro
latest
false
Guia da API do Maestro
  • API do CaseApp
    • Solicitações de aplicativos de casos
Importante :
A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.

Solicitações de aplicativos de casos

Pontos de extremidade de API para disparar tarefas de caso ad-hoc por meio da API CaseApp v3.

Dispare uma tarefa de caso ad-hoc

Dispara uma tarefa acionada manualmente (ad-hoc), identificada pelo nome do plano de caso, em uma instância em execução do Maestro Case.

Postar

{AutomationCloudURL}/{organizationName}/{tenantName}/pims_/api/v3/caseapp/instances/{instanceId}/tasks/trigger

Cabeçalhos de solicitação.

ChaveValor
AutorizaçãoO portador
ChaveDaPastaX-UIPATHA chave da pasta da instância do caso

Corpo da Solicitação

CampoTipoRequiredDescription
taskNameStringSimO nome da tarefa ad-hoc a ser disparada, exatamente como é resolvido no plano de caso. A correspondência diferencia maiúsculas de minúsculas.
Entrada da TarefaobjectNãoUm objeto JSON de forma livre encaminhado textual para a tarefa acionada como uma carga aninhada, por exemplo, referências de aprovação ou dados de decisão. A plataforma não interpreta nem valida o esquema dessa carga e não está associada às entradas declaradas da tarefa.
{
  "taskName": "string",
  "taskInput": {}
}
{
  "taskName": "string",
  "taskInput": {}
}

Código de resposta

200 Sucesso (corpo vazio)

Respostas de erro

CódigoSignificado
400O corpo da solicitação está ausente ou é inválido.
401O chamador não é autenticado.
403O chamador não tem a permissão necessária para esta tarefa.
404A instância de caso não existe ou não existe nenhuma tarefa ad-hoc com esse nome no plano de caso. Apenas tarefas com um evento "adhoc" a condição de entrada é elegível — outros nomes retornam 404.
500Ocorreu um erro de servidor inesperado.

Permissões

Requer a permissão Cases.RunAdhocTasks, autorizada no escopo do estágio que possui a tarefa solicitada.

Fechar uma instância de caso

Fecha uma instância em execução do Maestro Case.

Postar

{AutomationCloudURL}/{organizationName}/{tenantName}/pims_/api/v3/caseapp/instances/{instanceId}/close

Cabeçalhos de solicitação.

ChaveValor
AutorizaçãoO portador
ChaveDaPastaX-UIPATHA chave da pasta da instância do caso

Códigos de resposta

CódigoSignificado
200A instância fez a transição para Canceling. O trabalho conclui o deslocamento para Cancelled de forma assíncrona. Uma instância já terminal retorna seu status atual inalterado.
400A instância já atingiu Completed e não pode ser cancelada.
401O chamador não é autenticado.
403O chamador não tem a permissão necessária para esta instância.
404O ID da instância não é resolvido em uma instância de caso.

Permissões

Requer a concessão de persona Cases.Close.

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte

Quer aprender? Academia UiPath

Tem perguntas? Fórum do UiPath

Fique por dentro das novidades