Datensatz einfügen

UiPath.MicrosoftDynamics.Activities.InsertRecord

Die Aktivität Insert Record verwendet den Web API POST- Vorgang, um einen neuen Datensatz einzufügen.

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

Wenn die Anforderung erfolgreich ist, gibt die Aktivität den String -Bezeichner zurück, der dem neuen Datensatz zugewiesen ist. Wenn Sie beispielsweise einen Account einfügen möchten, können Sie den AccountId- Wert ausgeben, indem Sie eine String -Variable über die Konfigurationsschaltfläche hinzufügen (siehe Beispiel unten).

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 Ihrem Projekt die Aktivität Microsoft Dynamics Application Scope hinzu.
3. Add the Insert Record activity inside the Microsoft Dynamics Application Scope activity.
4. Click the Configure button inside the Insert Record activity (this opens the Object Wizard).
5. Select the Object you want to insert and add the fields (with values) that you want to populate.
6. Erstellen und geben Sie eine ResponseStatus -Variable für die Output- Eigenschaft ein.

   • Ihre Eingabeeigenschaftswerte werden in der POST- Vorgangsanforderung gesendet.

   • Die Operation gibt den String -Bezeichner und die ResponseStatus -Werte an Ihre Ausgabeeigenschaftsvariablen zurück.

     

Konfigurieren

To enter your Insert Record property values, you must use the Object Wizard by clicking the Configure button.

Wenn Sie mit dem Objekt-Assistenten ein Objekt auswählen, können Sie die Felder hinzufügen, die Sie in den neuen Datensatz aufnehmen möchten. Eine vollständige Liste der verfügbaren Felder für jedes Objekt finden Sie in der Web API EntityType-Referenz in der Microsoft-Dokumentation.

Eigenschaften

Erweitert (Advanced)

• AdditionalFields - A DataRow that includes the columns and values that you want to insert. Enter a DataRow variable.
  • To determine/validate your DataRow column names, click the Configure button, select your Object, and review the names shown in the Field column; your DataRow column names must match the shown value.
  • If you enter a value for a field in both the Object Wizard and the AdditionalFields property, the value entered in the Object Wizard takes precedent (overwriting the AdditionalFields value).

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

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