Etapa de registros de pesquisa

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 1 min. de leitura
  • Pesquise vários registros em qualquer tabela usando 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

    Condições a serem pesquisadas em registros.

    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.

    Para usar um script em linha para especificar condições, considere o uso das classes GlideRecord e GlideQueryCondition para criar sua consulta. Consulte GlideRecord - Global e GlideQueryCondition - Global.

    Ordenar por 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.
    Máximo de Resultados Número máximo de resultados retornados.

    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.

    Saídas

    Saída Tipo Descrição
    Registros Registros Lista de SYS IDs de registro encontrados com base nos critérios de pesquisa fornecidos.

    Para obter mais informações, consulte Registros. [Tabela] Tipo de dados.

    Tabela Tabela Nome da tabela para os registros encontrados
    Contagem Número inteiro Número de registros encontrados

    Exemplo

    Exemplo da etapa Pesquisar registros em uma ação.