Étape Script
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é
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 :
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 :
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.
|
| 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 :
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.
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.
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.