...
- Visão Geral
- Exemplo de utilização
- Como cadastrar a Atividade de Expressão para executar em uma API
01. VISÃO GERAL
O objetivo deste documento é mostrar como deve ser utilizada a atividade "Expressão" de uma Fórmula Visual.
...
Informações |
---|
|
Deck of Cards |
---|
id | Configurando o Aplicativo Confiável no ADFS |
---|
| Card |
---|
| Primeiramente, é necessário arrastar a atividade "Consulta SQL" para o "fluxo de trabalho" sequencial em sua fórmula visual: ![](/download/attachments/161350726/worddav3444dd442ba522e9bb45bd9a62f3e654.png?version=1&modificationDate=1410381177000&api=v2)
|
Card |
---|
| Clique com o Botão direito do mouse na atividade e selecione uma consulta SQL: ![](/download/attachments/161350726/worddav06ea851f6fd80cf36615c88d88b540c7.png?version=1&modificationDate=1410381180000&api=v2)
|
Card |
---|
| Utilizamos a seguinte Consulta SQL em nossa pesquisa: - Select VALORORIGINAL from TFLAN where NUMERODOCUMENTO='00000433'
![](/download/attachments/161350726/worddav6378f6c0b2c75de11c80e507fb62bc22.png?version=1&modificationDate=1410381182000&api=v2)
![](/download/attachments/161350726/worddav16219b567c4ce5d125d0866780f43b01.png?version=1&modificationDate=1410381184000&api=v2)
|
Card |
---|
| Note que essa Consulta SQL está nos retornando um valor numérico com 4 casas decimais. Vamos utilizar a Atividade Expressão para converter esse valor para o formato 162,02.
Adicione a Atividade Expressão: ![](/download/attachments/161350726/worddavff7e5319762574ba4eb2a0a0611c3219.png?version=1&modificationDate=1410381186000&api=v2)
|
Card |
---|
| Após atividade ter sido adicionada ao fluxo de trabalho é necessário configurar as propriedades da atividade. Clique em para montar a sua expressão. ![](/download/attachments/161350726/worddavdbe5e2d06bdd46d90963bfde96d6a604.png?version=1&modificationDate=1410381188000&api=v2)
Propriedades - Nome: Nome da Atividade
- Descrição: Descrição da Atividade
- Habilitado: Opção de habilitar ou desabilitar a atividade
- Expressões: Expressões a serem calculadas, (separadas por
![(piscar o olho)](/s/ougqdk/8804/xgjkrn/_/images/icons/emoticons/wink.svg) - Usar Valor Nulo: Define se o valor deverá ser calculado caso o valor da expressão seja Nulo.
- Valor Calculado: Valor Calculado da Expressão.
|
---|
|
Card |
---|
| Neste exemplo, iremos adicionar uma Expressão que utiliza a função "Format", que têm por objetivo formatar determinado valor. ![](/download/attachments/161350726/worddava173c22824661bbbccbdd620b5486754.png?version=1&modificationDate=1410381191000&api=v2)
|
Card |
---|
| Na criação de sua expressão, observe que ao colocar o ponteiro do mouse encima da função, é exibida sua sintaxe. Como parâmetro para a expressão, podemos utilizar dados de outras atividades da Fórmula Visual (Como no exemplo, o valor de nossa Consulta SQL). ![](/download/attachments/161350726/worddavc545d7984758248b755b6320f30ae2bd.png?version=1&modificationDate=1410381194000&api=v2)
|
Card |
---|
| A sintaxe da função "Format" é: Format("valor", "string máscara") Em nosso exemplo, teremos como "valor" o resultado da nossa Consulta SQL e usaremos "'##,##0.00'" como string máscara. Format( rmsConsSQLActivity1.VALORORIGINAL, "###,##0.00" ) Obs: Na Expressão, usamos "," (Virgula) para separador de milhares e "." (Ponto) para separador decimal. ![](/download/attachments/161350726/worddava497fb164be9e9bf71fff64cbd20a7cf.png?version=1&modificationDate=1410381195000&api=v2)
|
Card |
---|
| Adicione a atividade Gerar exceção ![](/download/attachments/161350726/worddave41ee0d007b322632c629085e7563bc2.png?version=1&modificationDate=1410381198000&api=v2)
|
Card |
---|
| Nas propriedades da atividade Gerar Exceção, busque o valor da Expressão como Mensagem para verificar se realmente o valor da base foi convertido para a Máscara definida pela atividade Expressão. ![](/download/attachments/161350726/worddavd28bb8c01ea77c2c1563885d12d88d56.png?version=1&modificationDate=1410381201000&api=v2)
|
Card |
---|
| Salve, execute sua Fórmula Visual e verifique os dados. ![](/download/attachments/161350726/worddaveaf5d98835e0f1f678b12ab0a684b845.png?version=1&modificationDate=1410381201000&api=v2)
|
|
|
03. COMO CADASTRAR A ATIVIDADE DE EXPRESSÃO PAR EXECUTAR EM UMA API
Para o exemplo vamos utilizar o contexto de usuário (UserControllerServer) juntamente com as atividades de "Expressão" e "Gerar Exceção", para trazer os campos UserName e FormatedName depois de recuperar um (GET) na API de usuário
Leia mais sobre Fórmula Visual em API
- A Fórmula Visual deve estar cadastrada com a opção Executa em API (POCO)habilitada, conforme exibido na imagem abaixo.
Image Added
- Para o exemplo utilizado, é necessário adicionar o gatilho o "UserControllerServer" no gatilho "Depois de recuperar (get)", para que a nossa formula retorne corretamente o resultado da expressão.
Image Added
Na Atividade de expressão, foi selecionado o campo "Expressão" e parametrizado para ser visualizado os campos UserName e FormatedName como mostra a imagem abaixo:
Image Added
No campo "Valor Calculado", foi selecionado a atividade de "Gerar Exceção", para visualizar a mensagem da expressão como mostra a imagem abaixo:
Image Added
Após salvar a fórmula, é necessário acessar a API de Usuários para realizar um "GET" e visualizar o resultado da expressão, como mostra a imagem abaixo:
Image Added