Étapes d’intégration
Activez les actions personnalisées à intégrer dans les systèmes externes en activant Hub d'intégration, ce qui ajoute des étapes d'intégration à l'interface Studio de workflow.
Les étapes qui exécutent des opérations sur les données d’enregistrement s’exécutent sur l’instance, tandis que les étapes qui s’intègrent aux systèmes de votre réseau s’exécutent sur un Serveur MID. Si une étape nécessite un Serveur MID pour s’exécuter, l’instance délègue le traitement du flux à l’instance appropriée Serveur MID en envoyant le plan de processus dans un appel REST. Le Serveur MID exécute l’action ou l’étape dans le plan de processus et renvoie les résultats. Affichez les messages du journal et l’état d’exécution à partir de l’instance ou du Serveur MIDfichier .
Étapes d’intégration disponibles
Ces étapes d’intégration sont disponibles à partir de Studio de workflow - Création d’actions personnalisées.
| Étape d’intégration | Description | L’étape s’exécute à partir de |
|---|---|---|
| Étape JDBC | Créez une action réutilisable pour envoyer des commandes SQL à une base de données relationnelle. | Serveur MID |
| Étape du générateur JSON | Créez une charge utile JSON à utiliser dans une autre étape. Saisissez des valeurs ou utilisez des pastilles de données pour produire une charge utile dynamique. Cette étape prend en charge plusieurs types de données, y compris les objets et les tableaux pour les structures imbriquées. | Instance |
| Étape du générateur de charge utile | Activez les designers d'actions pour créer facilement des paires nom-valeur dans les charges utiles JSON et XML à l'aide de données dynamiques. |
|
| Étape PowerShell | Exécutez des scripts PowerShell sur des ordinateurs distants à partir de votre instance ServiceNow via un Serveur MID. | Serveur MID |
| Étape REST | Envoyez une demande de service Web REST sortante à un système externe. |
|
| Étape SOAP | Activez les designers d'actions pour envoyer des demandes de service Web SOAP sortantes à des systèmes externes. |
|
| Étape SSH | L'étape SSH exécute des commandes SSH sur un système *nix externe via un ServiceNow® Serveur MID. L'étape stocke également des scripts et des commandes pour les systèmes *nix. | Serveur MID |
| Étape de l’analyseur XML | Identifiez les données structurées d'une charge utile XML sans avoir à écrire de script. Mappez les éléments XML entrants à une sortie d'objet complexe que vous pouvez utiliser dans d'autres étapes ou actions. Lors de l'exécution, les valeurs d'une charge utile XML renseignent la sortie d'objet complexe. |
|
Formation
Suivez une formation étape par étape sur l’utilisation de l’étape REST dans la formation des développeurs REST dans Centre d’intégration.
Attributs de connexion
Définissez des variables spécifiques à la connexion que vous pouvez utiliser dans les étapes d'intégration Hub d'intégration. Lorsque vous utilisez une étape d'intégration, vous devez établir une connexion avec un système externe. Utilisez un alias de connexion et d'informations d'identification au lieu de définir l'inline de la connexion. Un alias vous permet de mettre à jour les détails de la connexion une seule fois, sans avoir à reconfigurer chaque action. Toute étape d'action qui utilise un alias hérite des attributs qui lui sont associés. Studio de workflow affiche les attributs en tant que pastilles de données que vous pouvez faire glisser dans votre étape d'action. Par exemple, vous pouvez créer un attribut de taille de page qui devient un paramètre de requête d'étape REST. Pour plus d’informations sur les attributs de connexion, consultez Créer des attributs de connexion pour Centre d’intégration.
Serveur MID Alias de connexion
Les concepteurs d’actions peuvent définir des Serveur MID attributs de sélection à l’aide d’un enregistrement de connexion associé à un alias et associer l’alias à une étape d’intégration. Lorsque le flux s’exécute, le système utilise les attributs pour déterminer qui Serveur MID exécute l’étape. En savoir plus sur Présentation des informations d’identification, connexions et alias.
Serveur MID et sélection de grappe MID
Pour la plupart des étapes d’intégration, vous pouvez spécifier un Serveur MID ou une grappe MID à utiliser lors de l’exécution. Pour un Serveur MID, vous pouvez en sélectionner un que vous avez configuré ou demander au système d’en choisir un en sélectionnant Sélectionner automatiquement Serveur MID dans la liste Sélection MID de l’étape. Pour en savoir plus sur la façon dont un est sélectionné pendant l’exécution, reportez-vous à la section Sélection d’unServeur MID serveur MID. Pour les grappes MID, vous pouvez sélectionner une grappe d’équilibrage de charge ou de basculement pour l’étape. Pour plus d’informations sur les grappes MID, consultez Configurer une grappe de Serveur MID. L’étape du générateur de charge utile et l’étape de l’analyseur XML ne prennent pas en charge la sélection du serveur MID.
Lors de la spécification d’un Serveur MID, les concepteurs de flux doivent éviter de déplacer l’environnement d’exécution de l’un à l’autre lors de l’exécution d’un Serveur MID flux. Configurez chacun d’eux Serveur MID pour effectuer des opérations sur plusieurs points de terminaison ou fournissez plusieurs options à chacun Serveur MID de votre réseau. Vous pouvez avoir besoin d’un utilisateur disposant du rôle connection_admin pour mettre à jour les enregistrements de connexion associés à une action, ou d’un administrateur réseau pour mettre à jour la Serveur MID configuration réseau.
Considérations relatives à la conception
Concevez les étapes d’intégration à l’aide des directives suivantes.
- Évitez de déplacer l’environnement d’exécution entre l’instance et plusieurs Serveur MID fois. Dans la mesure du possible, regroupez les étapes d’action similaires. Par exemple, regroupez les étapes principales qui effectuent des opérations d’enregistrement et les étapes d’intégration qui s’exécutent sur le Serveur MID.
- Lors de la création d'un spoke utilisant une étape d'intégration, incluez un enregistrement d'alias de connexion et d'informations d'identification avec le type de connexion approprié. Avant que tout le monde puisse utiliser le spoke, un utilisateur disposant du rôle connection_admin doit associer l'enregistrement d'alias à un enregistrement de connexion prenant en charge ce type de connexion. Si la définition de la connexion est en ligne, utilisez des entrées pour permettre à l'analyste du processus de définir les informations de connexion lors de l'ajout de l'action à un flux.
- Le Serveur MID n'a pas accès à toutes les valeurs d'un objet GlideRecord, il n'a accès qu'à la référence sys_id. Les entrées de type référence ne fonctionnent pas sur un Serveur MID. Créez plutôt des entrées d'action contenant les valeurs GlideRecord nécessaires.
Rôles
Pour créer des étapes d’intégration, un utilisateur doit avoir les rôles action_designer ou admin. En cas d’exécution d’étapes sur un Serveur MID, l’utilisateur Serveur MID doit disposer des rôles connection_admin et credential_admin pour accéder aux informations de connexion et d’informations d’identification associées à l’étape.