Exemplo: converter comportamento de data e hora

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Este exemplo demonstra como usar a mensagem ConvertDateAndTimeBehaviorRequest para converter o valor UTC do valor DateOnly do atributo de data e hora em Dynamics 365 que existe no sistema antes de alterar o comportamento do atributo de UserLocal para DateOnly.Para obter mais informações:Converter o comportamento de valores existentes de data e hora no banco de dados.

Este exemplo é para o Atualização 1 do Microsoft Dynamics CRM Online 2015 e o Microsoft Dynamics 365 (no local). Essa opção está disponível para download de Converter comportamento de data e hora.

Pré-requisitos

1. Tenha acesso a uma organização do Atualização 1 do Microsoft Dynamics CRM Online 2015 ou do Microsoft Dynamics 365.

2. Permita que a função Administrador do Sistema da organização do Dynamics 365 use a mensagem ConvertDateAndTimeBehaviorRequest que é demonstrada neste exemplo. Caso contrário, este exemplo falhará.

3. Baixe o projeto DateTimeAttributeBehaviorVisual Studio.

4. Abra o projeto DateTimeAttributeBehavior do Visual Studio e instale o Pacote NuGet do Microsoft.CrmSdk.CoreAssemblies versão 7.1.0-preview. Consulte Instalar pacotes NuGet mais tarde para obter instruções.

   Depois de instalar os pacotes NuGet, consulte Executar o exemplo para obter instruções sobre como executar o exemplo e o que esperar.

Neste tópico

O que este exemplo faz

Instalar pacotes NuGet

Executar o exemplo

O que este exemplo faz

1. O método ConvertDateandTimeBehavior da classe Run verifica se você está executando a versão apropriada do Dynamics 365 para o exemplo.

2. O método CreateRequiredRecords cria os registros necessários para o exemplo:

   1. Cria um atributo de data e hora de exemplo para a entidade Account com o comportamento UserLocal.

   2. Cria um registro de conta de exemplo com o valor March 31, 2015 11:00 PM UTC no novo atributo de data e hora.

   3. Altera o comportamento do atributo de data e hora para DateOnly.

   4. Cria outro registro de conta de exemplo com o valor March 31, 2015 11:00 PM UTC no novo atributo de data e hora. Como o atributo agora é DateOnly, a parte de hora é ignorada e armazenada no sistema como March 31, 2015 00:00:00.

   5. Recupera o valor do atributo de data e hora nos dois registros de conta. Como o comportamento foi alterado, os dois valores são exibidos como March 31, 2015 00:00:00. No entanto, o valor no primeiro registro de conta permanece no UTC (March 31, 2015 11:00 PM) no banco de dados.

3. Executa a mensagem SDK ConvertDateAndTimeBehaviorRequest para criar um trabalho assíncrono para converter os valores UTC no atributo de data e hora em um valor DateOnly. A regra de conversão na mensagem SDK converte o valor por código de fuso horário de IST (Hora Padrão da Índica) em 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. Recupera o valor do atributo de data e hora nos dois registros de conta após a conversão. O valor UTC no primeiro registro de conta é convertido em 1º de abril, em vez de 31 de março porque a conversão ocorreu de acordo com o fuso horário de IST. O valor no segundo registro de conta não é afetado pois ele já foi um valor DateOnly.

5. Por fim, o método DeleteRequiredRecords solicita que você exclua os registros de entidade e o atributo personalizado de data e hora criados durante a execução de exemplo:

   1. Digite y e pressione ENTER para excluir os registros de entidade e o atributo personalizado da sua organização.

   2. Digite n e pressione ENTER para manter os registros de entidade e o atributo personalizado na sua organização. Você precisará excluí-los manualmente se desejar retornar ao estado original.

Instalar pacotes NuGet

Use as etapas a seguir para instalar os assemblies necessários para este exemplo:

1. Baixe este exemplo e extraia os arquivos.

2. Navegue até a pasta C# e abra o arquivo DateTimeAttributeBehavior.sln usando o Visual Studio.

3. No Visual Studio, clique com o botão da direito no projeto DateTimeAttributeBehavior e escolha Gerenciar pacotes NuGet.

4. Para a versão de visualização, selecione Incluir Pré-lançamento em vez de Somente Estável nos critérios da pesquisa. Em seguida, procure "Microsoft Dynamics CRM 2015 SDK core assemblies". Selecione a versão 7.1.0-preview.

5. Clique em Instalar. Você precisará aceitar os termos de licença para concluir a instalação desse pacote.

Executar o exemplo

1. No Visual Studio, com a solução aberta e os pacotes NuGet necessários instalados, pressione F5.

2. Caso você não tenha executado antes um dos exemplos de código gerenciado do Microsoft Dynamics 365, será necessário inserir informações para executar o código; caso contrário, insira o número para um dos servidores do Dynamics 365 configurado anteriormente.

   Solicitar	Descrição
   Insira um nome de servidor do Dynamics 365 e uma porta [crm.dynamics.com]	Digite o nome do seu servidor do Microsoft Dynamics 365. O padrão é Microsoft Dynamics 365 (online) (crm.dynamics.com) na América do Norte. Exemplo: crm5.dynamics.com
   Esta organização foi provisionada nos serviços online da Microsoft (y/n) [n]	Digite y caso seja uma organização provisionada pelos serviços online da Microsoft. Caso contrário, digite n.
   Insira domínio\nome de usuário	Digite sua conta da Microsoft.
   Insira a senha	Digite sua senha. Os caracteres serão mostrados como "*" na janela. Sua senha é salva com segurança no Microsoft Credential Manager para reutilização posterior.
   Especificar um número da organização (1-n) [1]	Na lista de organizações mostradas que você participa, digite o número correspondente. O padrão é 1, indicando a primeira organização na lista.

3. O exemplo executará as operações descritas em O que este exemplo faz e pode solicitar a você opções adicionais.

4. Quando o exemplo for concluída, pressione ENTER para fechar a janela do console.

Confira Também

ConvertDateAndTimeBehaviorRequest
Comportamento e formato do atributo de data e hora
Personalizar metadados do atributo de entidades

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais