Automatische Vervollständigung für Referenzfelder

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 8 Minuten Lesedauer

    • Standardmäßig wird ein Referenzfeld automatisch vervollständigt, wenn der Anwender in das Feld eingibt.

    Administratoren können zusätzliche Optionen für die automatische Vervollständigung konfigurieren. Ein Anwender muss über Leseberechtigung auf Tabellenebene für die referenzierte Tabelle verfügen, damit Optionen automatisch vervollständigt werden können.
    Abbildung : 1. Automatische Vervollständigung
    Ein Anwender gibt joe ein, und die automatische Vervollständigung schlägt Joe-Mitarbeiter für das Feld vor.

    Wörterbuchattribute für die automatische Vervollständigung von Referenzfeldern

    Es gibt Wörterbuchattribute, die spezifisch für Referenzfelder sind und das Verhalten der automatischen Vervollständigung bestimmen.

    Tabelle : 1. Wörterbuchattribute der automatischen Vervollständigung des Referenzfelds
    Attribut Beschreibung
    ref_auto_completer Gibt den Namen der clientseitigen JavaScript-Klasse an, die die Dropdown-Auswahlmöglichkeiten für die automatische Fertigstellung erstellt. Zu den gültigen Klassenwerten gehören:
    • AJAXReferenceCompleter: Zeigt übereinstimmende Auswahlmöglichkeiten für automatische Vervollständigung als Dropdown-Auswahlliste an. In der Liste wird nur die Anzeigewertspalte der Referenztabelle angezeigt. Referenzfelder verwenden diese Klasse automatisch, wenn keine andere Klasse für automatische Vervollständigung angegeben ist.
    • AJAXTableCompleter: Zeigt übereinstimmende Auswahlmöglichkeiten für automatische Vervollständigung als Zeilen in einer Tabelle an. In der Tabelle werden die Anzeigewertspalte der Referenztabelle und alle Spalten angezeigt, die in aufgeführt sind ref_ac_columnsAttribut.
    • AJAXReferenceChoice: Zeigt übereinstimmende Auswahlmöglichkeiten für automatische Vervollständigung als Dropdown-Auswahlliste an. In der Liste wird nur die Anzeigewertspalte der Referenztabelle angezeigt. Darüber hinaus werden in der Liste nur bis zu 25 übereinstimmende Optionen angezeigt. Wenn mehr als 25 Optionen zur automatischen Vervollständigung vorhanden sind, zeigt das Referenzfeld stattdessen die Auswahlmöglichkeiten mit der AJAXTableCompleter-Klasse an.
    ref_ac_columns Gibt die Liste der anzuzeigenden Referenztabellenspalten an. Trennen Sie die Spaltennamen mit einem Semikolon. Beispiel: ref_ac_columns=user_name;email;sys_created_onErmöglicht die automatische Vervollständigung, um Text aus den Spalten „user_Name“, „email“ und „sys_created_on“ abzugleichen.
    ref_ac_order_by Gibt die Referenztabellenspalte an, die die Auswahlmöglichkeiten für die automatische Vervollständigung sortiert. Beispiel: ref_ac_order_by=nameSortiert die Auswahlmöglichkeiten für die automatische Vervollständigung alphabetisch nach Namen.

    UI-Funktionen automatisch vervollständigen

    Die AJAX-Tabellenvollständiger-Klasse weist eine Reihe von UI-Verbesserungen auf.

    • Der Tabellenvollständiger zeigt immer die Anzahl der Datensätze an, die die automatisch vervollständigte Abfrage findet.
    • Der Tabellenvollständiger hebt die gesamte ausgewählte Zeile hervor, indem die Farbe des Hintergrunds und des Texts geändert wird.
    • Der Tabellenvollständiger listet für jede Spalte einen Wert auf.
      • Wenn ein Wert zum ersten Mal in einer Spalte angezeigt wird, wird er vom Tabellenvollständiger in schwarzem Text angezeigt.
      • Der Tabellenvollständiger zeigt nachfolgende doppelte Werte in grauem Text an. Zuvor zeigte der Tabellenvollständiger eine leere Zelle in einer Spalte an, die einen doppelten Wert enthält.
    Abbildung : 2. Hervorhebung der ausgewählten Zeile

    Legen Sie fest ref_auto_completer=AJAXTableCompleterWörterbuchattribut zur Verwendung dieser Verbesserungen.

    Definieren Sie Attribute für die automatische Vervollständigung für alle Verweise auf eine Tabelle

    Ein Feld erbt die Attribute der automatischen Vervollständigung der Referenztabelle und verwendet sie, es sei denn, das Feld hat seinen eigenen Wert für dieselben Attribute. Sie können die Attribute für Verweise auf eine Tabelle definieren. Dies wirkt sich auf jedes Formular aus, das auf diese Tabelle verweist.

    Vorbereitungen

    Erforderliche Rolle: Personalize_dictionary

    Warum und wann dieser Vorgang ausgeführt wird

    Ein Attribut auf Feldebene überschreibt ein Attribut auf Tabellenebene mit demselben Namen. Wenn ein Feld andere Referenzattribute verwendet als die, die für die Referenztabelle definiert sind, verwendet das Feld beide Sätze von Attributen.

    Verwenden Sie diese Schritte, um Attribute für die automatische Vervollständigung für alle Felder in einer Tabelle zu definieren, die noch nicht über eigene Attribute für die automatische Vervollständigung verfügen. In diesem Beispiel wird beschrieben, wie Attribute der automatischen Vervollständigung für alle Verweise auf die Tabelle „Anwender“ [sys_user] definiert werden.
    Hinweis:
    Der Attributwert für die automatische Vervollständigung eines Felds ersetzt den Attributwert für die automatische Vervollständigung einer Tabelle. Dies bedeutet, dass jeder vorhandene Wert auf Feldebene für ein Attribut der automatischen Vervollständigung jeden Wert ersetzt, den der Administrator für das Attribut der automatischen Vervollständigung aus der Referenztabelle anwendet.

    Prozedur

    1. Navigieren Sie zu einer Liste der Zieltabelle, z. B. Alle > Anwenderadministration > Anwenderan.
    2. Führen Sie die entsprechende Aktion für Ihre Listenversion aus.
      VersionAktion
      Liste v2 Klicken Sie mit der rechten Maustaste auf den Spaltenheader, und klicken Sie auf Konfigurieren > Lexikonan.
      Liste v3 Öffnen Sie das Listentitelmenü, und klicken Sie auf Konfigurieren , Und klicken Sie dann auf Wörterbuch .
    3. Wählen Sie die Zeile aus, die keinen Spaltennamen auflistet.
      Diese Zeile ist normalerweise die erste Zeile in der Liste. Wählen Sie beispielsweise zuerst aus sys_user Link.
    4. Unter Zugehörige Links , Klicken Sie auf Erweiterte Ansicht .
    5. In Attribute Feld: Geben Sie eine kommagetrennte Liste von Attributen für die automatische Vervollständigung ein, die Sie auf alle Felder in der Tabelle anwenden möchten.
      Um beispielsweise die Abteilung des Anwenders mit allen Verweisen auf die Tabelle „sys_user“ anzuzeigen, geben Sie Folgendes ein: 
      ref_auto_completer=AJAXTableCompleter,ref_ac_columns=department,ref_ac_order_by=department
    6. Klicken Sie auf Aktualisieren.

    Nächste Maßnahme

    Um die neuen Attribute der automatischen Vervollständigung zu testen, öffnen Sie ein Formular, das auf die Anwendertabelle [sys_user] verweist, z. B. einen offenen Incident. Geben Sie ein einzelnes Zeichen in ein Zugewiesen an Feld. Die Optionen für die automatische Vervollständigung enthalten jetzt sowohl den Anwendernamen als auch die Abteilung.
    Liste der automatischen Vervollständigung

    Entfernen Sie die Spalte „Anzeigewert“

    Sie können die Anzeigewertspalte aus einem Referenzfeld entfernen, indem Sie festlegen ref_ac_display_valueAttribut auf „falsch“.

    Vorbereitungen

    Erforderliche Rolle: Personalize_dictionary

    Warum und wann dieser Vorgang ausgeführt wird

    Dies führt dazu, dass das Referenzfeld die Anzeigewertspalte entfernt und nur die in aufgeführten Spalten angezeigt werden ref_ac_columnsAttribut. Diese Funktion erfordert die Verwendung von AJAXTableCompleter Klasse und ref_ac_columns, ref_ac_columns_search, Und ref_ac_display_valueAttribute.
    Hinweis:
    Die automatische Vervollständigung kann nicht mit Text aus zusätzlichen Spalten übereinstimmen, wenn das Referenzfeld ein Produkt von ist ui_referenceUI-Makro. Dies bedeutet, dass jede automatische Vervollständigungsaktion für eine Auswahl, z. B. die Liste „Anwender annehmen“, nur Text mit dem Anzeigewert abgleichen kann.

    In diesem Beispiel wird beschrieben, wie die Anzeigewertspalte aus Verweisen auf die Tabelle „Anwender“ [sys_user] entfernt und durch Verweise auf die Spalten „first_Name“ und „Last_Name“ ersetzt wird.

    Prozedur

    1. Navigieren Sie zu einer Liste der Zieltabelle, z. B. Alle > Anwenderadministration > Anwenderan.
    2. Führen Sie die entsprechende Aktion für Ihre Listenversion aus.
      VersionAktion
      Liste v2 Klicken Sie mit der rechten Maustaste auf den Spaltenheader, und klicken Sie auf Konfigurieren > Lexikonan.
      Liste v3 Öffnen Sie das Listentitelmenü, und klicken Sie auf Konfigurieren , Und klicken Sie dann auf Wörterbuch .
    3. Wählen Sie die Zeile aus, die keinen Spaltennamen auflistet.
      Diese Zeile ist normalerweise die erste Zeile in der Liste. Wählen Sie beispielsweise zuerst aus sys_user Link.
    4. Unter Zugehörige Links , Klicken Sie auf Erweiterte Ansicht .
    5. In Attribute Feld hinzufügen ref_auto_completer, ref_ac_columns, ref_ac_columns_search , Und ref_ac_display_valueAttribute.
      Um beispielsweise die Spalte „Anzeigewert“ auszublenden und nur den vor- und Nachnamen des Anwenders anzuzeigen, geben Sie Folgendes ein. 
      ref_auto_completer=AJAXTableCompleter,ref_ac_columns=first_name;last_name,ref_ac_columns_search=true,ref_ac_display_value=false
    6. Klicken Sie auf Aktualisieren.

    Nächste Maßnahme

    Um die neuen Attribute der automatischen Vervollständigung zu testen, öffnen Sie ein Formular, das auf die Anwendertabelle [sys_user] verweist, z. B. einen offenen Incident. Geben Sie ein einzelnes Zeichen in ein Zugewiesen an Feld. Die Optionen für die automatische Vervollständigung blenden jetzt die Spalte „Anzeigewert“ (user_Name) aus und zeigen nur die Spalten „first_Name“ und „Last_Name“ an.

    Automatische Vervollständigung – kein Anzeigewert

    Verbessern Sie die automatische Vervollständigung von Abfragen

    Standardmäßig verwenden alle Referenzfelder eine Beginnt mit Abfrage zum Suchen nach übereinstimmendem Text in der Referenztabelle. Dadurch wird verhindert, dass die automatische Vervollständigung ineffizient ausgeführt wird Enthält Fragt jedes Mal ab, wenn ein Anwender ein Referenzfeld durchsucht. Sie können festlegen, dass alle Referenzfelder eine verwenden Beginnt mit Abfrage.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Das folgende Beispiel veranschaulicht einen Enthält Abfrage. Beachten Sie, dass der Buchstabe „d“ an einer beliebigen Stelle im vor- oder Nachnamen des Anwenders angezeigt wird.
    Automatische Vervollständigung enthält Abfrage

    In diesem Verfahren wird beschrieben, wie Sie ändern glide.ui.ref_ac.startswithSystemeigenschaft, die immer verwendet werden soll starts withAbfrage.

    Prozedur

    1. Geben Sie im Navigationsfilter ein sys_properties.list Und drücken Sie die Eingabetaste.
    2. Wählen Sie die Eigenschaft glide.ui.ref_ac.startswith aus.
      Um nach der Eigenschaft zu suchen, geben Sie ein *startsmit In Wechseln Sie zu Suchfilter für Name Spalte.
    3. In Wert Feld ersetzen Falsch Mit Wahr .
      Hinweis:
      Wird festgelegt glide.ui.ref_ac.startswithSystemeigenschaft zu Wahr Überschreibt alle vorhandenen autocomplete.containsEinstellungen sowohl in den Einstellungen auf Anwender- als auch auf Systemebene. Diese Eigenschaft ändert die Abfragemethode für die automatische Vervollständigung für alle Anwender unabhängig von den Einstellungen.
    4. Klicken Sie auf Aktualisieren.
    5. Testen Sie den Change, indem Sie einen Datensatz mit einem Referenzfeld öffnen und ein Zeichen eingeben, wie im folgenden Beispiel dargestellt.
      Die automatische Vervollständigung beginnt mit Abfrage

    Konfigurieren Sie die automatische Vervollständigung, um Text aus einem beliebigen Referenzfeld abzugleichen

    Standardmäßig entspricht die automatische Vervollständigung nur dem Text in der Spalte „Anzeigewert“. Sie können ein Referenzfeld so konfigurieren, dass es Text aus jeder zusätzlichen Spalte abgleicht, die das Referenzfeld anzeigt.

    Vorbereitungen

    Erforderliche Rolle: Personalize_dictionary

    Warum und wann dieser Vorgang ausgeführt wird

    Sie können hinzufügen ref_ac_columns_searchAttribut zum Aktivieren der automatischen Vervollständigung, um Text in einer beliebigen Spalte abzugleichen, die in aufgeführt ist ref_ac_columnsAttribut. Legen Sie fest ref_ac_columns_searchAttribut zu Wahr Zum Abgleichen von Text aus allen Referenzfeldspalten. Standardmäßig (oder wenn dieses Attribut ist Falsch ) Die automatische Vervollständigung entspricht nur dem Text in der Spalte „Anzeigewert“.

    Prozedur

    1. Klicken Sie mit der rechten Maustaste auf die Bezeichnung eines Referenzfelds.
    2. Wählen Sie Aus Konfigurieren Sie Wörterbuch Aus der Auswahlliste.
    3. Unter Zugehörige Links , Klicken Sie auf Erweiterte Ansicht .
    4. In Attribute Fügen Sie die gewünschten Attribute für die automatische Vervollständigung hinzu.
      Diese Attribute fügen beispielsweise der Anruferliste das Feld „Abteilung“ hinzu, und sortieren Anrufer nach ihrer Abteilung:
      ref_auto_completer=AJAXTableCompleter,ref_ac_columns=department,ref_ac_order_by=department,ref_ac_columns_search=true
      Abbildung : 3. Attribut für automatische Vervollständigung
      Anruferliste mit Name und Abteilung
    5. Klicken Sie auf Aktualisieren.

    Beispiel

    Im folgenden Beispiel wird beschrieben, wie Sie festlegen Konfigurationselement Feld zeigt die CI-Klassennamen aus Auswahlmöglichkeiten für die Tabelle „Konfigurationselement“ [cmdb_ci] an.
    ref_auto_completer=AJAXTableCompleter ,ref_ac_columns =sys_class_name ,ref_ac_order_by =sys_class_name ,ref_contributions =task_show_ci_map ;ci_show_incidents
    Hinweis:
    Die ref_contributionsDas Attribut steuert die Symbole, die neben dem Referenzfeld angezeigt werden.

    Zusätzliche CI-Attribute

    Aktivieren enthält automatisch vervollständigte Suchvorgänge

    Standardmäßig verwendet die Referenz für die automatische Vervollständigung einen Beginnt mit Suchen. Eine Anwendereinstellung kann erstellt werden, um eine zu implementieren Enthält Suchen.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Deaktivieren Sie glide.ui.ref_ac.startswithSystemeigenschaft.
      Weitere Informationen finden Sie unter Verbessern Sie die automatische Vervollständigung von Abfragen.
      Hinweis:
      Wird festgelegt glide.ui.ref_ac.startswithSystemeigenschaft zu Wahr Überschreibt alle vorhandenen Einstellungen für „Autocomplete.enthält“ sowohl in den Einstellungen auf Anwender- als auch auf Systemebene. Diese Eigenschaft ändert die Abfragemethode für die automatische Vervollständigung für alle Anwender unabhängig von den Einstellungen.
    2. Navigieren zu Anwenderadministration > Anwendereinstellungenan.
    3. Wählen Sie die Einstellung aus „'<referenced table>.Autocomplete.enthält'' .
    4. Legen Sie fest Wert Feld bis Wahr .
      Anwendereinstellung für automatische Vervollständigung auf „wahr“ festgelegt
    5. Klicken Sie auf Aktualisieren.

    Nächste Maßnahme

    Melden Sie sich ab, und melden Sie sich erneut an, um die aktualisierte Suche anzuzeigen.

    Platzhalter in automatischen Vervollständigungen der Referenz

    Platzhaltersuchen verwenden die Funktion zur automatischen Vervollständigung.

    Verwenden Sie ein Sternchen im Referenzfeld für Platzhaltersuchen.

    Abbildung : 4. Platzhaltersuche mit einem Sternchen

    Wenn zwei Sternchen eingegeben werden, wird eine Liste der verfügbaren Datensätze in den Vorschlägen für automatische Vervollständigung angezeigt.

    Abbildung : 5. Platzhaltersuche mit zwei Sternchen