Del via

Eksempel: Indsætte eller opdatere en post ved hjælp af Upsert

  • Artikel

 

Udgivet: november 2016

Gælder for: Dynamics CRM 2015

I denne eksempelkode kan du se, hvordan du indsætter eller opdaterer poster ved hjælp af Upsert-meddelelsen. Du kan finde flere oplysninger om den funktion, som dette eksempel demonstrerer, under Brug Upsert til at indsætte eller opdatere en post.

Dette eksempel er for Opdatering 1 til Microsoft Dynamics CRM Online 2015. Dette kan downloades fra Indsætte eller opdatere en post ved hjælp af Upsert.

Forudsætninger

  1. Har adgang til en Opdatering 1 til Microsoft Dynamics CRM Online 2015-organisation.

  2. Download Visual Studio-projektet UpsertSample.

  3. Åbn Visual Studio-projektet UpsertSample, og installer NuGet-pakken til Microsoft.CrmSdk.CoreAssemblies version 7.1.0-preview. Du kan finde en vejledning i Installer NuGet-pakker.

  4. Når du har installeret NuGet-pakkerne, kan du se en vejledning i, hvordan du kører eksemplet, og hvad der kan forventes, under Kør eksemplet.

Dette emne indeholder

Det kan eksemplet gøre

Installer NuGet-pakker

Kør eksemplet

Det kan eksemplet gøre

  1. ProductUpsertSample-klassens Run-metode kalder ImportUpsertSampleSolution-metoden, der først registrerer, om den administrerede UpsertSample-løsning allerede er installeret. Hvis ikke, importeres UpsertSample_1_0_0_0_managed.zip-filen for at installere denne administrerede løsning.

    Denne administrerede løsning indeholder en brugerdefineret sample_product-enhed, der bruges af dette eksempel. Dette objekt har en alternativ sample_productcode-nøgle, der opretter en entydig begrænsning for de værdier, der er gemt i attributten.

  2. WaitForEntityAndKeysToBeActive-metoden er nødvendig, fordi de alternative nøgler, der kræves til dette eksempel, muligvis ikke er klar, umiddelbart efter at UpsertSample-løsningen er installeret. Denne metode undersøger metadataene for objektet sample_product for at forsinke udførelsen af resten af eksemplet, indtil de alternative nøgler er klar.

  3. Første gang ProcessUpsert-metoden kaldes, behandler den data i filen newsampleproduct.xml, der repræsenterer nye produkter.UpsertRequest overføres til Execute-metoden for at oprette nye 13 poster.

    Egenskaben UpsertResponse.RecordCreated returnerer værdien true for at angive, at der blev oprettet nye poster.

    Inden ProcessUpsert-metoden er fuldført, bliver du spurgt, om du vil se eksempelproduktets objektposter. Hvis du svarer med 'y', forsøger programmet at åbne en visning i Internet Explorer, der viser de nye poster.

  4. Anden gang ProcessUpsert-metoden kaldes, behandler den data i filen updatedsampleproduct.xml, der repræsenterer opdateringer til tidligere oprettede produkter.Upsert-meddelelsen bruges til at opdatere 6 poster. Egenskaben UpsertResponse.RecordCreated returnerer værdien false som tegn på, at poster er blevet opdateret.

    Igen spøger ProcessUpsert-metoden, om du vil se posterne i browseren. Hvis du allerede har åbnet visningen, kan du blot opdatere visningen for at se ændringerne.

  5. Endelig beder DeleteUpsertSampleSolution dig om at slette den administrerede Upsert-eksempelløsning.

    Hvis du vælger "y", slettes den administrerede løsning, herunder objektet sample_product og alle data i objektet. Der tilføjes ikke noget til organisationen.

    Hvis du vælger "n", kan du undersøge detaljerne for løsningen, herunder de data, der er oprettet af eksemplet. Men du skal manuelt slette den administrerede løsning, for at din organisation kan vende tilbage til den oprindelige tilstand.

Installer NuGet-pakker

Brug følgende trin til at installere de nødvendige assemblier til dette eksempel:

  1. Download dette eksempel, og pak filerne ud.

  2. Gå til mappen C#, og åbn filen UpsertSample.sln ved hjælp af Visual Studio.

  3. I Visual Studio skal du højreklikke på projektet UpsertSample og vælge Manage NuGet Packages.

  4. I Preview-versionen skal du vælge Include Prerelease frem for Stable Only i søgekriterierne. Derefter skal du søge efter "Microsoft Dynamics CRM 2015 SDK core assemblies". Sørg for at vælge 7.1.0-preview-versionen.

  5. Klik på Installer. Du skal acceptere vilkårene i licensaftalen for at kunne installere denne pakke.

Kør eksemplet

  1. Åbn løsningen i Visual Studio med de nødvendige NuGet-pakker installeret, og tryk på F5.

  2. Hvis du ikke tidligere har kørt en af de administrerede Microsoft Dynamics CRM-kodeeksempler før, skal du angive oplysninger for at køre koden, og ellers skal du indtaste nummeret for en af de CRM-servere, du tidligere har oprettet.

    Prompt

    Beskrivelse

    Angiv et CRM-servernavn og en -port [crm.dynamics.com]

    Skriv navnet på din Microsoft Dynamics CRM-server. Standarden er Microsoft Dynamics CRM Online (crm.dynamics.com) i Nordamerika.

    Eksempel:
    crm5.dynamics.com

    Er denne organisation klargjort i Microsoft-onlinetjenester (y/n) [n]

    Skriv y, hvis dette er en Microsoft Online-klargjort organisation. Ellers skal du skrive n.

    Angiv domæne\brugernavn

    Angiv din Microsoft-konto.

    Angiv adgangskode

    Skriv din adgangskode. Tegnene vil blive vist som "*" i vinduet. Adgangskoden gemmes sikkert i Microsoft Legitimationsstyring til senere brug.

    Angiv et organisationsnummer (1-n) [1]

    Skriv det tilsvarende nummer fra listen over viste organisationer, du tilhører. Standardværdien er 1, der angiver den første organisation på listen.

  3. Eksemplet udfører de operationer, der er beskrevet i Det kan eksemplet gøre, og du bilver muligvis bedt om at angive flere indstillinger.

  4. Når eksemplet er fuldført, skal du trykke på Enter for at lukke konsolvinduet.

Se også

Brug Upsert til at indsætte eller opdatere en post

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret