Ação Pesquisar registros

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • PESQUISE vários registros em qualquer tabela usando condições definidas.

    Funções e disponibilidade

    Disponível como uma ação principal de Workflow Studio ServiceNow. Usuários com a função flow_designer ou admin podem adicionar uma ação a um fluxo e definir detalhes de configuração.

    Entradas

    Forneça um valor para cada entrada de que seu fluxo precisa. Para adicionar valores dinâmicos, você também pode arrastar cápsulas do painel Dados ou selecioná-las no seletor de cápsulas.

    Tabela
    Tipo de dados: Table Name

    Nome da tabela que contém os registros que você deseja pesquisar.

    Condições
    Tipo de dados: Conditions

    Nomes de campo e valores de campo que você deseja usar para pesquisar registros. Para usar um script em linha para especificar condições, considere usar as classes GlideRecord e GlideQueryCondition para criar sua consulta. Consulte GlideRecord - Global e GlideQueryCondition - Global.

    Ordenar por
    Tipo de dados: Field Name

    Campo que você deseja usar para classificar resultados.

    Tipo de Classificação
    Tipo de dados: Choice

    Opção para classificar em ordem alfabética em ordem crescente ou decrescente.

    Máximo de Resultados
    Tipo de dados: Integer

    O número máximo de resultados de registro que a ação pode retornar.

    Saídas

    Essas saídas aparecem no painel de dados. Você pode usá-las como entradas em outro lugar em seu fluxo.

    Registros
    Tipo de dados: Records

    Lista de SYS IDs de registro encontrados com base nos critérios de pesquisa fornecidos. Para obter mais informações, consulte [Tabela] Tipo de dados .

    Tabela
    Tipo de dados: Table Name

    Tabela que contém a lista de registros.

    Contagem
    Tipo de dados: Integer

    Número de registros que a ação retornou.

    Diretrizes gerais

    Use estas diretrizes gerais ao trabalhar com a ação Pesquisar registros.

    Registros de processo com para cada lógica de fluxo
    Use para cada lógica de fluxo para iterar em uma lista de registros. Para obter mais informações sobre como usar para cada lógica de fluxo, consulte Para cada lógica de fluxo.
    Máximo de resultados para melhorar o desempenho
    Defina a entrada Máximo de resultados como 1000 registros ou menos para melhorar o desempenho do fluxo. Quanto mais registros o sistema precisar pesquisar, mais recursos do sistema serão necessários para identificá-los e processá-los.
    Use condições para filtrar registros
    Use condições para limitar o número de registros que a ação retorna. Quanto mais condições específicas você puder fornecer, melhor será o desempenho do fluxo.

    PESQUISE itens de configuração atribuídos a um usuário de solicitação de mudança

    Configuração da ação Pesquisar registros

    Neste exemplo, o fluxo começa quando uma solicitação de mudança de emergência é aberta na categoria Rede. A ação Pesquisar registros usa a tabela Item de configuração [cmdb_ci] como a entrada Tabela. A entrada Condições procura itens de configuração atribuídos ao solicitante da solicitação de mudança. A ordem por entrada usa o campo Nome para executar uma classificação do tipo alfabética crescente.

    Detalhes da execução da ação Pesquisar registros

    Nos detalhes da execução, a saída Contagem mostra três itens de configuração atribuídos ao solicitante da solicitação de mudança. A saída Registros mostra os itens de configuração por nome na página de detalhes da execução, mas a cápsula de dados contém uma série de valores de SYS ID. A saída da Tabela é a tabela Item de configuração [cmdb_ci].