Del via

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

  • Artikel

 

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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 kan downloades fra Indsætte eller opdatere en post ved hjælp af Upsert.

Forudsætninger

  1. Have adgang til en Microsoft Dynamics 365 eller Opdatering til CRM Online 2016-organisation.

  2. Download Visual Studio-projektet UpsertSample.

  3. Åbn UpsertSample Visual Studio-projektet, og installér Microsoft.CrmSdk.CoreAssemblies version 8.0.0-preview eller nyere NuGet Package. 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 klikke på Manage NuGet Packages.

  4. I Preview-versionen skal du klikke på Include Prerelease frem for Stable Only i søgekriterierne. Derefter skal du søge efter "Microsoft Dynamics CRM 2016 SDK core assemblies". Sørg for at vælge 8.0.0-preview-versionen eller nyere.

  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 365-kodeeksempler før, skal du angive oplysninger for at køre koden, og ellers skal du indtaste nummeret for en af de Dynamics 365-servere, du tidligere har oprettet.

    Prompt

    Beskrivelse

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

    Angiv navnet på din Microsoft Dynamics 365-server. Standarden for Microsoft Dynamics 365 (online) er crm.dynamics.com i Nordamerika.

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

    Medtag ikke navnet på din organisation eller internetprotokol (http eller https). Du bliver bedt om dette senere.

    Er denne server konfigureret til Secure Sockets Layer (https) (y/n) [n]

    Skriv y, hvis URL-adressen du bruger til at få adgang til Microsoft Dynamics 365 starter med https://, eller skriv n.

    Er denne organisation klargjort i Microsoft Office 365 (y/n) [n]

    Skriv y, hvis det er en Microsoft Office 365-klargjort organisation. Ellers skal du skrive n.

    Angiv domæne\brugernavn

    Angiv din Microsoft-konto.
    For Microsoft Dynamics 365 skal du skrive dit netværksdomæne og brugernavn adskilt af en omvendt skråstreg (\).

    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

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret