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

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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 procédure à suivre pour soumettre des demandes à la boutique 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’applications

    Si vous rencontrez des difficultés pour installer l’application, assurez-vous que le module d’extension dépendant, ServiceNow IntegrationHub 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.

    Aptitudes

    Un Hub d'intégration spoke personnalisé fournit une 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écifications OpenAPI ou Postman, 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 nouveau spoke.
      • Importez une spécification OpenAPI.
      • Créez un alias de connexion.
      • Publiez des actions et enregistrez des actions en tant que 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 ayant le 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 de la flow_designer peuvent afficher les flux et les flux secondaires.

    Limite de taille de spécification OpenAPI

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

    Limites de la spécification OpenAPI

    Les actions de spoke créées par l’importation de la spécification OpenAPI contiennent l’étape OpenAPI. Assurez-vous d’être conscient de ces limitations d’é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 des propriétés supplémentaires 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 à 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 discriminant
    • 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 Security
    • 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. Voir Spécification OpenAPI.

    Nombre maximal d’opérations prises en charge
    Le nombre d’opérations 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 v3.0.0 est la dernière version.