Compartilhar via


Exemplo: executar várias solicitações

Este exemplo mostra como executar várias solicitações de mensagem da organização usando uma única chamada de método de serviço Web, passando ExecuteMultipleRequest como um parâmetro. Reduzir o número de solicitações de mensagem que devem ser transmitidas pela rede resulta no aumento do desempenho de processamento de mensagens.

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 ExecuteMultipleRequest mensagem destina-se a ser usada em um cenário em que contém dados necessários para executar uma ou mais solicitações de mensagens como uma única operação em lote e, opcionalmente, retornar uma coleção de resultados.

Como este exemplo funciona

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

Configuração

Verifica a versão atual da organização.

Demonstração

  1. O ExecuteMultipleRequest método cria o ExecuteMultipleRequest objeto.
  2. O ExecutingMultipleSettings método atribui configurações que definem o comportamento de execução: continuar com o erro, retornar respostas.
  3. O OrganizationRequestCollection método cria uma coleção de solicitações de organização vazia.
  4. O CreateRequest método é adicionado para cada tabela à coleção de solicitações.
  5. A GetCollectionOdEntitiesToUpdate classe atualiza as tabelas criadas anteriormente.

Limpeza

Exiba uma opção para excluir os registros criados na Instalação. A exclusão é opcional caso você queira examinar as tabelas e os dados criados pelo exemplo. Você pode excluir manualmente os registros para obter o mesmo resultado.