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