Scripts alignés

Permettez aux utilisateurs ayant de l’expérience en codage d’écrire des scripts en ligne qui définissent et modifient les valeurs d’entrée pendant la configuration d’une action ou d’un flux. Utilisez les scripts en ligne pour modifier les valeurs d’entrée qui nécessitent des conversions de petits formats, des transformations de données ou des opérations mathématiques.

Vous pouvez également modifier les valeurs d’entrée sans scripting à l’aide des fonctions de transformation. Pour obtenir la liste des options disponibles, reportez-vous à la section Fonctions de transformation.

Studio de workflow affiche un bouton Script lorsque vous configurez ces composants.

• Entrées d’action lorsque vous configurez l’action pour un flux
• Sorties d’action lorsque vous configurez l’action pour un flux
• Entrées de logique de flux lorsque vous configurez la logique de flux pour un flux
• Sorties de logique de flux lorsque vous configurez la logique de flux d’un flux
• Entrées d’étapes lorsque vous configurez l’étape d’une action.
• Entrées de flux secondaire lorsque vous configurez le flux secondaire d’un flux.
• Sorties de flux secondaire lorsque vous configurez le flux secondaire d’un flux.

Les scripts en ligne doivent renvoyer des valeurs du même type de données que les attentes de l’entrée. Par exemple, un script en ligne pour une entrée d’enregistrement doit renvoyer un objet GlideRecord et un script en ligne pour une entrée Date doit renvoyer une valeur date-heure. Testez toujours les actions et les flux contenant des scripts en ligne, et vérifiez qu’il n’y a pas d’erreurs d’exécution dans les détails d’exécution du flux.

Les scénaristes doivent être familiers avec Now Platform les structures de table et les types de champs. En outre, ils doivent savoir comment travailler avec les données d’enregistrement et système à l’aide de l’API ServiceNow .

Avantages

Les scripts en ligne offrent ces avantages.

• Activez la conversion ou la transformation de données simple sans avoir à créer d’actions ou de flux personnalisés.
• Identifiez les données d’entrée qu’un script affecte.
• Accès restreint aux fonctionnalités de scripting pour les utilisateurs ou les groupes connaissant bien les API disponibles ServiceNow .

Accès au script Inline

Vous pouvez accorder aux utilisateurs l’accès aux scripts en ligne en leur accordant le rôle flow_designer_scripting ou l’autorisation de développement délégué Autoriser les scripts . Le rôle et l’autorisation de développeur affichent tous deux un champ de bouton de script pour chaque Studio de workflow entrée.

Bouton Script

Lorsque vous permettez à un utilisateur de créer des scripts en ligne, Studio de workflow un bouton de script s’affiche en regard des entrées de flux et d’étape.

Figure 1. Les boutons de script s’affichent à côté des entrées

Cliquez sur le bouton Script pour ouvrir l’éditeur de script, qui remplace l’interface d’entrée standard. Entrez un script pour calculer la valeur d’entrée.

Assurez-vous que votre script inclut une instruction de retour avec les résultats de votre script. Par exemple, return shortDesc ; renvoie la valeur de la variable shortDesc .

Figure 2. Éditeur de script pour l’entrée

Cliquez sur le bouton Réduire le script pour masquer l’éditeur de script et afficher une version en lecture seule de l’entrée. Cliquez sur le bouton Développer le script pour afficher l’éditeur de script et vous permettre de modifier le script.

Figure 3. Entrée contenant le script

Studio de workflow objet de données

Les scénaristes peuvent utiliser l’objet fd_data pour accéder aux données des actions et étapes précédentes. Utilisez l’objet fd_data pour remonter pas à pas vers une sortie spécifique du flux. Vous pouvez utiliser les suggestions de suggestion automatique de l’éditeur de script pour sélectionner une valeur de sortie spécifique. Par exemple, saisissez fd_data et sélectionnez _2__for_each.item dans les suggestions de suggestion automatique pour créer une référence de remontée pas à pas vers fd_data._2__for_each.item. Cette référence accède aux données de la deuxième sortie du flux, qui dans cet exemple est un élément de logique de flux For Each.

Important :

L’objet fd_data nécessite toujours une référence de remontée pas à pas vers une sortie de flux spécifique. Sans référence de remontée pas à pas, le script en ligne ne peut pas accéder aux Studio de workflow données.

Studio de workflow Met à jour l’objet de données chaque fois que vous enregistrez votre action, votre flux ou votre flux secondaire. Si les suggestions de suggestion automatique n’incluent pas votre cible, essayez d’enregistrer l’action, le flux ou le flux secondaire, puis de saisir à nouveau le point pour actualiser la liste des suggestions.

Tableau 1. Options de l’objet de données de Concepteur de flux

Cible de données	Syntaxe de référence	Exemple
Entrée d'action	fd_data.action_inputs.nom d’entrée d’action	var tâche = fd_data.action_inputs.task ;
Variable de flux	fd_data.flow_var.nom_variable_flux	var shortDesc = fd_data.flow_var.short_description ;
Sortie de l’action, de la logique de flux ou de l’étape précédente	fd_data._output-target-step-number__output-target-name	var taskRecord = fd_data._2__create_task ;
Entrée de flux secondaire	fd_data.subflow_inputs.nom d’entrée de flux secondaire	var reqItem = fd_data.subflow_inputs.requested_item ;
Déclencheur	fd_data.déclencheur.pilule de données déclencheur	var incident = fd_data.trigger.current ;

Directives générales

Suivez ces instructions générales pour créer des scripts en ligne réutilisables et maintenables.

Écrire un script en ligne pour une petite logique non réutilisable

Utilisez le format de script en ligne ou modifiez les données pour des entrées et des cas d’utilisation spécifiques. Pour les conversions de données d’entrée standard et réutilisables et les opérations de formatage, sélectionnez plutôt une fonction de transformation.

Examiner les fonctions de transformation disponibles

Studio de workflow Fournit une liste de fonctions de transformation standard pour les conversions de données et les opérations de formatage. Plutôt que d’écrire et de gérer une solution de script personnalisée, sélectionnez une fonction de transformation existante le cas échéant.

Includes de script d’appel à partir du script en ligne

Appelez un include de script à partir de votre script en ligne pour réduire la quantité de code que vous écrivez et également pour maintenir le code commun dans un emplacement unique. Utilisez le constructeur de classe pour appeler votre include de script. Pour en savoir plus sur la création d’un include de script, reportez-vous à la section Script includes.

var si = new MyScriptInclude();
si.functionOne();

Créer des actions ou des flux secondaires personnalisés pour le code réutilisable plutôt que pour le script en ligne

Créez des actions ou des flux secondaires personnalisés pour une logique de données réutilisables ou complexes, telles que la modification du type de données source. Vous pouvez également fournir des actions ou des flux secondaires personnalisés pour les concepteurs de flux qui ne sont pas à l’aise avec le code.

Éviter de dupliquer l’action et la fonctionnalité de flux

Évitez d’écrire un script en ligne qui duplique les fonctionnalités d’action et de flux. Par exemple, plutôt que d’écrire un script en ligne pour effectuer des opérations d’enregistrement, utilisez les actions de base de référence Créer et mettre à jour un enregistrement.

Éviter les changements de type de données

Évitez les erreurs d’exécution en vérifiant que votre script en ligne fournit des informations dans le même type de données que celui attendu par l’entrée ou la sortie.

Créer des variables en les déclarant avec le mot clé var

Utilisez le mot-clé var pour déclarer des variables afin qu’elles restent dans la portée JavaScript appropriée. Lorsque vous créez une variable en lui attribuant une valeur, JavaScript peut l’attacher à l’objet global, ce qui peut entraîner la persistance des valeurs de variable en dehors de la portée locale et provoquer des erreurs.

Traiter les sorties d’enregistrements avec la logique de flux For Each et l’objet de données de flux

Le script aligné ne peut accéder qu’à la sortie d’enregistrements d’une action Rechercher des enregistrements à partir de la logique de flux Pour chaque. Ajoutez une action de recherche d’enregistrements au flux pour générer la sortie d’enregistrements. Ajoutez une logique de flux For Each au flux pour traiter chaque enregistrement dans la sortie d’enregistrements. Créez une référence de script en ligne à la logique de flux For Each à l’aide des objets fd_data et item. Par exemple, cette référence suppose que la logique de flux Pour chaque est le deuxième élément de votre plan de flux fd_data._2__for_each.item.

Utilisez les suggestions de suggestion automatique pour générer des références aux données de flux et d’action.

Créez des références aux données de flux et d’action à l’aide de l’objet fd_data. L’éditeur de script affiche des suggestions de suggestion automatique pour les données de flux et d’action existantes lorsque vous tapez fd_data. Sélectionnez une suggestion pour créer des références aux données de flux et d’action.

Remarque :

Reportez-vous aux données d’enregistrement dans une logique de flux For Each à l’aide de l’objet item .

Compteurs de boucles de champ d’application

Les boucles de script n’ont pas un nombre maximum d’itérations, de sorte que les boucles s’exécutent à l’infini lorsqu’il n’y a pas de condition de sortie valide.

Pour vous assurer qu’il existe une condition de sortie valide, utilisez des compteurs de boucle de champ d’application dans les scripts en ligne ou dans les étapes de script au sein d’une action. Ajouter var àfor (i=0 ; i< length ; i++) et obtenir for (var i=0 ; i< length ; i++)

Considérations relatives à la gestion des licences

Les scripts Inline qui appellent des API d’intégration sont soumis à Hub d'intégration une gestion des licences.

Éditeur de code

L’éditeur de code fournit une prise en charge de l’éditeur de texte pour les scripts en ligne.

L’éditeur de code dispose des fonctionnalités suivantes pour les services linguistiques et les scripts Inline pris en charge.

• Coloration de la syntaxe, indentation, numéros de ligne et création automatique d’accolades fermantes et de guillemets
• Auto-suggestions et auto-complétions

Figure 4. Éditeur de code

Conseils d’édition

• Pour insérer un espace fixe n’importe où dans votre code, appuyez sur la touche de tabulation.
• Pour mettre en retrait une seule ligne de code, cliquez sur l’espace vide au début de la ligne, puis appuyez sur la touche de tabulation.
• Pour mettre en retrait une ou plusieurs lignes de code, sélectionnez le code, puis appuyez sur la touche de tabulation. Pour réduire l’indentation, appuyez sur Maj+Tab.
• Pour supprimer un onglet du début d’une ligne de code, cliquez sur la ligne et appuyez sur Maj+Tab.
• Pour déclarer des variables, utilisez le mot-clé var afin qu’elles restent dans la portée JavaScript appropriée.