Actualizar registro de ServiceNow

UiPath.ServiceNow.Activities.UpdateRecord

La actividad Actualizar registro de ServiceNow utiliza la API PUT de la tabla de ServiceNow para actualizar un registro específico (sys_id).

Después de actualizar 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).

Consejo:

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

Las actividadesActualizar 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 actualizar los registros directamente en las tablas de producción, se recomienda usar la actividad Insertar registros de ConjuntoDeImportaciones para actualizar 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 Actualizar registro de ServiceNow dentro de la actividad del ámbito de ServiceNow .
4. Haga clic en el botón Configurar dentro de la actividad Actualizar registro de ServiceNow (se abre el Asistente para objetos).
5. Selecciona el Objeto que deseas actualizar e introduce, como mínimo, el sys_id del registro.
6. Crea e introduce una variable ResponseStatus para la propiedad de salida .
   • Los valores de tus propiedades de entrada se envían a la API Table-PUT .
   • 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 Actualizar 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 actualizar. 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 : una DataRow que incluye las columnas y valores que quieres actualizar. 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 .