Cross Segmentos - Backoffice RM - Integração - Fórmula Visual - Utilizando a atividade "Executar serviço do TOTVS API Services"

 Tempo aproximado para leitura: 00:03:25 min

Dúvida
Como utilizar a atividade "Executar serviço do TOTVS API Services"?

Ambiente
Cross Segmentos - Backoffice RM - Integração - A partir da versão 12.1.2306.

Solução
Em versões anteriores à versão 12.1.2306 este serviço possuía o nome "Executar Mashup", mas a partir da versão 12.1.2306 passou a ser chamado de “Executar serviço do TOTVS API Services” devido à descontinuação dos serviços do Mashup.

A atividade “Executar serviço do TOTVS API Services” é uma atividade que permite utilizar um serviço disponibilizado pelo TAS, o qual possui serviços gratuitos e pagos. Para mais informações sobre o TAS, segue documentação abaixo:
TOTVS API Services

Para a Fórmula Visual ser corretamente executada, a parametrização do TAS já deve estar corretamente configurada no ambiente. Para realizar a configuração, segue documentação abaixo:
Como configurar o TAS - TOTVS API Service

No exemplo abaixo, utilizaremos o serviço de Consulta de CEP, um serviço gratuito que não irá exigir a chave token para os testes.

Para executar a atividade, realize os seguintes passos:
1. Arraste a atividade "Executar serviço do TOTVS API Services" para o fluxo de trabalho sequencial em sua fórmula visual.


2. Configure as propriedades da atividade:

Propriedades Obrigatórias da atividade que devem ser utilizadas:

- Tipo de Serviço:

Neste exemplo, utilizaremos o tipo de serviços SOACustomService que irá carregar os serviços do TAS.

 - Nome do Serviço:

Neste exemplo, utilizaremos o serviço SOACEPService do SOACustomService.

- Parâmetros do Serviço: 

Neste exemplo, como utilizaremos o serviço de busca de CEP, passaremos como parâmetro um CEP qualquer para validação.

3. Adicione a atividade "Expressão" na fórmula visual, para retornar os resultados da atividade anterior:


Nas propriedades da atividade de Expressão, crie o retorno desejado:


Segue abaixo o exemplo utilizado:

'TOTVS API SERVICES:'
+NewLine+
'Busca do CEP:'+rmsMashupActivity1.CEP 
+NewLine+
'Endereço:'+rmsMashupActivity1.Endereço 
+NewLine+
'Bairro:'+rmsMashupActivity1.Bairro
+NewLine+
'Cidade:'+rmsMashupActivity1.Cidade
+NewLine+
'Estado:'+rmsMashupActivity1.Estado

4. Adicione a atividade "Gerar Exceção" na fórmula visual, para conseguir visualizar os dados da expressão:


Nas propriedades da sua atividade de "Gerar Exceção", parametrize a "Mensagem de Erro" com o valor de sua atividade de "Expressão".

 Activity=rmsExpressionActivity1, Path=ValueConverter.AsString

Após a configuração clique em "Salvar e Executar" em sua Fórmula Visual:


Sua fórmula visual será executada, sendo exibido o retorno os dados de sua consulta de CEP da atividade de "Executar serviço do TOTVS API Services": 


Segue anexo exemplo da Fórmula Visual com o serviço TAS utilizado.
Executar_TAS.TotvsWF

Processo completo no GIF abaixo:

Saiba mais: 
Para mais informações sobre a configuração do TAS ao sistema RM:
Como configurar o TAS - TOTVS API Service

Para mais informações sobre o TAS:
TOTVS API Services

Para mais informações sobre a atividade "Executar serviço do TOTVS API Services":
Executar serviço do TOTVS API Services"