Exemplo: Sincronizar dados com sistemas externos usando o controle de alterações
Publicado: novembro de 2016
Aplicável a: Dynamics CRM 2015
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.
Este exemplo refere-se ao Atualização 1 do Microsoft Dynamics CRM Online 2015. Ela está disponível para download de Sincronizar dados com sistemas externos usando o controle de alterações.
Pré-requisitos
Tenha acesso a uma organização do Atualização 1 do Microsoft Dynamics CRM Online 2015.
Baixe o projeto ChangeTrackingSample do Visual Studio.
Abra o projeto ChangeTrackingSample do Visual Studio e instale o Pacote NuGet do Microsoft.CrmSdk.CoreAssemblies versão 7.1.0-preview. Consulte Instalar pacotes NuGet 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
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.
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.
O método CreateRequiredRecords gera 10 registros na entidade sample_book.
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.
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.
O métodoUpdateRecords adiciona dez novos registros, atualiza um registro existente e exclui um registro na entidade sample_book.
Depois de atualizar os registros, o programa redefine as informações de paginação e instancia os objetos do cache.
Quando RetrieveEntityChangesRequest for chamado novamente, só recuperará os registros atualizados desde a última sincronização.
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.
Por fim, a DeleteChangeTrackingSampleSolution solicitará que você exclua a solução gerenciada ChangeTrackingSample.
Se você escolher "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ê escolher "n", poderá inspecionar os detalhes da solução, incluindo os dados criados pelo exemplo. 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:
Baixe este exemplo e extraia os arquivos.
Navegue até a pasta C# e abra o arquivo ChangeTrackingSample.sln usando o Visual Studio.
No Visual Studio, clique com o botão da direito no projeto ChangeTrackingSample e escolha Gerenciar pacotes NuGet.
Para a versão de visualização, escolha 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.
Clique em Instalar. Você precisará aceitar os termos de licença para concluir a instalação desse pacote.
Executar o exemplo
No Visual Studio, com a solução aberta e os pacotes NuGet necessários instalados, pressione F5.
Caso você não tenha executado anteriormente um dos exemplos de código gerenciado do Microsoft Dynamics CRM antes, será necessário inserir informações para executar o código; caso contrário, insira o número para um dos servidores do CRM configurado anteriormente.
Solicitar
Descrição
Insira um nome de servidor do CRM e uma porta [crm.dynamics.com]
Digite o nome do seu servidor do Microsoft Dynamics CRM. O padrão é Microsoft Dynamics CRM Online (crm.dynamics.com) na América do Norte.
Exemplo:
crm5.dynamics.comEsta 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.
O exemplo executará as operações descritas em O que este exemplo faz e pode solicitar a você opções adicionais.
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
© 2017 Microsoft. Todos os direitos reservados. Direitos autorais