Erstellen Sie Spoke- und Build-Aktionen, indem Sie eine OpenAPI-Spezifikation importieren

Automatisieren Sie eine Integration, und generieren Sie wiederverwendbare Aktionen, indem Sie eine OpenAPI-Spezifikation importieren.

Vorbereitungen

• Installieren Sie die Spoke Generator-App aus dem ServiceNow Store.
• Bestätigen Sie das ServiceNow IntegrationHub Professional Pack-Installationsprogramm (com.glide.hub.integrations.professional) ist installiert, und die Lizenz ist berechtigt.
• Erforderliche Rolle: Administrator

Prozedur

1. Navigieren zu Alle > Prozessautomatisierung > Workflow-Studioan.
2. Klicken Neu erstellen > Spokean.
3. Geben Sie auf dem Bildschirm Spoke-Info an, ob Sie die Spoke in einem neuen Bereich oder einem vorhandenen Bereich erstellen möchten.
   1. Wenn Sie die Spoke in einem neuen Bereich erstellen möchten, wählen Sie ein Bild als Logo für Ihre Integration aus, und füllen Sie die Felder aus.

      Hier gehen wir als Beispiel eine Integration mit Zoom durch.

      Feld	Beschreibung
      Spoke-Name	Name zur Identifizierung der anwenderdefinierten Spoke.
      Beschreibung	Beschreibung der anwenderdefinierten Spoke.

      

      Hinweis:

      Der Wert von Name des App-Umfangs Ist das Format: X_<company-code>_<spoke-name>_<spoke> . Standardmäßig lautet der <company-code>: snc . Sie können den Unternehmenscode konfigurieren, indem Sie konfigurieren Wert Der Systemeigenschaft, glide.appcreator.company.code.

      Dieser konfigurierte Wert wird verwendet, wenn der Wert verwendet wird Name des App-Umfangs Wird generiert.

   2. Wenn Sie die Spoke in einem vorhandenen Bereich erstellen möchten, wählen Sie ein Bild als Logo für Ihre Integration aus, und füllen Sie die Felder aus.

      Hier gehen wir als Beispiel eine Integration mit AWS durch.

      Feld	Beschreibung
      Anwendungsname	Ein vorhandener Anwendungsname oder -Umfang.
      Name des App-Umfangs	Bereichsname, der basierend auf der ausgewählten automatisch ausgefüllt wird Anwendungsname .
      Beschreibung	Beschreibung der anwenderdefinierten Spoke.

      

4. Klicken Sie auf Fortsetzen.

   Basierend auf dem angegebenen Namen und der Beschreibung werden bei übereinstimmenden Spokes im Store die Spoke-Details angezeigt.

   1. Klicken Sie Auf Zeigen Sie Details im Store an Um die Details der übereinstimmenden Spokes anzuzeigen.
      Details der übereinstimmenden Spokes werden auf einer neuen Browserregisterkarte angezeigt.
   2. Installieren Sie die Spoke aus dem Store.
      Weitere Einzelheiten finden Sie unter Install a ServiceNow Store application.
   3. Navigieren Sie nach der Installation der Spoke zu Workflow-Studio Registerkarte.
      Das System zeigt die Meldung an Haben Sie eine Spoke aus dem Store installiert? .
   4. Wählen Sie eine dieser Optionen aus, und klicken Sie auf Fahren Sie Fort .

      Option	Beschreibung
      Ja, zeigen Sie die installierte Spoke an.	Option zur Umleitung zu Spokes Dashboard unter Integrationen .
      Nein, ich werde eine anwenderdefinierte Spoke erstellen.	Option zum Fortsetzen der Spoke-Erstellung.
      Nein, ich möchte die Spoke-Erstellung beenden.	Option zum Schließen der aktuellen Registerkarte.

5. Klicken Sie Auf Überspringen Wenn Sie die anwenderdefinierte Spoke erstellen möchten.
   Hinweis:

   Die folgenden Schritte gelten auch, wenn Sie ausgewählt haben Nein, ich werde anwenderdefinierte Spoke erstellen. Option.

   Die Spoke wird erstellt, und eine Bestätigungsnachricht wird angezeigt.

6. Wählen Sie im Bildschirm Build-Info die Methode aus, mit der Sie Ihre Spoke erstellen möchten.
   Sie können Ihre Spoke mithilfe der OpenAPI-Spezifikation oder der Postman-Sammlung erstellen.
7. Wählen Sie Aus OpenAPI-Spezifikation Und klicken Sie auf Fahren Sie Fort Dient zum Importieren einer OpenAPI-Spezifikation.
   
8. Für OpenAPI-Quelle , Klicken Sie auf Importieren Sie neu .
9. Führen Sie im Bildschirm neue OpenAPI-Quelle importieren einen der beiden Schritte aus.
   1. Wenn Sie mit einer URL importieren möchten, wählen Sie aus Aus URL importieren Für Importmethode Und geben Sie die URL in an OpenAPI-URL .
      
   2. Wenn Sie manuell mit JSON- oder YAML-Code importieren möchten, wählen Sie aus Manuell aus JSON oder YAML importieren Für Importmethode Und geben Sie den Code in an JSON oder YAML .
      
10. Klicken Sie auf Importieren.
    Die OpenAPI-Quelle wird importiert.
11. Für Alias für Verbindungen und Anmeldeinformationen , Klicken Sie auf Erstellen Sie neu .
12. Füllen Sie die Felder im Bildschirm Alias für neue Verbindungen und Anmeldeinformationen erstellen aus, und geben Sie die Aliasinformationen an.

    Feld	Beschreibung
    Verbindungs- und Anmeldeinformationsname	Name zur Identifizierung des Alias für Verbindungen und Anmeldeinformationen.
    Konfigurationsvorlage für die Authentifizierung	Erforderlicher Authentifizierungsmechanismus für diese Integration. Stellen Sie sicher, dass der Authentifizierungsmechanismus mit der OpenAPI-Quelle kompatibel ist. Hinweis: Die Konfigurationsvorlage wird basierend auf der von Ihnen angegebenen OpenAPI-Spezifikation automatisch ausgefüllt. Sie können mit der Standardoption fortfahren oder sie entsprechend Ihren Anforderungen ändern.

    
13. Klicken Sie Auf Erstellen Sie einen Alias, und fahren Sie fort .
14. Füllen Sie auf demselben Bildschirm die Felder aus, um den Alias zu konfigurieren.

    Feld	Beschreibung
    Verbindungsinformation
    Verbindungsname	Name zur Identifizierung des Verbindungsdatensatzes.
    Verbindungs-URL	Basis-URL für die Verbindung mit der Drittparteiinstanz oder dem Server. Diese URL wird basierend auf der von Ihnen angegebenen OpenAPI-Spezifikation automatisch ausgefüllt.
    Anmeldedaten
    Basierend auf der von Ihnen ausgewählten Konfigurationsvorlage werden die relevanten Anmeldeinformationsfelder angezeigt. Geben Sie die erforderlichen Werte an, um den Anmeldeinformationsdatensatz zu konfigurieren.

    

    Wenn Sie den Aliasdatensatz später konfigurieren möchten, klicken Sie auf Tun Sie es später .

15. Klicken Sie auf Absenden.
    Der Verbindungsalias-Datensatz wird erstellt.
16. Klicken Sie Auf Generieren Sie Vorgänge .
    
    Alle Vorgänge, die mit der OpenAPI-Spezifikation ausgeführt werden können, werden aufgelistet.
17. Wählen Sie die erforderlichen Vorgänge aus.

    Sie können nach den erforderlichen Aktionen suchen, indem Sie den erforderlichen Begriff in die Suchleiste eingeben. Die Aktionen, die dem angegebenen Suchbegriff entsprechen, werden angezeigt.

    
18. Klicken Sie auf Veröffentlichen.
    Alternativ können Sie auch auswählen Speichern Sie Aktionen als Entwurf Um die Aktionen als Entwurf zu speichern, ändern Sie sie gemäß Ihren Anforderungen, und veröffentlichen Sie sie später.
19. Klicken Sie Auf Fertig: Wechseln Sie zu Spoke Um zur Spokes-Seite zu wechseln und den Veröffentlichungsstatus anzuzeigen.
    • Aktionen mit dem OpenAPI-Schritt werden erstellt. Informationen zum OpenAPI-Schritt finden Sie unter OpenAPI support in the REST step.
    • Aktionseingaben und -Ausgaben werden zugeordnet.
    • Aktionen werden veröffentlicht und auf der Seite „Spoke-Details“ unter aufgelistet Aktionen > Veröffentlichtan.

    Sie können diese veröffentlichten Aktionen verwenden, um Flows und Subflows entsprechend Ihren Anforderungen zu erstellen.

    • Wenn Sie Aktionen als Entwurf gespeichert haben, können Sie auf diese Entwurfsaktionen auf der Seite „Spoke-Details“ unter zugreifen Aktionen > Entwurfan.
    • Um Laufzeitinformationen zu den Spoke-Aktivitäten anzuzeigen, klicken Sie auf Spoke-Aktivitätsprotokoll Auf der Seite „Spoke-Details“. Jedes Mal, wenn eine Spoke-Aktivität ausgeführt wird, generiert das System ihre Informationen als Spoke-Aktivitätsprotokoll. Klicken Sie auf die erforderliche Nummer Dient zum Anzeigen des Aktivitätsprotokolls. Jeder Vorgang im Spoke-Aktivitätsprotokoll hat einen der folgenden Statuswerte:

      Status	Beschreibung
      new	Ein Ereignis für den Vorgang wird erstellt, und dieser Vorgang wird in Kürze ausgeführt.
      Fehler	Der Vorgang konnte nicht ausgeführt werden.
      Wird verarbeitet	Die Ausführung des Vorgangs wird ausgeführt.
      Erfolg	Der Vorgang wurde erfolgreich ausgeführt.

    Sie können Flows und Subflows auf der Spoke-Detailseite erstellen und in Ihrer Integration verwenden. Weitere Informationen finden Sie unter Erstellen von Flows und Subflows werden erstellt.

    Zusammen mit Spoke-Aktivitätsprotokoll , Sie können auch Details der verfügbaren Flows, Subflows und Aktionen auf der Seite „Spoke-Details“ anzeigen.