Partilhar via

Exemplo: Sincronizar dados com sistemas externos usando o controle de alterações

  • Artigo

 

Publicado: janeiro de 2017

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

Este código de exemplo mostra como recuperar alterações de uma entidade e sincronizar dados com sistemas externos usando a mensagem RetrieveEntityChangesRequest. Para obter mais informações sobre o recurso demonstrado por este exemplo, consulte Usar o controle de alterações para sincronizar dados com sistemas externos.

Essa amostra requer Atualização 1 do Microsoft Dynamics CRM Online 2015, Atualização do Microsoft Dynamics CRM Online 2016 ou Microsoft Dynamics 365 (local). Esta amostra está disponível para fazer download em Sincronizar dados com sistemas externos usando o rastreamento de alterações.

Pré-requisitos

  1. Tenha acesso à organização Atualização 1 do Microsoft Dynamics CRM Online 2015, Atualização do Microsoft Dynamics CRM Online 2016 ou Microsoft Dynamics 365 (local).

  2. Baixe o projeto ChangeTrackingSample do Visual Studio.

  3. Abra o projeto ChangeTrackingSample Visual Studio e instale o Microsoft.CrmSdk.CoreAssemblies NuGet Package mais recente. Consulte Instalar pacotes NuGet para obter instruções.

  4. Depois de instalar os pacotes NuGet, consulte Executar o exemplo para obter instruções sobre como executar a amostra 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 Run da classe ChangeTrackingSample chama o método ImportChangeTrackingSolution, que detecta primeiro se a solução gerenciada ChangeTrackingSample já está instalada. Caso não esteja, o arquivo ChangeTrackingSample_1_0_0_0_managed.zip será importado para instalar essa solução gerenciada.

    Essa solução gerenciada contém uma entidade sample_book personalizada usada por este exemplo. A entidade tem uma chave alternativa sample_bookcode que cria uma restrição exclusiva nos valores armazenados no atributo.

  2. O método WaitForEntityAndKeysToBeActive é necessário porque as chaves alternativas exigidas por este exemplo podem não ficar prontas imediatamente após a instalação da solução ChangeTrackingSample. Este método sonda os metadados da entidade sample_book para atrasar a execução do resto do exemplo até que as chaves alternativas estejam prontas.

  3. O método CreateRequiredRecords gera 10 registros na entidade sample_book.

  4. Na primeira vez que RetrieveEntityChangesRequest for chamada, ela executará uma sincronização inicial e recuperará todos os registros da entidade junto com o número de versão e armazenará em cache os registros recuperados.

  5. Após o armazenamento em cache dos registros iniciais, o programa perguntará se você deseja exibir os registros de entidade sample_book. Se você responder com 'y', o programa tentará abrir o Internet Explorer para uma exibição mostrando os registros recém-criados.

  6. O métodoUpdateRecords adiciona dez novos registros, atualiza um registro existente e exclui um registro na entidade sample_book.

  7. Depois de atualizar os registros, o programa redefine as informações de paginação e instancia os objetos do cache.

  8. Quando RetrieveEntityChangesRequest for chamado novamente, só recuperará os registros atualizados desde a última sincronização.

  9. Após a recuperação das alterações, o programa perguntará se você deseja exibir os registros de entidade sample_book. Se você responder com 'y', o programa tentará abrir o Internet Explorer para uma exibição mostrando os registros recém-criados.

  10. Por fim, a DeleteChangeTrackingSampleSolution solicitará que você exclua a solução gerenciada ChangeTrackingSample.

    Se você selecionar "y", a solução gerenciada será excluída incluindo a entidade sample_book e todos os dados dessa entidade. Nada será adicionado à sua organização.

    Se você selecionar "n", poderá inspecionar os detalhes da solução, incluindo os dados criados pela amostra. Mas é preciso excluir manualmente a solução gerenciada para que sua organização retorne para o 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 ChangeTrackingSample.sln usando o Visual Studio.

  3. No Visual Studio, clique com o botão da direito no projeto ChangeTrackingSample 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 2016 SDK core assemblies". Não se esqueça de selecionar a versão mais recente.

  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:
    myservername
    myprefix.myservername:5500
    crm5.dynamics.com

    Não inclua o nome da sua organização ou protocolo Internet (http ou https). Você receberá uma solicitação para isso mais tarde.

    Este servidor é configurado para Secure Sockets Layer (https) (y/n) [n]

    Digite y se a URL que você usa para acessar o Microsoft Dynamics 365 começa com https://. Caso contrário, digite n.

    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.
    Para Dynamics 365 (local), digite seu domínio de rede e o nome do usuário separados por uma barra invertida (\).

    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

Usar o controle de alterações para sincronizar dados com sistemas externos

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais