Créer des actions de spoke et de build en important une spécification OpenAPI
Automatisez une intégration et générez des actions réutilisables en important une spécification OpenAPI.
Avant de commencer
Rôle requis : admin
Procédure
- Accédez à la Tout > Automatisation des processus > Studio de workflow.
- Cliquer sur Créer > Spoke.
-
Sur l’écran Informations sur le spoke, indiquez si vous souhaitez créer le spoke dans un nouveau périmètre ou dans un périmètre existant.
-
Si vous choisissez de créer le spoke dans un nouveau périmètre, sélectionnez une image comme logo pour votre intégration et renseignez les champs.
Ici, nous allons passer par une intégration avec Zoom à titre d’exemple.
Champ Description Nom de spoke Nom permettant d’identifier le spoke personnalisé. Description Description du spoke personnalisé. Remarque :La valeur du nom du périmètre de l’application est au format suivant : x_<company-code>_<spoke-name>_<spoke>. Par défaut, le <company-code> est snc. Vous pouvez configurer le code société en configurant la valeur de la propriété système, glide.appcreator.company.code.
Cette valeur configurée est utilisée lorsque la valeur Nom du périmètre de l’application est générée.
-
Si vous choisissez de créer le spoke dans un périmètre existant, sélectionnez une image comme logo pour votre intégration et renseignez les champs.
Ici, nous allons passer par une intégration avec AWS à titre d’exemple.
Champ Description Nom d'application Un nom d’application ou un périmètre d’application existant. Nom du champ de l'application Nom du champ d’application renseigné automatiquement en fonction du nom d’application sélectionné. Description Description du spoke personnalisé.
-
Si vous choisissez de créer le spoke dans un nouveau périmètre, sélectionnez une image comme logo pour votre intégration et renseignez les champs.
-
Cliquez sur Continuer.
En fonction du nom et de la description fournis, s’il existe des spokes correspondants dans le Store, les détails du spoke sont affichés.
-
Cliquez sur Afficher les détails dans le magasin pour afficher les détails des spokes correspondants.
Les détails des spokes correspondants sont affichés dans un nouvel onglet de navigateur.
-
Installez le spoke à partir du Store.
Pour en savoir plus, consultez Install a ServiceNow Store application.
-
Après avoir installé le spoke, accédez à l’onglet Studio de workflow .
Le système affiche le message Avez-vous installé un spoke à partir du magasin ?
-
Sélectionnez l’une de ces options, puis cliquez sur Continuer.
Option Description Oui, afficher le spoke installé. Option permettant de rediriger vers le tableau de bord des spokes sous Intégrations. Non, je vais élaborer un spoke personnalisé. Option permettant de poursuivre la création de spoke. Non, je veux quitter la création de spoke. Option permettant de fermer l’onglet actif.
-
Cliquez sur Afficher les détails dans le magasin pour afficher les détails des spokes correspondants.
-
Cliquez sur Ignorer si vous souhaitez créer le spoke personnalisé.
Remarque :Les étapes suivantes s’appliquent également si vous avez sélectionné l’option Non, je créerai un spoke personnalisé.
Le spoke est créé et un message de confirmation s’affiche.
-
Sur l’écran Informations sur la build, sélectionnez la méthode à l’aide de laquelle vous souhaitez créer votre spoke.
Vous pouvez choisir de créer votre spoke à l’aide de la spécification OpenAPI ou de la collection Postman.
-
Sélectionnez Spécification OpenAPI et cliquez sur Continuer pour importer une spécification OpenAPI.
- Pour la source OpenAPI, cliquez sur Importer nouveau.
-
Sur l’écran Importer une nouvelle source OpenAPI, effectuez l’une de ces deux étapes.
-
Si vous souhaitez importer à l’aide d’une URL, sélectionnez Importer à partir d’une URL pour Méthode d’importation et spécifiez l’URL dans l’URL OpenAPI.
-
Si vous souhaitez importer manuellement à l’aide du code JSON ou YAML, sélectionnez Importer manuellement à partir de JSON ou YAML pour Méthode d’importation et fournissez le code au format JSON ou YAML.
-
Si vous souhaitez importer à l’aide d’une URL, sélectionnez Importer à partir d’une URL pour Méthode d’importation et spécifiez l’URL dans l’URL OpenAPI.
-
Cliquez sur Importer.
La source OpenAPI est importée.
- Pour Alias de connexion et d’informations d’identification, cliquez sur Créer.
-
Sur l’écran Créer un alias de connexion et d’informations d’identification, renseignez les champs et fournissez les informations de l’alias.
Champ Description Nom de connexion et d’informations d’identification Nom permettant d’identifier l’enregistrement d’alias de connexion et d’informations d’identification. Modèle de configuration pour authentification Mécanisme d’authentification requis pour cette intégration. Assurez-vous que le mécanisme d’authentification est compatible avec la source OpenAPI. Remarque :Le modèle de configuration est renseigné automatiquement en fonction de la spécification OpenAPI que vous avez fournie. Vous pouvez continuer avec l’option par défaut ou la modifier selon vos besoins. - Cliquez sur Créer un alias et continuer.
-
Sur le même écran, renseignez les champs pour configurer l’alias.
Champ Description Information de connexion Nom de la connexion Nom permettant d’identifier l’enregistrement de connexion. URL de connexion URL de base pour se connecter à l’instance ou au serveur tiers. Cette URL est renseignée automatiquement en fonction de la spécification OpenAPI que vous avez fournie. Informations d'identification Les champs d’informations d’identification pertinents s’affichent en fonction du modèle de configuration que vous avez sélectionné. Fournissez les valeurs requises pour configurer l’enregistrement des informations d’identification. Si vous souhaitez configurer l’enregistrement d’alias ultérieurement, cliquez sur Exécuter ultérieurement.
-
Cliquez sur Envoyer.
L’enregistrement d’alias de connexion est créé.
-
Cliquez sur Générer des opérations.
Toutes les opérations qui peuvent être effectuées à l’aide de la spécification OpenAPI sont répertoriées.
-
Sélectionnez les opérations requises.
Vous pouvez rechercher les actions requises en saisissant le terme requis dans la barre de recherche. Les actions qui correspondent au terme de recherche spécifié s’affichent.
-
Cliquez sur Publier.
Vous pouvez également sélectionner Enregistrer les actions en tant que brouillon pour enregistrer les actions en tant que brouillon, les modifier selon vos besoins et les publier ultérieurement.
-
Cliquez sur Terminé : accédez au spoke pour accéder à la page Spokes et afficher l’état de publication.
- Les actions avec l’étape OpenAPI sont créées. Pour en savoir plus sur l’étape OpenAPI, reportez-vous à la section OpenAPI support in the REST step.
- Les entrées et sorties d’action sont mappées.
- Les actions sont publiées et répertoriées dans la page des détails du spoke sous Actions > Publié.
Vous pouvez commencer à utiliser ces actions publiées pour créer des flux et des flux secondaires selon vos besoins.
- Si vous avez enregistré des actions en tant que brouillons, vous pouvez accéder à ces brouillons d’actions dans la page des détails du spoke sous Actions > Brouillon.
- Pour afficher des informations d’exécution sur les activités du spoke, cliquez sur Journal d’activité du spoke sur la page des détails du spoke. Chaque fois qu’une activité de spoke est exécutée, le système génère ses informations sous la forme d’un journal d’activité de spoke. Cliquez sur le nombre requis pour afficher le journal d’activité. Chaque opération dans le journal d’activité du spoke présente l’une des valeurs d’état suivantes :
Statut Description nouveau Un événement pour l’opération est créé et cette opération sera exécutée prochainement. erreur Échec de l’exécution de l’opération. traitement L’exécution de l’opération est en cours. réussite L’opération a été exécutée avec succès.
Vous pouvez créer des flux et des flux secondaires dans la page des détails du spoke et les utiliser dans votre intégration. Pour plus d'informations, consultez Création de flux et Création de flux secondaires.
Outre le journal d’activité du spoke, vous pouvez également afficher les détails des flux, des flux secondaires et des actions disponibles sur la page des détails du spoke.