Insert ImportSet Records

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 Datensätze einzufügen.

Nach Abschluss des Vorgangs gibt die Aktivität das Ergebnis der Einfügung in einem DataTable -Objekt (Result) und den Vorgangsstatus (Erfolgs-/Fehlerinformationen) in einem ResponseStatus -Objekt (ServiceNowStatus) aus, das Sie in nachfolgenden Aktivitäten ( z. B. bedingte Logik).

Tipp:

Dieses Aktivitätenpaket bietet vier verschiedene Methoden zum Aktualisieren und/oder Einfügen eines Datensatzes: Update ServiceNow Record, Insert ServiceNow Record, Upsert Recordsoder Insert ImportSet Records.

Die AktivitätenUpdate ServiceNow Record, Insert ServiceNow Recordund Upsert Records verwenden REST-APIs, um direkt in eine Produktionstabelle zu schreiben. Die Aktivität Insert ImportSet Records verwendet die REST-Importsatz-API, um in eine Importsatztabelle zu schreiben, aus der die Daten in die Zielproduktionstabelle umgewandelt werden.

Um zu vermeiden, dass direkt in Produktionstabellen geschrieben wird, wird empfohlen, die Aktivität Insert ImportSet Records zu verwenden, um einen neuen Datensatz zu aktualisieren oder einzufügen.

Ausführliche Informationen, einschließlich der Fehlerbehebung bei der Leistung von Importsätzen, finden Sie in 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. Fügen Sie die Aktivität Insert ImportSet Records innerhalb der Aktivität ServiceNow Scope hinzu.
4. Klicken Sie auf die Schaltfläche Konfigurieren in der Aktivität ImportSet-Datensätze einfügen (dadurch wird der Objekt-Assistentgeöffnet).
5. Wählen Sie das Objekt aus, das Sie für Ihren Importsatz verwenden möchten, und geben Sie Ihre Eingabeeigenschaften ein.
6. Erstellen Sie eine DataTable -Variable und eine ResponseStatus -Variable für die Ausgabeeigenschaften, und geben Sie sie ein.
   • Ihre Eingabeeigenschaftswerte werden an den Importsatz – GET API gesendet.
   • Die API gibt die Werte von DataTable and ResponseStatus an Ihre Ausgabeeigenschaftsvariablen zurück.
     
     

     

     
     

Im Textkörper der Aktivität

Um Ihren Importsatz auszuwählen, müssen Sie den Objektassistenten verwenden, indem Sie auf die Schaltfläche Konfigurieren klicken.

• Object – Der Importsatz, den Sie verwenden möchten. Verwenden Sie den Objektassistenten , um Ihren Importsatz auszuwählen. Die Dropdownliste Objekt-Assistent enthält die Importsätze, die Sie in Ihrer ServiceNow-Anwendung haben.

Eigenschaften

Note: If you do not see a list of properties for the object you choose, even looking at the "Add Multiple Fields" option, you may not have sufficient permissions in ServiceNow to see object meta data and modify data. Please see Troubleshooting for more details.

Allgemein

• DisplayName - Der Anzeigename der Aktivität. Geben Sie eine String - oder String -Variable ein.

Eingabe

• DataTable - Die Daten, die Sie einfügen möchten. Geben Sie eine DataTable -Variable ein.

Sonstiges

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

Ausgabe

• Ergebnis - Die Ergebnisdaten der Einfügung. Geben Sie eine DataTable -Variable ein.
• Status – 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.