bi-superpowers 1.0.0

package/templates/base-template/base-template.SemanticModel/definition/database.tmdl

@@ -0,0 +1,3 @@
+database
+	compatibilityLevel: 1702
+

package/templates/base-template/base-template.SemanticModel/definition/expressions.tmdl

@@ -0,0 +1,234 @@
+/// Helper M didáctico que calcula el número de semana ISO de una fecha.
+expression fxTemplateIsoWeek =
+		(dateValue as date) as number =>
+		let
+		    // En M, let crea pasos con nombre. Cada paso puede usar los pasos anteriores.
+		    // dateValue es el parametro de entrada: la fecha que queremos clasificar.
+		    // Date.DayOfWeek devuelve el dia de la semana como numero.
+		    // Day.Monday hace que lunes sea el inicio de la semana.
+		    dayIndex = Date.DayOfWeek(dateValue, Day.Monday),
+		    // Para calendario ISO, el jueves define a que año pertenece la semana.
+		    // Si una semana cruza de diciembre a enero, este ajuste evita clasificarla mal.
+		    thursday = Date.AddDays(dateValue, 3 - dayIndex),
+		    // Date.Year extrae el año de la fecha ajustada al jueves.
+		    isoYear = Date.Year(thursday),
+		    // El 4 de enero siempre pertenece a la semana ISO 1.
+		    firstThursday = #date(isoYear, 1, 4),
+		    // Buscamos el lunes de la semana que contiene al 4 de enero.
+		    firstWeekStart = Date.StartOfWeek(firstThursday, Day.Monday),
+		    // Buscamos el lunes de la semana de la fecha recibida.
+		    weekStart = Date.StartOfWeek(dateValue, Day.Monday),
+		    // Duration.Days cuenta dias entre ambos lunes.
+		    // Number.IntegerDivide divide por 7 y se queda con semanas completas.
+		    // Sumamos 1 porque la primera semana se numera como 1, no como 0.
+		    week = Number.IntegerDivide(Duration.Days(weekStart - firstWeekStart), 7) + 1
+		in
+		    // in devuelve el paso final de la query o funcion.
+		    week
+	lineageTag: 8177d19e-7f3b-4eb2-a9b4-13ed978a2925
+	queryGroup: Calendario
+
+	annotation PBI_NavigationStepName = Navegación
+
+	annotation PBI_ResultType = Function
+
+/// Helper M didáctico que replica la aproximación de año fiscal 4-4-5 del template.
+expression fxTemplateCalendar445Year =
+		(dateValue as date) as number =>
+		let
+		    // Esta funcion recibe una fecha y devuelve el año fiscal 4-4-5 aproximado.
+		    // Day.Monday hace que el calculo semanal empiece los lunes.
+		    dayIndex = Date.DayOfWeek(dateValue, Day.Monday),
+		    // Movemos la fecha hacia el jueves de su semana.
+		    // El jueves funciona como ancla para semanas que cruzan de un año a otro.
+		    fiscalAnchorDate = Date.AddDays(dateValue, 3 - dayIndex),
+		    // Date.Year toma solo el año de la fecha ancla.
+		    fiscalYear = Date.Year(fiscalAnchorDate)
+		in
+		    // Devolvemos el año fiscal aproximado.
+		    fiscalYear
+	lineageTag: bc114851-859b-4070-8a1f-94277a765443
+	queryGroup: Calendario
+
+	annotation PBI_NavigationStepName = Navegación
+
+	annotation PBI_ResultType = Function
+
+/// Helper M didáctico que calcula el mes fiscal 4-4-5 aproximado del template.
+expression fxTemplateCalendar445MonthNr =
+		(dateValue as date) as number =>
+		let
+		    // Esta funcion recibe una fecha y devuelve un numero de mes fiscal entre 1 y 12.
+		    // Reutilizamos fxTemplateIsoWeek para saber en que semana del año cae la fecha.
+		    weekNr = fxTemplateIsoWeek(dateValue),
+		    // En un calendario 4-4-5, los meses de cada trimestre duran 4, 4 y 5 semanas.
+		    // Las condiciones se leen de arriba hacia abajo y la primera verdadera gana.
+		    fiscalMonth =
+		        if weekNr <= 4 then 1
+		        else if weekNr <= 8 then 2
+		        else if weekNr <= 13 then 3
+		        else if weekNr <= 17 then 4
+		        else if weekNr <= 21 then 5
+		        else if weekNr <= 26 then 6
+		        else if weekNr <= 30 then 7
+		        else if weekNr <= 34 then 8
+		        else if weekNr <= 39 then 9
+		        else if weekNr <= 43 then 10
+		        else if weekNr <= 47 then 11
+		        else 12
+		in
+		    // Devolvemos el mes fiscal aproximado.
+		    fiscalMonth
+	lineageTag: 92f3a8a4-5c4d-4efc-a8f9-3a4d0a9d4b9b
+	queryGroup: Calendario
+
+	annotation PBI_NavigationStepName = Navegación
+
+	annotation PBI_ResultType = Function
+
+/// Parámetro de Power Query que define la fecha inicial del calendario del template.
+expression FechaInicio =
+		// Este parametro indica desde que dia empieza la tabla Calendario.
+		// Si se cambia esta fecha, el calendario tendra mas o menos filas.
+		#date(2023, 1, 1) meta [IsParameterQuery=true, Type="Date", IsParameterQueryRequired=true]
+	lineageTag: c49bce2a-539e-46c9-9554-9bba49ca7580
+	queryGroup: Params
+
+	annotation PBI_ResultType = Date
+
+	annotation PBI_NavigationStepName = Navegación
+
+/// Parámetro de Power Query que define el offset horario UTC del template.
+expression ZonaHoraria =
+		// Este parametro ajusta la fecha actual segun la zona horaria.
+		// Buenos Aires usa -3; España suele usar 1 o 2 segun horario de verano.
+		-3 meta [IsParameterQuery=true, Type="Number", IsParameterQueryRequired=true]
+	lineageTag: f11ac853-0898-4e54-ac32-115848938226
+	queryGroup: Params
+
+	annotation PBI_ResultType = Number
+
+	annotation PBI_NavigationStepName = Navegación
+
+/// Parámetro de Power Query que define la moneda base y moneda default de visualización.
+expression MonedaBase =
+		// Este parametro define la moneda base del modelo.
+		// Las funciones de conversion usan esta moneda como punto intermedio.
+		"USD" meta [IsParameterQuery=true, Type="Text", IsParameterQueryRequired=true]
+	lineageTag: 49a97699-aa32-43e9-a7c6-8f42299f36a1
+	queryGroup: Params
+
+	annotation PBI_ResultType = Exception
+
+	annotation PBI_NavigationStepName = Navegación
+
+/// Parámetro de Power Query que define si los períodos dinámicos incluyen la fecha actual del modelo.
+expression IncluirHoy =
+		// TRUE significa que los periodos terminan en hoy.
+		// FALSE significa que los periodos terminan en ayer.
+		true meta [IsParameterQuery=true, Type="Logical", IsParameterQueryRequired=true]
+	lineageTag: 5d8d5732-49e2-4d2a-a216-9ed53a5b6a10
+	queryGroup: Params
+
+	annotation PBI_ResultType = Exception
+
+	annotation PBI_NavigationStepName = Navegación
+
+/// Query auxiliar M que define las vistas de calendario disponibles para slicers y cálculos.
+expression 'Tipos de calendario' =
+		let
+		    // Esta query crea una tabla manual pequeña.
+		    // En Power Query, #table permite escribir filas directamente en el codigo.
+		    Source = #table(
+		        // Definimos solo las columnas que consume el template: vista y orden.
+		        type table [#"Vista de calendario" = text, #"Orden vista de calendario" = Int64.Type],
+		        {
+		            // Fila 1: calendario gregoriano tradicional.
+		            {"Gregoriano", 1},
+		            // Fila 2: calendario fiscal semanal 4-4-5.
+		            {"Semanal 4-4-5", 2}
+		        }
+		    )
+		in
+		    // Devolvemos la tabla Source para que otras queries la puedan usar.
+		    Source
+	lineageTag: a069c0cc-4f7d-4fca-b7c9-37487d05240f
+	queryGroup: Calendario
+
+/// Query editable por el usuario que define los períodos visibles en el slicer de Aux Períodos.
+expression 'Períodos predefinidos' =
+		let
+		    // Esta tabla es el catalogo de periodos que vera el usuario.
+		    // Si borras una fila, ese periodo desaparece cuando se refresca Aux Periodos.
+		    Source = #table(
+		        // Periodo es la etiqueta visible en español y Sort define el orden.
+		        type table [#"Período" = text, Sort = Int64.Type],
+		        {
+		            // Periodos moviles cortos.
+		            {"Hoy", 1},
+		            {"Ayer", 2},
+		            {"Últimos 7 días", 3},
+		            {"Últimos 30 días", 4},
+		            {"Últimos 90 días", 5},
+		            {"Últimos 180 días", 6},
+		            {"Últimos 365 días", 7},
+		            // Periodos fijos del calendario.
+		            {"Esta semana", 8},
+		            {"Semana pasada", 9},
+		            {"Este mes", 10},
+		            {"Mes pasado", 11},
+		            {"Este trimestre", 12},
+		            {"Trimestre pasado", 13},
+		            {"Este semestre", 14},
+		            {"Semestre pasado", 15},
+		            {"Este año", 16},
+		            {"Año pasado", 17},
+		            // Historico cubre todo el rango disponible.
+		            {"Histórico", 18}
+		        }
+		    )
+		in
+		    // Devolvemos el catalogo completo.
+		    Source
+	lineageTag: 64c9497c-8a00-4ae3-ba2b-30f625ff6abd
+	queryGroup: Calendario
+
+/// Query editable por el usuario que define las comparaciones visibles en Aux Comparaciones.
+expression 'Comparaciones predefinidas' =
+		let
+		    // Esta tabla define los textos de comparacion que aparecen en el slicer.
+		    // La columna Sort debe coincidir con Periodos predefinidos para reutilizar el mismo orden.
+		    Source = #table(
+		        // El esquema queda solo en español: orden y etiqueta visible.
+		        type table [Sort = Int64.Type, #"Período actual (vs. período previo)" = text],
+		        {
+		            // Comparaciones dia contra dia.
+		            {1, "Hoy (vs. Ayer)"},
+		            {2, "Ayer (vs. día anterior)"},
+		            // Comparaciones moviles contra la misma cantidad de dias previos.
+		            {3, "Últimos 7 días (vs. 7 días previos)"},
+		            {4, "Últimos 30 días (vs. 30 días previos)"},
+		            {5, "Últimos 90 días (vs. 90 días previos)"},
+		            {6, "Últimos 180 días (vs. 180 días previos)"},
+		            {7, "Últimos 365 días (vs. 365 días previos)"},
+		            // Comparaciones de periodo actual contra periodo anterior equivalente.
+		            {8, "Esta semana (vs. semana pasada)"},
+		            {9, "Semana pasada (vs. semana anterior)"},
+		            {10, "Este mes (vs. mes pasado)"},
+		            {11, "Mes pasado (vs. mes anterior)"},
+		            {12, "Este trimestre (vs. trimestre pasado)"},
+		            {13, "Trimestre pasado (vs. trimestre anterior)"},
+		            {14, "Este semestre (vs. semestre pasado)"},
+		            {15, "Semestre pasado (vs. semestre anterior)"},
+		            {16, "Este año (vs. año pasado)"},
+		            {17, "Año pasado (vs. año anterior)"},
+		            // Historico no necesita comparacion previa.
+		            {18, "Histórico"}
+		        }
+		    )
+		in
+		    // Devolvemos el catalogo de comparaciones.
+		    Source
+	lineageTag: 85e0cb3c-0f2d-49e2-b73e-d1aaf7197a32
+	queryGroup: Calendario
+