Introducir registro de ServiceNow

UiPath.ServiceNow.Activities.InsertRecord

La actividad Insertar registro de ServiceNow utiliza la API POST de la tabla de ServiceNow para insertar un nuevo objeto de registro.

Después de insertar 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 el valor sys_id del nuevo objeto de registro. Por ejemplo, si desea insertar un objeto de incidente de ServiceNow, puede generar el valor sys_id agregando una variable String en el asistente de objetos (consulte el ejemplo a continuación).

Consejo:

Este paquete de actividades proporciona tres métodos diferentes para insertar un registro: Insertar registro de ServiceNow,Insertar registroso Insertar registros de ImportSet.

Las actividadesInsertar registro de ServiceNow y Upsert registros usan las API REST para escribir directamente en una tabla de producción. La actividad Insertar registros de ConjuntoDeImportaciones utiliza la API de conjunto de importación de REST para escribir en una tabla de conjuntos de importación desde la que los datos se transforman en la tabla de producción de destino.

Para evitar insertar registros directamente en las tablas de producción, se recomienda usar la actividad Registro de Upsert ServiceNow para insertar un nuevo registro.

Para obtener información detallada, incluida la solución de problemas de rendimiento del conjunto de importación, consulta conjuntos de importación en la documentación de ServiceNow.

Para obtener más información sobre el uso de conjuntos de importación, consulta Conjunto de importación de servicios web e Importar datos usando conjuntos de importación en la documentación de ServiceNow.

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 Insertar registro de ServiceNow dentro de la actividad de ámbito de ServiceNow .
4. Haga clic en el botón Configurar dentro de la actividad Insertar registro de ServiceNow (esto abre el Asistente para objetos).
5. Seleccione el Objeto que desea insertar y agregue los campos (con valores) que desea completar.
6. Crea e introduce una variable ResponseStatus para la propiedad Salida .
   • Los valores de tus propiedades de entrada se envían a la API Tabla - POST .
   • 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 Insertar registro de ServiceNow , debe usar 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 se crea. Introduce una variable String . ServiceNow genera automáticamente el sys_id cuando inserta el nuevo registro. Para recuperar este valor y utilizarlo en otras actividades, cree e introduzca una variable String en el asistente de objetos (a continuación se muestra un ejemplo).

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 insertar. 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 .