Inicio rápido: cómo usar Buscar registros de ServiceNow

Información general

El propósito de esta guía es guiarle a través de varios ejemplos de cómo consultar datos mediante la actividad Buscar registros de ServiceNow .

Puedes introducir una consulta como "pares de nombre-valor=estado=cerrado" que dice filtrar la lista de objetos (como un Incidente) donde el estado está cerrado. Esto se describe en la documentación de ServiceNow y puedes probarlo utilizando el explorador de la API REST de ServiceNow. Nuestra actividad toma la consulta que el usuario proporciona y la añade a la llamada API REST de ServiceNow correspondiente y luego recibe los resultados.

El problema para algunos clientes es que no es fácil entender cómo crear consultas, cómo probar consultas, o que la persona no sea técnica hasta el punto de que aprender y usar el explorador de la API REST de ServiceNow sea práctico.

Guía

La documentación de ServiceNow sobre la creación de consultas que se pueden utilizar con su API REST se encuentra en la documentación de las cadenas de consulta codificadas . Este es un recurso útil si quieres aprender a crear consultas que puedan utilizarse con la actividad Buscar registros de ServiceNow.

A continuación, se muestran algunos ejemplos de consultas que pueden utilizarse con el objeto Incidencias :

Consulta	Descripción
sysparm_fields=number,sys_created_on,sys_created_by	Devuelve todos los registros, pero solo devuelve las tres columnas especificadas (number, sys_c created_on y sys_c creado_by)
name-value pairs=state=closed	Devuelve todos los registros donde el estado está cerrado.
sysparm_fields=number,sys_created_on,sys_created_by&sysparm_limit=1&name-value pair=state%3Dopen	Devuelve solo las tres columnas (number, sys_c created_on y sys_c created_by) para cada registro, devuelve solo los registros en los que el estado es Abiertoy limita los resultados a 1 registro.
priority=2	Devuelve todos los registros donde la prioridad es 2.
sysparm_query=active=true&state=closed	Devolver todos los registros donde la descripción corta es como red
sysparm_query=short_descriptionLIKEnetwork	Devuelve un registro donde el número es INC0010060 y solo devuelve tres columnas como parte del resultado (sys_id, number, short_description)

Hay otros dos métodos para crear y obtener consultas útiles que se pueden utilizar con esta actividad.

1. Opción A: copie cualquier consulta de la interfaz de usuario de ServiceNow.
2. Opción B: copiar la cadena de consulta del navegador.

Opción A: copiar cualquier consulta de la interfaz de usuario de ServiceNow

Deberá anteponer el texto "sysparm_query =" a cualquier consulta que siga los pasos que se indican a continuación.

Paso 1

Vaya a un objeto, Incidentes en este caso.

Paso 2

Borre los filtros y cree un nuevo. En nuestro caso, buscamos cualquier incidencia cuyo número termine con la cadena "100".

Paso 3

Copie la consulta utilizando el elemento de menú Copiar consulta. Se verá como el número FINAL CON100.

Paso 4

Péguela en la actividad Buscar registros de ServiceNow. Puedes hacerlo en la ventana Consulta de prueba como se ve a continuación, o en la propiedad de consulta de la actividad.

Asegúrese de colocar previamente sysparm_query = al frente para que se vea como sysparm_query = numberENDSWith100, de lo contrario no funcionará correctamente.

Opción B: copiar la cadena de consulta desde el navegador.

En esta opción no tiene que acordarse de añadir nada como paso pendiente. Puede copiar y pegar la cadena de consulta si usa la opción Abrir nueva ventana como se muestra a continuación:

Paso 1:

Cree el filtro que desea usar como antes en la Opción A.

  Paso 2: haz clic con el botón derecho y elige la opción de menúAbrir nueva ventana .

Paso 3: Copie la cadena de consulta completa (todo lo que aparece después del signo de interrogación "?"). A continuación, péguela directamente en el cuadro de diálogo "Consulta de prueba" de la actividad Buscar registros de ServiceNow, como se ve a continuación.