Einführung in crUFLBcsNet.dll – Eine moderne Barcode- und QR-Lösung

Hauptfunktionen

Verwendung von crUFLBcsNet.dll in MS Dynamics NAV

So verwenden Sie crUFLBcsNet.dll in Microsoft Dynamics NAV:

• Kopieren Sie crUFLBcsNet.dll und SkiaSharp.dll in den NAV-Ordner Add-ins (empfohlen: C:\Program Files (x86)\Microsoft Dynamics NAV\...\RoleTailored Client\Add-ins\).
• Stellen Sie sicher, dass die native SkiaSharp-Binärdatei (libSkiaSharp.dll) für Ihre Architektur (x86/x64) ebenfalls im selben Add-ins-Ordner liegt. (Nicht in den GAC legen; der NAV-Add-ins-Ordner ist bevorzugt.)
• Im NAV-Entwicklungsumfeld (C/SIDE):
  1. Öffnen Sie Tools → Object Designer → C/AL Globals.
  2. Erstellen Sie eine neue DotNet-Variable und verweisen Sie auf crUFLBcsNet.dll.
  3. Stellen Sie Subtype auf die gewünschte Klasse (z. B. CQRCode).
• Beispielcode in C/AL:

                              myQR := myQR.CQRCode;
  
                              codewords := myQR.Encode('1234567890');
                              // Dafür wird eine passende Barcode-Schrift benötigt
  
                              barcodeBytes := myQR.Image('1234567890', 240, 240);
                              // Reines Bild, keine Schrift erforderlich
  
                              barcodeBytes := myQR.AwesomeQR('1234567890', 'Tangerine', 'XS');
                              // Künstlerischer QR-Code, keine Schrift erforderlich
  
                              // In Datei speichern oder in einen BLOB-Stream schreiben
                              BLOBField.CREATEINSTREAM(inStream);
                              inStream.Write(barcodeBytes);
                                                          

                              myLinear := myLinear.CQRCode;
  
                              codewords := myLinear.GS1128('(17)190508(90)50921');
                              // Hier wird eine passende Barcode-Schrift benötigt. Die Klammern und AI-Präfixe nicht vergessen.
  
                              barcodeBytes := myLinear.GS1128Image('(17)190508(90)50921', 480, 240);
                              // Reines Bild, keine Schrift erforderlich
  
                              // In Datei speichern oder in einen BLOB-Stream schreiben
                              BLOBField.CREATEINSTREAM(inStream);
                              inStream.Write(barcodeBytes);
                              

Verwendung von crUFLBcsNet.dll in Crystal Reports 2025

So verwenden Sie crUFLBcsNet.dll in Crystal Reports 2025:

• Kopieren Sie crUFLBcsNet.dll und SkiaSharp.dll in den Bin-Ordner von Crystal Reports (z. B.: C:\Program Files (x86)\SAP BusinessObjects\Crystal Reports 2025\bin).
• Stellen Sie sicher, dass die native SkiaSharp-Binärdatei (libSkiaSharp.dll) ebenfalls im selben Ordner vorhanden ist. Das gemeinsame Platzieren aller Dateien verhindert Laufzeitfehler.
• Erstellen Sie in Crystal Reports ein neues Formelfeld und rufen Sie Methoden von crUFLBcsNet.dll über UFL auf:

                              Dim qrObj As Object
                              Set qrObj = CreateObject("cruflbcsnet.CQRCode")
  
                              Dim imgBytes As Variant
                              imgBytes = qrObj.Image("987654321", 200, 200, 1, 0, False)
  
                              ' In Datei speichern (Crystal kann dieses Bild per Pfad laden)
                              Dim fso, file
                              Set fso = CreateObject("Scripting.FileSystemObject")
                              Set file = fso.CreateTextFile("C:\temp\qr.png", True)
                              file.Write imgBytes
                              file.Close
                              

• Wenn Sie EncodeCR verwenden, beachten Sie die 250-Zeichen-Begrenzung von Crystal-Reports-Formelfeldern. Nutzen Sie mehrere Formelfelder (Index = 1, 2, 3...), um lange kodierte Werte wieder zusammenzusetzen.
• Um Bilder anzuzeigen: Fügen Sie ein OLE-Objekt / Bild in den Bericht ein und binden Sie es an das Byte-Array, das durch Image() oder AwesomeQR() zurückgegeben wird.

Vorteile

• Keine speziellen Schriftarten erforderlich bei Verwendung des Bildmodus.
• Voll rückwärtskompatibel, wenn Barcode-Schriftarten bevorzugt werden.
• Vereinfachte Integration für Entwickler und Berichtsdesigner.
• Zukunftssicher mit Funktionen zur Erzeugung künstlerischer Barcodes.