Erstellen Sie anwenderdefinierte Datensuchen

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, um Suchdaten zu speichern.

Die anwenderdefinierte Tabelle muss die Übereinstimmungsregeln für die Datensuche erweitern [Dl_Matcher] Tabelle. 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 Datensuchtabelle einen Datensuchwert 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. Beispielsweise listet diese Tabelle „Prioritätsdatensuche“ [dl_u_Priority] die Kombinationen aus Auswirkung und Dringlichkeit (Übereinstimmungsfelder) auf, die einen bestimmten Prioritätswert (Einstellfeld) erzeugen.

Tabelle : 2. Suchtabelle

Übereinstimmungsfelder		Einstellfeld
Auswirkung	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 Tabelle, auf die verwiesen werden soll
   Anrufer	Referenz	Benutzer [sys_user]
   Priorität	Ganzzahl
   Zuweisungsgruppe	Referenz	Gruppe [sys_user_group]

   Weitere Informationen finden Sie unter Konfigurieren von Listen in ServiceNow AI Platform.

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

   Zum Beispiel:

   Tabelle : 4. Neue Matcher- und Setter-Feldwerte

   Übereinstimmungsfeld	Setter-Felder
   Anrufer	Priorität	Zuweisungsgruppe
   Beth Anglin	2	VIP-Probleme
   Fred Luddy	1	VIP-Probleme

   

   Hinweis:

   Jede Zeile in einer Datensuchtabelle muss eindeutig sein.

Erstellen Sie einen Datensatz für eine Datensuchdefinition

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

Vorbereitungen

Erforderliche Rolle: admin

Prozedur

1. Navigieren zu Alle > Systemrichtlinie > Bedingungen > Datensuchedefinitionenan.
2. Wählen Sie Neu.
3. Wählen Sie Aus Datensuchregel .
4. Füllen Sie das Formular „Datensuchregel“ anhand 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. Datensuchdefinitionen 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 einem u_-Präfix beginnen. Diese Tabelle kann eine beliebige Tabelle im aktuellen Bereich sein, die die Suchwerte enthält. Hinweis: Die Liste zeigt nur Tabellen und Datenbankansichten, die sich im selben Bereich wie die Suchdefinition für Katalogdaten befinden.
   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 onChange-Client-Skript einen Feldwert in einem Quelltabellenformular ändert. Hinweis: Dies umfasst keine Änderungen, die automatisch von anderen Datensuchregeln vorgenommen werden, z. B. Prioritätssuchregeln.
   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. Rechtsklicken Sie auf die Formularüberschrift und wählen Sie Speichern.
6. Von Übereinstimmungsfelddefinitionen Zugehörige Liste, klicken Sie auf Neu .
7. Füllen Sie die Übereinstimmungsfelddefinitionen mithilfe der folgenden Tabelle aus.

   Eine Datensuche findet nur für Felder mit Übereinstimmungsfelddefinitionen statt. Die Datensuche verwendet die Werte der Quelltabellenfelder, um einen oder mehrere Werte aus der Übereinstimmungstabelle zu suchen. Beachten Sie, dass die Datensuche mit nicht funktioniert Journal Typfelder.

   Tabelle : 6. Übereinstimmungsfelddefinitionsfelder

   Feld	Beschreibung
   Datensuche	Zeigt den Namen des übergeordneten Datensatzes der 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. Diese Tabelle kann eine beliebige Tabelle im aktuellen Bereich sein, die die Suchwerte enthält.
   Genaue Übereinstimmung beim Suchen	Aktivieren Sie dieses Kontrollkästchen, damit die Matcher-Tabelle eine übereinstimmende Zeile für jede mögliche Kombination von Werten (einschließlich leerer Werte) enthält. Wenn Sie dieses Kontrollkästchen deaktivieren, stimmen alle leeren Werte in der Übereinstimmungstabelle mit einem beliebigen Wert überein. Angenommen, das Feld Priorität ist in der Übereinstimmungstabelle leer. Wenn dieses Kontrollkästchen aktiviert ist, gibt es nur eine Übereinstimmung, wenn der Wert Priorität in der Quelltabellenzeile leer ist. Wenn dieses Kontrollkästchen deaktiviert ist, stimmt der leere Matcher-Feldwert mit einem beliebigen Wert im Quelltabellenfeld überein. Hinweis: Wenn für die Suche keine genaue Übereinstimmung erforderlich ist, werden Matcher-Tabellenzeilen mit leeren Werten als Platzhalter behandelt, die allen Werten entsprechen.

8. Wählen Sie Absenden.
9. Von Felddefinitionen Festlegen Zugehörige Liste, klicken Sie auf Neu .
10. Füllen Sie das Formular „Setter-Felddefinitionen“ anhand der folgenden Tabelle aus.

    Tabelle : 7. Felder für Felddefinitionen 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 die Datensuche aktualisiert.
    Ü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. Wählen Sie Absenden.
12. Wählen Sie Aktualisieren.

    Beispielsweise weist die folgende Datensuchdefinition Incidents der VIP-Problemgruppe basierend auf zu Anrufer Feld. Darüber hinaus werden die Incidents je nach Anrufer auf „Kritisch“ oder „hoch“ festgelegt.

    

Erstellen Sie ein Datensuchmodul

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

Prozedur

1. Navigieren zu Alle > Systemdefinition > Anwendungsmenüs, 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 Datensuchtabelle, die Sie mit den folgenden Eigenschaften erstellt haben.

   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.
   Linktyp	Liste der Datensätze

4. Klicken Sie auf Absenden.

Fehlerbehebung bei Datensuche

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

• Überprüfen Sie, ob die Datensuchdefinition so festgelegt ist, dass sie für die entsprechenden Ereignisse ausgeführt wird.
• Stellen Sie sicher, dass das Matcher-Feld nicht schreibgeschützt ist. Da Anwender schreibgeschützte Felder nicht ändern können, können Anwenderinteraktionen für schreibgeschützte Felder kein Ereignis für Formularänderungen auslösen.
• Stellen Sie sicher, dass ein Clientskript keinen Feldwert ändert. Client-Skripts können auslösen Run on form changeEreignisse auch in schreibgeschützten Feldern.
• Überprüfen Sie, ob die Daten in der Matcher-Tabelle 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 Feld A = 2.