Consultar definições de esquema e detectar alterações

Este exemplo mostra como recuperar e detectar alterações nas definições de tabela usando o método RetrieveMetadataChangeRequest . Você pode exibir o exemplo em PowerApps-Samples/dataverse/orgsvc/C#-NETCore/Schema/RetrieveMetadataChanges/.

Para obter mais informações sobre a funcionalidade, consulte:

• Definições de esquema de consulta
• Dados do esquema de cache

Como executar este exemplo

Consulte as instruções nas instruções de exemplos de esquema.

Demonstrações

Este exemplo mostra como recuperar definições de esquema para um conjunto específico de definições de coluna e salvá-las na memória para representar um cache.

Em seguida, ele cria uma nova coluna, recupera os dados apenas para essa nova coluna e adiciona-os ao cache.

Em seguida, ele exclui a coluna, recupera dados sobre itens excluídos e usa esses dados para remover a definição de coluna excluída do cache.

Este exemplo tem seis seções:

Definir consulta

Defina uma consulta usando EntityQueryExpression que retorna todas as colunas de escolha picklist da tabela de contatos.

Inicializar cache

1. Crie uma instância de RetrieveMetadataChangesRequest com o parâmetro Query definido como a consulta.
2. Envie a solicitação usando IOrganizationService.Execute.
3. Armazene em cache o valor RetrieveMetadataChangesResponse.EntityMetadata .
4. Salve o valor RetrieveMetadataChangesResponse.ServerVersionStamp para uso na próxima solicitação.
5. Escreva uma lista de todas as colunas atuais no cache.

Adicionar coluna de escolha

Crie uma nova coluna de escolha criando uma nova instância PicklistAttributeMetadata nos atributos da tabela de contatos.

Detectar coluna adicionada

1. Crie uma nova instância de RetrieveMetadataChangesRequest e defina o parâmetro Query como a consulta original.
2. Defina o RetrieveMetadataChangesRequest.ClientVersionStamp com o valor retornado anteriormente da primeira solicitação.
3. Envie a solicitação usando IOrganizationService.Execute.
4. Verifique se apenas uma nova definição de coluna foi retornada para representar a coluna de escolha que você criou.
5. Salve o valor RetrieveMetadataChangesResponse.ServerVersionStamp para uso na próxima solicitação.
6. Adicione os dados da coluna de escolha ao cache.

Excluir coluna de escolha

Exclua a coluna de escolha que você criou anteriormente.

Detectar coluna excluída

1. Crie uma nova instância de RetrieveMetadataChangesRequest e defina o parâmetro Query como a consulta original.
2. Defina o RetrieveMetadataChangesRequest.ClientVersionStamp como o valor retornado da segunda solicitação.
3. Defina o RetrieveMetadataChangesRequest.DeletedMetadataFilters como DeletedMetadataFilters.Attribute porque você está procurando apenas definições de coluna excluídas.
4. Envie a solicitação usando IOrganizationService.Execute.
5. Localize a ID da coluna de escolha excluída no RetrieveMetadataChangesResponse.DeletedMetadata, usando DeletedMetadataFilters.Attribute como um valor de índice para a coleção.
6. Remova a definição da coluna do cache.
7. Escreva uma lista de todas as colunas atuais no cache.

Limpeza

Nenhuma limpeza é necessária porque todos os dados criados por este exemplo são excluídos.