Etapa de registros de pesquisa
Pesquise vários registros em qualquer tabela usando 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.
Entradas
Forneça um valor para cada entrada necessária para sua ação. Para adicionar valores dinâmicos, você também pode arrastar cápsulas do painel Dados ou selecioná-las no seletor de cápsula.
- Tabela
- Tipo de dados: Table Name
Nome da tabela que contém os registros que você deseja pesquisar.
- Condições
- Tipo de dados: Conditions
Nomes de campo e valores de campo que você deseja usar para pesquisar registros. Para usar um script em linha para especificar condições, considere usar as classes GlideRecord e GlideQueryCondition para criar sua consulta. Consulte GlideRecord - Global e GlideQueryCondition - Global.
- Ordenar por
- Tipo de dados: Field Name
Campo que você deseja usar para classificar resultados.
- Tipo de Classificação
- Tipo de dados: Choice
Opção para classificar em ordem alfabética crescente ou decrescente.
- Máximo de Resultados
- Tipo de dados: Integer
O número máximo de resultados de registro que a etapa pode retornar.
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.
Saídas
Essas saídas aparecem no painel de dados. Você pode usá-las como entradas em outro lugar em seu fluxo.
- Registros
- Tipo de dados: Records
Lista de SYS IDs de registro encontrados com base nos critérios de pesquisa que você forneceu. Para obter mais informações, consulte Registros. Tipo de dados [Tabela].
- Tabela
- Tipo de dados: Table Name
Tabela que contém a lista de registros.
- Contagem
- Tipo de dados: Integer
Número de registros que a etapa retornou.
Diretrizes gerais
Use estas diretrizes gerais ao trabalhar com a ação Pesquisar registros.
- Processar registros com a lógica de fluxo Para cada
- Use a lógica de fluxo Para cada para iterar em uma lista de registros. Para obter mais informações sobre como usar a lógica de fluxo Para cada, consulte Para cada lógica de fluxo. Como alternativa, você pode usar uma etapa de script para processar uma lista de registros em uma ação personalizada.
- Definir resultados máximos para melhorar o desempenho
- Defina a entrada Resultados máximos como 1000 registros ou menos para melhorar o desempenho da sua ação. Quanto mais registros o sistema tiver para pesquisar, mais recursos do sistema serão necessários para identificá-los e processá-los.
- Usar condições para filtrar registros
- Use condições para limitar o número de registros que a etapa retorna. Quanto mais condições específicas você puder fornecer, melhor será o desempenho da sua ação.