Tipos de Datos Avanzados

Esta sección cubre cuatro conceptos que amplían lo que ya sabes sobre campos y tipos de datos en Business Central: cómo suscribirse a eventos de campo sin tocar la tabla original, qué tipos de datos son compatibles con los servicios web, cómo usar referencias genéricas con RecordRef y FieldRef, y cómo cargar datos masivamente mediante Paquetes de Configuración.

1. Eventos de Campo

Los triggers de campo (OnValidate, OnLookup…) son código que escribes dentro de la propia tabla. Pero ¿qué pasa cuando quieres reaccionar a la modificación de un campo de una tabla estándar de BC sin tocarla? Para eso existen los eventos de campo, que funcionan con el modelo publisher/subscriber de AL.

¿Cómo funciona el modelo publisher/subscriber?

BC publica eventos en momentos clave del ciclo de vida de un campo. Tu extensión se suscribe a esos eventos con un EventSubscriber. Cuando el evento se dispara, BC ejecuta tu código automáticamente, sin que hayas modificado ningún objeto base.

Ejemplo práctico

Queremos que, cada vez que alguien cambie el campo "Sell-to Customer No." en una cabecera de venta, nuestra extensión registre un mensaje en un log propio. Sin tocar la tabla Sales Header:

codeunit 50100 "Suscriptor Ventas"
{
    // Este codeunit no hace nada por sí solo.
    // Solo reacciona cuando BC dispara el evento.

    [EventSubscriber(ObjectType::Table,
                     Database::"Sales Header",
                     'OnAfterValidateEvent',
                     'Sell-to Customer No.',
                     false, false)]
    local procedure AlCambiarCliente(var Rec: Record "Sales Header")
    var
        MiLog: Record "Mi Tabla Log";
    begin
        MiLog.Init();
        MiLog."Fecha"      := Today;
        MiLog."Descripcion" := 'Cliente cambiado a: ' + Rec."Sell-to Customer No.";
        MiLog.Insert(true);
    end;
}

2. Servicios Web — Compatibilidad de Tipos de Datos

Cuando expones una página o query de BC como servicio web (OData o SOAP), no todos los tipos de datos AL se traducen de la misma forma al mundo externo. Es importante saber qué tipos son compatibles, cuáles se transforman y cuáles no se pueden exponer directamente.

¿Qué es un servicio web en BC?

BC permite publicar objetos (páginas, queries, codeunits) como endpoints accesibles desde el exterior. Hay dos protocolos principales:

• OData v4: el más moderno. Se usa para leer y escribir datos desde Power BI, Excel, aplicaciones externas o integraciones REST.
• SOAP: el clásico. Usado para integraciones legacy o sistemas más antiguos.

Cómo publicar un servicio web desde BC

En Business Central, ve a Servicios Web (búscalo en el menú de búsqueda). Crea una nueva línea indicando el tipo de objeto (Page o Query), el número de objeto y el nombre del servicio. Marca la casilla Publicado y BC generará automáticamente la URL OData.

// Ejemplo: URL OData generada por BC para una página publicada
// Formato base:
https://[servidor]/[instancia]/ODataV4/Company('[empresa]')/[NombreServicio]

// Ejemplo real con BC en la nube (SaaS):
https://api.businesscentral.dynamics.com/v2.0/[tenantId]/production/ODataV4/Company('CRONUS')/Clientes

3. Referencias y Otros Tipos de Datos

AL dispone de tipos de datos especiales que permiten escribir código genérico capaz de trabajar con cualquier tabla o campo sin conocerlos en tiempo de compilación. Son los tipos de referencia: RecordRef, FieldRef, KeyRef y Variant.

RecordRef — Referencia genérica a cualquier tabla

Un RecordRef es una variable que puede apuntar a un registro de cualquier tabla en tiempo de ejecución. Se usa cuando quieres crear funciones reutilizables que operen sobre tablas distintas sin duplicar código.

// Procedimiento genérico que cuenta registros de cualquier tabla
procedure ContarRegistros(NumTabla: Integer): Integer
var
    RefRec: RecordRef;
begin
    RefRec.Open(NumTabla);        // Abre la tabla por su número
    exit(RefRec.Count);           // Devuelve el número de registros
    RefRec.Close();
end;

// Llamadas desde otro código:
// ContarRegistros(18)  → cuenta clientes (tabla Customer = 18)
// ContarRegistros(27)  → cuenta artículos (tabla Item = 27)

FieldRef — Referencia genérica a cualquier campo

Un FieldRef se obtiene a partir de un RecordRef y permite leer o escribir el valor de un campo de forma genérica, sin conocer su nombre en tiempo de compilación.

// Leer el valor del campo número 2 de cualquier registro
procedure LeerCampo(RefRec: RecordRef; NumeroCampo: Integer): Text
var
    RefCampo: FieldRef;
begin
    RefCampo := RefRec.Field(NumeroCampo);   // Obtiene el campo por número
    exit(Format(RefCampo.Value));             // Devuelve su valor como texto
end;

Variant — El tipo comodín

Una variable Variant puede contener un valor de cualquier tipo en tiempo de ejecución: un entero, un texto, una fecha, un record… Se usa principalmente en parámetros de procedimientos muy genéricos. Su contrapartida es que el compilador no puede verificar el tipo en tiempo de compilación, lo que lo hace más propenso a errores.

procedure MostrarValor(Valor: Variant)
begin
    // Variant acepta cualquier tipo como argumento
    Message('El valor es: %1', Valor);
end;

// Puede llamarse con cualquier tipo:
MostrarValor(42);
MostrarValor('Hola');
MostrarValor(Today);

4. Carga de Datos con Paquetes de Configuración

Los Paquetes de Configuración (Configuration Packages) son la herramienta nativa de Business Central para importar datos masivamente desde ficheros Excel o CSV hacia las tablas de BC. No requieren código AL y son especialmente útiles en migraciones de datos iniciales o en la carga de catálogos.

¿Cuándo usarlos?

• Migración inicial de datos desde un sistema anterior (clientes, artículos, proveedores…).
• Carga de tablas de configuración propias que has creado en tu extensión.
• Actualización masiva de un campo en miles de registros sin código.

Flujo de trabajo

El proceso siempre sigue los mismos pasos: defines el paquete indicando qué tabla y qué campos quieres cargar, exportas la plantilla a Excel, rellenas los datos y la vuelves a importar para que BC valide e inserte los registros.

Puntos clave a tener en cuenta

• Orden de las tablas: si la tabla A tiene una TableRelation a la tabla B, debes cargar primero la tabla B. Por ejemplo, primero cargas artículos y luego las líneas de pedido que los referencian.
• Validación de campos: por defecto BC aplica las validaciones de campo (OnValidate). Puedes desactivar esto por tabla en el paquete si los datos ya vienen limpios y quieres acelerar la carga.
• Errores: si un registro falla, BC lo marca en rojo en la vista del paquete y te indica el motivo. El resto de registros válidos se siguen aplicando.
• Reutilización: un paquete puede exportarse como fichero .rapidstart y compartirse entre entornos (útil para configurar una demo o un nuevo cliente).