Erstellen Sie anwenderdefinierte Datensuchen

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 5 Minuten Lesedauer
  • Das Erstellen anwenderdefinierter Datensuchen umfasst das Hinzufügen eines Suchwerts, das Erstellen der Definition und das Aktivieren der Datensuche.

    Erstellen Sie eine anwenderdefinierte Datensuchtabelle

    Erstellen Sie eine anwenderdefinierte Tabelle zum Speichern von Suchdaten.

    Die benutzerdefinierte Tabelle muss die Tabelle „Regeln zur Übereinstimmung mit Datensuche“ [dl_matcher] erweitern. Diese anwenderdefinierte Suchtabelle speichert beispielsweise Informationen zu VIP-Anrufern und Incident-Zuweisungen.

    Tabelle : 1. Anwenderdefinierte Datensuchtabelle
    Feld Beispielwert
    Bezeichnung VIP-Anrufersuche
    Tabellenname u_vip_caller_lookup
    Erweitert Basistabelle dl_matcher
    Neues Modul erstellen True
    Modul zu Menü hinzufügen Systemrichtlinie

    Fügen Sie der Datensuche-Tabelle einen Datensuche-Wert hinzu

    Die Spalten einer Datensuchtabelle enthalten sowohl Übereinstimmungs- als auch Festsetzungsfelddaten.

    Warum und wann dieser Vorgang ausgeführt wird

    Jede Datensuche ist eine Abfrage, die nach einer Zeile sucht, die Werte enthält, die mit den Übereinstimmungsfeldern übereinstimmen. Die Datensuche gibt dann den in den Festsetzungsfeldern aufgeführten Wert zurück. Zum Beispiel listet die Tabelle „Prioritätsdatensuche“ [dl_u_priority] die Kombinationen aus Auswirkung und Dringlichkeit (Matcher-Felder) auf, die einen bestimmten Prioritätswert (Setter-Feld) ergeben.

    Tabelle : 2. Suchtabelle
    Übereinstimmungsfelder Feld „Festlegen“
    Impact Dringlichkeit Priorität
    1 – Hoch 1 – Hoch 1 - Kritisch
    1 – Hoch 2 – Mittel 2 – Hoch
    1 – Hoch 3 – Niedrig 3 – Mittel
    2 – Mittel 1 – Hoch 2 – Hoch
    2 – Mittel 2 – Mittel 3 – Mittel
    2 – Mittel 3 – Niedrig 4 – Niedrig
    3 – Niedrig 1 – Hoch 3 – Mittel
    3 – Niedrig 2 – Mittel 4 – Niedrig
    3 – Niedrig 3 – Niedrig 5 – In Planung

    Prozedur

    1. Geben Sie im Navigationsfilter den Namen der neuen benutzerdefinierten Suchtabelle ein.
      Beispiel: u_vip_caller_lookup.list.
    2. Konfigurieren Sie die Liste, und erstellen Sie neue Felder.

      Erstellen Sie für dieses Beispiel die neuen Felder in der folgenden Tabelle.

      Tabelle : 3. Neue Felder
      Name Typ Feldlänge oder zu referenzierende Tabelle
      Anrufer Referenz Benutzer [sys_user]
      Priorität Ganzzahl
      Zuweisungsgruppe Referenz Gruppe [sys_user_group]

      Weitere Informationen finden Sie unter Listenkonfiguration.

    3. Klicken Sie in der Tabellenliste auf Neu, und geben Sie die entsprechenden Werte für die Übereinstimmungs- und Festsetzungsfeldwerte ein.

      Beispiel:

      Tabelle : 4. Neue Abgleich- und Festsetzungsfeldwerte
      Übereinstimmungsfeld Felder festlegen
      Anrufer Priorität Zuweisungsgruppe
      Beth Anglin 2 VIP-Probleme
      Fred Luddy 1 VIP-Probleme
      Anwenderdefinierte Suchwerte
      Hinweis:
      Jede Zeile in einer Datensuchtabelle muss eindeutig sein.

    Erstellen Sie einen Definitionsdatensatz für die Datensuche

    Die Datensuche erfordert einen Definitionsdatensatz, der angibt, wie ein oder mehrere Feldwerte festgelegt werden, wenn die angegebenen Bedingungen erfüllt sind.

    Prozedur

    1. Navigieren zu Alle > Systemrichtlinie > Bedingungen > Datensuchedefinitionenan.
    2. Klicken Sie auf Neu.
    3. Klicken Sie auf Datensuchregel.
    4. Füllen Sie das Formular „Datensuchregel“ mithilfe der folgenden Tabelle aus.
      Tabelle : 5. Definitionsfelder für Datensuche
      Feld Beschreibung
      Name Geben Sie einen eindeutigen Namen ein, um den Definitionsdatensatz zu identifizieren.
      Quelltabelle Wählen Sie die Tabelle aus, die die Felder enthält, die Sie automatisch mit Suchwerten aktualisieren möchten. Datensuchedefinitionen werden nicht von Erweiterungstabellen geerbt. Beispielsweise kann eine Datensuchdefinition in der Aufgabentabelle nicht mit Werten in der Incident-Incident-Tabelle übereinstimmen.
      Übereinstimmungstabelle Wählen Sie die Tabelle mit den Suchwerten aus. Diese Tabelle muss immer mit dem Präfix „u_“ beginnen.
      Aktiv Aktivieren Sie dieses Kontrollkästchen, um diese Datensuchregel auszuführen. Deaktivieren Sie das Kontrollkästchen, um diese Datensuchregel zu ignorieren.
      Bei Formular-Change ausführen

      Aktivieren Sie dieses Kontrollkästchen, um automatisch nach Werten zu suchen, wenn ein Anwender oder ein onChange-Client-Skript einen Feldwert in einem Quelltabellenformular ändert.

      Hinweis:
      Dies umfasst keine Änderungen, die automatisch von anderen Datensuchregeln vorgenommen wurden, z. B. den Regeln für die Prioritätssuche.
      Beim Einfügen ausführen Aktivieren Sie dieses Kontrollkästchen, um automatisch nach Werten zu suchen, wenn ein Anwender einen neuen Datensatz erstellt.
      Beim Aktualisieren ausführen Aktivieren Sie dieses Kontrollkästchen, um automatisch nach Werten zu suchen, wenn ein Anwender einen Datensatz speichert oder aktualisiert.
    5. Klicken Sie mit der rechten Maustaste in den Header Kopfzeile des Formulars, und wählen Sie Speichern aus.
    6. Klicken Sie in der zugehörigen Liste „Matcher-Felddefinitionen“ auf Neu.
    7. Vervollständigen Sie die Matcher-Felddefinitionen mithilfe der folgenden Tabelle.

      Eine Datensuche erfolgt nur für Felder mit Übereinstimmungsfelddefinitionen. Die Datensuche verwendet die Werte der Quelltabellenfelder, um einen oder mehrere Werte aus der Übereinstimmungstabelle zu suchen. Beachten Sie, dass die Datensuche nicht mit Feldern vom Typ „ Journal “ funktioniert.

      Tabelle : 6. Übereinstimmungsfelddefinitionsfelder
      Feld Beschreibung
      Datensuche Zeigt den Namen des übergeordneten Datensatzes für die Datensuche an.
      Quelltabellenfeld Wählen Sie das Feld aus der Quelltabelle aus, das die abzugleichenden Daten enthält.
      Übereinstimmungstabellenfeld Wählen Sie das Feld aus der Übereinstimmungstabelle aus, das die abzugleichenden Daten enthält.
      Genaue Übereinstimmung beim Suchen

      Aktivieren Sie dieses Kontrollkästchen, damit die Übereinstimmungstabelle für jede mögliche Wertekombination (einschließlich leerer Werte) eine übereinstimmende Zeile enthält. Wenn Sie dieses Kontrollkästchen deaktivieren, entsprechen alle leeren Werte in der Übereinstimmungstabelle einem beliebigen Wert. Angenommen, das Feld Priorität in der Übereinstimmungstabelle ist leer. Wenn dieses Kontrollkästchen aktiviert ist, gibt es nur dann eine Übereinstimmung, wenn der Prioritätswert in der Quelltabellenzeile leer ist. Wenn dieses Kontrollkästchen deaktiviert ist, entspricht der Wert des leeren Übereinstimmungsfelds einem beliebigen Wert im Quelltabellenfeld.

      Hinweis:
      Wenn für die Suche keine exakte Übereinstimmung erforderlich ist, werden Übereinstimmungstabellenzeilen mit leeren Werten als Platzhalter behandelt, die allen Werten entsprechen.
    8. Klicken Sie auf Absenden.
    9. Klicken Sie in der zugehörigen Liste „Felddefinitionen festlegen“ auf Neu.
    10. Füllen Sie das Formular „Felddefinitionen für Festsetzung“ mithilfe der folgenden Tabelle aus.
      Tabelle : 7. Felddefinitionsfelder für Feld festlegen
      Feld Beschreibung
      Daten suchen Zeigt den Namen des übergeordneten Datensatzes für Datensuchdefinitionen an.
      Quelltabellenfeld Wählen Sie das Feld aus der Quelltabelle aus, das durch die Datensuche aktualisiert wird.
      Übereinstimmungstabellenfeld Wählen Sie das Feld aus der Übereinstimmungstabelle aus, das den neuen Wert für das Update bereitstellt.
      Immer ersetzen Aktivieren Sie diese Checkbox, um einen vorhandenen Wert durch einen Wert aus der Datensuche zu ersetzen. Deaktivieren Sie diese Checkbox, um die Aktualisierung zu ignorieren, wenn das Feld einen vorhandenen Wert aufweist.
    11. Klicken Sie auf Absenden.
    12. Klicken Sie auf Aktualisieren.

      Die folgende Datensuchdefinition weist beispielsweise der Gruppe VIP-Probleme Incidents basierend auf dem Feld Anrufer zu. Darüber hinaus werden die Incidents je nach Anrufer auf die Priorität „Kritisch“ oder „Hoch“ festgelegt.

      Datensuchdefinition

    Erstellen Sie ein Datensuchemodul

    Sie können ein Modul für die Datensuche erstellen, damit es im Instanzanwendungsnavigator angezeigt wird.

    Prozedur

    1. Navigieren zu Alle > Systemdefinition > Anwendungsmenüs, und wählen Sie dann eine Anwendung aus, der das Modul hinzugefügt werden soll.
    2. Klicken Sie in der zugehörigen Liste „Module“ auf Neu.
    3. Konfigurieren Sie ein Modul für die von Ihnen erstellte Datensuchtabelle mit den folgenden Eigenschaften.
      Tabelle : 8. Moduleigenschaften
      Eigenschaft Erforderlicher Wert
      Tabelle Wählen Sie die Datensuchtabelle aus, die Sie in Schritt 2 erstellt haben. Beispiel: u_vip_caller_lookup.
      Link-Typ Liste der Datensätze
    4. Klicken Sie auf Absenden.

    Problembehandlung bei der Datensuche

    Wenn sich die Definitionsregeln für benutzerdefinierte Datensuche nicht wie erwartet verhalten, prüfen Sie, ob bestimmte Bedingungen erfüllt sind.

    • Stellen Sie sicher, dass die Datensuchdefinition so festgelegt ist, dass sie für die entsprechenden Ereignisse ausgeführt wird.
    • Vergewissern Sie sich, dass das Feld „Matcher“ nicht schreibgeschützt ist. Da Benutzer keine schreibgeschützten Felder ändern können, können Benutzerinteraktionen kein Change-Ereignis im Formular für schreibgeschützte Felder auslösen.
    • Stellt sicher, dass ein Client-Skript keinen Feldwert ändert. Client-Skripts können Run on form change -Ereignisse auch für schreibgeschützte Felder auslösen.
    • Vergewissern Sie sich, dass die Daten in der Übereinstimmungstabelle korrekt sind.
    • Wenn für die Suche eine genaue Übereinstimmung erforderlich ist, überprüfen Sie, ob für jede mögliche Kombination eine Übereinstimmungstabellenzeile vorhanden ist (einschließlich leerer Werte). Die Suche schlägt fehl, wenn kein übereinstimmender Wert gefunden werden kann.
    • Stellen Sie sicher, dass Sie keine rekursive Regel erstellt haben, etwa:

      Wenn Feld A = 1, dann Feld B = 2. Wenn Feld B = 2, dann ist Feld A = 2.