在月前發布的FastReport.Net2013.3中出現的FastReport.Service.dll引起了一些開發者的注意，今天我們就來談談這個用于新的定制服務的WCF服務庫。

　　該庫中包含了以下功能：

List<ReportItem> GetReportsList();
List<ReportItem> GetReportsListByPath(string path);
List<GearItem> GetGearList();
Stream GetReport(ReportItem report, GearItem gear);

　　List<ReportItem> GetReportsList()：返回一個可用的報表列表。每一個項目都被認為是一個ReportItem對象，報表存儲在運行該服務的服務器硬盤上，并按字母順序排序。

 　　List<ReportItem> GetReportsListByPath(string path)：按路徑返回可用的報表列表。

　　List<GearItem> GetGearList()：返回一個可用的格式列表，這些格式可以作為元素GearItem合并為服務報表。

　　Stream GetReport(ReportItem report, GearItem gear)：返回一個創建報表結果的流。

ReportItem

public class ReportItem
 {
 public string Path;
 public string Name;
 public string Description;
 public Dictionary<string, string> Parameters;
 }

　　Path：路徑在服務器上，在相對的根文件夾內存儲報表。該報表的文件擴展名必須為*.frx，這個屬性一般被用來在下一步查詢中識別報表。

　　Name：元數據報表的名稱。如果元數據報表包含的是一個空的名字，那該屬性就只包含一個沒有擴展名的文件名。這個屬性可以用于在應用程序中創建一個交互式的列報表，如列表框等。

　　Description：元數據報表的報表描述。

　　Dictionary<string, string> Parameters：報表參數的字典，支持支持字符串值。

GearItem

public class GearItem
 {
 public string Name;
 public Dictionary<string, string> Properties;
 }

　　Name：格式的名稱，可能包含PDF、DOCX、XLSX、PPTX、RTF、ODS、ODT、MHT、CSV、DBF、XML、TXT、FPX等字符串。

　　Dictionary<string, string> Properties：報表參數的字典。

　　需要注意是的，在App.config或Web.config中需要添加以下幾行代碼：

<appSettings>
 <add key="FastReport.ReportsPath" value="C:\Program files\FastReports\FastReport.Net\Demos\WCF" />
 <add key="FastReport.ConnectionStringName" value="FastReportDemo" />
 <add key="FastReport.Gear" value="PDF,DOCX,XLSX,PPTX,RTF,ODS,ODT,MHT,CSV,DBF,XML,TXT,FPX" />
 </appSettings>

　　FastReport.ReportsPath：用于指定報表文件夾的路徑。

　　FastReport.ConnectionStringName：指定數據庫連接流的名稱。

　　FastReport.Gear：可用格式列表。

FastReport.Service工作流程

確定接收報表和格式的流程

　　使用這個服務創建報表模板時，需要注意：

1. 報表中不支持對話框
2. 每個報表必須包括內部的DataConnection