Exemplo: Inserir ou atualizar um registro usando Upsert

  • Artigo

 

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

Este código de exemplo mostra como inserir ou atualizar registros usando a mensagem Upsert. Para obter mais informações sobre o recurso demonstrado por este exemplo, consulte Usar Upsert para inserir ou atualizar um registro.

Este exemplo refere-se ao Atualização 1 do Microsoft Dynamics CRM Online 2015. Isso está disponível para download de Inserir ou atualizar um registro usando Upsert.

Pré-requisitos

  1. Tenha acesso a uma organização do Atualização 1 do Microsoft Dynamics CRM Online 2015.

  2. Baixe o projeto UpsertSample do Visual Studio.

  3. Abra o projeto UpsertSample 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.

  4. 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

Instalar pacotes NuGet

Executar o exemplo

O que este exemplo faz

  1. O método Run da classe ProductUpsertSample chama o método ImportUpsertSampleSolution, que detecta primeiro se a solução gerenciada UpsertSample já está instalada. Caso não esteja, o arquivo UpsertSample_1_0_0_0_managed.zip será importado para instalar essa solução gerenciada.

    Essa solução gerenciada contém uma entidade sample_product personalizada usada por este exemplo. A entidade tem uma chave alternativa sample_productcode 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 UpsertSample. Este método sonda os metadados da entidade sample_product para atrasar a execução do resto do exemplo até que as chaves alternativas estejam prontas.

  3. Na primeira vez que o método ProcessUpsert for chamado, ele processará dados no arquivo newsampleproduct.xml para representar novos produtos. O UpsertRequest é passado para o método Execute para criar 13 novos registros.

    A propriedade UpsertResponse.RecordCreated retorna verdadeiro para indicar que novos registros foram criados.

    Antes da conclusão do método ProcessUpsert, o programa perguntará se você deseja exibir os registros da entidade do produto de exemplo. Se você responder com 'y', o programa tentará abrir o Internet Explorer para uma exibição mostrando os registros recém-criados.

  4. Na segunda vez que o método ProcessUpsert for chamado, ele processará dados no arquivo updatedsampleproduct.xml para representar atualizações para produtos anteriormente criados. A mensagem Upsert é usada para atualizar 6 registros. A propriedade UpsertResponse.RecordCreated retornará falso mostrando que registros foram atualizados.

    Novamente, o método ProcessUpsert perguntará se você deseja exibir os registros no navegador. Se você já tiver a exibição aberta, poderá simplesmente atualizar a exibição para observar as alterações.

  5. Por fim, DeleteUpsertSampleSolution solicitará que você exclua a solução gerenciada Exemplo de Upsert.

    Se você escolher "y", a solução gerenciada será excluída, incluindo a entidade sample_product 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:

  1. Baixe este exemplo e extraia os arquivos.

  2. Navegue até a pasta C# e abra o arquivo UpsertSample.sln usando o Visual Studio.

  3. No Visual Studio, clique com o botão da direito no projeto UpsertSample e escolha Gerenciar Pacotes NuGet.

  4. 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.

  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 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.com

    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.

    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 Upsert para inserir ou atualizar um registro

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais