Ao criar seus atributos e métricas personalizados, você usará muitas funções para ajudar em comparações, cálculos e manipulações das suas informações de negócios.
O Explore dispõe de várias funções para ajudar você a trabalhar com datas, cadeias de caracteres, cálculos e muito mais. Use este artigo como referência para descobrir as funções disponíveis e como usá-las.
Este artigo contém os seguintes tópicos:
Introdução
Você pode pesquisar e selecionar funções ao criar um atributo ou uma métrica calculada padrão. Na janela de edição de fórmulas, comece digitando o nome de uma função ou clicando em Adicionar em Funções e escolhendo a função da lista.
Depois de adicionada à fórmula, a função será exibida com valores padrão. Substitua esses valores com outros que você queira usar na sua fórmula. Neste exemplo, você quer retornar somente seus tickets com linhas de assunto que comecem com "[Marcado]".
- No menu Cálculos (
), clique em Atributo calculado padrão. - Dê um nome a seu atributo calculado. Este exemplo usa Assunto começa com [Marcado].
- Em Funções, clique em Adicionar.
- Na janela da fórmula, digite IF.
- Em Funções, clique em Adicionar.
- Pesquise por LEFTPART. Use a caixa de pesquisa e clique em Filtrar para definir os valores até a categoria Texto ou role pela lista até encontrar a função desejada.
- Ao lado de LEFTPART, clique em +.
- Você verá a fórmula IF LEFTPART(_texto,_número). Altere o parâmetro _texto para o atributo “Assunto do ticket”. Destaque _texto e escolha Assunto do ticket do menu Campos ou altere a fórmula manualmente para adicionar o atributo.
Agora, a fórmula será IF LEFTPART([Assunto do ticket],_número)
- Altere “texto_número” para o número de caracteres que você deseja comparar. [Marcado] tem nove caracteres, portanto, insira 9.
Agora, a fórmula lerá IF LEFTPART([Assunto do ticket],9)
- Por fim, adicione a condição que estamos procurando, neste caso, o texto "[Marcado]". A fórmula final será:
IF LEFTPART([Assunto do ticket],9)="[Marcado]" THEN [ID do ticket] ENDIF
Agora, quando esse atributo é usado no relatório, ele retornará somente os tickets com uma linha de assunto que comece com “[Marcado]”.
Para obter ajuda e exemplos, consulte Criação de fórmulas do Explore.
Operadores matemáticos básicos
Além das funções acima, você pode usar operadores matemáticos básicos para realizar cálculos e conectar texto:
| Operador | Descrição |
| + | Adiciona dois valores numéricos ou une duas cadeias de caracteres. |
| - | Subtrai um valor do outro. |
| * | Multiplica dois valores. |
| / | Divide um valor pelo outro. |
| = | Testa se um valor é igual ao outro. |
| != | Testa se um valor não é igual ao outro. |
| > |
Testa se o primeiro valor é maior que o valor seguinte (x>y) |
| < |
Testa se o primeiro valor é menor que o valor seguinte (x<y) |
| >= |
Testa se o primeiro valor é maior ou igual ao valor seguinte (x>=y) |
| <= |
Testa se o primeiro valor é menor ou igual ao valor seguinte (x<=y) |
| % | Calcula o módulo (ou resto) depois de dividir um valor pelo outro. Exemplo: 5%2 retorna 1, 20%3 retorna 2 |
Funções lógicas
Estas funções dão grande flexibilidade à análise e à apresentação das suas informações da forma que você quiser.
| Função | Descrição |
| Expressão condicional IF THEN ELSE | Permite que você avalie valores lógicos. Formato: IF (condição) THEN (valor se for verdadeiro) ELSE (valor se for falso) ENDIF Para obter informações mais detalhadas sobre essa função, consulte Uso da função IF THEN ELSE. |
| AND | Retorna TRUE se as duas expressões inseridas forem TRUE. Exemplo: IF ([Canal do ticket]="Email") AND ([E-mail do emissor]="fred@fredco.com") THEN [ID do ticket] ENDIF Retorna todos os tickets que foram recebidos por e-mail de fred@freedco.com. |
| OU | Retorna TRUE se pelo menos uma das duas expressões inseridas for TRUE. Exemplo: IF ([canal do ticket]="Email") OR ([canal do ticket]="Voice") THEN [ID do ticket] ENDIF Retorna todos os tickets que foram recebidos por canais de e-mail ou voz. |
| NOT | Inverte o valor lógico da expressão inserida. Exemplo: IF NOT([Canal do ticket]="Email") THEN [ID do ticket] ENDIF Retorna todos os tickets que não foram recebidos pelo canal de e-mail. |
| TRUE | Retorna o valor lógico "TRUE". |
| FALSE | Retorna o valor lógico "FALSE". |
| IN(_param,_matriz) | Retorna TRUE se o primeiro parâmetro inserido estiver na matriz especificada pelo segundo parâmetro inserido. Exemplos: IN(200,ARRAY(100,200,300,400)) retornará TRUE IN(250,ARRAY(20,40,60,80)) retornará FALSE |
| Expressão condicional SWITCH | A expressão SWITCH é uma alternativa mais fácil às instruções IF THEN ELSE com várias ramificações. SWITCH (_elemento_testado) { CASE _value1: _valor_retorno CASE _value2: _valor_retorno DEFAULT: _valor_retorno_padrão } Para obter informações aprofundadas sobre essa função, consulte Adição de várias expressões condicionais com SWITCH. |
Funções de atributo
Estas funções permitem que você realize operações básicas para quantificar o número de atributos retornados pelo seu relatório. Você também pode executar operações mais avançadas para "bloquear" ou estender o nível de agregação de seus cálculos.
| Função | Descrição |
| COUNT_VALUES(_atributo) | Conta o número de valores do atributo inserido. Valores repetidos são incluídos. Pode ser usada como uma condição em métricas e atributos calculados, mas não pode ser usado na cláusula THEN de uma métrica calculada. Exemplo: IF COUNT_VALUES([ID do ticket])>30 THEN 1 ELSE 0 ENDIF O exemplo acima retorna 1 quando há mais de 30 tickets e 0 quando há menos de 30.
Dica: se você deseja criar uma métrica que conte o número de valores de um atributo, a fórmula da métrica deve ser simplesmente [Atributo]. Você pode então aplicar o agregador COUNT normalmente.
|
| DCOUNT_VALUES(_atributo) | Conta o número distinto de valores diferentes do atributo inserido. Pode ser usada como uma condição em métricas e atributos calculados, mas não pode ser usado na cláusula THEN de uma métrica calculada. Exemplo: IF COUNT_VALUES([Nome da organização])>100 THEN 1 ELSE 0 ENDIF O exemplo acima retorna 1 quando há mais de 100 organizações distintas e 0 quando há menos de 100.
Dica: se você deseja criar uma métrica que conte o número de valores distintos de um atributo, a fórmula da métrica deve ser simplesmente [Atributo]. Você pode então aplicar o agregador D_COUNT normalmente.
|
| ATTRIBUTE_FIX(agregador(nome da métrica), atributo1, atributo2) |
Retorna o valor de agregador(nome da métrica), agregado pelos atributos que você especificou; nesse exemplo, atributo1 e atributo2. Nenhum outro atributo pode afetar os resultados dessa métrica. Os atributos calculados não podem ser usados dentro da função ATTRIBUTE_FIX. Exemplo: ATTRIBUTE_FIX(MED(Tempo da primeira resposta (min), [Criação do ticket - ano], [Criação do ticket - mês]) Para obter mais ajuda e exemplos, consulte Trabalho com funções de nível de agregação. |
| ATTRIBUTE_ADD(agregador(nome da métrica), atributo1, atributo2) |
Retorna o valor de agregador(nome da métrica), agrupado pelos atributos no relatório em complemento a atributo1 e atributo2. Os atributos calculados não podem ser usados dentro da função ATTRIBUTE_ADD. Exemplo: ATTRIBUTE_ADD(MED(Tempo da primeira resposta (min), [Criação do ticket - ano], [Criação do ticket - mês]) Para obter mais ajuda e exemplos, consulte Trabalho com funções de nível de agregação. |
Funções de tag
Estas funções ajudam você a pesquisar pela presença ou ausência de tags. Isso inclui tags de tickets, tags de chamadas ou tudo que usa tags.
| Função | Descrição |
| INCLUDES_ALL([atributo de tag], "tag1", "tag2") | Retorna TRUE se todas as tags especificadas estiverem inclusas no atributo de tag. Exemplos: INCLUDES_ALL([Tags de ticket], "Londres", "Milão") retorna TRUE se o ticket tem as tags "Londres" e "Milão". NOT INCLUDES_ALL ([Tags de ticket], "Londres", "Milão") retorna TRUE se o ticket não tiver ambas as tags "Londres" e "Milão". Para ver mais exemplos sobre como usar essa função, consulte Relatórios com tags. |
| INCLUDES_ANY([atributo de tag], "tag1", "tag2") | Retorna TRUE se alguma das tags especificadas estiver inclusa no atributo de tag. Exemplos: INCLUDES_ANY([Tags de ticket], "Londres", "Milão") retorna TRUE se o ticket tem as tags "Londres" ou "Milão". NOT INCLUDES_ANY ([Tags de Ticket], "Londres", "Milão") retorna TRUE se o ticket não tiver nenhuma das tags "Londres" ou "Milão". Para ver mais exemplos sobre como usar essa função, consulte Relatórios com tags. |
Funções de texto
Estas funções permitem que você realize operações de pesquisa e avaliação de texto. Também é possível modificar o texto usando fórmulas e padrões criados por você.
Para obter exemplos de como usar algumas dessas funções de texto (como CONTAINS, LEFTPART, SUBSTR, FIND e LENGTH), consulte Receita do Explore: relatórios sobre campos de lista suspensa aninhados.
| Função | Descrição |
| CONTAINS(_texto,_texto_para_pesquisa) | Retorna TRUE se o primeiro parâmetro inserido contiver o segundo como uma subcadeia. Exemplo: CONTAINS([Nome do emissor],"Sally")
|
| ENDSWITH(_texto,_texto_para_pesquisa) | Retorna TRUE se o primeiro texto inserido terminar com o segundo. Exemplo: ENDSWITH([Estado dos EUA],"ippi") retornará TRUE para Mississippi, mas FALSE para Delaware. |
| FIND(_texto,_texto_para_pesquisa,_número_início_índice) |
Retorna o índice, no primeiro texto inserido, da primeira instância do segundo texto inserido a partir do índice inicial inserido. Retorna -1 se o segundo texto inserido não for encontrado. O índice do primeiro caractere de uma cadeia é 0. Exemplos: Se [Modo de transporte]="Urgent", então FIND([Modo de transporte],"Norm",0) retornará -1 Se [Modo de transporte]="Normal", então FIND([Modo de transporte],"ma",0) retornará 3 Se [Modo de transporte]="Urgent", então FIND([Modo de transporte],"ge",2) retornará 0 |
| LEFTPART(_texto,_número) | Retorna o (_número) de caracteres mais à esquerda do texto inserido. Exemplo: Se [Departamento]="Documentos técnicos", então LEFTPART([Departamento],9) retornará "Documentos" |
| LENGTH(_texto) | Retorna o comprimento (número de caracteres) do texto inserido. Exemplo: LENGTH([Categoria de produto]) retornará o comprimento de cada valor do atributo Categoria de produto. |
| LOWERCASE(_texto) | Converte e retorna o texto inserido em caixa baixa. |
| LTRIM(_texto) | Retorna o valor do atributo inserido com todos os espaços em branco mais à esquerda removidos. Exemplo: LTRIM([Nome]) retornaria “Peter” se [Nome] fosse “ Peter ” |
| REPLACE(_texto,_texto_a_substituir,_texto_de_substituição) | Retorna uma cópia de _texto em que todas as instâncias de _texto_a_substituir foram substituídas por _texto_de_substituição. Exemplo: IF [Estado dos EUA]="new York", então REPLACE([Estado dos EUA],"n","N") retornará "New York" |
| RIGHTPART(_texto,_número) | Retorna o _número de caracteres mais à direita no texto inserido. Exemplo: Se [Departamento]="Documentos técnicos", então RIGHTPART([Departamento],13) retornará "técnicos" |
| RTRIM(_texto) | Retorna o valor do atributo inserido com todos os espaços em branco mais à direita removidos. Exemplo: TRIM([Nome]) retornaria “ Peter” se [Nome] fosse “ Peter ” |
| STARTSWITH(_texto,_texto_para_pesquisa) | Retorna TRUE se o primeiro texto inserido começar com o segundo texto inserido. Exemplo: STARTSWITH([Estado dos EUA],"Miss") retornará TRUE para Mississippi, mas FALSE para Delaware. |
| IS_POSITIVE(_texto) | Retorna TRUE para positivo e FALSE para negativo com base na análise do texto. |
| SUBSTR(_texto,_número_início_índice,_número_fim_índice) |
Retorna a parte do _texto que consiste no caractere especificado pelo índice inicial (o primeiro inteiro inserido) e todos os caracteres até o índice final-1 (o segundo inteiro inserido). Exemplo: SUBSTR("Web marketing",0,3) retornará "Web" |
| TRIM(_texto) | Retorna o valor do atributo inserido com todos os espaços em branco à direita e à esquerda removidos. Exemplo: TRIM([Nome]) retornaria “Peter” se [Nome] fosse “ Peter ”: |
| UPPERCASE(_texto) | Converte e retorna o texto inserido em caixa alta. |
| STRING(_número) | Converte o número inserido em uma cadeia de caracteres. |
| LPAD(_texto,_comprimento,_preenchimento) | Adiciona texto à esquerda de _texto com _preenchimento até a cadeia de caracteres estar no valor de _comprimento. Exemplo: LPAD("1",7,"?") retornará "??????1" |
| RPAD(_texto,_comprimento,_preenchimento) | Adiciona texto à direita de _texto com _preenchimento até a cadeia de caracteres estar no valor de _comprimento. Exemplo: RPAD("1",7,"?") retornará "1??????" |
| LINK(_url,_rótulo) | Retorna um link HTML que aponta para a URL inserida. Para ver um exemplo, consulte Receita do Explore: configuração de links clicáveis para tickets. |
Funções de regex
Uma expressão regular (também conhecida como regex ou regexp) é uma sequência de caracteres que define um padrão de pesquisa. O Explore oferece suporte no uso de expressões regulares para realizar os seguintes cálculos em suas fórmulas:
| Função | Descrição |
| REGEXP_MATCH(_texto,_regexp) | Retorna true se o texto corresponder à expressão regular. |
| REGEXP_EXTRACT(_texto,_regexp) | Retorna a parte do texto que corresponde ao grupo de coleta dentro da expressão regular. Para obter um exemplo de como usar essa função, consulte Como crio relatórios sobre o domínio de e-mail do usuário no Explore? |
| REGEXP_REPLACE(_texto,_regexp,_texto_substituição) | Retorna uma cadeia de caracteres na qual qualquer subcadeia de texto que corresponda à expressão regular é substituída por texto_substituição. Exemplo: REGEXP_REPLACE("Ajuda","jud","rar") retornará "Arara" |
Para obter mais informações sobre expressões regulares, consulte esta página da Wikipédia.
Funções de data
O Explore permite que você crie, compare e realize cálculos em datas e horários. Estas funções são especialmente úteis porque é provável que você passe muito tempo analisando as informações da sua empresa em um determinado intervalo de datas.
| Função | Descrição |
| DATE(_texto) | Converte o texto fornecido em uma data com um carimbo de data/hora UTC. O texto inserido pode estar em diversos formatos, mas deve incluir, pelo menos, o mês, o dia e o ano. Exemplos:
|
| DATE_EQUAL(_data,_data) | Retorna TRUE se as duas datas inseridas forem iguais. Exemplo: IF DATE_EQUAL([Criação do ticket - mês],[Resolução do ticket - mês]) THEN [ID do ticket] ENDIF Retorna todos os tickets resolvidos no mesmo mês em que foram criados. O ano não é incluído nesse exemplo. Então um ticket que foi criado em junho de 2018 e resolvido em junho de 2020 será retornado por esse exemplo. |
| DATE_NOT_EQUAL(_data,_data) | Retorna TRUE se as duas datas inseridas forem diferentes. Exemplo: IF DATE_EQUAL([Criação do ticket - mês],[Resolução do ticket - mês]) THEN [ID do ticket] ENDIF Retorna todos os tickets que não foram resolvidos no mesmo mês em que foram criados. |
| DATE_LESS(_data,_data) | Retorna TRUE se a primeira data for anterior à segunda data. Exemplo: IF DATE_LESS([Atribuição do ticket - data],[Vencimento do ticket - data - data]) THEN [ID do ticket] ENDIF Retorna todos os tickets atribuídos antes da data de vencimento deles. |
| DATE_LESS_OR_EQUAL(_data,_data) | Retorna TRUE se a primeira data for anterior ou igual à segunda data. Exemplo: IF DATE_LESS_OR_EQUAL([Atribuição do ticket - data],[Vencimento do ticket - data - data]) THEN [ID do ticket] ENDIF Retorna todos os tickets que foram atribuídos antes ou na data de vencimento. |
| DATE_GREATER(_data,_data) | Retorna TRUE se a primeira data for posterior à segunda data. Exemplo: IF DATE_GREATER([Atribuição do ticket - data],[Vencimento do ticket - data - data]) THEN [ID do ticket] ENDIF Retorna todos os tickets atribuídos após a data de vencimento deles. |
| DATE_GREATER_OR_EQUAL(_data,_data) | Retorna TRUE se a primeira data for posterior ou igual à segunda data. Exemplo: IF DATE_GREATER_OR_EQUAL([Atribuição do ticket - data],[Vencimento do ticket - data - data]) THEN [ID do ticket] ENDIF Retorna todos os tickets que foram atribuídos na data de vencimento ou depois dela. |
| DATE_ADD(_data,_data_parte,_incremento) |
Retorna a data fornecida no fuso horário do usuário, atualizada com o incremento inserido. O parâmetro _data_parte pode ser por exemplo, "year", "quarter", "month", "day", "hour" etc. O incremento inserido deve ser um número inteiro, mas pode ser negativo. |
| DATE_DIFF(_data,_data,_data_parte) | Retorna a diferença relativa ou exata entre duas datas no formato da sua escolha. Na função, _date_part pode ser uma das seguintes: Para diferenças relativas (números inteiros):
Para valores exatos:
Exemplos: DATE_DIFF("2011/10/22","2008/01/06","year") retorna 3 (2011-2008) DATE_DIFF("2011/10/22","2008/01/06","nb_of_years") retorna 4 (contagem real de anos) DATE_DIFF("2019/03/06","2019/03/05","day") retorna 1 DATE_DIFF("2019/03/06","2017/03/05","nb_of_days") retorna 731 |
| DATE_FORMAT(_data,_formato) | Retorna a data inserida no fuso horário do usuário no formato fornecido. Para ver a lista de formatos disponíveis, consulte Formatação de datas. |
| TODAY() | Retorna a data atual no fuso horário do usuário. |
| NOW() | Retorna a data e a hora atuais no fuso horário do usuário (em horas, minutos e segundos). |
| CURRENT_YEAR() | Retorna o ano atual. |
| CURRENT_HALFYEAR() | Retorna o semestre atual como "H1" ou "H2" |
| CURRENT_QUARTER() | Retorna o trimestre atual como "Q1", "Q2", "Q3" ou "Q4" |
| CURRENT_MONTH() | Retorna o mês atual, por exemplo, "janeiro", "fevereiro". |
| CURRENT_MONTH_NUMERIC() | Retorna o mês atual como número, por exemplo, "1" para janeiro, "2" para fevereiro. |
| CURRENT_DAY() | Retorna o dia atual como número. |
| CURRENT_WEEKDAY() | Retorna o dia atual da semana como texto, por exemplo, "segunda-feira", "terça-feira". |
| CURRENT_WEEKDAY_NUMERIC() | Retorna o dia atual da semana como número, por exemplo "0" para domingo, "1" para segunda-feira. |
| CURRENT_HOUR() | Retorna a hora atual no fuso horário do usuário como número. |
| CURRENT_MINUTE() | Retorna o minuto atual no fuso horário do usuário como número. |
| CURRENT_SECOND() | Retorna o segundo atual no fuso horário do usuário como número. |
| YEAR(_data) | Retorna o ano da data fornecida. |
| MONTH(_data) | Retorna o mês da data fornecida como texto, por exemplo, "janeiro", "fevereiro" |
| MONTH_NUMERIC(_data) | Retorna o mês da data fornecida como número, por exemplo, "1" para janeiro e "2" para fevereiro. |
| DAY(_data) | Retorna o dia da data inserida. |
| WEEKDAY(_data) | Retorna o dia da data inserida como cadeia de caracteres, por exemplo, "segunda-feira", "terça-feira". |
| WEEKDAY_NUMERIC(_data) | Retorna o dia da data inserida como número, por exemplo, "1" para domingo e "2" para segunda-feira. |
| HOURS(_data) | Retorna a hora da data inserida. |
| MINUTES(_data) | Retorna o minuto da data inserida. |
| SECONDS(_data) | Retorna o segundo da data inserida. |
| WEEK_NUMBER(_date) | Retorna o número da semana associado à data inserida. Consulte Noções básicas sobre como o início de semana afeta os números da semana. |
| WEEK_NUMBER_MONDAY(_data) | Retorna o número da semana associado à data inserida começando na segunda-feira. |
| WEEK_NUMBER_FRIDAY(_data) | Retorna o número da semana associado à data inserida começando na sexta-feira. |
| WEEK_NUMBER_SATURDAY(_data) | Retorna o número da semana associado à data inserida começando no sábado. |
| WEEK_NUMBER_SUNDAY(_data) | Retorna o número da semana associado à data inserida começando no domingo. |
| START_OF_QUARTER(_data) | Retorna o início do trimestre da data inserida. |
| END_OF_QUARTER(_data) | Retorna o fim do trimestre da data inserida. |
| START_OF_MONTH(_data) | Retorna o início do mês da data inserida. |
| END_OF_MONTH(_data) | Retorna o fim do mês da data inserida. |
| START_OF_WEEK(_date) | Retorna o início da semana da inserida. Consulte Configuração do início da semana para relatórios e filtros. |
| END_OF_WEEK(_date) | Retorna o fim da semana da data inserida. Consulte Configuração do início da semana para relatórios e filtros. |
| START_OF_WEEK_MONDAY(_data) | Retorna o início da semana que corresponde à data inserida, com a semana que começa na segunda-feira. |
| END_OF_WEEK_MONDAY(_data) | Retorna o fim da semana que corresponde à data inserida, com a semana que começa na segunda-feira. |
| START_OF_WEEK_FRIDAY(_data) | Retorna o início da semana que corresponde à data inserida, com a semana que começa na sexta-feira. |
| END_OF_WEEK_FRIDAY(_data) | Retorna o fim da semana que corresponde à data inserida, com a semana que começa na sexta-feira. |
| START_OF_WEEK_SATURDAY(_data) | Retorna o início da semana que corresponde à data inserida, com a semana que começa no sábado. |
| END_OF_WEEK_SATURDAY(_data) | Retorna o fim da semana que corresponde à data inserida, com a semana que começa no sábado. |
| START_OF_WEEK_SUNDAY(_data) | Retorna o início da semana que corresponde à data inserida, com a semana que começa no domingo. |
| END_OF_WEEK_SUNDAY(_data) | Retorna o fim da semana que corresponde à data inserida, com a semana que começa no domingo. |
| DATE_FROM_ISO | Retorna um carimbo de data/hora se o parâmetro for uma cadeia de caracteres de carimbo de data/hora padrão ISO. Assume que o carimbo de data/hora tem um fuso horário, mas carimbos de data/hora sem informações de fuso horário podem ser analisados definindo o parâmetro opcional skip-timezone como TRUE. Exemplos: DATE_FROM_ISO("2020-07-24T13:42:00Z") DATE_FROM_ISO("2020-07-24T13:42EST") DATE_FROM_ISO("2020-07-24T13:42+05") DATE_FROM_ISO("2020-07-24T13:42," TRUE) |
| DATE_FROM_TIMESTAMP(_carimbo) | Retorna a data de um carimbo de data/hora UNIX em segundos. |
| DATE_FROM_MILLI_TIMESTAMP(_carimbo) | Retorna a data de um carimbo de data/hora UNIX em milissegundos. |
| DATE_TO_TIMESTAMP(_data) | Retorna um carimbo de data/hora UNIX no fuso horário do usuário de uma data fornecida. |
| DATE_TO_MILLI_TIMESTAMP(_data) | Retorna um carimbo de data/hora UNIX em milissegundos de uma data. |
| SECONDS_TO_TIME(_hora) | Converte segundos para o formato HH:MM:SS. |
| FISCAL_YEAR(_data,_mês_inicial) | Retorna o ano fiscal de acordo com a data inserida e o mês de início. O parâmetro do mês deve ser o nome completo do mês (por exemplo, "Fevereiro", não "Fev"). |
| FISCAL_QUARTER(_data,_mês_inicial) | Retorna o trimestre fiscal de acordo com a data inserida e o mês de início. O parâmetro do mês deve ser o nome completo do mês (por exemplo, "Fevereiro", não "Fev"). |
| FISCAL_WEEK_NUMBER(_data,_mês_inicial) | Retorna o número da semana fiscal com base na data inserida e no mês de início. O parâmetro do mês deve ser o nome completo do mês (por exemplo, "Fevereiro", não "Fev"). |
| WEEKYEAR(_data) | Retorna o ano do número da semana associado à data inserida. |
| DATE_FIRST(atributo de tempo) |
Retorna a data ou carimbo de data/hora mais antigo de acordo com os atributos adicionados ao relatório e é afetada por todos os filtros aplicados. Exemplo: DATE_FIRST([Atualização - carimbo de data/hora]) Retorna o carimbo de data/hora da primeira atualização levando em conta todos os atributos adicionados ao relatório. Para obter mais ajuda e exemplos, consulte Trabalho com as funções de data mais antigas e mais recentes. |
| DATE_LAST(atributo de tempo) |
Retorna a data ou carimbo de data/hora mais recente de acordo com os atributos adicionados ao relatório e é afetada por todos os filtros aplicados. Exemplo: DATE_LAST([Atualização - carimbo de data/hora]) Retorna o carimbo de data/hora da atualização mais recente levando em conta todos os atributos adicionados ao relatório. Para obter mais ajuda e exemplos, consulte Trabalho com as funções de data mais antigas e mais recentes. |
| DATE_FIRST_FIX(atributo de tempo, atributo1, atributo2, ...) |
Retorna a data ou carimbo de data/hora mais antigo de acordo com os atributos especificados na função. Os atributos adicionados ao relatório não afetarão o cálculo, mas todos os filtros aplicados serão levados em consideração. Exemplo: DATE_FIRST_FIX([Atualização - carimbo de data/hora], [ID do ticket da atualização]) Retorna o carimbo de data/hora da primeira atualização por ticket, independentemente dos atributos do relatório. Para obter mais ajuda e exemplos, consulte Trabalho com as funções de data mais antigas e mais recentes. |
| DATE_LAST_FIX(atributo de tempo, atributo1, atributo2, ...) |
Retorna a data ou carimbo de data/hora mais recente de acordo com os atributos especificados na função. Os atributos adicionados ao relatório não afetarão o cálculo, mas todos os filtros aplicados serão levados em consideração. Exemplo: DATE_LAST_FIX([Atualização - carimbo de data/hora], [ID do ticket da atualização]) Retorna o carimbo de data/hora da atualização mais recente por ticket, independentemente dos atributos do relatório. Para obter mais ajuda e exemplos, consulte Trabalho com as funções de data mais antigas e mais recentes. |
Formatação de datas
A função DATE_FORMAT retorna carimbos de data/hora completos como diferentes tipos de data. Cada formato é representado por uma letra diferente. Insira a letra associada na parte do formato da função DATE_FORMAT. Todo o texto deve ser inserido entre aspas duplas. É possível combinar componentes de data ou hora para exibir mais informações sobre uma data.
Por exemplo, para alterar o formato padrão (2015-01-27T13:21:10) do atributo Ticket criado - Carimbo de data/hora para um formato no estilo dos EUA (Jan 27, 2015 01:21 PM), use esta fórmula:
DATE_FORMAT([Ticket created - Timestamp],"Mon DD, YYYY hh:MI AM")
A tabela mostra os formatos disponíveis. Os exemplos usam o carimbo de data/hora 2017-11-03T15:18:25.
| Componente de data ou hora | Letra | Exemplo usando 2017-11-03T15:18:25 |
| Ano | YYYY | 2017 |
| Ano | YY | 17 |
| Trimestral | Q | 4º TRI |
| Número do mês | MM | 11 |
| Nome do mês | Mon | Nov |
| Nome do mês | Mensalmente | novembro |
| Semana do ano (1–53) | WW | 44 |
| Semana do mês (1-5) | L | 1 |
| Número do dia do ano (01-366) | DDD | 307 |
| Número do dia do mês (01-31) | DD | 3 |
| Nome do dia da semana | Dia | Sexta-feira |
| Nome do dia da semana | Dy | Sex |
| Hora do dia (01-12) | hh | 3 |
| Hora do dia (1-23) | HH | 15 |
| Minutos | MI | 18 |
| Segundos | SS | 25 |
| Milissegundo (000-999) | MS | 0 |
| Indicador meridiano (AM ou PM) | AM | PM |
Funções numéricas
Estas funções permitem que você realize diversos tipos de cálculos matemáticos nas informações em seus relatórios.
| Função | Descrição |
| ABS(_número) | Retorna o valor absoluto do número inserido.
Exemplos: O valor absoluto de 1 é 1 O valor absoluto de -7,3 é 7,3 |
| BETWEEN(_número,_número,_número) | Retorna TRUE se o primeiro número inserido estiver entre os outros dois números. Exemplo: BETWEEN(SUM(Lucro),500,1500) retornará TRUE se SUM(Lucro) for igual a ou estiver entre 500 e 1500. |
| CEIL(_número) | Retorna o teto do número inserido. O teto de um número é o valor inteiro maior e mais próximo ou igual. Exemplos: O teto de 125,4 é 126 O teto de -63,2 é -63 CEILING(SUM(Tempo da primeira resolução - minutos)) retornará o valor inteiro maior e mais próximo para cada tempo da primeira resolução armazenado no atributo. |
| EXP(_número) | Retorna o valor da base do logaritmo natural (e) elevado à potência do expoente inserido. Exemplo: EXP(SUM(Preço unitário)) retornará o logaritmo natural de cada valor da métrica SUM (Preço unitário). |
| FLOOR(_número) | Retorna o piso do número inserido. O piso de um número é seu valor inteiro menor e mais próximo ou igual. Exemplos: O piso de 125,4 é 125 O piso de -63,2 é -64 FLOOR(SUM(Tempo da primeira resolução - minutos)) retornará o inteiro menor e mais próximo de cada tempo da primeira resolução armazenado no atributo. |
| INTEGER(_param) | Retorna o inteiro do número não inteiro inserido. Exemplo: INTEGER(1,56) retornará 1 |
| IS_NUMBER(_param) | Retorna TRUE se o parâmetro determinado for um número (inteiro ou decimal) e FALSO se não for. Exemplos:
|
| MAXIMUM(_número,_número) | Retorna o maior valor entre os dois parâmetros inseridos. MAXIMUM(SUM(Receitas),SUM(Despesas)) retornará o maior valor entre Receitas e Despesas. |
| MINIMUM(_número,_número) | Retorna o menor valor entre os dois parâmetros inseridos. MINIMUM(SUM(Receitas),SUM(Despesas)) retornará o menor valor entre Receitas e Despesas. |
| NUMBER(_param) |
Retorna a representação numérica de um parâmetro fornecido ou retorna NaN quando não puder ser exibido como número. Exemplos: NUMBER("3.14116") retornará 3,14116 NUMBER([Categoria de caixa]) retornará a representação numérica do valor atual do atributo Categoria de caixa. |
| PI() |
Retorna a constante matemática para a proporção da circunferência de um círculo para seu diâmetro, expressa como PI. O valor é de 3,141592653589793. |
| POWER(_número,_número) | Calcula e retorna o primeiro número inserido elevado a potência do segundo número inserido. Exemplo: IF SUM(Preço unitário)=2, então POWER(SUM(Preço unitário),3) retornará 8 |
| RANDOM() |
Retorna um número pseudoaleatório 'n' onde 0<=n<1. Se você precisar de um inteiro aleatório, use a fórmula Round(Random()*100). |
| ROUND(_número) |
Arredonda o valor do número inserido para cima ou para baixo em relação ao inteiro mais próximo. Se equidistante, o valor é arredondado para cima. |
| SIGN(_número) |
Retorna -1 se o número for negativo, 0 se for zero e 1 se positivo. |
| SQRT(_número) | Calcula e retorna a raiz quadrada do número inserido. |
| SQUARE(_número) | Calcula e retorna o quadrado do número inserido. |
| LN(_número) | Retorna o logaritmo natural do número inserido. |
| LOG10(_número) | Retorna o logaritmo de base -10 do número inserido. |
| LOG2(_número) | Retorna o logaritmo de base -2 do número inserido. |
| LOG(_base,_número) | Retorna o logaritmo do número inserido para a base inserida. |
Funções trigonométricas
Estas funções ajudam você a criar fórmulas avançadas para calcular ângulos e distâncias.
| Função | Descrição |
| ACOS(_número) | Calcula o cosseno do arco do número inserido em radianos. |
| ASIN(_número) | Calcula o seno do arco do número inserido em radianos. |
| ATAN(_número) | Retorna o valor, em radianos, do ângulo com a tangente inserida no parâmetro. O valor retornado está entre PI/2 negativo e PI/2 positivo. |
| ATAN2(_número,_número) | Retorna o ângulo do ponto Y/X em radianos, quando medido em sentido anti-horário a partir do eixo X de um círculo (0,0 representa o centro do círculo). O valor de retorno está entre PI positivo e PI negativo. Insere a coordenada Y como o primeiro parâmetro. |
| COS(_número) | Calcula o cosseno do número inserido em radianos. |
| DEGREES(_número) | Converte o número fornecido de radianos para graus. |
| RADIANS(_número) | Converte o número fornecido de graus para radianos. |
| SIN(_número) | Calcula o seno do número inserido em radianos. |
| TAN(_número) | Retorna a tangente do ângulo inserido. |