...

Falando de componente Atividade de serviço...Image Modified

...

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.

...

Esse componente permite utilizar dois tipos de execução da consulta aos dados do serviço externo: a execução Automatizada e a execução Imediata, que são detalhadas a seguir.

** imagem**

Execução automatizada

A execução automatizada determina que a execução do script será feita de forma assíncrona e sem a necessidade de uma interação manual de uma pessoa. Nesse tipo de execução, é possível definir o número de tentativas de execução e uma mensagem de sucesso que será exibida quando a execução for concluída sem inconsistências.

Quando a solicitação chega em uma atividade de serviço com execução automatizada, ela fica parada nesse ponto até que o scritp seja executado com sucesso ou até que ele seja executado o número de vezes definido como tentativas de execução.

Se o script for executado com sucesso, a atividade de serviço é considerada concluída e a solicitação segue o seu fluxo de saída padrão. Porém, se o número de tentativas for atingido sem que haja uma execução do script com sucesso, a solicitação é movimentada para o evento intermediário de captura de erro que, por sua vez, movimentará a solicitação para o fluxo correspondente à etapa de tratamento do erro.

Em atividades de serviço com a forma de execução automatizada, é obrigatório o uso do evento intermediário de captura de erro anexado a ela, bem como um fluxo de saída deste evento, para permitir que o processo seja desviado quando o script de integração não for executado com sucesso em nenhuma das tentativas feitas.

O script da próxima execução – depois de uma execução com inconsistência – pode receber a quantidade de tentativas de execução e a mensagem da última execução como parâmetros, podendo ser utilizados dentro do script. Dessa forma, o script ficaria conforme o exemplo abaixo:

Image Added

function servicetask9(attempt, message) {
	
	//Variáveis globais com os dados do formulário
	var FOLDER_NAME = hAPI.getCardValue("txtFolderName");
	var PARENT_FOLDER_CODE = hAPI.getCardValue("txtFolderCode");
	var GROUP_CODE

 = hAPI.getCardValue("

txtGroupCode");

	var INHERIT_SECURITY = hAPI.getCardValue("cbxInheritSecurity") ==

 "

Tanto a mensagem de sucesso quanto as mensagens de inconsistências são salvas no histórico da solicitação como complementos, podendo ser vistas por quem tiver acesso à solicitação.

...

O fluxo de contingência é criado anexando um evento intermediário de captura de erro à atividade de serviço (o evento deve ser colocado em cima da atividade). Esse fluxo de saída será utilizando quando todas as tentativas de integração falharem.

** imagem de uma modelagem básica de uma tarefa de serviço do tipo Automática. **

...

...

Execução imediata

A execução imediata determina que a execução do script será feita de forma síncrona, logo depois do evento afterStateEntry do processo em questão, ou seja, será executado no momento em que a solicitação chegar na atividade de serviço.

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, esta forma de execução 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.

Esse é um exemplo de código para iniciar a integração com o serviço configurado no componente:

try {
    var Service = ServiceManager.getService('rm');
    var serviceHelper = Service.getBean();
    var serviceLocator = serviceHelper.instantiate('classe.locator');
} catch(erro) {
    log.error(erro);
}

...

Desta forma, quando a última etapa de aprovação for concluída, a solicitação seguirá para uma atividade de serviço que, utilizando as APIs da plataforma, criará a pasta no recurso Documentos com base nas informações fornecidas e nas permissões de acesso definidas no formulário, garantindo que a pasta será única para cada contrato.

Um exemplo de código que poderia ser utilizado como script na atividade de serviço é:

function servicetask9(attempt, message) {
	
	//Variáveis globais com os dados do formulário
	var FOLDER_NAME = hAPI.getCardValue("txtFolderName");
	var PARENT_FOLDER_CODE = hAPI.getCardValue("txtFolderCode");
	var GROUP_CODE = hAPI.getCardValue("txtGroupCode");
	var INHERIT_SECURITY = hAPI.getCardValue("cbxInheritSecurity") == "true";
	
	//Tipo de documento pasta
	var DOCUMENT_TYPE_FOLDER = "1";
	
	//Usuário logado
	var USER_LOGGED = getValue("WKUser");
	
	//Número da solicitação para comentário uso na descrição da pasta criada
	var REQUEST_NUMBER = getValue("WKNumProces");
	
	// Descrição da pasta criada
	var ADDITIONAL_COMMENTS = "This folder was created automatically from fluig BPM - request ";
	
	//Atribuições de segurança
	var USER_ATTRIBUTION_TYPE = 1;
	var GROUP_ATTRIBUTION_TYPE = 2;
	var ALL_USER_ATTRIBUTION_TYPE = 3; 
	
	//Níveis de segurança
	var READING = 0;
	var RECORDING = 1;
	var MODIFICATION = 2;
	var ALL = 3;
	
    try {
    	
    	//Instancia um novo documento e define as propriedades básicas
    	var dto = docAPI.newDocumentDtotrue";
	
	//Tipo de documento pasta
	var DOCUMENT_TYPE_FOLDER = "1";
	
	//Usuário logado
	var USER_LOGGED = getValue("WKUser");
	
	//Número da solicitação para comentário uso na descrição da pasta criada
	var REQUEST_NUMBER = getValue("WKNumProces");
	
	// Descrição da pasta criada
	var ADDITIONAL_COMMENTS = "This folder was created automatically from fluig BPM - request ";
	
	//Atribuições de segurança
	var USER_ATTRIBUTION_TYPE = 1;
	var GROUP_ATTRIBUTION_TYPE = 2;
	var ALL_USER_ATTRIBUTION_TYPE = 3; 
	
	//Níveis de segurança
	var READING = 0;
	var RECORDING = 1;
	var MODIFICATION = 2;
	var ALL = 3;
	
    try {
    	
    	//Instancia um novo documento e define as propriedades básicas
    	var dto = docAPI.newDocumentDto();
        dto.setDocumentDescription(FOLDER_NAME);
        dto.setAdditionalComments(ADDITIONAL_COMMENTS + REQUEST_NUMBER);
        dto.setDocumentType(DOCUMENT_TYPE_FOLDER);
        dto.setParentDocumentId(parseInt(PARENT_FOLDER_CODE));
        dto.setInheritSecurity(INHERIT_SECURITY);
        
        /*
         Como é possível definir várias permissões, é necessário criar um array com todas as permissões
         que serão aplicadas. Cada item do array é uma permissão ou restrição
        */
        var dtosSecurity = new Array();
        
        //Definindo permissão total para grupo
        var dtoGroupSecurity = docAPI.newDocumentSecurityConfigDto();
        dtoGroupSecurity.setAttributionType(GROUP_ATTRIBUTION_TYPE);
        dtoGroupSecurity.setAttributionValue(GROUP_CODE);
        dtoGroupSecurity.setPermission(true);
        dtoGroupSecurity.setShowContent(true);
        dtoGroupSecurity.setSecurityLevel(ALL);

        //Definindo permissão total para usuário
        var dtoUserSecurity = docAPI.newDocumentSecurityConfigDto();
        dtoUserSecurity.setAttributionType(USER_ATTRIBUTION_TYPE);
        dtoUserSecurity.setAttributionValue(USER_LOGGED);
        dtoUserSecurity.setPermission(true);
        dtoUserSecurity.setShowContent(true);
        dtoUserSecurity.setSecurityLevel(ALL);
        
      //Definindo permissão de modificação para todos os usuários
        var dtoAllUsersSecurity = docAPI.newDocumentSecurityConfigDto();
        dtodtoAllUsersSecurity.setDocumentDescription(FOLDER_NAMEsetAttributionType(ALL_USER_ATTRIBUTION_TYPE);
        dtodtoAllUsersSecurity.setAdditionalComments(ADDITIONAL_COMMENTS + REQUEST_NUMBER);setAttributionValue(""); //Para todos os usuários deve-se passar vazio 
        dtodtoAllUsersSecurity.setDocumentType(DOCUMENT_TYPE_FOLDERsetPermission(true);
        dtodtoAllUsersSecurity.setParentDocumentId(parseInt(PARENT_FOLDER_CODE))setShowContent(true);
        dtodtoAllUsersSecurity.setInheritSecuritysetSecurityLevel(INHERIT_SECURITYMODIFICATION);

      //Definindo restrição para usuário
        /*var dtoGroupRestrictionSecurity = docAPI.newDocumentSecurityConfigDto();
         Como é possível definir várias permissões, é necessário criar um array com todas as permissõesdtoGroupRestrictionSecurity.setAttributionType(GROUP_ATTRIBUTION_TYPE);
        dtoGroupRestrictionSecurity.setAttributionValue(GROUP_CODE);
         que serão aplicadas. Cada item do array é uma permissão ou restriçãodtoGroupRestrictionSecurity.setPermission(false);
        */dtoGroupRestrictionSecurity.setShowContent(true);
        var dtosSecurity = new Array(dtoGroupRestrictionSecurity.setSecurityLevel(MODIFICATION);
        
        //Definindo restrição permissãopara totaltodos paraos grupousuários
        var dtoGroupSecuritydtoAllUsersRestrictionSecurity = docAPI.newDocumentSecurityConfigDto();
        dtoGroupSecuritydtoAllUsersRestrictionSecurity.setAttributionType(GROUPALL_USER_ATTRIBUTION_TYPE);
        dtoGroupSecuritydtoAllUsersRestrictionSecurity.setAttributionValue(GROUP_CODE"");
        dtoGroupSecuritydtoAllUsersRestrictionSecurity.setPermission(true);
        dtoGroupSecuritydtoAllUsersRestrictionSecurity.setShowContent(true);
        dtoGroupSecuritydtoAllUsersRestrictionSecurity.setSecurityLevel(ALLRECORDING);

        //Definindo permissão
 total para usuário
     //Adicionando permissões no vararray dtoUserSecurity = docAPI.newDocumentSecurityConfigDto();de segurança
        dtoUserSecuritydtosSecurity.setAttributionType(USER_ATTRIBUTION_TYPEpush(dtoGroupSecurity);
        dtoUserSecurity.setAttributionValue(USER_LOGGED);
        dtoUserSecuritydtosSecurity.setPermissionpush(truedtoUserSecurity);
        dtoUserSecuritydtosSecurity.setShowContentpush(truedtoAllUsersSecurity);

        dtoUserSecurity.setSecurityLevel(ALL);
   //Adicionando restrições no array de segurança
        dtosSecurity.push(dtoGroupRestrictionSecurity);
      //Definindo permissão de modificação para todos os usuários  dtosSecurity.push(dtoAllUsersRestrictionSecurity);
       
        var dtoAllUsersSecurityFOLDER = docAPI.newDocumentSecurityConfigDto(createFolder(dto, dtosSecurity, null);
        dtoAllUsersSecuritylog.setAttributionType(ALL_USER_ATTRIBUTION_TYPE);
        dtoAllUsersSecurity.setAttributionValue(""); //Para todos os usuários deve-se passar vazioinfo("Folder successfully createad: ID :" + FOLDER.getDocumentId());
        
    }   catch dtoAllUsersSecurity.setPermission(truee);
        dtoAllUsersSecurity.setShowContent(true); {
        dtoAllUsersSecuritylog.setSecurityLevel(MODIFICATION);

      //Definindo restrição para usuário
        var dtoGroupRestrictionSecurity = docAPI.newDocumentSecurityConfigDto(error("Could not create folder: \n" + e);
        dtoGroupRestrictionSecurity.setAttributionType(GROUP_ATTRIBUTION_TYPE);
        dtoGroupRestrictionSecurity.setAttributionValue(GROUP_CODE);
        dtoGroupRestrictionSecurity.setPermission(false);
        dtoGroupRestrictionSecurity.setShowContent(true);
        dtoGroupRestrictionSecurity.setSecurityLevel(MODIFICATION);
        
        //Definindo restrição para todos os usuários
        var dtoAllUsersRestrictionSecurity = docAPI.newDocumentSecurityConfigDto();
        dtoAllUsersRestrictionSecurity.setAttributionType(ALL_USER_ATTRIBUTION_TYPE);
        dtoAllUsersRestrictionSecurity.setAttributionValue("");
        dtoAllUsersRestrictionSecurity.setPermission(true);
        dtoAllUsersRestrictionSecurity.setShowContent(true);
        dtoAllUsersRestrictionSecurity.setSecurityLevel(RECORDING);
        
        //Adicionando permissões no array de segurança
        dtosSecurity.push(dtoGroupSecurity);        
        dtosSecurity.push(dtoUserSecurity);
        dtosSecurity.push(dtoAllUsersSecurity);

        //Adicionando restrições no array de segurança
        dtosSecurity.push(dtoGroupRestrictionSecurity);
        dtosSecurity.push(dtoAllUsersRestrictionSecurity);
       
        var FOLDER = docAPI.createFolder(dto, dtosSecurity, null);
        log.info("Folder successfully createad: ID :" + FOLDER.getDocumentId());
        
    } catch (e) {
        log.error("Could not create folder: \n" + e);
    }	
}

** imagem **

Configurar componente Atividade de serviço – Rest

01. No diagrama do processo, clique no componente Atividade de serviço Image Removed que deseja configurar com um serviço do tipo Rest.

02. Na aba Geral, defina as informações gerais para o componente que representa uma consulta de dados de um serviço externo.

...

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 EditarImage Removed– localizado no lado direito.

...

...

Selecione o serviço
Serviço que será utilizado para fazer a consulta de dados. É 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 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
  title Dica!
  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.

}	
}

Execução automatizada

...

A execução automatizada determina que a execução do script será feita de forma assíncrona e sem a necessidade de uma interação manual de uma pessoa. Nesse tipo de execução, é possível definir o número de tentativas de execução e uma mensagem de sucesso que será exibida quando a execução for concluída sem inconsistências.

Quando a solicitação chega em uma atividade de serviço com execução automatizada, ela fica parada nesse ponto até que o scritp seja executado com sucesso ou até que ele seja executado o número de vezes definido como tentativas de execução.

Se o script for executado com sucesso, a atividade de serviço é considerada concluída e a solicitação segue o seu fluxo de saída padrão. Porém, se o número de tentativas for atingido sem que haja uma execução do script com sucesso, a solicitação é movimentada para o evento intermediário de captura de erro que, por sua vez, movimentará a solicitação para o fluxo correspondente à etapa de tratamento do erro.

Em atividades de serviço com a forma de execução automatizada, é obrigatório o uso do evento intermediário de captura de erro anexado a ela, bem como um fluxo de saída deste evento, para permitir que o processo seja desviado quando o script de integração não for executado com sucesso em nenhuma das tentativas feitas.

O script da próxima execução – depois de uma execução com inconsistência – pode receber a quantidade de tentativas de execução e a mensagem da última execução como parâmetros, podendo ser utilizados dentro do script. Dessa forma, o script ficaria conforme o exemplo abaixo:

function servicetask9(attempt, message) {
    log.info("Exemplo servicetask");
    var a = hAPI.getCardValue("campo_no_formulario");
    if (a == "1") {
        return true;
    } else {
        throw "Exemplo de Erro";
    }
}

Tanto a mensagem de sucesso quanto as mensagens de inconsistências são salvas no histórico da solicitação como complementos, podendo ser vistas por quem tiver acesso à solicitação.

O fluxo de contingência é criado anexando um evento intermediário de captura de erro à atividade de serviço (o evento deve ser colocado em cima da atividade). Esse fluxo de saída será utilizando quando todas as tentativas de integração falharem.

Execução imediata

...

A execução imediata determina que a execução do script será feita de forma síncrona, logo depois do evento afterStateEntry do processo em questão, ou seja, será executado no momento em que a solicitação chegar na atividade de serviço.

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, esta forma de execução 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.

Esse é um exemplo de código para iniciar a integração com o serviço configurado no componente:

try {
    var Service = ServiceManager.getService('rm');
    var serviceHelper = Service.getBean();
    var serviceLocator = serviceHelper.instantiate('classe.locator');
} catch(erro) {
    log.error(erro);
}

Headers 

Âncora
headers headers

...

No contexto do componente Atividade de serviço, os headers (cabeçalhos) representam informações adicionais ou metadados que são enviados junto com a requisição de um serviço. Eles são usados para fornecer contexto ou parâmetros extras que o serviço ou a operação que está sendo chamada pode precisar para processar a requisição.

Os headers são frequentemente usados em chamadas de APIs REST ou SOAP e permitem adicionar informações cruciais para a comunicação entre sistemas. Cada chave/valor tem um propósito específico e a definição correta desses headers pode ser fundamental para o sucesso da integração com o serviço. Eles permitem personalizar ou configurar as requisições e, muitas vezes, podem ser obrigatórios para que o serviço funcione corretamente.

Esses headers podem ser usados para várias finalidades, dependendo do tipo de serviço e da operação. Alguns exemplos comuns de headers são:

• Autenticação e autorização: pode ser um token de autenticação, uma chave de API ou credenciais de um usuário.

  Painel
  borderColor #ebecf0
  Estado subtle true title Exemplo Chave: Authorization Valor: Bearer token_de_acesso

• Informações de rastreio: dados sobre a requisição que podem ser usados para monitoramento ou rastreamento da chamada do serviço.

  Painel
  borderColor #ebecf0
  Estado subtle true title Exemplo Chave: X-Request-ID Valor: 12345

• Informações de contexto: dados que definem o contexto da requisição, tais como o idioma, a localidade ou a versão da API.

  Painel
  borderColor #ebecf0
  Estado subtle true title Exemplo

...

Mensagem
Mensagem que será exibida na conclusão da execução do script de consulta ao serviço.

• Chave: Accept-Language Valor: pt-BR

• Formato dos dados: definição sobre como os dados devem ser interpretados ou enviados, como o tipo de conteúdo (Content-Type) ou a versão da API.

  Painel
  borderColor #ebecf0
  Estado subtle true title Exemplo Chave: Content-Type Valor: application/json

Parâmetros

Âncora
parametros parametros

...

No contexto do componente Atividade de serviço, os parâmetros são valores ou variáveis que o método/operação precisa receber para funcionar corretamente. Cada método/operação de um serviço geralmente tem uma lista de parâmetros que precisam ser fornecidos para que a execução da ação seja bem-sucedida. Sendo assim, o objetivo de configurar esses parâmetros é fornecer as informações necessárias para que o método/operação seja executado.

Esses parâmetros podem ser de diversos tipos, como números, textos, datas ou até mesmo objetos, que são uma estrutura de dados mais complexa.

Além de fornecer os dados essenciais para a execução do método/operação, outros objetivos da configuração dos parâmetros podem envolver:

• a definição do contexto da execução: os parâmetros podem determinar o contexto no qual a operação será executada.

  Painel
  borderColor #ebecf0
  Estado subtle true title Exemplo Um parâmetro de "idioma" pode ser usado para alterar o idioma de uma resposta ou para personalizar a resposta do serviço com base na localização do usuário.

• a comunicação eficiente entre sistemas: quando diferentes sistemas estão interagindo, é essencial que os parâmetros estejam corretamente configurados para que a comunicação e o entendimento entre eles se estabeleça corretamente.

  Painel
  borderColor #ebecf0
  Estado subtle true title Exemplo Se um serviço externo precisa de um código de produto para retornar informações sobre ele, esse código precisa ser passado corretamente como um parâmetro.

• o mapeamento de dados: permite mapear valores provenientes de outras etapas do processo.

  Painel
  borderColor #ebecf0
  Estado subtle true title Exemplo Um parâmetro pode ser alimentado com o valor presente no formulário do processo preenchido em uma etapa anterior, como um número de pedido ou o ID de um cliente.

Por isso, a configuração dos parâmetros do método/operação é essencial para a correta execução da ação e comunicação entre os sistemas envolvidos.

Retorno

Âncora
retorno retorno

...

No contexto do componente Atividade de serviço, o retorno são os dados que a operação retorna depois de ser executada. Ao chamar um método/operação dentro de uma atividade de serviço, em muitos casos, a operação não só executa uma ação, mas também retorna um ou mais valores que podem ser usados em outras partes do processo. Esse retorno pode ser uma resposta simples – como um código de status ou uma mensagem – ou dados mais complexos – como um objeto JSON, uma lista ou um valor calculado.

Quando o método/operação é chamado, ele processa os dados de entrada, que são os parâmetros. Durante sua execução, o método/operação pode realizar cálculos, consultas a um banco de dados ou algum outro processamento de dados. Depois de processar os parâmetros e realizar suas funções internas, o serviço gera um retorno. Esse retorno pode ser algo simples – como um código de sucesso – ou pode ser um conjunto de dados mais complexo – como o resultado de uma busca ou a confirmação de que uma ação foi realizada.

O retorno do serviço pode ser utilizado de várias formas no processo:

• de forma condicional: se o retorno for um código de status que indica sucesso ou falha, por exemplo, é possível direcionar o fluxo para diferentes caminhos dependendo do valor desse retorno;

• como entrada para outras etapas: pode "alimentar" outra etapa do processo, como o ID de um pedido retornado por um serviço Criar pedido, que pode ser passado para uma etapa/atividade Enviar notificação;

• ser armazenado para uso futuro: pode ser armazenado em variáveis ou campos de formulário para ser utilizado em uma fase posterior, como um ID de usuário gerado após sua criação.

Alguns exemplos de retorno de uma operação são:

• criação de um registro:

  Painel
  borderColor #ebecf0
  Estado subtle true title Exemplo Ao chamar um método/operação para criar o cadastro de um novo usuário, o retorno pode ser o identificador (ID) do usuário gerado pelo sistema. Retorno da execução: 78956

• resposta de sucesso ou falha:

  Painel
  borderColor #ebecf0
  Estado subtle true title Exemplo Em operações simples, o retorno pode ser apenas um status – como sucesso ou falha – ou um código que indica o resultado da execução. Retorno da execução: sucesso

• dados complexos:

  Painel
  borderColor #ebecf0
  Estado subtle true title Exemplo Se o objetivo de uma operação é buscar informações de um usuário, o retorno pode ser um objeto complexo com vários campos. Retorno da execução: { "id": 12345, "nome": "Alonso da Cunha", "email": "[email protected]" }

• valor calculado:

  Painel
  borderColor #ebecf0
  Estado subtle true title Exemplo Uma operação pode realizar cálculos e retornar um valor como resultado, como o preço final de um pedido com base em itens, descontos e impostos, onde o retorno pode ser o valor total. Retorno da execução: 5000

Dessa forma, o retorno de uma operação é essencial para capturar os resultados de um serviço e usá-los de maneira eficaz dentro do fluxo do processo. Ele pode ser utilizado para tomar decisões, realizar ações subsequentes ou simplesmente para fornecer informações úteis para a continuação do processo.

Configurar componente Atividade de serviço – REST

Âncora
rest rest

...

01. No diagrama do processo, clique no componente Atividade de serviço Image Added que deseja configurar com um serviço do tipo REST.

02. Na aba Geral, defina as informações gerais para o componente que representa a execução de um serviço externo.

03. Clique em Configurar integração.

04. Na aba Geral, defina as informações solicitadas para configurar a execução do serviço. 

05. Em Header, clique em Adicionar header para adicionar informações adicionais à requisição do serviço.

06. Informe os dados necessários para cada header.

07. Clique na aba Parâmetros para configurar os parâmetros do método/operação do serviço. 

08. Na coluna Origem do valor de cada parâmetro, selecione de onde será obtido o valor que será passado para esse parâmetro do método/operação.

09. Na coluna Valor de cada parâmetro, selecione ou insira o valor que será passado de acordo com a origem selecionada.

10. Se um dos parâmetros for do tipo objeto, na coluna Ação, clique em Editar objeto Image Added para configurar os parâmetros do objeto.

11. Ao finalizar a configuração dos parâmetros do objeto, clique em Salvar, para voltar para a aba Parâmetros.

12. Se um dos parâmetros for do tipo lista, na coluna Ação, clique em Adicionar via lista Image Added para adicionar os valores para os parâmetros da lista.

13. Clique em Adicionar valor Image Added.

14. Ao finalizar a configuração dos parâmetros da lista, clique em Salvar, para voltar para a aba Parâmetros.

15. Para os tipos de parâmetros Objeto ou Map, é possível adicionar atributos clicando em Adicionar atributos Image Added – localizado ao lado do parâmetro.

16. Clique em Adicionar atributos Image Added.

17. Na coluna Chave, insira uma chave para identificar o atributo.

18. Na coluna Atribuição, selecione como será a atribuição de valor para o atributo.

19. Na coluna Valor, selecione ou insira o valor para o atributo de acordo com a origem selecionada.

20. Ao finalizar a configuração dos atributos, clique em Salvar até voltar para a aba Parâmetros.

21. Clique na aba Retorno para configurar o destino dos dados retornados pelo método/operação. 

22. Na coluna Atribuição de cada retorno, selecione para onde o dado retornado pelo método/operação deve ser enviado ou armazenado para ser usado no processo.

23. Na coluna Valor de cada retorno, defina onde o dado retornado deve ser armazenado ou utilizado, de acordo com o destino selecionado.

24. Se um dos parâmetros de retorno for do tipo complexo, como objeto ou lista, na coluna Ação, clique em Editar objeto Image Added para configurar o destino dos valores de retorno.

25. Ao finalizar a configuração dos parâmetros do objeto retornado, clique em Salvar, para voltar para a aba Retorno.

26. Clique em Salvar para salvar todas as configurações feitas para o serviço, operação, parâmetros e retorno.

27. Clique em Salvar rascunho – localizado no lado direito da barra superior – para salvar as configurações feitas no componente Atividade de serviço.

28. Na mensagem exibida, clique em Ok, entendi.

Configurar componente Atividade de serviço – SOAP

Âncora
soap soap

...

01. No diagrama do processo, clique no componente Atividade de serviço Image Added que deseja configurar com um serviço do tipo SOAP.

02. Na aba Geral, defina as informações gerais para o componente que representa a execução de um serviço externo.

03. Clique em Configurar integração.

04. Na aba Geral, defina as informações solicitadas para configurar a execução do serviço. 

05. Em Header, clique em Adicionar header para adicionar informações adicionais à requisição do serviço.

06. Informe os dados necessários para cada header.

07. Na coluna Valor de cada propriedade do objeto, insira o valor que será enviado para essa propriedade na requisição do serviço.

08. Ao finalizar a configuração das propriedades do objeto do header, clique em Salvar.

09. Clique na aba Parâmetros para configurar os parâmetros do método/operação do serviço. 

10. Na coluna Origem do valor de cada parâmetro, selecione de onde será obtido o valor que será passado para esse parâmetro do método/operação.

11. Na coluna Valor de cada parâmetro, selecione ou insira o valor que será passado de acordo com a origem selecionada.

12. Se um dos parâmetros for do tipo objeto, na coluna Ação, clique em Editar objeto Image Added para configurar os parâmetros do objeto.

13. Ao finalizar a configuração dos parâmetros do objeto, clique em Salvar, para voltar para a aba Parâmetros.

14. Se um dos parâmetros for do tipo lista, na coluna Ação, clique em Adicionar via lista Image Added para adicionar os valores para os parâmetros da lista.

15. Clique em Adicionar valor Image Added.

16. Ao finalizar a configuração dos parâmetros da lista, clique em Salvar, para voltar para a aba Parâmetros.

17. Para os tipos de parâmetros Objeto ou Map, é possível adicionar atributos clicando em Adicionar atributos Image Added – localizado ao lado do parâmetro.

18. Clique em Adicionar atributos Image Added.

19. Na coluna Chave, insira uma chave para identificar o atributo.

20. Na coluna Atribuição, selecione como será a atribuição de valor para o atributo.

21. Na coluna Valor, selecione ou insira o valor para o atributo de acordo com a origem selecionada.

22. Ao finalizar a configuração dos atributos, clique em Salvar até voltar para a aba Parâmetros.

23. Clique na aba Retorno para configurar o destino dos dados retornados pelo método/operação. 

24. Na coluna Atribuição de cada retorno, selecione para onde o dado retornado pelo método/operação deve ser enviado ou armazenado para ser usado no processo.

25. Na coluna Valor de cada retorno, defina onde o dado retornado deve ser armazenado ou utilizado, de acordo com o destino selecionado.

26. Se um dos parâmetros de retorno for do tipo complexo, como objeto ou lista, na coluna Ação, clique em Editar objeto Image Added para configurar o destino dos valores de retorno.

27. Ao finalizar a configuração dos parâmetros do objeto retornado, clique em Salvar, para voltar para a aba Retorno.

28. Clique em Salvar para salvar todas as configurações feitas para o serviço, operação, parâmetros e retorno.

29. Clique em Salvar rascunho – localizado no lado direito da barra superior – para salvar as configurações feitas no componente Atividade de serviço.

30. Na mensagem exibida, clique em Ok, entendi.

Configurar integração

...

01. No diagrama do processo, clique no componente Atividade de serviço Image Added para o qual deseja configurar a integração depois de selecionar o serviço desejado.

02. Clique em Configurar integração.

03. Defina as configurações desejadas para a integração nas abas Geral, Parâmetros e Retorno, de acordo com o tipo de serviço selecionado.

04. Depois de definir todas as configurações desejadas em cada aba, clique em Salvar.

05. Clique em Salvar rascunho – localizado no lado direito da barra superior – para salvar as alterações feitas no componente Atividade de serviço.

06. Na mensagem exibida, clique em Ok, entendi.

Editar integração

...

01. No diagrama do processo, clique no componente Atividade de serviço Image Added para o qual deseja editar as configurações da integração.

02. Clique em Editar Image Added – localizado no quadro da integração configurada.

03. Edite as configurações desejadas para a integração nas abas Geral, Parâmetros e Retorno, de acordo com o tipo de serviço selecionado.

04. Depois de editar todas as configurações desejadas em cada aba, clique em Salvar.

05. Clique em Salvar rascunho – localizado no lado direito da barra superior – para salvar as alterações feitas no componente Atividade de serviço.

06. Na mensagem exibida, clique em Ok, entendi.

Excluir integração

...

01. No diagrama do processo, clique no componente Atividade de serviço Image Added do qual deseja excluir a integração configurada.

02. Clique em Excluir Image Added – localizado no quadro da integração configurada.

03. Na mensagem exibida, clique em Excluir para confirmar a exclusão da integração.

04. Clique em Salvar rascunho – localizado no lado direito da barra superior – para salvar as alterações feitas no componente Atividade de serviço.

05. Na mensagem exibida, clique em Ok, entendi.

Dúvidas frequentes

...

Confira aqui algumas dúvidas frequentes sobre o componente Atividade de serviço.

<script>
    (function() {
        function toggleAreas(isExpand, $parent) {
            var $items = $parent.find('.panel');

            $.each($items, function(idx, el) {
                var $arrow = $(el).find('span.cloakToggle').find('span');
                var $content = $(el).find('span.cloak');
                if (isExpand) {
                    $arrow.removeClass('cloakDefaultOpen').addClass('cloakDefaultClose');
                    $content.show();
                } else {
                    $arrow.addClass('cloakDefaultOpen').removeClass('cloakDefaultClose');
                    $content.hide();
                }
            });
        }

        $(document).on('click', '#toggleAll-3', function(ev) {
            ev.preventDefault();
            var isExpand = $(this).data('expand');
            var $parent = $(this).nextAll('.sectionColumnWrapper').first();
            toggleAreas(isExpand, $parent);
            $(this).data('expand', !isExpand);
        });
    })();
</script>
<a id="toggleAll-3" href="#" data-expand="true">Abrir/fechar todas as dúvidas</a>

03. Clique em Configurar integração.

04. Na aba Geral, defina as informações solicitadas para configurar a integração com o serviço.

06. Em Header, clique em Adicionar header para adicionar as informações necessárias para que a integração funcione corretamente.

07. Xxxxxxxxxxxxxxx

...

08. Xxxxxxxxxxxxxxx

...

09. Clique em Salvar rascunho – localizado no lado direito da barra superior – para salvar as configurações feitas no componente Atividade de serviço.

10. Na mensagem exibida, clique em Ok, entendi.

Configurar integração

01. No diagrama do processo, clique no componente Atividade de serviço Image Removed para o qual deseja configurar a execução automatizada.

02. Clique em Image Removed Adicionar condição.

03. Em Nome da condição, insira um nome para identificar a condição simples depois de criada.

04. Selecione o tipo Condição simples.

05. Xxxxxxx

...

06. Clique em Salvar.

...

07. Ao concluir a inclusão de todas as condições simples desejadas, clique em FecharImage Removed– localizado no canto superior direito.

08. Clique em Salvar rascunho – localizado no lado direito da barra superior – para salvar as alterações feitas no componente Atividade de serviço.

09. Na mensagem exibida, clique em Ok, entendi.

Editar integração

01. No diagrama do processo, clique no componente Exclusivo Image Removed do qual deseja editar uma condição simples.

02. Em Condições criadas, localize a condição que deseja editar e clique em AçõesImage Removed– localizado no seu lado direito.

03. Clique em Editar.

04. Xxxxxxxxxx.

09. Clique em Salvar rascunho – localizado no lado direito da barra superior – para salvar as alterações feitas no componente Atividade de serviço.

10. Na mensagem exibida, clique em Ok, entendi.

Dúvidas frequentes

...

<script>
    (function() {
        function toggleAreas(isExpand, $parent) {
            var $items = $parent.find('.panel');

            $.each($items, function(idx, el) {
                var $arrow = $(el).find('span.cloakToggle').find('span');
                var $content = $(el).find('span.cloak');
                if (isExpand) {
                    $arrow.removeClass('cloakDefaultOpen').addClass('cloakDefaultClose');
                    $content.show();
                } else {
                    $arrow.addClass('cloakDefaultOpen').removeClass('cloakDefaultClose');
                    $content.hide();
                }
            });
        }

        $(document).on('click', '#toggleAll-3', function(ev) {
            ev.preventDefault();
            var isExpand = $(this).data('expand');
            var $parent = $(this).nextAll('.sectionColumnWrapper').first();
            toggleAreas(isExpand, $parent);
            $(this).data('expand', !isExpand);
        });
    })();
</script>
<a id="toggleAll-3" href="#" data-expand="true">Abrir/fechar todas as dúvidas</a>

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.

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.

Toggle Cloak
id @saiba-mais-3

 O que acontece se uma atividade de serviço falhar ou gerar um erro?

• 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.

Toggle Cloak
id @saiba-mais-4

Xxxxxxxxxxxx?

Xxxxxxxxxxxx

Toggle Cloak
id @saiba-mais-5

 Xxxxxxxxxxxx?

Xxxxxxxxxxxxxx

Toggle Cloak
id @saiba-mais-6

 Xxxxxxxxxxxxx?

Xxxxxxxxxxxxxxx

Toggle Cloak
id @saiba-mais-7

Xxxxxxxxxxxx?

...