Buscar registros de ServiceNow

UiPath.ServiceNow.Activities.SearchRecords

La actividad Buscar registros de ServiceNow utiliza la API GET de ServiceNow para recuperar registros específicos (objeto) mediante su cadena de consulta codificada (Consulta).

Después de recuperar los registros, la actividad genera el resultado de la consulta como un objeto DataTable (Resultado) y el estado de la solicitud (información de éxito / error) en un objeto ResponseStatus (ServiceNowStatus). Ambas salidas se pueden utilizar como variables de entrada en actividades posteriores (por ejemplo, lógica condicional).

Cómo funciona

Los siguientes pasos y diagrama de secuencia de mensajes son un ejemplo de cómo funciona la actividad desde el momento de diseño (es decir, las dependencias de la actividad y las propiedades de entrada / salida) hasta el tiempo de ejecución.

1. Completa los pasos de configuración .
2. Agregue la actividad de ámbito de ServiceNow a su proyecto.
3. Agregue la actividad Buscar registros de ServiceNow dentro de la actividad de ámbito de ServiceNow .
4. Haga clic en el botón Configurar dentro de la actividad Buscar registros de ServiceNow (se abre el Asistente para objetos).
5. Selecciona el Objeto que deseas recuperar e introduce valores para las Propiedades de Entrada .
6. Crea e introduce variables DataTable y ResponseStatus para las propiedades de salida .
   • Los valores de tus propiedades de entrada se envían a la API Table - GET .
   • La API devuelve los valores DataTable y ResponseStatus a tus variables de propiedad de salida.
     
     

     

     
     

En el cuerpo de la actividad

Para introducir los valores de su propiedad Buscar registros de ServiceNow y probar las entradas de las consultas , puede utilizar el Asistente de objetos haciendo clic en el botón Configurar .

Para obtener más información sobre el Asistente de objetos, consulta la página Marcos de actividades empresariales .

• Objeto : el tipo de objeto de ServiceNow que quieres recuperar. Usa el Asistente de objetos para seleccionar un objeto o introducir una variable String o String válida. Si usa el Asistente de objetos para seleccionar su objeto, también debe usarlo para cambiar su selección. Los cambios realizados sin utilizar el asistente para objetos hacen que la actividad falle correctamente.

Propiedades

Común

• NombreParaMostrar: el nombre de la actividad que se muestra. Este campo solo admite variables Strings o String.

Entrada

• Consulta : los parámetros del filtro. Introduce una variable String o String .
  • Introduzca su consulta siguiendo el formato de cadena de consulta codificada de ServiceNow (por ejemplo, "sysparm_query = short_descriptionLIKEUiPath & sysparm_fields = number, short_description").
  • Para crear su consulta, se recomienda que siga los pasos para generar una cadena de consulta codificada a través de un filtro en la documentación de ServiceNow.
  • Para probar tu consulta, abre el Asistente de objetos, introduce tu String (sin las comillas ("")) y haz clic en el botón Consulta de prueba para ver los resultados.
  • La consulta String que introduzcas en el Asistente para objetos también rellena la propiedad Consulta en el Panel de propiedades.

    Se describe más información sobre cómo crear consultas fácilmente en Cómo usar la búsqueda de registros de ServiceNow.

Otros

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.

Salida

• Resultado : los resultados de la consulta. Introduce una variable DataTable .
• ServiceNowStatus : el estado de la solicitud (información de éxito / error). Introduce una variable ResponseStatus (UiPath.BAF.Models.ResponseStatus). El objeto ResponseStatus incluye tres propiedades que puedes usar en otras actividades.
  • Correcto - Boolean - Especifica si la solicitud de la API se realizó correctamente.
  • CódigoDeError - String : el error de respuesta si la solicitud de la API no tiene éxito (Éxito=Falso).
  • Mensaje - String : el mensaje de error.

Ejemplo

La siguiente imagen muestra un ejemplo de la relación de dependencia de la actividad y los valores de las propiedades de entrada / salida.

Para obtener instrucciones paso a paso y ejemplos, consulta las guías de inicio rápido .