bi-superpowers 1.0.0

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

@@ -0,0 +1,637 @@
+/// Devuelve el tipo de cambio de una moneda hacia la moneda base definida por MonedaBase para una fecha; la moneda base devuelve 1 sin depender de la tabla de tasas.
+function GetExchangeRate =
+		( currency : STRING, rateDate : DATETIME ) =>
+		// Esta funcion recibe una moneda y una fecha, y devuelve la tasa hacia la moneda base.
+		// currency es el codigo de moneda que llega desde la fila o medida, por ejemplo USD o EUR.
+		// rateDate es la fecha para buscar la tasa; si viene vacia, usamos la ultima fecha disponible.
+		VAR __BaseCurrency =
+		    // COALESCE devuelve el primer valor que no sea BLANK; si no encuentra nada, usa USD.
+		    COALESCE (
+		        // MAXX recorre una tabla fila por fila y devuelve el valor maximo encontrado.
+		        MAXX (
+		            // FILTER deja pasar solo la fila donde Configuracion dice Moneda Base.
+		            FILTER (
+		                '_Aux Modelo configuración',
+		                '_Aux Modelo configuración'[Configuración] = "Moneda Base"
+		            ),
+		            // De esa fila tomamos el texto de la moneda base.
+		            '_Aux Modelo configuración'[ValorTexto]
+		        ),
+		        // USD es el valor de seguridad si la tabla de configuracion no trae moneda base.
+		        "USD"
+		    )
+		VAR __Currency =
+		    // Si la moneda pedida viene vacia, asumimos que ya es la moneda base.
+		    COALESCE ( currency, __BaseCurrency )
+		VAR __SafeDate =
+		    // IF elige entre dos caminos: cuando rateDate esta vacia o cuando tiene fecha.
+		    IF (
+		        // ISBLANK detecta valores vacios en DAX.
+		        ISBLANK ( rateDate ),
+		        // Si no hay fecha, buscamos la ultima fecha cargada en Tipo de cambio.
+		        CALCULATE (
+		            MAX ( 'Tipo de cambio'[Fecha] ),
+		            // REMOVEFILTERS ignora filtros externos para mirar toda la tabla de tasas.
+		            REMOVEFILTERS ( 'Tipo de cambio' )
+		        ),
+		        // Si rateDate tiene valor, usamos esa fecha directamente.
+		        rateDate
+		    )
+		RETURN
+		    // RETURN indica cual es el resultado final de la funcion.
+		    IF (
+		        // Si la moneda pedida es la moneda base, la tasa es 1 porque no hay conversion.
+		        __Currency = __BaseCurrency,
+		        1,
+		        // Si no es moneda base, buscamos la fecha de tasa mas reciente hasta __SafeDate.
+		        VAR __LastAvailableDate =
+		            CALCULATE (
+		                MAX ( 'Tipo de cambio'[Fecha] ),
+		                REMOVEFILTERS ( 'Tipo de cambio' ),
+		                'Tipo de cambio'[Moneda] = __Currency,
+		                'Tipo de cambio'[Fecha] <= __SafeDate
+		            )
+		        VAR __Rate =
+		            // Con la fecha encontrada, ahora buscamos el valor de la tasa.
+		            CALCULATE (
+		                MAX ( 'Tipo de cambio'[TipoCambioBase] ),
+		                REMOVEFILTERS ( 'Tipo de cambio' ),
+		                'Tipo de cambio'[Moneda] = __Currency,
+		                'Tipo de cambio'[Fecha] = __LastAvailableDate
+		            )
+		        RETURN
+		            // Si falta la tasa, devolvemos 1 para que el reporte no explote con error.
+		            COALESCE ( __Rate, 1 )
+		    )
+	lineageTag: eaeb396c-d336-4383-9809-420213485325
+
+/// Convierte un importe desde una moneda origen hacia una moneda destino usando la moneda base definida por MonedaBase como pivote.
+function ConvertCurrency =
+		( amount : NUMERIC, fromCurrency : STRING, toCurrency : STRING, rateDate : DATETIME ) =>
+		// Esta funcion convierte un importe desde una moneda origen hacia una moneda destino.
+		// amount es el valor numerico que queremos convertir.
+		// fromCurrency es la moneda original del importe.
+		// toCurrency es la moneda final que el usuario quiere ver.
+		// rateDate es la fecha usada para buscar la tasa de cambio.
+		IF (
+		    // Si no hay importe, devolvemos BLANK para que el visual muestre vacio y no cero falso.
+		    ISBLANK ( amount ),
+		    BLANK (),
+		    // Si hay importe, calculamos las monedas y las tasas necesarias.
+		    VAR __BaseCurrency =
+		        // Buscamos la moneda base del modelo; si falta, usamos USD.
+		        COALESCE (
+		            MAXX (
+		                FILTER (
+		                    '_Aux Modelo configuración',
+		                    '_Aux Modelo configuración'[Configuración] = "Moneda Base"
+		                ),
+		                '_Aux Modelo configuración'[ValorTexto]
+		            ),
+		            "USD"
+		        )
+		    VAR __FromCurrency =
+		        // Si la moneda origen viene vacia, asumimos moneda base.
+		        COALESCE ( fromCurrency, __BaseCurrency )
+		    VAR __ToCurrency =
+		        // Si la moneda destino viene vacia, asumimos moneda base.
+		        COALESCE ( toCurrency, __BaseCurrency )
+		    RETURN
+		        IF (
+		            // Si origen y destino son iguales, no hace falta convertir.
+		            __FromCurrency = __ToCurrency,
+		            amount,
+		            // Tasa desde la moneda origen hacia la moneda base.
+		            VAR __RateToBase = GetExchangeRate ( __FromCurrency, rateDate )
+		            // Tasa desde la moneda destino hacia la moneda base.
+		            VAR __RateFromBase = GetExchangeRate ( __ToCurrency, rateDate )
+		            RETURN
+		                // Primero llevamos el importe a moneda base y luego a moneda destino.
+		                DIVIDE ( amount, __RateToBase ) * __RateFromBase
+		        )
+		)
+	lineageTag: 6015e897-8732-43b5-ba6f-46d586d5ce00
+
+/// Devuelve el año fiscal semanal aproximado 4-4-5 para una fecha. Sirve para comparar calendarios de retail contra calendario gregoriano.
+function Calendar445Year =
+		( DateValue : DATETIME ) =>
+		// Esta funcion recibe una fecha y calcula a que año fiscal 4-4-5 pertenece.
+		VAR __Date =
+		    // Guardamos la fecha de entrada en una variable para que el resto sea mas legible.
+		    DateValue
+		VAR __FiscalAnchorDate =
+		    // WEEKDAY con 2 significa que la semana empieza el lunes.
+		    // Restamos el numero de dia de la semana y sumamos 4 para movernos al jueves.
+		    // Usar el jueves estabiliza semanas que cruzan entre dos años.
+		    __Date - WEEKDAY ( __Date, 2 ) + 4
+		RETURN
+		    // Si la fecha esta vacia, devolvemos BLANK; si no, devolvemos el año del jueves calculado.
+		    IF ( ISBLANK ( __Date ), BLANK (), YEAR ( __FiscalAnchorDate ) )
+	lineageTag: 66eb01d4-c444-474f-8d1b-b3da5cb58aa5
+
+/// Devuelve el mes fiscal aproximado de un calendario semanal 4-4-5 para una fecha. Es una aproximación didáctica para el template.
+function Calendar445MonthNr =
+		( DateValue : DATETIME ) =>
+		// Esta funcion convierte una fecha en numero de mes fiscal 4-4-5 aproximado.
+		VAR __Date =
+		    // Guardamos la fecha de entrada para reutilizarla sin repetir el parametro.
+		    DateValue
+		VAR __WeekNr =
+		    // WEEKNUM con 21 calcula la semana ISO, que usa lunes como inicio de semana.
+		    WEEKNUM ( __Date, 21 )
+		VAR __FiscalMonth =
+		    // SWITCH TRUE evalua condiciones en orden y devuelve el primer resultado que coincida.
+		    SWITCH (
+		        TRUE (),
+		        // Semanas 1 a 4 forman el primer mes fiscal.
+		        __WeekNr <= 4, 1,
+		        // Semanas 5 a 8 forman el segundo mes fiscal.
+		        __WeekNr <= 8, 2,
+		        // Semanas 9 a 13 forman el tercer mes fiscal, cerrando el patron 4-4-5.
+		        __WeekNr <= 13, 3,
+		        __WeekNr <= 17, 4,
+		        __WeekNr <= 21, 5,
+		        __WeekNr <= 26, 6,
+		        __WeekNr <= 30, 7,
+		        __WeekNr <= 34, 8,
+		        __WeekNr <= 39, 9,
+		        __WeekNr <= 43, 10,
+		        __WeekNr <= 47, 11,
+		        // Cualquier semana posterior queda en el mes fiscal 12.
+		        12
+		    )
+		RETURN
+		    // Si la fecha esta vacia, devolvemos BLANK; si no, devolvemos el mes fiscal.
+		    IF ( ISBLANK ( __Date ), BLANK (), __FiscalMonth )
+	lineageTag: af2ea27b-986e-4cb6-ac7a-fa8721391ea6
+
+/// Devuelve una tabla de una fila con el calendario elegido, el rango actual y el rango previo. En modo predefinido toma el rango actual desde _Aux Períodos y calcula el previo en DAX; en modo Rango fechas usa las tablas auxiliares desconectadas.
+function CalendarContext =
+		() =>
+		// Esta funcion no recibe parametros: lee los slicers activos del reporte.
+		VAR __CalendarType =
+		    // Vista temporal activa: calendario gregoriano o semanal 4-4-5.
+		    SELECTEDVALUE ( '_Aux Vista de calendario'[Vista de calendario], "Gregoriano" )
+		VAR __Mode =
+		    // Modo semantico oculto: Predefinido usa Aux Comparaciones; Rango fechas usa el slicer desconectado.
+		    SELECTEDVALUE ( '_Aux Modo fechas'[Modo fechas], "Predefinido" )
+		VAR __Comparison =
+		    // Comparacion elegida en el slicer predefinido, por ejemplo Este mes vs mes pasado.
+		    SELECTEDVALUE ( '_Aux Comparaciones'[Comparación] )
+		VAR __DefaultComparison =
+		    // Si no hay seleccion predefinida, usamos Este mes para el calendario activo.
+		    MAXX (
+		        FILTER (
+		            ALL ( '_Aux Comparaciones' ),
+		            '_Aux Comparaciones'[Vista de calendario] = __CalendarType
+		                && '_Aux Comparaciones'[Orden] = 10
+		        ),
+		        '_Aux Comparaciones'[Comparación]
+		    )
+		VAR __SelectedComparison =
+		    // COALESCE toma la seleccion del usuario; si esta vacia, toma el default.
+		    COALESCE ( __Comparison, __DefaultComparison )
+		VAR __SelectedSort =
+		    // Orden numerico de la comparacion activa; si algo falla, vuelve a Este mes.
+		    COALESCE (
+		        MAXX (
+		            FILTER (
+		                ALL ( '_Aux Comparaciones' ),
+		                '_Aux Comparaciones'[Vista de calendario] = __CalendarType
+		                    && '_Aux Comparaciones'[Comparación] = __SelectedComparison
+		            ),
+		            '_Aux Comparaciones'[Orden]
+		        ),
+		        10
+		    )
+		VAR __CurrentRows =
+		    // Buscamos el rango actual en Aux Periodos, que es la tabla fuente confiable de fechas.
+		    FILTER (
+		        ALL ( '_Aux Períodos' ),
+		        '_Aux Períodos'[Vista de calendario] = __CalendarType
+		            && '_Aux Períodos'[Orden] = __SelectedSort
+		    )
+		VAR __CurrentStart =
+		    // Fecha inicial del periodo actual predefinido.
+		    MINX ( __CurrentRows, '_Aux Períodos'[FechaInicio] )
+		VAR __CurrentEnd =
+		    // Fecha final del periodo actual predefinido.
+		    MAXX ( __CurrentRows, '_Aux Períodos'[FechaFin] )
+		VAR __Days =
+		    // Cantidad de dias del periodo actual, contando inicio y fin.
+		    IF ( ISBLANK ( __CurrentStart ) || ISBLANK ( __CurrentEnd ), BLANK (), DATEDIFF ( __CurrentStart, __CurrentEnd, DAY ) + 1 )
+		VAR __OffsetDays =
+		    // Dias transcurridos dentro del periodo actual; sirve para cortar periodos previos incompletos.
+		    IF ( ISBLANK ( __CurrentStart ) || ISBLANK ( __CurrentEnd ), BLANK (), DATEDIFF ( __CurrentStart, __CurrentEnd, DAY ) )
+		VAR __PriorSort =
+		    // Para periodos en curso, el periodo previo sale de otra fila de Aux Periodos.
+		    SWITCH (
+		        TRUE (),
+		        __SelectedSort = 8, 9,
+		        __SelectedSort = 10, 11,
+		        __SelectedSort = 12, 13,
+		        __SelectedSort = 14, 15,
+		        __SelectedSort = 16, 17,
+		        BLANK ()
+		    )
+		VAR __PriorRows =
+		    // Fila del periodo previo fijo, por ejemplo Mes pasado para Este mes.
+		    FILTER (
+		        ALL ( '_Aux Períodos' ),
+		        '_Aux Períodos'[Vista de calendario] = __CalendarType
+		            && '_Aux Períodos'[Orden] = __PriorSort
+		    )
+		VAR __PriorStart =
+		    // Inicio completo del periodo previo fijo.
+		    MINX ( __PriorRows, '_Aux Períodos'[FechaInicio] )
+		VAR __PriorEndFull =
+		    // Fin completo del periodo previo fijo.
+		    MAXX ( __PriorRows, '_Aux Períodos'[FechaFin] )
+		VAR __PriorEndCut =
+		    // Si el periodo actual esta incompleto, cortamos el previo en la misma posicion relativa.
+		    IF (
+		        ISBLANK ( __PriorStart ) || ISBLANK ( __PriorEndFull ) || ISBLANK ( __OffsetDays ),
+		        BLANK (),
+		        MIN ( __PriorEndFull, __PriorStart + __OffsetDays )
+		    )
+		VAR __Is445 =
+		    // TRUE cuando el calendario activo es el semanal 4-4-5.
+		    __CalendarType = "Semanal 4-4-5"
+		VAR __FiscalMonthKey =
+		    // Clave fiscal del mes que contiene el inicio actual.
+		    MAXX ( FILTER ( ALL ( Calendario ), Calendario[Fecha] = __CurrentStart ), Calendario[Fiscal445MonthKey] )
+		VAR __PrevFiscalMonthKey =
+		    // Mes fiscal inmediatamente anterior al mes actual.
+		    MAXX ( FILTER ( ALL ( Calendario ), Calendario[Fiscal445MonthKey] < __FiscalMonthKey ), Calendario[Fiscal445MonthKey] )
+		VAR __FiscalQuarterKey =
+		    // Clave fiscal del trimestre que contiene el inicio actual.
+		    MAXX ( FILTER ( ALL ( Calendario ), Calendario[Fecha] = __CurrentStart ), Calendario[Fiscal445QuarterKey] )
+		VAR __PrevFiscalQuarterKey =
+		    // Trimestre fiscal inmediatamente anterior al trimestre actual.
+		    MAXX ( FILTER ( ALL ( Calendario ), Calendario[Fiscal445QuarterKey] < __FiscalQuarterKey ), Calendario[Fiscal445QuarterKey] )
+		VAR __FiscalSemesterKey =
+		    // Clave fiscal del semestre que contiene el inicio actual.
+		    MAXX ( FILTER ( ALL ( Calendario ), Calendario[Fecha] = __CurrentStart ), Calendario[Fiscal445SemesterKey] )
+		VAR __PrevFiscalSemesterKey =
+		    // Semestre fiscal inmediatamente anterior al semestre actual.
+		    MAXX ( FILTER ( ALL ( Calendario ), Calendario[Fiscal445SemesterKey] < __FiscalSemesterKey ), Calendario[Fiscal445SemesterKey] )
+		VAR __FiscalYear =
+		    // Año fiscal que contiene el inicio actual.
+		    MAXX ( FILTER ( ALL ( Calendario ), Calendario[Fecha] = __CurrentStart ), Calendario[Fiscal445Year] )
+		VAR __PrevFiscalYear =
+		    // Año fiscal inmediatamente anterior al actual.
+		    MAXX ( FILTER ( ALL ( Calendario ), Calendario[Fiscal445Year] < __FiscalYear ), Calendario[Fiscal445Year] )
+		VAR __PrevMonthStart =
+		    // Inicio del mes previo para comparaciones de Mes pasado.
+		    IF (
+		        __Is445,
+		        MINX ( FILTER ( ALL ( Calendario ), Calendario[Fiscal445MonthKey] = __PrevFiscalMonthKey ), Calendario[Fecha] ),
+		        EOMONTH ( __CurrentStart, -2 ) + 1
+		    )
+		VAR __PrevMonthEnd =
+		    // Fin del mes previo para comparaciones de Mes pasado.
+		    IF (
+		        __Is445,
+		        MAXX ( FILTER ( ALL ( Calendario ), Calendario[Fiscal445MonthKey] = __PrevFiscalMonthKey ), Calendario[Fecha] ),
+		        EOMONTH ( __CurrentStart, -1 )
+		    )
+		VAR __PrevQuarterStart =
+		    // Inicio del trimestre previo para comparaciones de Trimestre pasado.
+		    IF (
+		        __Is445,
+		        MINX ( FILTER ( ALL ( Calendario ), Calendario[Fiscal445QuarterKey] = __PrevFiscalQuarterKey ), Calendario[Fecha] ),
+		        EDATE ( __CurrentStart, -3 )
+		    )
+		VAR __PrevQuarterEnd =
+		    // Fin del trimestre previo para comparaciones de Trimestre pasado.
+		    IF (
+		        __Is445,
+		        MAXX ( FILTER ( ALL ( Calendario ), Calendario[Fiscal445QuarterKey] = __PrevFiscalQuarterKey ), Calendario[Fecha] ),
+		        __CurrentStart - 1
+		    )
+		VAR __PrevSemesterStart =
+		    // Inicio del semestre previo para comparaciones de Semestre pasado.
+		    IF (
+		        __Is445,
+		        MINX ( FILTER ( ALL ( Calendario ), Calendario[Fiscal445SemesterKey] = __PrevFiscalSemesterKey ), Calendario[Fecha] ),
+		        EDATE ( __CurrentStart, -6 )
+		    )
+		VAR __PrevSemesterEnd =
+		    // Fin del semestre previo para comparaciones de Semestre pasado.
+		    IF (
+		        __Is445,
+		        MAXX ( FILTER ( ALL ( Calendario ), Calendario[Fiscal445SemesterKey] = __PrevFiscalSemesterKey ), Calendario[Fecha] ),
+		        __CurrentStart - 1
+		    )
+		VAR __PrevYearStart =
+		    // Inicio del año previo para comparaciones de Año pasado.
+		    IF (
+		        __Is445,
+		        MINX ( FILTER ( ALL ( Calendario ), Calendario[Fiscal445Year] = __PrevFiscalYear ), Calendario[Fecha] ),
+		        DATE ( YEAR ( __CurrentStart ) - 1, 1, 1 )
+		    )
+		VAR __PrevYearEnd =
+		    // Fin del año previo para comparaciones de Año pasado.
+		    IF (
+		        __Is445,
+		        MAXX ( FILTER ( ALL ( Calendario ), Calendario[Fiscal445Year] = __PrevFiscalYear ), Calendario[Fecha] ),
+		        DATE ( YEAR ( __CurrentStart ) - 1, 12, 31 )
+		    )
+		VAR __PreviousStart =
+		    // Regla de inicio del periodo previo segun la opcion activa.
+		    SWITCH (
+		        TRUE (),
+		        ISBLANK ( __CurrentStart ) || ISBLANK ( __CurrentEnd ), BLANK (),
+		        __SelectedSort IN { 1, 2 }, __CurrentStart - 1,
+		        __SelectedSort IN { 3, 4, 5, 6, 7 }, __CurrentStart - __Days,
+		        __SelectedSort IN { 8, 10, 12, 14, 16 }, __PriorStart,
+		        __SelectedSort = 9, __CurrentStart - 7,
+		        __SelectedSort = 11, __PrevMonthStart,
+		        __SelectedSort = 13, __PrevQuarterStart,
+		        __SelectedSort = 15, __PrevSemesterStart,
+		        __SelectedSort = 17, __PrevYearStart,
+		        BLANK ()
+		    )
+		VAR __PreviousEnd =
+		    // Regla de fin del periodo previo segun la opcion activa.
+		    SWITCH (
+		        TRUE (),
+		        ISBLANK ( __CurrentStart ) || ISBLANK ( __CurrentEnd ), BLANK (),
+		        __SelectedSort IN { 1, 2 }, __CurrentEnd - 1,
+		        __SelectedSort IN { 3, 4, 5, 6, 7 }, __CurrentStart - 1,
+		        __SelectedSort IN { 8, 10, 12, 14, 16 }, __PriorEndCut,
+		        __SelectedSort = 9, __CurrentEnd - 7,
+		        __SelectedSort = 11, __PrevMonthEnd,
+		        __SelectedSort = 13, __PrevQuarterEnd,
+		        __SelectedSort = 15, __PrevSemesterEnd,
+		        __SelectedSort = 17, __PrevYearEnd,
+		        BLANK ()
+		    )
+		VAR __PresetContext =
+		    // Normalizamos el modo predefinido al contrato comun de CalendarContext.
+		    ROW (
+		        "Calendar Type", __CalendarType,
+		        "Current Start", __CurrentStart,
+		        "Current End", __CurrentEnd,
+		        "Previous Start", __PreviousStart,
+		        "Previous End", __PreviousEnd
+		    )
+		VAR __HasCustomRange =
+		    // TRUE solo cuando el slicer de rango tiene un filtro real aplicado.
+		    ISFILTERED ( '_Aux Rango fechas'[Fecha] )
+		VAR __UseCustomRange =
+		    __Mode = "Rango fechas" && __HasCustomRange
+		VAR __CustomMode =
+		    // Si el usuario no eligio modo, comparamos contra el periodo inmediatamente previo.
+		    SELECTEDVALUE ( '_Aux Rango fechas modo'[Rango fechas modo], "Periodo previo" )
+		VAR __SelectedCustomDates =
+		    // ALLSELECTED conserva el rango visible seleccionado por el slicer desconectado.
+		    ALLSELECTED ( '_Aux Rango fechas'[Fecha] )
+		VAR __CustomStart =
+		    // Fecha inicial del rango personalizado.
+		    MINX ( __SelectedCustomDates, '_Aux Rango fechas'[Fecha] )
+		VAR __CustomEnd =
+		    // Fecha final del rango personalizado.
+		    MAXX ( __SelectedCustomDates, '_Aux Rango fechas'[Fecha] )
+		VAR __SpanDays =
+		    // Cantidad de dias del rango, inclusiva: inicio y fin cuentan.
+		    DATEDIFF ( __CustomStart, __CustomEnd, DAY ) + 1
+		VAR __CustomPreviousStart =
+		    // Interanual desplaza 12 meses; Periodo previo toma la misma duracion justo antes del inicio.
+		    SWITCH (
+		        TRUE (),
+		        NOT __UseCustomRange, BLANK (),
+		        __CustomMode = "Interanual", EDATE ( __CustomStart, -12 ),
+		        __CustomStart - __SpanDays
+		    )
+		VAR __CustomPreviousEnd =
+		    // El fin previo acompaña la misma regla que el inicio previo.
+		    SWITCH (
+		        TRUE (),
+		        NOT __UseCustomRange, BLANK (),
+		        __CustomMode = "Interanual", EDATE ( __CustomEnd, -12 ),
+		        __CustomStart - 1
+		    )
+		VAR __CustomContext =
+		    // Normalizamos el modo personalizado al mismo contrato que el modo predefinido.
+		    ROW (
+		        "Calendar Type", __CalendarType,
+		        "Current Start", __CustomStart,
+		        "Current End", __CustomEnd,
+		        "Previous Start", __CustomPreviousStart,
+		        "Previous End", __CustomPreviousEnd
+		    )
+		RETURN
+		    // Devolvemos una sola fila: preset cuando no aplica rango, custom cuando aplica rango.
+		    UNION (
+		        FILTER ( __PresetContext, NOT __UseCustomRange ),
+		        FILTER ( __CustomContext, __UseCustomRange )
+		    )
+	lineageTag: 411b9c02-2219-4344-9f91-224e5e3f6185
+
+/// Devuelve el formato de la métrica seleccionada usando el símbolo visible de Monedas[Símbolo] cuando la métrica es monetaria.
+function FormatoMetricaSeleccionada =
+		() =>
+		// Esta funcion devuelve un texto de formato para la metrica elegida en el slicer.
+		VAR __MetricFormat =
+		    // Leemos el formato base guardado en la tabla Metricas, por ejemplo #,0 o 0.0%.
+		    SELECTEDVALUE ( 'Métricas'[Formato] )
+		VAR __CurrencySymbol =
+		    // Leemos el simbolo de moneda seleccionado, por ejemplo $, EUR o USD.
+		    SELECTEDVALUE ( Monedas[Símbolo] )
+		VAR __Monetary =
+		    // Esta bandera indica si la metrica debe mostrarse como moneda.
+		    SELECTEDVALUE ( 'Métricas'[Monetaria] )
+		RETURN
+		    // SWITCH TRUE permite evaluar varias condiciones de arriba hacia abajo.
+		    SWITCH (
+		        TRUE (),
+		        // Sin formato, no inventamos uno: devolvemos BLANK.
+		        ISBLANK ( __MetricFormat ), BLANK (),
+		        // Si es monetaria y falta simbolo, usamos $ como fallback didactico.
+		        __Monetary = TRUE () && ISBLANK ( __CurrencySymbol ), "$ " & __MetricFormat,
+		        // Si es monetaria y hay simbolo, lo ponemos delante del formato.
+		        __Monetary = TRUE (), __CurrencySymbol & " " & __MetricFormat,
+		        // Si no es monetaria, devolvemos el formato original.
+		        __MetricFormat
+		    )
+	lineageTag: fa141865-229b-4309-9618-aadd1a4e038f
+
+/// Devuelve TRUE si alguna columna de la tabla Calendario está en el eje del visual (Fecha / Año / Trimestre / Mes / Año mes / Semana). Las medidas router (Actual, Previo) usan esto para decidir si respetar el eje del visual o aplicar el rango completo del período.
+function EjeCalendarioEnContexto =
+		() =>
+		// Esta funcion responde una pregunta simple: el visual tiene una columna de Calendario en el eje?
+		// Si devuelve TRUE, las medidas deben respetar cada punto del eje temporal.
+		// Si devuelve FALSE, las medidas pueden calcular el total del rango seleccionado.
+		ISINSCOPE ( 'Calendario'[Fecha] )
+		    // ISINSCOPE detecta si esta columna participa en el nivel visible del visual.
+		    || ISINSCOPE ( 'Calendario'[Año] )
+		    // Cada OR agrega otra granularidad temporal posible.
+		    || ISINSCOPE ( 'Calendario'[Trimestre] )
+		    || ISINSCOPE ( 'Calendario'[Mes] )
+		    || ISINSCOPE ( 'Calendario'[Año mes] )
+		    || ISINSCOPE ( 'Calendario'[Semana] )
+	lineageTag: 6f9014bc-cbde-419a-a944-6770c550d6e1
+
+/// Formatea una etiqueta textual con la misma metadata centralizada que el formato numérico de la métrica activa. Usa Aux Métrica como fuente principal de selección y Métricas como fallback.
+function FormatoValorEtiqueta =
+		( metricValue : NUMERIC ) =>
+		// Esta funcion recibe un numero y lo convierte en texto para etiquetas de visuals.
+		VAR __Value =
+		    // Guardamos el numero recibido para usarlo con un nombre mas claro.
+		    metricValue
+		VAR __MetricName =
+		    // Buscamos primero la metrica activa en Aux Metrica y luego en Metricas.
+		    COALESCE (
+		        SELECTEDVALUE ( '_GC Métrica'[Métrica] ),
+		        SELECTEDVALUE ( 'Métricas'[Métrica] ),
+		        // Si no hay seleccion, usamos Ventas como fallback del template.
+		        "Ventas"
+		    )
+		VAR __FormatString =
+		    // Pedimos a otra UDF el formato correcto para esa metrica.
+		    FormatoMetricaPorNombre ( __MetricName )
+		RETURN
+		    // Si el valor esta vacio mostramos guion; si no, FORMAT lo convierte a texto.
+		    IF ( ISBLANK ( __Value ), "-", FORMAT ( __Value, __FormatString ) )
+	lineageTag: 958d9e74-4b91-432d-b3b5-a1d5b0bf7792
+
+/// Devuelve el formato semántico seguro de una métrica según la metadata de Métricas: tipo, decimales y moneda seleccionada. No aplica escalas ni sufijos para evitar doble abreviación en cards, ejes y matrices; conserva fallback para helpers heredados fuera del catálogo seleccionable.
+function FormatoMetricaPorNombre =
+		( pMetrica : STRING ) =>
+		// Esta funcion arma un formato numerico leyendo la metadata de una metrica por nombre.
+		VAR __TipoFormatoCatalogo =
+		    // LOOKUPVALUE busca el tipo de formato de la metrica, por ejemplo Moneda o Porcentaje.
+		    LOOKUPVALUE ( 'Métricas'[Tipo de formato], 'Métricas'[Métrica], pMetrica )
+		VAR __TipoFormatoHelper =
+		    // Algunas medidas auxiliares siguen fuera del catalogo seleccionable de 56 metricas.
+		    SWITCH (
+		        pMetrica,
+		        "Costo de ventas", "Moneda",
+		        "Ventas nuevos clientes", "Moneda",
+		        "Ventas nuevos clientes %", "Porcentaje"
+		    )
+		VAR __TipoFormato =
+		    COALESCE ( __TipoFormatoCatalogo, __TipoFormatoHelper )
+		VAR __FormatoFallback =
+		    // Si el tipo no alcanza, usamos el formato textual guardado como respaldo.
+		    LOOKUPVALUE ( 'Métricas'[Formato], 'Métricas'[Métrica], pMetrica )
+		VAR __MonetariaCatalogo =
+		    LOOKUPVALUE ( 'Métricas'[Monetaria], 'Métricas'[Métrica], pMetrica )
+		VAR __MonetariaHelper =
+		    pMetrica IN { "Costo de ventas", "Ventas nuevos clientes" }
+		VAR __Monetaria =
+		    // COALESCE convierte un valor vacio en FALSE para evitar dudas en comparaciones.
+		    COALESCE ( __MonetariaCatalogo, __MonetariaHelper, FALSE () )
+		VAR __Decimales =
+		    // Leemos cuantos decimales debe mostrar la metrica; si falta, usamos 0.
+		    COALESCE ( LOOKUPVALUE ( 'Métricas'[Decimales], 'Métricas'[Métrica], pMetrica ), 0 )
+		VAR __Symbol =
+		    // Leemos el simbolo de moneda elegido por el usuario.
+		    SELECTEDVALUE ( Monedas[Símbolo] )
+		VAR __CurrencyPrefix =
+		    // Construimos el prefijo monetario solo cuando la metrica es monetaria.
+		    SWITCH (
+		        TRUE (),
+		        __Monetaria <> TRUE (), "",
+		        ISBLANK ( __Symbol ), "$ ",
+		        __Symbol & " "
+		    )
+		VAR __DecimalPattern =
+		    // REPT repite ceros para armar la parte decimal del formato.
+		    IF ( __Decimales > 0, "." & REPT ( "0", __Decimales ), "" )
+		VAR __NumberFormat =
+		    // #,0 muestra miles y al menos un digito entero.
+		    "#,0" & __DecimalPattern
+		VAR __PercentFormat =
+		    // El formato de porcentaje usa 0 como entero base y agrega el signo %.
+		    "0" & __DecimalPattern & "%"
+		VAR __MetricFormat =
+		    // Elegimos el patron final segun el tipo de formato de la metrica.
+		    SWITCH (
+		        TRUE (),
+		        __TipoFormato = "Porcentaje", __PercentFormat,
+		        __TipoFormato IN { "Moneda", "Número" }, __NumberFormat,
+		        __FormatoFallback
+		    )
+		RETURN
+		    // Si no hay formato devolvemos BLANK; si hay, agregamos prefijo de moneda cuando corresponde.
+		    IF ( ISBLANK ( __MetricFormat ), BLANK (), __CurrencyPrefix & __MetricFormat )
+	lineageTag: 9679fb4f-8575-49a9-ab3e-f867818d2e93
+
+/// Formatea etiquetas textuales compactas usando metadata de Métricas. No se usa como format string de medidas numéricas.
+function FormatoValorCompacto =
+		( metricValue : NUMERIC ) =>
+		// Esta funcion convierte un numero en una etiqueta compacta, por ejemplo $ 2 mill.
+		VAR __Value =
+		    // Guardamos el numero recibido para reutilizarlo de forma clara.
+		    metricValue
+		VAR __MetricName =
+		    // Detectamos cual es la metrica activa; si no hay seleccion, usamos Ventas.
+		    COALESCE (
+		        SELECTEDVALUE ( '_GC Métrica'[Métrica] ),
+		        SELECTEDVALUE ( 'Métricas'[Métrica] ),
+		        "Ventas"
+		    )
+		VAR __TipoFormato =
+		    // Leemos si la metrica se comporta como moneda, numero o porcentaje.
+		    LOOKUPVALUE ( 'Métricas'[Tipo de formato], 'Métricas'[Métrica], __MetricName )
+		VAR __Monetaria =
+		    // Leemos si necesita simbolo de moneda; si falta metadata, asumimos que no.
+		    COALESCE ( LOOKUPVALUE ( 'Métricas'[Monetaria], 'Métricas'[Métrica], __MetricName ), FALSE () )
+		VAR __DecimalesGlobal =
+		    // Decimales generales de la metrica.
+		    COALESCE ( LOOKUPVALUE ( 'Métricas'[Decimales], 'Métricas'[Métrica], __MetricName ), 0 )
+		VAR __DecimalesEtiqueta =
+		    // Decimales especificos para etiquetas; si faltan, usamos los generales.
+		    COALESCE ( LOOKUPVALUE ( 'Métricas'[Decimales etiqueta], 'Métricas'[Métrica], __MetricName ), __DecimalesGlobal )
+		VAR __EscalaEtiqueta =
+		    // Escala decide si dividimos por miles, millones o dejamos el numero igual.
+		    COALESCE ( LOOKUPVALUE ( 'Métricas'[Escala etiqueta], 'Métricas'[Métrica], __MetricName ), "Ninguna" )
+		VAR __SufijoEtiqueta =
+		    // Sufijo visible, por ejemplo mill. o k.
+		    COALESCE ( LOOKUPVALUE ( 'Métricas'[Sufijo etiqueta], 'Métricas'[Métrica], __MetricName ), "" )
+		VAR __Symbol =
+		    // Simbolo de moneda elegido por el usuario.
+		    SELECTEDVALUE ( Monedas[Símbolo] )
+		VAR __CurrencyPrefix =
+		    // Si la metrica es monetaria agregamos simbolo; si no, no agregamos nada.
+		    SWITCH (
+		        TRUE (),
+		        __Monetaria <> TRUE (), "",
+		        ISBLANK ( __Symbol ), "$ ",
+		        __Symbol & " "
+		    )
+		VAR __Divisor =
+		    // El divisor transforma el numero real en una version compacta.
+		    SWITCH (
+		        __EscalaEtiqueta,
+		        "Millones", 1000000,
+		        "Miles", 1000,
+		        1
+		    )
+		VAR __ScaledValue =
+		    // DIVIDE evita errores si algun divisor inesperado fuera cero.
+		    DIVIDE ( __Value, __Divisor )
+		VAR __DecimalPattern =
+		    // Armamos la cantidad de decimales que vera el usuario en la etiqueta.
+		    IF ( __DecimalesEtiqueta > 0, "." & REPT ( "0", __DecimalesEtiqueta ), "" )
+		VAR __NumberFormat =
+		    // Formato base para numeros compactos.
+		    "#,0" & __DecimalPattern
+		VAR __PercentFormat =
+		    // Formato especial para porcentajes, que no se escalan por miles o millones.
+		    "0" & __DecimalPattern & "%"
+		VAR __Suffix =
+		    // Si hay sufijo, agregamos un espacio antes para que el texto quede legible.
+		    IF ( __SufijoEtiqueta = "", "", " " & __SufijoEtiqueta )
+		RETURN
+		    // SWITCH TRUE elige que texto final devolver segun el caso.
+		    SWITCH (
+		        TRUE (),
+		        ISBLANK ( __Value ), "-",
+		        __TipoFormato = "Porcentaje", FORMAT ( __Value, __PercentFormat ),
+		        __CurrencyPrefix & FORMAT ( __ScaledValue, __NumberFormat ) & __Suffix
+		    )
+	lineageTag: d0dfaf8a-90ab-4896-8bbe-d1a1393454c6
+