La carga de datos de T6 permite que los usuarios importen información desde archivos CSV a la aplicación de forma eficiente y configurable. El proceso incluye etapas que orientan al usuario desde la creación del objeto de carga, configuración del archivo, mapeo de columnas y definición del destino de los datos.
Para crear y utilizar este recurso, es necesario habilitar algunos permisos de usuario.
En permisos de Administrador, el usuario debe tener habilitado el siguiente permiso:
En permisos de Gestor, el usuario debe tener habilitados los siguientes permisos:
Y estar asociado a un grupo global con el siguiente permiso habilitado:
También es necesario utilizar un formulario de datos para el mapeo (de-para) de las columnas del archivo CSV. Por lo tanto, el usuario debe tener acceso a un formulario de datos para realizar la configuración de la carga de datos.
La funcionalidad de carga de datos en T6 implica la creación y configuración de objetos de carga de datos que permiten cargar información desde archivos CSV dentro de los formularios de manera rápida y dinámica.
En los temas a continuación, presentamos el proceso de creación, configuración y ejecución de una carga de datos dentro de T6.
Para crear una nueva carga de datos, siga estos pasos:
Acceda al explorer y seleccione el lugar donde desea crear el objeto de carga de datos.
Después de seleccionar el lugar de creación, en la ribbon, haga clic en Nuevo Ítem, haga clic en Carga de Datos y seleccione la opción Carga de Datos.
Después de crear el objeto, ábralo con doble clic o seleccione el objeto y haga clic en Abrir en la ribbon.
Será redirigido a una pantalla donde debe seleccionar un archivo CSV. Haga clic en:
.
La configuración del archivo CSV no es obligatoria. Esta configuración solo es necesaria cuando el sistema no puede inferir correctamente estos parámetros. Cuando esto ocurra, la tabla que muestra una vista previa de los datos del archivo no se visualizará correctamente.
Después de configurar los detalles del archivo, haga clic en
.
Regrese a la pantalla anterior y haga clic en
.
Actualmente inferimos la cultura del archivo CSV solo cuando se modifica mediante la edición de la carga de datos. Cuando la modificación del archivo se realiza a través del Panel de ejecución de la carga de datos, la cultura del archivo no se infiere para preservar posibles configuraciones de cultura realizadas manualmente durante la configuración de la carga.
Si un archivo con una cultura diferente de la original necesita ser procesado por la carga de datos, es necesario modificarlo a través de la edición de la carga de datos. De esta forma, el sistema intentará inferir la cultura del nuevo archivo y permitirá al usuario reconfigurarla según sea necesario.
Los campos para seleccionar las columnas del formulario de datos estarán deshabilitados, porque para editarlos es necesario hacerlo desde el propio formulario;
Esta etapa de mapeo será necesaria si los nombres mostrados en el archivo son diferentes de los nombres de los miembros de la dimensión, siendo necesario relacionar las columnas del archivo con las columnas del formulario de datos creado.
Seleccione las relaciones entre las columnas del formulario de datos y las del archivo de carga de datos haciendo clic en
en cada columna de la carga de datos, seleccionando la opción que se relacionará con la columna del formulario de datos (El usuario puede transformar/vincular información proveniente de una fuente externa, en este caso un archivo CSV, en otro dato que sea relevante para el proceso. Esta etapa de mapeo no es obligatoria).
Después de finalizar el mapeo, haga clic en
.
Haga clic en
.
Cada línea mostrada en Fuente de Datos y en Opciones se relacionará con una dimensión de la aplicación de destino seleccionada.
Con la opción parámetro seleccionada, al ejecutar la carga de datos, siempre podrá modificar el valor del parámetro antes de la ejecución.
Si ya existen datos en el formulario y el checkbox Ámbito de Exclusión no está habilitado, se generará un error en la ejecución de la carga.
Al habilitar la flag Agregar, las flags de Ámbito de Eliminación se deshabilitarán automáticamente, realizando la suma de los valores existentes en el formulario.
Los parámetros de carga son objetos de configuración global en T6 que centralizan valores de parámetros compartidos entre múltiples workflows y cargas de datos. En lugar de configurar el mismo valor individualmente en cada objeto, un parámetro de carga funciona como una única fuente de verdad externa que todos los objetos consumidores pueden referenciar.
Estos objetos se seleccionan en las cargas de datos y workflows mediante la opción Fuente de Datos > Parámetro al configurar el origen de datos.
Para crear un nuevo parámetro de carga:
El nombre del parámetro puede editarse en cualquier momento en Explorer sin afectar las referencias en los objetos que lo consumen, ya que esas referencias usan el identificador interno.
Los parámetros de carga admiten cuatro tipos base.
Almacena un valor de fecha. Los casos de uso típicos incluyen la definición de fechas de inicio y fin para cargas de datos o workflows que operan en intervalos de fechas.
Ejemplo: Un parámetro FechaInicio configurado con 01/01/2024 y consumido por todas las cargas de datos y workflows que procesan datos de enero de 2024.
Almacena un valor numérico con decimales. Úselo para porcentajes, multiplicadores o cualquier configuración que requiera valores fraccionarios.
Ejemplo: Un factor de ajuste del 15% almacenado como 0,15.
Almacena un número entero (sin parte decimal). Es más simple que el tipo Decimal cuando no se requiere precisión fraccionaria.
Almacena un valor de texto. Los parámetros de texto tienen subtipos que amplían su comportamiento:
| SubTipo | Descripción | Formato del Valor |
|---|---|---|
| Texto Libre | Un valor de texto libre | Cualquier texto |
| Miembro | Identifica un miembro cuando la dimensión ya es conocida | Solo el código del miembro |
| Atributo | Devuelve el valor de un atributo de miembro de dimensión | Cadena identificadora del atributo |
Si la flag Ejecutar al guardar fue habilitada durante la configuración de la carga de datos, el panel lateral de ejecución se abrirá automáticamente después de finalizar la configuración y guardar el objeto.
En el panel de ejecución de la carga de datos verá el nombre de la carga de datos configurada previamente, un campo para insertar archivos (por defecto, el archivo utilizado para configurar la carga estará adjunto), y, si se utilizó parámetro en la configuración de la fuente de datos, también se mostrarán los parámetros utilizados (puede modificar los parámetros según la necesidad en cada ejecución de carga).
Para ejecutar la carga de datos, haga clic en:
.
Al ejecutar la carga de datos, se generará una notificación del sistema informando sobre éxito en la ejecución, ejecución con fallos o error en la ejecución (en casos de ejecución con fallos, puede hacer clic en la notificación y ver qué causó el fallo; en caso de fallo de mapeo, puede ser dirigido a la corrección del mapeo directamente desde la pantalla de notificaciones. Para más información acceda a: Sistema de Notificación).
Esta sección presenta un ejemplo completo de extremo a extremo para cargar datos de planificación presupuestaria desde un archivo CSV en un cubo de T6. El ejemplo abarca la configuración del formulario de mapeo (tabla de correspondencia), la configuración del destino y la ejecución de la carga.
Considere un archivo CSV de planificación presupuestaria con las siguientes columnas:
| Columna | Descripción |
|---|---|
| cuenta | Descripción de la cuenta del sistema de origen (ej.: "Energía Eléctrica", "Restaurante") |
| tipo | Tipo de agrupamiento para diferenciar cuentas con nombres idénticos (ej.: "Grupo 1", "Grupo 2") |
| fecha | Mes y año del lanzamiento de planificación |
| valor | Importe presupuestado |
La aplicación de destino tiene cuatro dimensiones: Cuenta, Tiempo, Escenario y Entidad.
Los nombres de cuenta en el CSV no coinciden con los nombres de miembro en la dimensión Cuenta, y algunos nombres se repiten para diferentes tipos. Por ello, se necesita un formulario de mapeo (tabla de correspondencia) para traducir los valores del CSV en los miembros de dimensión correctos.
Antes de crear la carga de datos, configure un formulario de datos para funcionar como tabla de correspondencia. Este formulario mapea combinaciones de valores del CSV a los miembros correspondientes de la dimensión Cuenta.
| cuenta (CSV) | tipo (CSV) | miembro_cuenta (dimensión) |
|---|---|---|
| Energía Eléctrica | Grupo 1 | Energía Eléctrica — Grupo 1 |
| Energía Eléctrica | Grupo 2 | Energía Eléctrica — Grupo 2 |
| Restaurante | Grupo 1 | Restaurante — Operaciones |
| Restaurante | Grupo 2 | Restaurante — Eventos |
Cada valor de cuenta que aparezca en el CSV debe tener una entrada correspondiente en este formulario. Si algún valor del CSV no se encuentra durante el join, la carga de datos generará un error para esa fila.
Después de configurar un mapeo, las columnas del formulario de datos que no se usaron como clave de join (en este ejemplo, miembro_cuenta) quedan disponibles como opciones adicionales de fuente de datos en el paso de Destino. Estas columnas representan los valores resueltos mediante la tabla de correspondencia en el momento de la ejecución.
| Dimensión | Fuente de Datos | Opción Seleccionada |
|---|---|---|
| Cuenta | Archivo | Columna miembro_cuenta (resuelta mediante el join del mapeo) |
| Tiempo | Archivo | Columna fecha del CSV |
| Escenario | Parámetro | Parámetro de carga preconfigurado con el escenario de destino |
| Entidad | Dimensión | Miembro fijo seleccionado directamente desde la jerarquía de dimensión |
El Ámbito de Exclusión es una configuración crítica. Antes de insertar cualquier fila del CSV, T6 elimina todos los registros de la tabla de hechos que coincidan con el ámbito configurado.
El Ámbito de Exclusión elimina todos los registros de la tabla de hechos que coincidan con el ámbito — no solo los registros que provienen del archivo CSV. Configúrelo con cuidado para evitar pérdidas de datos no deseadas.
Ejemplo con una dimensión: Configurar Escenario = Actual eliminará todos los registros de la tabla de hechos donde Escenario = Actual antes de cargar, independientemente de cómo se ingresaron originalmente esos datos.
Combinar dimensiones restringe el ámbito: Agregar Tiempo = 2024 al ámbito anterior hará que solo se eliminen los registros donde Escenario = Actual y Tiempo = 2024, preservando los datos de otros años. Esta técnica es recomendable cuando múltiples procesos cargan datos en la misma aplicación.
Cuando la flag Agregar está habilitada, el Ámbito de Exclusión se ignora por completo — los valores existentes se conservan y los valores del CSV se suman a ellos en lugar de reemplazarlos.
Algunas acciones pueden generar inconsistencias en las cargas de datos, como por ejemplo un formulario de datos inexistente, un campo o parámetro no localizado o no existente en el mapeo o en el formulario, objetos configurados en la carga que fueron alterados, entre otros. En estos casos, se habilitará una nueva pestaña en la etapa de edición de la carga de datos: la pestaña de Inconsistencia.
Si algún objeto configurado en la carga se altera o elimina, al intentar ejecutar o editar la carga se abrirá esta pestaña y será necesario corregir o reconfigurar la carga para poder ejecutarla.
En la pestaña de inconsistencias, el usuario solo visualiza el motivo que generó la inconsistencia; la corrección y reconfiguración se realizan en las pestañas anteriores. Para más información acceda a: Sistema de Notificación.
Al hacer clic en editar, si hay inconsistencias, la pestaña de inconsistencias será la pestaña de apertura; de lo contrario, estará deshabilitada.
Para crear Cargas de Datos en T6, el usuario debe tener habilitadas las siguientes funcionalidades: de Administrador Gestionar Rutinas de Carga, de Gestor Crear y Visualizar Formularios de Entrada de Datos y Ejecutar Carga de Datos, y además estar asociado a un grupo global con la funcionalidad Gestionar Explorer.
Actualmente, T6 solo admite archivos CSV para carga de datos.
No. La configuración solo se vuelve obligatoria cuando el sistema no logra inferir automáticamente los parámetros del archivo (ej.: formato, delimitadores, etc.).
En las Cargas de Datos de T6, el mapeo es opcional. Solo es necesario cuando los nombres de las columnas del archivo CSV son diferentes de los nombres de los miembros de dimensión en el formulario.
Al intentar ejecutar la carga de datos sin la flag de Ámbito de Exclusión habilitada, y si ya existen datos en el formulario, se generará un error en la ejecución de la carga, porque el sistema necesita saber cómo tratar los datos existentes.
Las dos flags tratan de forma diferente la inserción de datos en el formulario.
Agregar suma los nuevos valores a los existentes;
Ámbito de Exclusión permite sustituir datos específicos.
Estas opciones son mutuamente excluyentes.
Al mantener habilitada la flag Ejecutar online, el sistema ejecuta automáticamente las fórmulas del cubo después de finalizar la carga de datos.
Cuando existan inconsistencias, al intentar acceder a la Carga de Datos se mostrará la pestaña de inconsistencias. En esa pestaña podrá visualizar los motivos de las inconsistencias y deberá corregir o reconfigurar la carga para poder ejecutarla.
Siempre que se ejecute una carga de datos en T6, el sistema genera notificaciones informando sobre éxito, fallos o errores en la ejecución. En caso de fallos, puede hacer clic en la notificación para ver detalles.
Sí, en el panel de ejecución puede adjuntar un nuevo archivo CSV para usar en la carga de datos.
La configuración de parámetros de destino en las cargas de datos permite valores dinámicos que pueden modificarse en cada ejecución de carga, ofreciendo mayor flexibilidad.
La opción Dimensión en la fuente de datos de la carga de datos permite seleccionar un miembro específico de la dimensión que permanecerá fijo durante toda la ejecución de la carga.
El Ámbito de Exclusión elimina todos los registros de la tabla de hechos que coincidan con el ámbito configurado — no solo los registros que fueron cargados previamente por esa carga de datos. Antes de insertar nuevas filas del CSV, T6 elimina todos los registros de la tabla de hechos donde los miembros de dimensión coinciden con el ámbito definido, independientemente de cómo se ingresaron originalmente.
Sí. Puede configurar un ámbito en múltiples dimensiones simultáneamente. T6 eliminará solo los registros donde todos los miembros de dimensión configurados coincidan, creando un filtro más preciso. Por ejemplo, definir Escenario = Actual y Tiempo = 2024 eliminará únicamente los registros que tengan ambos ese escenario y ese miembro de tiempo, dejando intactos los registros de otros años.
Si el escenario de destino está bloqueado o cerrado, T6 no permitirá escribir datos en él. La carga de datos generará un error de ejecución indicando que no se permiten modificaciones en un escenario bloqueado. Es necesario desbloquear el escenario antes de ejecutar la carga.
Sí, los atributos de dimensión pueden usarse en el Ámbito de Exclusión para reducir el conjunto de registros que se eliminarán. Sin embargo, los atributos no pueden usarse en la configuración de fuente de datos Parámetro, que requiere un identificador de miembro específico.