Cross Segmentos - Backoffice RM - Integração - Fórmula Visual - Utilizando a atividade "Executar Código Fonte" em ambiente N Camadas – Central de Atendimento TOTVS

Tempo aproximado para leitura: 00:04:00 min

Dúvida
Como utilizar a atividade de Fórmula Visual, Executar Código Fonte, em ambiente N Camadas?

Ambiente
Cross Segmentos - Backoffice RM - Integração - Todas as Versões.

Descrição
A partir da versão 12.1.31 (e superiores), é possível realizar alterações em códigos-fonte diretamente pelo RM em ambientes SmartClient ou 3 camadas (Client). Para versões anteriores, acesse a documentação: Exportação e Importação de Códigos Fontes, para compreender as limitações e informações importantes.

Neste documento estarão explícitas as informações necessárias para realizar edições na atividade Executar Código Fonte em ambientes SmartClient / 3 Camadas.

A atividade “Executar Código Fonte” necessita de arquivos presentes apenas na camada Server. Por esse motivo, era possível editá-la apenas em ambientes Server, por possuírem esses arquivos, porém, agora, mesmo SmartClient ou camada Client (3 camadas) conseguem editar código-fonte clicando no botão Editor C#, tal qual demonstrado abaixo:

Porém, é valido frisar que existem algumas limitações. A compilação do código-fonte só é passível de ser criada no ambiente Server então, por exemplo, caso seja acionado o botão Build no editor, é possível que seja exibido os erros de referência, tal qual demonstrado abaixo:

Os erros acima acontecem em ambientes SmartClient por não possuir os arquivos (DLL) necessários para a compilação daquele código-fonte. Dessa forma, para conseguir compilar este código-fonte corretamente, siga as informações abaixo:

Após realizar as implementações desejadas no código-fonte, clique em OK. É possível que o aviso abaixo apareça:

Este aviso aparece pelo fato de o Editor C# não ser capaz de sozinho, compilar o código-fonte em questão. Clique em Sim.

Após seguir os passos para seleção do Código-Fonte, acesse o botão "Salvar e Executar na Fórmula Visual". Agora, o código-fonte será enviado à camada Server, compilado e executado corretamente, tal qual demonstrado abaixo:

Importante:
Caso exporte qualquer Fórmula Visual que possua Código-Fonte e deseja editar este codigo posteriormente, é necessário que a seguinte propriedade "Exportar código fonte" na atividade esteja como "TRUE".

Para que assim seja enviado o XMLSOURCE com a estrutura do código-fonte em conjunto da fórmula, podendo assim realizar a edição posterior do código-fonte no ambiente ao qual realizou a importação desta fórmula visual.

Se a fórmula visual for exportada com esta propriedade de "Exportar código fonte" como "FALSE", o XMLSOURCE será enviado para a nova base vazio, enviando somente assim o COMPILEDSOURCE.

Desta forma a Fórmula Visual será corretamente executada em ambos casos possuindo este código-fonte, mas ao tentar acessar o Editor C# deste código que não possui o XMLSOURCE, ao qual foi importada uma Fórmula com o "Exportar código fonte" como "FALSE", será apresentado o seguinte erro abaixo:

Saiba Mais: