Erstellen von Spokes mit Spoke Generator

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 2 Minuten Lesedauer

    • Automatisieren Sie Integrationsaufgaben, indem Sie eine Sequenz von wiederverwendbaren Aktionen erstellen, um benutzerdefinierte 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 Spoke Generator (sn_spoke_builder)herunterzuladen und zu installieren. Kumulative Informationen zum Release für alle veröffentlichten Apps finden Sie unter ServiceNow Store Versionsverlauf Versionshinweise.

    App-Abhängigkeiten

    Wenn Sie Probleme bei der Installation 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 benutzerdefinierte Spoke IntegrationHub ermöglicht die eingehende und ausgehende Integration 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. Für diese Funktion ist ein IntegrationHub -Abonnement erforderlich. Weitere Informationen finden Sie unter Gesetzliche Zeitpläne – IntegrationHub – Übersicht.

    Sie können benutzerdefinierte Spokes für die erforderliche Drittparteianwendung erstellen, indem Sie eine OpenAPI-Spezifikation importieren oder eine Spoke manuell erstellen.

    Erforderliche Benutzerrollen

    • Benutzer mit der Administratorrolle 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.
      • Siehe Aktionen in einer Spoke.
    • Benutzer mit der Rolle „action_designer“ können Aktionen manuell hinzufügen.
      Hinweis:
      Benutzer mit nur der Rolle „fd_read_actions“ 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 maximale Wert beträgt 100 MB.

    Einschränkungen der OpenAPI-Spezifikation

    Spoke-Aktionen, die durch Importieren der OpenAPI-Spezifikation erstellt werden, 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ätzliche Eigenschaften oder keine Eigenschaften aufweist.
    OpenAPI 3.0-Komponenten

    OpenAPI 3.0 fügt neue Komponenten zu SWAGGER 2.0 hinzu, um eine API detaillierter zu beschreiben. OpenAPI-Support 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“
    • Diskriminatorobjekt
    • Info-Objekt: „termsOfService“, „Kontakt“, „Lizenz“-Felder
    • Beispielobjekt
    • Link-Objekt
    • Rückrufobjekt
    • Sicherheitsschemaobjekt
    • Sicherheitsanforderungsobjekt
    • Tag-Objekt
    • Externes Dokumentationsobjekt
    • Serverobjekt
    • Spezifikationserweiterungen
    • Rekursive Referenzen

    Weitere Informationen zu diesen Komponenten finden Sie in der OpenAPI-Dokumentation. Weitere Informationen finden Sie unter 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 die Anzahl der Vorgänge von 1 bis 1000 konfigurieren.

    App-Version

    Spoke Generator v2.0.2 ist die neueste Version.