Risoluzione dei problemi relativi agli errori nelle formule di Explore

In Explore, puoi scrivere formule che potenziano metriche e attributi personalizzati. Per garantire che le formule funzionino correttamente, creale correttamente. Se la formula non è stata creata correttamente, l’editor delle formule visualizza un messaggio di errore in tempo reale durante la scrittura o la modifica. 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 che potresti incontrare nell’editor delle formule e fornisce consigli su come correggere la formula, inclusi esempi di formule errate e corrette.

Nota: a partire dal 13 agosto 2024, i report con formule configurate in modo errato che potrebbero aver funzionato in precedenza smetteranno di funzionare e verrà visualizzato un messaggio di errore. Per ulteriori informazioni, leggi l’articolo: Annuncio del ritiro dei calcoli non validi in Explore.

Questo articolo include i seguenti argomenti:

• Correzione di formule configurate in modo errato
• Tipi di messaggi di errore nell’editor delle formule

Articoli correlati:

• Risorse per la scrittura di formule
• Funzioni di riferimento di Explore

Correzione di formule configurate in modo errato

Se una metrica o un attributo calcolato contiene una formula configurata in modo errato, non invierà risultati. Identifica le formule configurate in modo errato controllando le seguenti 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
• Strumento di 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 che usa la formula e correggila nell’editor formule. A questo punto ripubblica i dashboard in cui viene usato il report.

Nota: se una formula configurata in modo errato è annidata all'interno di un calcolo non basato su una formula (come una metrica di intervallo date o un attributo di gruppo o di set), non viene visualizzato alcun messaggio di errore nel calcolo non basato su una formula. Per visualizzare il messaggio di errore nell’editor delle formule, devi aprire il calcolo annidato originale.

Suggerimento: puoi chiedere ai creatori di report di correggere le proprie formule. La colonna Creato da nella Libreria report mostra l’utente che ha creato ciascun report. Se non vedi Creato da, aggiungilo facendo clic sull’icona delle colonne () e selezionando Creato da.

Per aggiornare una formula configurata in modo errato

1. In Explore, fai clic sull’icona Report () per aprire la libreria Report
2. Fai clic sulla scheda Aggiornamenti obbligatori

   

3. Fai clic su uno dei report elencati per aprirlo
4. Per ogni metrica o attributo calcolato:
   1. Fai clic sulla metrica o sull’attributo e poi sull’icona a forma di matita
   2. 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.

      

   3. (Facoltativo) Crea una copia della metrica o dell’attributo prima di apportare modifiche. Questo impedisce che i report esistenti vengano alterati durante il processo di risoluzione dei problemi.
   4. 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

   5. (Facoltativo) Se hai creato una copia della metrica o dell’attributo, aggiorna l’originale.
5. Salva il report

Per ripubblicare i dashboard interessati

1. Fai clic sull’icona Dashboard () per aprire la libreria Dashboard
2. Fai clic sulla scheda Aggiornamenti obbligatori
3. Posiziona il cursore del mouse su uno dei dashboard e fai clic su Modifica
4. Nel dashboard, fai clic sulla freccia del menu a discesa accanto a Condividi e seleziona Pubblica. Non appena gli utenti visualizzeranno il dashboard condiviso, potranno godere della versione più recente
5. Fai clic su Pubblica

Tipi di messaggi di errore nell’editor delle formule

Questa sezione mostra i alcuni messaggi di errore e offre consigli su come risolverli:

• Errori di formula più comuni
• Messaggi di errore di sintassi generici
• Messaggi di errore relativi al tipo di dati
• Messaggi di errore dell’aggregatore di metriche
• Altri messaggi di errore

Errori di formula più comuni

Il video seguente illustra come correggere alcuni avvisi 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, una parte della sintassi nella formula non è corretta:

• “Si è verificato un problema con la formula. Controlla la sintassi di calcolo e riprova”.

  

I motivi più comuni di questo errore sono elencati nella tabella seguente.

Motivo	Formula errata	Formula corretta
Hai aperto una parentesi ma non l’hai chiusa, oppure l’hai chiusa più di quanto sia stata aperta.	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 che potresti vedere 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
• Operazioni aritmetiche e unione dei valori di testo
• Funzioni

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" 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 [Codice 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 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" Lo stesso tipo di dati deve essere usato 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 Lo stesso tipo di dati deve essere usato su entrambi i lati dell’espressione minore di. Un valore racchiuso tra virgolette è considerato testo, mentre un numero senza virgolette è un numero. Poiché le Risposte agente rappresentano una metrica, il valore deve essere un numero, quindi le virgolette non devono essere usate.

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]) L’obiettivo di questa formula è unire il testo come mostrato nella Procedura di Explore: Unione attributi. 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 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]) L’obiettivo di questa formula è sommare due valori. Tempo di soluzione completa (min) è un numero, ma Tempo di attività aggiuntivo è un campo di testo con valori numerici elencati al suo interno. L’approccio migliore consiste nel creare un nuovo campo numerico personalizzato in Support per ricodificare il tempo dell’attività aggiuntivo, che non richiederà alcuna trasformazione e funzionerà immediatamente in Explore. In alternativa, l’attributo di testo può essere trasformato in un numero tramite la funzione NUMERO.
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 è 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. Commento pubblico è un attributo di testo. Devi usare 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 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 indicato 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 impostate all’interno dell’istruzione IF devono essere TRUE o FALSE. La sintassi corretta è: IF TRUE O FALSE THEN [ID ticket] ENDIF Invece, aggiungi alcune condizioni. Tuttavia, 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 è pensata 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. Al contrario, gli attributi di testo come l’ID esterno del ticket possono.
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://subdomain.zendesk .com /agent/organizations/” + STRINGA([ID organizzazione ticket]), [Nome organizzazione ticket]) oppure LINK(” https://subdomain.zendesk .com /agent/organizations/” + STRINGA([ID organizzazione ticket]), STRING([Casella di spunta Organizzazione])) La funzione LINK prevede il testo come secondo parametro, motivo per cui non puoi usare un attributo booleano. Come mostrato sopra, sono disponibili due opzioni. Puoi usare un attributo di testo o trasformare l’attributo booleano nel testo tramite la funzione STRINGA.
Impossibile usare [Ticket creato - mese] come testo in questa sezione. Usa il 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]) {CASO "Support": "1" CASO 3: "2" }	SWITCH ([Gruppo ticket]) {CASE "Support": "1" CASO 3: "2" } Poiché il gruppo Ticket è un attributo di testo, le condizioni di tutti i casi devono essere di tipo di 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 è 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. 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 usare 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 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. In questo caso, utilizza l’aggregatore VALUE.
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] = "Solved" OR [Stato ticket - Non in ordine] = "Closed") THEN "Risolto" ELSE "Non risolto" 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. Quindi puoi aggiornare la formula come mostrato sopra.
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, 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, dovrebbe essere calcolato a livello di ID ticket di 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 annidata. La formula contiene già un aggregatore. Ad esempio, potrebbe essere MED(Tempo di 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 l’aggregatore di livello inferiore 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] ="Risolto"	[Stato ticket] = "Risolto” I motivi più comuni di questo errore sono: L’attributo o la metrica usata proviene da un altro dataset. Errore di battitura nel nome dell’attributo o della metrica. Il nome dell’attributo o della metrica non è scritto nella lingua del profilo dell’utente. La formula fa riferimento a una metrica o a un attributo calcolato che include virgolette nel nome. Rimuovi le virgolette per risolvere l’errore. In questo esempio, c’è 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 correggerlo.
Il calcolo fa riferimento a se stesso qui COUNT(Ticket delle vendite). Rimuovilo o sostituiscilo.	COUNT(Ticket delle vendite)/COUNT(Ticket)	Stai aggiungendo una formula al suo interno. In questo caso, la formula modificata è Ticket delle vendite e l’utente sta tentando di aggiungere Ticket delle vendite all’interno della 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 calcolata di tempo di seconda risposta si basa su un altro calcolo, che a sua volta è basato su un altro calcolo. Tali calcoli sono detti annidati. 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")	INCLUDES_ALL([Tag ticket], "support", "vendite") IN([Gruppo ticket], ARRAY( "Support", "Vendite")) Le funzioni INCLUDES sono consentite solo con gli attributi dei 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. Per eseguire calcoli usando le metriche calcolate per intervalli di date, usa invece uncalcolo della metrica dei risultati.