Informes Avanzados

Esta sección amplía lo que ya sabes sobre la arquitectura básica de los informes en BC. Cubre los cuatro diseñadores disponibles y cuándo elegir cada uno, cómo estructurar informes de resumen, las propiedades específicas del layout Word, el flujo para modificar un informe existente y los informes de solo procesamiento que ejecutan lógica AL sin generar ningún documento visual.

1. Los Cuatro Diseñadores de Informes de BC

Business Central soporta cuatro tipos de layout para sus informes. Cada uno responde a una necesidad distinta y se gestiona con una herramienta diferente. Un mismo informe puede tener varios layouts simultáneos y el usuario elige cuál usar en el momento de ejecutarlo.

RDLC — El más potente para maquetación

RDLC (Report Definition Language Client-side) es el formato nativo de BC para informes con maquetación precisa. Permite controlar píxel a píxel la posición de cada elemento, incrustar gráficos, usar expresiones condicionales de formato y crear subreports anidados. Su contrapartida es que requiere SQL Server Report Builder o Visual Studio para editarlo, lo cual es menos accesible para usuarios no técnicos.

Word — El más accesible para documentos

El layout Word usa marcadores (bookmarks) dentro de un documento .docx para indicar dónde BC debe insertar cada campo de datos. Es ideal para facturas, albaranes y cualquier documento con texto libre y formato corporativo, ya que cualquier usuario con Word puede editarlo sin conocimientos técnicos.

Excel — Para análisis de datos

El layout Excel genera un fichero .xlsx donde BC vuelca los datos del informe en formato tabular. El diseñador puede preconfigurar hojas, tablas dinámicas y gráficos en el template, y BC los rellena con los datos reales al ejecutar el informe.

2. Tipos de Informes de Resumen

Un informe de resumen (summary report) es aquel que agrupa y totali­za los datos en lugar de listarlos registro a registro. En lugar de mostrar cada préstamo individual, muestra el total de préstamos por socio, por mes o por categoría de libro. Son los más usados en reporting de negocio.

Informe de detalle vs. informe de resumen

Técnica 1: Acumuladores en triggers del DataItem

La forma más directa de crear un resumen en AL es usar variables acumuladoras en los triggers OnAfterGetRecord y OnPostDataItem:

report 50600 "Resumen Prestamos por Socio"
{
    UsageCategory = ReportsAndAnalysis;
    ApplicationArea = All;
    DefaultRenderingLayout = LayoutWord;

    dataset
    {
        dataitem(Socio; Socio)
        {
            // Columnas del nivel padre (socio)
            column(NoSocio;    Socio."No.")    { }
            column(NombreSocio; Socio.Nombre) { }
            column(TotalPrestamos; TotalPrest) { } // acumulador

            dataitem(Prestamo; Prestamo)
            {
                DataItemLink = "No. Socio" = field("No.");

                trigger OnAfterGetRecord()
                begin
                    TotalPrest += 1; // contamos cada préstamo
                end;
            }

            trigger OnPreDataItem()
            begin
                TotalPrest := 0; // reiniciamos el contador por cada socio
            end;
        }
    }

    var
        TotalPrest: Integer;

    rendering
    {
        layout(LayoutWord)
        {
            Type    = Word;
            Caption = 'Layout Word';
            LayoutFile = 'ResumenPrestamos.docx';
        }
    }
}

Técnica 2: Usar una Query como DataItem

La alternativa más limpia para informes de resumen es basar el informe en una Query con agrupación. La Query realiza el GROUP BY directamente en SQL, lo que es mucho más eficiente que acumular en AL:

// Query que agrupa préstamos por socio
query 50601 "Prestamos por Socio"
{
    QueryType = Normal;

    elements
    {
        dataitem(Prestamo; Prestamo)
        {
            column(NoSocio; "No. Socio") { }
            column(TotalPrestamos; "No.")
            {
                Method = Count; // GROUP BY implícito
            }
        }
    }
}

// Report usando la Query como fuente de datos
report 50602 "Resumen Desde Query"
{
    UsageCategory = ReportsAndAnalysis;
    ApplicationArea = All;

    dataset
    {
        dataitem(ResumenQ; "Prestamos por Socio")
        {
            column(NoSocio;        ResumenQ.NoSocio)        { }
            column(TotalPrestamos; ResumenQ.TotalPrestamos) { }
        }
    }
}

3. Microsoft Word — Propiedades del Informe

Un informe con layout Word usa un fichero .docx como plantilla. BC inyecta los datos en esa plantilla mediante marcadores (bookmarks) de Word que corresponden exactamente con los nombres de las columnas definidas en el dataset del informe.

Propiedades clave en AL para Word layout

Cómo funciona el sistema de marcadores

En el documento Word, cada dato del informe se representa con un marcador cuyo nombre coincide exactamente (respetando mayúsculas) con el nombre de la columna en el dataset. BC busca esos marcadores al renderizar y sustituye su contenido por el valor real del campo.

// En AL: definición del informe con Word layout
report 50610 "Ficha Socio Word"
{
    UsageCategory          = ReportsAndAnalysis;
    ApplicationArea        = All;
    DefaultRenderingLayout = LayoutWord;
    WordMergeDataItem      = Socio; // DataItem raíz para Word

    dataset
    {
        dataitem(Socio; Socio)
        {
            // Los nombres de columna deben coincidir con los bookmarks en el .docx
            column(NoSocio;     Socio."No.")         { }
            column(NombreSocio; Socio.Nombre)       { }
            column(EmailSocio;  Socio.Email)         { }
            column(FechaHoy;    Today)               { }
        }
    }

    rendering
    {
        layout(LayoutWord)
        {
            Type       = Word;
            Caption    = 'Ficha de Socio';
            LayoutFile = 'FichaSocio.docx'; // fichero en la carpeta del proyecto
        }
    }
}

// En el fichero FichaSocio.docx deberás tener marcadores con estos nombres:
// «NoSocio»    → se reemplaza por el valor del campo "No."
// «NombreSocio» → se reemplaza por Nombre
// «EmailSocio»  → se reemplaza por Email
// «FechaHoy»    → se reemplaza por la fecha actual

Cómo crear los marcadores en Word

• En Word: Insertar → Marcador. Escribe el nombre exacto del campo (sin espacios ni caracteres especiales) y haz clic en Agregar.
• Para tablas repetidas (una fila por registro del DataItem), BC usa una tabla de Word donde la primera fila de datos contiene los marcadores. Al renderizar, BC duplica esa fila por cada registro.
• Los marcadores de tabla siguen el patrón NombreDataItem_NombreColumna.

4. Modificar un Informe con el Diseñador o Word

Una vez que un informe está publicado en BC, puedes modificar su layout directamente desde la interfaz sin tocar el código AL. BC permite exportar el layout actual, editarlo con la herramienta correspondiente y volver a importarlo.

Flujo para modificar un layout Word

Flujo para modificar un layout RDLC

Crear un layout personalizado desde VS Code

Si el informe no tiene layout o quieres añadir uno nuevo desde cero directamente en el proyecto de extensión, el flujo en VS Code es:

// 1. En el fichero .al del informe, genera el dataset primero y despliega la extensión
// 2. En BC, abre el informe y usa "Gestión de layouts"
// 3. Acción "Crear layout" → elige Word o RDLC
// 4. BC genera una plantilla base con todos los campos del dataset
// 5. Exporta esa plantilla, edítala y vuelve a importarla

// Alternativa desde VS Code: usar el comando AL:
// Ctrl+Shift+P → "AL: Generate Report Layout"
// Esto genera automáticamente el fichero .docx o .rdlc con los campos del dataset
// y lo añade al proyecto como fichero linked en el bloque rendering

rendering
{
    layout(LayoutWord)
    {
        Type       = Word;
        Caption    = 'Layout Principal';
        LayoutFile = 'MiInforme.docx'; // generado con AL: Generate Report Layout
    }
}

5. Informes de Solo Procesamiento

Un informe de solo procesamiento (processing-only report) es un informe que no genera ningún documento visible. Su función es ejecutar lógica AL de forma masiva sobre un conjunto de registros: actualizar datos, hacer cálculos, enviar emails, llamar a servicios externos… usando la misma infraestructura de RequestPage y DataItem que un informe normal, pero sin producir ninguna salida visual.

¿Por qué usar un informe en lugar de un codeunit?

• El informe hereda automáticamente la RequestPage para que el usuario introduzca filtros antes de ejecutarlo.
• El DataItem recorre los registros de forma optimizada, aplicando los filtros del usuario automáticamente.
• Aparece en el menú de BC como cualquier otro informe y puede programarse con el programador de trabajos.

Cómo declararlo en AL

Basta con añadir la propiedad ProcessingOnly = true en el informe. Con esto BC sabe que no debe buscar ni renderizar ningún layout.

report 50620 "Actualizar Estado Prestamos"
{
    UsageCategory  = Tasks;
    ApplicationArea = All;
    ProcessingOnly = true; // sin layout, sin salida visual
    Caption        = 'Actualizar Estado de Préstamos Vencidos';

    dataset
    {
        dataitem(Prestamo; Prestamo)
        {
            // El DataItem recorre los préstamos activos
            DataItemTableView = where(Estado = const(Activo));

            trigger OnAfterGetRecord()
            begin
                // Si la fecha límite ha pasado, marcamos como vencido
                if Prestamo."Fecha Devolucion" < Today then begin
                    Prestamo.Estado := Prestamo.Estado::Vencido;
                    Prestamo.Modify(true);
                    ContadorActualizados += 1;
                end;
            end;

            trigger OnPostDataItem()
            begin
                Message('Proceso completado. Préstamos actualizados: %1', ContadorActualizados);
            end;
        }
    }

    // RequestPage: el usuario puede filtrar por fechas antes de ejecutar
    requestpage
    {
        layout
        {
            area(Content)
            {
                group(Opciones)
                {
                    Caption = 'Opciones';
                    field(FechaCorte; FechaCorte)
                    {
                        Caption         = 'Fecha de Corte';
                        ApplicationArea = All;
                        ToolTip         = 'Préstamos anteriores a esta fecha se marcarán como vencidos.';
                    }
                }
            }
        }
    }

    var
        ContadorActualizados: Integer;
        FechaCorte:           Date;

    trigger OnPreReport()
    begin
        // Si no se especificó fecha de corte, usamos hoy
        if FechaCorte = 0D then
            FechaCorte := Today;

        ContadorActualizados := 0;
    end;
}

Cuándo usar ProcessingOnly vs. Codeunit