1,438
edits
Changes
Created page with "Sintaxe: COUNT_DISTINCT(<expressão>) Exemplo: '''COUNT_DISTINCT("Produto")''' - Retorna o número de ocorrências únicas de produtos"
Lembramos apenas que atualmente o TaticView suporta apenas expressões cujo retorno é numérico.
As expressões suportam a barra inversa como [[EscapeChar|caractere de escape]] para que nomes possam conter os caracteres delimitadores.
Abaixo detalhes sobre o funcionamento das expressões.
== Estrutura básica de uma expressão ==
==== Identificador ====
É o nome do campo ou coluna envolvido na expressão, deve ser delimitado por aspas duplas.
* Exemplos: "Preço médio", "Parafuso 1\" philips", "Vendedor"
==== Operando de Valor ====
* Exemplo: IF("Produto" == "#null";0;20)
== Expressões Aritméticas ==
'''BETWEEN("Data Emissão"; '01/01/2019'; '31/12/2019')''' – Retorna true se a ''Data Emissão'' estiver entre ''01/01/2019'' e ''31/12/2019''. Caso contrário retorna false
==== Função COUNT ====
Retorna o número de ocorrências (linhas) de uma coluna ou valor.
Por ora, esta função funciona apenas em expressões de Fontes de Dados
Sintaxe:
COUNT(<expressão>)
Exemplo:
'''COUNT("Produto")''' - Retorna o número de ocorrências (linhas) de produtos
==== Função COUNT_DISTINCT ====
Retorna o número de ocorrências únicas (linhas) de uma coluna ou valor.
Por ora, esta função funciona apenas em expressões de Fontes de Dados
Sintaxe:
COUNT_DISTINCT(<expressão>)
Exemplo:
'''COUNT_DISTINCT("Produto")''' - Retorna o número de ocorrências únicas de produtos
==== Função IF ELSE (Se.... Senão...) ====
Testa uma expressão booleana e aplica uma condição em caso verdadeiro (true) ou outra condição nos casos de retornar falso (false). Precisa de três parâmetros, separados por ponto e virgula (;). O primeiro parâmetro é a expressão a ser testada, o segundo o valor a ser aplicado no caso de verdadeiro e o terceiro para ser aplicado no caso de falso.
Sintaxe:
IF(<expressão a ser testada>; <expressão no caso de verdadeiro>; <expressão no caso de falso>)
Exemplos:
'''IF(BETWEEN("Valor"; 0; 100); 10; 250)''' – Se o ''Valor'' estiver entre ''0'' e ''100'' retorna ''10'', se não retorna ''250''
==== Função LOG ====
Retorna o logaritmo de um número em uma base definida. Pode ser utilizada com apenas um parâmetro, neste caso é utilizado o logaritmo na base 10. Caso seja utilizado dois parâmetros, o segundo serve para informar a base a ser utilizada pelo logaritmo.
Sintaxe:
LOG(<expressão>; <base>)
Exemplos:
'''LOG("Lucro")''' – Retorna o logaritmo do campo ''Lucro''
Retorna a potência de um valor em um expoente definido. Pode ser utilizada com apenas um parâmetro, neste caso considera o expoente padrão 2. Se um segundo parâmetro for passado, esse será o expoente.
Sintaxe:
POW(<expressão>; <expoente>)
Exemplos:
'''POW("Lucro")''' – Retorna a potência do valor ''Lucro''
'''RANDOM(10; 100)''' – Retorna um número aleatório entre ''10'' e ''100''
==== Função ROUND ====
Retorna o arredondamento de uma coluna de valor ou valor.
Sintaxe:
ROUND(<valor>;<precisão>)
Exemplo:
'''ROUND("Lucro")''' - Se lucro for 10.38 retorna 10.00
'''ROUND(15.65)''' - Retorna 16.00
'''ROUND(1.777;1)''' - Retorna 1.8
==== Função SQRT (Raiz Quadrada) ====
Retorna a raiz quadrada de um valor.
Sintaxe:
SQRT(<valor ou expressão>)
Exemplos:
'''SQRT("Lucro")''' – Retorna a raiz quadrada do valor ''Lucro''
Retorna verdadeiro (true) se o conteúdo desejado for encontrado na lista e falso (false) caso contrário. Precisa de dois parâmetros, o primeiro são os dados que serão consultados e o segundo é o termo a ser encontrado. Lembrando que é necessário utilizar o operador de curinga ''%'' e circundar o termo por aspa simples.
Sintaxe:
LIKE(<dados>; <termo>)
Exemplo:
'''LKELIKE("Produto"; '%anh%')''' – Retorna true se o ''Produto'' contém o termo ''anh'' ou false caso contrário</div> '''LIKE("Produto"; '%anh%')''' - Retorna verdadeiro se o ''Produto'' conter a string ''anh'', caso contrário falso
== Funções de Data ==
* Com dois parâmetros, o primeiro é a constante do agrupamento da qual queremos obter a primeira data (vide lista acima), e o segundo é a data base.
Sintaxe:
FIRST_DAY_OF(<parte da data>; < data base>)
Exemplos:
'''FIRST_DAY_OF(0; DAY_FROM_TODAY(0))''' – retorna o primeiro dia do ano a partir de hoje
* Com três parâmetros, o primeiro é a constante do agrupamento da qual queremos obter a primeira data (vide lista acima), o segundo é o modificador da base da data a partir de hoje e o terceiro é a quantidade para alterar o modificador.
* Com dois parâmetros, o primeiro é a constante do agrupamento da qual queremos obter a última data (vide lista acima), e o segundo é a data base.
Sintaxe:
LAST_DAY_OF(<parte da data>; < data base>)
Exemplos:
'''LAST_DAY_OF(0; DAY_FROM_TODAY(0))''' – retorna o último dia do ano a partir de hoje
* Com três parâmetros, o primeiro é a constante do agrupamento da qual queremos obter a última data (vide lista acima), o segundo é o modificador da base da data a partir de hoje e o terceiro é a quantidade para alterar o modificador.
Retorna o número de dias entre duas datas. Portanto necessita de duas datas.
Sintaxe:
NUM_OF_DAYS(< data 1>; < data 2>)
Exemplos:
'''NUM_OF_DAYS(FIRST_DAY_OF(0; "Data Emissão"); "Data Emissão")''' – retorna o número de dias entre o primeiro dia do ano, baseado na coluna ''Data Emissão'', até o dia atual, baseado na mesma coluna
* '''"@avg[coluna]"''' – Média da coluna, semelhante a ''"@sum[coluna]"'' / ''"@count"''
* '''"@prev[coluna]"''' – Valor da linha anterior à linha atual, para essa coluna
* '''"@totalRowValue[coluna]"''' - Valor da Linha de Total, (se presente), para essa coluna.
* '''"@accumCol[coluna]"''' – Valor acumulado da coluna até a linha corrente. Útil para calcular média variável.
** Exemplo: ''"@accumCol[coluna]"'' / ''"@row"''
