Realizar upsert de registros

UiPath.ServiceNow.Activities.UpsertRecords

La actividad Upsert registros utiliza la API de ServiceNow Batch - POST para actualizar o insertar uno o más registros.

Después de completar la operación, la actividad genera el resultado de la inserción en un objeto DataTable (Resultado) y el estado de la operación (información de éxito / error) en un objeto ResponseStatus (ServiceNowStatus) que puede usar en actividades posteriores (p. Ej. , lógica condicional).

Consejo:

Este paquete de actividades proporciona cuatro métodos diferentes para actualizar y / o insertar un registro: Actualizar registro de ServiceNow, Insertar registro de ServiceNow, Insertar registroso Insertar registros de ImportSet.

Las actividades Actualizar registro de ServiceNow, Insertar registro de ServiceNowy Insertar registros usan las API de 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 escribir directamente en las tablas de producción, se recomienda usar la actividad Insertar registros de ConjuntoDeImportaciones para actualizar o insertar un nuevo registro.

Para obtener información detallada, incluida la solución de problemas de rendimiento del conjunto de importación, consulta los 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 Upsert registros dentro de la actividad de ámbito de ServiceNow .
4. Haz clic en el botón Configurar dentro de la actividad Upsert Registros (esto abre el Asistente de objetos).
5. Selecciona el Objeto que deseas utilizar para tu conjunto de importación e introduce tus propiedades de Entrada .
6. Crea e introduce una variable DataTable y una variable ResponseStatus para las propiedades de salida .
   • Los valores de tus propiedades de entrada se envían a la API de Batch - POST .
   • La API devuelve los valores DataTable y ResponseStatus a tus variables de propiedad de salida.
     
     

     

     
     

Configurar

Para seleccionar su objeto, 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 .

• Objeto : el tipo de registro que quieres insertar o actualizar. Se establecerá y aparecerá en el lienzo en tiempo de diseño, pero no en el panel de propiedades. Utilice el Asistente para objetos para seleccionar su objeto.

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 los datos. Consulta Solución de problemas de permisos para obtener más información.

Común

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

Entrada

• TablaDeDatos : los datos del registro que quieres insertar o actualizar. Introduce una variable DataTable .
  • Para actualizar un registro existente, añade el valor sys_Id a la fila de datos que contiene las actualizaciones que quieres realizar.
  • Las filas de datos sin un valor de sys_id se insertan como nuevos registros (el sys_id del nuevo registro se devuelve en el objeto DataTable los resultados ).
  • El número máximo de registros que puede actualizar o insertar por ejecución de actividad es 200. Si desea insertar / actualizar más de 200 registros, puede agregar un bucle for o agregar una actividad Upsert para cada DataTable que contenga 200 registros (por ejemplo, si tiene 4 000 registros en total, puede dividirlos en 20 actividades). Para obtener más información, consulte API de Batch en la documentación de ServiceNow.

Otros

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

Salida

• Estado : el estado de la solicitud (información correcta / errónea). 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.
• Resultado : el resultado de los registros insertados o actualizados. Los resultados DataTable tienen la misma estructura que la TablaDeDatosde entrada, con las siguientes excepciones:
  • Los nuevos registros que se insertaron correctamente ahora incluyen un valor sys_id .
  • Se anexa una nueva columna "ActionType" que incluye un valor de Agregar o Actualizar para indicar si un registro se actualizó o agregó a la tabla.
  • Se anexa una nueva columna "Error" que incluye información del error si la operación falla.