Manual de Actualización Dashboard de Operaciones (CPRM) - Genomma-Lab-Internacional/Developers GitHub Wiki

Acerca de este manual

El presente documento describe el proceso y requisitos de actualización del dashboard de Operaciones. Los pasos y consideraciones son exclusivos de este dashboard. Para la orientación en el uso y desarrollo de aplicaciones Qlik Sense o la consola de administración de Qlik Sense, consulte la página de Qlik o Qlik Community.

Consideraciones

• No cambiar la estructura del nombre de los archivos ni de las pestañas de los archivos Excel.
• No renombrar ni eliminar columnas en el Excel, en caso de que no se tenga el dato, dejar la columna vacía.
• Evite la inclusión de totales en los archivos Excel.
• Cualquier cambio en los puntos anteriores imposibilitará la automatización.

A continuación, se muestra la estructura para cada uno de los archivos Excel que deben mantenerse. Para todos los archivos:

• WW : Semana en formato de dos cifras (01, 02, …, 51, 52)
• YYYY : Año en formato de cuatro cifras (2018, 2019)

Nombre del archivo: Benavides-Semana WW

Ejemplo: Benavides-Semana 01

Nombre pestaña: Base

Etiqueta en renglón: 5

Nombre del archivo: Casa Ley-Semana WW

Ejemplo: Casa Ley-Semana 01

Nombre pestaña: Base

Etiqueta en renglón: 5

Nombre del archivo: City Fresko YYYYWW

Ejemplo: City Fresko 201846

Nombre pestaña: 46 Fresko

Etiqueta en renglón: 3

Nombre del archivo: Base Scorecard YYYYWW

Ejemplo: Base Scorecard 201846 Chedraui

Nombre pestaña: 46 Chedraui

Etiqueta en renglón: 3

Nombre del archivo: FAHO YYYYWW

Ejemplo: FAHO 201846

Nombre pestaña: detalle

Etiqueta en renglón: 2

Nombre del archivo: HEB-Semana WW

Ejemplo: HEB-Semana 01

Nombre pestaña: base

Etiqueta en renglón: 4

Nombre del archivo: Sams WW

Ejemplo: Sams 201847

Nombre pestaña: Base

Etiqueta en renglón: 3

Nombre del archivo: SP_WW

Ejemplo: SP_02

Nombre pestaña: Base

Etiqueta en renglón: 4

Nombre del archivo: Soriana OTC-Semana WW

Ejemplo: Soriana OTC-Semana 01

Nombre pestaña: BASE

Etiqueta en renglón: 4

Nombre del archivo: Soriana Belleza YYYYWW

Ejemplo: Soriana Belleza 201846

Nombre pestaña: Base

Etiqueta en renglón: 2

Nombre del archivo: Walmart YYYYWW

Ejemplo: Walmart 201846

Nombre pestaña: Base

Etiqueta en renglón: 4

Estructura de las aplicaciones

• OPERACIONES EXTV2

Esta aplicación no almacena información, se encarga exclusivamente de extraer los datos de los archivos Excel e importarlos a archivos QVD.

Del lado izquierdo se encuentra una pestaña por cada tienda, del lado derecho las conexiones. Cada pestaña contiene una subrutina con el mismo código, lo único que varía es el nombre de la tabla, el nombre del QVD (el cual debe incluir el uso de las variables vAño y vSemana como se muestra en la ilustración 1) y la ruta, pestaña y tamaño de la cabecera del archivo Excel.

El uso de subrutinas facilita elegir cuales son los archivos a actualizar. En la última pestaña, llamada Subrutinas, se debe colocar la semana y el año que se ha de actualizar. Una vez definidas estas variables, las subrutinas cargarán los archivos QVD con el histórico de cada tienda y extraerán el respectivo Excel de acuerdo a las variables.

En la imagen anterior se muestra el caso en el que se actualizará la semana 46 del 2018 para todas las tiendas. Para seleccionar que tiendas se han de actualizar, es necesario comentar el nombre de las tiendas que deben omitirse en la actualización. Para comentar simplemente coloque dos diagonales al principio del renglón o bien, seleccione la línea o líneas que desea comentar y de clic en el ícono de la parte de arriba . Ejemplo. Solo se requiere actualizar la semana 46 del 2018 para Benavides, Casa Ley y Sams.

Si necesita actualizar dos o más semanas consecutivas, puede realizar un ciclo for.

Ejemplo Solo se requiere actualizar los archivos de Benavides, Casa Ley y Sams de la semana 46 a la 52.

Nota: Si requiere añadir algún otro archivo que no esté listado en las subrutinas, copie el código de alguna de las subrutinas y cambie el nombre de la subrutina, la etiqueta de la tabla, el archivo QVD y la ruta Excel. Asegúrese de que el código mantenga la estructura general de la subrutina de extracción (Ilustración 1). Para crear un archivo QVD inicial puede crear una nueva aplicación, cargar el QVD de cualquier tienda y limitar con un WHERE para que no regrese ningún dato, pero ya se tenga la estructura y nombre de los campos. Ejemplo

Otra opción es, basándose en la ilustración 1, comente la parte de la carga del QVD, así solo estará importando el Excel a formato QVD que podrá servir como QVD inicial. No olvide descomentar esa parte en una segunda recarga para actualizar el QVD y no solo sobreescribirlo.

• PERFECT STORE

Esta aplicación se conecta vía SQL y mediante una carga incremental extrae los datos del indicador Perfect Store. Es candidata a recarga automática ya que no requiere ninguna modificación o parámetro que deba especificar el usuario.

• OPERACIONES TRANS A

Esta aplicación consume los QVD producto de la extracción uniéndolos en uno solo. Da formato a los campos de texto:

• Grupo
• Formato
• Promotoría (Homologación)
• Desc Gli
• Marca Gli
• Agp
• Status Gli
• Grupo

Si extrae los datos de otra tienda, agregue el código solo copiando y pegando el código de alguna de las tablas que están siendo concatenadas y cambie el nombre del QVD.

• OPERACIONES

Aquí se integran todas las fuentes (listadas abajo) para el desarrollo del modelo de datos que permitirán la visualización de los objetos presentes en las 8 pestañas de esta aplicación. No requiere modificación alguna.

Catálogos:

• Catálogo canal
• Tiendas Promotoría
• Estados_cat
• Calendario

Estatus producto Facts:

• Histórico 2017 a semana 44 de 2018 (la extracción de este QVD no se describe en este documento dado que no es necesario volverlo a realizar)
• Trans1 (de Operaciones Trans)
• Perfect Store

SUPOSICIONES

• Los archivos Excel tendrán el formato especificado en el apartado anterior.
• La aplicación estará montada en el servidor con la versión Qlik Sense Enterprise.
• La aplicación será visible para todos los usuarios con acceso a una licencia. El presente manual no considera roles de seguridad ni Section Access.
• Los usuarios actualizarán a conveniencia, elegirán los archivos que se actualizarán, no habrá recargas automáticas.
• La carga de información es incremental, es decir, no se modificará el histórico y solo se agregará lo nuevo.  

MANUAL DE RECARGA

Antes de recargar, asegúrese de respaldar los archivos QVD existentes.

1. Abrir aplicación Operaciones_extv2.
2. Lo primero que verá es el mensaje que indica que la aplicación no tiene datos, dar clic en Abrir, para entrar al Editor de carga de datos

3. Una vez en el editor, diríjase a la pestaña del script llamada Subrutinas

4. Modifique las variables vSemana y vAño según sea el caso y comente las tiendas que no requieran actualizarse.
5. De clic en Cargar datos en la parte superior derecha. Si la pantalla muestra algún error verifique que los archivos Excel cumplan con la estructura descrita.
6. Al terminar la carga, abra la app Operaciones trans
7. Mostrará la misma ventana que el paso 2, de clic en Abrir
8. En el editor de script de click en Cargar datos
9. Al terminar la carga, abra la app Operaciones
10. De clic en el ícono de la esquina superior izquierda y abra el Editor de Carga de datos.
11. En el editor de script de click en Cargar datos
12. Verifique que estén disponibles los nuevos datos en los objetos.

Si desea verificar la actualización de los datos antes de actualizar la aplicación final, puede comentar las líneas que incluyan drop table para tener disponibles los datos en las apps de extracción o transformación y crear tablas con los datos que desee validar.