Etapa de registro de pesquisa

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • PESQUISE um registro de qualquer tabela com base em condições definidas.

    Funções e disponibilidade

    Disponível como uma etapa de ação de Workflow Studio. Usuários com a função action_designer podem criar uma ação personalizada com uma ou mais etapas de ação.

    Campos

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

    Defina condições estáticas ou dinâmicas para filtrar registros. Para definir uma condição estática aplicada sempre que a ação for executada, defina as condições com o construtor de condições. Para permitir que os designers de fluxo apliquem condições dinamicamente, defina uma entrada de condições do tipo e arraste e solte a cápsula de dados de entrada no Condições campo.

    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] . [Solicitado por][is][action->incident->Chamador->SYS ID] onde incidente é uma variável de entrada para um registro de incidente.

    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 o que será retornado se 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 se um registro não puder ser encontrado.

    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 0 se houve um erro 1.

    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 é 0.

    Avaliação de erro de ação

    Se esta etapa falhar
    Tipo de dados: Choice

    Opção para continuar executando a próxima etapa ou ir para a avaliação de erro. Para usar o código de status da etapa ou a mensagem para uma condição de erro de ação personalizada, consulte Avaliação de erro de ação.

    Exemplo

    Etapa Pesquisar registro de exemplo em uma ação.