Extension des rapports avec le code-barres QR Pay

Cette documentation explique comment étendre un rapport dans Business Central avec un QR Pay QR-CODE. Le code QR est généré automatiquement et ajouté lors de l'impression du rapport ou lors de la validation ou conversion d'un document.

Procédure

Il existe deux approches pour y parvenir :

Rapports personnalisés :
Dans les rapports personnalisés, vous pouvez intégrer directement le code nécessaire dans le rapport.
Rapports standards :
Pour les rapports standards, vous pouvez créer une extension de rapport qui implémente le code approprié.

Veuillez noter qu'il existe des différences entre les rapports Word et les rapports RDLC à prendre en compte lors de l’implémentation.

Prérequis

Avant de commencer, assurez-vous que les prérequis suivants sont remplis :

CORE doit être référencé dans l’extension.
QR Pay doit être référencé dans l’extension.
QR Pay doit être activé dans la configuration du module concerné.

En savoir plus sur la création d'un rapport Word Layout dans Microsoft Business Central.

En savoir plus sur la création d'un rapport RDLC Layout dans Microsoft Business Central.

Configuration dans QR Pay

Pour assurer un bon fonctionnement, les configurations suivantes doivent être réalisées pour le rapport créé/étendu dans QR Pay :

L’ID du rapport et l’ID de la table pour l’enregistrement de configuration QR Pay doivent être définis.
Dans la configuration du module QR Pay, tous les champs nécessaires doivent être configurés.

Modifier la valeur Amount dans la génération de code QR

Dans cette section, nous allons modifier la valeur Amount du code QR avec un EventSubscriber.
Créez un nouveau fichier .al dans Visual Studio Code ou ouvrez un fichier .al existant.

Ajoutez le code suivant dans le fichier ouvert :

AL
[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
    // Calculez ici la logique personnalisée du Amount
    ParamAmountDecimal := NewValue;
    ParamIshandledBoolean := true;
end;

4. Utilisez le RecordRef pour calculer le nouveau Amount. 5. Définissez ParamIshandledBoolean sur true si cette valeur doit être utilisée.

Extension des rapports RDLC

Dans cette section, nous allons ajouter un code QR de QR Pay à un rapport de votre choix.
Créez un nouveau fichier .al dans Visual Studio Code ou ouvrez un fichier .al existant qui étend le rapport souhaité.

Ajoutez le code suivant au fichier ouvert :

AL
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;
}

Remplacez "XXX" par l’ID du rapport que vous souhaitez étendre (les rapports 1306 "Standard Sales - Invoice" et 117 "Reminder" sont déjà étendus dans le standard de QR Pay).
Publiez l’extension.
Ouvrez Mises en page de rapport dans Business Central.
Trouvez la mise en page que vous souhaitez étendre et cliquez sur "Mettre à jour et télécharger la mise en page".
Ouvrez le fichier de mise en page téléchargé.
Ajoutez une image en sélectionnant "Insérer" -> "Image".
Positionnez l’image là où vous souhaitez que le code-barres apparaisse.
Faites un clic droit sur l’image et sélectionnez "Propriétés de l'image".
Effectuez les ajustements suivants dans la boîte de dialogue "Propriétés de l'image" :
- Général :
  - Nom : Barcode
  - Source de l’image : Base de données
  - Champ à utiliser : =System.Convert.FromBase64String(Fields!SIM_QRPGlobal_BarcodeRDLCText.Value)
  - Type MIME : image/bmp
- Taille :
  - Affichage : Redimensionner proportionnellement
- Visibilité :
  - Expression : =IsNothing(Fields!SIM_QRPGlobal_BarcodeRDLCText.Value) OR (Globals!PageNumber>1)
Enregistrez le fichier .rdl modifié.
Retournez dans Mises en page de rapport dans Business Central et ajoutez la mise en page modifiée :
- Sélectionnez "Nouveau" pour ajouter une nouvelle mise en page et téléchargez le fichier modifié.
- Alternativement, vous pouvez remplacer la mise en page existante par le fichier modifié.
Liez le rapport à la nouvelle mise en page créée.
Lors de l’impression du rapport, le code-barres doit s’afficher correctement.

Extension des rapports Word

Dans cette section, nous allons ajouter un code QR de QR Pay à un rapport de votre choix.
Créez un nouveau fichier .al dans Visual Studio Code ou ouvrez un fichier .al existant qui étend le rapport souhaité.

Ajoutez le code suivant au fichier ouvert :

AL
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;
}

Remplacez "XXX" par l’ID du rapport que vous souhaitez étendre (les rapports 1306 "Standard Sales - Invoice" et 117 "Reminder" sont déjà étendus dans le standard de QR Pay).
Publiez l’extension.
Ouvrez le fichier Word du rapport.
Allez dans l’onglet "Développeur" dans le document Word et sélectionnez "Volet de mappage XML".
1. Faites un clic droit sur "Global_Barcode".
2. Sélectionnez "Insérer un contrôle de contenu" puis "Image".
Positionnez l’image à l’endroit souhaité dans le document.
Enregistrez le fichier Word.
Retournez dans Business Central et téléchargez le fichier Word comme mise en page.
Liez la mise en page modifiée au rapport correspondant.
Lors de l’impression de ce rapport, le code-barres sera désormais généré.