Del via

Eksempel: Konvertér funktionsmåde for dato og klokkeslæt

  • Artikel

 

Udgivet: november 2016

Gælder for: Dynamics CRM 2015

Dette eksempel viser, hvordan du bruger meddelelsen ConvertDateAndTimeBehaviorRequest til at konvertere UTC-værdien til DateOnly-værdien for dato- og klokkeslætsattributten i Dynamics 365, der fandtes i systemet, før du ændrede funktionsmåden for attributten fra UserLocal til DateOnly.Flere oplysninger:Konverter funktionsmåden for eksisterende dato- og klokkeslætsværdier i databasen.

Dette eksempel er for Opdatering 1 til Microsoft Dynamics CRM Online 2015. Det kan downloades fra Konvertér funktionsmåde for dato og klokkeslæt.

Forudsætninger

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

  2. Du skal have rollen Systemadministrator i CRM-organisationen for at kunne bruge meddelelsen ConvertDateAndTimeBehaviorRequest, der vises i dette eksempel. Eller kan dette eksempel ikke bruges.

  3. Download Visual Studio-projektet DateTimeAttributeBehavior.

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

    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. Run-metoden i ConvertDateandTimeBehavior-klassen kontrollerer, om du kører den korrekte version af Dynamics 365 for eksemplet.

  2. CreateRequiredRecords-metoden opretter de nødvendige poster til eksemplet:

    1. Opretter eksemplets dato- og klokkeslætsattribut for objektet Account med funktionsmåden UserLocal.

    2. Opretter en firmapost til eksemplet med værdien March 31, 2015 11:00 PM UTC i den nye dato- og klokkeslætsattribut.

    3. Ændrer funktionsmåden for dato- og klokkeslætsattributten til DateOnly

    4. Opretter endnu en firmapost til eksemplet med værdien March 31, 2015 11:00 PM UTC i den nye dato- og klokkeslætsattribut. Da attributten nu er DateOnly, ignoreres tidsdelen og gemmes i systemet som March 31, 2015 00:00:00.

    5. Henter værdien i dato- og klokkeslætsattributten i begge firmaposter. Da funktionsmåden er ændret, vises begge værdier som March 31, 2015 00:00:00. Men værdien i den første firmapost er fortsat i UTC-tid (March 31, 2015 11:00 PM) i databasen.

  3. Kører SDK-meddelelsen ConvertDateAndTimeBehaviorRequest for at oprette et asynkront job til konvertering af UTC-værdier i dato- og klokkeslæts attributten til en DateOnly-værdi. Konverteringsreglen i SDK-meddelelsen konverterer værdien i overensstemmelse med IST-tidszonekoden (India Standard Time) i CRM (190).

    
ConvertDateAndTimeBehaviorRequest request = new ConvertDateAndTimeBehaviorRequest()
{
    Attributes = new EntityAttributeCollection() 
            { 
                new KeyValuePair<string, StringCollection>("account", new StringCollection() 
                { "new_sampledatetimeattribute" }) 
            },
    ConversionRule = DateTimeBehaviorConversionRule.SpecificTimeZone.Value,
    TimeZoneCode = 190, // Time zone code for India Standard Time (IST) in CRM
    AutoConvert = false // Conversion must be done using ConversionRule
};

// Execute the request
ConvertDateAndTimeBehaviorResponse response = (ConvertDateAndTimeBehaviorResponse)_serviceProxy.Execute(request);

  4. Henter værdien i dato- og klokkeslætsattributten i begge firmaposter efter omregningen. UTC-værdien i den første firmapost bliver konverteret til 1. april i stedet for 31. marts, fordi konverteringen skete i overensstemmelse med IST-tidszonen. Værdien i den anden firmapost påvirkes ikke, da den allerede var en DateOnly-værdi.

  5. Endelig beder DeleteRequiredRecords-metoden dig om at slette objektposterne og den brugerdefinerede dato- og klokkeslætsattribut, der oprettes under kørslen af eksemplet:

    1. Skriv y, og tryk på ENTER for at slette objektposterne og den brugerdefinerede attribut fra din organisation.

    2. Skriv n, og tryk på ENTER for at lade objektposterne og den brugerdefinerede attribut blive din organisation. Du skal manuelt slette dem senere, hvis du vil 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 DateTimeAttributeBehavior.sln ved hjælp af Visual Studio.

  3. I Visual Studio skal du højreklikke på projektet DateTimeAttributeBehavior 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 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 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å

ConvertDateAndTimeBehaviorRequest
Funktionsmåde og format for dato- og klokkeslætsattribut
Tilpasse objektets attributmetadata

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret