Delen via

Voorbeeld: Datum- en tijdgedrag converteren

  • Artikel

 

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Dit voorbeeld laat zien hoe het ConvertDateAndTimeBehaviorRequest-bericht kan worden gebruikt voor het converteren va de UTC-waarde naar DateOnly-waarde van het datum- en tijdkenmerk in Dynamics 365 dat bestaat in het systeem voordat u het gedrag van het kenmerk hebt gewijzigd van UserLocal in DateOnly.Meer informatie:Het gedrag van bestaande datum- en tijdwaarden in de database converteren.

Dit voorbeeld is voor Update 1 voor Microsoft Dynamics CRM Online 2015 en Microsoft Dynamics 365 (on-premises). Dit kan worden gedownload vanuit Datum- en tijdgedrag converteren.

Vereisten

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

  2. U moet over de rol van systeembeheerder in uw Dynamics 365-organisatie beschikken om het ConvertDateAndTimeBehaviorRequest-bericht te kunnen gebruiken dat wordt gedemonstreerd in dit voorbeeld. Anders mislukt dit voorbeeld.

  3. Download het DateTimeAttributeBehaviorVisual Studio-project.

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

    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 ConvertDateandTimeBehavior controleert of u de juiste versie van Dynamics 365 uitvoert voor het voorbeeld.

  2. De methode CreateRequiredRecords maakt de vereiste records voor het voorbeeld:

    1. Maakt een voorbeeldkenmerk voor datum en tijd voor de entiteit Account met het gedrag UserLocal.

    2. Maakt een voorbeeldaccountrecord met de waarde March 31, 2015 11:00 PM UTC in het nieuwe datum- en tijdkenmerk.

    3. Wijzigt het gedrag van het datum- en tijdkenmerk in DateOnly.

    4. Maakt een andere voorbeeldaccountrecord met de waarde March 31, 2015 11:00 PM UTC in het nieuwe datum- en tijdkenmerk. Omdat het kenmerk nu DateOnly is, wordt het tijdgedeelte genegeerd en in het systeem opgeslagen als March 31, 2015 00:00:00.

    5. Haalt de waarde in het datum- en tijdkenmerk op in beide accountrecords. Omdat het gedrag is gewijzigd, worden beide waarden weergegeven als March 31, 2015 00:00:00. De waarde in de eerste record behoudt echter de UTC-indeling (March 31, 2015 11:00 PM) in de database.

  3. Voert het ConvertDateAndTimeBehaviorRequest SDK-bericht uit voor het maken van een asynchrone taak voor het converteren van de UTC-waarden in het datum- en tijdkenmerk naar een DateOnly-waarde. De conversieregel in het SDK-bericht converteert de waarde volgens de IST-tijdzonecode (India Standard Time) in Dynamics 365 (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. Haalt de waarde in het datum- en tijdkenmerk op in beide accountrecords na de conversie. De UTC-waarde in de eerste accountrecord wordt geconverteerd naar 1 april in plaats van 31 maart omdat de conversie plaatsvond op basis van de IST-tijdzone (India Standard Time). De waarde in de tweede accountrecord wordt niet beïnvloed omdat dit reeds een DateOnly-waarde was.

  5. Tot slot vrqaagt de methode DeleteRequiredRecords u de entiteitsrecords en het aangepaste datum- en tijdkenmerk te verwijderen tijdens het uitvoeren van het voorbeeld:

    1. Typ y en druk op ENTER om de entiteitsrecords en het aangepaste kenmerk uit uw organisatie te verwijderen.

    2. Typ n en druk op ENTER om de entiteitsrecords en het aangepaste kenmerk in uw organisatie te laten. U zult deze later handmatig moeten verwijderen als u uw organisatie wilt terugzetten 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 DateTimeAttributeBehavior.sln in Visual Studio.

  3. Klik in Visual Studio met de rechtermuisknop op het project DateTimeAttributeBehavior 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 365 hebt uitgevoerd, moet u informatie invoeren om de code te kunnen uitvoeren. Voer anders het nummer van een van de Dynamics 365-servers in die u eerder hebt opgezet.

    Vraag

    Beschrijving

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

    Typ de naam van uw Microsoft Dynamics 365-server. De standaardserver is Microsoft Dynamics 365 (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

ConvertDateAndTimeBehaviorRequest
Gedrag en indeling van het datum- en tijdkenmerk
Metagegevens van entiteitskenmerken aanpassen

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht