Saltar al contenido

Ampliando Informes con el QR Pay

Esta documentación explica cómo ampliar un informe en Business Central con un QR Pay QR-CODE. El QR-Code se genera automáticamente y se agrega durante la impresión del informe o al reservar o convertir un documento.

Procedimiento

Hay dos enfoques para lograr esto:

  1. Informes Personalizados:
    En informes personalizados, puedes integrar directamente el código requerido en el informe.

  2. Informes Estándar:
    Para informes estándar, puedes crear una extensión de informe que implemente el código apropiado.

Ten en cuenta que hay diferencias entre Informes de Word e Informes RDLC que deben considerarse durante la implementación.

Requisitos

Antes de comenzar, asegúrate de que se cumplan los siguientes requisitos previos:

  • CORE debe ser referenciado en la extensión.
  • QR Pay debe ser referenciado en la extensión.
  • QR Pay debe estar activado en la configuración del módulo correspondiente.

Aprende más sobre cómo crear un informe de diseño de Word en Microsoft Business Central.

Aprende más sobre cómo crear un informe de diseño RDLC en Microsoft Business Central.

Configuración en QR Pay

Para asegurar la funcionalidad correcta, se deben realizar las siguientes configuraciones para el informe creado/ampliado en QR Pay:

  • El ID del Informe y el ID de la Tabla para el Registro de Configuración de QR Pay deben estar configurados.
  • En la Configuración del Módulo QR Pay se deben configurar todos los campos necesarios.

Modificar el valor de la Cantidad en la generación del QR-Code

  1. En esta sección, cambiaremos la Cantidad del QR-Code con un EventSubscriber.
  2. Crea un nuevo .al-file en Visual Studio Code o abre un .al-file existente.

  3. Agrega el siguiente código al archivo abierto:

    AL
    1
2
3
4
5
6
7
8
9
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"SIM_QRP Generation Mgt", 'OnBeforeCalculateAmountEPC', '', false, false)]
procedure SubOnBeforeCalculateAmountEPC(ParamRecordRef: RecordRef; var ParamAmountDecimal: Decimal; var ParamIshandledBoolean: Boolean)
var
    NewValue: Decimal;
begin
    // Lógica de cantidad personalizada aquí
    ParamAmountDecimal := NewValue;
    ParamIshandledBoolean := true;
end;
    4. Usa el RecordRef para calcular la nueva Cantidad. 5. Establece ParamIshandledBoolean en true si este valor debe ser utilizado.

Bloquear la Generación del QR-Code

  1. En esta sección, bloquearemos la generación del QR-Code con un EventSubscriber.
  2. Crea un nuevo .al-file en Visual Studio Code o abre un .al-file existente.

  3. Agrega el siguiente código al archivo abierto:

    AL
    1
2
3
4
5
6
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"SIM_QRP Generation Mgt", 'OnBeforeGenerateQRCode', '', false, false)]
procedure SubOnBeforeGenerateQRCode(ParamRecordRef: RecordRef; var ParamIshandledBoolean: Boolean)
begin
    if ParamRecordRef.TableNo = 18 then
        ParamIshandledBoolean := true;
end;
    4. Usa el RecordRef para personalizar la lógica de negocio si el QR Code debe ser creado. 5. Establece ParamIshandledBoolean en true si el QR Code no debe ser creado.

Ampliando Informes RDLC

  1. En esta sección, agregaremos un QR Pay QR-Code a un informe de tu elección.
  2. Crea un nuevo .al-file en Visual Studio Code o abre un .al-file existente que amplíe el informe deseado.

  3. Agrega el siguiente código al archivo abierto:

    AL
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
    reportextension 5227509 "SIM_QRP Test" extends XXX
{
    dataset
    {
        add(Header)
        {
            column(SIM_QRPGlobal_Barcode2; GlobalWordRecordSIMCORETempTable."SIM_QRP QR Code")
            { }
            column(SIM_QRPGlobal_BarcodeRDLCText; GlobalBarcodeRDLCText)
            { }
        }
        modify(Header)
        {
            trigger OnAfterAfterGetRecord()
            begin
                GlobalBarcodeRDLCText := GlobalCodeunitSIMQRPGenerationMgt.FillTempBlobForReport(Header.RecordId, CopyStr(CurrReport.OBJECTID(false), 7), GlobalWordRecordSIMCORETempTable);
            end;
        }
    }
    var
        GlobalWordRecordSIMCORETempTable: Record "SIM_CORE Temp Table";
        GlobalCodeunitSIMQRPGenerationMgt: Codeunit "SIM_QRP Generation Mgt";
        GlobalBarcodeRDLCText: Text;
}

  4. Reemplaza "XXX" con el ID del informe que deseas ampliar (el Informe 1306 "Ventas Estándar - Factura y 117 Recordatorio ya están ampliados en el estándar de QR Pay).

  5. Publica la extensión.
  6. Abre Diseños de Informes en Business Central.
  7. Encuentra el diseño que deseas ampliar y haz clic en "Actualizar y Descargar Diseño".
  8. Abre el archivo de diseño descargado.
  9. Agrega una imagen seleccionando "Insertar" -> "Imagen".
  10. Posiciona la imagen agregada donde deseas que aparezca el código de barras.
  11. Haz clic derecho en la imagen y selecciona "Propiedades de la Imagen".
  12. Realiza los siguientes ajustes en el diálogo de "Propiedades de la Imagen":
    • General:
      • Nombre: Código de barras
      • Fuente de Imagen: Base de datos
      • Campo a Usar: =System.Convert.FromBase64String(Fields!SIM_QRPGlobal_BarcodeRDLCText.Value)
      • Tipo MIME: image/bmp
    • Tamaño:
      • Mostrar: Redimensionar proporcionalmente
    • Visibilidad:
      • Expresión: =IsNothing(Fields!SIM_QRPGlobal_BarcodeRDLCText.Value) OR (Globals!PageNumber>1)
  13. Guarda el archivo .rdl editado.
  14. Regresa a Diseños de Informes en Business Central y agrega el diseño editado:
    • Selecciona "Nuevo" para agregar un nuevo diseño y carga el archivo editado.
    • Alternativamente, puedes reemplazar el diseño existente con el archivo editado.
  15. Vincula el informe al diseño recién creado.
  16. Cuando imprimas el informe, el código de barras debería mostrarse correctamente.

Ampliando Informes de Word

  1. En esta sección, agregaremos un QR Pay QR-Code a un informe de tu elección.
  2. Crea un nuevo .al-file en Visual Studio Code o abre un .al-file existente que amplíe el informe deseado.

  3. Agrega el siguiente código al archivo abierto:

    AL
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
    reportextension 5227509 "SIM_QRP Test" extends XXX
{
    dataset
    {
        add(Header)
        {
            column(SIM_QRPGlobal_Barcode2; GlobalWordRecordSIMCORETempTable."SIM_QRP QR Code")
            { }
            column(SIM_QRPGlobal_BarcodeRDLCText; GlobalBarcodeRDLCText)
            { }
        }
        modify(Header)
        {
            trigger OnAfterAfterGetRecord()
            begin
                GlobalBarcodeRDLCText := GlobalCodeunitSIMQRPGenerationMgt.FillTempBlobForReport(Header.RecordId, CopyStr(CurrReport.OBJECTID(false), 7), GlobalWordRecordSIMCORETempTable);
            end;
        }
    }
    var
        GlobalWordRecordSIMCORETempTable: Record "SIM_CORE Temp Table";
        GlobalCodeunitSIMQRPGenerationMgt: Codeunit "SIM_QRP Generation Mgt";
        GlobalBarcodeRDLCText: Text;
}

  4. Reemplaza "XXX" con el ID del informe que deseas ampliar (el Informe 1306 "Ventas Estándar - Factura y 117 Recordatorio ya están ampliados en el estándar de QR Pay).

  5. Publica la extensión.
  6. Abre el archivo de Word del informe.
  7. Navega a la pestaña "Desarrollador" en el documento de Word y selecciona "Panel de Mapeo XML".
    1. Haz clic derecho en "Global_Barcode".
    2. Selecciona "Insertar Control de Contenido" y luego "Imagen".
  8. Posiciona la imagen donde deseas que aparezca el código de barras en el documento.
  9. Guarda el archivo de Word.
  10. Regresa a Business Central y carga el archivo de Word como un diseño.
  11. Vincula el diseño editado al informe correspondiente.
  12. Al imprimir este informe, el código de barras ahora se generará.

Ver también