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.

After retrieving the record, the activity outputs the status of the request (success/failure information) in a ResponseStatus object (ServiceNowStatus) that you can use in subsequent activities (e.g., conditional logic).

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 Daten short_description undcontact_type ausgeben, indem Sie die Felder (mit Variablen) im Objektassistenten 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. Add the Get ServiceNow Record activity inside the ServiceNow Scope activity.
4. Click the Configure button inside the Get ServiceNow Record activity (this opens the Object Wizard).
5. Select the Object that you want to retrieve and enter, at a minimum, the sys_id of the record.
6. Erstellen und geben Sie eine ResponseStatus -Variable für die Output- Eigenschaft 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

To enter your Get ServiceNow Record property values, you must use the Object Wizard by clicking the Configure button.

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

• sys_id - The id of the ServiceNow record that you want to retrieve. Enter a String or String variable.
  • Um den Wert sys_id abzurufen, können Sie einer der Methoden folgen, die in der Dokumentation zur eindeutigen Datensatzkennung (sys_id) von ServiceNow gezeigt werden, oder Sie klicken mit der rechten Maustaste auf den Datensatz in der ServiceNow-Benutzeroberfläche und wählen im Popup-Menü die Option sys_id kopieren aus.

Eigenschaften

Hinweis:

Wenn Sie keine Liste mit Eigenschaften für das von Ihnen ausgewählte Objekt sehen, auch wenn Sie sich die Option „Mehrere Felder hinzufügen“ ansehen, haben Sie möglicherweise keine ausreichenden Berechtigungen in ServiceNow, um Objektmetadaten anzuzeigen und Daten zu ändern. Weitere Informationen finden Sie unter Fehlerbehebung bei Berechtigungsproblemen .

Erweitert (Advanced)

• AdditionalFields - A DataRow that includes the columns and values that you want to retrieve. The column names must match the names as they appear in the ServiceNow database table for the selected object type.

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 - The status of the request (success/failure information). Enter a ResponseStatus variable (UiPath.BAF.Models.ResponseStatus). The ResponseStatus object includes three properties that you can use in other activities.
  • Success - Boolean - Specifies whether the API request was successful.
  • ErrorCode - String - The response error if the API request is unsuccessful (Success=False).
  • Message - String - The error message.

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 .