Erweiterung von Berichten mit dem Document Inbound Barcode

In dieser Dokumentation erfahren Sie, wie Sie einen Bericht in Business Central um einen Document Inbound Barcode erweitern können. Der Barcode wird automatisch während des Druckens des Berichts oder beim Buchen bzw. Konvertieren eines Dokuments generiert und hinzugefügt.

Vorgehensweise

Es gibt zwei Ansätze, um dies zu erreichen:

Benutzerdefinierte Berichte:
In benutzerdefinierten Berichten können Sie den erforderlichen Code direkt in den Bericht integrieren.
Standardberichte:
Für Standardberichte besteht die Möglichkeit, eine Berichtserweiterung zu erstellen, die den entsprechenden Code implementiert.

Bitte beachten Sie, dass Unterschiede zwischen Word-Berichten und RDLC-Berichten bestehen, die bei der Umsetzung berücksichtigt werden müssen.

Anforderungen

Bevor Sie beginnen, stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:

CORE muss in der Erweiterung als Referenz eingebunden sein.
Document Central muss in der Erweiterung als Referenz eingebunden sein.
Document Inbound muss in der Erweiterung als Referenz eingebunden sein.
Document Central muss ordnungsgemäß lizenziert sein.
Document Central und Document Inbound müssen in der entsprechenden Moduleinrichtung aktiviert sein.

Erfahren Sie mehr über das Erstellen eines Word-Layout-Berichts in Microsoft Business Central.

Erfahren Sie mehr über das Erstellen eines RDLC-Layout-Berichts in Microsoft Business Central.

Einrichtung in Document Central

Um die korrekte Funktionalität sicherzustellen, müssen folgende Konfigurationen für den erstellten/erweiterten Bericht in Document Central vorgenommen werden:

Eine Nummernserie für den Barcode muss im Mapping eingerichtet werden. Das Mapping muss auf der Tabelle des Reports basieren.
In den Berichtseinstellungen sind folgende Punkte zu beachten:
Ein Barcode Content Type muss definiert werden.
Der Barcode-Druck muss aktiviert werden.

Erweiterung von RDLC-Berichten

In diesem Abschnitt fügen wir einen Document Inbound Barcode zu einem von Ihnen ausgewählten Bericht hinzu.
Erstellen Sie eine neue .al-Datei in Visual Studio Code oder öffnen Sie eine bereits existierende .al-Datei, die den gewünschten Bericht erweitert.

Fügen Sie den folgenden Code in die geöffnete Datei ein:

AL
reportextension 5227509 "DMSDI_EXT Test" extends XXX
{
    dataset
    {
        add(Header)
        {
            column(Global_Barcode; GlobalBarcode)
            { }
        }
        modify(Header)
        {
            trigger OnAfterAfterGetRecord()
            var
                LocalSIMDIBarcodeMgt: Codeunit "SIM_DI Barcode Management";
                LocalCodeunitSIMDMSSI: Codeunit "SIM_DMS SI";
                LocalEnumSIMDITypeOfBarcodes: Enum "SIM_DI Type of Barcodes";
                LocalRRef: RecordRef;
                LocalBarcodeText: Text;
            begin
                if LocalCodeunitSIMDMSSI.GetPdfPrint() then
                    exit;

                LocalRRef.Get(Header.RecordId());
                LocalBarcodeText := LocalSIMDIBarcodeMgt.CreateBarcode(LocalRRef, Header."No.", '', XXX, false);
                GlobalBarcode := LocalSIMDIBarcodeMgt.CreateLabel(LocalBarcodeText, 250, 600, true, Format(LocalEnumSIMDITypeOfBarcodes::Code128), 'PNG');
            end;
        }
    }
    var
        GlobalBarcode: Text;
}

Info

Im Enum "LocalEnumSIMDITypeOfBarcodes" sind alle unterstützten Barcode-Typen definiert. Um den Barcode-Typ zu ändern, wählen Sie einfach den gewünschten Wert aus diesem Enum aus.

Ersetzen Sie "XXX" durch die ID des Berichts, den Sie erweitern möchten (z. B. 1306 für den Verkaufsbeleg).
Veröffentlichen Sie die Erweiterung.
Öffnen Sie die Berichts-Layouts in Business Central.
Suchen Sie das Layout, das Sie erweitern möchten, und klicken Sie auf "Layout aktualisieren und herunterladen".
Öffnen Sie die heruntergeladene Layout-Datei.
Fügen Sie ein Bild hinzu, indem Sie "Einfügen" -> "Bild" auswählen.
Positionieren Sie das hinzugefügte Bild an der gewünschten Stelle, an der der Barcode erscheinen soll.
Klicken Sie mit der rechten Maustaste auf das Bild und wählen Sie "Bildeigenschaften".
Nehmen Sie die folgenden Anpassungen im Dialog "Bildeigenschaften" vor:
- Allgemein:
  - Name: Barcode
  - Bildherkunft: Datenbank
  - Feld verwenden: =System.Convert.FromBase64String(Fields!Global_Barcode.Value)
  - MIME-Typ verwenden: image/bmp
- Größe:
  - Anzeige: Proportional anpassen
- Sichtbarkeit:
  - Ausdruck: =IsNothing(Fields!Global_Barcode.Value) OR (Globals!PageNumber>1)
Speichern Sie die bearbeitete .rdl-Datei.
Wechseln Sie zurück zu den Berichts-Layouts in Business Central und fügen Sie das bearbeitete Layout hinzu:
- Wählen Sie "Neu", um ein neues Layout hinzuzufügen, und laden Sie die überarbeitete Datei hoch.
- Alternativ können Sie das bestehende Layout mit der bearbeiteten Datei ersetzen.
Verknüpfen Sie den Bericht mit dem neu erstellten Layout.
Wenn Sie den Bericht drucken, sollte der Barcode korrekt angezeigt werden.

Erweiterung von Word-Berichten

In diesem Abschnitt fügen wir einen Document Inbound Barcode zu einem ausgewählten Bericht hinzu.
Erstellen Sie eine neue .al-Datei in Visual Studio Code oder öffnen Sie eine bereits vorhandene .al-Datei, die den gewünschten Bericht erweitert.

Fügen Sie den folgenden Code in die geöffnete Datei ein, oder verwenden Sie alternativ Ihr eigenes Blob-Feld anstelle des Blob-Felds des Datensatzes "SIM_CORE Temp Table". Achten Sie darauf, dass das Feld entweder den Untertyp "Bitmap" hat oder keinen Untertyp definiert ist.

AL
reportextension 5227509 "DMSDI_EXT Test" extends XXX
{
    dataset
    {
        add(Header)
        {
            column(Global_Barcode; GlobalRecordSIMCORETempTable."Blob 1")
            { }
        }
        modify(Header)
        {
            trigger OnAfterAfterGetRecord()
            var
                LocalSIMDIBarcodeMgt: Codeunit "SIM_DI Barcode Management";
                LocalCodeunitBase64Convert: Codeunit "Base64 Convert";
                LocalCodeunitSIMDMSSI: Codeunit "SIM_DMS SI";
                LocalRecordRef: RecordRef;
                LocalEnumSIMDITypeOfBarcodes: Enum "SIM_DI Type of Barcodes";
                LocalOutStream: OutStream;
                LocalBarcodeText: Text;
                LocalBarcodeBase64Text: Text;
            begin
                if LocalCodeunitSIMDMSSI.GetPdfPrint() then
                    exit;

                LocalRecordRef.Get(Header.RecordId());
                LocalBarcodeText := LocalSIMDIBarcodeMgt.CreateBarcode(LocalRecordRef, Header."No.", '', XXX, false);
                LocalBarcodeBase64Text := LocalSIMDIBarcodeMgt.CreateLabel(LocalBarcodeText, 250, 600, true, Format(LocalEnumSIMDITypeOfBarcodes::Code128, 'PNG');
                GlobalRecordSIMCORETempTable."Blob 1".CreateOutStream(LocalOutStream);
                LocalCodeunitBase64Convert.FromBase64(LocalBarcodeBase64Text, LocalOutStream);
            end;
        }
    }
    var
        GlobalRecordSIMCORETempTable: Record "SIM_CORE Temp Table";
}

Info

Im Enum "LocalEnumSIMDITypeOfBarcodes" sind alle unterstützten Barcode-Typen hinterlegt. Um den Barcode-Typ anzupassen, wählen Sie einfach den gewünschten Wert aus diesem Enum aus.

Ersetzen Sie "XXX" durch die Bericht-ID, die Sie erweitern möchten (z. B. 1306 für den Verkaufsbeleg).
Veröffentlichen Sie die Erweiterung.
Öffnen Sie die Word-Datei des Berichts.
Navigieren Sie im Word-Dokument zum Reiter "Entwickler" und wählen Sie die Option "XML-Zuordnungsbereich" aus.
1. Klicken Sie rechts auf "Global_Barcode".
2. Wählen Sie "Inhaltselement einfügen" und anschließend "Bild" aus.
Positionieren Sie das Bild an der Stelle im Dokument, an der der Barcode angezeigt werden soll.
Speichern Sie die Word-Datei.
Wechseln Sie zurück zu Business Central und laden Sie die Word-Datei als Layout hoch.
Verknüpfen Sie das bearbeitete Layout mit dem entsprechenden Bericht.
Beim Drucken dieses Berichts wird der Barcode nun ausgegeben.