--- sourceDocument: Verwaltung der Xanadu Now Platform sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/platform-administration Release : - xanadu ft:locale : - de-DE ft:publication_title : - Verwaltung der Xanadu Now Platform ft:clusterId : - platadm bundleId : - platadm workflow : - Platform --- # Erstellen Sie anwenderdefinierte Datensuchen # Erstellen Sie anwenderdefinierte Datensuchen {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 {#ariaid-title2} 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. {#create-custom-data-lookup__table_n5p_l2q_wq__entry__2} | Feld | Beispielwert | |-|-| | Bezeichnung | VIP-Anrufersuche | | Tabellenname | u_vip_caller_lookup | | Erweitert Basistabelle | dl_matcher | | Neues Modul erstellen | True | | Modul zu Menü hinzufügen | Systemrichtlinie | [Tabelle : 1. Anwenderdefinierte Datensuchtabelle] {#create-custom-data-lookup__table_n5p_l2q_wq} ## Fügen Sie der Datensuche-Tabelle einen Datensuche-Wert hinzu {#ariaid-title3} 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. {#t_AddADLValueToTheDataLookupTable__table_yjm_xgq_wq__entry__2} | Ü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 | [Tabelle : 2. Suchtabelle] {#t_AddADLValueToTheDataLookupTable__table_yjm_xgq_wq} ### 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. {#t_AddADLValueToTheDataLookupTable__table_xnv_13q_wq__entry__3} | Name | Typ | Feldlänge oder zu referenzierende Tabelle | |-|-|-| | Anrufer | Referenz | Benutzer \[sys_user\] | | Priorität | Ganzzahl | | | Zuweisungsgruppe | Referenz | Gruppe \[sys_user_group\] | [Tabelle : 3. Neue Felder] {#t_AddADLValueToTheDataLookupTable__table_xnv_13q_wq} Weitere Informationen finden Sie unter [Listenkonfiguration](https://www.servicenow.com/docs/je4mXolmo_cbgcjVJRcopQ "Benutzer mit den entsprechenden Rollen können verschiedene Aspekte von Listen konfigurieren. Konfigurationsänderungen gelten für alle Benutzer."). 3. Klicken Sie in der Tabellenliste auf Neu, und geben Sie die entsprechenden Werte für die Übereinstimmungs- und Festsetzungsfeldwerte ein. Beispiel: {#t_AddADLValueToTheDataLookupTable__table_gjm_j3q_wq__entry__2} | Übereinstimmungsfeld | Felder festlegen || |-|-|-| | Anrufer | Priorität | Zuweisungsgruppe | | Beth Anglin | 2 | VIP-Probleme | | Fred Luddy | 1 | VIP-Probleme | [Tabelle : 4. Neue Abgleich- und Festsetzungsfeldwerte] {#t_AddADLValueToTheDataLookupTable__table_gjm_j3q_wq} Hinweis: Jede Zeile in einer Datensuchtabelle muss eindeutig sein. ## Erstellen Sie einen Definitionsdatensatz für die Datensuche {#ariaid-title4} 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 AlleSystemrichtlinieBedingungenDatensuchedefinitionenan. 2. Klicken Sie auf Neu. 3. Klicken Sie auf Datensuchregel. 4. Füllen Sie das Formular „Datensuchregel" mithilfe der folgenden Tabelle aus. {#t_CreateADataLookupDefinRec__table_qcb_2jk_t1b__entry__2} | 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. | [Tabelle : 5. Definitionsfelder für Datensuche] {#t_CreateADataLookupDefinRec__table_qcb_2jk_t1b} 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. {#t_CreateADataLookupDefinRec__table_avq_1qq_wq__entry__2} | 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. | [Tabelle : 6. Übereinstimmungsfelddefinitionsfelder] {#t_CreateADataLookupDefinRec__table_avq_1qq_wq} 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. {#t_CreateADataLookupDefinRec__table_m2j_yqq_wq__entry__2} | 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. | [Tabelle : 7. Felddefinitionsfelder für Feld festlegen] {#t_CreateADataLookupDefinRec__table_m2j_yqq_wq} 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. ## Erstellen Sie ein Datensuchemodul {#ariaid-title5} Sie können ein Modul für die Datensuche erstellen, damit es im Instanzanwendungsnavigator angezeigt wird. ### Prozedur 1. Navigieren zu AlleSystemdefinitionAnwendungsmenü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. {#t_CreateADataLookupModule__table_rxn_bsq_wq__entry__2} | 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 | [Tabelle : 8. Moduleigenschaften] {#t_CreateADataLookupModule__table_rxn_bsq_wq} 4. Klicken Sie auf Absenden. {#t_CreateADataLookupModule__steps_l55_3rq_t1b} ## Problembehandlung bei der Datensuche {#ariaid-title6} 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. {#troubleshooting-data-lookup__ul_jst_vsq_wq}