Schnellstart – Datensätze

Überblick

Der Zweck dieses Handbuchs besteht darin, Sie beim Erstellen eines funktionierenden Beispiels zu unterstützen, das die folgenden Microsoft Dynamics 365-Aktivitäten verwendet:

• Datensatz einfügen
• Datensätze durchsuchen
• Datensatz abrufen
• Delete Record

Mit diesem Arbeitsbeispiel können Sie die Verbindung zu Ihrer Microsoft Dynamics 365-Anwendung schnell überprüfen und sich mit den Eingabe-/Ausgabedatentypen der Aktivität vertraut machen.

Nachdem Sie die Schritte in dieser Anleitung ausgeführt haben, verfügen Sie über eine Automatisierungs-Sequence, die Folgendes ausführt:

1. Stellt eine Verbindung mit Ihrer Microsoft Dynamics 365-Anwendung (Get Credential und Microsoft Dynamics Application Scope) her.
2. Fügt einen neuen Kontodatensatz ein (Insert Record).
3. Sucht nach dem eingefügten Kontodatensatz (Datensätze suchen).
4. Aktualisiert das Website-Feld des Kontodatensatzes (Update Record).
5. Überprüft, ob der Kontodatensatz erfolgreich aktualisiert wurde (Get Record).

6. Löscht den eingefügten Kontodatensatz ( Datensatzlöschen ).

   Hinweis: Obwohl es möglicherweise effizientere Möglichkeiten gibt, dasselbe Ergebnis zu erzielen, besteht das Ziel dieser Sequenz darin, alle Aufzeichnungsaktivitäten zu demonstrieren.

Voraussetzungen

Bevor Sie beginnen:

1. Schließen Sie die Schritte zum Einrichten von Microsoft Dynamics 365 ab.

2. Verwenden Sie den Paket-Manager , um das Microsoft.Activities.Extensions -Paket zu installieren (dies ist für die Aktivität Datensätze suchen ).

   Hinweis: In diesem Handbuch wird ClientCredentials als Authentifizierungstyp in der Aktivität Microsoft Dynamics Application Scope verwendet. Wenn Sie PasswordCredentialsbevorzugen, können Sie Schritt 1 überspringen (eine Get Credential -Aktivität hinzufügen) und die aufgezählten Unterschritte in Schritt 2 ausführen (die Aktivität Microsoft Dynamics Application Scope hinzufügen).

Schritte

Erstellen Sie Ihr Projekt

1. Fügen Sie eine Aktivität Get Credential hinzu .
2. Geben Sie den AssetName für das Anmeldeinformations-Asset ein, das Sie (während des Setups) für das Client-Geheimnis der Anwendung erstellt haben (z. B. „MicrosoftDynamics365ClientCredentials“).
3. Erstellen Sie eine SecureString -Variable für die Eigenschaft Password (z. B. clientSecret), und geben Sie sie ein.
4. Erstellen Sie eine String -Variable für die Eigenschaft Benutzername (z. B. clientId), und geben Sie sie ein.
5. Fügen Sie die Aktivität Microsoft Dynamics 365 Application Scope nach der Aktivität Get Credential hinzu .

6. Klicken Sie auf die Schaltfläche Konfigurieren (dadurch wird der Verbindungsassistentgeöffnet), wählen Sie Ihren AuthenticationTypeaus, geben Sie Ihre Anmeldeinformationen ein und klicken Sie auf die Schaltfläche Verbindung testen . Weitere Informationen zu Zweck und Verhalten dieses Assistenten finden Sie im Abschnitt.

   • Dieser Schritt dient nur zu Entwurfszeitzwecken. Um die Eigenschaften des Microsoft Dynamics-Anwendungsbereichs auszufüllen , führen Sie die folgenden Schritte aus.

7. Wählen Sie in der Eigenschaft AuthenticationType Ihren bevorzugten Authentifizierungstyp aus.

   • Wenn Sie PasswordCredentialsauswählen, erstellen Sie eine String -Variable für die ClientId (z. B. Name: clientId Standard: „56X9aXXX-b5d9-4a90-XXXX-13XX9643XXXX“)
8. Geben Sie in der Eigenschaft ClientId die Variable String ein, die Sie für die Aktivität „ Get Credential “ oder den Unterschritt oben erstellt haben (z. B. clientId).
9. Geben Sie in der Eigenschaft ClientSecret die Variable SecureString ein, die Sie für die Aktivität „ Get Credential “ erstellt haben (z. B. clientSecret).
   • Wenn Sie PasswordCredentials ausgewählt haben, lassen Sie die ClientSecret- Eigenschaft leer.
10. Erstellen Sie in der Eigenschaft EndpointUrl eine String -Variable mit der URL der CRM-Instanz, mit der Sie eine Verbindung herstellen möchten, und geben Sie sie ein (z. B. Name: endpointURL Standard: „https://uipath.crm4.dynamics.com/“ )
11. Erstellen und geben Sie in der Eigenschaft TenantId eine String -Variable für die Verzeichnis-ID (Mandant) ein, die Ihrem Azure Active Directory-Mandanten (ADD) zugewiesen ist (z. B. Name: TenantId Standard: „d8353d2a-b153-4d17-8827-902cXXXXXXX“) .

    • Wenn Sie PasswordCredentialsausgewählt haben, wählen Sie Ihre Einstellung für die Kennworteingabeaufforderung (Optionen) aus.

      
      

      

      
      

12. Fügen Sie die Aktivität Insert Record innerhalb der Aktivität Microsoft Dynamics Application Scope hinzu.

    1. Klicken Sie auf die Schaltfläche Konfigurieren innerhalb der Aktivität Datensatz einfügen (dadurch wird der Objekt-Assistentgeöffnet).

       1. Wählen Sie in der Dropdownliste Entität auswählen die Option Kontoaus.
       2. Erstellen Sie im Feld accountId eine String -Variable (z. B. accountId), und geben Sie sie ein.
       3. Geben Sie im Textfeld Einzelnes Feld hinzufügen einen Namen ein, und klicken Sie auf die Eingabetaste.
       4. Geben Sie im Namensfeld einen Kontonamen ein (z. B. „Quickstart_Account“).

       5. Klicken Sie auf die Schaltfläche Fertig .

          
          

          

          
          
    2. Fügen Sie nach der Aktivität „ Datensatz einfügen“ eine Aktivität „ Zum Wörterbuch hinzufügen“ hinzu.
    3. Erstellen Sie in der Eigenschaft Dictionary eine Dictionary<String,String> -Variable, und geben Sie sie entsprechend ein: Name: queryOption, Default: new Dictionary(Of String, String) (Sie können einen anderen Name -Wert verwenden, aber der Standardwert ist erforderlich).
    4. Geben Sie in der Eigenschaft „ Schlüssel “ „$filter“ein.

    5. Geben Sie in der Eigenschaft Wert „name eq 'Quickstart_Account'“ ein (Quickstart_Account ist der Name des Kontos, das Sie in den obigen Schritten eingefügt haben. Wenn Sie einen anderen Namen eingegeben haben, verwenden Sie stattdessen diesen Wert).

       • Weitere Informationen zu Abfragewerten finden Sie auf den Seiten mit Abfragemetadaten und/oder Abfragedaten in der Microsoft-Dokumentation.
    6. Fügen Sie die Aktivität Search Records nach der Aktivität Add to Dictionary hinzu.
    7. Wählen Sie in der Eigenschaft Object die Option Kontoaus.
    8. Geben Sie in der Eigenschaft Abfrageoptionen die Variable Dictionary<String,String> ein, die Sie oben erstellt haben (z. B. queryOption).
    9. Erstellen Sie in der Eigenschaft Ergebnis eine DataTable -Variable (z. B. searchResults), und geben Sie sie ein.
       
       

       

       
       

13. Fügen Sie eine „ Assign “-Aktivität nach der „ Search Records “-Aktivität hinzu.

    1. Erstellen Sie in der Eigenschaft An eine String -Variable (z. B. webURL), und geben Sie sie ein.

    2. Geben Sie in der Eigenschaft Value Folgendes ein: searchResults.Rows(0).Item("websiteurl").ToString.

       • Weitere Informationen zu den Spaltennamen für jede Entität finden Sie unter Web API EntityType Reference in der Microsoft-Dokumentation.
    3. Fügen Sie nach der Aktivität Zuweisen eine If -Aktivität hinzu.
    4. Erstellen Sie eine String -Variable mit einem Standardwert einer URL (z. B. Name: Website, Standard: „www.uipath.com“).
    5. Geben Sie in der Eigenschaft Condition Folgendes ein: webURL = website.
    6. Fügen Sie im Feld Then -Anweisung eine Write Line- Aktivität mit dem folgenden Texthinzu: „Website present“.

    7. Fügen Sie im Feld Else statement die Aktivität Update Record hinzu.

       1. Klicken Sie auf die Schaltfläche Konfigurieren in der Aktivität Datensatz aktualisieren (dadurch wird der Objekt-Assistentgeöffnet).

          1. Wählen Sie in der Dropdownliste Entität auswählen die Option Kontoaus.
          2. Geben Sie im Feld accountId die Variable String ein, die Sie für die Aktivität Datensatz einfügen erstellt haben (z. B. accountId).
          3. Geben Sie im Textfeld Einzelnes Feld hinzufügen die Website- URL ein, und klicken Sie auf die Eingabetaste.
          4. Geben Sie im Namensfeld die Variable String ein, die Sie im obigen Schritt erstellt haben (z. B. Website).

          5. Klicken Sie auf die Schaltfläche Fertig .

             
             

             

             
             

Testen Sie Ihr Projekt

1. Fügen Sie „ Get Record “ nach der Aktivität „ Update Record “ (im Feld „ Else “-Anweisung) hinzu.

   1. Klicken Sie auf die Schaltfläche Konfigurieren in der Aktivität Datensatz abrufen (hierdurch wird der Objekt-Assistentgeöffnet).

      1. Wählen Sie in der Dropdownliste Entität auswählen die Option Kontoaus.
      2. Geben Sie im Feld accountId die Variable String ein, die Sie für die Aktivität Datensatz einfügen erstellt haben (z. B. accountId).
      3. Geben Sie im Textfeld Einzelnes Feld hinzufügen die Website- URL ein, und klicken Sie auf die Eingabetaste.
      4. Erstellen Sie im Feld websiteurl eine String -Variable (z. B. websiteVerification), und geben Sie sie ein.
      5. Klicken Sie auf die Schaltfläche Fertig .
   2. Fügen Sie eine If -Aktivität nach der Aktivität „ Get Record “ (im Feld „ Else “-Anweisung) hinzu.
   3. Geben Sie in der Eigenschaft Condition Folgendes ein: website = websiteVerification.
   4. Fügen Sie im Feld Then -Anweisung eine Write Line- Aktivität mit dem folgenden Texthinzu: "Website-Update erfolgreich!".
   5. Fügen Sie im Feld Then -Anweisung eine Write Line- Aktivität mit dem folgenden Texthinzu: „Website-Update fehlgeschlagen“.

2. Fügen Sie die Delete Record- Aktivität außerhalb der ersten If -Aktivität hinzu.

   1. Wählen Sie in der Eigenschaft Object die Option Kontoaus.
   2. Geben Sie im Feld ID die Variable String ein, die Sie für die Aktivität Datensatz einfügen erstellt haben (z. B. accountId).
   3. Erstellen Sie in der Eigenschaft MicrosoftDynamicsStatus eine ResponseStatus -Variable (z. B. responseStatus), und geben Sie sie ein.

3. Fügen Sie eine „Write Line “-Aktivität nach der „Delete Record“ -Aktivität hinzu.

   1. Geben Sie in der Eigenschaft Text Folgendes ein: „Datensatz gelöscht: „+responseStatus.Success.ToString.

4. Klicken Sie auf Ausführen und überprüfen Sie, ob das Fenster Ausgabe ( Output ) die erwarteten Werte für die Schreibzeile enthält.

   
   

   

   
   

Alles erledigt!

Weitere Informationen zu Microsoft Dynamics 365-Aktivitäten (einschließlich Beispieleigenschaftseingaben/-ausgaben) finden Sie auf der Seite Aktivitäten für eine vollständige Aktivitätsliste und Links zu den Aktivitätsdetailseiten.