StandaloneClientMethods

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

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

Autonome : reflistOpen (cible de chaîne, String elementName, String refTableName, String dependent, String useQBE, String refQualElements, String additionalQual, String parentID, String forceReference, String 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é d’un champ de référence, dans les formulaires de l’interface utilisateur 16.

Par exemple, cette méthode vous permet d’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 de saisir son propre ensemble de critères de requête pour sélectionner les données de 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 le script client Workspace. 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 de la cible du formulaire. Par exemple, l’ID de champ de référence cible du paramètre caller_id est incident.caller_id.
elementName (en anglais seulement)	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 indiquant le type d’informations à renvoyer dans la fenêtre contextuelle. Valeurs valides : vrai : affiche un formulaire de requête avec un bouton de recherche. faux : affiche 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 affiche uniquement 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 la 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 passer une valeur.
forceReference (en anglais seulement)	Chaîne	Facultatif. Actuellement uniquement un paramètre interne, pas besoin de passer une valeur.
ignoreTargetValue	Chaîne	Facultatif. Actuellement uniquement un paramètre interne, pas besoin de passer une valeur.

Tableau 2. Renvoie

Type	Description
Fenêtre contextuelle	Affiche les données de 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 de l’appelant dans la fenêtre contextuelle de la table d’incidents (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', '');
}