Erstellen Sie eine dynamische Filteroption

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer
  • Dynamische Filteroptionen verbessern die Filterfunktion, indem sie es Anwendern ermöglichen, vorhandene Skripteinbindungen oder JavaScript für ein Referenzfeld in Bedingungsgeneratoren und dynamischen Referenzqualifizierern auszuführen.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Diese Aufgabe beschreibt, wie Sie eine neue dynamische Filteroption und eine zugehörige Skripteinbindungerstellen.

    Dynamische Filteroptionen „objektivieren“ Skripteinbindungen/JavaScript, sodass sie in mehreren Bedingungsgeneratoren und dynamischen Referenzqualifizierernwiederverwendet werden können. Mit diesem Filtertyp können Sie ein Skript einmal ändern und die Änderungen automatisch überall dort übernehmen, wo die dynamische Filteroption verwendet wird.

    Beim Definieren eines dynamischen Filters haben Sie folgende Möglichkeiten:
    • Vorhandene ist (dynamisch) dynamische Filteroption verwenden (nur Bedingungsgenerator)
    • Eine vorhandene dynamische Filteroption verwenden (OOB oder anwenderdefiniert)
    • Erstellen Sie eine neue dynamische Filteroption und eine Skripteinbindung/JavaScript
    Alle dynamischen Filter des Bedingungsgenerators verwenden den Operator is (dynamic) und rufen eine dynamische Filteroption auf. Im folgenden Beispiel wird die bereits vorhandene dynamische Filteroption Me verwendet. Eine Liste der verfügbaren bereits vorhandenen dynamischen Filteroptionen für den Bedingungsgenerator finden Sie unter Dynamische Operatoren.
    Hinweis:
    Dynamische Filter werden in bereichsbezogenen Anwendungen unterstützt, nicht jedoch in UI-Richtlinienbedingungen.
    Abbildung : 1. Dynamische Operanden
    Dynamische Operanden

    Prozedur

    1. Erstellen Sie einen geskripteten Filter als vom Client aufrufbare Skripteinbindung oder Geschäftsregel.
    2. Navigieren zu Systemdefinition > Dynamische Filteroptionen.
    3. Wählen Sie Neu.
    4. Füllen Sie das Formular aus.
      Tabelle : 1. Dynamische Filteroptionen
      Feld Beschreibung
      Bezeichnung Geben Sie einen beschreibenden Namen für die dynamische Filteroption ein.
      Skript Geben Sie den Namen der von Ihnen erstellten Funktion, JavaScript (keine Skripteinbindung erforderlich) oder den vollständigen Skripteinbindungs-/Business-Regelaufruf ein, z. B. new GlobalCanvasUtil().refQualPaTabs().
      Feldtyp Wählen Sie Referenzaus.
      Referenzierte Tabelle Wählen Sie die Tabelle aus, für die diese dynamische Filteroption gilt.
      Reihenfolge Geben Sie eine Zahl ein, um die Platzierung dieser dynamischen Filteroption in der Auswahlliste der Filteroptionen anzugeben.
      Rollen Wählen Sie die Rolle aus, die ein Anwender haben muss, um diese Option anzuzeigen.
      Aktiv Aktivieren oder deaktivieren Sie die Option.
      Referenzskript Optional. Wählen Sie die vom Client aufrufbare Skripteinbindung oder die Business Rule aus, die Sie für den geskripteten Filter erstellt haben. Wenn das Feld Skript JavaScript, eine codierte Abfrage oder die gesamte Skripteinbindungs-/Business-Regelreferenz enthält, kann dieses Feld leer sein.
      Verfügbar für Filter Wählen Sie diese Option aus, um die dynamische Filteroption als Filter-Breadcrumb anzuzeigen.
      Verfügbar für Standard Wählen Sie diese Option aus, damit die dynamische Filteroption als Standard in einem Wörterbucheintrag verwendet werden kann.
      Verfügbar für Ref.qual. Wählen Sie diese Option aus, damit die dynamische Filteroption als dynamischer Referenzqualifizierer ausgewählt werden kann.
      Hinweis:
      Dynamische Filter mit GET-Methoden der Tabellen-API in Skripts funktionieren nur, wenn sie denselben Anwender verwenden, der im Standardauthentifizierungsprofil konfiguriert ist. Um mehreren Anwendern den Zugriff auf die dynamischen Filter zu ermöglichen, verwenden Sie stattdessen globale JavaScript-APIs wie GlideRecord- und GlideQuery-APIs.
    5. Wählen Sie Absenden.