Get ServiceNow Record

UiPath.ServiceNow.Activities.GetRecord

Die Aktivität Get ServiceNow Record verwendet die ServiceNow Table - GET{sys_id} API, um einen bestimmten Datensatz (sys_id) abzurufen.

Nach dem Abrufen des Datensatzes gibt die Aktivität den Status der Anforderung (Erfolgs-/Fehlerinformationen) in einem ResponseStatus -Objekt (ServiceNowStatus) aus, das Sie in nachfolgenden Aktivitäten (z. B. bedingte Logik) verwenden können.

Diese Aktivität gibt auch die Felddaten zurück, die der sys_id zugeordnet sind. Wenn Sie beispielsweise ein ServiceNow- Vorfallobjekt abrufen möchten, können Sie die short_description- und contact_type -Daten ausgeben, indem Sie die Felder (mit Variablen) im Objekt-Assistenten hinzufügen (siehe Beispiel unten).

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.

Schließen Sie die Einrichtungsschritte ab.
Fügen Sie die Aktivität ServiceNow Scope zu Ihrem Projekt hinzu.
Fügen Sie die Aktivität „ Get ServiceNow Record “ innerhalb der Aktivität „ServiceNow Scope “ hinzu.
Klicken Sie auf die Schaltfläche Konfigurieren in der Aktivität „ Get ServiceNow Record “ (dadurch wird der Objekt-Assistentgeöffnet).
Wählen Sie das Objekt aus, das Sie abrufen möchten, und geben Sie mindestens die sys_id des Datensatzes ein.
Erstellen und geben Sie eine ResponseStatus -Variable für die Ausgabeeigenschaft ein.
- Ihre Eingabeeigenschaftswerte werden an die Tabelle – GET{sys_id} API gesendet.
- Die API gibt den Wert ResponseStatus an Ihre Ausgabeeigenschaftsvariable zurück.

Im Textkörper der Aktivität

Um Ihre Get ServiceNow Record -Eigenschaftswerte einzugeben, müssen Sie den Objekt-Assistenten verwenden, indem Sie auf die Schaltfläche Konfigurieren klicken.

Weitere Informationen zum Objekt-Assistenten finden Sie auf der Seite Frameworks für Geschäftsaktivitäten .

sys_id - Die ID des ServiceNow-Datensatzes, den Sie abrufen möchten. Geben Sie eine String - oder String -Variable ein.
- Um den sys_id- Wert abzurufen, können Sie einer der Methoden folgen, die in der Dokumentation zum eindeutigen Datensatzbezeichner (sys_id) von ServiceNow gezeigt werden, oder klicken Sie mit der rechten Maustaste auf den Datensatz in der ServiceNow-Benutzeroberfläche, und wählen Sie im Popup-Menü die Option sys_id kopieren aus.

Eigenschaften

Hinweis: Wenn Sie die Liste der Eigenschaften für das ausgewählte Objekt nicht sehen, auch wenn Sie die Option „Mehrere Felder hinzufügen“ verwenden, haben Sie möglicherweise keine ausreichenden Berechtigungen in ServiceNow, um Objektmetadaten anzuzeigen und Daten zu ändern. Weitere Informationen finden Sie unter Beheben von Berechtigungsproblemen.

Erweitert (Advanced)

AdditionalFields – Ein DataRow , das die Spalten und Werte enthält, die Sie abrufen möchten. Die Spaltennamen müssen mit den Namen übereinstimmen, die in der ServiceNow-Datenbanktabelle für den ausgewählten Objekttyp angezeigt werden.

Allgemein

AnzeigeName (DisplayName) - Der Anzeigename der Aktivität. Dieses Feld unterstützt nur Strings- oder String-Variablen.

Sonstiges

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

Ausgabe

ServiceNowStatus – Der Status der Anforderung (Erfolgs-/Fehlerinformationen). Geben Sie eine ResponseStatus -Variable ein (UiPath.BAF.Models.ResponseStatus). Das ResponseStatus -Objekt enthält drei Eigenschaften, die Sie in anderen Aktivitäten verwenden können.
- Success – Boolean – Gibt an, ob die API-Anforderung erfolgreich war.
- ErrorCode – String – Der Antwortfehler, wenn die API-Anforderung nicht erfolgreich ist (Success=False).
- Message – String – Die Fehlermeldung.