Freigeben über

Beispiel: Einen Datensatz mit Upsert einfügen oder aktualisieren

  • Artikel

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Dieses Beispielcode zeigt, wie Datensätze mithilfe der Meldung Upsert eingefügt oder aktualisiert werden. Weitere Informationen zu der Funktion, die dieses Beispiel veranschaulicht, finden Sie unter Einen Datensatz mit Upsert einfügen oder aktualisieren.

Dies kann unter Einen Datensatz mit Upsert einfügen oder aktualisieren heruntergeladen werden.

Erforderliche Komponenten

  1. Lassen Sie sich den Zugriff auf eine Microsoft Dynamics 365- oder CRM Online 2016-Update-Organisation zuweisen.

  2. Laden Sie das Visual Studio-Projekt UpsertSample herunter.

  3. Öffnen Sie das Visual Studio-Projekt UpsertSample und installieren Sie das NuGet-Paket Microsoft.CrmSdk.CoreAssemblies Version 8.0.0-preview oder höher. Anweisungen dazu finden unter Installieren von NuGet-Paketen.

  4. Nachdem Sie die NuGet-Pakete installiert haben, finden Sie unter Ausführen des Beispiels Informationen dazu, wie das Beispiel ausgeführt wird und was zu erwarten ist.

In diesem Thema

Funktionsweise:

Installieren von NuGet-Paketen

Ausführen des Beispiels

Funktionsweise:

  1. Die Methode Run der Klasse ProductUpsertSample ruft die Methode ImportUpsertSampleSolution auf, die zuerst feststellt, ob die verwaltete UpsertSample-Lösung bereits installiert ist. Ist dies nicht der Fall, wird die Datei UpsertSample_1_0_0_0_managed.zip importiert, um diese verwaltete Lösung zu installieren.

    Diese verwaltete Lösung enthält die benutzerdefinierte Entität sample_product, die in diesem Beispiel verwendet wird. Diese Entität hat den Alternativschlüssel sample_productcode, der eine eindeutige Einschränkung für Werte erstellt, die in diesem Attribut gespeichert werden.

  2. Die Methode WaitForEntityAndKeysToBeActive ist erforderlich, da die Alternativschlüssel, die für dieses Beispiel benötigt werden, möglicherweise nicht direkt nach Installation der UpsertSample-Lösung bereit sind. Diese Methode ruft die Metadaten für die Entität sample_product ab, um die Ausführung des Rests des Beispiels zu verzögern, bis die Alternativschlüssel bereit sind.

  3. Beim ersten Aufrufen der ProcessUpsert-Methode erfolgt die Verarbeitung von Daten in der newsampleproduct.xml-Datei, um neue Produkte darzustellen.UpsertRequest wird an die Execute-Methode übergeben, um 13 neue Datensätze zu erstellen.

    Die UpsertResponse.RecordCreated-Eigenschaft gibt "true" zurück, um anzugeben, dass neue Datensätze erstellt wurden.

    Vor dem Fertigstellen der ProcessUpsert-Methode fragt das Programm, ob Sie die Entitätsdatensätze des Beispielprodukts anzeigen möchten. Wenn Sie mit „y“ bestätigen, versucht das Programm, Internet Explorer mit einer Ansicht der neu erstellten Datensätze zu öffnen.

  4. Beim zweiten Aufrufen der ProcessUpsert-Methode erfolgt die Verarbeitung von Daten in der updatedsampleproduct.xml-Datei, um Aktualisierungen der zuvor erstellten Produkte darzustellen. Die Nachricht Upsert wird verwendet, um sechs Datensätze zu aktualisieren. Die UpsertResponse.RecordCreated-Eigenschaft gibt "false" zurück, was zeigt, dass Datensätze aktualisiert wurden.

    Die ProcessUpsert-Methode fragt erneut, ob Sie die Datensätze im Browser anzeigen möchten. Ist bereits die Ansicht geöffnet, können Sie die Ansicht nur aktualisieren, um die Änderungen zu beachten.

  5. Zuletzt fordert DeleteUpsertSampleSolution Sie auf, die verwaltete Upsert-Beispiellösung zu löschen.

    Wenn Sie "y“ auswählen, wird die verwaltete Lösung einschließlich der Entität sample_product und aller Daten in der Entität gelöscht. Ihre Organisation verbleibt ohne Hinzufügungen.

    Wenn Sie „n“ auswählen, können Sie die Details der Lösung einschließlich der im Beispiel erstellten Daten überprüfen. Sie müssen jedoch manuell die verwaltete Lösung löschen, um Ihre Organisation auf den ursprünglichen Zustand zurückzusetzen.

Installieren von NuGet-Paketen

Verwenden Sie die folgenden Schritte, um die erforderlichen Assemblys für dieses Beispiel zu installieren:

  1. Laden Sie das Beispiel herunter und extrahieren Sie die Dateien.

  2. Navigieren Sie zum C#-Ordner und öffnen Sie die UpsertSample.sln-Datei mithilfe von Visual Studio.

  3. Klicken Sie in Visual Studio mit der rechten Maustaste auf das Projekt UpsertSample, und wählen Sie NuGet-Pakete verwalten aus.

  4. Stellen Sie für die Vorschauversion sicher, dass Sie in den Suchkriterien Vorabversion berücksichtigen anstelle von Stabile Version auswählen. Suchen Sie dann nach Microsoft Dynamics CRM 2016 SDK core assemblies. Wählen Sie die Version 8.0.0-preview oder höher aus.

  5. Klicken Sie auf Installieren. Akzeptieren Sie die Lizenzbedingungen, um die Installation dieses Pakets abzuschließen.

Ausführen des Beispiels

  1. Drücken Sie in Visual Studio bei geöffneter Lösung und nach Installation der erforderlichen NuGet-Pakete F5.

  2. Wenn Sie zuvor keines der verwalteten Microsoft Dynamics 365-Codebeispiele ausgeführt haben, geben Sie die Informationen ein, um den Code auszuführen. Andernfalls geben Sie die Zahl für einen der Dynamics 365-Server ein, die Sie bereits eingerichtet haben.

    Eingabeaufforderung

    Beschreibung

    Einen Dynamics 365-Servernamen und einen Port eingeben [crm.dynamics.com]

    Geben Sie den Namen Ihres Microsoft Dynamics 365-Servers ein. Die Standardeinstellung für Microsoft Dynamics 365 (online) ist crm.dynamics.com in Nordamerika.

    Beispiel:
    myservername
    myprefix.myservername:5500
    crm5.dynamics.com

    Fügen Sie nicht den Namen Ihrer Organisation oder das Internetprotokoll (http oder https) ein. Sie werden später dazu aufgefordert.

    Ist dieser Server für Secure Sockets Layer (https) konfiguriert (j/n) [n]

    Geben Sie y ein, wenn die URL, die Sie verwenden, um auf Microsoft Dynamics 365 zuzugreifen, mit https:// beginnt. Andernfalls geben Sie n ein.

    Ist diese Organisation in Microsoft Office 365 bereitgestellt? (y/n) [n]

    Geben Sie y ein, falls dies eine Microsoft Office 365-bereitgestellte Organisation ist. Andernfalls geben Sie n ein.

    Domäne\Benutzernamen eingeben

    Geben Sie Ihr Microsoft-Konto ein.
    Geben Sie für Microsoft Dynamics 365 Ihre Netzwerkdomäne und den Benutzernamen an, getrennt durch einen umgekehrten Schrägstrich (\).

    Kennwort eingeben

    Geben Sie Ihr Kennwort ein. Die Zeichen werden im Fenster als "*" angezeigt. Ihr Kennwort wird sicher im Microsoft Credential Manager zur späteren Wiederverwendung gespeichert.

    Organisationsnummer angeben (1-n) [1]

    Geben Sie aus der Liste der angezeigten Organisationen, zu denen Sie gehören, die entsprechende Nummer ein. Die Standardeinstellung ist 1 für die erste Organisation in der Liste.

  3. Das Beispiel führt die Vorgänge aus, die unter Funktionsweise: beschreiben werden, und fordert Sie möglicherweise zur Angabe weiterer Optionen auf.

  4. Wenn das Beispiel abgeschlossen ist, drücken Sie die EINGABETASTE, um das Konsolenfenster zu schließen.

Siehe auch

Einen Datensatz mit Upsert einfügen oder aktualisieren

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright