Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Informações
titleNota:

Atualmente, o tipo de execução imediata não é muito recomendado por ter seu desempenho reduzidosreduzido.


Headers 
Âncora
headers
headers

...

Painel
borderColor#f2f2f2
bgColor#f2f2f2

Título
Nome da etapa que representa a execução de um serviço externo. O nome também pode ser alterado diretamente no componente, clicando sobre seu nome atual e depois em Editar– localizado no lado direito.

Painel
borderColor#ebecf0

Estado
subtletrue
titleExemplo de uso

Em um processo de Aprovação de contrato, o componente poderia receber o nome Criar pasta, visto que ele servirá para criar uma pasta específica para armazenar esse contrato no recurso Documentos.

Selecione o serviço
Serviço externo que será utilizado para executar alguma ação. É possível selecionar serviços do tipo Rest que já existem no recurso Serviços do Painel de controle.

Tipo de execução
Forma como a requisição do serviço externo será executada. As opções disponíveis são:

  • Automatizado: a requisição é executada de forma assíncrona. Deve ser utilizado quando a execução não necessita de um retorno imediato sobre a operação ter sido ou não executada com êxito;
  • Imediato: a requisição é executada de forma síncrona. Deve ser utilizado quando a execução necessita de um retorno imediato sobre a operação para que o processo possa seguir adiante.
Dica
titleDica!

Saiba mais sobre os tipos de execução em Integração assíncrona via processos workflow.


Tentativas
Número de vezes que o componente deve tentar executar a operação do serviço antes que seja encaminhado para o evento intermediário de captura de erro. Esse campo somente é exibido ao selecionar o tipo de execução Automatizado.

A cada
Intervalo que o componente deve considerar entre uma tentativa e outra de execução. Esse campo somente é exibido ao selecionar o tipo de execução Automatizado.

Frequência
Unidade de tempo que o componente deve considerar para fazer os intervalos e as tentativas de execução. Esse campo somente é exibido ao selecionar o tipo de execução Automatizado. As opções disponíveis são:

  • Minuto;
  • Hora;
  • Dia.
Painel
borderColor#ebecf0

Estado
subtletrue
titleExemplo de configuração de tentativas

→ O componente deve tentar executar o script por 10 vezes, tentando 1 vez  a cada hora. Sendo assim, a configuração deve ser feita como:

TentativasA cadaFrequência
101Hora

Mensagem
Mensagem que será exibida na conclusão da execução da operação do serviço.

...

Xxxxxxxxxxxx

Section
Painel
borderColor#ebecf0

Toggle Cloak
id@saiba-mais-1
Quando se deve usar uma atividade de serviço?

Cloak
id@saiba-mais-1

A atividade de serviço é indicada quando o processo depende de dados externos oriundos de uma ação automatizada que pode ser executada sem a necessidade de interação direta de uma pessoa, tais como uma consulta a um banco de dados, uma chamada a uma API externa ou um cálculo automatizado.

Painel
borderColor#ebecf0

Toggle Cloak
id@saiba-mais-2
Qual é a diferença da atividade de serviço e o evento de mensagem?

Cloak
id@saiba-mais-2

A principal diferença entre esses dois componentes é o papel de cada um. Enquanto a atividade de serviço executa uma ação específica – como uma consulta a um sistema externos – o evento de mensagem envia ou recebe uma mensagem durante o andamento do processo, o que pode desencadear uma ação em outro processo ou sistema.

Sendo assim, pode-se dizer que o evento de mensagem é mais voltado para a comunicação entre processos ou sistemas e a atividade de serviço tem como objetivo automatizar uma ação dentro do processo.

Painel
borderColor#ebecf0

Toggle Cloak
id@saiba-mais-3
 O que acontece se uma atividade de serviço falhar ou gerar um erro?

Cloak
id@saiba-mais-3

Se a atividade de serviço foi configurada com a execução automatizada, é obrigatório que ela contenha um evento intermediário de captura de erro e um fluxo alternativo para onde a solicitação será direcionada em caso de falhas. Desta forma, quando a execução da atividade de serviço falhar, a solicitação será direcionada para o evento de captura de erro e, posteriormente, para o fluxo alternativo que direciona para uma etapa de tratamento da falha. Depois que a falha for solucionada, a solicitação volta para a atividade de serviço de origem e, assim que ela for executada com sucesso, segue o fluxo principal de saída.

Se a atividade de serviço foi configurada com a execução imediata, quando o script for executado com sucesso, a solicitação é enviada imediatamente da atividade de serviço para a próxima etapa, dando continuidade ao fluxo de saída padrão. Porém, se ocorrer alguma inconsistência, ela apenas retornará a inconsistência encontrada, mantendo a solicitação parada até que uma pessoa interaja na solicitação para averiguar e corrigir as inconsistências que ocorreram.

Painel
borderColor#ebecf0
Toggle Cloak
id@saiba-mais-4
Xxxxxxxxxxxx?
Cloak
id@saiba-mais-4
Painel
borderColor#ebecf0
Toggle Cloak
id@saiba-mais-5
 Xxxxxxxxxxxx? Cloak
id@saiba-mais-5

Xxxxxxxxxxxxxx

Painel
borderColor#ebecf0

Toggle Cloak
id@saiba-mais-6
 Xxxxxxxxxxxxx?

Cloak
id@saiba-mais-6

Xxxxxxxxxxxxxxx

Painel
borderColor#ebecf0
Toggle Cloakid@saiba-mais-7

Xxxxxxxxxxxx? Cloak
id@saiba-mais-7

Xxxxxxxxxxxxx

Informações
titleFique atento!

Esta documentação é válida a partir da atualização 9.9.9 – Xxxxxxx Voyager (2.0). Se você utiliza uma atualização anterior, ela pode conter informações diferentes das quais você vê na sua plataforma.

...