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.
Usando a Atividade Consultar Objetos
- Na guia Atividades, abra o diretório do Salesforce.com para localizar a atividade Consultar Objetos.
- Inclua a atividade em sua orquestração.
A Lista de Verificação e o Resumo para a atividade são exibidos abaixo da orquestração.
- 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.
- Configure a atividade, especificando uma consulta e configurando opções de consulta.
- Especifique os parâmetros Tentar Novamente e Expirar para a atividade.
- Mapeie a entrada da atividade.
- Mapeie a saída da atividade.
Mapear a Entrada da Atividade Consultar Objetos
- Na
Lista de Verificação, selecione
Mapear Entradas.
O elemento parameters é exibido no painel Atividade de Destino. 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.
- 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
- 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.
- 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
- Na Lista de Verificação, selecione Mapear
Saídas.
O elemento objects é exibido no painel Atividade de Partida. 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.
- 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.
- 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.