Ir para o conteúdo

Conexão do 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. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades do Microsoft Dynamics CRM associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

Nota

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

Nota

Este conector suporta a política de Habilitar Re-autenticação em Mudança política de organização. Se habilitada, uma alteração na URL do Serviço das Organizações ou Login nesta conexão requer que os usuários reentrem 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 a partir de uma dessas localizações:

Uma conexão existente do Microsoft Dynamics CRM pode ser editada a partir dessas localizações:

Configurar uma conexão do Microsoft Dynamics CRM

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

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu com as variáveis existentes para escolher.

  • Nome da Conexão: Insira um nome 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 (:). Este nome também é usado para identificar o endpoint do Microsoft Dynamics CRM, que se refere tanto a uma conexão específica quanto às suas atividades.

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

    Atenção

    Não use a URL do serviço da organização que está presente na página Recursos para Desenvolvedores de uma instância do Dynamics CRM na nuvem ou a URL de Descoberta Regional obsoleta.

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

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

  • Tipo de Conectividade: Selecione o tipo de conectividade que é necessário para resolver o ID do usuário registrado na instância do Microsoft Dynamics CRM. Selecione um dos seguintes: Active Directory, Federation, Live ID, Online Federation ou None.

  • ID do Aplicativo: Insira o ID do aplicativo, visível apenas quando Online Federation é selecionado como o Tipo de Conectividade. Para mais informações sobre como obter o ID do aplicativo, consulte Obter um ID de aplicativo do Microsoft Dynamics CRM.

  • Nome Único da Organização: Insira o nome único da organização. O nome único 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 política de organização Desativar Atualização Automática do Conector.

  • Salvar Alterações: Clique para salvar e fechar a configuração da 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 solicita que você confirme 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 (veja Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme 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 conector Jitterbit CRM REST incorreto está instalado. Certifique-se de que o agente privado instalado é da versão 10.42 ou posterior e que o conector Jitterbit CRM REST correto está instalado. Veja Configuração do agente do Microsoft Dynamics CRM para mais informações.
Error: Invalid Input: No input for organizationUniqueName O campo Nome Único da Organização está vazio. Insira qualquer string 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. Isso pode ser retornado quando a URL do Serviço da Organização está 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 está 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 em nuvem do Dynamics CRM. Isso pode ser retornado quando a URL do Serviço da Organização está 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 Jitterbit CRM REST não está instalado ou o serviço não está em execução. veja Configuração do agente do Microsoft Dynamics CRM para instruções sobre como instalar um Conector Jitterbit CRM REST.
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 uma URL de serviço da organização incorreta. Certifique-se de que está usando as credenciais apropriadas do Microsoft Dynamics CRM. Para informações sobre como obter o ID do aplicativo, veja Obter um ID de aplicativo do Microsoft Dynamics CRM.

Próximas etapas

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

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis no painel do projeto e na paleta de componentes de design. Para mais detalhes, veja Menus de ações em Conceitos básicos do conector.

Estes 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 é destinado a ser usado como um alvo em uma operação.

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

  • Update: Atualiza um registro de objeto existente no Microsoft Dynamics CRM e é destinado a ser usado como um alvo em uma operação.

  • Delete: Exclui um registro de objeto do Microsoft Dynamics CRM e é destinado a ser usado como um alvo em uma operação.