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 seu fluxo precisa. Para adicionar valores dinâmicos, você também pode arrastar cápsulas do painel Dados ou selecioná-las no seletor de cápsulas.
- 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 em ordem 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 fornecidos. Para obter mais informações, consulte [Tabela] Tipo de dados .
- 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.
- Registros de processo com para cada lógica de fluxo
- Use para cada lógica de fluxo para iterar em uma lista de registros. Para obter mais informações sobre como usar para cada lógica de fluxo, consulte Para cada lógica de fluxo.
- Máximo de resultados para melhorar o desempenho
- Defina a entrada Máximo de resultados como 1000 registros ou menos para melhorar o desempenho do fluxo. Quanto mais registros o sistema precisar pesquisar, mais recursos do sistema serão necessários para identificá-los e processá-los.
- Use 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 fluxo.
PESQUISE 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 ordem por entrada usa o campo Nome para executar uma classificação do tipo alfabética crescente.
Nos detalhes da execução, a saída Contagem mostra três itens de configuração atribuídos ao solicitante da solicitação de mudança. A saída Registros mostra os itens de configuração por nome na página de detalhes da execução, mas a cápsula de dados contém uma série de valores de SYS ID. A saída da Tabela é a tabela Item de configuração [cmdb_ci].