Création de spokes à l’aide du générateur de spokes

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 2 minutes de lecture

    • Automatisez les tâches d’intégration en créant une séquence d’actions réutilisables pour développer des intégrations personnalisées appelées spokes.

    Demander des applications dans l'App Store

    Visitez le ServiceNow Store pour afficher toutes les applications disponibles, pour obtenir des informations sur la soumission de demandes au magasin et pour télécharger et installer Spoke Generator (sn_spoke_builder). Pour obtenir des informations sur les notes de publication cumulatives pour toutes les applications publiées, consultez le ServiceNow Store Historique des versions Notes de publication.

    Dépendances d’application

    Si vous rencontrez des difficultés pour installer l’application, assurez-vous que le module d’extension dépendant, ServiceNow Centre d’intégration Professional Pack Installer (com.glide.hub.integrations.professional) est installé.

    Remarque :
    Certains de ces modules d'extension sont des fonctionnalités sous licence et nécessitent des licences appropriées s'ils sont utilisés en dehors de l'implémentation des spokes.

    Options

    Un Hub d'intégration spoke personnalisé assure l’intégration entrante et sortante avec des applications tierces. Ces intégrations, appelées spokes, sont faciles à configurer et vous permettent d’ajouter rapidement des actions puissantes sans avoir besoin d’écrire un script. Cette fonctionnalité nécessite un Hub d'intégration abonnement. Pour plus d’informations, consultez Calendriers juridiques - Vue d’ensemble du Centre d’intégration.

    Vous pouvez créer des spokes personnalisés pour l’application tierce requise en important une collection de spécification OpenAPI ou Postman, des extraits de documentation de la documentation d’API tierce ou en créant un spoke manuellement.

    Rôles d'utilisateur requis

    • Les utilisateurs disposant du rôle administrateur peuvent :
      • Affichez l’onglet Spokes .
      • Créez un spoke.
      • Importer une spécification OpenAPI.
      • Créez un alias de connexion.
      • Publiez des actions et enregistrez des actions comme brouillons.
      • Consultez le journal d’activité du spoke.
    • Les utilisateurs disposant des rôles action_designer et fd_read_actions peuvent :
      • Affichez l’onglet Spokes .
      • Voir les actions dans un spoke.
    • Les utilisateurs disposant du rôle action_designer peuvent ajouter des actions manuellement.
      Remarque :
      Les utilisateurs disposant uniquement du rôle fd_read_actions peuvent uniquement voir les actions.
    • Les utilisateurs disposant du flow_operator ou d’un flow_designer peuvent afficher les flux et les flux secondaires.

    Limite de taille de la spécification OpenAPI

    Par défaut, le système peut importer des spécifications OpenAPI jusqu’à 10 Mo. Pour augmenter la taille d’importation, mettez à jour la glide.rest.openapi.max_request_size propriété système. La valeur maximale est de 100 Mo.

    Limitations de la spécification OpenAPI

    Les actions de spoke créées lors de l’importation de la spécification OpenAPI contiennent l’étape OpenAPI. Assurez-vous de connaître ces limitations de l’étape OpenAPI.

    Types de médias de corps de demande
    Le corps de la demande ne prend en charge que les types de médias JSON.
    Remarque :
    Un objet de sortie de type chaîne est créé lorsque le schéma OpenAPI a additionalProperties ou aucune propriété.
    Composants OpenAPI 3.0

    OpenAPI 3.0 ajoute de nouveaux composants à Swagger 2.0 pour décrire une API plus en détail. La prise en charge d’OpenAPI dans l’étape OpenAPI prend en charge certains de ces composants, mais pas tous. L’étape OpenAPI ne prend actuellement pas en charge ces composants.

    • Objet de schéma : propriétés oneOf, anyOf, additionalProperties
    • Objet discriminateur
    • Objet d’informations : termsOfService, contact, champs de licence
    • Exemple d’objet
    • Objet de lien
    • Objet de rappel
    • Objet du schéma de sécurité
    • Objet des besoins de sécurité
    • Objet de balise
    • Objet de documentation externe
    • Objet serveur
    • Extensions de spécifications
    • Références récursives

    Plus d’informations sur ces composants sont disponibles dans la documentation OpenAPI. Consultez la spécification OpenAPI.

    Nombre maximal d’opérations prises en charge
    Le nombre d’opérations d’API est limité à 500 par défaut. Toutefois, à l’aide de la propriété glide.rest.openapi.max_operation_limitsystème, vous pouvez configurer le nombre d’opérations de 1 à 1 000.

    Version de l'application

    Spoke Generator v4.0.3 est la dernière version.