使用FastReport報表工具生成標籤列印文檔

2019 年 10 月 30 日
筆記

在我們實際開發報表的時候，我們需要按一定的業務規則組織好報表的模板設計，讓報表儘可能的貼近實際的需求，在之前的隨筆中《使用FastReport報表工具生成報表PDF文檔》介紹了FastReport生成常規報表的處理，本篇隨筆回顧常規報表的處理效果，並介紹基於FastReport生成標籤紙列印需要的報表格式。

1、常規報表的處理

我們一般處理報表的時候，大多數情況碰到的是明細報表，或者有主從表這種樣式的報表格式，明細報表就是只需要設計一個表頭，按列表展示即可，如下所示格式。

或者類似一個基於XtraReport報表的功能介面，如下面圖示所示。

這裡面涉及的欄位，包括字元型、日期型，數值型、枚舉類型等，還有統計值、列印時間（參數），因此也算一個比較完整的報表展示了。

或者一些有一條記錄構建成的報表資訊，如下報表所示，這些也只是設計模板上的差異，在模板裡面綁定對應的欄位或者參數即可實現。

還有一種是主表有資訊，從表有明細的數據展示方式，這個在隨筆《使用FastReport報表工具生成報表PDF文檔》有介紹過。

2、基於標籤資訊報表的列印處理

之前在隨筆《在Winform開發中使用Grid++報表》和《在Bootstrap開發框架中使用Grid++報表》中介紹了使用銳浪報表來設計展現標籤列印報表的處理，如下效果所示。

本篇隨筆介紹基於FastReport報表工具生成標籤列印文檔的操作。

其實如果細心查找，FastReport也提供了很多Demo案例，其中就有標籤的案例介紹，設計效果如下所示。

報表預覽效果如下所示。

我們要做的類似，不過我們需要增加二維碼、條碼上去進行列印而已。

首先我們需要設計一個報表模板，設計格式如下所示。

在其中我們需要加入一個數據源進行綁定和測試預覽效果，我們選擇SQLServer一個表的數據進行創建數據源，如下所示。

設計報表，我們需要根據實際標籤紙張預先設計好報表頁面大小，如下所示。

如果需要展示多少列，可以通過頁面設置中的列進行指定劃分多少列，如下所示。

不過在實際測試的時候，這樣的屬性設置，報表渲染的時候，是按指定高度，從左列到右列進行依次展現的，如果我們需要按實際渲染高度，那麼這裡可以設置為1，然後由數據區進行設置列的數量即可。如下所示。

數據區設置列數為實際需要展現的列數，這個根據寬度預覽看大概設計多少列合適，讓頁面高寬儘可能利用好即可。

二維碼標籤報表格式設計效果大概如下所示。

我們使用數據源的數據預覽下效果，效果還是杠杠的。

報表模板弄好了，我們就需要如何生成FastReport報表或者導出PDF了。

我在之前的隨筆《使用FastReport報表工具生成報表PDF文檔》裡面介紹了FastReport報表的處理程式碼，這裡做法依舊差不多，綁定數據源即可展示或者導出PDF了。

最主要的程式碼如下所示。

//生成PDF報表文檔到具體文件  Report report = new Report();  report.Load(reportPath);    //定義參數和數據格式  var dict = new Dictionary<string, object>();  var dt = DataTableHelper.CreateTable("ID,Name,CurrDept,Code,UsePerson,KeepAddr");  if (list != null)  {      foreach (var info in list)      {          var dr = dt.NewRow();          dr["ID"] = info.ID;          dr["Name"] = info.Name;          dr["CurrDept"] = info.CurrDept;          dr["Code"] = info.Code;          dr["UsePerson"] = info.UsePerson;          dr["KeepAddr"] = info.KeepAddr;          dt.Rows.Add(dr);      }  }    //刷新數據源  foreach (string key in dict.Keys)  {      report.SetParameterValue(key, dict[key]);  }  report.RegisterData(dt, "T_Asset");    //運行報表  report.Prepare();

如果需要導出PDF，那麼程式碼增加部分導出處理即可。

//導出PDF報表  PDFExport export = new PDFExport();  report.Export(export, realPath);  report.Dispose();

我們來看看實際在瀏覽器預覽的效果，如下所示。

以上效果結合了pdfJS的在線預覽PDF操作，如果需要了解PDF的在線處理，參考下隨筆《實現在線預覽PDF的幾種解決方案》。