Méthodes clients autonomes

Les méthodes client autonomes sont des méthodes que vous pouvez utiliser dans vos JavaScripts clients, telles que reflistOpen, mais qui ne font partie d’aucune classe ou API.

Vous pouvez accéder directement à ces méthodes dans un script client sans constructeur ni autre type d’instanciation avant utilisation.

Autonome : reflistOpen (Chaîne cible, Chaîne elementName, Chaîne refTableName, Chaîne dépendante, Chaîne useQBE, Chaîne refQualElements, Chaîne additionalQual, Chaîne parentID, Chaîne forceReference, Chaîne ignoreTargetValue)

Affiche les données du champ de référence dans une fenêtre contextuelle standard. Cette méthode est couramment utilisée lors de la sélection d’une icône de loupe, à côté de n’importe quel champ de référence, dans les formulaires de l’interface utilisateur 16.

Par exemple, à l’aide de cette méthode, vous pouvez afficher les données de champ de référence pour un ensemble spécifique de critères de requête :

De même, vous pouvez utiliser cette méthode pour afficher un formulaire de recherche qui permet à l’utilisateur d’entrer son propre ensemble de critères de requête pour sélectionner les données du champ de référence à afficher.

Lors de l’ouverture de l’URL dans la fenêtre contextuelle standard, si la longueur de l’URL est supérieure à la longueur de TinyURL, 1024 par défaut, l’URL est convertie en TinyURL, par exemple :

« sys_user_list.do ?sysparm_tiny=7ea02c4ff8a8b510f877c74d78b60460 ».

Remarque :

reflistOpen() n’est pas pris en charge dans Workspace Client Script. Utilisez plutôt la méthode g_modal.showFrame().

Tableau 1. Paramètres

Nom	Type	Description
target	Chaîne	ID du champ de référence cible du formulaire. Par exemple, l’ID de champ de référence cible du paramètre caller_id est incident.caller_id.
elementName	Chaîne	Nom de l’élément de champ de référence du formulaire. Par exemple : caller_id
refTableName	Chaîne	Table de référence à mapper au champ de référence du formulaire. Par exemple, pour le champ de référence caller_id, sys_user est la table de référence. Dans ce cas, vous transmettrez la valeur sys_user.
dépendant	Chaîne	Champ dépendant configuré pour l’élément spécifié target . Pour en savoir plus, consultez Make a field dependent.
useQBE	Chaîne	Marqueur qui indique le type d’informations à renvoyer dans la fenêtre contextuelle. Valeurs valides : true : affiche un formulaire de requête avec un bouton de recherche. faux : afficher les résultats de la requête. Valeur par défaut : false
refQualElements	Chaîne	Qualificatif de référence configuré pour l’élément spécifié target . La fonction ajoute les qualificatifs de référence spécifiés à l’URL et n’affiche que les résultats filtrés dans la fenêtre contextuelle. Si vous ne souhaitez pas inclure de qualificatif de référence, transmettez une chaîne vide. Pour plus d’informations sur les qualificatifs de référence, reportez-vous à la section Reference qualifiers.
additionalQual	Chaîne	Facultatif. Requête de qualificatif supplémentaire à utiliser pour filtrer les résultats qui s’affichent dans la fenêtre contextuelle. Par exemple, pour un champ de référence caller_id dans un incident, vous pouvez transmettre le sys_id de l’utilisateur sys_id=62826bf03710200044e0bfc8bcbe5df1. La fonction filtre la table Utilisateur [sys_user] et affiche les résultats filtrés dans la fenêtre contextuelle.
ID parent	Chaîne	Facultatif. Actuellement uniquement un paramètre interne, pas besoin de transmettre une valeur.
ForceReference	Chaîne	Facultatif. Actuellement uniquement un paramètre interne, pas besoin de transmettre une valeur.
ignoreTargetValue	Chaîne	Facultatif. Actuellement uniquement un paramètre interne, pas besoin de transmettre une valeur.

Tableau 2. Renvoie

Type	Description
Fenêtre contextuelle	Affiche les données du champ de référence renvoyées dans une fenêtre contextuelle standard.

L’exemple suivant montre comment appeler cette méthode pour afficher les données du champ Appelant dans la fenêtre contextuelle de la table Incident (première image ci-dessus).

function onChange(control, oldValue, newValue, isLoading, isTemplate) {
   if (isLoading || newValue === '') {
      return;
   }

   reflistOpen('incident.caller_id', 'caller_id', 'sys_user','company', 'false', '');
}

L’exemple suivant montre comment appeler ce même script client, mais avec useQBE = true, qui affiche un bouton de recherche et les critères de recherche associés dans la fenêtre contextuelle (deuxième image ci-dessus).

function onChange(control, oldValue, newValue, isLoading, isTemplate) {
   if (isLoading || newValue === '') {
      return;
   }

   //  Type appropriate comment here, and begin script below
   reflistOpen('incident.caller_id', 'caller_id', 'sys_user','company', 'true', '');
}