Usando a atividade Consultar objetos do Sage CRM

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

  1. Clique com o botão direito na seção Orquestrações e selecione nova orquestração.
  2. Arraste o terminal Sage CRM recém-criado para a orquestração e selecione a atividade Consultar objetos.
  3. 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.
  4. Na lista de verificação, clique em Configurar.
  5. 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 '?'.

  6. Clique em Pesquisar para selecionar o tipo de objeto. A janela Procurar Sage CRM é exibida.
  7. Em Procurar Sage CRM, é possível selecionar o tipo de objeto na lista de tipos de objetos. Clique em OK.
  8. 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.
  9. Na Lista de Verificação, clique em Tentar Novamente. Revise as configurações padrão e faça as alterações necessárias.
  10. 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.
  11. 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.
  12. 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 consulta
    Nome 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.