Upsert Records

UiPath.ServiceNow.Activities.UpsertRecords

Die Aktivität Upsert Records verwendet die ServiceNow Batch – POST API, um einen oder mehrere Datensätze zu aktualisieren oder einzufügen.

After completing the operation, the activity outputs the result of the insert in a DataTable object (Result) and the operation status (success/failure information) in a ResponseStatus object (ServiceNowStatus) that you can use in subsequent activities (e.g., conditional logic).

Tipp:

Dieses Aktivitätenpaket bietet vier verschiedene Methoden zum Aktualisieren und/oder Einfügen eines Datensatzes: Update ServiceNow Record, Insert ServiceNow Record, Upsert Records oder Insert ImportSet Records. Die Aktivitäten Update ServiceNow Record, Insert 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 zu vermeiden, dass direkt in Produktionstabellen geschrieben werden, wird empfohlen, dass Sie die Aktivität Insert ImportSet Records verwenden, um einen neuen Datensatz zu aktualisieren oder einzufügen. Ausführliche Informationen, einschließlich der Fehlerbehebung bei der Importsatzleistung, finden Sie unter den Importsätzen 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 Upsert Records activity inside the ServiceNow Scope activity.
4. Click the Configure button inside the Upsert Records activity (this opens the Object Wizard).
5. Wählen Sie das Objekt aus, das Sie für Ihren Importsatz verwenden möchten, und geben Sie Ihre Eingabeeigenschaften ein.
6. Erstellen und geben Sie eine DataTable -Variable und eine ResponseStatus -Variable für die Ausgabeeigenschaften ein.

   • Ihre Eingabeeigenschaftswerte werden an die Batch – POST- API gesendet.

   • Die API gibt die Werte DataTable und ResponseStatus an Ihre Ausgabeeigenschaftsvariablen zurück.

     

Konfigurieren

To select your object, 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 .

• Object - The type of record that you want to insert or update. This will be set and appear in the design-time canvas but not the property panel. Use the Object Wizard to select your object.

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 .

Allgemein

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

Eingabe

• DataTable - The record data that you want to insert or update. Enter a DataTable variable.
  • To update an existing record, add the sys_Id value to the data row that contains the updates you want to make.
  • Data rows without a sys_id value are inserted as new records (the sys_id of the new record is returned in the Results DataTable object).
  • Die maximale Anzahl der Datensätze, die Sie pro Aktivitätsausführung aktualisieren oder einfügen können, ist 200. Wenn Sie mehr als 200 Datensätze einfügen/aktualisieren möchten, können Sie eine for-Schleife oder eine Upsert-Aktivität für jedes DataTable hinzufügen, das 200 Datensätze enthält (z. B. wenn Sie insgesamt 4.000 Datensätze haben, können Sie die Datensätze in 20 separate Datensätze aufteilen Aktivitäten). Weitere Informationen finden Sie unter Batch-API in der ServiceNow-Dokumentation.

Sonstiges

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

Ausgabe

• Status - 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.
• Result - The result of the inserted or updated record(s). The Results DataTable has the same structure as the input DataTable, with the following exceptions:
  • New records that were inserted successfully now include a sys_id value.
  • A new "ActionType" column is appended and includes a value of either Add or Update to indicate whether a record was updated or added to the table.
  • Eine neue Spalte „Fehler“ wird angefügt und enthält Fehlerinformationen, wenn der Vorgang fehlgeschlagen ist.