Update ServiceNow Record

Aktivität zum Aktualisieren eines bestimmten ServiceNow-Datensatzes durch sys_id mithilfe der Table PUT-API

UiPath.ServiceNow.Activities.UpdateRecord

Die Aktivität Update ServiceNow Record verwendet die ServiceNow Table – PUT- API, um einen bestimmten Datensatz (sys_id) zu aktualisieren.

After updating 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).

Tipp:

Dieses Aktivitätenpaket bietet drei verschiedene Methoden zum Aktualisieren eines Datensatzes: Update ServiceNow Record,Upsert Records oder Insert ImportSet Records. Die AktivitätenUpdate ServiceNow Record und Upsert Records verwenden REST-APIs, um direkt in eine Produktionstabelle zu schreiben. Die Aktivität Insert ImportSet Records verwendet die REST Import Set-API, um in eine Importsatztabelle zu schreiben, aus der die Daten in die Zielproduktionstabelle umgewandelt werden. Um die direkte Aktualisierung von Datensätzen in Produktionstabellen zu vermeiden, wird empfohlen, dass Sie die Aktivität Insert ImportSet Records verwenden, um einen neuen Datensatz zu aktualisieren. Ausführliche Informationen, einschließlich der Fehlerbehebung bei der Leistung von Importsätzen, finden Sie unter Importsätze in der ServiceNow-Dokumentation. Weitere Informationen zur Verwendung von Importsätzen finden Sie unter Webdienst-Importsatz und Importieren von Daten mithilfe von Importsätzen 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 die Aktivität ServiceNow Scope zu Ihrem Projekt hinzu.
3. Add the Update ServiceNow Record activity inside the ServiceNow Scope activity.
4. Click the Configure button inside the Update ServiceNow Record activity (this opens the Object Wizard).
5. Select the Object that you want to update and enter, at a minimum, the sys_id of the record.
6. Erstellen und geben Sie die Variable ResponseStatus für die Output-Eigenschaft ein.
   • Ihre Eingabeeigenschaftswerte werden an die Tabelle – PUT -API gesendet.
   • Die API gibt den Wert ResponseStatus an Ihre Ausgabeeigenschaftsvariable zurück.

Im Textkörper der Aktivität

To enter your Update 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 – Die ID des ServiceNow-Datensatzes, den Sie aktualisieren möchten. 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 update. 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 .