Tres archivos, una tabla

Las capturas muestran Q-Expert en inglés; la interfaz en español llegará pronto.

01La pregunta de negocio

Q-Expert Distributors recibe sus ventas en un archivo por mes: Sales_2025_01.csv, Sales_2025_02.csv y Sales_2025_03.csv. El equipo quiere todos en una sola tabla, y que el archivo del próximo mes cargue sin que nadie toque el script.

02Antes de empezar

• Descomprime el paquete del episodio. Necesitas data/Sales_2025_01.csv … Sales_2025_03.csv y, para el último paso, data/Raw/Sales_2025_01.qvd … _03.qvd.
• El episodio 1 empieza con un proyecto vacío, así que no hay start.qep que importar. Desde el episodio 2, cada paquete trae el proyecto tal como lo dejó el episodio anterior.
• En Qlik, crea una conexión de datos de carpeta llamada QXDistributors que apunte a la carpeta data que descomprimiste. El script lee todos los archivos a través de ella. Dentro de esa carpeta data, crea también la carpeta Transform/_QVS: ahí van los archivos de script de Q-Expert (ver Revisa tu resultado).
• ¿Quieres ver los archivos por dentro antes de empezar? Q-Explorator, la herramienta de escritorio del equipo de Q-Fábrica, abre archivos CSV, Excel, Parquet y QVD para que veas su contenido y su calidad antes de modelar.

03Paso a paso

1. 1

   Crea el proyecto

   Haz clic en New Project en la barra superior. Llámalo Q-Expert Distributors y haz clic en Create Project. Todo modelo empieza en un canvas limpio.

   

2. 2

   Di dónde viven los archivos

   Abre Project Settings → Source Paths. Agrega un mapeo con el nombre de variable vPathRaw y la carpeta QXDistributors, de modo que la fila diga vPathRaw = lib://QXDistributors/. En la misma pestaña, pon vTxfPath en lib://QXDistributors/Transform/: ahí viven los QVD de trabajo y los archivos de script que Q-Expert separa, bajo la misma conexión.

   

3. 3

   Define los formatos numéricos del proyecto

   Estos archivos usan punto para los decimales y coma para los miles. Haz clic en $(x) en la barra superior y, en la pestaña Predefined, define:

   • ThousandSep ,
   • DecimalSep .
   • MoneyThousandSep ,
   • MoneyDecimalSep .
   • MoneyFormat $ #,##0.00;-$ #,##0.00

   

4. 4

   Agrega las variables de proyecto

   Pasa a la pestaña Project y agrega, cada una con el botón +:

   • vEnvironment = PROD
   • vBaseCurrency = COP (la usa el episodio 4)

   Luego haz clic en Save.

   

5. 5

   Agrega los tres archivos de ventas

   En la Library, haz clic en Add Files y elige los tres archivos Sales_2025_0N.csv. Q-Expert ve las mismas columnas en todos y los agrupa bajo un solo patrón, Sales_*.csv.

   

6. 6

   Arrastra el grupo al canvas

   Arrastra el encabezado del grupo Sales_*.csv al canvas. Un solo nodo RAW lee todos los meses: los tres archivos de hoy y los que vienen.

   

7. 7

   Nómbrala como tabla de trabajo

   Selecciona el nodo. En la pestaña Config, escribe tmp_SalesRaw como nombre de la tabla y presiona Tab.

   

8. 8

   Explica el porqué en un comentario

   En la pestaña Info, escribe en Comments: Sales arrive as one file per month; the wildcard reads every month, including next month's file. Va al script justo encima del LOAD.

   

9. 9

   Genera el script

   Haz clic en Generate Syntax y abre la pestaña Flow_1. Un solo LOAD con un asterisco en la ruta, leído a través de la variable: FROM [$(vPathRaw)Sales_*.csv]. El archivo del próximo mes simplemente funciona.

   

10. 10

    La misma idea con archivos QVD

    Agrega los tres archivos de data/Raw/. Son QVD, así que la Library crea un segundo grupo, Sales_*.qvd, junto a Sales_*.csv. Arrastrado al canvas, los lee con (qvd). El curso sigue con los archivos CSV, así que deja este grupo en la Library.

    

04Revisa tu resultado

• El canvas tiene un nodo RAW, tmp_SalesRaw, con 11 de 11 columnas: SaleID, SaleDate, CustomerID, ProductID, SalespersonID, BranchID, Quantity, UnitPrice, DiscountPct, Currency y Channel.
• Ejecuta el script en Qlik: tmp_SalesRaw tiene 330 filas, 110 de cada mes.
• Q-Expert divide el script en dos: _Main, la única parte que pegas en Qlik, y Flow_1.qvs, un archivo que _Main lee con MUST_INCLUDE. Ambos deben coincidir con los de abajo, salvo la fecha del encabezado y una línea // Q-Expert · Ref … con tu propia referencia.

/*----------------------------------------------------------------------------------------
	Description [MAIN]:
		
	-------------------------------------------------------------------------------------
	Author:	The Q-Fábrica team - 
	Date:	[2026-11-02]
	-------------------------------------------------------------------------------------
	Changes
	-------------------------------------------------------------------------------------
	Author		Date		Detail
	-------------------------------------------------------------------------------------

	-------------------------------------------------------------------------------------
	Copyright © Q-Expert Distributors.
	Q-Expert Qlik Developer Framework. www.qfabrica.com
----------------------------------------------------------------------------------------*/

SET ThousandSep=',';
SET DecimalSep='.';
SET MoneyThousandSep=',';
SET MoneyDecimalSep='.';
SET MoneyFormat='$ #,##0.00;-$ #,##0.00';
SET TimeFormat='hh:mm:ss';
SET DateFormat='YYYY-MM-DD';
SET TimestampFormat='YYYY-MM-DD hh:mm:ss';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';
SET LongMonthNames='January;February;March;April;May;June;July;August;September;October;November;December';
SET DayNames='Mon;Tue;Wed;Thu;Fri;Sat;Sun';
SET LongDayNames='Monday;Tuesday;Wednesday;Thursday;Friday;Saturday;Sunday';
SET FirstWeekDay=0;
SET BrokenWeeks=1;
SET ReferenceDay=4;
SET FirstMonthOfYear=1;

LET vExecutionDate = Timestamp(Now(), 'YYYY-MM-DD hh:mm:ss');

SET vTxfPath  = 'lib://QXDistributors/Transform/';
SET vPathRaw = 'lib://QXDistributors/';
SET vEnvironment = 'PROD';   // PROD, QA or DEV
SET vBaseCurrency = 'COP';   // Currency every amount is converted to

$(MUST_INCLUDE=$(vTxfPath)_QVS/Flow_1.qvs);

/*----------------------------------------------------------------------------------------
	Description [Flow_1]:
		
	-------------------------------------------------------------------------------------
	Author:	The Q-Fábrica team - 
	Date:	[2026-11-02]
	-------------------------------------------------------------------------------------
	Changes
	-------------------------------------------------------------------------------------
	Author		Date		Detail
	-------------------------------------------------------------------------------------

	-------------------------------------------------------------------------------------
	Copyright © Q-Expert Distributors.
	Q-Expert Qlik Developer Framework. www.qfabrica.com
----------------------------------------------------------------------------------------*/

// -------------------------------------------------------------------------------------------------
// Sales arrive as one file per month; the wildcard reads every month, including next month's file.
[tmp_SalesRaw]:
    LOAD
        SaleID,
        SaleDate,
        CustomerID,
        ProductID,
        SalespersonID,
        BranchID,
        Quantity,
        UnitPrice,
        DiscountPct,
        Currency,
        Channel
    FROM [$(vPathRaw)Sales_*.csv] (txt, delimiter is ',', embedded labels);

05Por qué se hace así

• tmp_ dice que es una tabla de trabajo. tmp_SalesRaw es un paso hacia Fact_Sales, no parte del modelo final. Toda tabla tmp_ se elimina antes de que termine el script (episodio 6).
• ¿Comodín o loop? El comodín basta cuando todos los archivos tienen la misma estructura y no hay que hacer nada por archivo. El episodio 2 necesita saber de qué mes viene cada fila, y eso pide un loop.
• Rutas y formatos en variables. El script nunca fija una carpeta ni depende de la configuración regional del servidor Qlik que lo ejecuta. Por eso pasa de desarrollo a producción sin cambios.
• Nombres de campo en PascalCase, en inglés y sin espacios. Más adelante solo las llaves compartirán nombre entre tablas; cualquier otro nombre repetido crearía una llave sintética.

06Lo que sigue

Episodio 2: los mismos archivos, pero necesitamos saber de qué mes viene cada fila.