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.

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 verwenden können (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äten Update 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 Upsert Records innerhalb der Aktivität ServiceNow Scope hinzu.
4. Klicken Sie auf die Schaltfläche Konfigurieren innerhalb der Aktivität Upsert Records (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 Batch – POST -API gesendet.
   • Die API gibt die Werte DataTable und ResponseStatus an Ihre Ausgabeeigenschaftsvariablen zurück.
     
     

     

     
     

Konfigurieren

Um Ihr Objekt auszuwählen, müssen Sie den Objekt-Assistenten verwenden, indem Sie auf die Schaltfläche Konfigurieren klicken.

Weitere Informationen zum Objekt-Assistenten finden Sie auf der Seite Frameworks für Geschäftsaktivitäten .

• Objekt – Der Typ des Datensatzes, den Sie einfügen oder aktualisieren möchten. Dies wird festgelegt und im Entwurfszeit-Zeichenbereich angezeigt, jedoch nicht im Eigenschaftenbereich. Verwenden Sie den Objektassistenten , um Ihr Objekt auszuwählen.

Eigenschaften

Hinweis: Wenn Sie keine Liste von Eigenschaften für das 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 Behebung von Berechtigungsproblemen.

Allgemein

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

Eingabe

• DataTable - Die Datensatzdaten, die Sie einfügen oder aktualisieren möchten. Geben Sie eine DataTable -Variable ein.
  • Um einen vorhandenen Datensatz zu aktualisieren, fügen Sie den Wert sys_Id der Datenzeile hinzu, die die Aktualisierungen enthält, die Sie vornehmen möchten.
  • Datenzeilen ohne sys_id- Wert werden als neue Datensätze eingefügt (die sys_id des neuen Datensatzes wird im Results DataTable -Objekt zurückgegeben).
  • Die maximale Anzahl der Datensätze, die Sie pro Aktivitätsausführung aktualisieren oder einfügen können, beträgt 200. Wenn Sie mehr als 200 Datensätze einfügen/aktualisieren möchten, können Sie eine for-Schleife hinzufügen 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 Sekunden 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 – 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.
• Ergebnis – Das Ergebnis der eingefügten oder aktualisierten Datensätze. Die Ergebnisse DataTable haben die gleiche Struktur wie die Eingabe- DataTable, mit den folgenden Ausnahmen:
  • Neue Datensätze, die erfolgreich eingefügt wurden, enthalten jetzt einen sys_id- Wert.
  • Eine neue Spalte „ActionType“ wird angefügt und enthält den Wert „ Add “ oder „ Update “, um anzugeben, ob ein Datensatz aktualisiert oder der Tabelle hinzugefügt wurde.
  • Eine neue Spalte „Fehler“ wird angefügt und enthält Fehlerinformationen, wenn der Vorgang fehlgeschlagen ist.