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
Erstellen Sie ein neues Modul	Wahr
Modul zu Menü hinzufügen	Systemrichtlinie

Fügen Sie der Datensuchtabelle einen Datensuchwert hinzu

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

Vorbereitungen

Erforderliche Rolle: Administrator

Warum und wann dieser Vorgang ausgeführt wird

Jede Datensuche ist eine Abfrage, die nach einer Zeile sucht, die Werte enthält, die den Übereinstimmungsfeldern entsprechen. Die Datensuche gibt dann den in den Setter-Feldern aufgeführten Wert zurück. Beispiel: In dieser Tabelle „Prioritätsdatensuche“ [dl_u_Priority] werden die Kombinationen aus Auswirkung und Dringlichkeit (Übereinstimmungsfelder) aufgelistet, die einen bestimmten Prioritätswert (Festsetzerfeld) erzeugen.

Tabelle : 2. Suchtabelle

Übereinstimmungsfelder		Feld „Feststeller“
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 anwenderdefinierten 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. Wählen Sie in der Tabellenliste aus Neu Und geben Sie die entsprechenden Matcher- und Setter-Feldwerte 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 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.

Vorbereitungen

Erforderliche Rolle: Administrator

Prozedur

1. Navigieren zu Alle > Systemrichtlinie > Bedingungen > Datensuchdefinitionenan.
2. Wählen Sie Neu.
3. Wählen Sie Aus 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. Datensuchdefinitionen werden nicht von Erweiterungstabellen geerbt. Beispielsweise kann eine Datensuchdefinition in der Aufgabentabelle nicht mit Werten in der Incident-Tabelle übereinstimmen.
   Übereinstimmungstabelle	Wählen Sie die Tabelle aus, die die Suchwerte enthält. 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 an, die sich im selben Umfang wie die Katalogdatensuchdefinition befinden.
   Aktiv	Aktivieren Sie dieses Kontrollkästchen, um diese Datensuchregel auszuführen. Deaktivieren Sie das Kontrollkästchen, um diese Datensuchregel zu ignorieren.
   Bei Formularänderung 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.
   Bei Aktualisierung ausführen	Aktivieren Sie dieses Kontrollkästchen, um automatisch nach Werten zu suchen, wenn ein Anwender einen Datensatz speichert oder aktualisiert.

5. Drücken und halten Sie den Formularheader (oder klicken Sie mit der rechten Maustaste darauf), 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 nicht mit 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 bei der Suche	Aktivieren Sie dieses Kontrollkästchen, damit die Übereinstimmungstabelle eine übereinstimmende Zeile für jede mögliche Kombination von Werten enthält (einschließlich leerer Werte). 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 Prioritätswert in der Quelltabellenzeile leer ist. Wenn dieses Kontrollkästchen deaktiviert ist, stimmt der Wert des leeren Matcher-Felds 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 Setter-Felddefinitionen Zugehörige Liste, klicken Sie auf Neu .
10. Füllen Sie das Formular „Setter-Felddefinitionen“ mithilfe der folgenden Tabelle aus.

    Tabelle : 7. Definitionsfelder des Festerfelds

    Feld	Beschreibung
    Datensuche	Zeigt den Namen des Datensatzes der übergeordneten 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 dieses Kontrollkästchen, um einen vorhandenen Wert durch einen Wert aus der Datensuche zu ersetzen. Deaktivieren Sie dieses Kontrollkästchen, um die Aktualisierung zu ignorieren, wenn das Feld einen vorhandenen Wert hat.

11. Wählen Sie Absenden.
12. Wählen Sie Aktualisieren.

Erstellen Sie ein Datensuchmodul

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

Vorbereitungen

Erforderliche Rolle: Administrator

Prozedur

1. Navigieren zu Alle > Systemdefinition > Anwendungsmenüs, Wählen Sie dann eine Anwendung aus, der das Modul hinzugefügt werden soll.
2. Wählen Sie in der zugehörigen Liste Module die Option aus 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. Wählen Sie Absenden.

Fehlerbehebung bei der Datensuche

Wenn sich die Definitionsregeln für die anwenderdefinierte Datensuche nicht wie erwartet verhalten, überprüfen Sie auf bestimmte Bedingungen.

• Stellen Sie sicher, dass 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 kein Ereignis für Formularänderung für schreibgeschützte Felder auslösen.
• Stellen Sie sicher, dass ein Clientskript keinen Feldwert ändert. Client-Skripts können ausgelöst werden Run on form changeEreignisse auch in schreibgeschützten Feldern.
• Stellen Sie sicher, dass die Daten in der Übereinstimmungstabelle korrekt sind.
• Wenn die Suche eine genaue Übereinstimmung erfordert, stellen Sie sicher, dass 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, z. B.:

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