Introducir ConjuntoDeImportaciones de ServiceNow

UiPath.ServiceNow.Activities.InsertImportSet

La actividad Insertar conjunto de importación de ServiceNow utiliza la API POST de Conjunto de importación de ServiceNow para importar un nuevo objeto ImportSet.

Después de insertar el registro ImportSet, la actividad genera el estado de la solicitud (información de éxito / error) en un objeto ResponseStatus (ServiceNowStatus) que puedes usar en actividades posteriores (por ejemplo, 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 cuatro métodos diferentes para insertar un registro: Insertar registro de ServiceNow,Insertar registros, Insertar registrosde ConjuntoDeImportaciones e Insertar ConjuntoDeImportaciones de ServiceNow.

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 ImportSet e Insertar ImportSet de ServiceNow utiliza la API de conjunto de importación 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 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 Conjunto de Importación de ServiceNow dentro de la actividad Ámbito de ServiceNow .
4. Haga clic en el botón Configurar dentro de la actividad Insertar conjunto de importación de ServiceNow (esto abre el Asistente de 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 las propiedades de entrada se envían a la API ImportSet - 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 su propiedad Insertar ConjuntoDeImportaciones 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.

Común

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

Otros

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