Como configurar o Dynamics CRM em uma atividade de cópia

Este artigo descreve como usar a atividade de cópia em um pipeline de dados para copiar dados de e para o Dynamics CRM.

Pré-requisitos

Para usar esse conector com a autenticação de entidade de serviço do Entra ID, você deve configurar a autenticação de servidor para servidor (S2S) no Dynamics CRM. Primeiro, registre o usuário do aplicativo (Service Principal) no Microsoft Entra. Para obter mais informações, consulte Criar um aplicativo e uma entidade de serviço do Microsoft Entra que possam acessar recursos.

Durante o registro do aplicativo, você precisará criar esse usuário no Dynamics CRM e conceder permissões. Essas permissões podem ser concedidas direta ou indiretamente adicionando o usuário do aplicativo a uma equipe à qual foram concedidas permissões no Dynamics CRM. Para obter mais informações sobre como configurar um usuário de aplicativo para autenticar com o Dynamics CRM, consulte Usar autenticação de servidor para servidor de locatário único.

Configuração suportada

Para a configuração de cada guia em atividade de cópia, vá para as seções a seguir, respectivamente.

• General (Geral)
• Source
• Destino
• Mapeamento
• Definições

Geral

Para Configuração da guia Geral , vá para Configurações gerais.

Origem

Vá para a guia Origem para configurar sua fonte de atividade de cópia. Consulte o conteúdo a seguir para obter a configuração detalhada.

As seguintes propriedades são necessárias:

• Tipo de armazenamento de dados: Selecione Externo.
• Conexão: selecione uma conexão existente do Dynamics CRM na lista de conexões. Se não existir nenhuma conexão, crie uma nova conexão do Dynamics CRM selecionando Novo.
• Tipo de conexão: Selecione Dynamics CRM.
• Usar consulta: especifique a maneira usada para ler dados. Você pode escolher Nome da entidade para ler dados usando o nome da entidade ou Consulta para usar a consulta para ler dados.

  • Nome da entidade: selecione o nome da entidade na lista suspensa ou selecione Editar para inseri-lo manualmente. É o nome lógico da entidade a ser recuperada.

  • Consulta: Usando FetchXML para ler dados do Dynamics CRM. FetchXML é uma linguagem de consulta proprietária que é usada no Dynamics online e local. Veja o seguinte exemplo. Para saber mais, consulte Criar consultas com FetchXML.

    Exemplo de consulta FetchXML:

    <fetch>
      <entity name="account">
        <attribute name="accountid" />
        <attribute name="name" />
        <attribute name="marketingonly" />
        <attribute name="modifiedon" />
        <order attribute="modifiedon" descending="false" />
        <filter type="and">
          <condition attribute ="modifiedon" operator="between">
            <value>2017-03-10 18:40:00z</value>
            <value>2017-03-12 20:40:00z</value>
          </condition>
        </filter>
      </entity>
    </fetch>
    

Em Avançado, você pode especificar os seguintes campos:

• Colunas adicionais: adicione colunas de dados adicionais para armazenar o caminho relativo ou o valor estático dos arquivos de origem. A expressão é suportada para este último.

Destino

Vá para a guia Destino para configurar o destino da atividade de cópia. Consulte o conteúdo a seguir para obter a configuração detalhada.

As seguintes propriedades são necessárias:

• Tipo de armazenamento de dados: Selecione Externo.
• Conexão: selecione uma conexão existente do Dynamics CRM na lista de conexões. Se não existir nenhuma conexão, crie uma nova conexão do Dynamics CRM selecionando Novo.
• Tipo de conexão: Selecione Dynamics CRM.
• Nome da entidade: especifique o nome da entidade para gravar dados. Selecione o nome da entidade na lista suspensa ou selecione Editar para inseri-lo manualmente. Este é o nome lógico da entidade a ser recuperada.

Em Avançado, você pode especificar os seguintes campos:

• Comportamento de gravação: O comportamento de gravação da operação. Esta propriedade é obrigatória e você deve selecionar Upsert. Se você usar Adicionar conteúdo dinâmico, especifique o valor para Upsert.
• Nome da chave alternativa: especifique o nome da chave alternativa definida em sua entidade para atualizar os registros.
• Ignorar valores nulos: Indica se os valores nulos dos dados de entrada devem ser ignorados durante a operação de gravação. Ele é desmarcado por padrão.
  • Quando for selecionado: Deixe os dados no objeto de destino inalterados ao fazer a operação upsert/update e insira o valor padrão definido ao fazer a operação insert.
  • Quando estiver desmarcado: atualize os dados no objeto de destino para NULL ao fazer a operação upsert/update e insira o valor NULL ao fazer a operação insert.
• Tamanho do lote de gravação: especifique a contagem de linhas de dados gravados no Dynamics CRM em cada lote.
• Máximo de conexões simultâneas: o limite superior de conexões simultâneas estabelecido para o armazenamento de dados durante a execução da atividade. Especifique um valor somente quando quiser limitar conexões simultâneas.

Mapeamento

Para Configuração da guia Mapeamento , vá para Configurar seus mapeamentos na guia Mapeamento.

Definições

Para a configuração da guia Configurações , vá para Configurar suas outras configurações na guia configurações.

Resumo da tabela

Consulte a tabela a seguir para obter o resumo e mais informações sobre a atividade de cópia do Dynamics CRM.

Fonte da informação

Informações sobre o destino

Conteúdos relacionados

• Visão geral do conector do Dynamics CRM