Créer une transformation dans Service Bridge

En tant que fournisseur ou consommateur, créez un transformateur pour Service Bridge intégrer des tâches entre les instances connectées.

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Les étapes suivantes décrivent le processus de transformation pour les fournisseurs. Les consommateurs peuvent accéder à Tous > Consommateur de Service Bridge > Transformations et suivez le même processus.

Procédure

1. Accédez à la Tous > Fournisseur de Service Bridge > Administration > Transformations.
2. Cliquez sur Nouveau.
3. Renseignez les champs du formulaire.

   Tableau 1. Formulaire de transformation

   Champ	Description
   Numéro	Numéro généré automatiquement pour l’enregistrement de transformation.
   Société	Nom du consommateur pour lequel cette transformation est applicable.
   Toutes les sociétés	Si cette option est sélectionnée, la transformation s’exécute pour toutes les sociétés, à l’exception de celles ayant la même transformation au niveau de l’entreprise. Utilisez ce champ pour créer une définition de transformation par défaut qui peut être appliquée à toutes les sociétés. Le champ Toutes les sociétés élimine la nécessité de définir une transformation spécifique pour chaque compte client, même lorsque leurs besoins sont similaires. Vous pouvez utiliser la définition par défaut pour transformer des champs spécifiques dans toutes les sociétés simultanément. La transformation globale n’est appliquée qu’aux sociétés qui correspondent à la configuration et qui n’ont pas de transformation spécifique déjà définie. Si une transformation spécifique à la société pour la même configuration existe déjà, elle remplacera la transformation globale.
   Type	Simple : utilisé lorsque le champ dispose d’une liste de choix connue et stable sur chaque instance. Une liste connexe de lignes de transformation est créée pour correspondre aux valeurs entrantes et sortantes. Avancé : utilisé pour les critères complexes qui nécessitent un script pour déterminer la nouvelle valeur. Entrant virtuel : permet de transformer un champ entrant virtuel. Nécessite un script pour déterminer la nouvelle valeur. Sortant virtuel : permet de transformer un champ sortant virtuel. Nécessite un script pour déterminer la nouvelle valeur.
   Entrant	Option qui active une transformation entrante pour cette transformation.
   Sortant	Option qui active une transformation sortante pour cette transformation.
   Table du fournisseur	Option qui désigne la table de tâches du fournisseur. Par exemple, Ticket.
   Champ du fournisseur	Option qui désigne le champ du fournisseur. Par exemple, État.
   Table consommateur	Option qui désigne la table Tâche du consommateur. Par exemple, Incident.
   Champ consommateur	Option qui désigne le champ du consommateur. Par exemple, État.
   Champ entrant	Lorsque le champ Type est défini sur Entrant virtuel, ce champ est disponible pour référencer le champ virtuel que cette transformation doit renseigner.
   Champ sortant	Lorsque le champ Type est défini sur Sortant virtuel, ce champ est disponible pour référencer le champ virtuel que cette transformation doit renseigner.

4. Cliquez sur Enregistrer.
5. Sélectionnez l'une des options suivantes :
   1. Simple: Cliquez sur Nouveau dans la liste connexe Lignes de transformation et renseignez les champs du formulaire.

      Tableau 2. Formulaire Lignes de transformation

      Champ	Description
      Étiquette du fournisseur	Option qui désigne l’étiquette de choix du fournisseur. Par exemple, Ouvrir.
      Valeur du fournisseur	Option qui désigne la valeur de choix du fournisseur. Par exemple, 10.
      Étiquette client	Option qui désigne l’étiquette de choix du client. Par exemple, Progression.
      Valeur du client	Option qui désigne la valeur de choix du client. Par exemple, 2.

   2. Avancé : utilisez un script pour définir les étiquettes et les valeurs sortantes et entrantes, comme illustré dans l’exemple suivant :

      output.value=input.value;
      output.label=input.label;
      
      var ci=new GlideRecord('cmdb_ci');
      
      if(direction=='inbound'){
         if(ci.get('correlation_id',input.value)){
            output.value=ci.sys_id+";
            output.label=ci.getDisplayValue();
            }
      }
      if (direction=='outbound'){
        if(ci.get(input.value)){
           if(ci.correlation_id){
              output.value=ci.correlation_id+";
              output.label=input.label;
             }
          }
      }
            
      

   3. Entrant virtuel : utilisez un script pour déterminer l’étiquette et la valeur entrantes, comme illustré dans l’exemple suivant :

      var inputArr = input.value.split(',');
      var outputValues = [];
      var outputLabels = [];
      for (i in inputArr) {
          getInstanceID(inputArr[i]);
      }
      output.value = outputValues+'';
      output.label = outputLabels+'';
      
      function getInstanceID(name) {
          var gr = new GlideRecord('cmdb_ci_server');
          if (gr.get('name', name)) {
              outputValues.push(gr.sys_id+'');
              outputLabels.push(name);
          }
      }

   4. Sortant virtuel : utilisez un script pour déterminer l’étiquette et la valeur sortantes, comme illustré dans l’exemple suivant :

      /*
       ** The 'input' object contains the original value and label
       ** 'direction' contains an 'inbound' or 'outbound' value to determine transform direction
       ** 'object_data' contains the Remote Task GlideRecord
       ** It is required to set the variables 'output.value' and 'output.label' with your script.
       */
      output.value = 'condev,conprod';
      output.label = 'condev,conprod';

6. Cliquez sur Envoyer.
7. Sur le formulaire de transformation, cliquez sur Activer.

Résultats

Un enregistrement de transformation est créé sur votre ServiceNow® instance. Les champs entrants ou sortants de toute tâche distante correspondant à une transformation les utiliseront automatiquement. Pour en savoir plus, consultez Créer des définitions de tâches distantes dans Service Bridge pour les fournisseurs.