StaticMethods : global

Les méthodes statiques sont des méthodes que vous pouvez utiliser dans vos JavaScripts côté serveur, mais qui ne font partie d’aucune classe ou API.

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

Méthode statique : updateVirtualField(GlideRecord remoteTaskGr, String virtualField, String virtualValue, String virtualDisplayValue)

Remplit les champs virtuels dans une table de tâches sur une instance cible lors de l’utilisation Service Bridge de tâches distantes.

Un champ virtuel est un champ qui existe dans une table de tâches cible, mais qui n’existe pas dans la table de tâches source. Cette méthode permet de transmettre les valeurs d’un champ virtuel de l’instance source à l’instance cible. Cette méthode stocke les valeurs spécifiées pour le champ virtuel au format JSON dans la section de formulaire de la tâche distante spécifiée. Cette tâche distante est ensuite synchronisée avec l’instance cible où les valeurs sont stockées dans le champ mappé de la table de tâches cible.

Les champs virtuels sont définis dans les définitions de tâches distantes. Les définitions de tâches distantes contiennent des tables de mappage entrantes et sortantes qui mappent les champs entre les tables de tâches dans les instances source et cible. Lorsqu’une table source ne contient pas de champ qui existe sur une table cible, le champ est configuré dans la définition de tâche distante en tant que champ virtuel. Le consommateur peut ensuite utiliser Service Bridge les transformations ou cette méthode pour mettre à jour les valeurs de ces champs virtuels dans l’enregistrement de tâche cible associé.

La section suivante décrit un exemple de cas d’utilisation sur la façon d’implémenter des champs virtuels, puis d’utiliser la méthode updateVirtualField() pour renseigner les valeurs dans le champ virtuel. Dans cet exemple, les deux tables de tâches liées par une définition de tâche distante sont la table Ticket du fournisseur et la table Incident du consommateur. Lorsqu’un enregistrement d’incident est créé ou mis à jour sur l’instance de consommateur, il est configuré pour être synchronisé avec la table Ticket du fournisseur. Le champ Instances affectées de la table Ticket est un champ obligatoire mais n’existe pas dans la table Incident. Pour gérer cette situation, le champ Instances affectées doit être défini comme un champ virtuel dans le mappage entrant de la définition de tâche distante associée.

1. Le fournisseur crée une définition de tâche distante pour la table Ticket du fournisseur et la table Incident du consommateur.
2. Dans l’onglet Champs entrants des liens connexes de la définition de tâche distante, le fournisseur mappe les champs entre la table Incident et la table Ticket.
   Lors de la définition du champ Instances affectées, le fournisseur coche la case Virtuel , puis sélectionne Instances affectées dans le champ Cible de l’onglet Mappage cible .

   Remarque :

   Lors de la définition d’un champ virtuel, aucun champ source n’est défini car il n’existe pas.
3. Le fournisseur publie ensuite la définition de tâche distante, qui est synchronisée avec l’instance du consommateur.
4. Le consommateur crée une tâche à distance pour la table Incident. Une charge utile JSON contenant toutes les valeurs des champs mappés, y compris les informations sur les champs virtuels, est incluse dans une section de formulaire de la tâche distante.
5. L’instance de consommateur appelle la méthode updateVirtualField(), par exemple dans une règle métier qui s’exécute lorsque les enregistrements de la table Incident sont mis à jour, pour définir les valeurs du champ Instances affectées dans la tâche distante.
   Remarque :

   Même si vous pouvez renseigner les données de la table cible à tout moment, les champs requis configurés en tant que champs virtuels doivent être renseignés dans la tâche distante avant que celle-ci ne soit envoyée à l’instance du producteur.
6. La tâche distante est synchronisée avec l’instance du fournisseur et crée un enregistrement de ticket sur l’instance du fournisseur.

Pour en savoir plus sur la création d’une définition de tâche distante, reportez-vous à la section Create remote task definitions in Service Exchange for Providers.

Pour en savoir plus sur la création d’une Service Bridge transformation, reportez-vous à la section Transform data with the Service Exchange transform framework.

Tableau 1. Paramètres

Nom	Type	Description
remoteTaskGr	GlideRecord	Objet GlideRecord de la tâche distante pour laquelle définir les valeurs de champ virtuel spécifiées.
Champ virtuel	Chaîne	Nom du champ virtuel pour lequel mettre à jour les informations associées. Défini dans l’onglet connexe Champs sortants de la définition de tâche distante associée.
valeur virtuelle	Chaîne	Valeur à définir pour ce champ sur l’instance cible.
virtualDisplayValue	Chaîne	Valeur d’affichage à définir pour ce champ sur l’instance cible

Tableau 2. Renvoie

Type	Description
Néant

L’exemple suivant montre comment appeler cette méthode.

var remoteTaskGr = new GlideRecord("");
/** Remote Task table name,
** Table name vary based on which instance the script is being executed.
**/

remoteTaskGr.get(""); // Remote Task record sys_id

global.sb.updateVirtualField(remoteTaskGr,"<virtual outbound field name>", "<value to set on target field>", "<display value to set on target field>");