Fügen Sie einen dynamischen JavaScript-Filter hinzu

Fügen Sie eine dynamische JavaScript-Anweisung zur Auswertung als Teil der Filterkriterien einer Berichtsvisualisierung hinzu.

Vorbereitungen

Erforderliche Rolle: itil, Report_user, Report_Group, Report_global, Report_admin, oder Administrator. Um einen aussagekräftigen Bericht zu erstellen, müssen Sie das Recht haben, auf die Daten zuzugreifen, für die Sie Berichte erstellen möchten.

Warum und wann dieser Vorgang ausgeführt wird

JavaScript-Filter können einzeilige Anweisungen oder längere Skripts sein. Erstellen Sie für längere JavaScript-Anweisungen eine Skripteinbindung, die das richtige Format und den richtigen Datentyp zurückgibt, den spezifischen Daten entspricht, nach denen der Bericht filtern soll, und vom Client aufrufbar ist. Weitere Informationen finden Sie unter Skripteinbindungen .

Diese Tabelle listet die Operatoren auf, die von jedem Feldtyp unterstützt werden, der JavaScript-Filter unterstützt. Feldtypen, die sich nicht in dieser Tabelle befinden, unterstützen keine JavaScript-Filter und nicht Wert Das Feld im Bedingungsgenerator für diese Feldtypen hat keine Option zum Einfügen eigener Anweisungen.

Feldtyp	Zulässige Operatoren	Erwarteter Rückgabedatentyp
Sys-ID (GUID)	„Ist“, „ist nicht“, „ist eins von“, „beginnt mit“, „endet mit“, „enthält“, „enthält nicht“, „zwischen“, „größer als oder gleich“, „kleiner als oder gleich“.	Textdarstellung eines vollständigen oder teilweisen sys_ID-Werts. Für den Operator „ist eine von“ wäre der erwartete Rückgabetyp entweder eine durch Kommas getrennte Liste von sys_ID-Werten oder ein Array mit jeder sys_ID, die in den Ergebnissen enthalten sein soll.
Freitextzeichenfolge	„Ist“, „ist nicht“, „ist eins von“, „beginnt mit“, „endet mit“, „enthält“, „enthält nicht“, „zwischen“, „größer als oder gleich“, „kleiner als oder gleich“	Mindestens ein Textzeichen. Für den Operator „ist einer von“ wäre das erwartete Ergebnis entweder eine durch Kommas getrennte Liste von Zeichenfolgenwerten oder ein Array mit jedem der Werte, die in das Suchwertfeld „ist einer von“ aufgenommen werden sollen.
Referenz	„Beginnt mit“, „endet mit“, „enthält“, „enthält nicht“	Mindestens ein Textzeichen, das einen Wert oder Teil eines Werts darstellen kann, der in diesem Feld in der Tabelle oder Datenquelle gefunden wurde.
Zeichenfolge (verweist auf eine andere Tabelle)	„Enthält“, „beginnt mit“, „endet mit“, „enthält nicht“	Mindestens ein Textzeichen, das einen Wert oder Teil eines Werts darstellen kann, der in diesem Feld in der Tabelle oder Datenquelle gefunden wurde.
Anwendereingabe	„Ist“, „ist nicht“	Textzeichen, die den vollständigen Wert eines Datensatzes für dieses Feld in der Tabelle oder Datenquelle darstellen könnten.
Tabellenname	„Ist“, „ist nicht“, „ist eins von“, „beginnt mit“, „endet mit“, „enthält“, „enthält nicht“, „zwischen“, „größer als oder gleich“, „kleiner als oder gleich“	Textdarstellung eines vollständigen oder teilweisen Tabellennamens im System. Für den Operator „ist einer von“ wäre der erwartete Rückgabetyp entweder eine durch Kommas getrennte Liste von Tabellennamen-Werten oder ein Array mit jedem Tabellennamen, der in den Ergebnissen enthalten sein soll.
Vorlagenwert	„Ist“, „ist nicht“	Textzeichen, die den Wert gemäß einer in der Instanz gefundenen Vorlage erfüllen.
Domänen-ID	„Beginnt mit“, „endet mit“, „enthält“, „enthält nicht“	Ein oder mehrere Textzeichen, die einen Wert oder Teil eines Werts darstellen können, der im Domänenfeld in der Tabelle oder Datenquelle gefunden wurde.
Anwenderrollen	„Ist“, „ist nicht“	Textdarstellung eines Zeichenfolgenwerts der Anwenderrolle.
Domänenpfad	„Beginnt mit“, „endet mit“, „enthält“, „enthält nicht“, „ist“, „ist nicht“, „ist eins von“, „kleiner als oder gleich“, „größer als oder gleich“, „zwischen“	Mindestens ein Textzeichen, das einen Wert oder Teil eines Werts darstellen kann, der in diesem Feld in der Tabelle oder Datenquelle gefunden wurde. Für den Operator „ist einer von“ entweder eine kommagetrennte Liste von Textwerten oder ein Array-Objekt mit jedem einzuschließenden Wert.
Übersetzter Text	„Ist“, „ist nicht“, „ist eins von“, „beginnt mit“, „endet mit“, „enthält“, „enthält nicht“, „zwischen“, „größer als oder gleich“, „kleiner als oder gleich“	Textwert. Für den Operator „ist einer von“ wäre der erwartete Rückgabetyp entweder eine durch Kommas getrennte Liste von Textwerten oder ein Array von Textwerten.
Übersetztes Feld
HTML	„Enthält“, „enthält nicht“	Textwert, der Daten im ausgewählten Feld in diesen Berichtskriterien entsprechen kann.
HTML-Vorlage
E-Mail-Skript	„Enthält“, „enthält nicht“	Textwert, der einen Wert darstellt, der im Feld „E-Mail-Skript“ enthalten sein soll.
Skript (Einfach)	„Enthält“, „enthält nicht“	Textwert, der einen Wert darstellt, der im Feld „Skript“ enthalten sein soll (oder nicht).
Skript (serverseitig)
Skript
Kurzer Tabellenname	„Ist“, „ist nicht“	Textwert (unter 40 Zeichen). Für den Operator „ist eins von“ ist der erwartete Rückgabetyp entweder eine durch Kommas getrennte Liste von Textwerten oder ein Array mit jedem Textzeichen, das einen kurzen Tabellennamen darstellen würde.
Feldname	„Ist“, „ist nicht“, „ist eins von“, „beginnt mit“, „endet mit“, „enthält“, „enthält nicht“, „zwischen“, „größer als oder gleich“, „kleiner als oder gleich“	Textdarstellung eines vollständigen oder teilweisen Feldnamenwerts. Für den Operator „ist einer von“ wäre der erwartete Rückgabetyp entweder eine durch Kommas getrennte Liste von Feldnamenwerten oder ein Array mit jedem Feldnamen, der in den Ergebnissen enthalten sein soll.

Prozedur

1. Navigieren zu Alle > Platform Analytics > Bibliothek > Datenvisualisierungenan.
2. Öffnen Sie die Datenvisualisierung, der Sie den dynamischen Filter hinzufügen möchten, und wählen Sie sie aus Bearbeiten .
3. In Konfiguration Wählen Sie die Datenquelle aus, die Sie filtern möchten.
4. Erstellen Sie im Abschnitt Filter Ihre Filterbedingung.
   Mit diesen Kombinationen von Feldtypen und Operatoren können Sie eine dynamische JavaScript-Anweisung angeben.

   Hinweis:

   • Der Operator „Zwischen“ stellt zwei Felder bereit, die dieselbe oder verschiedene JavaScript-URLs unterstützen können.
   • Der Operator „ist“ kann ein Array von Datenelementen des erwarteten Typs zurückgeben. In diesem Fall wird der Operator als Operator „ist einer von“ behandelt.
   • Listenfelder unterstützen keine dynamischen JavaScript-Filter.
5. Wählen Sie einen Feldtyp und einen Operator aus, und geben Sie eine JavaScript-Anweisung ein.
   • Verwenden Sie für eine einzeilige JavaScript-Anweisung das Format javascript:<JavaScript_Statement>; .
   • Verwenden Sie für eine JavaScript-Anweisung, die eine Skripteinbindung aufruft, das Format javascript:New <Record_Name>().<Function_Name>(); In welcher Datensatzname Entspricht dem Datensatznamen der Skripteinbindung und Funktionsname Ist die Funktion in der Skripteinbindung, die den im Filter verglich Wert zurückgibt.

   Hinweis:

   Die JavaScript-URL kann auch einen oder mehrere Parameter enthalten, die an die Funktion übergeben werden, die die Berechnung durchführt und ein Ergebnis zurückgibt. Beispielsweise könnte eine JavaScript-Funktion, die zwei Parameter an den Skripteinbindungsdatensatz übergibt, als geschrieben werden javascript:New TextJSFilter().getGroupIDs("Professional Services","Vertrieb"); .

Nächste Maßnahme

Nachdem Sie die erforderlichen JavaScript-Anweisungen und -Bedingungen hinzugefügt und den Rest des Berichts konfiguriert haben, testen Sie den Bericht, um sicherzustellen, dass die erwarteten Ergebnisse zurückgegeben und angezeigt werden.