--- sourceDocument: Yokohama Now Plattformverwaltung sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/platform-administration Release : - yokohama ft:locale : - de-DE ft:publication_title : - Yokohama Now Plattformverwaltung ft:clusterId : - platadm bundleId : - platadm workflow : - Platform --- # Erstellen Sie anwenderdefinierte Datensuchen # Erstellen Sie anwenderdefinierte Datensuchen {#ariaid-title1} * Freigeben Version: Yokohama * * Aktualisiert 30. Januar 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 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, 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. {#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 | wahr | | Modul zu Menü hinzufügen | Systemrichtlinie | [Tabelle : 1. Anwenderdefinierte Datensuchtabelle] {#create-custom-data-lookup__table_n5p_l2q_wq} ## Fügen Sie der Datensuchtabelle einen Datensuchwert hinzu {#ariaid-title3} Die Spalten einer Datensuchtabelle enthalten sowohl Übereinstimmungs- als auch Setter-Felddaten. ### 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. {#t_AddADLValueToTheDataLookupTable__table_yjm_xgq_wq__entry__2} | Ü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 | [Tabelle : 2. Suchtabelle] {#t_AddADLValueToTheDataLookupTable__table_yjm_xgq_wq} ### 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. {#t_AddADLValueToTheDataLookupTable__table_xnv_13q_wq__entry__3} | Name | Typ | Feldlänge oder Tabelle, auf die verwiesen werden soll | |-|-|-| | Anrufer | Referenz | Anwender \[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 [Konfigurieren von Listen auf Now Platform](https://servicenow-prod.fluidtopics.net/Z_eRD3txsiWqQO01ALYa4Q "Anwender mit den entsprechenden Rollen können verschiedene Aspekte von Listen konfigurieren. Konfigurationsänderungen gelten für alle Anwender."). 3. Klicken Sie in der Tabellenliste auf Neu Und geben Sie die entsprechenden Matcher- und Setter-Feldwerte ein. Zum Beispiel: {#t_AddADLValueToTheDataLookupTable__table_gjm_j3q_wq__entry__2} | Übereinstimmungsfeld | Setter-Felder || |-|-|-| | Anrufer | Priorität | Zuweisungsgruppe | | Beth Anglin | 2 | VIP-Probleme | | Fred Luddy | 1 | VIP-Probleme | [Tabelle : 4. Neue Matcher- und Setter-Feldwerte] {#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. ### Vorbereitungen Erforderliche Rolle: Administrator ### Prozedur 1. Navigieren zu AlleSystemrichtlinieBedingungenDatensuchedefinitionenan. 2. Wählen Sie Neu. 3. Wählen Sie Aus 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. 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 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-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. | | Bei Aktualisierung 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. 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 nicht mit funktioniert Journal Typfelder. {#t_CreateADataLookupDefinRec__table_avq_1qq_wq__entry__2} | 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 Ü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 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. | [Tabelle : 6. Übereinstimmungsfelddefinitionsfelder] {#t_CreateADataLookupDefinRec__table_avq_1qq_wq} 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. {#t_CreateADataLookupDefinRec__table_m2j_yqq_wq__entry__2} | 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. | [Tabelle : 7. Definitionsfelder des Festerfelds] {#t_CreateADataLookupDefinRec__table_m2j_yqq_wq} 11. Wählen Sie Absenden. 12. Wählen Sie Aktualisieren. Die folgende Datensuchdefinition weist beispielsweise Incidents der VIP-Problemgruppe basierend auf zu Anrufer Feld. Darüber hinaus werden die Incidents basierend auf dem Anrufer auf die Priorität „Kritisch" oder „hoch" festgelegt. ## Erstellen Sie ein Datensuchmodul {#ariaid-title5} Sie können ein Modul für die Datensuche erstellen, damit es im Instanzanwendungsnavigator angezeigt wird. ### Prozedur 1. Navigieren zu AlleSystemdefinitionAnwendungsmenü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. {#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. | | Linktyp | Liste der Datensätze | [Tabelle : 8. Moduleigenschaften] {#t_CreateADataLookupModule__table_rxn_bsq_wq} 4. Klicken Sie auf Absenden. {#t_CreateADataLookupModule__steps_l55_3rq_t1b} ## Fehlerbehebung bei der Datensuche {#ariaid-title6} 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. {#troubleshooting-data-lookup__ul_jst_vsq_wq}