Insert ImportSet Records

Aktivität zum Einfügen neuer Datensätze oder zum Aktualisieren vorhandener in einer ServiceNow-Importsatztabelle mithilfe der Import Set-API

UiPath.ServiceNow.Activities.InsertImportSetRecords

Die Aktivität Insert ImportSet Records verwendet die ServiceNow Import Set – GET API, um vorhandene Datensätze zu aktualisieren oder neue 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 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ätenUpdate 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 Insert ImportSet Records activity inside the ServiceNow Scope activity.
4. Click the Configure button inside the Insert ImportSet 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 Import Set – GET API gesendet.

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

     

Im Textkörper der Aktivität

To select your import set, you must use the Object Wizard by clicking the Configure button.

• Object - The import set that you want to use. Use the Object Wizard to select your Import Set. The Object Wizard drop-down list includes the import sets that you have in your ServiceNow application.

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 .

Allgemein

• DisplayName - The display name of the activity. Enter a String or String variable.

Eingabe

• DataTable - The data that you want to insert. Enter a DataTable variable.

Sonstiges

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

Ausgabe

• Result - The result data of the insert. Enter a DataTable variable.
• 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.