Créer un spoke et créer des actions 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
- Installez l’application Générateur de spokes à partir du ServiceNow Store.
- Rôle requis : admin
Procédure
-
Dans l’écran Informations sur le spoke, spécifiez 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 champ d’application, sélectionnez une image comme logo de votre intégration et renseignez les champs.
Ici, nous allons passer en revue 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 le format suivant : x_<company-code>_<spoke-name>_<spoke>. Par défaut, le <company-code> est snc. Vous pouvez configurer le code de 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 de votre intégration et renseignez les champs.
Ici, nous allons passer en revue une intégration avec AWS à titre d’exemple.
Champ Description Nom de l'application Un nom 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 de l’application sélectionnée. Description Description du spoke personnalisé.
-
Si vous choisissez de créer le spoke dans un nouveau champ d’application, sélectionnez une image comme logo de 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 magasin, les détails du spoke s’affichent.
-
Sélectionnez Spécification OpenAPI, puis cliquez sur Continuer pour importer une spécification OpenAPI.
-
Sur l’écran Importer une nouvelle source OpenAPI, effectuez l’une des deux étapes suivantes.
-
Si vous souhaitez importer à l’aide d’une URL, sélectionnez Importer à partir de l’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 de l’URL pour Méthode d’importation et spécifiez l’URL dans l’URL OpenAPI.
-
Sur l’écran Créer un alias de connexion et d’informations d’identification, renseignez les champs et fournissez les informations sur 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. -
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 Selon le modèle de configuration que vous avez sélectionné, les champs d’informations d’identification pertinents s’affichent. Fournissez les valeurs requises pour configurer l’enregistrement des informations d’identification. Si vous souhaitez configurer l’enregistrement d’alias ultérieurement, cliquez sur Effectuer cette opération ultérieurement.
-
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.
Sinon, vous pouvez également sélectionner Enregistrer les actions comme brouillon pour enregistrer les actions comme brouillon, les modifier selon vos besoins et les publier ultérieurement.