Importación de datos de la organización mediante la importación basada en API (importación posterior) (versión preliminar)

En este artículo, se describen dos tipos de importaciones: completas e incrementales. Estas importaciones actualizan los datos que proporcionó al configurar la conexión a Viva Insights.

Acerca de las importaciones posteriores

Al importar datos a Viva Insights, realizará una actualización completa o incremental. Si desea eliminar campos, puede usar una actualización completa para hacerlo.

La aplicación de exportación personalizada que creó en Importar datos de la organización (primera importación), junto con la aplicación DescriptiveDataUploadApp que hemos creado en GitHub, facilita las actualizaciones de las que hablamos a continuación. Como resumen rápido, cuando se ejecuta DescriptiveDataUploadApp, extrae datos de la carpeta comprimida que descargó de GitHub. Esta carpeta comprimida contiene los siguientes archivos:

• data.csv, que contiene los campos que desea importar.
• metadata.json, que asigna los campos de origen a Viva Insights campos. También usará metadata.json para indicar a Viva Insights si la actualización está completa o incremental, como se explica en la sección siguiente.

Cómo indicar una actualización completa o incremental

1. En metadata.json, vaya a la línea 3.
2. Actualice la “IsBootstrap”: propiedad a una de las siguientes opciones:
   • Para una actualización completa, use “IsBootstrap” : “true”.
   • Para una actualización incremental, use “IsBootstrap” : “false”.

Cuando se ejecuta DescriptiveDataUploadApp, Viva Insights comenzará a procesar los datos como una actualización completa o incremental, en función de lo que haya especificado aquí en metadata.json.

Actualizar tipos

Full

Cuando se realiza una actualización completa, se reemplazan todos los datos de la organización en Viva Insights, es decir, se sobrescribe lo que ya ha importado. Cuando realice una actualización completa, asegúrese de proporcionar datos para todos los empleados con licencia y sin licencia (es decir, los que tienen una suscripción Viva Insights y los que no). Se describen los campos que se proporcionarán más adelante en este artículo.

Puede usar una actualización completa para eliminar campos, ya que los campos que deje no aparecerán en los datos. Hablamos sobre la eliminación de datos en la sección siguiente.

Eliminación de campos con actualizaciones completas

Para eliminar campos con una actualización completa, exporte los datos como un .csv que contiene todos los campos excepto los campos que desea eliminar. Dado que una actualización completa reemplaza a los datos existentes, terminará con todos los campos excepto los que se han dejado fuera durante la importación.

Incremental

Realice una actualización incremental cuando solo quiera agregar información nueva a los datos de la organización que ya ha cargado en Viva Insights. Esto es lo que puede hacer con una actualización incremental:

• Incorporación de nuevos empleados
• Adición de nuevos atributos para los empleados existentes
• Adición de nuevos atributos para nuevos empleados
• Edición de los atributos de los empleados existentes

Estos son un par de ejemplos de cuándo puede realizar una actualización incremental:

Incorporación de nuevas contrataciones

Supongamos que desea agregar cinco nuevas contrataciones a los datos de la organización. Durante la importación, incluiría lo siguiente:

• Cinco filas que contienen nuevos datos de empleado.
• Atributos necesarios: PersonId, ManagerId, Organization y EffectiveDate.
• Todos los campos opcionales reservados (por ejemplo, HireDate) que ya ha importado a Viva Insights.

Una vez finalizada la importación, el único cambio que observaría es cinco filas nuevas y sus valores.

Adición de un nuevo atributo

Tal vez quiera agregar un atributo reservado opcional que no estaba en los datos antes (digamos , ubicación) para todos los empleados existentes. Cuando vaya a importar los datos, solo incluiría los valores Location, PersonId y EffectiveDate, con valores actuales e históricos para cada empleado, en el archivo .csv. Una vez finalizada la importación, encontraría los mismos datos que había antes, con la excepción de una nueva columna para cada empleado, Location.

Campos que se van a incluir en data.csv para actualizaciones completas e incrementales

Para los tipos de actualización que se enumeran a continuación, incluya los siguientes campos en el archivo data.csv. Asegúrese de que:

• Dar formato a estos campos de acuerdo con nuestras directrices en Preparación de datos de la organización.
• Quite los campos que no incluya del archivo metadata.json.
• Mantenga los archivos data.csv y metadata.json en la carpeta comprimida que descargó de GitHub. Al ejecutar DescriptiveDataUploadApp, proporcionará la ruta de acceso de la carpeta comprimida. Viva Insights extraerá los datos de esta ubicación.