In Explore können Sie Formeln mit angepassten Metriken und Attributen schreiben. Damit Formeln richtig funktionieren, müssen Sie sie richtig konstruieren. Wenn eine Formel nicht korrekt konstruiert ist, zeigt der Formeleditor direkt beim Schreiben oder Bearbeiten eine Fehlermeldung in Echtzeit 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 der Fehlermeldungen, die im Formeleditor angezeigt werden können, mit Hinweisen 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:
- In der Berichtsbibliothek: Berichte, die eine falsch konfigurierte Formel enthalten, befinden sich in der Kategorie „Aktualisierungen erforderlich“ der Berichtsbibliothek.
- In der Dashboard-Bibliothek: Dashboards, die betroffene Berichte verwenden, erscheinen in der Dashboard-Bibliothek auf der Registerkarte „Aktualisierungen erforderlich“.
- Im Berichtsgenerator: Am Ende von Berichten mit einer falsch konfigurierten Formel wird eine Warnmeldung angezeigt.
- Im 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. Auf diese Weise vermeiden Sie Störungen vorhandener 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 der Berichte 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
Das unten stehende Video zeigt, wie Sie einige häufige Warnmeldungen beheben.
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 Klammer geöffnet, aber nicht geschlossen, oder Sie haben mehr Klammern geschlossen, als Sie geöffnet haben. | 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 der Fehlermeldungen im Zusammenhang mit Datentypen, die möglicherweise im Formeleditor erscheinen, mit Hinweisen zur Korrektur und 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] >= "2023-01-26" 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, die nicht in Anführungszeichen stehen darf. |
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 dient zum Verknüpfen von Text (siehe Rezept für Explore: Verknüpfen von Attributen). Deshalb muss das numerische Attribut 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 dient zum Summieren zweier 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. Am besten erstellen Sie in Support ein neues numerisches angepasstes Feld für die Eingabe der zusätzlich benötigten Zeit, damit der Wert ohne vorherige Umwandlung direkt in Explore verwendet werden kann. 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 1. Antwort – Min.)/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. Deshalb dürfen hier keine Anführungszeichen verwendet werden. |
| „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“. Verwenden Sie denselben Typ. | 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 denselben Typ aufweisen. Ein Wert in Anführungszeichen gilt als Text, eine Ziffer ohne Anführungszeichen hingegen als Zahl. Es gibt also wie oben dargestellt zwei Möglichkeiten, diesen Fehler zu beheben. |
| „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. Ein Textattribut wie „Ticket – externe ID“ hingegen kann 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([Ticket – Organisations-ID]), [Kontrollkästchen Organisation]) |
LINK oder LINK Die Funktion LINK erwartet als zweiten Parameter ein Textattribut. Deshalb können Sie kein boolesches Attribut verwenden. Es gibt also wie oben dargestellt zwei Möglichkeiten. 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. Ein Wert in Anführungszeichen gilt als Text, eine Ziffer ohne Anführungszeichen hingegen als Zahl. Die 3 muss also in Anführungszeichen gesetzt werden. |
| In der SWITCH-Anweisung können keine unterschiedlichen Typen verwendet werden. „1“ ist „Text“ und „2“ ist „Nummer“. Verwenden Sie denselben Typ. | 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. Ein Wert in Anführungszeichen gilt als Text, eine Ziffer ohne Anführungszeichen hingegen als Zahl. Die 2 muss also in Anführungszeichen gesetzt werden. |
| Es ist nicht möglich, im Array unterschiedliche Typen zu verwenden. Verwenden Sie denselben Typ. | IN([Segmentinstanz], ARRAY(1, "2", "3")) |
IN([Segmentinstanz], ARRAY(1, 2, 3)) Setzen Sie alle Werte in Anführungszeichen, wenn es sich um Textattribute handelt, oder setzen Sie keinen der Werte in Anführungszeichen, wenn es sich um numerische Attribute handelt. Segmentinstanz ist ein numerisches Attribut, deshalb dürfen in der Formel keine Anführungszeichen verwendet werden. |
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. In diesem Fall müssen Sie den Aggregator VALUE verwenden. |
| COUNT(Gelöste Tickets) kann in einem berechneten Attribut nicht verwendet werden. Schließen Sie die Metrik 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") "Solved" ELSE "Unsolved" ENDIF Diese Fehlermeldung wird bei berechneten Attributen angezeigt, aber nicht bei Metriken. Um diesen Fehler zu beheben, verwenden Sie am besten dieselben Bedingungen wie in der Metrik Gelöste Tickets. Die Formel dieser Metrik lautet: IF ([Ticketstatus – unsortiert] = "Solved" OR [Ticketstatus – unsortiert] = "Closed") THEN [Ticket-ID] ENDIF Sie können die Formel also wie oben dargestellt aktualisieren. |
| 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 bei berechneten Attributen angezeigt, aber nicht bei Metriken. Wenn die ursprüngliche Formel komplexer ist und nicht wiederverwendet werden kann, geben Sie mit der Funktion ATTRIBUTE_FIX an, auf welchen Ebenen dieses Attribut aggregiert werden soll. In diesem Fall sollte es auf der Ebene Aktualisierung –Ticket-ID berechnet werden. |
| „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. Ihre Formel enthält bereits einen Aggregator, z. B. MED(Zeit bis zur 1. Antwort – Std.). Die Berechnung eines Durchschnitts zusätzlich zu einem Median ist nicht zulässig. Daher muss der Aggregator der obersten Ebene auf SUM oder der Aggregator der untersten Ebene auf VALUE gesetzt werden. |
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" Die häufigsten Ursachen für diesen Fehler sind:
In diesem Fall weist der Name des Attributs einen Tippfehler auf. |
| „[Berechnete Gruppe]“ hat eine falsch konfigurierte Formel. Beheben Sie das Problem vor dem Speichern. | IF [Berechnete Gruppe] = "light" THEN TRUE ELSE FALSE ENDIF | Berechnete Gruppe ist in dieser Formel falsch konfiguriert. Sie müssen also zuerst die Konfiguration korrigieren. |
| Berechnung bezieht sich hier auf sich selbst: COUNT(Vertriebstickets). Entfernen oder ersetzen Sie sie. | COUNT(Vertriebstickets)/COUNT(Tickets) | Sie fügen eine Formel in sich selbst ein. In diesem Fall bearbeitet der Benutzer die Formel Vertriebstickets und versucht, Vertriebstickets in die Formel einzufügen. |
| 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 berechnete Metrik Zeit bis zur 2. Antwort basiert auf einer anderen Berechnung, die ihrerseits auf einer anderen Berechnung basiert. Solche Berechnungen werden als „verschachtelt“ bezeichnet. 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 sind nur bei Stichwortattributen zulässig. Für andere Attribute müssen Sie die Funktion IN verwenden. |