Spokes mit Spoke Generator erstellen

  • Freigeben Version: Zurich
  • Aktualisiert 2. September 2025
  • 2 Minuten Lesedauer

    • Automatisieren Sie Integrationsaufgaben, indem Sie eine Sequenz wiederverwendbarer Aktionen erstellen, um anwenderdefinierte Integrationen zu entwickeln, die als Spokes bezeichnet werden.

    Apps im Store anfordern

    Besuchen Sie ServiceNow Store Website, um alle verfügbaren Apps anzuzeigen, Informationen zum Senden von Anforderungen an den Store zu erhalten und herunterzuladen und zu installieren Spoke-Generator (sn_Spoke_Builder) . Kumulative Informationen zu Release-Hinweisen für alle veröffentlichten Apps finden Sie unter ServiceNow Store Release-Hinweise zum Versionsverlaufan.

    App-Abhängigkeiten

    Wenn Sie Probleme bei der Installation der App haben, stellen Sie sicher, dass das abhängige Plugin ServiceNow IntegrationHub Starter Pack Installer (com.glide.hub.integrations.starter) installiert ist. Sie benötigen die ServiceNow IntegrationHub Professional Pack-Installationsprogramm-Lizenz in Ihren Produktions- und Subprod-Umgebungen, um Spokes mit Offen zu erstellen API-Spezifikation, Postman-Sammlung , Oder Now Assist.

    Hinweis:
    Einige dieser Plugins sind lizenzierbare Funktionen und erfordern entsprechende Lizenzen, wenn sie außerhalb der Spoke-Implementierung verwendet werden.

    Fähigkeiten

    Ein IntegrationHub Anwenderdefinierte Spoke bietet sowohl eingehende als auch ausgehende Integration mit Drittanbieteranwendungen. Diese Integrationen werden als Spokes bezeichnet, sind einfach zu konfigurieren und ermöglichen es Ihnen, schnell leistungsstarke Aktionen hinzuzufügen, ohne ein Skript schreiben zu müssen. Diese Funktion erfordert einen IntegrationHub Abonnement. Weitere Informationen finden Sie unter Rechtliche Zeitpläne – IntegrationHub-Übersicht .

    Sie können anwenderdefinierte Spokes für die erforderliche Drittanbieteranwendung erstellen, indem Sie einen importieren OpenAPI-Spezifikation Oder Postman-Sammlung , Dokumentationsausschnitte aus der API-Dokumentation von Drittparteien , Oder Spoke wird manuell erstellt .

    Erforderliche Anwenderrollen

    • Anwender mit der Administratorrolle können:
      • Zeigen Sie an Spokes Registerkarte.
      • Erstellen Sie eine neue Spoke.
      • Importieren Sie eine OpenAPI-Spezifikation.
      • Erstellen Sie einen Verbindungsalias.
      • Veröffentlichen Sie Aktionen, und speichern Sie Aktionen als Entwürfe.
      • Siehe Spoke-Aktivitätsprotokoll.
    • Anwender mit den Rollen „action_Designer“ und „fd_read_actions“ können:
      • Zeigen Sie an Spokes Registerkarte.
      • Aktionen in einer Spoke anzeigen.
    • Benutzer mit der Rolle „action_Designer“ können Aktionen hinzufügen .
      Hinweis:
      Anwender mit nur der Rolle „fd_read_actions“ können nur Aktionen anzeigen.
    • Anwender mit Flow_Operator oder Flow_Designer können Flows und Subflows anzeigen.

    Größenbeschränkung der OpenAPI-Spezifikation

    Standardmäßig kann das System OpenAPI-Spezifikationen bis zu 10 MB importieren. Um die Importgröße zu erhöhen, aktualisieren Sie glide.rest.openapi.max_request_sizeSystemeigenschaft. Der Höchstwert beträgt 100 MB.

    Einschränkungen der OpenAPI-Spezifikation

    Spoke-Aktionen, die durch den Import der OpenAPI-Spezifikation erstellt wurden, enthalten den OpenAPI-Schritt. Stellen Sie sicher, dass Sie sich dieser OpenAPI-Schrittbeschränkungen bewusst sind.

    Medientypen des Anforderungstexts
    Der Anforderungstext unterstützt nur JSON-Medientypen.
    Hinweis:
    Ein Ausgabeobjekt vom Typ Zeichenfolge wird erstellt, wenn das OpenAPI-Schema über additionalProperties oder keine Eigenschaften verfügt.
    OpenAPI 3,0-Komponenten

    OpenAPI 3,0 fügt Swagger 2,0 neue Komponenten hinzu, um eine API detaillierter zu beschreiben. Die OpenAPI-Unterstützung im OpenAPI-Schritt unterstützt einige, aber nicht alle dieser Komponenten. Der OpenAPI-Schritt unterstützt diese Komponenten derzeit nicht.

    • Schemaobjekt: Eigenschaften oneof, anyOf, additionalProperties
    • Unterscheiderobjekt
    • Informationsobjekt: TermsOfService, Kontakt, Lizenzfelder
    • Beispielobjekt
    • Objekt Verknüpfen
    • Rückrufobjekt
    • Sicherheitsschemaobjekt
    • Sicherheitsanforderungsobjekt
    • Tag-Objekt
    • Externes Dokumentationsobjekt
    • Serverobjekt
    • Spezifikationserweiterungen
    • Rekursive Referenzen

    Weitere Informationen zu diesen Komponenten finden Sie in der OpenAPI-Dokumentation. Siehe OpenAPI-Spezifikation .

    Maximale Anzahl unterstützter Vorgänge
    Die Anzahl der API-Vorgänge ist standardmäßig auf 500 beschränkt. Verwenden Sie jedoch die Systemeigenschaft glide.rest.openapi.max_operation_limit, Sie können die Anzahl der Vorgänge von 1 bis 1000 konfigurieren.

    App-Version

    Spoke-Generator v4.2.0 ist die neueste Version.