介紹 crUFLBcsNet.dll – 現代化的條碼與 QR 解決方案

主要功能

在 MS Dynamics NAV 中使用 crUFLBcsNet.dll

在 Microsoft Dynamics NAV 中使用 crUFLBcsNet.dll：

• 將 crUFLBcsNet.dll 與 SkiaSharp.dll 複製至 NAV 的 add-ins 資料夾 （建議路徑：C:\Program Files (x86)\Microsoft Dynamics NAV\...\RoleTailored Client\Add-ins\）。
• 確保 native SkiaSharp binary (libSkiaSharp.dll)（x86/x64）也放在同一資料夾中。 不要將 SkiaSharp 放到 GAC，建議全部放在 add-ins 資料夾。
• 在 NAV 開發環境（C/SIDE）中：
  1. 開啟 Tools → Object Designer → C/AL Globals
  2. 新增 DotNet 變數並指向 crUFLBcsNet.dll
  3. Subtype 設為所需的類別（如 CQRCode）
• C/AL 程式碼範例：

                                  myQR := myQR.CQRCode;
  
                                  codewords := myQR.Encode('1234567890');
                                  // 使用字型模式，需要對應字型
  
                                  barcodeBytes := myQR.Image('1234567890', 240, 240);
                                  // 純影像模式，不需字型
  
                                  barcodeBytes := myQR.AwesomeQR('1234567890', 'Tangerine', 'XS');
                                  // 藝術 QR 影像，不需字型
  
                                  // 存成檔案或寫入 BLOB
                                  BLOBField.CREATEINSTREAM(inStream);
                                  inStream.Write(barcodeBytes);
                              

                                  myLinear := myLinear.CQRCode;
  
                                  codewords := myLinear.GS1128('(17)190508(90)50921');
                                  // 字型模式，不要忘記括號與 AI 前綴
  
                                  barcodeBytes := myLinear.GS1128Image('(17)190508(90)50921', 480, 240);
                                  // 純影像模式，不需字型
  
                                  // 存成檔案或寫入 BLOB
                                  BLOBField.CREATEINSTREAM(inStream);
                                  inStream.Write(barcodeBytes);
                              

在 Crystal Reports 2025 中使用 crUFLBcsNet.dll

要在 Crystal Reports 2025 中使用 crUFLBcsNet.dll：

• 將 crUFLBcsNet.dll 與 SkiaSharp.dll 放到 Crystal Reports bin 資料夾 （例如：C:\Program Files (x86)\SAP BusinessObjects\Crystal Reports 2025\bin）。
• 確保 native SkiaSharp binary (libSkiaSharp.dll)（x86/x64）也位於同一資料夾。 三個檔案放一起可避免執行期錯誤。
• 在 Crystal Reports 中建立新的 Formula Field，並通过 UFL 呼叫 crUFLBcsNet.dll 方法：

                              Dim qrObj As Object
                              Set qrObj = CreateObject("cruflbcsnet.CQRCode")
  
                              Dim imgBytes As Variant
                              imgBytes = qrObj.Image("987654321", 200, 200, 1, 0, False)
  
                              ' 存成檔案供 Crystal 讀取
                              Dim fso, file
                              Set fso = CreateObject("Scripting.FileSystemObject")
                              Set file = fso.CreateTextFile("C:\temp\qr.png", True)
                              file.Write imgBytes
                              file.Close
                              

• 如果使用 EncodeCR，請注意 Crystal Reports 的公式欄位限制為 250 字元。 請使用 index = 1, 2, 3 … 的多個公式欄位接續輸出完整字串。
• 若要顯示影像：在報表中插入 OLE Object / Picture，並綁定至 Image() 或 AwesomeQR() 回傳的 byte[]。

優點

• 使用影像模式時不需任何特殊字型。
• 若偏好字型模式，也可完全相容舊有方式。
• 讓開發者與報表設計者能更輕鬆整合。
• 支援具未來性的藝術條碼產生。