Pontos de extremidade de fluxos de trabalho
Pontos de extremidade de fluxos de trabalho e parâmetros
Carregar um novo fluxo de trabalho
Carregar uma nova versão de um fluxo de trabalho existente
Recuperar todos os fluxos de trabalho
Recuperar um registro de fluxo de trabalho específico
Atualizar um fluxo de trabalho existente
Para saber mais sobre as relações de objetos e como usá-las na API, vá para a seção Relações de objetos .
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): obrigatório. Insira seus comentários.
isPublic (booleano): obrigatório. Selecione se o fluxo de trabalho estará disponível publicamente.
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): obrigatório.
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 obter mais informações, visite a página Opções de fluxo de trabalho na interface do administrador .
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): opcional. Selecione o arquivo 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 obter mais informações, visite a página Opções de fluxo de trabalho na interface do administrador .
comments (cadeia de caracteres): obrigatório. 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.
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 carregar uma nova versão de 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 obter mais informações, visite a página Opções de fluxo de trabalho na interface do administrador .
Excluir um 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" (falso). Se um fluxo de trabalho estiver agendado, definir o parâmetro como "true" excluirá todos os agendamentos antes de excluí-lo.
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 estiver adicionando fluxos de trabalho a uma coleção .
appId se estiver removendo fluxos de trabalho de uma coleção .
workflowId se estiver procurando um fluxo de trabalho específico .
workflowId se estiver excluindo um fluxo de trabalho específico .
workflowId se estiver atualizando um fluxo de trabalho existente .
workflowId se estiver atualizando uma nova versão de um fluxo de trabalho existente .
workflowId se estiver procurando um agendamento .
workflowId se estiver criando um agendamento .
Exemplos de solicitações Postman
GET /v3/workflows/{workflowId}