Saisie semi-automatique pour les champs de référence

Par défaut, un champ de référence se remplit automatiquement lorsque l’utilisateur saisit du type dans le champ.

Les administrateurs peuvent configurer d’autres options de saisie semi-automatique. Un utilisateur doit disposer d’une autorisation de lecture au niveau de la table sur la table référencée pour que la saisie semi-automatique affiche des options.

Figure 1. Saisie semi-automatique

Attributs de dictionnaire pour la saisie semi-automatique des champs de référence

Il existe des attributs de dictionnaire spécifiques aux champs de référence qui déterminent le comportement de saisie semi-automatique.

Tableau 1. Attributs du dictionnaire de saisie semi-automatique du champ de référence

Attribut	Description
ref_auto_completer	Spécifie le nom de la classe JavaScript côté client qui crée les choix de saisie semi-automatique dans la liste déroulante. Les valeurs de classe valides sont les suivantes : AJAXReferenceCompleter: affiche les choix de saisie semi-automatique correspondants sous forme de liste déroulante de choix. La liste affiche uniquement la colonne de valeur d’affichage de la table de référence. Les champs de référence utilisent automatiquement cette classe si aucune autre classe de saisie semi-automatique n’est spécifiée. AJAXTableCompleter: affiche les choix de saisie semi-automatique correspondants sous forme de lignes dans un tableau. La table affiche la colonne de valeur d’affichage de la table de référence et toutes les colonnes répertoriées dans l’attribut ref_ac_columns . AJAXReferenceChoice: affiche les choix de saisie semi-automatique correspondants sous forme de liste déroulante de choix. La liste affiche uniquement la colonne de valeur d’affichage de la table de référence. De plus, la liste n’affiche que 25 choix correspondants. S’il existe plus de 25 choix de saisie semi-automatique, le champ de référence affiche à la place les choix avec la classe AJAXTableCompleter.
ref_ac_columns	Spécifie la liste des colonnes de table de référence à afficher. Séparez les noms de colonnes par un point-virgule. Par exemple, autorise ref_ac_columns=user_name;email;sys_created_on la saisie semi-automatique pour faire correspondre le texte des colonnes user_name, e-mail et sys_created_on.
ref_ac_order_by	Spécifie la colonne de table de référence qui trie les choix de saisie semi-automatique. Par exemple, ref_ac_order_by=name trie les choix de saisie semi-automatique par ordre alphabétique des noms.

Définir des attributs de saisie semi-automatique pour toutes les références à une table

Un champ hérite et utilise les attributs de saisie semi-automatique de la table de référence, sauf si le champ possède sa propre valeur pour les mêmes attributs. Vous pouvez définir les attributs des références à une table, et cela affecte tous les formulaires qui font référence à cette table.

Avant de commencer

Rôle requis : personalize_dictionary

Pourquoi et quand exécuter cette tâche

Un attribut au niveau du champ remplace un attribut au niveau de la table du même nom. Si un champ utilise des attributs de référence différents de ceux définis pour la table de référence, le champ utilise les deux ensembles d’attributs.

Suivez ces étapes pour définir des attributs de saisie semi-automatique pour tous les champs d’une table qui n’ont pas déjà leurs propres attributs de saisie semi-automatique. Cet exemple décrit comment définir des attributs de saisie semi-automatique pour toutes les références à la table Utilisateur [sys_user].

Remarque :

La valeur d’attribut de saisie semi-automatique d’un champ remplace la valeur d’attribut de saisie semi-automatique d’une table. Cela signifie que toute valeur existante au niveau du champ pour un attribut de saisie semi-automatique remplace toute valeur que l’administrateur applique à l’attribut de saisie semi-automatique de la table de référence.

Procédure

1. Accédez à une liste de la table cible, par exemple Tous > Administration utilisateurs > Utilisateurs.
2. Effectuez l’action appropriée pour la version de votre liste.

   Version	Action
   Liste v2	Cliquez avec le bouton droit sur l’en-tête de colonne, puis cliquez sur Configurer > Dictionnaire.
   Liste v3	Ouvrez le menu du titre de la liste et cliquez sur Configurer, puis sur Dictionnaire.

3. Sélectionnez la ligne qui ne répertorie pas de nom de colonne.
   Cette ligne est généralement la première ligne de la liste. Par exemple, sélectionnez le premier lien sys_user .
4. Sous Liens connexes, cliquez sur Vue avancée.
5. Dans le champ Attributs , saisissez une liste d’attributs de saisie semi-automatique séparés par des virgules que vous souhaitez appliquer à tous les champs de la table.
   Par exemple, pour afficher le département de l’utilisateur avec toutes les références à la table sys_user, saisissez :

   ref_auto_completer=AJAXTableCompleter,ref_ac_columns=department,ref_ac_order_by=department

6. Cliquez sur Mettre à jour.

Que faire ensuite

Pour tester les nouveaux attributs de saisie semi-automatique, ouvrez un formulaire qui fait référence à la table Utilisateur [sys_user], par exemple un incident ouvert. Saisissez un caractère unique dans le champ Affecté à . Les options de saisie semi-automatique incluent désormais à la fois le nom d’utilisateur et le département.

Supprimer la colonne de valeur d’affichage

Vous pouvez supprimer la colonne de valeur d’affichage d’un champ de référence en définissant l’attribut ref_ac_display_value sur false.

Avant de commencer

Rôle requis : personalize_dictionary

Pourquoi et quand exécuter cette tâche

Le champ de référence supprime alors la colonne de valeur d’affichage et affiche uniquement les colonnes répertoriées dans l’attribut ref_ac_columns . Cette fonctionnalité nécessite l’utilisation de la classe AJAXTableCompleter et des ref_ac_columnsattributs , ref_ac_columns_searchet .ref_ac_display_value

Remarque :

La saisie semi-automatique ne peut pas correspondre au texte des colonnes supplémentaires lorsque le champ de référence est un produit de la ui_reference macro d’interface utilisateur. Cela signifie que toute action de saisie semi-automatique sur un sélecteur, telle que la liste Emprunter l’identité d’un utilisateur, ne peut faire correspondre que le texte à la valeur d’affichage.

Cet exemple décrit comment supprimer la colonne de valeur d’affichage des références à la table Utilisateur [sys_user] et la remplacer par des références aux colonnes first_name et last_name.

Procédure

1. Accédez à une liste de la table cible, par exemple Tous > Administration utilisateurs > Utilisateurs.
2. Effectuez l’action appropriée pour la version de votre liste.

   Version	Action
   Liste v2	Cliquez avec le bouton droit sur l’en-tête de colonne, puis cliquez sur Configurer > Dictionnaire.
   Liste v3	Ouvrez le menu du titre de la liste et cliquez sur Configurer, puis sur Dictionnaire.

3. Sélectionnez la ligne qui ne répertorie pas de nom de colonne.
   Cette ligne est généralement la première ligne de la liste. Par exemple, sélectionnez le premier lien sys_user .
4. Sous Liens connexes, cliquez sur Vue avancée.
5. Dans le champ Attributs, ajoutez les ref_auto_completerattributs , ref_ac_columns, .ref_ac_display_valueref_ac_columns_search
   Par exemple, pour masquer la colonne de valeur d’affichage et n’afficher que les noms et prénoms de l’utilisateur, saisissez ce qui suit.

   ref_auto_completer=AJAXTableCompleter,ref_ac_columns=first_name;last_name,ref_ac_columns_search=true,ref_ac_display_value=false

6. Cliquez sur Mettre à jour.

Que faire ensuite

Pour tester les nouveaux attributs de saisie semi-automatique, ouvrez un formulaire qui fait référence à la table Utilisateur [sys_user], par exemple un incident ouvert. Saisissez un caractère unique dans le champ Affecté à . Les options de saisie semi-automatique masquent désormais la colonne de valeur d’affichage (user_name) et n’affichent que les colonnes first_name et last_name.

Améliorer les requêtes de saisie semi-automatique

Par défaut, tous les champs de référence utilisent une requête commençant par pour rechercher du texte correspondant dans la table de référence. Cela empêche la saisie semi-automatique d’exécuter des requêtes contenant inefficaces chaque fois qu’un utilisateur recherche un champ de référence. Vous pouvez exiger que tous les champs de référence utilisent une requête Starter par .

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

L’exemple suivant illustre une requête contains . Notez que la lettre « d » apparaît n’importe où dans le prénom ou le nom de famille de l’utilisateur.

Cette procédure décrit comment modifier la glide.ui.ref_ac.startswith propriété système pour toujours utiliser une starts with requête.

Procédure

1. Dans le filtre de navigation, saisissez sys_properties.list et appuyez sur la touche Entrée.
2. Sélectionnez la propriété glide.ui.ref_ac.startswith.
   Pour rechercher la propriété, entrez *startswith dans le filtre de recherche Accéder à la colonne Nom .
3. Dans le champ Valeur , remplacez faux par vrai.
   Remarque :

   Définir la glide.ui.ref_ac.startswith propriété système sur vrai remplace tous les paramètres existants autocomplete.contains dans les préférences au niveau de l’utilisateur et du système. Cette propriété modifie la méthode de requête de saisie automatique pour tous les utilisateurs, quelles que soient leurs préférences.
4. Cliquez sur Mettre à jour.
5. Testez le changement en ouvrant un enregistrement avec un champ de référence et en y saisissant un caractère, comme illustré dans l’exemple ci-dessous.

   

Configurer la saisie semi-automatique pour faire correspondre le texte de n’importe quel champ de référence

Par défaut, la saisie semi-automatique correspond uniquement au texte de la colonne de valeur d’affichage. Vous pouvez configurer un champ de référence pour qu’il corresponde au texte de n’importe quelle colonne supplémentaire affichée par le champ de référence.

Avant de commencer

Rôle requis : personalize_dictionary

Pourquoi et quand exécuter cette tâche

Vous pouvez ajouter l’attribut pour activer la ref_ac_columns_search saisie semi-automatique afin qu’elle corresponde au texte de n’importe quelle colonne répertoriée dans l’attribut ref_ac_columns . Définissez l’attribut ref_ac_columns_search sur vrai pour correspondre au texte de toutes les colonnes de champ de référence. Par défaut (ou lorsque cet attribut est faux), la saisie semi-automatique correspond uniquement au texte de la colonne de valeur d’affichage.

Procédure

1. Sélectionnez et maintenez enfoncée (ou cliquez avec le bouton droit de la souris) l’étiquette d’un champ de référence.
2. Sélectionnez Configurer le dictionnaire dans la liste.
3. Sous Liens connexes, cliquez sur Vue avancée.
4. Dans le champ Attributs , ajoutez les attributs de saisie semi-automatique souhaités.
   Par exemple, ces attributs ajoutent le champ de département à la liste des appelants et trient les appelants en fonction de leur département :

   ref_auto_completer=AJAXTableCompleter,ref_ac_columns=department,ref_ac_order_by=department,ref_ac_columns_search=true 

5. Cliquez sur Mettre à jour.

Exemple

L’exemple suivant décrit comment définir le champ Configuration Item (Élément de configuration ) pour afficher les noms de classes CI à partir des choix de saisie semi-automatique pour la table Configuration item (Élément de configuration) [cmdb_ci].

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

Remarque :

L’attribut ref_contributions contrôle les icônes qui apparaissent en regard du champ de référence.

Activer contient les recherches de saisie semi-automatique

Par défaut, la saisie semi-automatique de référence utilise un démarrage par recherche. Vous pouvez créer une préférence utilisateur pour implémenter une recherche contains .

Avant de commencer

Rôle requis : admin

Procédure

1. Désactivez la propriété système glide.ui.ref_ac.startswith .
   Pour plus d'informations, consultez Améliorer les requêtes de saisie semi-automatique.

   Remarque :

   Définir la glide.ui.ref_ac.startswith propriété système sur vrai remplace tous les paramètres « autocomplete.contains » existants dans les préférences utilisateur et système. Cette propriété modifie la méthode de requête de saisie semi-automatique pour tous les utilisateurs, quelles que soient leurs préférences.
2. Accédez à la Administration utilisateurs > Préférences utilisateur.
3. Sélectionnez la préférence « '<table référencée>.autocomplete.contains'.
4. Définissez le champ de valeur sur true.
5. Sélectionnez Mettre à jour.

Que faire ensuite

Déconnectez-vous puis reconnectez-vous pour afficher la recherche mise à jour.

Caractères génériques dans les références Saisie semi-automatique

Les recherches par caractères génériques utilisent la fonctionnalité de saisie semi-automatique.

Utilisez un astérisque dans le champ de référence pour les recherches par caractères génériques.

Si deux astérisques sont entrés, une liste des enregistrements disponibles s’affiche dans les suggestions de saisie semi-automatique.