Aller au contenu

Étendre les rapports avec le QR Pay

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

Procédure

Il existe deux approches pour y parvenir :

  1. Rapports personnalisés :
    Dans les rapports personnalisés, vous pouvez intégrer directement le code requis dans le rapport.

  2. Rapports standard :
    Pour les rapports standard, 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 qui doivent être prises en compte lors de l'implémentation.

Exigences

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 correspondant.

En savoir plus sur la création d'un rapport de mise en page Word dans Microsoft Business Central.

En savoir plus sur la création d'un rapport de mise en page RDLC dans Microsoft Business Central.

Configuration dans QR Pay

Pour garantir un fonctionnement correct, les configurations suivantes doivent être effectuées pour le rapport créé/étendu dans QR Pay :

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

Modifier la valeur du montant dans la génération du QR-Code

  1. Dans cette section, nous allons changer le montant du QR-Code avec un EventSubscriber.
  2. Créez un nouveau .al-file dans Visual Studio Code ou ouvrez un .al-file existant.

  3. Ajoutez le code suivant au fichier ouvert :

    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
    // Calculer la logique du montant personnalisé ici
    ParamAmountDecimal := NewValue;
    ParamIshandledBoolean := true;
end;
    4. Utilisez le RecordRef pour calculer le nouveau montant. 5. Définissez ParamIshandledBoolean sur true si cette valeur doit être utilisée.

Bloquer la génération du QR-Code

  1. Dans cette section, nous allons bloquer la génération du QR-Code avec un EventSubscriber.
  2. Créez un nouveau .al-file dans Visual Studio Code ou ouvrez un .al-file existant.

  3. Ajoutez le code suivant au fichier ouvert :

    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. Utilisez le RecordRef pour personnaliser la logique métier si le QR Code doit être créé. 5. Définissez ParamIshandledBoolean sur true si le QR Code ne doit pas être créé.

Étendre les rapports RDLC

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

  3. Ajoutez le code suivant au fichier ouvert :

    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. Remplacez "XXX" par l'ID du rapport que vous souhaitez étendre (le rapport 1306 "Standard Sales - Invoice et 117 Reminder sont déjà étendus dans le standard de QR Pay).

  5. Publiez l'extension.
  6. Ouvrez Mises en page de rapport dans Business Central.
  7. Trouvez la mise en page que vous souhaitez étendre et cliquez sur "Mettre à jour et télécharger la mise en page".
  8. Ouvrez le fichier de mise en page téléchargé.
  9. Ajoutez une image en sélectionnant "Insérer" -> "Image".
  10. Positionnez l'image ajoutée à l'endroit où vous souhaitez que le code-barres apparaisse.
  11. Cliquez avec le bouton droit sur l'image et sélectionnez "Propriétés de l'image".
  12. Apportez les ajustements suivants dans la boîte de dialogue "Propriétés de l'image" :
    • Général :
      • Nom : Code-barres
      • 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)
  13. Enregistrez le fichier .rdl modifié.
  14. Retournez à 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é.
  15. Liez le rapport à la mise en page nouvellement créée.
  16. Lorsque vous imprimez le rapport, le code-barres doit s'afficher correctement.

Étendre les rapports Word

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

  3. Ajoutez le code suivant au fichier ouvert :

    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. Remplacez "XXX" par l'ID du rapport que vous souhaitez étendre (le rapport 1306 "Standard Sales - Invoice et 117 Reminder sont déjà étendus dans le standard de QR Pay).

  5. Publiez l'extension.
  6. Ouvrez le fichier Word du rapport.
  7. Accédez à l'onglet "Développeur" dans le document Word et sélectionnez "Volet de mappage XML".
    1. Cliquez avec le bouton droit sur "Global_Barcode".
    2. Sélectionnez "Insérer un contrôle de contenu" puis "Image".
  8. Positionnez l'image là où vous souhaitez que le code-barres apparaisse dans le document.
  9. Enregistrez le fichier Word.
  10. Retournez à Business Central et téléchargez le fichier Word en tant que mise en page.
  11. Liez la mise en page modifiée au rapport correspondant.
  12. Lors de l'impression de ce rapport, le code-barres sera désormais affiché.

Voir aussi