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. 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 fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Nota

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

Nota

Este conector oferece suporte a Ativar reautenticação ao alterar política da organização. Se ativado, uma alteração no Organizations Service URL ou Login nesta conexão exige que os usuários digitem 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 a partir destes 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 a seguir.

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

Dica

Campos com í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 da variável para exibir uma lista das variáveis existentes para escolher.

  • Nome da conexão: Digite 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 (:). 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 o URL do serviço da organização, faça logon na instância do Microsoft Dynamics CRM 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 como entrada para este campo.

    Nota

    A URL do serviço da organização que está presente na página Recursos para desenvolvedores da instância do Dynamics CRM não é a URL do serviço da organização apropriada a ser usada.

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

  • Senha: Digite a senha para o ID do 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 uma das opções Active Directory, Federação, Live ID, Federação Online ou Nenhuma.

  • Application ID: Digite o ID do aplicativo, visível apenas quando Online Federation for selecionado como o Connectivity Type. Para obter mais informações sobre como obter a ID do aplicativo, consulte Obtendo uma ID de 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 do 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.

  • Test: Clique para verificar a conexão usando a configuração fornecida.

  • Save Changes: 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 (consulte Dependências, exclusão e remoção de componentes). Uma mensagem solicita que você confirme que deseja excluir a conexão.

Possíveis Erros de Conexão

Estes são possíveis erros 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 REST do Jitterbit CRM incorreto está instalado. Certifique-se de que o Agente Privado instalado seja da 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 maiores informações.
Error: Invalid Input: No input for organizationUniqueName O campo Nome exclusivo da organização está vazio. Digite 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 esse URL seja permitido.
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. 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. Verifique se você está usando as credenciais apropriadas do Microsoft Dynamics CRM. Para obter informações sobre como obter a ID do aplicativo, consulte Obtendo uma ID de aplicativo do Microsoft Dynamics CRM.

Próximos Passos

Após a criação de uma conexão do Microsoft Dynamics CRM, você coloca um tipo de atividade na quadro de design para criar instâncias de atividade a serem usadas como fontes (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 no painel do projeto e na paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.

Estes tipos de atividade estão disponíveis:

  • Inserir: Atualiza um registro de objeto existente ou cria um novo registro de objeto no Microsoft Dynamics CRM e destina-se a ser usado como destino em uma operação.

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

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

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