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 zur Fehlerbehebung bei der Leistung von Importsätzen, finden Sie zu 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 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 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

Hinweis: Wenn Sie keine Liste von Eigenschaften für das ausgewählte Objekt sehen, auch wenn Sie 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 - 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.