Erstellen von Spokes mit Spoke Generator

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer

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

    Apps im Store anfordern

    Besuchen Sie die ServiceNow Store Auf der Website können Sie alle verfügbaren Apps anzeigen, Informationen zum Senden von Anforderungen an den Store erhalten und den Spoke Generator (sn_spoke_builder)herunterladen und installieren. Kumulative Informationen zum Release für alle veröffentlichten Apps finden Sie unter ServiceNow Store Versionshinweise zum Versionsverlauf.

    App-Abhängigkeiten

    Wenn Sie Probleme beim Installieren der App haben, stellen Sie sicher, dass das abhängige Plugin ServiceNow IntegrationHub Professional Pack Installer (com.glide.hub.integrations.professional) installiert ist.

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

    Fähigkeiten

    Eine anwenderdefinierte IntegrationHub -Spoke bietet sowohl eingehende als auch ausgehende Integrationen mit Anwendungen von Drittanbietern. 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 ein -Abonnement IntegrationHub. Weitere Informationen finden Sie unter Gesetzliche Zeitpläne − IntegrationHub − Übersicht.

    Sie können anwenderdefinierte Spokes für die erforderliche Drittanbieteranwendung erstellen, indem Sie eine OpenAPI-Spezifikation oder eine Postman-Sammlung, Dokumentationsausschnitte aus der API-Dokumentation einer Drittparteiimportieren oder manuell eine Spoke erstellen.

    Erforderliche Anwenderrollen

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

    Größenbeschränkung für OpenAPI-Spezifikation

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

    Einschränkungen der OpenAPI-Spezifikation

    Spoke-Aktionen, die durch Importieren der OpenAPI-Spezifikation erstellt wurden, enthalten den OpenAPI-Schritt. Stellen Sie sicher, dass Sie diese Einschränkungen für OpenAPI-Schritte kennen.

    Medientypen des Anforderungstexts
    Der Anforderungstext unterstützt nur JSON-Medientypen.
    Hinweis:
    Ein Ausgabeobjekt vom Typ Zeichenfolge wird erstellt, wenn das OpenAPI-Schema zusätzlicheEigenschaften oder keine Eigenschaften aufweist.
    OpenAPI 3.0-Komponenten

    OpenAPI 3.0 fügt zu „Swaiger 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“.
    • Unterscheidungsmerkmalobjekt
    • Info-Objekt: „termsOfService“, „Kontakt“, „Lizenz“-Felder
    • Beispielobjekt
    • Link-Objekt
    • Rückrufobjekt
    • Sicherheitsschemaobjekt
    • Sicherheitsanforderungsobjekt
    • Tag-Objekt
    • Externes Dokumentationsobjekt
    • Serverobjekt
    • Spezifikationserweiterungen
    • Rekursive Verweise

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

    Maximale Anzahl der unterstützten Vorgänge
    Die Anzahl der API-Vorgänge ist standardmäßig auf 500 beschränkt. Mit der Systemeigenschaft glide.rest.openapi.max_operation_limitkönnen Sie jedoch eine Anzahl von Vorgängen zwischen 1 und 1000 konfigurieren.

    App-Version

    Spoke Generator v4.0.3 ist die neueste Version.