Usando a atividade Procurar objetos do Marketo

Use a atividade Procurar objetos para buscar detalhes de objetos do Marketo.

Sobre Esta Tarefa

Use essa tarefa para procurar objetos com base no valor de filtro especificado na instância do Marketo. 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. Em uma orquestração ativa, abra a guia Atividades e expanda o conteúdo da pasta Marketo.
  2. Arraste o ícone da atividade Procurar Objetos para a orquestração. Selecione a atividade. A Lista de verificação de Procurar objetos do Marketo é exibida.
  3. Na lista de verificação, clique em Resumo.
  4. Revise o conteúdo do campo Nome da Atividade e faça as mudanças necessárias.
  5. Na lista de verificação, clique em Selecionar terminal.
  6. Clique em Procurar e use a caixa de diálogo Explorador de Projetos para selecionar o terminal Marketo relevante.
  7. Opcional: é possível criar o terminal clicando em Novo e especificando os detalhes necessários da conexão. Clique em OK para salvar e usar o terminal para essa configuração.
  8. Para fazer as alterações necessárias na configuração do terminal selecionado, clique em Editar para acessar as opções em uma janela separada. Quaisquer mudanças feitas globalmente afetam todos os usos desse terminal em orquestrações ativas.
  9. Na lista de verificação, clique em Configurar.
  10. Clique em Pesquisar para selecionar o tipo de objeto. A janela Procurar Marketo é exibida.
  11. Na janela Procurar Marketo, é possível selecionar o tipo de objeto na lista de tipos de objetos. Clique em OK.
  12. Na Lista de Verificação, clique em Tentar Novamente. Revise as configurações padrão e faça as alterações necessárias.
    Nota: Para obter informações adicionais, consulte Especificando as opções de Nova tentativa para atividades do Marketo REST API.
  13. Selecione Mapear Entradas na Lista de Verificação. Os Esquemas XML gerados a partir do objeto selecionado da atividade Procurar Objetos são exibidos como nós sob o parâmetro de entrada de solicitação no painel Para Atividade.
  14. 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.
  15. 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.
  16. Crie um mapa entre os parâmetros de saída e as variáveis de orquestração.

Resultados

Você configurou a atividade Procurar objetos do Marketo.
Nota:

É possível incluir mais de um objeto como entrada para esta atividade. Para incluir mais de um objeto como entrada, clique com o botão direito no campo ID (por exemplo: Campanha) na área de janela Atividade de destino de Mapear entradas e selecione Expandir ocorrências.

Além disso, é possível incluir mais de um valor para fields e filterValues como entrada na atividade (por exemplo: Lead). Para incluir mais de um valor como entrada, clique com o botão direito em filterValues e fields na área de janela Atividade de destino de Mapear entradas e selecione Expandir ocorrências.

Tabela 1. Detalhes dos campos de entrada
Nome do Campo Descrição
filterType Esse valor de parâmetro depende dos tipos de filtro suportados para o objeto.
filterValues valor que será usado para a operação de procura; o usuário pode fornecer múltiplos valores ao expandir esse nó.
fields lista de nomes de campos a serem retornados na resposta. Se o parâmetro fields não estiver incluído nesta solicitação, os campos padrão correspondentes aos objetos serão retornados.
batchSize O número de registros a serem retornados em uma única chamada (padrão e depende da API de Marketo. Atualmente é 300)
nextPageToken Usado para paginar por grandes conjuntos de resultados