Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

--- enduser:prosystnet:customizacoes:formulas [2021/06/21 14:15] – admin
+++ enduser:prosystnet:customizacoes:formulas [2026/09/28 00:25] (atual) – removida - edição externa (Data desconhecida) 127.0.0.1
@@ Linha 1: / Linha 1: @@
-{{indexmenu_n>40}}
-====== Editor de Expressões (Fórmulas) ======
-Um dos grandes recursos oferecidos pela tecnologia Prosyst.NET é a opção da criação de **fórmulas**, possibilitando a criação de novas informações interpretadas a partir das demais informações já apresentadas.
-O uso de fórmulas pode ser identificado ao longo de todos os novos controles que compõe a tecnologia Prosyst.NET, tais como campos calculados no [[:enduser:prosystnet:grid:formulas|Grid]] e [[:enduser:prosystnet:pivotgrid:formulas|Pivot Grid]], [[:enduser:prosystnet:customizacoes:formatacaocondicional|formatação condicional]], relatórios, entre outros.
-Estas fórmulas são criadas e editadas pelo [[#editor_de_expressao|Editor de Expressão]].
-===== Editor de Expressão =====
-[[https://suporte.prosyst.com.br:8090/wiki/lib/exe/detail.php?id=enduser:prosystnet:customizacoes:formulas&media=enduser:prosystnet:customizacoes:pasted:20140224-150339.png|{{:enduser:prosystnet:customizacoes:pasted:20140224-150339.png}}]]
-**(1) Expressão Atual:** Este campo define a fórmula da expressão que está sendo editada no momento. A expressão pode ser editada manualmente, ou através da seleção de campos, funções e operadores através das opções de auxílio disponíveis nesta tela.
-**(2) Operadores (Botões de Auxílio):** Esta área define botões de auxílio para fácil acesso aos operadores aritméticos, comparação, agrupamento, etc.
-**(3) Categorias de Informações:** Este grupo organiza os campos e funções disponíveis para inclusão na expressão, que serão apresentadas no grupo de **Campos / Funções**.
-**(4) Campos / Funções:** Este grupo enumera as funções ou campos disponíveis para a categoria selecionada, conforme a origem da fonte de dados. Para adicionar uma destas informações à expressão, selecione o campo ou função desejado com duplo-clique.
-**(5) Campo de Explicação:** Este campo dará detalhes sobre o campo ou função selecionada no momento.
-===== Regras de Sintaxe =====
-    * __Textos constantes__  deverão aparecer entre __aspas simples__. Ex: '''Texto Fixo'''.
-    * __Números constantes__  deverão ter suas decimais __separadas por ponto__  (.). Ex: ''150.90''  (Cento e Cinquenta vírgula noventa).
-    * __Datas Constantes__  deverão aparecer __entre sustenidos (#)__  respeitando a formatação __AAAA/MM/DD__. Ex: ''#2014/03/31#''  (31 de Março de 2014).
-    * __Campos__  (ou referência a outras fórmulas) devem aparecer entre __colchetes__. Ex: ''[Nome do Campo]''.
-===== Tipos de Expressão =====
-**Expressão Booleana (verdadeiro / falso):**  A expressão booleana é aquela cuja fórmula deve retornar um resultado **verdadeiro**  ou **falso**. Este tipo de expressão é requerido quando é necessária uma condição para definir uma consequência (como, por exemplo, na [[:enduser:prosystnet:customizacoes:formatacaocondicional|Formatações Condicionais]]). Em vias gerais, este tipo de expressão se resume a comparações entre campos e/ou valores.
-Exemplo de expressões booleanas:
-''[Saldo] > 15.00''
-''[Preço Total] == ([Qtde Solicitada] * [Preço Unitário])''
-**Expressão Convencional:**  A expressão convencional é aquela que, a partir da incorporação de funções e outros campos, retorna . Uma expressão convencional, por sua vez, resulta em uma informação que possibilita nas mesmas funcionalidades de campos oficiais da fonte de dados, tais como [[:enduser:prosystnet:grid:ordenacao|ordenação]], [[:enduser:prosystnet:grid:agrupamento|agrupamentos]], [[:enduser:prosystnet:grid:sumarizacao|sumarizações]], etc.
-===== Lista de Funções e Exemplos =====
-**Função: DateDiffDay( , )**  \\ **Exemplo:**  DateDiffDay([Data Entrega],Today()) - É retornado a diferença do número de dias entre a data de entrega comparada com a data corrente (hoje).
-**Função: Iif( , , ) **
-**Exemplo**: Iif([Data Entrega] < Today(), 'Verdadeiro', 'Falso') - É retornado a parte verdadeira ou a parte falsa, dependendo do resultado lógico da expressão, nesse caso se a data de entrega realmente for menor que a data corrente retorna "Verdadeiro", caso contrário retorna "Falso".
-**Função: Contains(' ',' ')**  \\ **Exemplo**: Iif(Contains([Descrição],'Prosyst'),'Apresenta o nome Prosyst','Não apresenta o nome Prosyst') - Caso o campo descrição que está sendo tratado nesse exemplo contém a palavra "Prosyst" é retornado a primeira mensagem, caso contrário retorna a segunda mensagem tratada na função acima.
- \\ **Função: Substring(' ', , )**  \\ **Exemplo1**: Substring([Descrição],0,4) - Possui a função de extrair uma substring de uma string, ou seja, no campo descrição que é tratado nesse exemplo será extraído seu conteúdo do primeiro caractere até o quarto caractere.
-**Exemplo2**: Substring([Cod-Descrição],  0,  CharIndex(' - ', [<font 13px/arial;;#000000;;#ffffff>Cod-Descrição</font> ]))- <font 13px/arial;;#000000;;#ffffff>nesse</font> exemplo<font 13px/arial;;#000000;;#ffffff></font> será<font 13px/arial;;#000000;;#ffffff></font> extraído<font 13px/arial;;#000000;;#ffffff>o</font> <font 13px/arial;;#000000;;#ffffff></font> conteúdo<font 13px/arial;;#000000;;#ffffff>do</font> primeiro<font 13px/arial;;#000000;;#ffffff></font> caractere<font 13px/arial;;#000000;;#ffffff></font> até<font 13px/arial;;#000000;;#ffffff>o</font> caractere <font 13px/arial;;#000000;;#ffffff>' - '.</font>
- \\ **Função: Round( , )**  \\ **Exemplo**: Round([Preço Total] == [Quantidade] * [Preço Unitário],4) - Nesse exemplo será retornado o resultado da expressão lógica definida dentro da função, arredondando esse resultado para 4 casas decimais.
- \\ **Função: Lower()**  \\ **Exemplo**: Lower([Descrição]) - Retorna todo o campo da descrição em minúsculo, independente se a descrição estava em minúsculo ou maiúsculo.
- \\ **Função: Upper()**  \\ **Exemplo**: Lower([Descrição]) - Retorna todo o campo da descrição em maiúsculo, independente se a descrição estava em minúsculo ou maiúsculo.
-Estes são somente alguns dos exemplos de funções que podem ser utilizadas através da tecnologia Prosyst.NET, sendo que é possível aplicar uma série de outras funções que não foram descritas acima, mas que também implica na busca ou análise de um resultado que vem agregar ao programa que está sendo estudado.