Atividade Consultar Objetos

Use o Sforce Object Query Language (SOQL) para executar uma consulta em um ou mais tipos de objetos do Salesforce.com a partir desta atividade e retorne um conjunto de resultados. A atividade Consultar Objetos é executada automaticamente em uma chamada query ou queryAll, seguida por chamadas queryMore contínuas para todos os filhos e objetos retornados do Salesforce.com.

Nota: Executar a atividade Consultar Objetos pode resultar em um cursor sendo aberto pelo Salesforce.com para controlar os resultados da consulta. Se a atividade atingir o limite do cursor que o Salesforce.com aloca para cada usuário ou se o cursor expirar, o Integration Appliance tentará a atividade novamente.

Usando a Atividade Consultar Objetos

  1. Na guia Atividades, abra o diretório do Salesforce.com para localizar a atividade Consultar Objetos.
  2. Inclua a atividade em sua orquestração.

    A Lista de Verificação e o Resumo da atividade são exibidos abaixo da orquestração.

  3. Selecione um terminal Salesforce.com.

    Para obter instruções sobre como criar ou editar um terminal Salesforce.com, consulte Criando ou Editando um Terminal Salesforce.com.

  4. Configure a atividade, especificando uma consulta e configurando opções de consulta.
  5. Especifique os parâmetros Tentar Novamente e Expirar para a atividade.
  6. Mapeie a entrada da atividade.
  7. Mapeie a saída da atividade.

Mapear a Entrada da Atividade Consultar Objetos

  1. Na Lista de Verificação, selecione Mapear Entradas.

    O elemento parameters é exibido no painel Para Atividade. O elemento parameters possui um elemento filho para cada parâmetro especificado na consulta SOQL. O contexto para o parâmetro na consulta determina o tipo de parâmetro. Se você não especificar quaisquer parâmetros, nenhum elemento filho será exibido sob o elemento parameters.

  2. Clique com o botão direito do mouse no nó padrão e escolha Mostrar Parâmetros Opcionais, para mostrar os parâmetros de entrada opcionais para esta atividade:
    • MruHeader
    • CallOptions
    • connection
    • sessionInfo
  3. Clique em Selecionar Entradas... e selecione a variável ou variáveis de entrada para o mapa.

    Para obter instruções sobre como criar variáveis, consulte Criando Variáveis.

  4. Conforme apropriado, mapeie os parâmetros de entrada para a variável ou as variáveis.

    Para instruções de mapeamento, consulte Criando um Mapa.

Mapear a Saída da Atividade Consultar Objetos

  1. Na Lista de Verificação, selecione Mapear Saídas.

    O elemento objects é exibido no painel Da Atividade. O parâmetro de resultado possui um único elemento denominado objects com um único elemento de repetição denominado após o objeto de direcionamento da consulta. O objeto de direcionamento é o primeiro objeto denominado na cláusula FROM da consulta. Por exemplo, na instrução SOQL a seguir, Account é o objeto de direcionamento:

    Select Name from Account, Account.Contacts

    O objeto de direcionamento possui elementos filhos que correspondem aos campos ou relacionamentos listados na cláusula SELECT de uma consulta. O esquema é definido da seguinte forma:
    • Para campos, o tipo de campo corresponde ao tipo SOAP do campo. O tipo de campo será nillable se o tipo SOAP for nillable.
    • Para relacionamentos para elementos-pai, o nome de elemento é o nome do pai. Se não houver pai quando a atividade executar a consulta, o elemento estará ausente. Os campos ou relacionamentos do pai são exibidos imediatamente abaixo do elemento de relacionamento.
    • Para relacionamentos para elementos filhos, o nome de elemento é o nome do filho. O elemento de relacionamento possui um único elemento de repetição nomeado após o tipo de objeto do objeto-filho. Os campos e o relacionamento do filho são exibidos abaixo do elemento de tipo de objeto. Se não houver filhos quando a atividade executar a consulta, o elemento estará ausente.
    • Se você não selecionou nenhum campo ou relacionamento mas, em vez disso, solicitou count() na cláusula SELECT, o elemento de tipo de objeto inteiro será substituído por um elemento denominado count do tipo unsignedInt.
     
  2. Clique em Selecionar Saídas... e selecione a variável ou as variáveis de saída para o mapa.

    Para obter instruções sobre como criar variáveis, consulte Criando Variáveis.

  3. Conforme apropriado, mapeie os parâmetros de saída para a variável ou as variáveis.

    Para instruções de mapeamento, consulte Criando um Mapa.




Feedback | notices