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:
- A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
- A página Conexões globais (consulte Criar um endpoint global em Conexões Globais).
Uma conexão existente do Microsoft Dynamics CRM pode ser editada nestes locais:
- A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
- A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).
- A página Conexões globais (consulte Editar um endpoint global em Conexões Globais).
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.
Dica
Campos com um í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.