Get ServiceNow Record

UiPath.ServiceNow.Activities.GetRecord

Die Aktivität „ Get ServiceNow Record “ verwendet die API „ServiceNow Table – GET{sys_id}“ , 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.

1. Schließen Sie die Einrichtungsschritte ab.
2. Fügen Sie die Aktivität ServiceNow Scope zu Ihrem Projekt hinzu.
3. Fügen Sie die Aktivität „ Get ServiceNow Record “ innerhalb der Aktivität „ServiceNow Scope “ hinzu.
4. Klicken Sie auf die Schaltfläche Konfigurieren in der Aktivität „ Get ServiceNow Record “ (dadurch wird der Objekt-Assistentgeöffnet).
5. Wählen Sie das Objekt aus, das Sie abrufen möchten, und geben Sie mindestens die sys_id des Datensatzes ein.
6. Erstellen und geben Sie eine ResponseStatus -Variable für die Ausgabeeigenschaft ein.
   • Ihre Eingabeeigenschaftswerte werden an die API „Table – GET{sys_id}“ 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 Objektassistentenfinden Sie auf der Seite Business Activity Frameworks .

• 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 eine der Methoden befolgen, die in der ServiceNow-Dokumentation zur eindeutigen Datensatz-ID (sys_id) gezeigt werden, oder mit der rechten Maustaste auf den Datensatz in der ServiceNow-Benutzeroberfläche klicken und die Option sys_id kopieren im Popoutmenü auswählen.

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.

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 .