Veja como embutir comentários nas expressões de regras de negócio dos projeto Magic xpi. 
Esta é uma postagem simples e trata-se de um “brinde de final de ano”.
Vamos falar de um “truque”, ou de uma “dica do editor”, ou ainda, de um “recurso alternativo”.
O Magic xpi possui uma propriedade chamada “Description” em quase todos os seus objetos, durante o desenho do projeto de integração e automação,
que tem o propósito especifico de documentação.
Veja:
Além do código-fonte no Studio, essas informações também ficam disponíveis na “Documentação Automática” que pode ser gerada para o projeto:
Muito bom este recurso.
Mas já teve a necessidade de colocar um comentário numa Expressão de Regra de Negócio, para registrar o motivo ou importância dela estar montada daquela forma?
Se não teve, terá em algum momento. Mas estas expressões não possuem uma propriedade “Description“.
E aqui está truque:
Podemos usar a função “IF” do Magic xpi em qualquer parte da expressão, com o propósito apenas de embutir um texto no código dela.
Mas sempre com o cuidado de não alterar o resultado da expressão avaliada.
Por exemplo:
Se a expressão for do tipo ALPHA, podemos usar:
& IF( <texto> = '', '', '' )
Se for do tipo NUMERIC, pode ser:
+ IF( <texto> = '', 0, 0 )
Ou se for o tipo LOGICAL:
OR IF( <texto> = '', 'TRUE'LOG, 'TRUE'LOG )
O importante sempre é o cuidado para que o resultado final calculado não se altere por conta da adição desta função (IF) na expressão.
Dessa forma, a mesma expressão acima poderia estar escrita assim:
😉
Gostou? Fique ligado no Blog MagicBR, para mais dicas.
Para receber os artigos do Blog Magic Brasil em primeira mão no seu email, registre-se aqui