Étape Script

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 6 minutes de lecture

    • Ajoutez un JavaScript personnalisé à exécuter dans une action réutilisable. Bien que la plupart des actions et étapes de base correspondent à des cas d’utilisation courants, vous pouvez créer une étape de script pour exécuter un comportement qui n’est pas satisfait par les étapes de base.

    Rôles et disponibilité

    Disponible en tant qu’étape d’action Concepteur d'action . Les utilisateurs disposant du rôle action_designer peuvent créer une action personnalisée avec une ou plusieurs étapes d’action.
    Remarque :
    Hub d'intégration Voir Demande Hub d'intégration pour plus d’informations sur Hub d'intégration l’utilisation et les abonnements.

    Champs

    L’étape Script inclut des variables d’entrée et de sortie distinctes qui vous permettent de mapper les données JavaScript aux Concepteur de flux données. En définissant des variables d’entrée et de sortie dans l’étape, vous pouvez définir quelles Concepteur de flux données sont disponibles dans votre script, et quelles variables de script sont disponibles pour les autres étapes de votre action.

    Champ Description
    Exécution obligatoire
    L’environnement d’exécution requis pour prendre en charge le script. Les choix sont les suivants :
    • Instance : l’étape d’action exécute le script à partir de l’instance. Sélectionnez cette option lorsque le script a besoin d’accéder aux données d’API ServiceNow ou d’instance. Il s’agit de la valeur par défaut.
    • MID : l’étape d’action exécute le script à partir du MID Server. Sélectionnez cette option lorsque le script a besoin d’accéder aux fichiers de script et aux API du MID Server . Si vous sélectionnez cette option, le champ Sélectionner un MID Server using s’affiche .
    • Vanilla (JavaScript principal) : l’étape d’action exécute le script à partir de l’instance ou du MID Server. Sélectionnez cette option lorsque le script a uniquement besoin des API JavaScript de base et non de l’API ou des données d’instance ServiceNow .

    L’environnement d’exécution que vous sélectionnez détermine les objets et méthodes JavaScript affichés dans l’aide contextuelle.

    Remarque :
    Ce champ n’est visible que lorsqu’il Hub d'intégration est activé.
    Sélectionner un MID Server en utilisant
    Spécifiez le processus de sélection de Serveur MID à utiliser. Les choix sont les suivants :
    • N’importe quel MID. Le système exécute l’étape d’action à partir de n’importe quel MID Server disponible.
    • Utilisez un alias de connexion. Le système exécute l’action à l’aide de l’alias de connexion que vous spécifiez. Si vous sélectionnez cette option, le champ Alias de connexion s’affiche.
    • Utilisez la sélection en ligne. Le système exécute l’action à l’aide des détails de connexion que vous spécifiez dans l’action. La sélection de cette option affiche les champs Hôte, Application MID et Options .
    Remarque :
    Ce champ n’est visible que lorsqu’il est activé et que Hub d'intégration vous sélectionnez MID dans Exécution requise.
    Alias de connexion Enregistrement d’alias de connexion et d’informations d’identification que le système utilise pour exécuter l’étape d’action. Les utilisateurs disposant du rôle flow_designer ou administrateur peuvent créer ou sélectionner un enregistrement de connexion associé. L'utilisation d'un alias élimine la nécessité de configurer plusieurs informations d'identification et profils d'informations de connexion lors de l'utilisation d'une action dans plusieurs environnements. De même, si les informations de connexion changent, vous n’avez pas besoin de mettre à jour votre action personnalisée. Pour en savoir plus sur les connexions et les informations d’identification, consultez Informations d’identification, connexions et alias. Seuls les alias de type de connexion Basic sont pris en charge.
    Remarque :
    Ce champ n’est visible que lorsque est activé et que Hub d'intégration vous sélectionnez Utiliser des alias de connexion dans Sélectionner l’utilisation de MID Server Using (Sélectionner un MID Server Using).
    Hôte Nom de domaine complet du MID Server dans lequel le système exécute l’étape d’action. Par exemple, mid-server.domain.com.
    Remarque :
    Ce champ n’est visible que lorsqu’il est activé et que Hub d'intégration vous sélectionnez Utiliser la sélection en ligne dans Sélectionner l’utilisation de Serveur MID en utilisant.
    Sélection de MID Option permettant de sélectionner le MID Server ou la grappe MID spécifique.
    • Sélectionner automatiquement un MID Server : sélectionne automatiquement le MID Server.
    • MID Server spécifique : utilise le MID Server que vous sélectionnez.
    • Grappe MID spécifique : utilise la grappe MID que vous sélectionnez.
    Ce champ est disponible lorsque MID est sélectionné dans la liste Exécution requise et que l’option Utiliser la sélection en ligne est sélectionnée dans la liste Sélectionner un MID Server à l’aide de.
    Grappe MID Pastille de données pour la grappe MID que vous souhaitez utiliser. Ce champ est disponible lorsque MID est sélectionné dans la liste Exécution requise et que l’option Utiliser la sélection en ligne est sélectionnée dans la liste Sélectionner un MID Server à l’aide de.
    Application MID Spécifiez l’application que le MID Server doit prendre en charge pour être éligible à la sélection. Le système exécute l’étape d’action à partir d’un MID Server qui prend en charge l’application sélectionnée. Ce champ n’est visible que lorsque l’option est activée, que Hub d'intégrationl’option Sélectionner automatiquement Serveur MID est sélectionnée dans la liste Sélection MID et que vous sélectionnez Utiliser la sélection en ligne dans Sélectionner Serveur MID à l’aide de.
    Options Options que le doit prendre en charge pour être éligible à la Serveur MID sélection. Le système exécute l’étape d’action à partir d’un Serveur MID qui prend en charge les options sélectionnées. Ce champ n’est visible que lorsque l’option est activée, que Hub d'intégrationl’option Sélectionner automatiquement Serveur MID est sélectionnée dans la liste Sélection MID et que vous sélectionnez Utiliser la sélection en ligne dans Sélectionner Serveur MID à l’aide de.
    Serveur MID spécifique Pastille de données du fichier .Serveur MID Ce champ n’est visible que lorsqu’est Hub d'intégration activé, qu’un MID Server spécifique est sélectionné dans la liste Sélection MID et que vous sélectionnez Utiliser la sélection en ligne dans Sélectionner un MID Server à l’aide.
    Variables d'entrée Paires nom-valeur qui représentent les données de l’action, vous permettant d’utiliser les entrées d’action et les données provenant d’autres étapes d’un script.
    Script
    Script qui s’exécute au sein de l’action. Pour accéder aux variables d’entrée et de sortie de votre script, utilisez les entrées et sortiesdes objets globaux. Par exemple, inputs.myVariable.
    Remarque :
    Étape Script Les noms d’entrée et de sortie ne peuvent inclure aucun des noms de système réservés suivants :
    • sys_id
    • sys_created_by
    • sys_created_on
    • sys_updated_on
    • sys_updated_by
    • sys_mod_count
    L’étape Script convertit toujours les données stockées dans les objets globaux d’entrée et de sortie en chaînes. Si votre étape Script doit travailler avec des données JSON, vous pouvez utiliser l’objet global inputs pour convertir les données JSON en une chaîne. Vous pouvez également définir une variable JavaScript en tant que chaîne plutôt qu’en tant qu’objet JavaScript. Par exemple, ce script illustre deux façons de générer des données JSON.
    (function execute()inputs, outputs) {
  outputs.json_object_1 = inputs.json_input;
  var array_of_objs = '[{"name1":"value1"}, {"id":"abcd"}]';
  outputs.json_object_2 = array_of_objs;
})(inputs, outputs);

    Par défaut, Concepteur de flux exécutez des scripts sur l’instance. Pour exécuter un script à partir d’un MID Server, vous devez disposer d’un Hub d'intégration abonnement.

    Concepteur de flux Exécute le script à partir du domaine à partir duquel il est déclenché ou initié. Consultez Séparation de domaine et Concepteur de flux.

    Pour connaître les classes et méthodes disponibles, reportez-vous à l’aide contextuelle de JavaScript API ou à la API referencesection .
    Variables de sortie Mappez la sortie JavaScript aux pastilles de Concepteur de flux données. Définir des variables de sortie lorsque vous voulez que d’autres étapes de l’action utilisent la sortie d’un script.

    Champs d’évaluation des erreurs d’action

    Champ Description
    En cas d'échec de cette étape Option permettant de continuer à exécuter l’étape suivante ou d’accéder à l’évaluation des erreurs. Pour utiliser le code d’état ou le message de l’étape pour une condition d’erreur d’action personnalisée, reportez-vous à Évaluation de l’erreur d’action.

    Exemple

    Cet exemple génère une charge utile JSON qui peut être facilement mise à jour ou modifiée et ajoutée à une étape REST ultérieure.

    Remarque :
    Étape REST n’est pas disponible dans le système de base et requiert l’abonnement ServiceNow® Hub d'intégration .

    Exemple d’étape de script dans une action.

    En créant une variable de sortie qui représente la charge utile, vous pouvez faire glisser la pastille de données [Charge utile] dans le champ Corps de l’étape REST.