Ação Pesquisar registros
Pesquise vários registros em qualquer tabela usando 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.
Entradas
Forneça um valor para cada entrada de que o fluxo precisa. 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 ação pode retornar.
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 ação 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.
- Definir resultados máximos para melhorar o desempenho
- Defina a entrada Resultados máximos como 1000 registros ou menos para melhorar o desempenho do fluxo. 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 ação retorna. Quanto mais condições específicas você puder fornecer, melhor será o desempenho do seu fluxo.
Pesquisar itens de configuração atribuídos a um usuário de solicitação de mudança
Neste exemplo, o fluxo começa quando uma solicitação de mudança de emergência é aberta na categoria Rede. A ação Pesquisar registros usa a tabela Item de configuração [cmdb_ci] como a entrada Tabela. A entrada Condições procura itens de configuração atribuídos ao solicitante da solicitação de mudança. A entrada Ordenar por usa o campo Nome para executar uma classificação de tipo alfabético crescente.
Nos detalhes da execução, a saída Contagem mostra três itens de configuração que são atribuídos ao solicitante da solicitação de mudança. A saída de Registros mostra os itens de configuração por nome na página de detalhes de execução, mas a cápsula de dados contém uma série de valores de SYS ID. A saída de Tabela é a tabela Item de configuração [cmdb_ci].