Pesquisar ação de registro

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 1 min. de leitura

    • PESQUISE um registro de qualquer tabela com base em 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.

    Campos

    Campo Descrição
    Tabela Selecione uma tabela na lista.
    Condições

    Condições que o registro retornado deve atender.

    Ao criar uma condição que pesquisa o valor de um campo de referência, use uma cápsula de dados que forneça explicitamente o valor do SYS ID. Certifique-se de que a condição tenha o formato [Campo de referência][IS][Pílula de dados do tipo de referência->SYS ID] . Por exemplo, as tabelas Mudança e Incidente contêm um campo de referência para a tabela Usuário. Para pesquisar registros de mudança em que o solicitante é o chamador de um registro de incidente, crie a condição [Solicitado por][IS][gatilho->registro de incidente->chamador->SYS ID] .

    Ordenar por Determina como classificar resultados quando mais de um registro corresponde às condições definidas. Selecione o campo que você deseja usar para classificar os resultados.
    Tipo de Classificação Selecione se deseja classificar alfabeticamente em ordem crescente ou decrescente.
    Se forem encontrados vários registros Determina quais informações retornar quando mais de um registro corresponder às condições definidas.
    • Retornar somente o primeiro registro
    • Falha da etapa
    Não falha em erro Determina se o fluxo deve falhar quando a pesquisa não conseguir encontrar um registro.

    Saídas

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

    Registro
    Tipo de dados: Record

    Registro encontrado com base nas condições especificadas em Conditionsentrada.

    Tabela
    Tipo de dados: Table

    Nome da tabela associada ao registro retornado.

    Status
    Tipo de dados: Choice

    0 se um registro foi encontrado com sucesso e 1 se houve um erro.

    Mensagem de erro
    Tipo de dados: String

    Mensagem que contém detalhes sobre o motivo pelo qual o registro não foi encontrado.

    Nota:
    O valor desta saída só será preenchido se Statuso valor da saída é 1.

    Exemplo

    Ação Pesquisar registro de exemplo em um fluxo.