Manual - Expressões

Informe nesta caixa o texto da expressão. Se for uma expressão de campo, o valor retornado de ser do mesmo tipo de dado do campo. Caso seja uma expressão de filtro, o valor retornado deve ser do tipo lógico (true ou false) e no caso da expressão do nome do arquivo, o retorno deve ser do tipo texto.

Esta expressão deve ser escrita em linguagem C# e as principais funções são listadas no botão de funções a esquerda do texto da expressão. Além das funções, poderão ser utilizados os dados disponíveis no botão de dados. Os dados disponíveis variam de acordo com o tipo de expressão.

O gerador de saídas irá compilar esta expressão no Layout, e caso ela não seja válida um erro será exibido ao salvar ou ao gerar o código do Layout não permitindo que o Layout seja gerado até que o erro seja corrigido.

Sempre utilize as funções "Convert" para converter os valores dos dados para o tipo que deseja ser trabalhado na expressão. No exemplo da imagem, a função "Convert.ToString()" converte o valor do dado NOME para o tipo texto (string) e permite que sejam executadas funções de texto em cima do valor do dado, como por exemplo a função StartsWith() que no caso da expressão da imagem, verifica se o campo NOME começa com a letra "A".

Exemplo:

Convert.ToString(CLIENTE.NOME).StartsWith("A")

Converte o valor da coluna NOME da ligação CLIENTE para texto e verifica se o valor começa com a letra A.

Clique para visualizar as funções disponíveis para utilização na expressão.

As principais funções também estão disponíveis na documentação oficial a seguir:

• Convert: https://msdn.microsoft.com/en-us/library/system.convert_methods(v=vs.110).aspx
• Math: https://msdn.microsoft.com/en-us/library/system.math(v=vs.110).aspx
• String: https://msdn.microsoft.com/en-us/library/system.string_methods(v=vs.110).aspx

As seguintes funções utilitárias são específicas do gerador de saídas:

• Util.Round - Função utilizada para fazer o arredondamento de um valor numérico de acordo com o número de casas decimais desejadas.
• Util.Truncate - Função utilizada para truncar um valor numérico de acordo com o número de casas decimais desejadas.
• Util.ValueIn - Função utilizada para verificar se o valor passado como parâmetro está na lista de valores passadas.
• Util.AreEqual - Função utilizada para verificar se os dois valores passados são iguais.
• Util.IsEmpty - Função utilizada para verificar se o valor passado é vazio ou nulo.
• Util.If - Função utilizada para retornar um valor de acordo com a condição especificada.
• Util.Normalizar - Função utilizada para fazer a normalização de um texto passado como parâmetro. Ela irá retirar toda a acentuação, caracteres especiais, enter e tab do texto.
• Util.RetirarTabEnter - Função utilizada para retirar os caracteres de enter e tab de um texto.
• Util.RetirarAcentos - Função utilizada para retirar os caracteres acentuados de um texto.
• Util.RetirarCaracteresEspeciais - Função utilizada para retirar os caracteres especiais de um texto.
• Util.Left - Função utilizada para retornar uma quantidade determinada de caracteres a esquerda de um texto.
• Util.Right - Função utilizada para retornar uma quantidade determinada de caracteres a direita de um texto.

As seguintes funções estão disponíveis somente para o gerador de saídas RM:

• this.ExecuteFormula - Função utilizada para executar uma fórmula RM na expressão.

Clique para visualizar os dados disponíveis para utilização na expressão.

Os principais tipos de dados utilizados pelo gerador e suas funções disponíveis estão na documentação oficial da linguagem, consulte cada um dos tipos para maiores informações. Verifique as funções disponíveis para manipulação de cada tipo nos seguintes links:

• String (Texto): https://msdn.microsoft.com/en-us/library/system.string(v=vs.110).aspx
• Integer (Número Inteiro): https://msdn.microsoft.com/en-us/library/system.int32(v=vs.110).aspx
• Decimal (Número Decimal): https://msdn.microsoft.com/en-us/library/system.decimal(v=vs.110).aspx
• DateTime (Data/Hora): https://msdn.microsoft.com/en-us/library/system.datetime(v=vs.110).aspx
• Boolean (Lógico): https://msdn.microsoft.com/en-us/library/system.boolean(v=vs.100).aspx