In Explore können Sie Formeln mit angepassten Metriken und Attributen schreiben. Damit die Formeln wie vorgesehen funktionieren, müssen Sie sie ordnungsgemäß erstellen. Wenn eine Formel fehlerhaft ist, zeigt der Formeleditor in Echtzeit eine Fehlermeldung an. Die Fehlermeldung benennt das Problem und gibt Anweisungen zur Lösung.
In diesem Beitrag erfahren Sie, wie Sie falsch konfigurierte Formeln in Berichten beheben können. Sie finden eine Liste möglicher Fehlermeldungen im Formeleditor mit Anweisungen zur Korrektur und Beispielen für falsche und richtige Versionen der jeweiligen Formel.
In diesem Beitrag werden folgende Themen behandelt:
Verwandte Beiträge:
Korrigieren falsch konfigurierter Formeln
Wenn eine berechnete Metrik oder ein berechnetes Attribut eine falsch konfigurierte Formel enthält, wird kein Ergebnis zurückgegeben. Sie können an den folgenden Stellen nach falsch konfigurierten Formeln suchen:
- Berichtsbibliothek: Berichte, die eine falsch konfigurierte Formel enthalten, befinden sich in der Kategorie „Aktualisierungen erforderlich“ der Berichtsbibliothek.
- Dashboard-Bibliothek: Dashboards, die betroffene Berichte verwenden, erscheinen in der Dashboard-Bibliothek auf der Registerkarte „Aktualisierungen erforderlich“.
- Berichtsgenerator: Am Ende von Berichten mit einer falsch konfigurierten Formel wird eine Warnmeldung angezeigt
- Formeleditor: Bei einer falsch konfigurierten Formel wird im Formeleditor eine Warnmeldung angezeigt
Um eine falsch konfigurierte Formel zu korrigieren, öffnen Sie den betreffenden Bericht und nehmen Sie im Formeleditor die erforderlichen Änderungen vor. Veröffentlichen Sie anschließend alle Dashboards erneut, in denen der Bericht verwendet wird.
) und dann auf Erstellt von, um sie hinzuzufügen.So aktualisieren Sie eine falsch konfigurierte Formel
- Klicken Sie in Explore auf das Symbol Berichte (
), um die Berichtsbibliothek zu öffnen. -
Klicken Sie auf die Registerkarte Aktualisierungen erforderlich.
- Klicken Sie in der Liste auf einen der Berichte, um ihn zu öffnen.
- Führen Sie mit jeder berechneten Metrik und jedem berechneten Attribut folgende Schritte aus:
- Klicken Sie auf die Metrik oder das Attribut und dann auf das Bleistiftsymbol.
-
Überprüfen Sie die Formel auf mögliche Fehlkonfigurationen. Die falsch konfigurierten Teile der Formel sind unterstrichen. In einer Fehlermeldung wird beschrieben, was korrigiert werden muss.
- (Optional) Erstellen Sie eine Kopie der Metrik oder des Attributs, bevor Sie irgendwelche Änderungen vornehmen. Dadurch vermeiden Sie Auswirkungen auf vorhandene Berichte während der Fehlerbehebung.
-
Beheben Sie die in der Fehlermeldung angegebenen Probleme mit der Formel. Weitere Informationen zu bestimmten Fehlermeldungen finden Sie in den folgenden Abschnitten.
Wenn Sie die Formel einer berechneten Metrik oder eines berechneten Attributs in einem Bericht korrigieren, wird das Problem auch in allen anderen Berichten behoben, in denen sie verwendet wird.
- (Optional) Wenn Sie eine Kopie der Metrik oder des Attributs erstellt haben, aktualisieren Sie die ursprüngliche Version.
- Speichern Sie den Bericht.
So veröffentlichen Sie betroffene Dashboards erneut
- Klicken Sie auf das Symbol Dashboards (
), um die Dashboard-Bibliothek zu öffnen. - Klicken Sie auf die Registerkarte Aktualisierungen erforderlich.
- Setzen Sie den Mauszeiger auf eines der Dashboards und klicken Sie auf Bearbeiten.
- Klicken Sie im Dashboard auf den Abwärtspfeil neben Teilen und dann auf Veröffentlichen. Beim nächsten Aufruf des geteilten Dashboards sehen die Benutzer die jeweils neueste Version.
- Klicken Sie auf Veröffentlichen.
Arten von Fehlermeldungen im Formeleditor
Dieser Abschnitt enthält eine Auflistung der folgenden Arten von Fehlermeldungen mit Hinweisen zur Fehlerbehebung:
Die häufigsten Formelfehler
Weitere Informationen zu bestimmten Fehlermeldungen finden Sie in den folgenden Abschnitten.
Meldungen zu allgemeinen Syntaxfehlern
Die folgende Fehlermeldung zeigt an, dass die Syntax der Formel fehlerhaft ist:
-
„Es liegt ein Problem mit der Formel vor. Überprüfen Sie die Berechnungssyntax und versuchen Sie es erneut.“
In der unten stehenden Tabelle sind die häufigsten Ursachen für diesen Fehler aufgeführt.
| Grund | Falsche Formel | Richtige Formel |
|---|---|---|
| Sie haben eine runde oder eckige Klammer geöffnet, aber nicht geschlossen, oder Sie haben mehr Klammern geschlossen als geöffnet. | IF ([Ticketstatus] = "Solved")) THEN [Ticket-ID] ENDIF | IF ([Ticketstatus] = "Solved") THEN [Ticket-ID] ENDIF |
| Sie haben ein erforderliches Anführungszeichen nicht gesetzt. | [Ticketstatus] = "Solved | [Ticketstatus] = "Solved" |
| Sie haben ein Attribut nicht in eckige Klammern gesetzt. | Ticketstatus = "Solved" | [Ticketstatus] = "Solved" |
| Sie haben einer Metrik keinen Aggregator vorangestellt. | Zeit bis zur 1. Antwort – Min. | SUM(Zeit bis zur 1. Antwort – Min.) |
| Sie haben einen wesentlichen Teil der IF-Anweisung nicht hinzugefügt. In diesem Beispiel fehlt ENDIF. | IF ([Ticketstatus] = "Solved") THEN [Ticket-ID] | IF ([Ticketstatus] = "Solved") THEN [Ticket-ID] ENDIF |
Meldungen zu fehlerhaften Datentypen
Die folgenden Tabellen enthalten eine Liste möglicher Fehlermeldungen im Zusammenhang mit Datentypen im Formeleditor, mit Beispielen für falsche und richtige Versionen der jeweiligen Formel.
In den unten stehenden Abschnitten werden Datentyp-Fehlermeldungen behandelt:
Gleich-, Ungleich-, Kleiner als- und Größer als-Ausdrücke
| Beispiele für Fehlermeldungen | Falsche Formel | Richtige Formel |
|---|---|---|
| „[Projekt – Phase]“ kann nicht als „Text“ und „1“ nicht als „Nummer“ verwendet werden. Verwenden Sie denselben Typ. | [Projekt – Phase]=1 |
[Projekt – Phase]="1" Auf beiden Seiten des Ist-gleich-Ausdrucks muss derselbe Datentyp verwendet werden. Ein Wert in Anführungszeichen gilt als Text, eine Ziffer ohne Anführungszeichen hingegen als Zahl. Da Projekt – Phase ein Textattribut ist, muss der Wert in Anführungszeichen stehen. |
| „[Ticket – Land]“ kann nicht als „Text“ und „[Ländercode des Benutzers]“ nicht als „Nummer“ verwendet werden. Verwenden Sie denselben Typ. | [Ticket – Land]!=[Ländercode des Benutzers] |
[Ticket – Land]!=[Land des Benutzers] Auf beiden Seiten des Ungleich-Ausdrucks muss derselbe Datentyp verwendet werden. Ticket – Land ist Text, deshalb muss auch das Attribut auf der rechten Seite Text sein. |
| „[Ticket zugewiesen – Datum]“ kann nicht als „Text“ und „26“ nicht als „Nummer“ verwendet werden. Verwenden Sie nur Zahlen oder Texte. | [Ticket zugewiesen – Datum] >= 26 |
[Ticket zugewiesen – Datum] >= "26.01.2023" Auf beiden Seiten des Größer-oder-gleich-Ausdrucks muss derselbe Datentyp verwendet werden. In diesem Fall handelt es sich um ein in Anführungszeichen gesetztes Datum. |
| „VALUE(Agentenantworten)“ kann nicht als „Nummer“ und „2“ nicht als „Text“ verwendet werden. Verwenden Sie nur Zahlen oder Texte. | VALUE(Agentenantworten)<”2” |
VALUE(Agentenantworten)<2 Auf beiden Seiten des Kleiner-als-Ausdrucks muss derselbe Datentyp verwendet werden. Ein Wert in Anführungszeichen gilt als Text, eine Ziffer ohne Anführungszeichen hingegen als Zahl. Da es sich bei Agentenantworten um eine Metrik handelt, muss der Wert eine Zahl sein; verwenden Sie daher keine Anführungszeichen. |
Arithmetische Operationen und Textwertverknüpfungen
| Beispiele für Fehlermeldungen | Falsche Formel | Richtige Formel |
|---|---|---|
| „[Ticketgruppe]“ kann nicht als „Text“ und „[Ticket-ID]“ nicht als „Nummer“ verwendet werden. Verwenden Sie nur Zahlen oder Texte. Bei Bedarf können Sie die Funktion STRING verwenden, um Zahlen in Text umzuwandeln, oder die Funktion NUMBER, um Text in Zahlen umzuwandeln. | [Ticketgruppe]+[Ticket-ID] |
[Ticketgruppe]+STRING([Ticket-ID]) Diese Formel fügt Text zusammen (siehe Explore-Rezept: Verknüpfen von Attributen). Das numerische Attribut muss mithilfe der Funktion STRING in Text umgewandelt werden. |
| „VALUE(Zeit bis zur vollständigen Lösung – Min.)“ kann nicht als „Nummer“ und „[Zusätzliche Zeit für Aufgabe]“ nicht als „Text“ verwendet werden. Verwenden Sie nur Zahlen oder Texte. Bei Bedarf können Sie die Funktion STRING verwenden, um Zahlen in Text umzuwandeln, oder die Funktion NUMBER, um Text in Zahlen umzuwandeln. | VALUE(Zeit bis zur vollständigen Lösung – Min.)+[Zusätzliche Zeit für Aufgabe] |
VALUE(Zeit bis zur vollständigen Lösung – Min.)+NUMBER([Zusätzliche Zeit für Aufgabe]) Diese Formel summiert zwei Werte. Zeit bis zur vollständigen Lösung – Min. ist eine Zahl, Zusätzliche Zeit für Aufgabe hingegen ein Textfeld, das numerische Werte enthält. Der beste Ansatz ist die Erstellung eines neuen numerischen angepassten Felds in Support zur Erfassung zusätzlicher Aufgabenzeit, das in Explore ohne Transformation funktioniert. Sie können das Textattribut auch mit der Funktion NUMBER in eine Zahl umwandeln. |
| „VALUE(Zeit bis zur 1. Antwort – Min.)“ kann nicht als „Nummer“ und „60“ nicht als „Text“ verwendet werden. Verwenden Sie nur Zahlen. | VALUE(Zeit bis zur 1. Antwort – Min.)/"60" |
VALUE(Zeit bis zur ersten Reaktion – Std.)/60 Arithmetische Operationen wie die Division erfordern numerische Werte. Ein Wert in Anführungszeichen gilt als Text, eine Ziffer ohne Anführungszeichen hingegen als Zahl. Setzen Sie hier keine Anführungszeichen. |
| „COUNT(Kommentare)“ kann nicht als „Nummer“ und „[Öffentlicher Kommentar]“ nicht als „Text“ verwendet werden. Verwenden Sie nur Zahlen. | COUNT(Kommentare)-[Öffentlicher Kommentar] |
COUNT(Kommentare)-COUNT(Öffentlicher Kommentar) Arithmetische Operationen wie die Subtraktion erfordern numerische Werte. Öffentlicher Kommentar ist ein Textattribut. Sie müssen stattdessen eine Metrik verwenden. |
Funktionen
| Beispiele für Fehlermeldungen | Falsche Formel | Richtige Formel |
|---|---|---|
| In der THEN-Anweisung können keine unterschiedlichen Typen verwendet werden. „1“ ist „Nummer“ und „0“ ist „Text“. Sie müssen denselben Typ verwenden. | IF [Ticketstatus]="Open" THEN 1 ELSE "0" ENDIF |
IF [Ticketstatus] = "Open" THEN 1 ELSE 0 ENDIF oder IF [Ticketstatus] = "Open" THEN "1" ELSE "0" ENDIF Die Werte nach den Schlüsselwörtern THEN und ELSE müssen vom selben Typ sein. Anführungszeichen geben Text an, während ihr Fehlen für eine Zahl steht. Beheben Sie diesen Fehler wie oben beschrieben. |
| „1“ kann nicht als „Nummer“ und „2“ nicht als „Nummer“ verwendet werden. Verwenden Sie nur boolesche Werte. | IF 1 OR 2 THEN [Ticket ID] ENDIF |
IF VALUE(Agentenantworten) = 1 OR VALUE(Agentenantworten) = 2 THEN [Ticket-ID] ENDIF In der IF-Anweisung verwendete Bedingungen müssen entweder TRUE oder FALSE sein. Die korrekte Syntax lautet: IF TRUE OR FALSE THEN [Ticket-ID] ENDIF Fügen Sie stattdessen Bedingungen hinzu. Die Gültigkeit der Bedingungen selbst wird vom Formeleditor jedoch nicht bewertet. |
| In dieser Funktion kann „Number“ nicht verwendet werden. Verwenden Sie Text. | NUMBER([Ticket-ID]) |
NUMBER([Ticket – externe ID]) Die Funktion NUMBER dient zum Umwandeln von Textattributen mit numerischen Werten in Text. Das Attribut „Ticket-ID“ ist ein numerisches Feld und kann deshalb bei dieser Funktion nicht verwendet werden. Textattribute wie externe Ticket-ID können verwendet werden. |
| Text, boolescher Wert kann in dieser Funktion nicht verwendet werden. Verwenden Sie Text, Text oder Number. | LINK("https://subdomain.zendesk.com/agent/organizations/" + STRING([Ticketorganisation – ID), [Kontrollkästchen Organisation]) |
LINK("https://yoursubdomain.zendesk.com/agent/organizations/" + STRING([Ticketorganisation – ID]), [Ticketorganisation –Name]) oder LINK("https://yoursubdomain.zendesk.com/agent/organizations/" + STRING([Ticketorganisation – ID]), STRING([Kontrollkästchen Organisation])) Die Funktion LINK erwartet Text als zweiten Parameter. Verwenden Sie kein boolesches Attribut. Sie können ein Textattribut verwenden oder das boolesche Attribut mit der Funktion STRING in Text umwandeln. |
| [Ticket erstellt – Monat] kann hier nicht als Text verwendet werden. Verwenden Sie Zeitstempel. | DATE_LAST([Ticket erstellt – Monat]) |
DATE_LAST([Ticket erstellt – Zeitstempel]) Die Funktion DATE_LAST erwartet ein Zeitstempelattribut. |
| Andere Bedingungstypen können nicht verwendet werden. Verwenden Sie den Typ „Text“. | SWITCH ([Ticketgruppe]) {CASE "Support": "1" CASE 3: "2" } |
SWITCH ([Ticketgruppe]) {CASE "Support": "1" CASE 3: "2" } Da Ticketgruppe ein Textattribut ist, müssen die CASE-Bedingungen ebenfalls Text sein. Setzen Sie die Zahl 3 in Anführungszeichen, um sie in Text umzuwandeln. |
| In der SWITCH-Anweisung können keine unterschiedlichen Typen verwendet werden. „1“ ist „Text“ und „2“ ist „Nummer“. Sie müssen denselben Typ verwenden. | SWITCH ([Ticketgruppe]) {CASE "Support": "1" CASE "IT": 2 } |
SWITCH ([Ticketgruppe]) {CASE "Support": "1" CASE "IT": "2" } Die Ergebnisse von CASE müssen denselben Datenyp aufweisen. Setzen Sie die Zahl 2 in Anführungszeichen, um sie in Text umzuwandeln. |
| Es ist nicht möglich, im Array unterschiedliche Typen zu verwenden. Sie müssen denselben Typ verwenden. | IN([Segmentinstanz], ARRAY(1, "2", "3")) |
IN([Segmentinstanz], ARRAY(1, 2, 3)) Setzen Sie alle Werte in Anführungszeichen, wenn es sich um ein Textattribut handelt, oder verwenden Sie keine, wenn es sich um ein numerisches Attribut handelt. Die Segmentinstanz ist numerisch. Setzen Sie also keine Anführungszeichen. |
| Ungültige Zeiteinheit für die angegebenen Datumswerte | DATE_DIFF([Ticket gelöst – Datum], [Ticket erstellt – Datum], "Minuten") | Stellen Sie bei Verwendung der Funktion DATE_DIFF sicher, dass die Zeiteinheit (dritter Parameter) mit der Genauigkeit der Datumsfelder übereinstimmt. Bei Datumsangaben ohne Zeitangaben (Stunden, Minuten) sind nur „Jahr“, „Monat“ oder „Tag“ zulässig. Wenn Sie nicht unterstützte Einheiten wie „Minuten“ verwenden, wird ein Fehler ausgelöst. |
Meldungen zu fehlerhaften Metrikaggregatoren
| Beispiele für Fehlermeldungen | Falsche Formel | Richtige Formel |
|---|---|---|
| Der Aggregator SUM(Datenbankmetrik) kann nicht verwendet werden. Verwenden Sie den Aggregator VALUE und die Funktion ATTRIBUTE_FIX oder ATTRIBUTE_ADD. | IF SUM(Wartezeit Anfragender – Min.)>120 THEN "Lange Wartezeit" ELSE "Kurze Wartezeit" ENDIF |
IF VALUE(Wartezeit Anfragender – Min.)>120 THEN "Lange Wartezeit" ELSE "Kurze Wartezeit" ENDIF Diese Fehlermeldung wird bei berechneten Attributen angezeigt, aber nicht bei Metriken. Verwenden Sie hier den Aggregator VALUE. |
| Der Aggregator COUNT(Gelöste Tickets) kann nicht verwendet werden. Verwenden Sie den Aggregator VALUE oder schließen Sie die Metriken in die Funktion ATTRIBUTE_FIX oder ATTRIBUTE_ADD ein. | IF COUNT(Gelöste Tickets)>1 THEN "Solved" ELSE "Unsolved" ENDIF |
IF ([Ticketstatus – unsortiert] = "Solved" OR [Ticketstatus – unsortiert] = "Closed") THEN "Solved" ELSE "Unsolved" ENDIF Diese Fehlermeldung wird in berechneten Attributen angezeigt. Um sie zu beheben, verwenden Sie die gleichen Bedingungen wie die Metrik Gelöste Tickets. |
| COUNT(Ticketzuweisungen an Dev) kann in einem berechneten Attribut nicht verwendet werden. Schließen Sie die Metrik in die Funktion ATTRIBUTE_FIX oder ATTRIBUTE_ADD ein. | IF COUNT(Ticketzuweisungen an Dev)>1 THEN "Solved" ELSE "Unsolved" ENDIF |
IF ATTRIBUTE_FIX(COUNT(Ticketzuweisungen an Dev), [Aktualisierung – Ticket-ID])>1 THEN "Multiple escalations" ELSE "One or no escalations" ENDIF Diese Fehlermeldung wird in berechneten Attributen angezeigt. Wenn die ursprüngliche Formel komplex ist, verwenden Sie die Funktion ATTRIBUTE_FIX, um Aggregationsebenen anzugeben. Berechnen Sie diesen Wert auf der Ebene Ticket-ID aktualisieren. |
| „Zeit im Status“ enthält bereits Aggregatoren. Ersetzen Sie entweder AVG durch SUM oder stellen Sie sicher, dass „Zeit im Status“ nur VALUE-Aggregatoren enthält. | AVG(Zeit im Status) |
SUM(Zeit im Status) „Zeit im Status“ ist eine verschachtelte Metrik mit einem vorhandenen Aggregator. Die Berechnung eines Durchschnitts zusätzlich zu einem Median ist nicht zulässig. Setzen Sie den obersten Aggregator auf SUM oder ändern Sie den untersten Aggregator auf VALUE. |
Sonstige Fehlermeldungen
| Beispiele für Fehlermeldungen | Falsche Formel | Richtige Formel |
|---|---|---|
| „[Ticketstatus]“ ist in diesem Dataset nicht vorhanden. Überprüfen Sie, ob ein Tippfehler vorliegt. | [Ticketstatus] ="Solved" |
[Ticketstatus] ="Solved" Häufige Gründe für diesen Fehler:
|
| „[Berechnete Gruppe]“ hat eine falsch konfigurierte Formel. Beheben Sie das Problem vor dem Speichern. | IF [Berechnete Gruppe] = "light" THEN TRUE ELSE FALSE ENDIF | Die berechnete Gruppe ist falsch konfiguriert. Korrigieren Sie das zuerst. |
| Berechnung bezieht sich hier auf sich selbst: COUNT(Vertriebstickets). Entfernen oder ersetzen Sie sie. | COUNT(Vertriebstickets)/COUNT(Tickets) | Fügen Sie keine Formel innerhalb ihrer selbst hinzu. In diesem Fall bearbeitet der Benutzer Vertriebstickets und versucht, dies in die Formel aufzunehmen. |
| Max. 3 Ebenen in einer Berechnung. Entfernen Sie die verschachtelte Berechnung hier: SUM((Zeit bis zur 2. Antwort) | MED(Zeit bis zur 2. Antwort) / MED(Zeit bis zur 1. Antwort – Min.) | Die Metrik Zeit bis zur zweiten Antwort ist verschachtelt. Berechnungen dürfen maximal 3 Ebenen tief verschachtelt werden. |
| [Ticketgruppe] kann hier nicht verwendet werden INCLUDES_ALL kann nur für Stichwortattribute verwendet werden. | INCLUDES_ALL([Ticketgruppe], "Support", "Sales") |
INCLUDES-Funktionen funktionieren nur mit Stichwortattributen. Für andere Attribute müssen Sie die Funktion IN verwenden. |
| „[Datumsbereich – berechnete Metrik]“ hat eine falsch konfigurierte Formel. Beheben Sie das Problem vor dem Speichern. | COUNT([Berechnete Metrik für Datumsbereich]) | Berechnete Datumsbereichsmetriken werden in berechneten Metriken nicht unterstützt. Verwenden Sie stattdessen eine Ergebnismetrikberechnung. |
| [function] kann hier nicht verwendet werden. Verwenden Sie INCLUDES_ALL oder INCLUDES_ANY als Stichwortattribute. | IF (CONTAINS([Ticket-Stichwörter],"Verkauf")) THEN "Verkauf" ELSE "Prod" ENDIF |
INCLUDES_ALL([Ticket – Stichwörter], "Verkauf", "Prod") Nur INCLUDES_ALL und INCLUDES_ANY melden Stichwörter. |