Dynamische JavaScript-Filter

Erstellen Sie dynamische Bedingungen in JavaScript, die Sie als Teil der Kriterien einer Berichtsvisualisierung anstelle der angegebenen Werte konfigurieren können.

Um einen Bericht mit einer dynamischen bedingten Anweisung zu erstellen, platzieren Sie eine JavaScript-URL in der Anweisung „bedingter Wert“ des Filters. Sie können einen JavaScript-Befehl direkt in das Feld eingeben, aber für ein Skript, das länger als eine Anweisung ist, sollte das Skript in einem eigenen Datensatz platziert werden. Sie rufen dann eine Funktion aus diesem Datensatz im Feld „Wert“ der Berichtsbedingung auf.

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 berechtigt sein, auf die Daten zuzugreifen, über die Sie berichten 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 .

Prozedur

1. Führen Sie eine der folgenden Aktionen aus:
   • In einer aktualisierten Instanz, die nicht vollständig zu migriert wurde Platform Analytics, Navigieren Sie zu Alle > Berichte > Anzeigen/Ausführenan.
   • In einer neuen Instanz oder einer Instanz, die vollständig zu migriert wurde Platform Analytics, Navigieren Sie zu Alle > Platform Analytics-Verwaltung > Nutzung und Governance > Berichtean.
2. Öffnen Sie die Berichtsvisualisierung, der Sie den dynamischen Filter hinzufügen möchten.
3. Wählen Sie das Filtersymbol aus ( ), um den Bedingungsgenerator zu erweitern.
4. Erstellen Sie 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 dieselben 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.

   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 eins 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“	Ein oder mehrere Textzeichen, die einen Wert oder Teil eines Werts darstellen können, 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“	Ein oder mehrere Textzeichen, die einen Wert oder Teil eines Werts darstellen können, 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“	Ein oder mehrere Textzeichen, die einen Wert oder Teil eines Werts darstellen können, 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 (oder nicht).
   Skript (einfach)	„Enthält“, „enthält nicht“	Textwert, der einen Wert darstellt, der im Feld „Skript“ enthalten sein soll (oder nicht).
   Skript (auf Serverseite)
   Skript
   Tabellenkurzname	„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 Feldnamens. 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.
5. Wählen Sie einen Feldtyp und 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 Record_Name Entspricht dem Datensatznamen der Skripteinbindung und Function_Name Ist die Funktion in der Skripteinbindung, die den im Filter verglichenen 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.