Ir para o conteúdo

Atividade de Consulta em Massa do ServiceMax

Introdução

Uma atividade de consulta em massa do ServiceMax consulta um grande número de registros de um endpoint do ServiceMax e deve ser usada como fonte para fornecer dados para uma operação. Depois de configurar uma conexão ServiceMax, você pode configurar quantas atividades ServiceMax desejar para cada conexão ServiceMax.

A atividade de consulta em massa é mais rápida e tem melhor escalabilidade do que uma atividade de consulta ServiceMax não em massa, mas deverá ser usado somente se você não precisar usar uma transformação para alterar os dados antes de atingir seu destino. (As atividades em massa do ServiceMax não podem ser usadas com transformações.)

O conector ServiceMax suporta Salesforce Bulk API 2.0. Para obter mais informações, consulte Pré-requisitos e versões de API suportadas.

Crie uma Atividade ServiceMax

Uma instância de uma atividade é criada a partir de uma conexão usando um tipo de atividade.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a quadro de design ou copie o tipo de atividade e cole-o na quadro de design. Para obter detalhes, consulte Criando uma instância de atividade em Reutilização de componentes.

Uma atividade existente pode ser editada nestes locais:

Configurar uma Atividade de Consulta em Massa do ServiceMax

Siga estas etapas para configurar uma atividade de consulta em massa do ServiceMax:

Etapa 1: Insira um Nome e Selecione Objetos

Nesta etapa, você fornece um nome para a atividade e seleciona os objetos a serem consultados em massa.

atividade de consultar em massa servicemax 1

  • Nome: Insira um nome a ser usado para identificar a atividade do ServiceMax Bulk Query. O nome deve ser exclusivo para cada atividade de consulta em massa do ServiceMax e não deve conter barras (/) ou dois pontos (:).

  • Selecionar objeto(s): Esta seção exibe objetos disponíveis no endpoint ServiceMax:

  • Visualizar: Use o menu suspenso para filtrar a lista de objetos que suportam consulta em massa para Padrão, Personalizado ou Todos os objetos. Por padrão, todos os objetos são mostrados.

    • Pesquisar: Insira qualquer parte do nome do objeto na caixa de pesquisa para filtrar a lista de objetos. A busca não diferencia maiúsculas de minúsculas.

    • Atualizar: Clique no ícone de atualização ícone de atualização para recarregar objetos e campos do endpoint ServiceMax. Isso pode ser útil se você adicionou recentemente objetos ou campos ao ServiceMax.

    • Selecionar objeto(s): Clique em um objeto da lista de objetos para selecioná-lo. Apenas um objeto pode ser selecionado.

      Nota

      Se a lista não for preenchida com objetos disponíveis, a conexão ServiceMax pode não ter sucesso. Certifique-se de estar conectado reabrindo a conexão e testando novamente as credenciais.

  • Salvar e Sair: Se ativado, clique para salvar a configuração desta etapa e feche a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e prosseguir para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar alterações: Após fazer as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 2: Selecione Campos e Crie Condições

Nesta etapa, você cria a instrução de consultar automaticamente, selecionando campos e especificando condições, ou manualmente, inserindo diretamente uma instrução de consultar. Você deve testar a consultar para garantir que ela seja válida antes de continuar.

atividade de consultar em massa servicemax 2

Nota

Campos com ícone de variável ícone de variável suporta o uso de variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone da variável para exibir uma lista das variáveis existentes para escolher.

  • Selecionar campos e criar condições: Esta seção exibe campos para os objetos selecionados que estão disponíveis no endpoint do Salesforce. Os objetos selecionados na etapa anterior são mostrados em negrito.

    • Pesquisar: Insira qualquer parte do nome do campo na caixa de pesquisa para filtrar a lista de campos. A busca não diferencia maiúsculas de minúsculas. Os resultados listados são filtrados em tempo real a cada pressionamento de tecla.
    • Selecionar tudo: Ao usar a caixa de pesquisa para filtrar, você pode usar esta caixa de seleção para selecionar todos os campos visíveis de uma vez (objetos e campos recolhidos não são selecionados).
    • Selecionar campos: Marque as caixas de seleção dos campos que deseja incluir na consultar para que sejam adicionados automaticamente à instrução SOQL à direita. A menos que use a caixa de pesquisa, você também pode selecionar um objeto inteiro para selecionar todos os seus campos de uma vez.

  • Instrução SOQL: À medida que você seleciona os campos, a instrução de consultar na caixa de texto superior direita é preenchida automaticamente com o objeto e os campos selecionados. Para usar uma instrução SOQL personalizada, faça edições nesta caixa de texto conforme necessário. Para obter referência sobre como estruturar uma instrução SOQL personalizada, consulte a documentação do Salesforce sobre Sintaxe SOQL SELECT.

  • Consulta de Teste: Clique neste botão para validar se a consultar é válida. Se a consultar for válida, uma amostra de 10 registros recuperados da consultar será exibida em uma tabela semelhante à mostrada abaixo. Se a consultar não for válida, serão exibidas mensagens de erro relevantes. A consultar deve ser válida para ativar o botão Próximo.

    consultar de teste de atividade de consultar servicemax 2

  • Cláusula WHERE (opcional): Para adicionar uma cláusula WHERE, você pode usar os campos abaixo como entrada para ajudar a construir a cláusula ou pode inserir manualmente a cláusula na caixa de texto inferior. Depois de adicionar uma cláusula WHERE, você deve primeiro testar a consultar usando o botão Testar Consulta para ativar o botão Próximo.

    • Objeto: Campo: Use o menu suspenso para selecionar um campo dos objetos selecionados.

    • Operador: Use o menu suspenso para selecionar o(s) operador(es) apropriado(s). A lista de operadores disponíveis depende do tipo de dados do campo selecionado.

      ------------ ---------------------------- ----------------------
      Comparação
      = Igual a
      != Não é igual
      \< Menos que
      \<= Menor ou igual
      > Maior que
      >= Maior ou igual
      GOSTO Curtir
      DENTRO DENTRO
      NÃO ESTÁ NÃO ESTÁ
      INCLUI Aplica-se somente a listas de opções de seleção múltipla
      EXCLUI Aplica-se somente a listas de opções de seleção múltipla
      Lógico
      E TRUE se ambas as expressões esquerda e direita forem TRUE
      OU TRUE se a expressão da esquerda ou da direita for TRUE
      NÃO TRUE se a expressão correta for FALSE

    • Valor: Insira o valor desejado para usar com as seleções suspensas.

      Nota

      Ao usar variáveis globais em uma cláusula WHERE, você deve especificar um valor padrão para que a consultar seja válida para teste (com o botão Testar Consulta), como variáveis globais obtêm seu valor em tempo de execução (consulte Definir um valor padrão em Variáveis Globais).

    • Adicionar: Clique no anexo link para construir automaticamente a cláusula com base nas seleções suspensas e no valor inserido. A cláusula construída automaticamente aparece na caixa de texto inferior.

    Nota

    Para adicionar diversas condições à cláusula, repita o processo adicionando seleções adicionais. Observe que pode ser necessário adicionar um operador lógico como AND ou OR para dar conta das condições adicionais.

  • Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

  • Descartar alterações: Após fazer as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Próximos Passos

Depois de configurar uma atividade ServiceMax Bulk Query, conclua a configuração da operação adicionando e configurando outras atividades ou scripts como etapas de operação. Você também pode definir as configurações de operação de uma operação, que incluem a capacidade de encadear operações que estejam no mesmo fluxo de trabalho ou em workflows diferentes.

Depois que uma atividade de consulta em massa do ServiceMax for criada, as ações de menu para essa atividade estarão acessíveis no painel do projeto nas guias Workflows ou Componentes e na quadro de design. Consulte Menu Ações de Atividade para detalhes.

As atividades do ServiceMax Bulk Query podem ser usadas como fonte com este padrão de operação:

Uma atividade ServiceMax pode ser usada como uma etapa de operação em apenas uma única operação. Ou seja, não é possível fazer referência à mesma atividade diversas vezes em outras operações. Em vez disso, você pode fazer uma cópia de uma atividade ServiceMax para usar em outro lugar (consulte Reutilização de componentes).

Outros padrões não são válidos usando atividades de consulta em massa do ServiceMax. Veja os padrões de validação na Validade da Operação página.

Um caso de uso típico é usar uma atividade de consulta em massa do ServiceMax no Padrão de origem em massa do Salesforce. Neste exemplo, a atividade ServiceMax Bulk Query (Bulk Query) fornece dados dentro da operação. A atividade FTP Write (Write Query Response) é usada como destino, recebendo dados dentro da operação que são então gravados no site FTP configurado e uma mensagem é registrada pelo script Write to Operation Log:

operação de atividade de consultar em massa servicemax 1

Além disso, o destino baseado em arquivo usado na operação deve usar um formato de arquivo simples com um cabeçalho e apenas os seguintes tipos de dados:

Base64 - Boleano - Formatos de data - Dobro - Inteiro - ID ServiceMax - Corda

As operações que usam atividades ServiceMax também podem ter ações operação configuradas para serem acionadas em uma falha SOAP — um erro resultante de um formato de mensagem incorreto, processamento de cabeçalho ou incompatibilidade. As ações de operação podem ser configuradas para executar uma operação ou enviar um e-mail após ocorrer uma falha SOAP. Para obter instruções sobre como disparar uma ação em caso de falha SOAP, consulte Ações de operação.

Para usar a atividade com funções de script, grave os dados em um local temporário e use esse local temporário na função de script.

Quando estiver pronto, implantar e execute a operação e valide o comportamento verificando os logs de operação.