Ampliación de informes con el código de barras de QR Pay

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

Procedimiento

Hay dos enfoques para lograr esto:

1. Informes personalizados:
   En los informes personalizados, puede integrar el código necesario directamente en el informe.

2. Informes estándar:
   Para los informes estándar, puede crear una extensión de informe que implemente el código adecuado.

Tenga en cuenta que existen diferencias entre los informes de Word y los informes RDLC que deben considerarse durante la implementación.

Requisitos

Antes de comenzar, asegúrese 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 correspondiente del módulo.

Más información sobre cómo crear un informe de diseño Word en Microsoft Business Central.

Más información sobre cómo crear un informe de diseño RDLC en Microsoft Business Central.

Configuración en QR Pay

Para asegurar el funcionamiento correcto, se deben realizar las siguientes configuraciones para el informe creado/ampliado en QR Pay:

• Se debe configurar el ID del informe y el ID de la tabla para el registro de configuración de QR Pay.
• En la Configuración del módulo QR Pay deben configurarse todos los campos necesarios.

Modificar el valor de Amount en la generación de código QR

1. En esta sección, cambiaremos el valor de Amount del código QR con un EventSubscriber.
2. Crea un nuevo archivo .al en Visual Studio Code o abre un archivo .al existente.

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

   [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
       // Calcula aquí la lógica personalizada del Amount
       ParamAmountDecimal := NewValue;
       ParamIshandledBoolean := true;
   end;
   

   4. Usa el RecordRef para calcular el nuevo Amount. 5. Establece ParamIshandledBoolean en true si este valor debe usarse.

Ampliación de informes RDLC

1. En esta sección, añadiremos un código QR de QR Pay a un informe de su elección.
2. Cree un nuevo archivo .al en Visual Studio Code o abra un archivo .al existente que amplíe el informe deseado.

3. Añada el siguiente código al archivo abierto:

   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. Reemplace "XXX" con el ID del informe que desea ampliar (los informes 1306 "Standard Sales - Invoice" y 117 "Reminder" ya están ampliados en el estándar de QR Pay).

5. Publique la extensión.
6. Abra Diseños de informes en Business Central.
7. Busque el diseño que desea ampliar y haga clic en "Actualizar y descargar diseño".
8. Abra el archivo de diseño descargado.
9. Añada una imagen seleccionando "Insertar" -> "Imagen".
10. Coloque la imagen donde desea que aparezca el código de barras.
11. Haga clic derecho en la imagen y seleccione "Propiedades de la imagen".
12. Realice los siguientes ajustes en el cuadro de diálogo "Propiedades de la imagen":
    • General:
      • Nombre: Barcode
      • Fuente de la imagen: Base de datos
      • Campo a utilizar: =System.Convert.FromBase64String(Fields!SIM_QRPGlobal_BarcodeRDLCText.Value)
      • Tipo MIME: image/bmp
    • Tamaño:
      • Mostrar: Cambiar el tamaño proporcionalmente
    • Visibilidad:
      • Expresión: =IsNothing(Fields!SIM_QRPGlobal_BarcodeRDLCText.Value) OR (Globals!PageNumber>1)
13. Guarde el archivo .rdl editado.
14. Vuelva a Diseños de informes en Business Central y agregue el diseño editado:
    • Seleccione "Nuevo" para agregar un nuevo diseño y cargue el archivo editado.
    • Alternativamente, puede reemplazar el diseño existente con el archivo editado.
15. Vincule el informe con el nuevo diseño creado.
16. Al imprimir el informe, el código de barras debería mostrarse correctamente.

Ampliación de informes Word

1. En esta sección, añadiremos un código QR de QR Pay a un informe de su elección.
2. Cree un nuevo archivo .al en Visual Studio Code o abra un archivo .al existente que amplíe el informe deseado.

3. Añada el siguiente código al archivo abierto:

   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. Reemplace "XXX" con el ID del informe que desea ampliar (los informes 1306 "Standard Sales - Invoice" y 117 "Reminder" ya están ampliados en el estándar de QR Pay).

5. Publique la extensión.
6. Abra el archivo Word del informe.
7. Navegue a la pestaña "Desarrollador" en el documento Word y seleccione "Panel de asignación XML".
   1. Haga clic derecho en "Global_Barcode".
   2. Seleccione "Insertar control de contenido" y luego "Imagen".
8. Coloque la imagen donde desea que aparezca el código de barras en el documento.
9. Guarde el archivo Word.
10. Vuelva a Business Central y cargue el archivo Word como diseño.
11. Vincule el diseño editado al informe correspondiente.
12. Al imprimir este informe, ahora se generará el código de barras.