Delen via

Voorbeeld: Een record invoegen of bijwerken met Upsert

  • Artikel

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

Deze voorbeeldcode toont hoe u records invoegt of bijwerkt met het bericht Upsert. Zie Upsert gebruiken om een record in te voegen of bij te werken voor meer informatie over de functie die in dit voorbeeld wordt gedemonstreerd.

Dit voorbeeld is voor Update 1 voor Microsoft Dynamics CRM Online 2015. Dit kan worden gedownload van Een record invoegen of bijwerken met Upsert.

Vereisten

  1. Toegang hebben tot een Update 1 voor Microsoft Dynamics CRM Online 2015-organisatie.

  2. Het Visual Studio-project UpsertSample downloaden.

  3. Open het Visual Studio-project UpsertSample en installeer Microsoft.CrmSdk.CoreAssemblies versie 7.1.0-preview NuGet-pakket. Zie NuGet-pakketten installeren voor instructies.

  4. Nadat u de NuGet-pakket hebt geïnstalleerd, raadpleegt u Het voorbeeld uitvoeren voor instructies voor het uitvoeren van het voorbeeld en wat u kunt verwachten.

In dit onderwerp

Wat dit voorbeeld doet

NuGet-pakketten installeren

Het voorbeeld uitvoeren

Wat dit voorbeeld doet

  1. De methode Run van de klasse ProductUpsertSample roept de methode ImportUpsertSampleSolution aan die eerst detecteert of de beheerde oplossing UpsertSample al is geïnstalleerd. Als dit niet het geval is, wordt het bestand UpsertSample_1_0_0_0_managed.zip geïmporteerd om deze beheerde oplossing te installeren.

    Deze beheerde oplossing bevat een aangepast entiteit sample_product die wordt gebruikt door dit voorbeeld. Deze entiteit heeft een alternatieve sleutel sample_productcode waarmee een unieke beperking wordt gecreëerd voor de waarde die zijn opgeslagen in dat kenmerk.

  2. De methode WaitForEntityAndKeysToBeActive is noodzakelijk omdat de alternatieve sleutels die zijn vereist voor dit voorbeeld mogelijk niet onmiddellijk na de installatie van de oplossing UpsertSample beschikbaar zijn. Met deze methode worden de metagegevens voor de entiteit sample_product geraadpleegd om de uitvoering van de rest van het voorbeeld te vertragen totdat de alternatieve sleutels gereed zijn.

  3. Wanneer de methode ProcessUpsert voor het eerst wordt aangeroepen, verwerkt deze gegevens in het bestand newsampleproduct.xml om nieuwe producten weer te geven. De UpsertRequest wordt doorgegeven aan de methode Execute om 13 nieuwe records te maken.

    De eigenschap UpsertResponse.RecordCreated retourneert true om aan te geven dat nieuwe records zijn gemaakt.

    Voordat de methode ProcessUpsert wordt voltooid, vraagt het programma of u de entiteitsrecords voor de voorbeeldproducten wilt bekijken. Als u 'y' antwoordt, probeert het programma Internet Explorer te openen met een weergave van de nieuw gemaakte records.

  4. Wanneer de methode ProcessUpsert de tweede keer wordt aangeroepen, verwerkt deze gegevens in het bestand updatedsampleproduct.xml om updates van eerder gemaakte producten weer te geven. Het bericht Upsert wordt gebruikt om 6 records bij te werken. De eigenschap UpsertResponse.RecordCreated retourneert false om aan te geven dat records zijn bijgewerkt.

    De methode ProcessUpsert vraagt opnieuw of u de records wilt bekijken in de browser. Als u de weergave al geopend hebt, kunt u deze simpelweg vernieuwen om de wijzigingen te bekijken.

  5. Tot slot wordt u gevraagd door DeleteUpsertSampleSolution om de beheerde oplossing Voorbeeld van Upsert te verwijderen.

    Als u 'y' kiest, wordt de beheerde oplossing verwijderd, met inbegrip van de entiteit sample_product en alle gegevens in die entiteit. Er is niets meer toegevoegd aan uw organisatie.

    Als u 'n' kiest, kunt u de details van de oplossing inspecteren, met inbegrip van de gegevens die zijn gemaakt door het voorbeeld. Maar u moet de beheerde oplossing handmatig verwijderen om uw organisatie terug te zetten in de oorspronkelijk toestand.

NuGet-pakketten installeren

Voer de volgende stappen uit om de vereisten assembly's voor dit voorbeeld te installeren:

  1. Download dit voorbeeld en extraheer de bestanden.

  2. Navigeer naar de C#-map en open het bestand UpsertSample.sln in Visual Studio.

  3. Klik in Visual Studio met de rechtermuisknop op het project UpsertSample en kies NuGet-pakketten beheren.

  4. Kies voor de preview-versie de optie Inclusief proefversie in plaats van Alleen stabiel in de zoekcriteria. Zoek vervolgens naar "Microsoft Dynamics CRM 2015 SDK core assemblies". Zorg ervoor dat u de versie 7.1.0-preview selecteert.

  5. Klik op Installeren. U moet de licentievoorwaarden accepteren om de installatie van dit pakket te kunnen voltooien.

Het voorbeeld uitvoeren

  1. Druk in Visual Studio, terwijl de oplossing is geopend en de benodigde NuGet-pakketten zijn geïnstalleerd, op F5.

  2. Als u niet eerder een van de beheerde codevoorbeelden van Microsoft Dynamics CRM hebt uitgevoerd, moet u informatie invoeren om de code te kunnen uitvoeren. Voer anders het nummer an een van de CRM-servers in die u eerder hebt opgezet.

    Vraag

    Beschrijving

    Een CRM-servernaam en -poort invoeren [crm.dynamics.com]

    Typ de naam van uw Microsoft Dynamics CRM-server. De standaardserver is Microsoft Dynamics CRM Online (crm.dynamics.com) in Noord-Amerika.

    Voorbeeld:
    crm5.dynamics.com

    Is deze organisatie ingericht in Microsoft online-services (j/n) [n]

    Typ y als deze organisatie is ingericht in Microsoft online-services. Typ anders n.

    Domein\gebruikersnaam invoeren

    Typ uw Microsoft-account.

    Wachtwoord invoeren

    Typ uw wachtwoord. De tekens worden als "*" in het venster weergegeven. Uw wachtwoord wordt veilig opgeslagen in Referentiebeheer van Microsoft voor later hergebruik.

    Geef een organisatienummer op (1-n) [1]

    Typ uit de lijst met organisaties waartoe u behoort, typt het bijbehorende nummer. De standaardinstelling is 1, waarmee de eerste organisatie in de lijst wordt aangegeven.

  3. Het voorbeeld voert de bewerkingen uit die worden beschreven in Wat dit voorbeeld doet en vraagt u mogelijk om aanvullende opties.

  4. Als het voorbeeld is voltooid, drukt u op Enter om het consolevenster te sluiten.

Zie ook

Upsert gebruiken om een record in te voegen of bij te werken

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht