Obtener registro de ServiceNow

UiPath.ServiceNow.Activities.GetRecord

La actividad Obtener registro de ServiceNow utiliza la API de ServiceNow Table - GET {sys_id} para recuperar un registro específico (sys_id).

Después de recuperar el registro, la actividad genera el estado de la solicitud (información de éxito / error) en un objeto ResponseStatus (ServiceNowStatus) que puedes usar en actividades posteriores (p. Ej., Lógica condicional).

Esta actividad también devuelve los datos de campo asociados con el sys_id. Por ejemplo, si desea recuperar un objeto de incidente de ServiceNow, puede generar los datos short_description y contact_type agregando los campos (con variables) en el asistente de objetos (consulte el ejemplo a continuación).

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 Obtener registro de ServiceNow dentro de la actividad del ámbito de ServiceNow .
4. Haga clic en el botón Configurar dentro de la actividad Obtener registro de ServiceNow (se abre el Asistente para objetos).
5. Selecciona el Objeto que deseas recuperar e introduce, como mínimo, el sys_id del registro.
6. Crea e introduce una variable ResponseStatus para la propiedad Salida .
   • Tus valores de propiedad de entrada se envían a la API Tabla - GET {sys_id} .
   • La API devuelve el valor ResponseStatus a su variable de propiedad de salida.
     
     

     

     
     

En el cuerpo de la actividad

Para introducir los valores de la propiedad Obtener registro de ServiceNow , debe utilizar el Asistente para 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 .

• sys_id : el identificador del registro de ServiceNow que quieres recuperar. Introduce una variable String o String .
  • Para obtener el valor de sys_id , puedes seguir uno de los métodos que se muestran en la documentación del identificador único de registro (sys_id) o hacer clic con el botón derecho en el registro en la interfaz de usuario de ServiceNow y seleccionar la opción Copiar sys_id en el menú emergente.

Propiedades

Nota: si no ve una lista de propiedades para el objeto que elija, incluso viendo la opción "Agregar varios campos", es posible que no tenga permisos suficientes en ServiceNow para ver los metadatos del objeto y modificar datos. Consulta Solución de problemas de permisos para obtener más información.

Avanzado

• CamposAdicionales : un DataRow que incluye las columnas y valores que quieres recuperar. Los nombres de columna deben coincidir con los nombres tal como aparecen en la tabla de base de datos de ServiceNow para el tipo de objeto seleccionado.

Común

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

Otros

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

Salida

• 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 la guía de inicio rápido .