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 (Benutzername) und ein Kennwort (Kennwort). Optional können Sie ein OAuth-Zugriffstoken von Ihrem ServiceNow-Mandanten abrufen. Um das OAuth-Zugriffstoken abzurufen, benötigen Sie Ihre Client-ID der ServiceNow-Instanz, den geheimen Clientschlüssel und die Endpunkt-URL.

If you choose to use OAuth, you must give the ServiceNow Scope activity the ability to retrieve the OAuth access token and enable the other activities to successfully send requests to the ServiceNow API, you must complete the following steps:

1. OAuth einrichten.

2. Erstellen Sie Anmeldeinformationsassets.

3. Erstellen Sie Ihr Projekt.

   

OAuth einrichten

Schließen Sie die Schritte zum Einrichten von OAuth in der Dokumentation zu ServiceNow ab. Obwohl die dokumentierten Schritte wahrscheinlich für alle ServiceNow-Plattformregionen gleich sind, wird empfohlen, dass Sie die Schritte für Ihre spezifische Region ausführen, falls es Unterschiede gibt (z. B. Spanien, 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, beachten Sie die Client-ID und den Geheimen Clientschlüssel, die Ihrer Anwendungsregistrierung zugewiesen sind, und fahren Sie mit Schritt 2. Anmeldeinformationsassets erstellen fort.

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

2. Go to System Definitions > Plugins and verify the OAuth plugin Status is set to Active.

   

3. Go to System OAuth > Application Registry and click New.

   • When asked What kind of OAuth application?, click Create an OAuth API endpoint for external clients.

     

4. Enter a Name for your application (e.g., UiPathQuickstart) and click Submit (if successful, you are redirected back to your Application Registries list).

   

5. In the Application Registries list, find your new application and click on its Name to open the details page.

6. Click on the lock icon next to Client Secret to show the value.

7. Take note of the Client Id and Client Secret values (you'll enter these in the ServiceNow Scope activity).

   

8. Wenn Sie möchten, dass diese OAuth-Anwendung OAuth2 unterstützt, 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 Anwendungsbereich 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 auf: http://127.0.0.1:{LocalPort}/authorize/ fest. Beispielsweise wäre die Umleitungs-URL für den lokalen Port 10002 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 eventuelle Zwischenspeicherfehler zu vermeiden.

   

Erstellen Sie Anmeldeinformations-Assets

Die Aktivität ServiceNow Scope erfordert SecureString -Eingaben für Ihre ServiceNow-Anmeldeinformationen (Kennwort und ClientGeheimnis). Um die SecureString -Variablen zu generieren, 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. In the left-hand navigation, click Assets (this opens the Assets page).

3. Click the + icon to create a new Asset (this opens the Create Asset window).

   

4. Enter a Name and select Credential under Type.

5. In the Username field, enter the ClientId of your ServiceNow application registry.

6. In the Password field, enter the ClientSecret of your ServiceNow application registry.

7. Klicken Sie auf Erstellen (Create).

   

8. Repeat steps 3-7 to create another Asset for your ServiceNow Username and Password.

   

Erstellen Sie Ihr Projekt

1. Erstellen Sie ein neues Automatisierungsprojekt.

   1. Open UiPath Studio.

   2. Under New Project, click Process (this opens a New Blank Process window).

   3. Enter a project Name, Location, and Description.

   4. Klicken Sie auf Erstellen (Create).

      

2. Install the UiPath.ServiceNowActivities package.
   1. In the Design ribbon, click Manage Packages (this opens the Manage Packages window).
   2. Under All Packages, click Beta
   3. In the Search bar, enter ServiceNow.
   4. Click, install and accept the license for the 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 „Learning by doing“ möchten und die Aktivitäten schnell einsetzen möchten, sehen Sie sich die Schnellstartanleitung an. Diese Anleitung enthält Schritt-für-Schritt-Anweisungen, mit denen Sie ein funktionierendes Beispiel für die verschiedenen Aktivitäten erstellen können, damit Sie die Verbindung zu Ihrer ServiceNow-Instanz überprüfen und sich mit den Eingabe-/Ausgabeeigenschaften vertraut machen können.

Weitere Informationen zu den ServiceNow-Aktivitäten ( einschließlich Eigenschaftseingaben/-ausgaben) finden Sie auf der Seite Aktivitäten für eine vollständige Liste der Aktivitäten und Links zu den Seiten mit den Aktivitätsdetails.