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
- 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 da 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 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.
- 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
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.
- 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.