In Explore, puoi scrivere formule che potenziano metriche e attributi personalizzati. È importante scrivere correttamente le formule per garantirne il corretto funzionamento. Se una formula non è corretta, l’editor formule mostra un messaggio di errore in tempo reale. Il messaggio di errore identifica il problema e fornisce indicazioni su come risolverlo.
Questo articolo spiega come correggere una formula configurata in modo errato nei report. Elenca i messaggi di errore nell’editor formule e fornisce consigli su come correggere la formula, inclusi esempi di formule errate e corrette.
Questo articolo include i seguenti argomenti:
- Correzione di formule configurate in modo errato
- Tipi di messaggi di errore nell’editor delle formule
Articoli correlati:
Correzione di formule configurate in modo errato
Se una metrica o un attributo calcolato contiene una formula configurata in modo errato, non invia risultati. Identifica le formule configurate in modo errato controllando queste posizioni:
- Libreria report: i report che usano una formula configurata in modo errato vengono visualizzati nella categoria Aggiornamenti obbligatori nella libreria Report
- Libreria dashboard: i dashboard che usano i report interessati vengono visualizzati nella scheda Aggiornamenti necessari nella libreria dashboard
- Creazione report: un messaggio di avviso viene visualizzato nella parte inferiore di un report che usa la formula
- Editor formule: nell'editor formule viene visualizzato un messaggio di avviso relativo alla formula interessata
Per correggere una formula configurata in modo errato, apri un report in cui viene utilizzata e modificala nell’editor formule. A questo punto ripubblica i dashboard in cui viene usato il report.
) e selezionando Creato da.Per aggiornare una formula configurata in modo errato
- In Explore, fai clic sull’icona Report (
) per aprire la libreria Report. -
Fai clic sulla scheda Aggiornamenti obbligatori.
- Fai clic su uno dei report elencati per aprirlo.
- Per ogni metrica o attributo calcolato:
- Fai clic sulla metrica o sull’attributo e poi sull’icona a forma di matita.
-
Controlla la formula per identificare eventuali configurazioni errate. Le parti della formula configurate in modo errato sono sottolineate. Un messaggio di errore indica cosa deve essere corretto.
- (Facoltativo) Crea una copia della metrica o dell’attributo prima di apportare modifiche. Questo previene eventuali effetti sui report esistenti durante la risoluzione dei problemi.
-
Risolvi i problemi con la formula specificata nel messaggio di errore. Consulta le sezioni seguenti per avere ulteriori indicazioni sui messaggi di errore specifici.
Quando si corregge la formula di una metrica calcolata o di un attributo in un report, la si corregge anche in tutti gli altri report in cui viene utilizzata.
- (Facoltativo) Se hai creato una copia della metrica o dell’attributo, aggiorna l’originale.
- Salva il report
Per ripubblicare i dashboard interessati
- Fai clic sull’icona Dashboard (
) per aprire la libreria Dashboard - Fai clic sulla scheda Aggiornamenti obbligatori
- Posiziona il cursore del mouse su uno dei dashboard e fai clic su Modifica
- Nel dashboard, fai clic sulla freccia del menu a discesa accanto a Condividi e seleziona Pubblica. La prossima volta che gli utenti accederanno al dashboard condiviso, vedranno l’ultima versione
- Fai clic su Pubblica
Tipi di messaggi di errore nell’editor delle formule
Questa sezione illustra i seguenti messaggi di errore e offre consigli su come risolverli:
Errori di formula più comuni
Consulta le sezioni seguenti per avere ulteriori indicazioni sui messaggi di errore specifici.
Messaggi di errore di sintassi generici
Se visualizzi il seguente messaggio di errore, la sintassi della formula non è corretta:
-
“Si è verificato un problema con la formula. Controlla la sintassi di calcolo e riprova”.
Nella tabella seguente sono riportati i motivi più comuni di questo errore.
| Motivo | Formula errata | Formula corretta |
|---|---|---|
| Hai aperto una parentesi tonda o quadra senza chiuderla, oppure ne hai chiuse più di quante ne hai aperte. | IF ([Stato ticket] = "Risolto")) THEN [ID ticket] ENDIF | IF ([Stato ticket] = "Risolto") THEN [ID ticket] ENDIF |
| Hai aperto ma non hai chiuso le virgolette. | [Stato ticket] = "Risolto | [Stato ticket] = "Risolto” |
| Non hai inserito l’attributo tra parentesi. | Stato ticket = “Risolto” | [Stato ticket] = "Risolto” |
| Non hai aggiunto un aggregatore davanti a una metrica. | Tempo di prima risposta (min) | SUM(Tempo di prima risposta (min)) |
| Una parte essenziale dell’istruzione IF non è presente. In questo esempio, la parte ENDIF è mancante. | IF ([Stato ticket] = "Risolto") THEN [ID ticket] | IF ([Stato ticket] = "Risolto") THEN [ID ticket] ENDIF |
Messaggi di errore relativi al tipo di dati
Le tabelle seguenti mostrano i messaggi di errore relativi ai tipi di dati nell’editor formule, comprese le versioni errate e corrette di una formula.
Le sezioni seguenti trattano i messaggi di errore relativi ai tipi di dati:
Espressioni uguale, diverso e minore o maggiore di
| Esempio di messaggio di errore | Formula errata | Formula corretta |
|---|---|---|
| Impossibile usare [Fase progetto] come testo e 1 come numero. Usa lo stesso tipo. | [Fase progetto]=1 |
[Fase progetto]="1" Usa lo stesso tipo di dati su entrambi i lati dell’espressione di uguaglianza. Un valore racchiuso tra virgolette è un testo, mentre un numero senza virgolette è un numero. Poiché la fase del progetto è un attributo di testo, il valore deve essere racchiuso tra virgolette. |
| Impossibile usare [Paese ticket] come testo e [Codice Paese utente] come numero. Usa lo stesso tipo. | [Paese ticket]!=[Codice Paese utente] |
[Paese ticket]!=[Nome Paese utente] Usa lo stesso tipo di dati su entrambi i lati dell’espressione di disuguaglianza. Il Paese ticket è rappresentato dal testo, quindi anche l’attributo a destra dovrebbe avere lo stesso formato.. |
| Impossibile usare [Ticket assegnato - Data] come testo e 26 come numero. Usa solo numeri o solo testo. | [Ticket assegnato - Data] >= 26 |
[Ticket assegnato - Data] >= "2023-01-26" Usa lo stesso tipo di dati su entrambi i lati dell’espressione maggiore o uguale a. In questo caso, si tratta di una data racchiusa tra virgolette. |
| Impossibile usare VALUE(Risposte agente) come numero e 2 come testo. Usa solo numeri o solo testo. | VALUE(Risposte agente)<"2" |
VALUE(Risposte agente)<2 Usa lo stesso tipo di dati su entrambi i lati dell’espressione minore di. Un valore racchiuso tra virgolette è un testo, mentre un numero senza virgolette è un numero. Poiché Risposte agente è una metrica, il valore deve essere un numero, quindi non usare le virgolette. |
Operazioni aritmetiche e unione dei valori di testo
| Esempio di messaggio di errore | Formula errata | Formula corretta |
|---|---|---|
| Impossibile usare [Gruppo ticket] come testo e [ID ticket] come numero. Usa solo numeri o solo testo. Se necessario, usa la funzione STRING per trasformare i numeri in testo oppure la funzione NUMBER per trasformare il testo in numeri. | [Gruppo ticket]+[ID ticket] |
[Gruppo ticket]+STRING([ID ticket]) Questa formula unisce il testo come mostrato nella Procedura di Explore: Unione attributi. Trasforma l’attributo numerico in testo tramite la funzione STRING. |
| Impossibile usare VALUE(Tempo di soluzione completa (min)) come numero e [Tempo di attività aggiuntivo] come testo. Usa solo numeri o solo testo. Se necessario, usa la funzione STRING per trasformare i numeri in testo oppure la funzione NUMBER per trasformare il testo in numeri. | VALUE(Tempo di soluzione completa (min))+[Tempo di attività aggiuntivo] |
VALUE(Tempo di soluzione completa (min))+NUMBER([Tempo di attività aggiuntivo]) Questa formula somma due valori. Tempo di soluzione completa (min) è un numero, mentre Tempo di attività aggiuntivo è un campo di testo che contiene valori numerici. L’approccio migliore consiste nel creare un nuovo campo numerico personalizzato in Support per registrare il tempo di attività aggiuntivo, utilizzabile direttamente in Explore senza necessità di modifiche. In alternativa, converti l’attributo di testo in un numero tramite la funzione NUMBER. |
| Impossibile usare VALUE(Tempo di prima risposta (min)) come numero e "60" come testo. Usa solo numeri. | VALUE(Tempo di prima risposta (min)))/"60" |
VALUE(Tempo di prima risposta (min))/60 Le operazioni aritmetiche come la divisione richiedono valori numerici. Un valore racchiuso tra virgolette è un testo, mentre un numero senza virgolette è un numero. Non usare le virgolette qui. |
| Impossibile usare COUNT(Commenti) come numero e [Commento pubblico] come testo. Usa solo numeri. | COUNT(Commenti)-[Commento pubblico] |
COUNT(Commenti)-COUNT(Commenti pubblici) Le operazioni aritmetiche come la sottrazione richiedono valori numerici. Commento pubblico è un attributo di testo. Usa una metrica. |
Funzioni
| Esempio di messaggio di errore | Formula errata | Formula corretta |
|---|---|---|
| Impossibile usare tipi diversi nell’istruzione THEN. 1 è il numero e "0" è il testo. Usa lo stesso tipo | IF [Stato ticket]="Aperto" THEN 1 ELSE "0" ENDIF |
IF [Stato ticket] = "Aperto" THEN 1 ELSE 0 ENDIF oppure IF [Stato ticket] = "Aperto" THEN "1" ELSE "0" ENDIF I valori dopo le parole chiave THEN ed ELSE devono essere dello stesso tipo. Le virgolette indicano che si tratta di un testo; in loro assenza, si tratta di un numero. Risolvi questo errore in uno dei due modi indicati sopra. |
| Impossibile usare 1 e 2 come numeri. Usa solo valori booleani | IF 1 O 2 THEN [ID ticket] ENDIF |
IF VALUE(Risposte agente) = 1 OR VALUE(Risposte agente) = 2 THEN [ID ticket] ENDIF Le condizioni all’interno dell’istruzione IF devono essere TRUE o FALSE. La sintassi corretta è: IF TRUE O FALSE THEN [ID ticket] ENDIF. Aggiungi le condizioni. L’editor formule non valuta la validità delle condizioni stesse. |
| Non è possibile usare il numero in questa funzione. Usa il testo | NUMBER([ID ticket]) |
NUMBER([ID esterno ticket]) La funzione NUMBER trasforma in testo gli attributi di testo con valori numerici. L’attributo ID ticket è un campo numerico e non può essere usato con questa funzione. Possono invece esserlo gli attributi di testo, come ID ticket esterno. |
| Impossibile utilizzare testo o booleano in questa funzione. Usa testo, testo o numero | LINK("https://subdomain.zendesk.com/agent/organizations/" + STRINGA([ID organizzazione ticket]), [Casella di spunta organizzazione]) |
LINK(“https://yoursubdomain.zendesk.com/agent/organizations/” + STRING([ID organizzazione ticket]), [Nome organizzazione ticket]) oppure LINK(“https://yoursubdomain.zendesk.com/agent/organizations/” + STRING([ID organizzazione ticket]), STRING([Casella di spunta organizzazione])) La funzione LINK richiede un testo come secondo parametro. Non usare un attributo booleano. Usa un attributo di testo o trasforma l’attributo booleano tramite la funzione STRING. |
| Impossibile usare [Ticket creato - mese] come testo in questa sezione. Usa il tipo data/ora | DATE_LAST([Ticket creato - mese]) |
DATE_LAST([Ticket creato - data/ora]) La funzione DATE_LAST prevede un attributo timestamp. |
| Impossibile usare tipi di condizioni diversi. Usa tipo testo | SWITCH ([Gruppo ticket]) {CASE "Support": "1" CASO 3: "2" } |
SWITCH ([Gruppo ticket]) {CASE "Support": "1" CASE "3": "2" } Poiché il gruppo Ticket è un attributo di testo, le condizioni di tutti i casi devono essere di tipo testo. Racchiudi il numero 3 tra virgolette per visualizzarlo come testo. |
| Impossibile usare tipi diversi nell’istruzione SWITCH. "1" è il testo e 2 è il numero. Usa lo stesso tipo | SWITCH ([Gruppo ticket]) {CASE "Support": "1" CASE "IT": 2 } |
SWITCH ([Gruppo ticket]) {CASE "Support": "1" CASE "IT": "2" } I risultati di tutti i casi devono essere dello stesso tipo. Racchiudi il numero 2 tra virgolette per visualizzarlo come testo. |
| Non puoi usare tipi diversi nell’array. Usa lo stesso tipo | IN([Istanza segmento], ARRAY(1, "2", "3")) |
IN([Istanza segmento], ARRAY(1, 2, 3)) Usa le virgolette per tutti i valori se si tratta di un attributo di testo oppure non usarle se si tratta di un attributo numerico. L’istanza segmento è un valore numerico, quindi non usare le virgolette. |
| Unità di tempo non valida per le date specificate | DATE_DIFF([Soluzione ticket - Data], [Creazione ticket - Data], "minuti") | Quando usi la funzione DATE_DIFF, assicurati che l’unità di tempo (terzo parametro) corrisponda alla precisione dei campi data. Per le date senza dettagli temporali (ore, minuti), sono consentiti solo "anno", "mese" o "giorno". L’uso di unità non supportate, come "minuti", genera un errore. |
Messaggi di errore dell’aggregatore di metriche
| Esempio di messaggio di errore | Formula errata | Formula corretta |
|---|---|---|
| Impossibile usare l’aggregatore SUM(metrica di database). Usa l’aggregatore VALUE o la funzione ATTRIBUTE_FIX o ATTRIBUTE_ADD. | IF SUM(Tempo di attesa richiedente (min))>120 THEN "Tempo di attesa lungo" ELSE "Tempo di attesa breve" ENDIF |
IF VALUE(Tempo di attesa richiedente (min))>120 THEN "Tempo di attesa lungo" ELSE "Tempo di attesa breve" ENDIF Questo messaggio di errore viene visualizzato negli attributi calcolati, non nelle metriche. Usa l’aggregatore VALUE qui. |
| Impossibile usare l’aggregatore COUNT(Ticket risolti). Usa l’aggregatore VALUE o racchiudi le metriche nella funzione ATTRIBUTE_FIX o ATTRIBUTE_ADD. | IF COUNT(Ticket risolti)>1 THEN "Risolto" ELSE "Non risolto" ENDIF |
IF ([Stato ticket - Non in ordine] = "Risolto" OR [Stato ticket - Non in ordine] = "Chiuso") THEN "Risolto" ELSE "Non risolto" ENDIF Questo messaggio di errore viene visualizzato negli attributi calcolati. Risolvi il problema usando le stesse condizioni della metrica Ticket risolti. |
| Impossibile usare COUNT(Assegnazioni ticket a Dev) in un attributo calcolato. Racchiude la metrica nella funzione ATTRIBUTE_FIX o ATTRIBUTE_ADD. | IF COUNT(Assegnazioni ticket a Dev)>1 THEN "Risolto" ELSE "Non risolto" ENDIF |
IF ATTRIBUTE_FIX(COUNT(Assegnazioni ticket a Dev), [ID ticket aggiornamento])>1 THEN "Escalation multiple" ELSE "Una o nessuna escalation" ENDIF Questo messaggio di errore viene visualizzato negli attributi calcolati. Se la formula originale è complessa, usa la funzione ATTRIBUTE_FIX per specificare i livelli di aggregazione. Il calcolo va eseguito a livello di ID ticket aggiornamento. |
| Tempo nello stato contiene già degli aggregatori. Sostituisci AVG con SUM oppure assicurati che Tempo nello stato contenga solo aggregatori VALUE. | AVG(Tempo nello stato) |
SUM(Tempo nello stato) Il tempo nello stato è una metrica nidificata che ha già un aggregatore. Il calcolo di una media su una mediana non è consentito. Imposta l’aggregatore di livello superiore su SUM o l’aggregatore di livello inferiore su VALUE. |
Altri messaggi di errore
| Esempio di messaggio di errore | Formula errata | Formula corretta |
|---|---|---|
| [Stati ticket] non esiste in questo dataset. Controlla se è presente un errore di battitura. | [Stati ticket] ="Risolto" |
[Stato ticket] = "Risolto” I motivi più comuni di questo errore includono:
|
| [Gruppo calcolato] ha una formula configurata in modo errato. Risolvi il problema prima di salvare. | IF [Gruppo calcolato] = "light" THEN TRUE ELSE FALSE ENDIF | Il gruppo calcolato presenta un errore di configurazione. Correggi prima questo errore. |
| Il calcolo fa riferimento a se stesso qui COUNT(Ticket delle vendite). Rimuovilo o sostituiscilo. | COUNT(Ticket delle vendite)/COUNT(Ticket) | Non creare riferimenti circolari. In questo caso, l'utente sta modificando Ticket delle vendite e sta tentando di includerlo nella formula. |
| Ci sono massimo 3 livelli in un calcolo. Rimuovi il calcolo annidato qui: SUM((tempo di seconda risposta) | MED(tempo di seconda risposta) / MED(tempo di prima risposta (min) | La metrica tempo di seconda risposta è annidata. Sono consentiti solo 3 livelli annidati. |
| Impossibile usare [Gruppo ticket] qui. INCLUDES_ALL può essere usato solo per gli attributi dei tag. | INCLUDES_ALL([Gruppo ticket], "Support", "Vendite") |
Le funzioni INCLUDES funzionano solo con gli attributi tag. Per altri attributi, usa la funzione IN. |
| [Metrica calcolata intervallo di date] ha una formula configurata in modo errato. Risolvi il problema prima di salvare. | COUNT([Metrica calcolata intervallo di date]) | Le metriche calcolate con intervallo di date non sono supportate nelle metriche calcolate. Usa invece un calcolo metrica risultato. |
| Non puoi usare [funzione] qui. Usa INCLUDES_ALL o INCLUDES_ANY per gli attributi dei tag. | IF (CONTAINS([Tag ticket],"vendite")) THEN "Vendite" ELSE "Prod" ENDIF |
INCLUDES_ALL([Tag ticket], "Vendite", "Prod") Solo INCLUDES_ALL e INCLUDES_ANY generano report sui tag. |