Datensätze durchsuchen

UiPath.MicrosoftDynamics.Activities.SearchRecords

Mithilfe Ihrer Suchparameter (QueryOptions und Object) verwendet die Aktivität Search Records die Web API-Operation GET , um Datensätze abzurufen.

Nach dem Abrufen der Datensätze gibt die Aktivität die Ergebnisse in einem DataTable -Objekt (Result) und den Status der Anforderung (Erfolgs-/Fehlerinformationen) in einem ResponseStatus -Objekt (MicrosoftDynamicsStatus) aus, die Sie beide in nachfolgenden Aktivitäten verwenden können (z. B. bedingte Logik, Update Record, Download Activity Attachmentusw.).

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 die Aktivität Datensätze suchen innerhalb der Aktivität Microsoft Dynamics-Anwendungsbereich hinzu .
4. Wählen Sie das Objekt aus, das Sie abrufen möchten, und geben Sie Ihre Suchparameter in der Eigenschaft Optionen ein.
5. Erstellen und geben Sie eine DataTable und eine ResponseStatus -Variable für die Ausgabeeigenschaften ein.
   • Ihre Eingabeeigenschaftswerte werden in der GET -Vorgangsanforderung gesendet.
   • Die Operation gibt die Werte DataTable und ResponseStatus an Ihre Ausgabeeigenschaftsvariablen zurück.
     
     

     

     
     

Im Textkörper der Aktivität

• Objekt – Wählen Sie ein Objekt mit dem Objekt-Assistenten aus.

Eigenschaften

Allgemein

• DisplayName - Der Anzeigename der Aktivität. Dieses Feld unterstützt nur Zeichenfolgen oder String -Variablen.

Sonstiges

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

Optionen

• Abfrageoptionen – Die Suchparameter, die Sie zum Abrufen Ihrer Datensätze verwenden möchten. Geben Sie eine Dictionary<String, String> - oder Dictionary<String, String> -Variable ein. Weitere Informationen zu Abfragewerten finden Sie auf den Seiten Abfragemetadaten bzw. Abfragedaten in der Microsoft-Dokumentation. Eine Möglichkeit zum Erstellen und Ausfüllen einer Dictionary<String, String> -Variablen finden Sie in den folgenden Schritten.
  Hinweis:

  Das Folgende ist eine Möglichkeit, eine Dictionary<String, String> -Variable aufzufüllen:

  • Installieren Sie das Microsoft.Activities.Extensions -Paket.
  • Erstellen Sie eine neue Dictionary<String, String> -Variable (z. B. queryOption).
  • Fügen Sie eine Aktivität „ Zum Wörterbuch hinzufügen“ hinzu.
  • Geben Sie Ihre Wörterbuchvariable ein (z. B. queryOption)
  • Geben Sie eine einzelne Abfragemethode in die Key -Eigenschaft ein (z. B. „$filter“, „$select“ usw.).

  • Geben Sie den Wert ein, der auf die Abfragemethode angewendet werden soll (z. B. „name eq 'Quickstart_Account'“).

    • Wiederholen Sie Schritt 3, um zusätzliche QueryOptions anzuwenden.

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.
• Ergebnis – Die Datensätze, die Ihren Suchparametern entsprechen. Geben Sie eine DataTable -Variable ein.

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 .