Início rápido — como usar a atividade Search ServiceNow Records

Visão geral

O objetivo deste guia é orientá-lo por vários exemplos de como consultar dados usando a atividade Search ServiceNow Records .

Você pode inserir uma consulta como "name-value parameters=state=closed" , que diz para filtrar a lista de objetos (como um Incident) onde o estado é fechado. Isso está descrito na documentação do ServiceNow, e você pode testá-lo usando o explorador da API REST do ServiceNow. Nossa atividade recebe a consulta que o usuário fornece e a anexa à chamada da API REST do ServiceNow relevante, recebendo os resultados.

O problema para alguns clientes é que não é fácil entender como criar consultas, como testar consultas ou que a pessoa não é técnica a ponto de ser prático aprender e usar o ServiceNow REST API explorer.

Guia

A documentação do ServiceNow sobre a criação de consultas que podem ser usadas com sua API REST está localizada na documentação de Strings de consulta codificadas . Este é um recurso útil se você quiser aprender a criar consultas que podem ser usadas com a atividade Search ServiceNow Records.

Abaixo estão alguns exemplos de consultas que podem ser utilizadas com o objeto Incidentes :

Consulta	Description
sysparm_fields=number,sys_created_on,sys_created_by	Retorna todos os registros, mas retorna apenas as três colunas especificadas (number, sys_created_on e sys_created_by)
name-value pairs=state=closed	Retorna todos os registros onde o estado é fechado.
sysparm_fields=number,sys_created_on,sys_created_by&sysparm_limit=1&name-value pair=state%3Dopen	Retorne apenas as três colunas (número, sys_created_on e sys_created_by) para cada registro, retorne apenas registros em que o estado é Opene limite os resultados a 1 registro.
priority=2	Retorna todos os registros onde a prioridade é 2.
sysparm_query=active=true&state=closed	Retorna todos os registros onde a descrição curta é como rede
sysparm_query=short_descriptionLIKEnetwork	Retorna um registro onde o número é INC0010060 e retorna apenas três colunas como parte do resultado (sys_id, number, short_description)

Existem dois outros métodos para criar e obter consultas úteis que podem ser usadas com esta atividade.

1. Opção A: Copie qualquer consulta da IU do ServiceNow.
2. Opção B: Copiar a string de consulta do navegador.

Opção A: Copie qualquer consulta da IU do ServiceNow

Você precisará anexar o texto "sysparm_query=" a qualquer consulta resultante de acordo com as etapas abaixo.

Etapa 1

Vá para um objeto, Incidentes neste caso.

Etapa 2

Limpe os filtros e crie um novo filtro. No nosso caso, procuramos quaisquer Incidentes cujo número termine com a string "100".

Etapa 3

Copie a consulta usando o item de menu Copiar consulta. Ele se parecerá com o númeroENDSWITH100.

Etapa 4

Cole isso na atividade Pesquisar registros do ServiceNow. Você pode fazer isso na janela Test Query, conforme mostrado abaixo, ou na propriedade query da atividade.

Certifique-se de pré-anexar sysparm_query= na frente para que pareça sysparm_query=numberENDSWITH100, caso contrário, não funcionará corretamente.

Opção B: copiando a querystring do navegador.

Nesta opção, você não precisa se lembrar de adicionar nada como uma etapa pré-pendente. Você pode copiar e colar a string de consulta se usar a opção Abrir nova janela como abaixo:

Passo 1:

Crie o filtro que deseja usar como antes na Opção A.

  Passo 2: Clique com o botão direito do mouse e escolha a opção de menuAbrir nova janela .

Passo 3: Copie a query string in toto (tudo depois do ponto de interrogação "?"). Em seguida, cole-o diretamente na caixa de diálogo "Test Query" da atividade Search ServiceNow Records, conforme mostrado abaixo.