Automatische Vervollständigung für Referenzfelder

Standardmäßig wird ein Referenzfeld automatisch vervollständigt, wenn der Anwender im 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

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 für automatische 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 Vervollständigung erstellt. Gültige Klassenwerte: AJAXReferenceCompleter: Zeigt übereinstimmende Auswahlmöglichkeiten für die automatische Vervollständigung als Dropdown-Auswahlliste an. Die Liste zeigt nur die Anzeigewertspalte der Referenztabelle an. Referenzfelder verwenden diese Klasse automatisch, wenn keine andere Klasse für die automatische Vervollständigung angegeben ist. AJAXTableCompleter: Zeigt übereinstimmende Auswahlmöglichkeiten für die automatische Vervollständigung als Zeilen in einer Tabelle an. Die Tabelle zeigt die Anzeigewertspalte der Referenztabelle und alle Spalten an, die in aufgeführt sind ref_ac_columnsAttribut. AJAXReferenceChoice: Zeigt übereinstimmende Auswahlmöglichkeiten für die automatische Vervollständigung als Dropdown-Auswahlliste an. Die Liste zeigt nur die Anzeigewertspalte der Referenztabelle an. Außerdem werden in der Liste nur bis zu 25 übereinstimmende Auswahlmöglichkeiten angezeigt. Wenn mehr als 25 Auswahlmöglichkeiten für die automatische Vervollständigung vorhanden sind, werden im Referenzfeld stattdessen die Auswahlmöglichkeiten mit der Klasse „AJAXTableCompleter“ angezeigt.
ref_ac_columns	Gibt die Liste der anzuzeigenden Referenztabellenspalten an. Trennen Sie Spaltennamen durch ein Semikolon. Beispiel: ref_ac_columns=user_name;email;sys_created_onErmöglicht die automatische Vervollständigung, 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.

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 keine eigenen Attribute für die automatische Vervollständigung haben. In diesem Beispiel wird beschrieben, wie Attribute für die automatische 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 für die automatische Vervollständigung jeden Wert ersetzt, den der Administrator für das Attribut für die automatische 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.

   Version	Aktion
   Liste v2	Klicken Sie mit der rechten Maustaste auf den Spaltenheader, und klicken Sie auf Konfigurieren > Wörterbuchan.
   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 die erste 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 für die automatische 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.

Entfernen Sie die Anzeigewertspalte

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 Spalten angezeigt werden, die in aufgeführt sind 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 Anwendertabelle [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.

   Version	Aktion
   Liste v2	Klicken Sie mit der rechten Maustaste auf den Spaltenheader, und klicken Sie auf Konfigurieren > Wörterbuchan.
   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 die erste aus sys_user Link.
4. Unter Zugehörige Links , Klicken Sie auf Erweiterte Ansicht .
5. In Attribute Feld, fügen Sie hinzu 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 für die automatische 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 Anzeigewertspalte (user_Name) aus, und zeigen nur die Spalten first_Name und Last_Name an.

Verbessern Sie die automatische Vervollständigung von Abfragen

Standardmäßig verwenden alle Referenzfelder ein Beginnt mit Abfrage, um nach übereinstimmendem Text in der Referenztabelle zu suchen. Dies 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 erfordern, 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 beliebiger Stelle im vor- oder Nachnamen des Anwenders angezeigt wird.

Dieses Verfahren beschreibt, wie geändert wird 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.
   Geben Sie ein, um nach der Eigenschaft zu suchen *startwith 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 bis 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 die Änderung, indem Sie einen Datensatz mit einem Referenzfeld öffnen und ein Zeichen eingeben, wie im folgenden Beispiel gezeigt.

   

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 Anzeigewertspalte. 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 für Wahr Dient zum Abgleichen von Text aus allen Referenzfeldspalten. Standardmäßig (oder wenn dieses Attribut ist Falsch ) Die automatische Vervollständigung stimmt nur mit Text in der Anzeigewertspalte überein.

Prozedur

1. Wählen Sie die Bezeichnung eines Referenzfelds aus, und halten Sie sie gedrückt (oder klicken Sie mit der rechten Maustaste).
2. Wählen Sie Aus Konfigurieren Sie Wörterbuch Aus der Liste.
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 

5. Klicken Sie auf Aktualisieren.

Beispiel

Das folgende Beispiel beschreibt, wie festgelegt wird Konfigurationselement Feld zeigt die CI-Klassennamen aus Auswahlmöglichkeiten für die Konfigurationselement-Tabelle [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_contributionsAttribut steuert die Symbole, die neben dem Referenzfeld angezeigt werden.

Aktivieren enthält automatisch vervollständigte Suchvorgänge

Standardmäßig verwendet die automatische Vervollständigung der Referenz 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 bis 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.contains'' .
4. Legen Sie fest Wert Feld bis Wahr .
5. Wählen Sie 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.

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