Pesquisar ação de registro

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 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][cápsula 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 solicitante de um registro de incidente, crie a condição [Solicitado por][is][gatilho->registro de incidente->solicitante->SYS ID] .

    Ordenar por Determina como classificar os 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 em ordem alfabética 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 puder encontrar um registro.

    Saídas

    Essas saídas aparecem no painel de 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

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

    Mensagens de erro
    Tipo de dados: String

    Mensagem que contém detalhes sobre o motivo pelo qual o registro não pôde ser 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.