Étape Script

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 6 minutes de lecture
  • Ajoutez du JavaScript personnalisé à exécuter dans une action réutilisable. Bien que la plupart des actions et étapes de base correspondent aux cas d’utilisation courants, vous pouvez créer une étape de script pour exécuter un comportement insatisfait par les étapes de base.

    Rôles et disponibilité

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

    Champs

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

    Champ Description
    Exécution obligatoire
    Environnement d’exécution requis pour prendre en charge le script. Vous avez le choix entre :
    • 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 à l’API ou aux données d’instance ServiceNow . Il s’agit de la valeur par défaut.
    • MID : l’étape d’action exécute le script à partir du serveur MID. Sélectionnez cette option lorsque le script a besoin d’accéder aux fichiers de script et aux API de Serveur MID . Lorsque vous sélectionnez cette option, le champ Sélectionner un serveur MID à l’aide s’affiche .
    • Vanilla (JavaScript principal) : l’étape d’action exécute le script à partir de l’instance ou du serveur MID. 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 Centre d'intégration est activé.
    Sélectionner un serveur MID en utilisant
    Spécifiez le processus de sélection du serveur MID à utiliser. Vous avez le choix entre :
    • N’importe quel MID. Le système exécute l’étape d’action à partir de n’importe quel serveur MID disponible.
    • Utilisez un alias de connexion. Le système exécute l’action à l’aide de l’alias de connexion que vous spécifiez. Lorsque 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. Lorsque vous sélectionnez cette option, les champs Hôte, Application MID et Options s’affichent.
    Remarque :
    Ce champ n’est visible que lorsqu’il est activé et que Centre d'intégration vous sélectionnez MID à partir de 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 admin 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 lorsqu’il est activé et que Centre d'intégration vous sélectionnez Utiliser des alias de connexion dans Sélectionnerl’utilisation d’un serveur MID.
    Hôte Nom de domaine complet du serveur MID sur 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 Centre d'intégration vous sélectionnez Utiliser la sélection en ligne dans Sélectionner l’utilisation d’un serveur MID.
    Sélection de MID Option permettant de sélectionner un serveur MID ou une grappe MID spécifique. Choisissez l’une des options suivantes.
    • Sélection automatique d’un serveur MID : votre ServiceNow instance sélectionne l’sans Serveur MID entrée manuelle.
    • Serveur MID spécifique : votre ServiceNow instance utilise ce Serveur MID que vous spécifiez.
    • Grappe MID spécifique : votre ServiceNow instance utilise la grappe MID que vous spécifiez.

      Une grappe MID est un groupe de serveurs MID qui permet à votre ServiceNow instance de gérer plusieurs intégrations et d’améliorer la vitesse d’intégration. Pour plus d'informations, consultez Configure a MID Server cluster.

    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 l’utilisation du serveur MID.
    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 l’utilisation du serveur MID.
    Application MID Spécifiez l’application que le serveur MID doit prendre en charge pour être éligible à la sélection. Le système exécute l’étape d’action à partir d’un serveur MID qui prend en charge l’application sélectionnée. Ce champ n’est visible que lorsqu’il est activé, que l’option Centre d'intégrationSélectionner automatiquement un 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 un serveur MID à l’aide de.
    Options Les capacités doivent être prises en charge pour être éligibles à 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 lorsqu’il est activé, que l’option Centre d'intégrationSélectionner automatiquement un 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 un serveur MID à l’aide de.
    Serveur MID spécifique Pastille de données du requis Serveur MID. Ce champ n’est visible que lorsqu’il est activé, que le Centre d'intégrationserveur MID 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 l’utilisation d’un serveur MID.
    Variables d'entrée Paires nom-valeur qui représentent les données de l’action, ce qui vous permet d’utiliser des entrées d’action et des données d’autres étapes dans un script.
    Script
    Script qui s’exécute dans l’action. Pour accéder aux variables d’entrée et de sortie de votre script, utilisez les entrées et sorties des 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
    En général, ne créez pas une variable portant le même nom qu’un champ système. L’étape Script peut confondre une telle variable d’entrée avec un nom de champ et utiliser une valeur incorrecte.
    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 fonctionner avec des données JSON, vous pouvez utiliser l’objet global d’entrées pour convertir les données JSON en une chaîne. Vous pouvez également définir une variable JavaScript comme une chaîne plutôt que comme un 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, Studio de workflow exécutez des scripts sur l’instance. L’exécution d’un script à partir d’un serveur MID nécessite un Centre d'intégration abonnement.

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

    Pour connaître les classes et méthodes disponibles, reportez-vous à l’aide contextuelle de l’API JavaScript ou à la section .

    Variables de sortie Mapper la sortie JavaScript aux Studio de workflow pastilles de données. Définissez des variables de sortie lorsque vous souhaitez que d’autres étapes de l’action utilisent la sortie du script.

    Évaluation des erreurs d’action

    En cas d'échec de cette étape
    Type de données : Choice

    Option permettant de continuer à exécuter l’étape suivante ou d’accéder à l’évaluation des erreurs. Pour utiliser le code d’état d’étape ou le message pour une condition d’erreur d’action personnalisée, reportez-vous à la section Évaluation des erreurs 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 nécessite l’abonnement ServiceNow® Centre 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.