In Explore, puoi scrivere formule che potenziano metriche e attributi personalizzati. Affinché le formule funzionino correttamente, devono essere create correttamente.
Se la formula non è strutturata correttamente, l’editor delle formule visualizza un messaggio di errore in tempo reale mentre scrivi o modifichi la formula. Il messaggio di errore identifica il problema con la formula e, se possibile, fornisce indicazioni su come risolvere il problema.
Questo articolo elenca i messaggi di errore che potresti incontrare nell’editor delle formule e fornisce ulteriori consigli su come correggere la formula, inclusi esempi di formule errate e corrette.
Questo articolo include i seguenti argomenti:
- Messaggi di errore generali di sintassi
- Messaggi di errore relativi al tipo di dati
- Messaggi di errore dell’aggregatore di metriche
- Altri messaggi di errore
Articoli correlati:
Messaggi di errore generali di sintassi
Se vedi il seguente messaggio di errore, significa che una parte della sintassi nella formula è errata:
- "Si è verificato un problema con la formula. Controlla la sintassi dei calcoli e riprova.
I motivi più comuni di questo errore sono elencati nella tabella seguente.
Motivo | Formula errata | Formula corretta |
---|---|---|
Hai aperto una parentesi o una parentesi ma non l’hai chiusa. Oppure hai chiuso più di quanto hai aperto. | IF ([Stato ticket] = "Solved")) THEN [ID ticket] ENDIF | IF ([Stato ticket] = "Solved") THEN [ID ticket] ENDIF |
Hai aperto ma non chiuso tra virgolette. | [Stato ticket] = "Risolto | [Stato ticket] = "Risolto" |
L’attributo non è racchiuso tra parentesi. | Stato ticket = “Risolto” | [Stato ticket] = "Risolto" |
Non hai aggiunto un aggregatore davanti a una metrica. |
Tempo di prima risposta (min) |
SUM(Tempo prima risposta (min)) |
Manca una parte essenziale dell’istruzione IF. In questo esempio, manca l’ENDIF. |
IF ([Stato ticket] = "Solved") THEN [ID ticket] |
IF ([Stato ticket] = "Solved") 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 che potresti vedere nell’editor delle formule, incluse le versioni errate e corrette di una formula. Per ulteriori informazioni sui tipi di dati, consulta Utilizzo dei tipi di dati nelle formule di Explore.
Le sezioni seguenti trattano i messaggi di errore relativi ai tipi di dati in:
Espressioni uguale, diversa 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" Lo stesso tipo di dati deve essere usato su entrambi i lati dell’espressione di uguaglianza. Un valore racchiuso tra virgolette è considerato 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 [Prefisso Paese utente] come numero. Usa lo stesso tipo. | [Paese ticket]!=[Codice Paese utente] |
[Paese ticket]!=[Nome Paese utente] Lo stesso tipo di dati deve essere usato su entrambi i lati dell’espressione di disuguaglianza. Il Paese del ticket è di testo, quindi anche l’attributo a destra deve essere di testo. |
Impossibile usare [Ticket assegnato - Data] come testo e 26 come numero. Usa solo numeri o solo testo. | [Ticket assegnato - Data] >= 26 |
[Ticket assegnato - Data] >= "26-01-2023" Lo stesso tipo di dati deve essere usato su entrambi i lati dell’espressione maggiore o uguale a. In questo caso, è 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 Lo stesso tipo di dati deve essere usato su entrambi i lati dell’espressione less di. Un valore racchiuso tra virgolette è considerato testo, mentre un numero senza virgolette è un numero. Poiché le risposte degli agenti è una metrica, il valore deve essere un numero, in modo da non usare le virgolette. |
Operazioni aritmetiche e unione di 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]) L’obiettivo di questa formula è unire il testo come mostrato in Ricetta Explore: Attributi di unione. Ecco perché l'attributo numerico deve essere trasformato in testo tramite la funzione STRINGA. |
Impossibile usare VALUE(Tempo di soluzione completa (min)) come numero e [Tempo compito 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 soluzione completa (min))+[Tempo compito aggiuntivo] |
VALUE(Tempo soluzione completa (min))+NUMBER([Tempo compito aggiuntivo]) Lo scopo di questa formula è riassumere due valori. Tempo di soluzione completa (min) è un numero, ma Tempo compito aggiuntivo è un campo di testo contenente valori numerici. L’approccio migliore consiste nel creare un nuovo campo numerico personalizzato in Support per la ricodifica del tempo aggiuntivo del compito, che non richiederà alcuna trasformazione e funzionerà immediatamente in Explore. In alternativa, l’attributo di testo può essere trasformato in un numero mediante la funzione NUMERO. |
Impossibile usare VALUE(Tempo prima risposta (min)) come numero e "60" come testo. Usa solo numeri. | VALUE(Tempo 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 è considerato testo, mentre un numero senza virgolette è un numero. Le virgolette non devono essere usate 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. Il commento public è un attributo di testo. In alternativa, devi usare una metrica. |
Funzioni
Esempio di messaggio di errore | Formula errata | Formula corretta |
---|---|---|
Impossibile usare tipi diversi nell’istruzione THEN. 1 è un numero e “0” è il testo. Usa lo stesso tipo. | IF [Stato ticket]="Open" THEN 1 ELSE "0" ENDIF |
I valori usati dopo le parole chiave THEN ed ELSE devono essere dello stesso tipo. Un valore racchiuso tra virgolette è considerato testo, mentre un numero senza virgolette è un numero. Esistono quindi due modi per correggere questo errore, come mostrato sopra. |
Impossibile usare 1 come numero e 2 come numero. 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 impostate all’interno dell’istruzione IF devono essere TRUE o FALSE. La sintassi corretta è: IF TRUE O FALSE THEN [ID ticket] ENDIF Devi aggiungere alcune condizioni, come mostrato sopra. (Tuttavia, l’editor delle formule non valuta la validità delle condizioni stesse.) |
Impossibile usare il numero in questa funzione. Usa testo. | NUMBER([ID ticket]) |
NUMBER([ID esterno ticket]) La funzione NUMBER è progettata per trasformare in testo gli attributi di testo con valori numerici. L’attributo ID ticket è un campo numerico, motivo per cui non può essere usato con questa funzione. Tuttavia, gli attributi di testo come l’ ID esterno del ticket possono. |
Testo booleano non utilizzabile in questa funzione. Usa testo, testo o numero. | LINK("https://subdomain.zendesk.com/agent/organizations/" + STRING([ID organizzazione ticket]), [Casella di spunta organizzazione]) |
La funzione LINK prevede del testo come secondo parametro, motivo per cui non puoi usare un attributo booleano. Sono disponibili due opzioni, come mostrato sopra. Puoi usare un attributo di testo o trasformare l’attributo booleano in testo tramite la funzione STRINGA. |
Impossibile usare [Creazione ticket - mese] come testo qui. Usa tipo di 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 di testo. | SWITCH ([Gruppo ticket]) {CASE "Support": CASO “1” 3: "2" } |
SWITCH ([Gruppo ticket]) {CASE "Support": CASO “1” 3: "2" } Poiché il gruppo Ticket è un attributo di testo, le condizioni di tutti i casi devono essere di tipo testo. Un valore racchiuso tra virgolette è considerato testo, mentre un numero senza virgolette è un numero. Quindi il 3 deve essere racchiuso tra virgolette. |
Impossibile usare tipi diversi nell’istruzione SWITCH. “1” è il testo e 2 è un numero. Usa lo stesso tipo. | SWITCH ([Gruppo ticket]) {CASE "Support": CASE “1” “IT”: 2 } |
SWITCH ([Gruppo ticket]) {CASE "Support": CASE “1” “IT”: "2" } I risultati di tutti i casi devono essere dello stesso tipo. Un valore racchiuso tra virgolette è considerato testo, mentre un numero senza virgolette è un numero. Quindi il 2 deve essere racchiuso tra virgolette. |
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 usare le virgolette per tutti i valori se si tratta di un attributo numerico. L’istanza segmento è un attributo numerico, quindi la formula non deve contenere virgolette. |
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 VALUE aggregatori, funzioni ATTRIBUTE_FIX o ATTRIBUTE_ADD. | IF SUM(Tempo di attesa richiedente (min))>120 THEN "Long wait time" ELSE "Short wait time" ENDIF |
IF VALUE(Tempo di attesa richiedente (min))>120 THEN "Long wait time" ELSE "Short wait time" ENDIF Questo messaggio di errore viene visualizzato negli attributi calcolati, non nelle metriche. In questo caso, devi usare VALUE aggregatori. |
Impossibile usare COUNT(Ticket risolti) in un attributo calcolato. Racchiude la metrica nella funzione ATTRIBUTE_FIX o ATTRIBUTE_ADD. | IF COUNT(Ticket risolti)>1 THEN "Solved" ELSE "Unsolved" ENDIF |
IF ([Stato ticket - Non in ordine] = "Solved" OR [Stato ticket - Non in ordine] = "Closed" "Solved" ELSE "Unsolved" ENDIF Questo messaggio di errore viene visualizzato negli attributi calcolati, non nelle metriche. Il modo migliore per correggere questo errore è usare le stesse condizioni usate nella metrica Ticket risolti . La formula di questa metrica è: IF ([Stato ticket - Non in ordine] = "Solved" OR [Stato ticket - Non in ordine] = "Closed") THEN [ID ticket] ENDIF Quindi puoi aggiornare la formula come mostrato sopra. |
Impossibile usare COUNT(Assegnazioni ticket a sviluppatori) in un attributo calcolato. Racchiude la metrica nella funzione ATTRIBUTE_FIX o ATTRIBUTE_ADD. | IF COUNT(Assegnazioni ticket a sviluppatori)>1 THEN "Solved" ELSE "Unsolved" ENDIF |
IF ATTRIBUTE_FIX(COUNT(Assegnazioni ticket a sviluppatori), [ID ticket aggiornamento])>1 THEN "Escalation multiple" ELSE "Una o nessuna escalation" ENDIF Questo messaggio di errore viene visualizzato negli attributi calcolati, non nelle metriche. Se la formula originale è più complessa e non può essere riutilizzata, prova a usare la funzione ATTRIBUTE_FIX per specificare a quali livelli deve essere aggregato questo attributo. In questo caso, deve essere calcolato a livello di ID ticket di aggiornamento . |
Il tempo nello stato contiene già aggregatori. Sostituisci AVG con SUM oppure assicurati che lo stato Tempo in contenga solo VALUE aggregatori. | Tempo medio nello stato |
SUM(Durata nello stato) Il tempo nello stato è una metrica nidificata. La formula contiene già un aggregatore. Ad esempio, potrebbe essere MED(Tempo prima risposta (ore)). Il calcolo di una media sopra una mediana non è consentito, quindi l’aggregatore di livello superiore deve essere impostato su SUM oppure deve essere impostato 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] ="Solved" |
[Stato ticket] ="Risolto" I motivi più comuni di questo errore sono:
In questo esempio, si è verificato un errore di battitura nel nome dell’attributo. |
[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 errori di configurazione nella formula. Quindi devi prima risolvere il problema. |
Il calcolo fa riferimento a se stesso qui COUNT(Ticket delle vendite). Rimuovilo o sostituiscilo. | COUNT(Ticket Sales)/COUNT(Ticket) | Stai aggiungendo una formula al suo interno. In questo caso, la formula modificata è Sales tickete l’utente sta tentando di aggiungere ticket Sales all’interno della formula. |
Max 3 livelli in un calcolo. Rimuovi il calcolo annidato qui: SUM((secondo tempo di risposta) | MED(Tempo 2a risposta) / MED(Tempo prima risposta (min) | La metrica calcolata secondo il tempo di risposta si basa su un altro calcolo, a sua volta basato su un altro calcolo. Tali calcoli sono detti annidati. Sono consentiti solo 3 livelli nidificati. |
Impossibile usare [Gruppo ticket] qui. INCLUDES_ALL può essere usato solo per gli attributi dei tag. | INCLUDES_ALL([Gruppo ticket], "Assistenza", "Vendite") |
Le funzioni INCLUDES sono consentite solo con gli attributi dei tag. Per altri attributi, usa la funzione IN. |
Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.
Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.