Use a atividade Consultar objetos para executar consulta SData em um tipo de objeto especificado no
Sage CRM.
Sobre Esta Tarefa
Use essa tarefa para executar uma consulta SData em um tipo de objeto especificado na instância do Sage CRM. A chamada para
essa atividade é uma chamada síncrona em que os dados de entrada são enviados para a
atividade para processamento e a resposta é enviada de volta para a orquestração.
Procedimento
- Clique com o botão direito na seção Orquestrações e selecione nova orquestração.
- Arraste o terminal Sage CRM recém-criado para a orquestração e selecione
a atividade Consultar objetos.
- A atividade Consultar objetos será incluída na orquestração. Selecione a atividade. A Lista de verificação de Consultar objetos do Sage CRM é exibida.
- Na lista de verificação, clique em Configurar.
- Insira os parâmetros de consulta válidos com um '?' como item temporário para o valor. Para configurar
múltiplos parâmetros de consulta, separe cada parâmetro de consulta com um 'e'. Alguns exemplos de consulta:
select=?&where=?
startIndex=?&count=?
orderBy=?
select=?&where=?orderBy=?
where=Lead_UpdatedDate lt @2016-01-10@
Observe que a sequência de consultas não deve iniciar com um '?'.
- Clique em Pesquisar para selecionar o tipo de
objeto. A janela Procurar Sage
CRM é exibida.
- Em Procurar Sage CRM, é possível selecionar o tipo de objeto na lista de tipos de
objetos. Clique em OK.
- Selecione Mapear Entradas na Lista de Verificação. Os Esquemas XML gerados a partir do
objeto selecionado da atividade Consultar Objetos são exibidos como nós
sob o parâmetro de entrada de solicitação no painel Para Atividade.
- Na Lista de Verificação, clique em Tentar Novamente. Revise
as configurações padrão e faça as alterações necessárias.
- Crie um mapa entre as variáveis de orquestração e o
parâmetro de entrada da atividade.
Nota: Os valores devem ser fornecidos no tempo de execução para quaisquer
elementos obrigatórios da estrutura de entrada. Um valor pode ser fornecido ao especificar um valor padrão para o elemento ou ao
vincular o elemento a um nó de entrada. Durante o tempo de execução, se nenhum
valor for fornecido para um elemento compulsório, a atividade lançará uma exceção
que será relatada pelo Web Management Console. Se um valor não for fornecido
no tempo de execução para um parâmetro de entrada opcional, nenhuma exceção será
lançada durante o tempo de execução.
- Selecione Mapear Saídas na Lista de Verificação. O Esquema XML gerado para manter a resposta da atividade será exibido
como nós sob o parâmetro de saída response no painel
Da Atividade.
- Crie um mapa entre os parâmetros de saída e as
variáveis de orquestração.
Parâmetro de consulta:
Tabela 1. Parâmetros de consulta comuns para os Objetos de consultaNome do Campo |
Descrição |
startIndex |
Índice inicial do registro a partir do qual o resultado da chamada API deve
iniciar |
contar |
Contagem do número de objetos a serem exibidos na resposta. |
sendo que |
Especifica os critérios de filtragem. Somente os recursos que correspondem aos critérios
especificados no parâmetro where são retornados. |
orderBy |
Especifica critérios de ordenação. A coleção é classificada por ordem ascendente ou
decrescente dos nomes de atributo especificados nesse parâmetro. |
Selecionar |
Seleciona as propriedades que serão retornadas na carga útil. Esse parâmetro
permite que um cliente solicite que uma lista específica de propriedades seja retornada na carga útil. Ele fornece
controle preciso sobre a amplitude e a profundidade de informações retornadas. |
Pelo menos um dos parâmetros de consulta acima deve ter um valor mapeado/valor padrão para que a
atividade seja executada com sucesso.
Resultados
Você configurou a atividade Consultar objetos do Sage CRM.
Nota: Essa atividade funciona na busca de múltiplos registros de um tipo especificado. Dessa forma, a resposta de entrada
seria única, que é aplicável a uma única chamada API recuperar todos, para buscar múltiplos objetos.