Como configurar o Dynamics CRM em uma atividade Copy

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

Pré-requisitos

Para usar este conector com a autenticação de entidade de serviço do Entra ID, é necessário configurar a autenticação de servidor para servidor (S2S) no CRM do Dynamics. Primeiro registre o usuário do aplicativo (Entidade de Serviço) no Microsoft Entra. Para obter mais informações, consulte Criar um aplicativo do Microsoft Entra e uma entidade de serviço que possa 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 que recebeu 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 com suporte

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

• Geral
• Origem
• Destino
• Mapeamento
• Configurações

Geral

Para a configuração da guia Geral, acesse Configurações gerais.

Fonte

Acesse a guia Origem para configurar a origem 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 nenhuma conexão existir, 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 ler dados usando a consulta.

  • 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: usar FetchXML para ler dados do Dynamics CRM. FetchXML é uma linguagem de consulta proprietária usada no Dynamics online e local. Veja o exemplo a seguir. Para obter mais informações, confira 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 tem suporte para o último.

Destino

Acesse 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 nenhuma conexão existir, 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. Esse é o nome lógico da entidade a ser recuperada.

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

• Comportamento de gravação: o comportamento da operação de gravação. Essa propriedade é necessária e você deve selecionar Upsert. Se você usar Adicionar conteúdo dinâmico, especifique o valor como Upsert.
• Nome alternativo da chave: especifique o nome de chave alternativo definido em sua entidade para registros do Upsert.
• Ignorar valores nulos: indica se deve ignorar valores nulos de dados de entrada durante a operação de gravação. Ele não é selecionado por padrão.
  • Quando está selecionado: deixe os dados no objeto de destino inalterados ao fazer a operação upsert/atualização e insira valor definido pelo padrão ao fazer a operação de inserção.
  • Quando não está selecionado: atualize os dados no objeto de destino inalterados para NULL ao fazer a operação upsert/atualização e insira valor definido pelo padrão ao fazer a operação de inserção.
• 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 estabelecidas para o armazenamento de dados durante a execução da atividade. Especifique um valor somente quando desejar limitar as conexões simultâneas.

Mapeamento

Para Configuração da guia Mapeamento, acesseConfigurar seus mapeamentos na guia mapeamento.

Configurações

Para configuração da guia Configurações, acesse Definir 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 Copy do Dynamics CRM.

Informações de origem

Nome	Descrição	Valor	Obrigatório	Propriedade do script JSON
Tipo de armazenamento de dados	Seu tipo de armazenamento de dados.	Externo	Yes	/
Conexão	Sua conexão com o armazenamento de dados de origem.	< sua conexão do Dynamics CRM >	Sim	connection
Tipo de conexão	Seu tipo de conexão.	Dynamics CRM	Sim	tipo(em typeProperties ->source ->datasetSettings): DynamicsCrmEntity
Usar consulta	A maneira de ler dados do Dynamics CRM	*Tabelas *Consulta	Sim	/
Nome da entidade	O nome lógico da entidade a ser recuperada.	< seu nome de entidade >	Sim	entityName
Consulta	Usa FetchXML para ler dados do Dynamics CRM. FetchXML é uma linguagem de consulta proprietária usada no Dynamics online e local. Para obter mais informações, confira Criar consultas com FetchXML.	< sua consulta >	Sim	Consulta
Colunas adicionais	Adicione colunas de dados adicionais para armazenar o caminho relativo ou o valor estático dos arquivos de origem. A expressão tem suporte para o último.	* Nome * Valor	Não	additionalColumns: * nome * valor

Informações de destino

Nome	Descrição	Valor	Obrigatório	Propriedade do script JSON
Tipo de armazenamento de dados	Seu tipo de armazenamento de dados.	Externo	Yes	/
Conexão	Sua conexão com o Dynamics CRM de destino.	< sua conexão >	Yes	connection
Tipo de conexão	Seu tipo de conexão.	Dynamics CRM	Sim	tipo(em typeProperties ->sink ->datasetSettings): DynamicsCrmEntity
Nome da entidade	O nome lógico da entidade a ser recuperada.	< sua entidade >	Sim	entityName
Comportamento de gravação	O comportamento da operação de gravação. O valor precisa ser Upsert.	Upsert	Sim	writeBehavior: upsert
nome alternativo da chave	O nome da chave alternativa definido na entidade para registros upsert.	< nome da chave alternativa >	Não	alternateKeyName
Ignorar valores nulos	Indica se deve ignorar valores nulos de dados de entrada durante a operação de gravação. - Selecionado (true): deixe os dados no objeto de destino inalterados ao fazer a operação upsert/atualização e insira valor definido pelo padrão ao fazer a operação de inserção. - Não selecionado (false): atualize os dados no objeto de destino inalterados para NULL ao fazer a operação upsert/atualização e insira valor definido pelo padrão ao fazer a operação de inserção.	selecionado ou não selecionado (padrão)	Não	ignoreNullValues: true ou false (padrão)
Tamanho do lote de gravação	A contagem de linhas de dados gravados no Dynamics em cada lote.	<seu tamanho do lote de gravação> O valor padrão é 10	Não	writeBatchSize
Máximo de conexões simultâneas	O limite superior de conexões simultâneas estabelecidas com o armazenamento de dados durante a execução da atividade. Especifique um valor somente quando desejar limitar as conexões simultâneas.	< máximo de conexões simultâneas >	Não	maxConcurrentConnections

Conteúdo relacionado

• Visão geral do conector do Dynamics CRM