Pontos de extremidade de fluxos de trabalho
Pontos de extremidade de fluxos de trabalho e parâmetros
Para saber mais sobre as relações de objetos e como usá-las na API, vá para a seção Relações de objeto .
Para obter mais informações sobre fluxos de trabalho, visite a página de ajuda Fluxos de trabalho .
Carregar um novo fluxo de trabalho
Para carregar um novo fluxo de trabalho, use o ponto de extremidade
POST {baseURL}/v3/workflows
.
Parâmetros
file (arquivo): obrigatório. Selecione o arquivo que deseja carregar no sistema. O tipo de mídia deve ser um arquivo YXZP.
name (cadeia de caracteres): obrigatório. Insira um nome de fluxo de trabalho. Este é o nome do fluxo de trabalho a ser exibido na IU do Server.
ownerId (cadeia de caracteres): obrigatório. Insira o ID do proprietário.
workerTag (cadeia de caracteres): opcional. Especifique a tag do trabalhador definida nos trabalhos para ajudar a atribuir tarefas a determinados nós de trabalho. Para obter mais informações, visite a página de ajuda Trabalhador .
districtTags (cadeia de caracteres): opcional. Envie como uma matriz formatada em JSON, por exemplo, ["id1", "id2"]. Use distritos para agrupar fluxos de trabalho públicos compartilhados por meio de tags para que os usuários possam encontrá-los facilmente. Para obter mais informações, visite a página de ajuda Distritos .
comments (cadeia de caracteres): opcional. Insira seus comentários.
isPublic (booleano): obrigatório. Selecione "true" para fazer com que o fluxo de trabalho fique publicamente disponível. Selecione "false" para fazer com que o fluxo de trabalho seja privado e publicamente indisponível.
isReadyForMigration (booleano): obrigatório. Defina se o fluxo de trabalho está pronto para ser migrado. Para obter mais informações sobre a migração de um ambiente do Server para outro, consulte a página de ajuda Habilitar fluxos de trabalho para migração .
sourceAppId (cadeia de caracteres): opcional. Define o ID de aplicativo de origem de um fluxo de trabalho. Pode ser usado como a referência para "sourceId" para o ponto de extremidade
POST admin/v1/workflows
. Fornecer um sourceAppId preexistente resultará em uma solicitação inválida.othersMayDownload (booleano): obrigatório. Especifique se outros usuários podem baixar este fluxo de trabalho.
othersCanExecute (booleano): obrigatório. Especifique se outros usuários podem executar este fluxo de trabalho.
executionMode (cadeia de caracteres): obrigatório. Os valores aceitos são "Safe" (seguro), "SemiSafe" (semiseguro) e "Standard" (padrão). Para obter mais informações sobre o modo de execução, consulte a página de ajuda Modos de execução seguro e semisseguro: ferramentas, eventos e conectores de dados bloqueados .
hasPrivateDataExemption (booleano): opcional. Forneça uma isenção para permitir que um fluxo de trabalho com dados privados seja executado. Selecione "true" para permitir uma isenção ou "false" para negar uma isenção. Para mais informações, visite a página Opções de fluxo de trabalho na interface do administrador .
workflowCredentialType (cadeia de caracteres): obrigatório. Os valores aceitos são "Default" (padrão), "Required" (obrigatório), and "Specific" (específico).
credentialId (cadeia de caracteres): opcional. Especifique o ID da credencial para este fluxo de trabalho.
collectionIds (cadeia de caracteres): opcional. Insira os IDs das coleções a que este fluxo de trabalho deve ser adicionado. Envie como uma matriz formatada em JSON, por exemplo: ["id1", "id2"].
Carregar uma nova versão de um fluxo de trabalho existente
Para carregar uma nova versão de um fluxo de trabalho existente, use o ponto de extremidade
POST {baseURL}/v3/workflows/{workflowId}/versions
.
Parâmetros
workflowId (cadeia de caracteres): obrigatório. Insira o ID do fluxo de trabalho para o qual você deseja carregar uma nova versão.
file (arquivo): obrigatório. Selecione o arquivo real que deseja carregar no sistema como uma nova versão. O tipo de mídia deve ser um arquivo YXZP.
name (cadeia de caracteres): obrigatório. Insira o nome do fluxo de trabalho. Este é o nome do fluxo de trabalho a ser exibido na IU do Server.
ownerId (cadeia de caracteres): obrigatório. Insira o ID do proprietário.
othersMayDownload (booleano): obrigatório. O padrão é definido como "true".
othersCanExecute (booleano): obrigatório. O padrão é definido como "true".
executionMode (cadeia de caracteres): obrigatório. Os valores aceitos são "Safe" (seguro), "SemiSafe" (semiseguro) e "Standard" (padrão). Para obter mais informações sobre o modo de execução, consulte a página de ajuda Modos de execução seguro e semisseguro: ferramentas, eventos e conectores de dados bloqueados .
hasPrivateDataExemption (booleano): opcional. Forneça uma isenção para permitir que um fluxo de trabalho com dados privados seja executado. Selecione "true" para permitir uma isenção ou "false" para negar uma isenção. Para mais informações, visite a página Opções de fluxo de trabalho na interface do administrador .
comments (cadeia de caracteres): opcional. Insira seus comentários.
makePublished (booleano): obrigatório. O padrão é definido como "true". O parâmetro makePublished é uma maneira de controlar se a nova versão de um fluxo de trabalho que você enviar para o Server deve ser a versão publicada ou não. Você pode definir o valor como "false" quando enviar o fluxo de trabalho para o Server e somente você poderá executá-lo.
workflowCredentialType (cadeia de caracteres): obrigatório. Digite o tipo de credencial a ser usado para este fluxo de trabalho. Os valores aceitos são "Default" (padrão), "Required" (obrigatório), and "Specific" (específico).
credentialId (cadeia de caracteres): opcional. Especifique o ID da credential para este fluxo de trabalho. Para obter mais informações sobre pontos de extremidade de credenciais, vá para Pontos de extremidade de credenciais .
Recuperar todos os fluxos de trabalho
Para obter informações sobre todos os registros de fluxos de trabalho, use o ponto de extremidade
GET {baseURL}/v3/workflows/
.
Parâmetros
view (cadeia de caracteres): opcional. Selecione como deseja exibir as informações dos fluxos de trabalho. Pode ser deixado sem um valor. Você pode selecionar entre os seguintes valores: "Default" (padrão) e "Full" (completo). Se esse parâmetro for definido como "Default", um objeto de visualização reduzido será retornado. Quando não especificado, o valor "Default" é usado.
name (cadeia de caracteres): opcional. Insira o nome do fluxo de trabalho caso deseje filtrar os fluxos pelo nome. Este é o nome do fluxo de trabalho exibido na IU do Server.
ownerId (cadeia de caracteres): opcional. Insira o ID do proprietário caso deseje filtrar os fluxos de trabalho por seu proprietário.
createdAfter (cadeia de caracteres): opcional. Insira a data e a hora após a qual o fluxo de trabalho foi criado. Insira a data e a hora no formato ISO8601 .
createdBefore (cadeia de caracteres): opcional. Insira a data e a hora antes da qual o fluxo de trabalho foi criado. Insira a data e a hora no formato ISO8601 .
Exemplo de solicitação: cURL
curl --location --request GET 'http://localhost/webapi/v3/workflows' \ --header 'Authorization: Bearer token-bearer-aqui'
Recuperar um registro de fluxo de trabalho específico
Para obter informações sobre um fluxo de trabalho específico, use o ponto de extremidade
GET {baseURL}/v3/workflows/{workflowId}
.
Parâmetros
workflowId (cadeia de caracteres): obrigatório. Insira o ID do fluxo de trabalho para obter informações sobre este fluxo de trabalho.
Exemplo de solicitação: cURL
curl --location --request GET 'http://localhost/webapi/v3/workflows/61db393fc565144387d451fb' \ --header 'Authorization: Bearer token-bearer-aqui'
Atualizar um fluxo de trabalho existente
Para alterar informações sobre um fluxo de trabalho existente, use o ponto de extremidade
PUT {baseURL}/v3/workflows/{workflowId}
.
Nota
Para alterar o ID do proprietário (ownerId), o novo proprietário deve estar na mesma assinatura do proprietário atual.
Parâmetros
workflowId (cadeia de caracteres): obrigatório. Insira o ID do fluxo de trabalho que deseja atualizar.
updateWorkflowContract (corpo): obrigatório. Insira as informações do fluxo de trabalho que deseja atualizar.
name (cadeia de caracteres): obrigatório. Insira o nome do fluxo de trabalho. Este é o nome do fluxo de trabalho a ser exibido na IU do Server.
versionId (cadeia de caracteres): obrigatório. Insira o ID da versão.
makePublished (booleano): opcional. Quando não especificado, o valor permanece o mesmo de antes. O parâmetro makePublished é uma maneira de controlar se a nova versão de um fluxo de trabalho que você enviar para o Server deve ser a versão publicada ou não. Você pode definir o valor como "false" quando enviar o fluxo de trabalho para o Server e somente você poderá executá-lo.
ownerId (cadeia de caracteres): obrigatório. Insira o ID do proprietário.
workerTag (cadeia de caracteres): obrigatório. Quando não houver nenhuma tag de trabalhador, use "".
districtTags (cadeia de caracteres): obrigatório. Insira as tags de distrito. Use distritos para agrupar fluxos de trabalho públicos compartilhados por meio de tags para que os usuários possam encontrá-los facilmente. Para obter mais informações, visite a página de ajuda Distritos .
comments (cadeia de caracteres): obrigatório. Insira seus comentários.
isPublic (booleano): opcional. Quando não especificado, o valor permanece o mesmo de antes.
isReadyForMigration (booleano): opcional. Quando não especificado, o valor permanece o mesmo de antes.
othersMayDownload (booleano): opcional. Quando não especificado, o valor permanece o mesmo de antes. Quando definido como "false" para um fluxo de trabalho público, o fluxo não poderá ser utilizado.
othersCanExecute (booleano): opcional. Quando não especificado, o valor permanece o mesmo de antes. Quando definido como "false" para um fluxo de trabalho público, o fluxo não poderá ser utilizado.
executionMode (cadeia de caracteres): opcional. Os valores aceitos são "Safe" (seguro), "SemiSafe" (semiseguro) e "Standard" (padrão). Para obter mais informações sobre o modo de execução, consulte a página de ajuda Modos de execução seguro e semisseguro: ferramentas, eventos e conectores de dados bloqueados .
hasPrivateDataExemption (booleano): opcional. Forneça uma isenção para permitir que um fluxo de trabalho com dados privados seja executado. Selecione "true" para permitir uma isenção ou "false" para negar uma isenção. Quando não especificado, o valor permanece o mesmo de antes. Para mais informações, visite a página Opções de fluxo de trabalho na interface do administrador .
Baixar um pacote de fluxo de trabalho
Para baixar um pacote de fluxo de trabalho, use o ponto de extremidade
GET {baseURL}/v3/workflows/{workflowId}/package
.
Parâmetros
workflowId (cadeia de caracteres): obrigatório. Insira o ID do fluxo de trabalho para o qual deseja baixar o pacote.
versionId (cadeia de caracteres): opcional. Insira o ID da versão específica de um fluxo de trabalho. Se nenhuma versão for fornecida, a versão publicada será baixada.
Nota
Se o versionID tiver dois dígitos, ele pode atingir o limite de tamanho e você pode receber o erro "414 - URI Too Long". Neste caso, analise a cadeia JSON do versionID e corte-a para manter apenas a versão mais recente. Isso manterá o comprimento do campo sob controle.
Exemplo de solicitação: cURL
curl -X GET --header 'Accept: application/octet-stream' --header 'Authorization: Bearer token-bearer-aqui' 'http://localhost/webapi/v3/workflows/635a4be7dc6e24bb8ff0/package'
Recuperar informações de perguntas para um fluxo de trabalho
Para obter informações sobre perguntas para um fluxo de trabalho, use o ponto de extremidade
GET {baseURL}/v3/workflows/{workflowId}/questions
.
Parâmetros
workflowId (cadeia de caracteres): obrigatório. Insira o ID fluxo de trabalho para o qual deseja recuperar as informações.
versionId (cadeia de caracteres): opcional. Insira o ID da versão específica de um fluxo de trabalho. Se nenhuma versão for fornecida, a versão publicada será usada.
Exemplo de solicitação: cURL
curl -X GET --header 'Accept: application/json' --header 'Authorization: Bearer token-bearer-aqui' 'http://localhost/webapi/v3/workflows/635a4bc6e24b78d0b8ff0/questions'
Obter informações sobre tarefas para um fluxo de trabalho específico
Para obter informações sobre tarefas para um fluxo de trabalho específico, use o ponto de extremidade
GET {baseURL}/v3/workflows/{workflowId}/jobs
.
Parâmetros
workflowId (cadeia de caracteres): obrigatório. Insira o ID fluxo de trabalho para o qual deseja recuperar as informações.
sortField (cadeia de caracteres): opcional.
direction (cadeia de caracteres): opcional.
offset (cadeia de caracteres): opcional.
limit (cadeia de caracteres): opcional.
Exemplo de solicitação: cURL
curl -X GET --header 'Accept: application/json' --header 'Authorization: Bearer token-bearer-aqui' 'http://localhost/webapi/v3/workflows/635a4be6e24b78d0b8ff0/jobs'
Excluir fluxo de trabalho
Para excluir um fluxo de trabalho específico, use o ponto de extremidade
DELETE {baseURL}/v3/workflows/{workflowId}
.
Parâmetros
workflowId (cadeia de caracteres): obrigatório. Insira o ID do fluxo de trabalho a ser excluído.
force (booleano): opcional. Quando não selecionado, o valor padrão é "false". Se um fluxo de trabalho estiver agendado, definir o parâmetro como "true" excluirá todos os agendamentos antes de excluí-lo.
Exemplo de solicitação: cURL
curl -X DELETE --header 'Accept: application/json' --header 'Authorization: Bearer token-bearer-aqui' 'http://localhost/webapi/v3/workflows/635a752fdc6e278d0ba40b'
Criar um novo trabalho
Para criar um novo trabalho e adicioná-lo à fila, use o ponto de extremidade
POST /v3/workflows/{workflowId}/jobs
.
Parâmetros
workflowId (cadeia de caracteres): obrigatório. Insira um ID de fluxo de trabalho que você deseja agendar.
contract (corpo): para criar um novo trabalho, especifique os seguintes parâmetros:
workerTag (cadeia de caracteres): opcional. Especifique o trabalhador atribuído. Se não for especificado, o valor será "none" (nenhum).
credentialId (cadeia de caracteres): opcional. Especifique o ID da credential para este fluxo de trabalho.
questions (cadeia de caracteres): opcional. Para um aplicativo analítico, especifique as perguntas e respostas para executar o fluxo de trabalho.
priority (cadeia de caracteres): opcional. Especifique a prioridade para a execução do agendamento. Escolha entre as seguintes opções: "Low" (baixa), "Medium" (média), "High" (alta) e "Critical" (crítica). Se não for especificado, o valor padrão será "Low" (baixa).
EXEMPLO DE SOLICITAÇÃO: cURL
Exemplo de uma solicitação para criar um trabalho:
curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: Bearer BearerTokenGoesHere' -d '{ \ "workerTag": "", \ "credentialId": "", \ "questions": [], \ "priority": "Low" \ }' 'http://localhost/webapi/v3/workflows/651faa8bde3e5381fd0dac29/jobs'{ "workerTag": "tag1", "credentialId": "652e6f90ea174cd34f6779d2", "questions": [ { "name": "Drop_Down", "value": "true" } ], "priority": "Low"}
Relações de objetos
Se você estiver carregando um fluxo de trabalho, você pode usar objetos criados da seguinte maneira:
Objeto criado: " workflowId " (for example, "id": "7917969784f84bd09442f66996ecb8f3")
Você pode usá-lo como:
workflowId se você estiver adicionando fluxos de trabalho a uma coleção .
appId se você estiver removendo o fluxos de trabalho de uma coleção .
workflowId se você estiver procurando um fluxo de trabalho específico .
workflowId se você estiver excluindo um fluxo de trabalho específico .
workflowId se você estiver atualizando um fluxo de trabalho existente .
workflowId se você estiver carregando uma nova versão de um fluxo de trabalho existente .
workflowId se você estiver procurando um agendamento .
workflowId se você estiver criando um agendamento .
workflowId se você estiver fazendo download de um pacote de fluxo de trabalho .
workflowId se você deseja recuperar informações de perguntas para um fluxo de trabalho .
workflowId se quiser obter informações sobre trabalhos para um fluxo de trabalho .
Exemplos de solicitações Postman
GET /v3/workflows/{workflowId}
Para saber mais sobre solicitações Postman, visite a página de ajuda Como usar Postman .