Update Record

UiPath.MicrosoftDynamics.Activities.UpdateRecord

Die Aktivität Update Record verwendet den Web API PATCH- Vorgang, um einen Datensatz zu aktualisieren.

Nach der Aktualisierung des Datensatzes gibt die Aktivität den Status der Anforderung (Erfolgs-/Fehlerinformationen) in einem ResponseStatus -Objekt (MicrosoftDynamicsStatus) aus, das Sie in nachfolgenden Aktivitäten (z. B. bedingte Logik) verwenden können.

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 Microsoft Dynamics Application Scope zu Ihrem Projekt hinzu.
3. Fügen Sie eine Aktivität hinzu, oder führen Sie einen externen Prozess aus, der den Datensatzbezeichner ausgibt (z. B. Insert Record, Search Records).
4. Fügen Sie die Aktivität Datensatz aktualisieren innerhalb der Aktivität Microsoft Dynamics-Anwendungsbereich hinzu .
5. Klicken Sie auf die Schaltfläche Konfigurieren in der Aktivität Datensatz aktualisieren (dadurch wird der Objekt-Assistentgeöffnet).
6. Wählen Sie das Objekt aus, das Sie aktualisieren möchten, geben Sie die Datensatz-ID ein und fügen Sie die Felder (mit Werten) hinzu, die Sie aktualisieren möchten.
7. Erstellen und geben Sie eine ResponseStatus -Variable für die Ausgabeeigenschaft ein.
   • Ihre Eingabeeigenschaftswerte werden in der PATCH- Vorgangsanforderung gesendet.
   • Die Operation gibt ResponseStatus und den Wert an Ihre Ausgabeeigenschaftsvariable zurück.
     
     

     

     
     

Eigenschaften

Die Werte für die folgenden Eigenschaften werden beim Hinzufügen dieser Aktivität zu Ihrem Projekt in UiPath Studio angegeben.

Konfigurieren

Um Ihre Eigenschaftswerte für Datensatz aktualisieren einzugeben, müssen Sie den Objekt-Assistenten verwenden, indem Sie auf die Schaltfläche Konfigurieren klicken.

Wenn Sie ein Objekt mit dem Objekt-Assistenten auswählen, können Sie die Felder hinzufügen, die Sie aktualisieren 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 – Ein DataRow , das die Spalten und Werte enthält, die Sie einfügen möchten. Geben Sie eine DataRow -Variable ein.
  • Um Ihre DataRow -Spaltennamen zu bestimmen/zu validieren, klicken Sie auf die Schaltfläche Konfigurieren , wählen Sie Ihr Objektaus und überprüfen Sie die in der Spalte Feld angezeigten Namen. Ihre DataRow -Spaltennamen müssen mit dem angezeigten Wert übereinstimmen.
  • Wenn Sie einen Wert für ein Feld sowohl im Object Wizard als auch in der AdditionalFields -Eigenschaft eingeben, hat der im Object Wizard eingegebene Wert Vorrang (der AdditionalFields -Wert wird überschrieben).

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

Beispiel

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

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 .