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

Este código de exemplo mostra como recuperar alterações de uma tabela e sincronizar dados com sistemas externos usando a mensagem com as RetrieveEntityChanges classes RetrieveEntityChangesRequest e RetrieveEntityChangesResponse .

Para obter mais informações sobre o recurso que este exemplo demonstra, consulte Usar o controle de alterações para sincronizar dados com sistemas externos.

Como executar este exemplo

1. Baixe ou clone o repositório Microsoft/PowerApps-Samples para que você tenha uma cópia local.
2. (Opcional) Edite o arquivo dataverse/App.config para definir um connection string especificando a instância de Microsoft Dataverse à qual você deseja se conectar.
3. Abra a solução de exemplo em Visual Studio e pressione F5 para executar o exemplo. Depois de especificar um connection string em dataverse/App.config, qualquer exemplo executado usará essas informações de conexão.

Se você não especificar um connection string no arquivo dataverse/App.config, uma caixa de diálogo será aberta sempre que você executar o exemplo e você precisar inserir informações sobre a instância do Dataverse à qual deseja se conectar e a quais credenciais deseja usar. Essa caixa de diálogo armazena em cache as conexões anteriores para que você possa escolher uma conexão usada anteriormente.

Esses exemplos neste repositório que exigem uma conexão com uma instância do Dataverse para execução incluem uma referência vinculada ao dataverse/App.config arquivo.

O que este exemplo faz

A RetrieveEntityChanges mensagem destina-se a ser usada em um cenário em que os dados de um sistema externo são sincronizados e a capacidade de usar o controle de alterações pode ser usada para detectar e reconciliar alterações de dados.

Sem um sistema separado necessário para replicar totalmente esse cenário, este exemplo simula o cenário executando duas solicitações. Entre as solicitações, alguns dados são alterados para que a segunda solicitação retorne dados sobre o que foi alterado ao longo do tempo.

Como este exemplo funciona

Para simular o cenário descrito no O que este exemplo faz, o exemplo fará o seguinte:

Configuração

1. Importar uma solução gerenciada (ChangeTrackingSample_1_0_0_0_managed.zip) que cria uma sample_book tabela que tem uma chave alternativa chamada sample_bookcode. Verifique se os índices para dar suporte à chave alternativa estão ativos
2. Os 10 registros iniciais da tabela sample_book são criados para que as alterações nessas tabelas possam ser acompanhadas.

Demonstração

1. Executar a solicitação inicial e armazenar em cache os resultados, incluindo o DataToken
2. Atualizar os registros criados na Instalação
3. Execute uma segunda solicitação, desta vez passando o valor DataVersion com o valor DataToken recuperado da solicitação inicial.
4. Mostrar as alterações de tabela retornadas pela segunda solicitação

Limpeza

Exiba uma opção para excluir a solução gerenciada importada na Instalação, que remove a sample_book tabela e todos os dados criados no exemplo. A exclusão é opcional caso você queira examinar as tabelas e os dados criados pelo exemplo. Você pode excluir manualmente o ChangeTrackingSample para obter o mesmo resultado.