Consulta do Conector do Microsoft Dynamics CRM¶

Introdução¶

Uma atividade Consulta do Microsoft Dynamics CRM, usando seu endpoint do Microsoft Dynamics CRM, consulta um objeto no Microsoft Dynamics CRM e se destina a ser usado como origem em uma operação.

Criando uma Atividade de Consulta do Microsoft Dynamics CRM¶

Uma instância de uma atividade Consulta do Microsoft Dynamics CRM é criada a partir de um endpoint do Microsoft Dynamics CRM usando seu tipo de atividade Query.

Para criar uma instância de uma atividade, siga uma destas opções:

• Navegue até Arquivo > Novo > Conectores > Nova consulta do MS CRM.
• Na árvore à esquerda, em Conectores, expanda Microsoft Dynamics CRM, clique com o botão direito em Consultas do MS CRM e selecione Nova consulta do MS CRM.
• Na barra de ferramentas superior, clique no ícone de conectores. Na caixa de diálogo, selecione Microsoft Dynamics CRM e, em seguida, selecione Consulta do MS CRM.

Configurando uma Atividade de Consulta do Microsoft Dynamics CRM¶

Siga estas etapas para configurar uma atividade Consulta do Microsoft Dynamics CRM:

• Etapa 1: Selecione ou crie um Endpoint
  Selecione ou crie um endpoint do Microsoft Dynamics CRM.

• Etapa 2: Selecione um objeto
  Selecione o objeto a ser consultado e selecione uma opção de construção de consultar.

• Etapa 3: Construir a Consulta
  Crie a instrução de consultar ou baixe a instrução de consultar da sua instância do Microsoft Dynamics CRM.

• Etapa 4: Revise as estruturas de dados
  Quaisquer estruturas de solicitação ou resposta geradas a partir do endpoint são exibidas.

Etapa 1: Selecione Ou Crie um Endpoint¶

Nesta etapa, selecione ou crie um endpoint no menu suspenso Endpoints do MS CRM disponíveis:

• Nome: Depois de selecionar um endpoint existente, você pode alterar o nome do endpoint aqui.
• Parâmetros de conexão: Após selecionar um endpoint existente, seus parâmetros de conexão são exibidos e você pode alterar esses parâmetros aqui. Para obter mais informações sobre cada parâmetro de conexão, consulte Endpoint do conector do Microsoft Dynamics CRM.
• Próximo: Clique para navegar para a próxima tela.
• Cancelar: Clique para fechar a configuração da atividade sem salvar.

Etapa 2: Selecione um Objeto¶

Nesta etapa, selecione o objeto a ser consultado e selecione uma opção de construção de consultar.

Selecionando um Objeto¶

Selecione o objeto a ser consultado:

• Filtro: Insira qualquer parte do nome do objeto na caixa de pesquisa para filtrar a lista de objetos. A busca não diferencia maiúsculas de minúsculas. Se os objetos já estiverem exibidos na tabela, os resultados da tabela serão filtrados em tempo real a cada pressionamento de tecla. Para recarregar objetos do endpoint durante a pesquisa, insira os critérios de pesquisa e atualize, conforme descrito abaixo.
• Mostrar: Selecione Nome lógico ou Nome de exibição para alterar a exibição dos nomes dos objetos.
• Selecionando um objeto: Na tabela, clique em qualquer lugar de uma linha para selecionar um objeto. Apenas um objeto pode ser selecionado. O objeto selecionado é destacado em azul.
• Atualizar: Clique para recarregar objetos do endpoint do Microsoft Dynamics CRM. Isso poderá ser útil se objetos tiverem sido adicionados ao Microsoft Dynamics CRM. Esta ação atualiza todos os metadados usados para construir a tabela de objetos exibidos na configuração.
• Voltar: Clique para retornar à etapa anterior.
• Próximo: Clique para continuar para a próxima tela.
• Cancelar: Clique para fechar a configuração da atividade sem salvar.

Selecionando uma Opção de Construção de Consulta¶

Selecione a Opção de criação de consulta apropriada para sua situação:

• Usar o Query Builder do Jitterbit: Selecione para usar o construtor de consultar do Jitterbit, onde você pode criar uma instrução de consultar, seja automaticamente selecionando campos e especificando condições, ou manualmente inserindo diretamente uma instrução de consultar. Para obter mais informações, consulte Usar o Query Builder do Jitterbit abaixo.
• Baixar ou copiar uma consulta salva do seu sistema CRM: Selecione para baixar ou copiar uma consultar salva anteriormente da sua instância do Microsoft Dynamics CRM.
• Voltar: Clique para retornar à etapa anterior.
• Próximo: Clique para continuar para a próxima tela.
• Cancelar: Clique para fechar a configuração da atividade sem salvar.

Etapa 3: Construir a Consulta¶

Nesta etapa, crie a instrução de consultar ou consultar -a da sua instância do Microsoft Dynamics CRM.

A interface usada nesta etapa da configuração de uma atividade Consulta do Microsoft Dynamics CRM depende das Opções de criação de consulta selecionadas em Etapa 2: selecionar um objeto:

• Use o Construtor de Consultas do Jitterbit: esta opção preencherá uma lista de buckets existentes para você escolher.

• Baixe ou copie uma consulta salva do seu sistema CRM: para esta opção, você inserirá manualmente o nome do bucket do Amazon S3.

Use o Construtor de Consultas do Jitterbit¶

Se Use Jitterbit's Query Builder estiver selecionado para Query Building Options, esta interface será apresentada:

• Selecionar atributos: Esta seção exibe atributos disponíveis no endpoint do Microsoft Dynamics CRM:

  • Usar todos os atributos: Selecione consultar todos os atributos na lista preenchida.
  • Filtro: Insira qualquer parte do nome do atributo na caixa de pesquisa para filtrar a lista de atributos. A busca não diferencia maiúsculas de minúsculas. Se os atributos já estiverem exibidos na tabela, os resultados da tabela serão filtrados em tempo real a cada pressionamento de tecla.
  • Selecionar tudo: Clique para selecionar todos os atributos da consultar.
  • Remover tudo: Clique para desmarcar quaisquer atributos selecionados anteriormente para a consultar.

• Fetch XML resultante:** À medida que você seleciona os campos, a instrução de consultar na caixa de texto Fetch XML resultante é preenchida automaticamente com o objeto, os atributos selecionados e as condições.

• Filtro: Adiciona condições para filtrar ainda mais a consultar. Na seção Filtro, para selecionar os operadores apropriados, um de AND ou OR:

  • AND: Selecione para consultas que exigem que as expressões esquerda e direita sejam true.

  • OU: Selecione para consultas que exigem que a expressão esquerda ou direita seja true.

  • Adicionar: Clique para adicionar uma condição. Após clicar em Adicionar, uma caixa de diálogo será exibida:

    

    • Selecionar Atributo: Insira qualquer parte do nome do atributo na caixa de pesquisa para preencher a lista de atributos aplicáveis. Os resultados são filtrados em tempo real a cada pressionamento de tecla. Como alternativa, clique em Selecionar para escolher em uma lista preenchida de atributos disponíveis.
    • Selecionar operador: Insira qualquer parte do operador na caixa de pesquisa para preencher a lista de operadores aplicáveis. Os resultados são filtrados em tempo real a cada pressionamento de tecla. Como alternativa, clique em Selecionar para escolher em uma lista preenchida de operadores disponíveis.
    • Insira o valor: Insira o valor desejado para usar com as seleções anteriores.
    • Cancelar: Clique para fechar a caixa de diálogo sem salvar a condição.
    • Ok: Clique para fechar a caixa de diálogo e salvar a condição.

  • Editar: Selecione uma condição criada anteriormente e clique em Editar para modificar as seleções da condição.

  • Excluir: Selecione uma condição criada anteriormente e clique em Excluir para remover a condição da consultar.

• Ordem: Adiciona pedidos para filtrar a resposta:

  • Adicionar: Clique para adicionar um pedido a um atributo. Após clicar em Adicionar, uma caixa de diálogo será exibida:

    

    • Pesquisar: Insira qualquer parte do nome do atributo na caixa de pesquisa para preencher a lista de atributos aplicáveis. Os resultados são filtrados em tempo real a cada pressionamento de tecla.
    • Selecionar: Clique para escolher um atributo em uma lista preenchida de atributos disponíveis.
    • Lista suspensa: Use a lista suspensa para selecionar a ordem do atributo, entre Crescente ou Decrescente.

  • Editar: Selecione um pedido criado anteriormente e clique em Editar para modificar as seleções do pedido.

  • Excluir: Selecione um pedido criado anteriormente e clique em Excluir para remover o pedido da consultar.

• Link Entidades: Adiciona um relacionamento de entidade à consultar:

  • Adicionar: Clique para adicionar um relacionamento de entidade à consultar.
  • Editar: Selecione uma entidade vinculada anteriormente e clique em Editar para modificar as seleções das entidades vinculadas.
  • Excluir: Selecione uma entidade vinculada anteriormente e clique em Excluir para remover as entidades vinculadas da consultar.

• Voltar: Clique para retornar à etapa anterior.

• Concluir: Clique para revisar as estruturas de dados e concluir a configuração da atividade.
• Cancelar: Clique para fechar a configuração da atividade sem salvar.

Baixe Ou Copie uma Consulta Salva do Seu Sistema CRM¶

Se Baixar ou copiar uma consulta salva do seu sistema CRM estiver selecionado em Opções de criação de consulta, esta interface será apresentada:

• Selecione uma consulta: Use o menu suspenso para selecionar uma consultar salva na instância do Microsoft Dynamics CRM.
• Baixar consultas salvas: Clique para baixar consultas salvas da instância do Microsoft Dynamics CRM.
• Editor de texto: Você pode criar uma instrução de consultar manualmente inserindo ou colando diretamente uma instrução XML de consultar no editor de texto.
• Editor de Árvore: Selecione um valor de condição no Editor de Árvore para editar o valor:
  • Editar valor da condição: Insira o valor da condição desejada.
  • Aplicar: Clique para aplicar o valor da condição à instrução de consultar.
• Voltar: Clique para retornar à etapa anterior.
• Concluir: Clique para revisar as estruturas de dados e concluir a configuração da atividade.
• Cancelar: Clique para fechar a configuração da atividade sem salvar.

Etapa 4: Revise as Estruturas de Dados¶

Quaisquer estruturas de solicitação ou resposta geradas a partir do endpoint serão exibidas. Cada elemento da interface do usuário desta etapa é descrito abaixo.

• Nome: Insira um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade Consulta do Microsoft Dynamics CRM.
• Endpoint: Selecione ou crie um novo endpoint a ser usado para a atividade Query.
• Editar: Clique para editar o Microsoft Dynamics CRM Connector Endpoint selecionado.
• Tipo: O tipo de atividade é exibido aqui.
• Objeto: O objeto selecionado anteriormente em Etapa 2: Selecione um objeto é exibido aqui.
• XML de consulta: Clique em Editar para modificar o XML de consultar configurado anteriormente.
• Usar em uma integração: Selecione Criar operação, Criar solicitação ou Criar resposta.
  • Criar operação: Clique para criar uma operação usando a atividade Consulta configurada.
  • Criar solicitação: Clique para navegar até o Assistente de Transformação, onde você pode configurar uma transformação de solicitação para a atividade Query configurada.
  • Criar resposta: Clique para navegar até o Assistente de Transformação, onde você pode configurar uma transformação de resposta para a atividade Query configurada.

Próximos Passos¶

Para obter informações sobre como usar atividades configuradas em uma operação, consulte estes recursos:

• Criando uma operação
• Opções de operação