Etapa de registro de pesquisa

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 2 min. de leitura

    • Pesquise um registro de qualquer tabela com base nas condições definidas.

    Funções e disponibilidade

    Disponível como uma etapa de ação de Designer de ações. 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ção. Para permitir que os designers de fluxo apliquem condições dinamicamente, defina uma entrada do tipo Condições e arraste e solte a cápsula de dados de entrada no campo Condições.

    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->ID do sistema]. 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 [Requested by][is][Trigger->incident record->Caller->SYS ID]. [Solicitado por] [é] [ação->incidente->Solicitante->ID do sistema] em que 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 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 for 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 na entrada Conditions.

    Tabela
    Tipo de dados: Table

    Nome da tabela associada ao registro retornado.

    Status
    Tipo de dados: Choice

    1 se um registro foi encontrado com sucesso e 0 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 o valor da saída Status for 0.

    Campos de avaliação de erro de ação

    Campo Descrição
    Se esta etapa falhar 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

    Exemplo de etapa de registro de pesquisa em uma ação.