In Analytics, puoi scrivere formule che potenziano metriche e attributi personalizzati. Costruisci le formule correttamente per assicurarti che funzionino. Se una formula non è corretta, l’editor formule visualizza un messaggio di errore in tempo reale. Il messaggio di errore identifica il problema e fornisce indicazioni per 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 per correggere le formule, inclusi esempi di formule errate e corrette.
Nota: A partire dal 13 agosto 2024, i report con formule configurate in modo errato che funzionavano in precedenza smetteranno di funzionare. e verrà visualizzato un messaggio di errore.
Consulta:
Correggi le formule configurate in modo errato
Se una metrica o un attributo calcolato contiene una formula configurata in modo errato, non restituisce 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.
Nota: Se una formula configurata in modo errato è annidata in un calcolo non basato su una formula, come una metrica di intervallo di date , un gruppo o un attributo 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: chiedi 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 .
) e selezionando Creato da .Per aggiornare una formula configurata in modo errato
- In Analitica, 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.
La correzione di una metrica calcolata o di una formula di attributo in un report la corregge anche in qualsiasi altro report in cui viene usata. - (Facoltativo) Se hai creato una copia della metrica o dell’attributo, aggiorna l’originale.
- Salva il report
Per ripubblicare i dashboard interessati
- In Analitica, fai clic sull’icona Dashboard (
) per aprire la libreria dei 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.
Motivi degli errori di sintassi generali
Questa tabella illustra gli errori di configurazione della sintassi comuni e le relative correzioni.
- Hai aperto ma non chiuso una parentesi o una parentesi oppure ne hai chiuse più di quante ne hai aperte.
Errato. IF ([Stato ticket] = "Risolto")) THEN [ID ticket] ENDIF
Corretto: IF ([Stato ticket] = "Risolto")) THEN [ID ticket] ENDIF - Hai aperto ma non chiuso le virgolette.
Errato: [Stato ticket] = "Risolto
Corretto: [Stato ticket] = "Risolto" - Non hai racchiuso l’attributo tra parentesi.
Errato. Stato ticket | Risolto
Corretto: [Stato ticket] = "Risolto" - Non hai aggiunto un aggregatore davanti a una metrica.
Errato. (Tempo di prima risposta (min))
Corretto: SUM(Tempo di prima risposta (min)) - Manca una parte essenziale dell’istruzione IF. In questo esempio, la parte ENDIF è mancante.
Errato. IF ([Stato ticket] = "Risolto") THEN [ID ticket]
Corretto: 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
Errori per le espressioni uguale, non uguale e di confronto
Questa sezione descrive le regole di sintassi per i confronti e i tipi di corrispondenza.
- Impossibile usare [Fase progetto] come testo e 1 come numero. Usa lo stesso tipo.
Errato: [Fase del progetto]=1
Corretto: [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.
Errato: [Paese ticket]!=[Codice Paese utente]
Corretto: [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.
Errato: [Ticket assegnato - Data]> = 26
Corretto: [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.
Errato. VALUE(Risposte agente)<"2"
Corretto: 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
Errori nelle operazioni aritmetiche e nell’unione del testo
Questa sezione descrive le regole di calcolo e descrive come unire gli attributi.
- 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.
Errato: [Gruppo ticket]+[ID ticket]
Corretto: [Gruppo ticket]+STRING([ID ticket])
Questa formula unisce il testo come mostrato in Ricetta analitica: 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.
Errato. VALUE(Tempo di soluzione completa (min))+[Tempo di attività aggiuntivo]
Corretto: 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 la registrazione del tempo aggiuntivo delle attività, che funziona senza trasformazioni in Analitica. 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.
Errato. VALUE(Tempo prima risposta (min))/"60"
Corretto: VALUE(Tempo 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.
Errato. COUNT(Commenti)-[Commento pubblico]
Corretto: COUNT(Commenti)-COUNT(Commenti pubblici)
Le operazioni aritmetiche come la sottrazione richiedono valori numerici. Commento pubblico è un attributo di testo. Usa una metrica.
Funzioni
Errori durante l’uso delle funzioni
Questa sezione descrive in dettaglio i criteri delle funzioni e gli errori di configurazione.
- Impossibile usare tipi diversi nell’istruzione THEN. 1 è il numero e "0" è il testo. Usa lo stesso tipo
Errato. IF [Stato ticket] = "Aperto" THEN "1" ELSE "0" ENDIF
Corretto: IF [Stato ticket] = "Aperto" THEN 1 ELSE 0 ENDIF o 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
Errato. IF 1 O 2 THEN [ID ticket] ENDIF
Corretto: 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 delle formule non valuta la validità delle condizioni stesse. - Non è possibile usare il numero in questa funzione. Usa il testo
Errato. NUMBER([ID ticket])
Corretto: 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
Errato. LINK("https://subdomain.zendesk.com/agent/organizations/" + STRINGA([ID organizzazione ticket]), [Casella di spunta organizzazione])
Corretto: LINK("https:// yoursubdomain .zendesk.com/agent/organizations/" + STRING([ID organizzazione ticket]), [Nome organizzazione ticket]) o LINK("https:// yoursubdomain .zendesk.com/agent/ organizzazioni/" + 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
Errato. DATE_LAST([Ticket creato - mese])
Corretto: DATE_LAST([Ticket creato - data/ora])
La funzione DATE_LAST prevede un attributo timestamp. - Impossibile usare tipi di condizioni diversi. Usa tipo testo
Errato. SWITCH ([Gruppo ticket])
Corretto: SWITCH ([Gruppo ticket])
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
Errato. SWITCH ([Gruppo ticket])
Corretto: SWITCH ([Gruppo ticket])
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
Errato. IN([Istanza segmento], ARRAY(1, "2", "3"))
Corretto: 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
Errato. DATE_DIFF([Soluzione ticket - Data], [Creazione ticket - Data], "minuti")
Corretto: 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
Errori durante l’uso degli aggregatori di metriche
Questa sezione descrive i problemi di calcolo degli aggregatori negli attributi personalizzati.
- Impossibile usare l’aggregatore SUM(metrica di database). Usa l’aggregatore VALUE, la funzione ATTRIBUTE_FIX o ATTRIBUTE_ADD.
Errato. IF SUM(Tempo di attesa richiedente (min))>120 THEN "Tempo di attesa lungo" ELSE "Tempo di attesa breve" ENDIF
Corretto: 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.
Errato. IF COUNT(Ticket risolti)>1 THEN "Risolto" ELSE "Non risolto" ENDIF
Corretto: 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.
Errato. IF COUNT(Assegnazioni ticket a Dev)>1 THEN "Risolto" ELSE "Non risolto" ENDIF
Corretto: 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.
Errato. AVG(Tempo nello stato)
Corretto: 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
Messaggi di errore vari
Questa sezione esamina gli errori di battitura dei dataset e i problemi relativi alle metriche autoreferenziali.
- [Stati ticket] non esiste in questo dataset. Controlla se è presente un errore di battitura.
Errato: [Stati ticket] ="Risolto"
Corretto: [Stato ticket] ="Risolto"
I motivi più comuni di questo errore includono: L’attributo o la metrica proviene da un altro dataset; Errore di battitura nel nome; Il nome non è nella lingua del profilo dell’utente; La formula fa riferimento a un calcolo racchiuso tra virgolette nel nome. Rimuovile per risolvere l’errore - [Gruppo calcolato] ha una formula configurata in modo errato. Risolvi il problema prima di salvare.
Errato. IF [Gruppo calcolato] = "light" THEN TRUE ELSE FALSE ENDIF
Corretto: 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.
Errato. COUNT(Ticket delle vendite)/COUNT(Ticket)
Corretto: 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)
Errato. MED(tempo di seconda risposta) / MED(tempo di prima risposta (min)
Corretto: 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.
Errato. INCLUDES_ALL([Gruppo ticket], "Support", "Vendite")
Corretto: INCLUDES_ALL([Tag ticket], "assistenza", "vendite") o IN(Gruppo ticket, ARRAY( "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.
Errato. COUNT([Metrica calcolata intervallo di date])
Corretto: 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.
Errato. IF (CONTAINS([Tag ticket],"vendite")) THEN "Vendite" ELSE "Prod" ENDIF
Corretto: INCLUDES_ALL([Tag ticket], "Vendite", "Prod")
Solo INCLUDES_ALL e INCLUDES_ANY generano report sui tag.
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.