ServiceNow-Datensatz einfügen

UiPath.ServiceNow.Activities.InsertRecord

Die Aktivität Insert ServiceNow Record verwendet die ServiceNow Table – POST- API, um ein neues Datensatzobjekt einzufügen.

After inserting the record, the activity outputs the status of the request (success/failure information) in a ResponseStatus object (ServiceNowStatus) that you can use in subsequent activities (e.g., conditional logic).

Diese Aktivität gibt auch den sys_id- Wert des neuen Datensatzobjekts zurück. Wenn Sie beispielsweise ein ServiceNow- Vorfallobjekt einfügen möchten, können Sie den sys_id- Wert ausgeben, indem Sie eine String -Variable im Objektassistenten hinzufügen (siehe Beispiel unten).

Tipp:

Dieses Aktivitätenpaket bietet drei verschiedene Methoden zum Einfügen eines Datensatzes: ServiceNow-Datensatz einfügen,Upsert Records oder ImportSet Records einfügen. Die AktivitätenInsert 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 das direkte Einfügen von Datensätzen in Produktionstabellen zu vermeiden, wird empfohlen, dass Sie die Aktivität Upsert ServiceNow Record verwenden, um einen neuen Datensatz einzufügen. Ausführliche Informationen, einschließlich der Fehlerbehebung bei der Leistung von Importsätzen, finden Sie unter Importsätze 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 ServiceNow Record activity inside the ServiceNow Scope activity.
4. Click the Configure button inside the Insert ServiceNow Record activity (this opens the Object Wizard).
5. Select the Object you want to insert and add the fields (with values) you want to populate.
6. Erstellen und geben Sie die Variable ResponseStatus für die Output- Eigenschaft ein.

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

   • Die API gibt den Wert ResponseStatus an Ihre Ausgabeeigenschaftsvariable zurück.

     

Im Textkörper der Aktivität

To enter your Insert ServiceNow Record property values, 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 .

• sys_id - The id of the ServiceNow record that gets created. Enter a String variable. The sys_id is auto-generated by ServiceNow when you insert your new record. To retrieve this value for use in other activities, create and enter a String variable in the object wizard (example shown below).

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 .

Erweitert (Advanced)

• AdditionalFields - A DataRow that includes the columns and values that you want to insert. The column names must match the names as they appear in the ServiceNow database table for the selected object type.

Allgemein

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

Sonstiges

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

Ausgabe

• ServiceNowStatus - 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.

Beispiel

Die folgende Abbildung zeigt ein Beispiel für die Aktivitätsabhängigkeitsbeziehung und Eingabe-/Ausgabe-Eigenschaftswerte.

Schritt-für-Schritt-Anweisungen und Beispiele finden Sie in der Schnellstartanleitung .