Ir para o conteúdo

Conexão com o Microsoft Dynamics CRM

Introdução

Uma conexão do Microsoft Dynamics CRM, criada usando o conector do Microsoft Dynamics CRM, estabelece acesso ao Microsoft Dynamics CRM. Depois que uma conexão é configurada, você pode criar instâncias de atividades do Microsoft Dynamics CRM associadas a essa conexão para serem usadas como origens (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Nota

Uma conexão com o Microsoft Dynamics CRM requer o uso de um Harmony agente privado do Windows com um Jitterbit Microsoft Dynamics CRM REST Connector. Esses dois softwares devem ser baixados, instalados e configurados antes do uso e da configuração deste Cloud Studio Microsoft Dynamics CRM Connector. Para obter mais informações, consulte Configuração do agente do Microsoft Dynamics CRM.

Nota

Este conector suporta a política da organização Habilitar Reautenticação na Alteração. Se habilitado, uma alteração no URL do serviço de organizações ou no Login nesta conexão exigirá que os usuários insiram novamente a Senha para a conexão.

Criar Ou Editar uma Conexão do Microsoft Dynamics CRM

Uma nova conexão do Microsoft Dynamics CRM é criada usando o conector do Microsoft Dynamics CRM de um destes locais:

Uma conexão existente do Microsoft Dynamics CRM pode ser editada nestes locais:

Configurar uma Conexão do Microsoft Dynamics CRM

Cada elemento da interface do usuário da tela de configuração de conexão do Microsoft Dynamics CRM é descrito abaixo.

Configuração de conexão do Microsoft Dynamics CRM

Dica

Campos com um ícone de variável Ícone de variável suporte usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir uma lista das variáveis existentes para escolher.

  • Nome da conexão: Insira um nome para usar para identificar a conexão. O nome deve ser exclusivo para cada conexão do Microsoft Dynamics CRM e não deve conter barras (/) ou dois pontos (:). Esse nome também é usado para identificar o endpoint do Microsoft Dynamics CRM, que se refere a uma conexão específica e suas atividades.

  • URL do serviço da organização: Para localizar a URL do serviço da organização em uma instância de nuvem do Dynamics CRM, faça login na instância e clique no cartão Dynamics 365 — personalizado. Use o domínio completo (excluindo o caminho) que está presente na barra de endereços do seu navegador da Web como entrada para este campo.

    Cuidado

    Não use a URL do serviço da organização presente na página Recursos para desenvolvedores de uma instância de nuvem do Dynamics CRM ou a URL de descoberta regional obsoleta.

  • Login: Insira o ID do usuário registrado na instância do Microsoft Dynamics CRM.

  • Senha: Digite a senha para o ID de usuário registrado na instância do Microsoft Dynamics CRM.

  • Tipo de conectividade: Selecione o tipo de conectividade necessário para resolver o ID do usuário registrado com a instância do Microsoft Dynamics CRM. Selecione um dos seguintes:** Active Directory, **Federação, Live ID, Federação Online ou Nenhum.

  • ID do aplicativo: Insira o ID do aplicativo, visível somente quando Federação Online estiver selecionado como o Tipo de conectividade. Para obter mais informações sobre como obter o ID do aplicativo, consulte Obter um ID do aplicativo do Microsoft Dynamics CRM.

  • Nome exclusivo da organização: Insira o nome exclusivo da organização. O nome exclusivo da organização pode ser qualquer string sem espaços.

  • Nome de Domínio: Insira o domínio ao qual o ID do usuário pertence. Insira o nome de domínio completo, conforme determinado pelo Tipo de Conectividade selecionado.

  • Teste: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta a suspensão do download da versão mais recente do conector usando a Desabilitar atualização automática do conector política da organização.

  • Salvar alterações: Clique para salvar e fechar a configuração de conexão.

  • Descartar alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para você confirmar que deseja descartar as alterações.

  • Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (consulte Dependências, exclusão e remoção de componentes). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Erros Comuns de Conexão

Estes são erros comuns de conexão e suas soluções:

Erro Causa Solução
Error: AUTHORIZATION ERROR: Test connection failed., reason:CData elements not valid at top level of an XML document. A versão do agente privado é muito antiga ou o Jitterbit CRM REST Connector incorreto está instalado. Certifique-se de que o agente privado instalado seja a versão 10.42 ou posterior e que o Jitterbit CRM REST Connector correto esteja instalado. Consulte Configuração do agente do Microsoft Dynamics CRM para mais informações.
Error: Invalid Input: No input for organizationUniqueName O campo Nome exclusivo da organização está vazio. Insira qualquer sequência de caracteres sem espaços.
Error: Connection Timeout A rede pode estar bloqueando o tráfego de saída. Verifique com os administradores de rede para garantir que o tráfego de saída para essa URL seja permitido.
Connector Error: The fatal error : Not initialized. Este erro pode ser retornado de um servidor Dynamics CRM 2011. Ele pode ser retornado quando a URL do Serviço da Organização estiver incorreta. Verifique se a URL do Serviço da Organização está correta e não está usando uma URL de Descoberta Regional.
Connector Error: The fatal error : Value cannot be null. Este erro pode ser retornado de uma instância local do Dynamics CRM. Isso pode ser retornado quando a URL do Serviço da Organização estiver incorreta. Verifique se a URL do Serviço da Organização está correta e não está usando uma URL de Descoberta Regional.
Connector Error: The fatal error : AUTHORIZATION ERROR: Test connection failed., reason:One or more errors occurred. Este erro pode ser retornado de uma instância de nuvem do Dynamics CRM. Isso pode ser retornado quando a URL do Serviço da Organização estiver incorreta. Verifique se a URL do Serviço da Organização está correta e não está usando uma URL de Descoberta Regional.
Connector Error: The call to url http://127.0.0.1:8000/CRM/TestConnection failed. reason : Connect to 127.0.0.1:8000[/127.0.0.1] failed: connection refused: connect o conector REST do Jitterbit CRM não está instalado ou o serviço não está em execução. consulte Configuração do agente do Microsoft Dynamics CRM para obter instruções sobre como instalar um conector REST do Jitterbit CRM.
Fatal Error: Object reference not set to an instance of an object. Há um ID de aplicativo incorreto, nome de usuário ou senha incorretos ou URL de serviço da organização incorreto. Certifique-se de que você esteja usando as credenciais apropriadas do Microsoft Dynamics CRM. Para obter informações sobre como obter o ID do aplicativo, consulte Obter um ID de aplicativo do Microsoft Dynamics CRM.

Próximos Passos

Após a criação de uma conexão com o Microsoft Dynamics CRM, você coloca um tipo de atividade na quadro de design para criar instâncias de atividade a serem usadas como origens (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

As ações de menu para uma conexão e seus tipos de atividade são acessíveis a partir do painel do projeto e da paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.

Esses tipos de atividade estão disponíveis:

  • Upsert: Atualiza um registro de objeto existente ou cria um novo registro de objeto no Microsoft Dynamics CRM e deve ser usado como um destino em uma operação.

  • Criar: Cria um registro de objeto no Microsoft Dynamics CRM e se destina a ser usado como um alvo em uma operação.

  • Atualizar: Atualiza um registro de objeto existente no Microsoft Dynamics CRM e deve ser usado como um destino em uma operação.

  • Excluir: Exclui um registro de objeto do Microsoft Dynamics CRM e deve ser usado como um destino em uma operação.