Quando inizierai a creare metriche e attributi personalizzati, userai molto le funzioni per aiutarti a confrontare, calcolare e manipolare le informazioni aziendali.
Explore offre molte funzioni per aiutarti a lavorare con, ad esempio, date, stringhe di testo, calcoli e altro ancora. Usa questo articolo come riferimento per scoprire le funzioni disponibili e come usarle.
Questo articolo include i seguenti argomenti:
Per cominciare
Quando crei una metrica calcolata o un attributo standard, puoi cercare e selezionare le funzioni. Nella finestra di modifica delle formule, puoi iniziare a digitare il nome di una funzione oppure fare clic su Aggiungi in Funzioni e scegliere la funzione dall’elenco.
Quando la funzione viene aggiunta a una formula, apparirà con valori standard. Devi sostituirli con i valori da usare nella formula. In questo esempio, si desidera restituire solo i ticket con l'oggetto che inizia con "[Segnalato]".
- Nel menu Calcoli (
), fai clic su Attributo calcolato standard. - Assegna un nome all’attributo calcolato. Questo esempio usa L’oggetto inizia con [Segnalato].
- In Funzioni, fai clic su Aggiungi.
- Nella finestra della formula, digita IF.
- In Funzioni, fai clic su Aggiungi.
- Cerca LEFTPART. Usa la casella di ricerca e fai clic su Filtra per ridurre i valori alla categoria Testo oppure scorri l’elenco fino a trovare la funzione desiderata.
- Accanto a LEFTPART, fai clic su +.
- Ora vedrai la formula IF LEFTPART(_text,_number). Cambia il parametro _text nell’attributo Oggetto ticket. Evidenzia _text e quindi scegli Oggetto ticket dal menu Campi oppure modifica la formula manualmente per aggiungere l’attributo.
La formula ora sarà IF LEFTPART([Oggetto ticket],_number)
- Cambia il text _number con il numero di caratteri da confrontare. [Segnalato] ha nove caratteri, quindi inserisci 9.
La formula ora sarà IF LEFTPART([Oggetto ticket],9)
- Infine, aggiungi la condizione che stiamo cercando; in questo caso, il testo “[Segnalato]”. La formula finale sarà:
IF LEFTPART([Oggetto ticket],9)="[Segnalato]" THEN [ID ticket] ENDIF
Ora, quando usi questo attributo nel report, verranno restituiti solo i ticket con l'oggetto che inizia con "[Segnalato]".
Per ulteriori informazioni ed esempi, consulta Scrittura di formule Explore.
Operatori matematici di base
Oltre alle funzioni indicate sopra, puoi anche usare i seguenti operatori matematici di base per eseguire calcoli e collegare testo:
| Operatore | Descrizione |
| + | Aggiungi due valori numerici o unisci due stringhe di testo. |
| - | Sottrai un valore da un altro. |
| * | Moltiplica due valori |
| / | Dividi un valore per un altro |
| = | Verifica se un valore è uguale a un altro valore |
| != | Verifica se un valore è diverso da un altro |
| > |
Verifica se il primo valore è maggiore del valore seguente (x>y) |
| < |
Verifica se il primo valore è inferiore al valore seguente (x<y) |
| >= |
Verifica se il primo valore è maggiore o uguale al valore seguente (x>=y) |
| <= |
Verifica se il primo valore è minore o uguale al valore seguente (x<=y) |
| % | Calcola il modulo (o remainder) dopo aver diviso un valore per un altro. Esempio: 5%2 restituisce 1, 20%3 restituisce 2 |
Funzioni logiche
Queste funzioni offrono una grande flessibilità nell’analisi e nella presentazione delle informazioni esattamente come desideri.
| Funzione | Descrizione |
| Espressione condizionale IF THEN ELSE | Permette di valutare valori logici. Formato: IF (condizione) THEN (valore se true) ELSE (valore se false) ENDIF Per informazioni dettagliate su questa funzione, consulta Uso della funzione IF THEN ELSE. |
| E | Restituisce TRUE se le due espressioni fornite sono TRUE. Esempio: IF ([Canale ticket]="Email") AND ([Email mittente]="fred@fredco.com") THEN [ID ticket] ENDIF Restituisce tutti i ticket ricevuti tramite email da fred@freedco.com. |
| OPPURE | Restituisce TRUE se almeno una delle espressioni fornite è TRUE. Esempio: IF ([Canale ticket]="Email") OR ([Canale ticket]="Voce") THEN [ID ticket] ENDIF Restituisce tutti i ticket ricevuti tramite i canali email o voce. |
| NOT | Inverte il valore logico dell’espressione fornita. Esempio: IF NOT([Canale ticket]="Email") THEN [ID ticket] ENDIF Restituisce tutti i ticket non ricevuti tramite il canale email. |
| TRUE | Restituisce il valore logico “TRUE”. |
| FALSE | Restituisce il valore logico “FALSE” |
| IN(_param,_array) | Restituisce TRUE se il primo parametro inserito rientra nell’array specificato dal secondo parametro. Esempi: IN(200,ARRAY(100,200,300,400)) restituisce TRUE IN(250,ARRAY(20,40,60,80)) restituisce FALSE |
| Espressione condizionale SWITCH | SWITCH offre un’alternativa di facile comprensione alle istruzioni IF THEN ELSE che hanno più branch. SWITCH (_tested_element) { CASE _value1: _return_value CASE _value2: _return_value DEFAULT: _default_return_value } Per informazioni dettagliate su questa funzione, consulta Aggiunta di più espressioni condizionali con SWITCH. |
Funzioni di attributo
Queste funzioni consentono di eseguire operazioni di base per quantificare il numero di attributi restituiti dal report. Puoi anche eseguire operazioni più avanzate per “bloccare” o estendere il livello di aggregazione dei calcoli.
| Funzione | Descrizione |
| COUNT_VALUES(_attributo) | Conta il numero di valori dell’attributo fornito. I valori ripetuti sono inclusi. Può essere usato come condizione in attributi e metriche calcolate, ma non può essere usato nella clausola THEN di una metrica calcolata. Esempio: IF COUNT_VALUES([ID ticket])>30 THEN 1 ELSE 0 ENDIF L’esempio qui sopra restituisce 1 quando i ticket sono più di 30 e 0 quando i ticket sono meno di 30.
Suggerimento: Se vuoi creare una metrica che conteggi il numero dei valori di un attributo, la formula della metrica deve essere semplicemente [Attributo]. Potrai quindi applicare l’aggregatore COUNT come di consueto.
|
| COUNT_VALUES(_attributo) | Conta il numero distinto di valori diversi dell’attributo fornito. Può essere usato come condizione in attributi e metriche calcolate, ma non può essere usato nella clausola THEN di una metrica calcolata. Esempio: IF COUNT_VALUES([Nome organizzazione])>100 THEN 1 ELSE 0 ENDIF L’esempio qui sopra restituisce 1 quando esistono più di 100 organizzazioni distinte e 0 quando sono meno di 100.
Suggerimento: se vuoi creare una metrica che conti il numero di valori distinti di un attributo, la formula della metrica deve essere semplicemente [Attributo]. Potrai quindi applicare l’aggregatore D_COUNT come di consueto.
|
| ATTRIBUTE_FIX(aggregatore(nome metrica), attributo1, attributo2) |
Restituisce il valore dell’aggregatore(nome metrica) aggregato in base agli attributi specificati (in questo esempio attributo1 e attributo2). Nessun altro attributo può influire sui risultati di questa metrica. Gli attributi calcolati non possono essere usati nella funzione ATTRIBUTE_FIX. Esempio: ATTRIBUTE_FIX(MED(Tempo prima risposta (min), [Ticket creato - Anno], [Ticket creato - Mese]) Per ulteriori informazioni ed esempi, consulta Utilizzo delle funzioni a livello di aggregazione. |
| ATTRIBUTE_ADD(aggregatore(nome metrica), attributo1, attributo2) |
Restituisce il valore dell’aggregatore(nome metrica) aggregato a tutti gli attributi nel report oltre all’ attributo1 e attributo2. Gli attributi calcolati non possono essere usati nella funzione ATTRIBUTE_ADD. Esempio: ATTRIBUTE_ADD(MED(Tempo prima risposta (min), [Ticket creato - Anno], [Ticket creato - Mese]) Per ulteriori informazioni ed esempi, consulta Utilizzo delle funzioni a livello di aggregazione. |
Funzioni di tag
Queste funzioni ti permettono di cercare la presenza o l’assenza di tag. Può includere tag di ticket, tag di chiamata o qualsiasi altro elemento che usi tag.
| Funzione | Descrizione |
| INCLUDES_ALL([attributo tag], "tag1", "tag2") | Restituisce TRUE se tutti i tag specificati sono inclusi nell’attributo tag. Esempi: INCLUDES_ALL([Tag ticket], "Londra", "Milano") restituisce TRUE se un ticket contiene i tag "Londra" e "Milano". NOT INCLUDES_ALL ([Tag ticket], "Londra", "Milano") restituisce TRUE se un ticket non contiene entrambi i tag "Londra" e "Milano". Per altri esempi di utilizzo di questa funzione, consulta Generazione di report con tag. |
| INCLUDES_ANY([attributo tag], "tag1", "tag2") | Restituisce TRUE se uno qualsiasi dei tag specificati è incluso nell’attributo tag. Esempi: INCLUDES_ANY([Tag ticket], "Londra", "Milano") restituisce TRUE se un ticket contiene i tag "Londra" o "Milano". NOT INCLUDES_ANY([Tag ticket], “Londra”, “Milano”) restituisce TRUE se un ticket non contiene i tag “Londra” o “Milano”. Per altri esempi di utilizzo di questa funzione, consulta Generazione di report con tag. |
Funzioni di testo
Queste funzioni ti consentono di eseguire operazioni di ricerca e valutazione del testo. Puoi anche modificare il testo usando formule e schemi creati da te.
Per esempi su come usare alcune di queste funzioni di testo (come CONTAINS, LEFTPART, SUBSTR, FIND e LENGTH), consulta Istruzione di Explore: Generazione di report su campi menu a discesa annidati.
| Funzione | Descrizione |
| CONTAINS(_text,_text_to_search) | Restituisce TRUE se il primo parametro inserito contiene il secondo come sottostringa. Esempio: CONTAINS([Nome mittente],"Sally")
|
| ENDSWITH(_text,_text_to_search) | Restituisce TRUE se il primo testo fornito termina con il secondo testo fornito. Esempio: ENDSWITH([Nazione USA],"ippi") restituisce TRUE per il Mississippi, ma FALSE per il Delaware. |
| FIND(_text,_text_to_find,_number_start_index) |
Restituisce l’indice all’interno del primo testo inserito della prima istanza del secondo testo inserito e specificato dall’indice startIndex. Restituisce -1 se il secondo testo inserito non viene trovato. l’indice del primo carattere di una stringa è 0. Esempi: Se [Modalità spedizione] = “Urgente”, la funzione FIND([Modalità spedizione],“Norm”,0) restituisce -1. Se [Modalità spedizione]="Normale", la funzione FIND([ModalitàSpedizione","ma",0) restituisce 3. Se [Modalità spedizione]="Urgente", la funzione FIND([ModalitàSpedizione","ge",2) restituisce 0 |
| LEFTPART(_text,_number) | Restituisce il _number di caratteri più a sinistra nel testo fornito. Esempio: Se [Reparto]="Documentazione tecnica", allora LEFTPART([Reparto],9) restituisce "Tecnica" |
| LENGTH(_text) | Restituisce la lunghezza (numero di caratteri) del testo fornito. Esempio: LENGTH([Categoria prodotti]) restituisce la lunghezza di ciascun valore con attributo Categoria prodotti. |
| LOWERCASE(_text) | Converte e restituisce il testo fornito in minuscolo. |
| LTRIM(_text) | Restituisce il valore dell’attributo fornito eliminando gli eventuali spazi a sinistra. Esempio: LTRIM([Nome]) restituisce “Peter “ se [Nome] è “ Peter “ |
| REPLACE(_text,_text_to_replace,_text_to_replace_with) | Restituisce una copia di _text in cui tutte le istanze di _text_to_replace sono state sostituite con _text_to_replace_with. Esempio: IF [Stato USA]="new York", allora REPLACE([Stato USA],"n", "N") restituisce "New York" |
| RIGHTPART(_text,_number) | Restituisce il _number di caratteri più a destra nel testo fornito. Esempio: Se [Reparto]="Documentazione tecnica", allora RIGHTPART([Reparto],13) restituisce "documentazione" |
| RTRIM(_text) | Restituisce il valore dell’attributo fornito eliminando gli eventuali spazi a destra. Esempio: TRIM([Nome]) restituisce " Peter" se [Name] è " Peter " |
| STARTSWITH(_text,_text_to_search) | Restituisce TRUE se il primo testo fornito inizia con il secondo testo fornito. Esempio: STARTSWITH([Nazione USA],“Miss”) restituisce TRUE per il Mississippi, ma FALSE per il Delaware. |
| IS_POSITIVE(_text) | Restituisce TRUE per i positivi e FALSE per i negativi in base all’analisi del testo. |
| SUBSTR(_text,_number_start_index,_number_end_index) |
Restituisce parte di _text costituita dal carattere specificato da start index (il primo numero intero inserito) e da tutti i caratteri fino alla fine index-1 (il secondo numero intero inserito). Esempio: SUBSTR(“Web marketing”,0,3) restituisce “Web” |
| TRIM(_text) | Restituisce il valore dell’attributo fornito eliminando gli eventuali spazi a sinistra o a destra. Esempio: TRIM([Nome]) restituisce “Peter” se [Nome] è “ Peter “: |
| UPPERCASE(_text) | Converte e restituisce il testo fornito in maiuscolo. |
| STRING(_number) | Converte il numero fornito in una stringa. |
| LPAD(_text,_length,_pad) | Compone il testo a sinistra di _text con _pad fino a quando la stringa non raggiunge _length. Esempio: LPAD(“1”,7,“?”) restituisce “??????1” |
| RPAD(_text,_length,_pad) | Compone il testo a destra di _text con _pad fino a quando la stringa non raggiunge _length. Esempio: RPAD(“1”,7,“?”) restituisce “1??????” |
| LINK(_url,_label) | Restituisce un link HTML che punta all’URL fornito. Per vedere un esempio, consulta Istruzione di Explore: Configurazione di link selezionabili a ticket. |
Funzioni regex
Un’espressione regolare (detta anche regex o regexp) è una sequenza di caratteri che definisce un modello di ricerca. Explore supporta l’uso di espressioni regolari per eseguire i seguenti calcoli nelle formule:
| Funzione | Descrizione |
| REGEXP_MATCH(_text,_regexp) | Restituisce TRUE se il testo corrisponde all’espressione regolare. |
| REGEXP_EXTRACT(_text,_regexp) | Restituisce la parte di testo che corrisponde al gruppo di acquisizione dell’espressione regolare. Per un esempio di utilizzo di questa funzione, consulta Posso generare report sul dominio email degli utenti in Explore? |
| REGEXP_REPLACE(_text,_regexp,_replace_text) | Restituisce una stringa in cui ogni sottostringa di testo corrispondente all’espressione regolare viene sostituita da replace_text. Esempio: REGEXP_REPLACE("Hello","lo","p") restituisce "Aiuto" |
Per maggiori informazioni sulle espressioni regolari, consulta questa pagina di Wikipedia.
Funzioni di data
Explore permette di creare, confrontare ed eseguire calcoli su date e orari. Queste funzioni sono particolarmente utili perché probabilmente impiegherai molto tempo ad analizzare le informazioni sulla tua azienda in un periodo di tempo stabilito.
| Funzione | Descrizione |
| DATE(_text) | Converte il testo fornito in una data con timestamp di UTC. Il testo inserito può essere in diversi formati, ma deve includere almeno il mese, il giorno e l’anno. Esempi:
|
| DATE_EQUAL(_date,_date) | Restituisce TRUE se le due date sono uguali. Esempio: IF DATE_EQUAL([Ticket creato - Mese],[Ticket risolto - Mese]) THEN [ID ticket] ENDIF Restituisce tutti i ticket risolti nello stesso mese in cui sono stati creati. L'anno non è incluso in questo esempio, quindi un ticket creato a giugno 2018 e risolto a giugno 2020 verrebbe restituito da tale esempio. |
| DATE_NOT_EQUAL(_date,_date) | Restituisce TRUE se le due date non sono uguali. Esempio: IF DATE_EQUAL([Ticket creato - Mese],[Ticket risolto - Mese]) THEN [ID ticket] ENDIF Restituisce tutti i ticket che non sono stati risolti nello stesso mese in cui sono stati creati. |
| DATE_LESS(_date,_date) | Restituisce TRUE se la prima data è precedente alla seconda data. Esempio: IF DATE_LESS([Assegnazione ticket - Data],[Scadenza ticket - Data - Data]) THEN [ID ticket] ENDIF Restituisce tutti i ticket assegnati prima della data di scadenza. |
| DATE_LESS_OR_EQUAL(_date,_date) | Restituisce TRUE se la prima data è precedente o uguale alla seconda data. Esempio: IF DATE_LESS_OR_EQUAL([Assegnazione ticket - Data],[Scadenza ticket - Data - Data]) THEN [ID ticket] ENDIF Restituisce tutti i ticket assegnati prima o alla data di scadenza. |
| DATE_GREATER(_date,_date) | Restituisce TRUE se la prima data è successiva alla seconda data. Esempio: IF DATE_GREATER([Assegnazione ticket - Data],[Scadenza ticket - Data - Data]) THEN [ID ticket] ENDIF Restituisce tutti i ticket assegnati dopo la data di scadenza. |
| DATE_GREATER_OR_EQUAL(_date,_date) | Restituisce TRUE se la prima data è successiva o uguale alla seconda data. Esempio: IF DATE_GREATER_OR_EQUAL([Assegnazione ticket - Data],[Scadenza ticket - Data - Data]) THEN [ID ticket] ENDIF Restituisce tutti i ticket assegnati alla data di scadenza o successivamente. |
| DATE_ADD(_date,_date_part,_increment) |
Restituisce la data specificata nel fuso orario dell’utente, aggiornata in base all’incremento inserito. Il parametro _date_part potrebbe essere, ad esempio, 'anno', 'trimestre', 'mese', 'giorno', 'ora', ecc. L’incremento inserito deve essere un valore intero, ma può essere negativo. |
| DATE_DIFF(_date,_date,_date_part) | Restituisce la differenza relativa o esatta tra due date nel formato scelto. Nella funzione, _date_part può essere uno dei seguenti: Per le differenze relative (numeri interi):
Per i valori esatti:
Esempi: DATE_DIFF("2011/10/22","2008/01/06","year")) restituisce 3 (2011-2008) DATE_DIFF("2011/10/22","2008/01/06","nb_of_years") restituisce 4 (conteggio di anni effettivo) DATE_DIFF("2019/03/06","2019/03/05","day") restituisce 1 DATE_DIFF("2019/03/06","2017/03/05","nb_of_days") restituisce 731 |
| DATE_FORMAT(_date,_format) | Restituisce la data inserita nel fuso orario dell’utente nel formato fornito. Per un elenco dei formati che puoi usare, consulta Formattazione delle date. |
| TODAY() | Restituisce la data corrente nel fuso orario dell’utente. |
| NOW() | Restituisce la data e l’ora correnti nel fuso orario dell’utente (ore, minuti, secondi). |
| CURRENT_YEAR() | Restituisce l’anno corrente. |
| CURRENT_HALFYEAR() | Restituisce il semestre corrente come “S1” o “S2” |
| CURRENT_QUARTER() | Restituisce il trimestre corrente come “T1”, “T2”, “T3” o “T4” |
| CURRENT_MONTH() | Restituisce il mese corrente, ad esempio “gennaio”, “febbraio”. |
| CURRENT_MONTH_NUMERIC() | Restituisce il mese corrente in formato numerico, ad esempio “1” per gennaio, “2” per febbraio. |
| CURRENT_DAY() | Restituisce il giorno corrente in formato numerico. |
| CURRENT_WEEKDAY() | Restituisce il giorno corrente della settimana in formato di testo, ad esempio “lunedì”, “martedì”. |
| CURRENT_WEEKDAY_NUMERIC() | Restituisce il giorno corrente della settimana in formato numerico, ad esempio “0” per domenica, “1” per lunedì. |
| CURRENT_HOUR() | Restituisce l’ora corrente nel fuso orario dell’utente in formato numerico. |
| CURRENT_MINUTE() | Restituisce il minuto corrente nel fuso orario dell’utente in formato numerico. |
| CURRENT_SECOND() | Restituisce il secondo corrente nel fuso orario dell’utente in formato numerico. |
| YEAR(_date) | Restituisce l’anno della data specificata. |
| MONTH(_date) | Restituisce il mese della data specificata, ad esempio “Gennaio”, “Febbraio”. |
| MONTH_NUMERIC(_data) | Restituisce il mese della data specificata in formato numerico, ad esempio “1” per gennaio, “2” per febbraio. |
| DAY(_date) | Restituisce il giorno della data specificata. |
| WEEKDAY(_date) | Restituisce il giorno della data specificata sotto forma di stringa, ad esempio “lunedì”, “martedì”. |
| WEEKDAY_NUMERIC(_date) | Restituisce il giorno della data specificata in formato numerico, ad esempio “1” per domenica, “2” per lunedì. |
| HOURS(_date) | Restituisce l’ora della data specificata. |
| MINUTES(_date) | Restituisce i minuti della data specificata. |
| SECONDS(_date) | Restituisce i secondi della data specificata. |
| WEEK_NUMBER(_date) | Restituisce il numero della settimana associato alla data specificata. Consulta Capire come l'inizio della settimana influisce sui numeri della settimana. |
| WEEK_NUMBER_MONDAY(_date) | Restituisce il numero della settimana associato alla data specificata a partire da lunedì. |
| WEEK_NUMBER_FRIDAY(_date) | Restituisce il numero della settimana associato alla data specificata a partire da venerdì. |
| WEEK_NUMBER_SATURDAY(_date) | Restituisce il numero della settimana associato alla data specificata a partire da sabato. |
| WEEK_NUMBER_SUNDAY(_date) | Restituisce il numero della settimana associato alla data specificata a partire da domenica. |
| START_OF_QUARTER(_date) | Restituisce l’inizio del trimestre per la data specificata. |
| END_OF_QUARTER(_date) | Restituisce la fine del trimestre per la data specificata. |
| START_OF_MONTH(_date) | Restituisce l’inizio del mese per la data specificata. |
| END_OF_MONTH(_date) | Restituisce la fine del mese per la data specificata. |
| START_OF_WEEK(_date) | Restituisce l’inizio della settimana per la data specificata. Consulta Impostazione dell’inizio della settimana per report e filtri. |
| END_OF_WEEK(_date) | Restituisce la fine della settimana per la data specificata. Consulta Impostazione dell’inizio della settimana per report e filtri. |
| START_OF_WEEK_MONDAY(_date) | Restituisce l’inizio della settimana corrispondente alla data fornita, iniziando la settimana da lunedì. |
| END_OF_WEEK_MONDAY(_date) | Restituisce la fine della settimana corrispondente alla data specificata, iniziando la settimana da lunedì. |
| START_OF_WEEK_FRIDAY(_date) | Restituisce l’inizio della settimana corrispondente alla data specificata, iniziando la settimana da venerdì. |
| END_OF_WEEK_FRIDAY(_date) | Restituisce la fine della settimana corrispondente alla data specificata, iniziando la settimana da venerdì. |
| START_OF_WEEK_SATURDAY(_date) | Restituisce l’inizio della settimana corrispondente alla data specificata, iniziando la settimana da sabato. |
| END_OF_WEEK_SATURDAY(_date) | Restituisce la fine della settimana corrispondente alla data specificata, iniziando la settimana da sabato. |
| START_OF_WEEK_SUNDAY(_date) | Restituisce l’inizio della settimana corrispondente alla data specificata, iniziando la settimana da domenica. |
| END_OF_WEEK_SUNDAY(_date) | Restituisce la fine della settimana corrispondente alla data specificata, iniziando la settimana da domenica. |
| DATE_FROM_ISO | Restituisce una data/ora se il parametro è una stringa timestamp standard ISO. Presuppone che la data/ora abbia un fuso orario, ma i valori data/ora senza informazioni sul fuso orario possono essere analizzati impostando il parametro facoltativo skip-timezone su TRUE. Esempi: 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(_timestamp) | Restituisce una data in secondi da un timestamp UNIX specificato. |
| DATE_FROM_MILLI_TIMESTAMP(_timestamp) | Restituisce una data in millisecondi da un timestamp UNIX specificato. |
| DATE_TO_TIMESTAMP(_date) | Restituisce un timestamp UNIX nel fuso orario dell’utente da una data specificata. |
| DATE_TO_MILLI_TIMESTAMP(_date) | Restituisce un timestamp UNIX in millisecondi da una data specificata. |
| SECONDS_TO_TIME(_time) | Converte i secondi nel formato HH:MM:SS. |
| FISCAL_YEAR(_date,_start_month) | Restituisce l’anno fiscale in base alla data specificata e al mese di inizio. Il parametro mese deve essere il nome completo del mese (ad es., “febbraio”, non “feb”). |
| FISCAL_QUARTER(_date,_start_month) | Restituisce il trimestre fiscale in base alla data e al mese di inizio specificati. Il parametro mese deve essere il nome completo del mese (ad es., “febbraio”, non “feb”). |
| FISCAL_WEEK_NUMBER(_date,_start_month) | Restituisce il numero della settimana fiscale in base alla data e al mese di inizio specificati. Il parametro mese deve essere il nome completo del mese (ad es., “febbraio”, non “feb”). |
| WEEKYEAR(_date) | Restituisce l'anno a cui appartiene il numero della settimana relativa alla data specificata. |
| DATE_FIRST(time attribute) |
Restituisce la data o la data/ora meno recente in base agli attributi aggiunti al report ed è soggetto a tutti i filtri applicati. Esempio: DATE_FIRST([Update - Timestamp]) Restituisce la data/ora dell’aggiornamento meno recente tenendo conto di tutti gli attributi aggiunti al report. Per ulteriori informazioni ed esempi, consulta Utilizzo delle funzioni relative alla data meno recente e più recente. |
| DATE_LAST(time attribute) |
Restituisce la data o la data/ora meno recente in base agli attributi aggiunti al report ed è soggetto a tutti i filtri applicati. Esempio: DATE_FIRST([Update - Timestamp]) Restituisce la data/ora dell’ultimo aggiornamento tenendo conto di tutti gli attributi aggiunti al report. Per ulteriori informazioni ed esempi, consulta Utilizzo delle funzioni relative alla data meno recente e più recente. |
| DATE_FIRST_FIX(attributo temporale, attributo1, attributo2, ...) |
Restituisce la data o data/ora meno recente in base agli attributi specificati nella funzione. Gli attributi aggiunti al report non influiranno sul calcolo, ma verranno presi in considerazione gli eventuali filtri applicati. Esempio: DATE_FIRST_FIX([Aggiorna - Data/ora], [ID ticket aggiornamento]) Restituisce la data/ora dell’aggiornamento meno recente per ciascun ticket, indipendentemente dagli attributi del report. Per ulteriori informazioni ed esempi, consulta Utilizzo delle funzioni relative alla data meno recente e più recente. |
| DATE_LAST_FIX(attributo temporale, attributo1, attributo2, ...) |
Restituisce la data o la data/ora più recente in base agli attributi specificati nella funzione. Gli attributi aggiunti al report non influiranno sul calcolo, ma verranno presi in considerazione gli eventuali filtri applicati. Esempio: DATE_LAST_FIX([Aggiorna - Data/ora], [ID ticket aggiornamento]) Restituisce la data/ora dell’aggiornamento più recente per ciascun ticket, indipendentemente dagli attributi del report. Per ulteriori informazioni ed esempi, consulta Utilizzo delle funzioni relative alla data meno recente e più recente. |
Formattazione delle date
La funzione DATE_FORMAT esegue il rendering della data/ora complete come diversi tipi di date. Ogni formato è rappresentato da una lettera diversa. Inserisci la lettera associata nel formato della funzione DATE_FORMAT. Le lettere devono essere inserite tra virgolette doppie. Puoi combinare i componenti data e ora per visualizzare maggiori informazioni su una data.
Ad esempio, per convertire il formato predefinito (2015-01-27T13:21:10) dell’attributo Ticket creato - Data/ora in un formato americano (Gen 27, 2015 01:21 PM), usa questa formula:
DATE_FORMAT([Ticket created - Timestamp],"Mon DD, YYYY hh:MI AM")
La tabella mostra i formati che puoi usare. Negli esempi viene utilizzato il timestamp 2017-11-03T15:18:25.
| Componente data/ora | Lettera | Esempio con 2017-11-03T15:18:25 |
| Anno | YYYY | 2017 |
| Anno | YY | 17 |
| Trimestre | T | T4 |
| Numero del mese | MM | 11 |
| Nome del mese | Lun | Nov |
| Nome del mese | Mese | Novembre |
| Settimana dell'anno (1-53) | WW | 44 |
| Settimana del mese (1-5) | W | 1 |
| Numero del giorno dell'anno (01-366) | DDD | 307 |
| Numero del giorno del mese (01-31) | DD | 3 |
| Nome del giorno della settimana | Giorno | Venerdì |
| Nome del giorno della settimana | Dy | Ven |
| Ora del giorno (01-12) | hh | 3 |
| Ora del giorno (1-23) | HH | 15 |
| Minuti | MI | 18 |
| Secondi | SS | 25 |
| Millisecondi (000-999) | MS | 0 |
| Indicatore Meridiem (AM o PM) | AM | PM |
Funzioni numeriche
Queste funzioni consentono di eseguire una vasta serie di calcoli matematici sulle informazioni contenute nei report.
| Funzione | Descrizione |
| ABS(_number) | Restituisce il valore assoluto del numero fornito.
Esempi: Il valore assoluto di 1 è 1 Il valore assoluto di -7,3 è 7,3 |
| BETWEEN(_number,_number,_number) | Restituisce TRUE se il primo numero fornito è compreso tra gli altri due. Esempio: BETWEEN(SUM(Ricavi),500,1500) restituisce TRUE se SUM(Ricavi) è uguale o compreso tra 500 e 1500. |
| CEIL(_number) | Restituisce il limite massimo del numero fornito. Il limite massimo di un numero è il suo numero intero più vicino o uguale. Esempi: Il limite massimo di 125,4 è 126 Il limite massimo di -63,2 è -63 CEILING(SUM(Tempo prima soluzione (min))) restituisce il numero intero più vicino per ciascun tempo di prima soluzione memorizzato nell’attributo. |
| EXP(_number) | Restituisce il valore della base del logaritmo naturale (e) alla potenza dell’esponente fornito. Esempio: EXP(SUM(Prezzo unitario)) restituisce il logaritmo naturale di ciascun valore della metrica SUM (Prezzo unitario). |
| FLOOR(_number) | Restituisce la parte intera del numero fornito. La parte intera di un numero è il suo intero più lontano o uguale. Esempi: La parte intera di 125,4 è 125 La parte intera di -63,2 è -64 FLOOR(SUM(Tempo prima soluzione (min))) restituisce il valore intero più lontano per ciascun tempo di prima soluzione memorizzato nell’attributo. |
| INTEGER(_param) | Restituisce il numero intero del numero non intero fornito. Esempio: INTEGER(1,56) restituisce 1 |
| IS_NUMBER(_param) | Restituisce TRUE se il parametro specificato è un numero (intero o decimale) e FALSE in caso contrario. Esempi:
|
| MAXIMUM(_number,_number) | Restituisce il più grande dei due parametri forniti. MAXIMUM(SUM(Ricavi),SUM(Spese)) restituisce il maggiore tra ricavi e spese. |
| MINIMUM(_number,_number) | Restituisce il più piccolo dei due parametri forniti. MINIMUM(SUM(Ricavi),SUM(Spese)) restituisce il minore tra ricavi e spese. |
| NUMBER(_param) |
Restituisce il numero che rappresenta il parametro dato oppure restituisce NaN quando non può essere visualizzato come numero. Esempi: NUMBER(“3,14116”) restituisce 3,14116 NUMBER ([Box category]) restituisce il numero del valore corrente dell’attributo categoria Box. |
| PI() |
Restituisce la costante matematica che rappresenta il rapporto tra la circonferenza e il diametro di un cerchio, espressa come pi greco. Il valore è 3,141592653589793. |
| POWER(_number,_number) | Calcola il risultato di una potenza in cui la base corrisponde al primo numero fornito e l’esponente corrisponde al secondo numero fornito. Esempio: Se SUM(Prezzo unitario) = 2, allora la funzione POWER(SUM(Prezzo unitario),3) restituisce 8. |
| RANDOM() |
Restituisce un numero pseudo-casuale n, dove 0<=n<1. Se hai bisogno di un numero intero casuale, usa la formula Round(Random()*100). |
| ROUND(_number) |
Arrotonda il valore del numero fornito per eccesso o per difetto al numero intero più vicino. Se equidistante, il valore viene arrotondato per eccesso. |
| SIGN(_number) |
Restituisce -1 se il numero è negativo, 0 se zero e 1 se positivo. |
| SQRT(_number) | Calcola e restituisce la radice quadrata del numero fornito. |
| SQUARE(_number) | Calcola e restituisce il quadrato del numero fornito. |
| LN(_number) | Restituisce il logaritmo naturale del numero fornito. |
| LOG10(_number) | Restituisce il logaritmo in base 10 del numero fornito. |
| LOG2(_number) | Restituisce il logaritmo in base 2 del numero fornito. |
| LOG(_base,_number) | Restituisce il logaritmo del numero fornito nella base specificata. |
Funzioni trigonometriche
Queste funzioni permettono di creare formule avanzate per misurare angoli e distanze.
| Funzione | Descrizione |
| ACOS(_number) | Calcola l’arcocoseno del numero inserito, in radianti. |
| ASIN(_number) | Calcola l’arcoseno del numero inserito, in radianti. |
| ATAN(_number) | Restituisce il valore in radianti dell’angolo con la tangente inserita nel parametro. Il valore restituito è compreso tra PI/2 negativo e PI/2 positivo. |
| ATAN2(_number,_number) | Restituisce l’angolo del punto Y/X in radianti misurato in senso antiorario dall’asse X di un cerchio (0,0 rappresenta il centro del cerchio). Il valore restituito è compreso fra pi greco positivo e pi greco negativo. Inserisci la coordinata Y come primo parametro. |
| COS(_number) | Calcola il coseno del numero inserito, in radianti. |
| DEGREES(_number) | Converte il numero espresso da radianti a gradi. |
| RADIANS(_number) | Converte il numero espresso da gradi a radianti. |
| SIN(_number) | Calcola il seno del numero inserito, in radianti. |
| TAN(_number) | Restituisce la tangente dell’angolo inserito. |