Freigeben über

Beispiel: Einen Datensatz mit Upsert einfügen oder aktualisieren

  • Artikel

 

Veröffentlicht: November 2016

Gilt für: Dynamics CRM 2015

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.

Dieses Beispiel ist für Microsoft Dynamics CRM Online 2015-Update 1. 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 CRM Online 2015-Update 1-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 7.1.0-preview. 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. Für die Vorschauversion stellen Sie sicher, dass Sie in den Suchkriterien Vorabversion berücksichtigen anstelle von Stabile Version auswählen. Suchen Sie dann nach Microsoft Dynamics CRM 2015 SDK core assemblies. Wählen Sie die Version 7.1.0-preview 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 CRM-Codebeispiele ausgeführt haben, geben Sie die Informationen ein, um den Code auszuführen. Andernfalls geben Sie die Zahl für die CRM-Server ein, die Sie bereits installiert haben.

    Eingabeaufforderung

    Beschreibung

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

    Geben Sie den Namen Ihres Microsoft Dynamics CRM-Servers ein. Die Standardeinstellung ist Microsoft Dynamics CRM Online (crm.dynamics.com) in Nordamerika.

    Beispiel:
    crm5.dynamics.com

    Wird die Organisation in Microsoft Online Services bereitgestellt [(y/nn]

    Geben Sie y ein, wenn es sich um eine Organisation handelt, die in Microsoft Online Services bereitgestellt wird. Andernfalls geben Sie n ein.

    Domäne\Benutzernamen eingeben

    Geben Sie Ihr Microsoft-Konto ein.

    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

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright