Einrichten

Einleitung

Um erfolgreich eine Verbindung herzustellen und Anforderungen an die ServiceNow-API zu senden, benötigt die Aktivität ServiceNow Scope eine Endpunkt-URL für Ihren ServiceNow-Mandanten (Endpunkt-URL), einen Benutzernamen (UserName) und ein Kennwort (Password). Sie können optional ein OAuth-Zugriffstoken von Ihrem ServiceNow-Mandanten abrufen. Zum Abrufen des OAuth-Zugriffstokens werden die Client-ID Ihrer ServiceNow-Instanz, der geheime Clientschlüssel und die Endpunkt-URL benötigt.

Wenn Sie sich für die Verwendung von OAuth entscheiden, müssen Sie der ServiceNow Scope- Aktivität die Möglichkeit geben, das OAuth-Zugriffstoken abzurufen, und die anderen Aktivitäten aktivieren, um erfolgreich Anforderungen an die ServiceNow-API zu senden. Sie müssen die folgenden Schritte ausführen:

1. OAuth einrichten.
2. Erstellen Sie Anmeldeinformationsassets.
3. Erstellen Sie Ihr Projekt.
   
   

   

   
   

OAuth einrichten

Schließen Sie die Schritte zum Einrichten der OAuth in der ServiceNow-Dokumentation ab. Auch wenn die dokumentierten Schritte wahrscheinlich in allen ServiceNow-Plattformregionen gleich sind, wird empfohlen, dass Sie die Schritte für Ihre spezifische Region ausführen, falls es Unterschiede gibt (z. B.Madrid, New York usw.).

Nachfolgend sehen Sie, wie wir OAuth für unsere Beispiele einrichten.

Hinweis: Wenn Sie OAuth bereits für Ihre ServiceNow-Instanz eingerichtet haben, notieren Sie sich die Client-ID und den geheimen Clientschlüssel, die Ihrer Anwendungsregistrierung zugewiesen sind, und fahren Sie mit dem Schritt 2. Anmeldeinformations-Assets erstellen fort.

1. Melden Sie sich bei Ihrer ServiceNow-Instanz an (z. B. https://dev74293.service-now.com/login)

2. Gehen Sie zu Systemdefinitionen > Plugins und überprüfen Sie, ob der Status des OAuth-Plugins auf Aktivfestgelegt ist.

   
   

   

   
   

3. Wechseln Sie zu System OAuth > Anwendungsregistrierung und klicken Sie auf Neu.

   • Bei der Frage Welche Art von OAuth-Anwendung?, klicken Sie auf OAuth-API-Endpunkt für externe Clients erstellen.

     
     

     

     
     

4. Geben Sie einen Namen für Ihre Anwendung ein (z. B. UiPathQuickstart) und klicken Sie auf Absenden (bei Erfolg werden Sie zurück zur Liste der Anwendungsregistrierungen geleitet ).

   
   

   

   
   
5. Suchen Sie in der Liste Anwendungs-Registries Ihre neue Anwendung und klicken Sie auf ihren Namen , um die Detailseite zu öffnen.
6. Klicken Sie auf das Schlosssymbol neben Geheimer Clientschlüssel , um den Wert anzuzeigen.

7. Notieren Sie sich die Werte „ Client-ID “ und „ Client Secret “ (diese geben Sie in der Aktivität „ ServiceNow Scope “ ein).

   
   

   

   
   
8. Wenn diese OAuth-Anwendung OAuth2 unterstützen soll, müssen Sie die Umleitungs-URL auf http://127.0.0.1:10001/authorize/ festlegen.
   Wichtig:

   Ab v1.3.8 haben wir Unterstützung für lokale Ports hinzugefügt. Der Parameter Lokaler Port , der im ServiceNow-Anwendungsumfang verfügbar ist, ist optional und konfigurierbar. Standardmäßig ist der Wert auf 10001 festgelegt (z. B. http://127.0.0.1:10001/authorize/). Wenn Sie Ihre OAuth-Anwendung konfigurieren, legen Sie die Umleitungs-URL fest auf: http://127.0.0.1:{LocalPort}/authorize/. Für den lokalen Port 10002 wäre die Umleitungs-URL beispielsweise http://127.0.0.1:10002/authorize/. Es ist nicht ratsam, den lokalen Port im selben Projekt zu ändern. Wenn sich der Port ändert, erstellen Sie ein neues Projekt oder einen neuen Workflow, um etwaige Caching-Fehler zu vermeiden.
   
   

   

   
   

Erstellen Sie Anmeldeinformations-Assets

Die Aktivität ServiceNow Scope erfordert SecureString Eingaben für Ihre ServiceNow-Anmeldeinformationen (Password und ClientGeheimnis). Zum Generieren der SecureString -Variablen wird empfohlen, zwei Anmeldeinformationsassets in Ihrem Orchestrator-Mandanten zu erstellen.

1. Melden Sie sich beim Orchestrator-Mandanten an, den Sie für Ihr Projekt verwenden möchten.
2. Klicken Sie links auf Assets (dadurch öffnet sich die Seite Assets).

3. Klicken Sie auf das Symbol + , um ein neues Asset zu erstellen (dadurch öffnet sich das Fenster Asset erstellen ).

   
   

   

   
   
4. Geben Sie einen Namen ein, und wählen Sie Anmeldeinformationen unter Typaus.
5. Geben Sie im Feld Benutzername die ClientId Ihrer ServiceNow-Anwendungsregistrierung ein.
6. Geben Sie im Feld Kennwort das ClientSecret Ihrer ServiceNow-Anwendungsregistrierung ein.

7. Klicken Sie auf Erstellen.

   
   

   

   
   

8. Wiederholen Sie die Schritte 3–7, um ein weiteres Asset für Ihren ServiceNow -Benutzernamen und Ihr Kennwort zu erstellen.

   
   

   

   
   

Erstellen Sie Ihr Projekt

1. Erstellen Sie ein neues Automatisierungsprojekt.

   1. Öffnen Sie UiPath Studio.
   2. Klicken Sie unter Neues Projektauf Prozess (dadurch wird das Fenster Neuer leerer Prozess geöffnet).
   3. Geben Sie einen Projektnamen, einen Speicherortund eine Beschreibungein.

   4. Klicken Sie auf Erstellen.

      
      

      

      
      

2. Installieren Sie das UiPath.ServiceNowActivities -Paket.

   1. Klicken Sie im Menüband Design auf Pakete verwalten (dadurch wird das Fenster Pakete verwalten geöffnet).
   2. Klicken Sie unter Alle Paketeauf Beta
   3. Geben Sie in der Suchleiste ServiceNowein.

   4. Klicken Sie auf, installieren und akzeptieren Sie die Lizenz für UiPath.ServiceNow.Activities.

      • Weitere Informationen zu Uipath Studio-Paketen finden Sie unter Verwalten von Paketen im Studio-Handbuch.

Alles erledigt!

Nachdem Sie die Einrichtung abgeschlossen haben, können Sie damit beginnen, die ServiceNow-Aktivitäten zu Ihrem Projekt hinzuzufügen.

Nächste Schritte

Wenn Sie Lernerfahrungen aus der Praxis sammeln möchten, und um schnell mit der Verwendung der Aktivitäten zu beginnen, sehen Sie sich die Schnellstartanleitung an. In dieser Anleitung finden Sie Schritt-für-Schritt-Anweisungen, die Ihnen helfen sollen, ein funktionierendes Beispiel für die verschiedenen Aktivitäten zu erstellen, damit Sie die Verbindung mit Ihrer ServiceNow-Instanz überprüfen und sich mit den Eingabe-/Ausgabeeigenschaften vertraut machen können.

Weitere Informationen zu den ServiceNow-Aktivitäten (einschließlich Beispiele für Eigenschaftseingaben/-ausgaben) finden Sie auf der Seite Aktivitäten . Dort finden Sie eine vollständige Aktivitätsliste und Links zu den Aktivitätsdetailseiten.