Realizar upsert de registros

Actividad para actualizar o insertar uno o más registros

UiPath.ServiceNow.Activities.UpsertRecords

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

After completing the operation, the activity outputs the result of the insert in a DataTable object (Result) and the operation status (success/failure information) in a ResponseStatus object (ServiceNowStatus) that you can use in subsequent activities (e.g., conditional logic).

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 registros o Insertar registros de ImportSet. Las actividades Actualizar registro de ServiceNow, Insertar registro de ServiceNow y Actualizar registros utilizan las API de REST para escribir directamente en una tabla de producción. La actividad Insertar registros de ImportSet utiliza la API REST Import Set 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 utilizar la actividad Insertar registros de ImportSet para actualizar o insertar un nuevo registro. Para obtener información detallada, incluida la solución de problemas de rendimiento del conjunto de importaciones, 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 utilizando 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. Añade la actividad Ámbito de ServiceNow a tu proyecto.
3. Add the Upsert Records activity inside the ServiceNow Scope activity.
4. Click the Configure button inside the Upsert Records activity (this opens the Object Wizard).
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 las propiedades de entrada se envían a la API POST de Batch .

   • La API devuelve los valores DataTable y ResponseStatus a tus variables de propiedad de salida.

     

Configurar

To select your object, you must use the Object Wizard by clicking the Configure button.

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

• Object - The type of record that you want to insert or update. This will be set and appear in the design-time canvas but not the property panel. Use the Object Wizard to select your object.

Propiedades

Nota:

Si no ves una lista de propiedades para el objeto que eliges, incluso mirando la opción Añadir varios campos , es posible que no tengas permisos suficientes en ServiceNow para ver los metadatos del objeto y modificar los datos. Consulta Resolución de problemas de permisos para obtener más información.

Común

• DisplayName - The display name of the activity. This field supports only Strings or String variables.

Entrada

• DataTable - The record data that you want to insert or update. Enter a DataTable variable.
  • To update an existing record, add the sys_Id value to the data row that contains the updates you want to make.
  • Data rows without a sys_id value are inserted as new records (the sys_id of the new record is returned in the Results DataTable object).
  • El número máximo de registros que puedes actualizar o insertar por ejecución de actividad es 200. Si quieres insertar/actualizar más de 200 registros, puedes añadir un bucle for o añadir una Actividad Upsert para cada DataTable que contenga 200 registros (p. ej., si tienes 4000 registros en total, puedes dividirlos en 20 registros independientes). actividades). Para obtener más información, consulta API por lotes 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

• Status - The status of the request (success/failure information). Enter a ResponseStatus variable (UiPath.BAF.Models.ResponseStatus). The ResponseStatus object includes three properties that you can use in other activities.
  • Success - Boolean - Specifies whether the API request was successful.
  • ErrorCode - String - The response error if the API request is unsuccessful (Success=False).
  • Message - String - The error message.
• Result - The result of the inserted or updated record(s). The Results DataTable has the same structure as the input DataTable, with the following exceptions:
  • New records that were inserted successfully now include a sys_id value.
  • A new "ActionType" column is appended and includes a value of either Add or Update to indicate whether a record was updated or added to the table.
  • Se anexa una nueva columna "Error" que incluye información del error si la operación falla.