Árvore de páginas

Versões comparadas

Chave

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

...

O componente Atividade de serviço representa um ponto do processo onde será feita uma consulta aos dados de um serviço externo repassando esses dados para o processo.

A principal característica desse componente é sua capacidade de automatizar a execução de tarefas, facilitando a integração com sistemas externos e promovendo a eficiência do processo.

Ao configurar esse componente, é necessário selecionar um serviço já cadastrado na plataforma e editar um script JavaScript que fará o acesso aos métodos e dados desse serviço.

...

Painel
borderColor#f2f2f2
bgColor#f2f2f2

Título
Nome da etapa que representa uma consulta de dados 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 Xxxxxxx, o componente poderia receber o nome Xxxxxxxx.

Selecione o serviço
Serviço que será utilizado para fazer a consulta de dados. É possível selecionar serviços do tipo SOAP que já existem no recurso Serviços do Painel de controle.

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

  • Automatizado: a consulta aos dados é 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 consulta aos dados é 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 o script 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 do script de consulta ao serviço.

03. Xxxxxxxxxxxxxx Clique em Configurar integração.

04. Xxxxxxxxxxx

05. Xxxxxxxxxxx

...

Xxxxxxxxxxxxxx

Section

Painel
borderColor#ebecf0

Toggle Cloak
id@saiba-mais-1

Xxxxxxxxxxxxxx

Quando se deve usar uma atividade de serviço?

Xxxxxxxxxxxxx

Cloak
id@saiba-mais-1
Painel
borderColor#ebecf0
Toggle Cloak
id@saiba-mais-2
Xxxxxxxxxxxxxxx?
Cloak
id@saiba-mais-2

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

Xxxxxxxxxxxxxxx

?

Cloak
id@saiba-mais-3

Xxxxxxxxxxx


Uma atividade de serviço pode gerar falhas, como a não obtenção de uma resposta de um serviço ou falha em um processo de automação. Essas falhas podem ser tratadas com mecanismos de exceção dentro do próprio BPMN, como eventos de erro (Error Event), que permitem que o processo seja redirecionado para um fluxo alternativo ou que ações corretivas sejam executadas.

Painel
borderColor#ebecf0

Toggle Cloak
id@saiba-mais-4
Xxxxxxxxxxxx?

Cloak
id@saiba-mais-4

Xxxxxxxxxxxx

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 Cloak
id@saiba-mais-7
Xxxxxxxxxxxx?

Cloak
id@saiba-mais-7

Xxxxxxxxxxxxx

...