ServiceNow Application Scope

UiPath.ServiceNow.Activities.ServiceNowScopeActivity

Tipp: Während die ServiceNow Application Scope-Aktivität die Standardauthentifizierung (UserName) und (Password) verwenden kann, wird dringend empfohlen, die OAuth-Sicherheit für alle Ihre Verbindungen gemäß den folgenden Schritten zu verwenden.

Die ServiceNow-Aktivitäten verwenden das Protokoll OAuth 1.0, um eine authentifizierte Verbindung zwischen UiPath und Ihrer ServiceNow-Instanz herzustellen. Diese Verbindung autorisiert einen Roboter, die ServiceNow-APIs aufzurufen und in Ihrem Namen auf Ressourcen zuzugreifen.

Um die Autorisierung zu aktivieren, erstellen Sie einen OAuth-Anwendungsendpunkt für Ihre ServiceNow-Instanz. Wenn Sie diesen Endpunkt erstellen, werden ein OAuth-Clientanwendungsdatensatz, eine Client-ID und ein geheimer Clientschlüssel generiert, um den authentifizierten Zugriff auf Ihre Instanz zu ermöglichen.

Nachdem Sie Ihren Endpunkt erstellt haben, geben Sie Ihre ServiceNow-Anmeldeinformationen zusammen mit der Anwendungsendpunkt-URL, der Client-ID und dem geheimen Clientgeheimnis in der Aktivität ServiceNow-Anwendungsbereich ein.

Tipp:

Integrationsbenutzerrollen sollten nur die erforderlichen Mindestberechtigungen für die Ausführung der Aufgaben erhalten, die durch die Aktivitäten in diesem Paket aktiviert werden (z. B. sollten admin, itil, soap_ecc usw. nicht für Integrationsbenutzerrollen verwendet werden). Eingehende Webdienste, die Tabellen ändern, sollten auf die entsprechenden Systemrollenbeschränkt werden.

Weitere Informationen finden Sie im Abschnitt Rollen in der ServiceNow-Dokumentation.

Wie es funktioniert

Die folgenden Schritte und das folgende Nachrichtensequenzdiagramm sind ein Beispiel dafür, wie die Aktivität von der Entwurfszeit (d. h. den Aktivitätsabhängigkeiten und Eingabe-/Ausgabeeigenschaften) bis zur Laufzeit funktioniert.

1. Schließen Sie die Einrichtungsschritte ab.
2. Fügen Sie für jede SecureString -Eingabeeigenschaft eine Aktivität hinzu (z. B. insgesamt zwei – eine für Password und eine für ClientSecret)
3. Fügen Sie die Aktivität ServiceNow Application Scope zu Ihrem Projekt hinzu.
4. Geben Sie Werte für die Eigenschaften Authentifizierung und Verbindung ein.
5. Erstellen und geben Sie eine IConnection -Variable für die Ausgabeeigenschaften ein.

   • Sie können diese Variable bei nachfolgenden Verwendungen der Aktivität „ServiceNow Application Scope “ verwenden.

     
     

     

     
     

Wenn bei der Verwendung der Standardauthentifizierung Probleme auftreten, finden Sie weitere Informationen unter Tipps zur Standardauthentifizierung.

Im Textkörper der Aktivität

Um Ihr Projekt zu erstellen und den Objektassistenten in anderen Aktivitäten zu aktivieren, müssen Sie den Verbindungsassistenten verwenden, indem Sie auf die Schaltfläche Konfigurieren klicken.

Weitere Informationen finden Sie im Abschnitt Assistenten auf der Seite Info .

Eigenschaften

Authentication

• Benutzername – Der Benutzername für Ihre ServiceNow-Instanz. Geben Sie eine String -Variable ein.
  • Dieser Wert kann sich von Ihrem ServiceNow-Konto unterscheiden, wenn Sie über mehrere Instanzen verfügen.
  • Der Benutzername ist mit dem Kennwortverknüpft. Es wird empfohlen, eine String -Variable gemäß dem Abschnitt Anmeldeinformations-Assets erstellen der Einrichtungsanleitung zu generieren.
  • Um Ihre Variable String einzugeben, verwenden Sie eine Aktivität, die Ihr Anmeldeinformationsasset ausgibt (siehe Beispiel unten).
• Kennwort (Password ) – Das (mit dem Benutzernamenverknüpfte) Kennwort für Ihre ServiceNow-Instanz. Geben Sie eine String - oder String -Variable ein.
  • Dieser Wert kann sich von Ihrem ServiceNow-Konto unterscheiden, wenn Sie über mehrere Instanzen verfügen.
  • Der Benutzername ist mit dem Kennwortverknüpft. Es wird empfohlen, eine String -Variable gemäß dem Abschnitt Anmeldeinformations-Assets erstellen der Einrichtungsanleitung zu generieren.
  • Um Ihre Variable String einzugeben, verwenden Sie eine Aktivität, die Ihr Anmeldeinformationsasset ausgibt (siehe Beispiel unten).
• Client Secret (Client Secret) - Der SecureString , der zum Autorisieren der Kommunikation zwischen UiPath und Ihrer ServiceNow-Instanz verwendet wird. Geben Sie eine SecureString -Variable ein.
  • Das ClientGeheimnis wird für Ihre ServiceNow-Instanz generiert, wenn Sie eine Anwendungsregistrierung ausfüllen. Weitere Informationen finden Sie im Abschnitt Einrichtung von OAuth der Einrichtungsanleitung .
  • Informationen zum Generieren einer SecureString -Variablen finden Sie im Abschnitt Anmeldeinformations-Assets erstellen der Setup- Anleitung.
  • Um Ihre Variable SecureString einzugeben, verwenden Sie eine Aktivität, die Ihr Anmeldeinformationsasset ausgibt (siehe Beispiel unten).
• ClientId – Die automatisch generierte, eindeutige ID Ihrer Anwendungsregistry. Geben Sie eine String -Variable ein.
  • Die ClientID wird für Ihre ServiceNow-Instanz generiert, wenn Sie eine Anwendungsregistrierung ausfüllen. Weitere Informationen finden Sie im Abschnitt Einrichtung von OAuth der Einrichtungsanleitung .
  • Die ClientID ist dem ClientGeheimniszugeordnet. Es wird empfohlen, dass Sie eine String -Variable gemäß dem Abschnitt Anmeldeinformations-Assets erstellen der Einrichtungsanleitung generieren.
  • Um Ihre Variable String einzugeben, verwenden Sie eine Aktivität, die Ihr Anmeldeinformationsasset ausgibt (siehe Beispiel unten).
• Lokaler Port (optional) – Der lokale Port für die Umleitung. Der Standardwert ist 10001. Geben Sie einen String oder eine Variable String ein.
• OAuth 2.0 verwenden – Aktivieren Sie diese Option, um den OAuth2-Codezuweisungsablauf von ServiceNow zu verwenden.

Allgemein

• DisplayName - Der Anzeigename der Aktivität. Geben Sie eine String - oder String -Variable ein.

Verbindung (Connection)

• EndpointURL – Die URL Ihrer ServiceNow-Instanz. Geben Sie eine String - oder String -Variable ein. Die URL sollte sich auf Ihre ServiceNow-Instanz beziehen und nicht auf die Umleitungs-URL in Ihrer Anwendungsregistrierung.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Optionen

• ReportApiErrorAsException – Wenn diese Option ausgewählt ist, werden API-Fehlerantworten in BusinessActivityExecutionException von allen untergeordneten Aktivitäten gemeldet, die diesen Anwendungsbereich verwenden. Wenn diese Option deaktiviert ist, füllt die untergeordnete Aktivität die API-Fehlermeldung in der Ausgabeeigenschaft ResponseStatus aus und die Workflowausführung wird fortgesetzt. Überprüfen Sie die Eigenschaft ResponseStatus, um die erfolgreiche Ausführung zu bestätigen.

Ausgabe

• ServiceNowConnection – Ein Datensatz Ihrer hergestellten Verbindung, den Sie in nachfolgenden ServiceNow Application Scope -Aktivitäten verwenden können. Geben Sie eine IConnection -Variable ein (UiPath.BAF.Models.Connection.IConnection).

Vorhandene Verbindung verwenden

• ExistingServiceNowConnection – Ein Verbindungsdatensatz aus einer übergeordneten ServiceNow Application Scope -Aktivität, den Sie verwenden können, anstatt eine neue Verbindung herzustellen. Geben Sie eine IConnection -Variable ein (UiPath.BAF.Models.Connection.IConnection).
  • Die Variable IConnection muss aus einer zuvor ausgeführten ServiceiceNow Scope- Aktivität (übergeordnet) stammen, die noch über eine aktive Verbindung verfügt.
  • Wenn Sie mit dieser Eigenschaft keine Verbindung herstellen können, versuchen Sie, die übergeordnete Aktivität „ ServiceNow Application Scope “ erneut auszuführen.

Beispiel

Die folgende Abbildung zeigt ein Beispiel für die Aktivitätsabhängigkeitsbeziehung und Eingabe-/Ausgabe-Eigenschaftswerte.

Schritt-für-Schritt-Anweisungen und Beispiele finden Sie in der Schnellstartanleitung .

Tipps zur Standardauthentifizierung

Im ServiceNow-Aktivitätspaket kann die Standardauthentifizierung (Benutzername und Kennwort) zum Ausführen von Aktivitäten verwendet werden. Die Schritte sind im Folgenden beschrieben:

Entwurfszeit

Geben Sie zur Entwurfszeit den Benutzernamen und das Kennwort mit der Endpunkt-URL ein, und diese Details werden gespeichert. Beachten Sie, dass die Anmeldeinformationen nicht mit ServiceNow für die Standardauthentifizierung auf Scope-Ebene validiert werden. Erst zu einem späteren Zeitpunkt, wenn ServiceNow-Entitäten in einer einzelnen Aktivität oder zur Laufzeit während der Ausführung einer Aktivität abgerufen werden, werden diese grundlegenden Authentifizierungsanmeldeinformationen zur Authentifizierung verwendet.

Wenn die angegebenen Anmeldeinformationen für die Standardauthentifizierung falsch sind, wird beim Laden der Entitätsliste ein Fehler ausgegeben, da die gespeicherten Anmeldeinformationen für die Standardauthentifizierung verwendet werden, um eine Verbindung mit ServiceNow herzustellen und Entitäten-/Tabellennamen abzurufen.

Wenn die Anmeldeinformationen (Username, Password, EndpointUrl) korrekt sind, werden die Entitäten wie folgt im Dropdown-Menü der Aktivität ausgefüllt:

Laufzeit

Stellen Sie sicher, dass die Anmeldeinformationen im Eigenschaftenbereich auf der rechten Seite ausgefüllt werden.

Wenn die Anmeldeinformationen korrekt sind, wird die Aktivität ausgeführt. Wenn es falsch ist, wird zur Laufzeit ein Fehler ausgegeben, wie unten gezeigt: