Introdução

Índice:

• Objetivo:

• Especificação:

Objetivo:

          Esse documento possui a finalidade de exemplificar a utilização da atividade de fórmula visual Executar Código Fonte para personalizar a execução de processos. Utilizaremos o processo de cópia de perfis neste exemplo.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.

         Para maiores detalhes da criação e acesso a fórmulas visuais, acesse a documentação Fórmula Visual - RM

Especificação:

     A atividade “Executar Código Fonte” é uma atividade que permite que um código (que varia de Levantar uma Exceção à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) são capazes de editar código-fonte clicando no botão Editor C#, tal qual demonstrado abaixo:

Image Added

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

Image Added

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:

Image Removed

Salve a fórmula visual. Na visão de fórmulas visuais, selecione a fórmula recém-criada e clique sobre o botão editar da visão. Selecione a aba Gatilhos. Em processos, selecione a opção “Antes da Execução” e clique no botão de adicionar gatilhos. Na tela aberta pesquise por GlbProcCopyPerfil e clique sobre o processo de cópia de perfis. Clique em OK para salvar as alterações.

Image Removed

Informações
icon false
Deck of Cards id ExemploFV
Informações
icon false
Crie uma nova fórmula visual e edite a mesma. A esquerda, clique na aba Atividades e arraste a atividade de Executar Código Fonte para o fluxo de trabalho da fórmula. Image Removed Depois de arrastar a atividade para o fluxo, clique com o botão direito do mouse e acesse a opção “Selecionar código fonte”. Image Removed Deck of Cards id ExemploFV Card id ExemploFV label Passo 01 Card id ExemploFV label Passo 02 Inclua um novo registro, preencha o campo Nome do código fonte e posteriormente clique no botão Editor C# Image Removed Na janela aberta é disponibilizado um NameSpace com uma classe pré criada para personalizarmos a execução do nosso processo. Nessa janela possuímos recursos para executar o Build do código fonte e adicionar referências necessárias para a nossa classe entre outros. Image Removed Como vamos personalizar um processo, utilizaremos o método CustomProcess Image Removed Para manipular a classe de parâmetros do processo de cópia de perfis, é necessário referenciar a dll que contém a definição da mesma, para isso, acessamos o Project Explorer (no canto direito da janela), selecionamos o item References, clicamos com o botão direito e selecionamos a opção Add Reference... Image Removed Na janela aberta, selecionamos a aba Browse, e clicamos no botão Browse Image Removed Para acessar as propriedades da classe de parâmetros do processo, é necessário realizar um CAST do objeto genérico processParams.ParamsProc para o tipo da classe de parâmetros do processo que escolhemos (RM.Glb.Processos.GlbParamsProcCopyPerfil). Observe que após realizar o cast, as propriedades da classe de parâmetros do nosso processo estarão disponíveis através do intelisense da atividade. Image Removed A partir daí, podemos manipular as informações da forma como desejarmos, e nesse exemplo utilizamos o recurso para: Forçar a criação de um novo perfil; Não permitir a substituição de registros existentes Verificar se todos os campos foram preenchidos e lançar exceções caso contrário Adicionar a string “**Cópia** ” na identificação do perfil resultante do processo de cópia Método ficou assim: Card id ExemploFV label Passo 03 Card id ExemploFV label Passo 04 Bloco de código language c# theme Eclipse public void CustomProcess(RM.Con.SourceCode.Intf.SrcProcessParams processParams) { // força que seja criado um novo registro ((RM.Glb.Processos.GlbParamsProcCopyPerfil)processParams.ParamsProc).GenerateNewRecord = true; // impossibilita a substituição de recursos existentes if (((RM.Glb.Processos.GlbParamsProcCopyPerfil)processParams.ParamsProc).ReplaceExistingRecords) throw new Exception ("Não é permitido sobrescrever perfis existentes"); // verifica se o código do novo perfil foi informado if (string.IsNullOrEmpty(((RM.Glb.Processos.GlbParamsProcCopyPerfil)processParams.ParamsProc).NewProfileCode.Trim())) throw new Exception("O código do novo perfil deve ser informado!"); // verifica se o identificador do novo perfil foi informado if (string.IsNullOrEmpty(((RM.Glb.Processos.GlbParamsProcCopyPerfil)processParams.ParamsProc).NewProfileId.Trim())) throw new Exception("O identificador do novo perfil deve ser informado!"); // verifica se o nome do novo perfil foi informado if (string.IsNullOrEmpty(((RM.Glb.Processos.GlbParamsProcCopyPerfil)processParams.ParamsProc).NewProfileName.Trim())) throw new Exception("O nome do novo perfil deve ser informado!"); // altera o nome do novo perfil para que seja identificado como uma cópia ((RM.Glb.Processos.GlbParamsProcCopyPerfil)processParams.ParamsProc).NewProfileName = "**Cópia** " + ((RM.Glb.Processos.GlbParamsProcCopyPerfil)processParams.ParamsProc).NewProfileName ; }
Card
id ExemploFV label Passo 05	01
Após realizar as implementações desejadas no código-fonte, clique em OK. É possível que o aviso abaixo apareça: Image Added 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

Image Removed

Selecionamos as opções “Novo Perfil” e “Substituir Perfis” e preenchemos os dados solicitados. Observando que, o comportamento definido foi para que não seja substituído nenhum perfil, apenas a criação de um novo como uma cópia do registro selecionado na visão.

Image Removed

Depois de clicar em executar, uma das exceções definidas no código fonte foi lançada.

Image Removed

Se repetirmos a execução preenchendo os mesmos dados e desmarcando a opção de Substituir Perfis, o processo será executado com sucesso e na visão, podemos observar que o valor da coluna Identificação na grid foi alterado conforme definido no código fonte criado.

Image Removed

Parâmetro da Atividade:

     Na atividade de "Executar Código Fonte (conSourceCodeActivity1)" existe a opção de criar parâmetros.

Image Removed

A utilização do parâmetro é utilizada quando é necessário a chamada de outra outra atividade dentro da fórmula visual.
Como exemplo, acrescente a atividade de "Exceção" no fluxo sequencial e aponte o parâmetro criado na atividade "Executar Código Fonte" para a atividade de "Exceção", exemplo demonstrativo abaixo:

Image Removed

Image Removed

Verifique que quando executada a fórmula visual a exceção é levantada.

Image Removed