設計器說明
在整個 EEP Report
Module 中，我們一個提供了
3 類報表設計器， DesignTime 設計器、 RunTime Win 設計器以及 RunTime Web 設計器。在設計器中我們將分為 4 個部分介紹，分別為
ReportHeader ( 含 ReportFooter ) 、 ReportDetails 、 ReportSetting 以及 Template 文件管理等。由於 RunTime 設計器與 DesignTime 除了 Caption 不同 ( 因為 RunTime 時會啟動多國語言功能，隨著 User 的語言別來顯示 Caption) ，屬性功能完全一致，因此，下面我們就這 4 個部分的內容將 DesignTime 設計器中的各個屬性意義來說明，
RunTime 時所對應的 Caption 請自行對照。 ReportHeader ( 報表頭 ) 含 ReportFooter ( 報表尾 )
1.
Style Setting( 樣式設定 )
設定對報表表頭與表尾所顯示的字體，預設為 SimSun ， 9pt 。該屬性與 HeaderFont 或 FooterFont 是連動的。
1. ConstantSetting ( 內容項目設定 )
1. ConstantIte m
用於設定表頭或表尾中常用的一些列印項目內容，系統將提供的一些常用的常數訊息，並設定每個項目訊息的個別化屬性，
Cells ( 占用單元格 ) ： 用於設定占用儲存格數。當設定為 0 時，表示占用以最大的 Column 數為儲存格數 ( 代表向右合併所有的儲存格 ) 。
Co ntent Alignment ( 內容對齊 ) ： 用於設定內容對齊模式，用分為三種： Center( 置中 ) 、 Left( 靠左 ) 和 Right( 靠右 ) 。
Font ( 字型 ) ： 設定該內容的字體格式，若不設定的情況下，會預設 StyleSetting 中的設定值 ( 就是明細資料區的字體 ) 。
Format ( 格式 ) ： 用于設定顯示格式，此處使用的是格式的表達式方式，設定方法請參考 Format 表達式說明
NewLine ( 換行 ) ： 是否將目前欄位放到新的一列 (Row) 中 ， 如果為 False 則會排在前一個項目的右方。
Position ( 位置 ) ： 用於該項目內容在該列中的位置，共有兩種選擇 Left( 靠左 ) 及 Right( 靠右 ) 。
Style ( 內容 ) ： 用於設定列印的常數項目類型，我們一共提供了 12 種內容，如：列印日期、頁次、列印人員等。
1.
ImageItem
用于設定報表中顯示的圖片。
Cells ( 占用單元格 ) ： 用於設定占用儲存格數。當設定為 0 時，表示占用以最大的 Column 數為儲存格數 ( 代表向右合併所有的儲存格 ) 。
Co ntent Alignment ( 內容對齊 ) ： 此沒有使用。
Font ( 字型 ) ： 此沒有使用。
Format ( 格式 ) ： 此沒有使用。
NewLine ( 換行 ) ： 是否將目前欄位放到新的一列 (Row) 中 ， 如果為 False 則會排在前一個項目的右方。
Position ( 位置 ) ： 用於該項目內容在該列中的位置，共有兩種選擇 Left( 靠左 ) 及 Right( 靠右 ) 。
Index( 索引 ) ： 用於使用圖片在 Images 屬性集合中所在的索引位置，該數值從 0 開始計算。
1. ParameterItem
用來列印在 Parameters 屬性中所設定的自定參數內容。
Cells ( 占用單元格 ) ： 用於設定占用儲存格數。當設定為
0 時，表示占用以最大的 Column 數為儲存格數 ( 代表向右合併所有的儲存格 ) 。
Co ntent Alignment ( 內容對齊 ) ： 用於設定內容對齊模式，用分為三種： Center( 置中 ) 、 Left( 靠左 ) 和 Right( 靠右 ) 。
Font ( 字型 ) ： 設定該內容的字體格式，若不設定的情況下，會預設 StyleSetting 中的設定值 ( 就是明細資料區的字體 ) 。
Format ( 格式 ) ： 用于設定顯示格式，此處使用的是格式的表達式方式，設定方法請參考 Format 表達式說明
NewLine ( 換行 ) ： 是否將目前欄位放到新的一列 (Row) 中 ， 如果為 False 則會排在前一個項目的右方。
Position ( 位置 ) ： 用於該項目內容在該列中的位置，共有兩種選擇 Left( 靠左 ) 及 Right( 靠右 ) 。
Index ( 索引 ) ： 用於使用參數在 Parameters 集合屬性中所在的索引位置，該數值從 0 開始計算。
1. DataSourceItem
用於設定列印在表頭或表尾的資料表欄位，這些欄位的資料源來自與 HeaderDataSource 。
Cells ( 占用單元格 ) ： 用於設定占用儲存格數。當設定為
0 時，表示占用以最大的 Column 數為儲存格數 ( 代表向右合併所有的儲存格 ) 。
ColumnNam e ( 欄位名 ) ： 用於設定要列印的欄位名稱。
Co ntent Alignment ( 內容對齊 ) ： 用於設定內容對齊模式，用分為三種： Center( 置中 ) 、 Left( 靠左 ) 和 Right( 靠右 ) 。
Font ( 字型 ) ： 設定該內容的字體格式，若不設定的情況下，會預設 StyleSetting 中的設定值 ( 就是明細資料區的字體 ) 。
Format ( 格式 ) ： 用于設定顯示格式，此處使用的是格式的表達式方式，設定方法請參考 Format 表達式說明
NewLine ( 換行 ) ： 是否將目前欄位放到新的一列 (Row) 中 ， 如果為 False 則會排在前一個項目的右方。
Position ( 位置 ) ： 用於該項目內容在該列中的位置，共有兩種選擇 Left( 靠左 ) 及 Right( 靠右 ) 。
1.
Report Details
1. Style
Setting ( 樣式設定 )
設定對報表欄位所顯示的字體，預設為 SimSun ， 9pt 。該屬性會與 Field Font 連動。
1. Show Grid Line( 顯示格線 )
用於設定報表中的欄位格線方式。
Column GridLine( 欄位格線 ) ： 用來設定最左與最右的兩個欄位外邊是否需要使用格線。如下圖：
|
Column1 |
Column2 |
Column3 |
|
Value1 |
Value2 |
Value3 |
Column InsideLine( 欄位內格線 ) ： 用來設定各個欄位間是否需要使用格線，如下圖：
|
Column1 |
Column2 |
Column3 |
|
Value1 |
Value2 |
Value3 |
Row GridLine( 資料格線 ) ： 用來設定各個資料間是否需要使用格線，如下圖：
|
Column1 |
Column2 |
Column3 |
|
Value1 |
Value2 |
Value3 |
2. Column 設定
Caption ( 欄位抬頭 ) ： 用於設定該欄位的標題。
CaptionAlignment ( 抬頭對齊 ) ： 用於設定標題的對齊方式，用分成三種： Center( 置中 ) 、 Left( 靠左 ) 和 Right( 靠右 ) 。
Cells( 占用單元格數 ) ： 用於設定占用的儲存格數量。
ColumnAlignment ( 欄位對齊 ) ： 用於設定欄位內容對齊模式，用分為三種： Center( 置中 ) 、 Left( 靠左 ) 和 Right( 靠右 ) 。
ColumnName ： 用於設定報表所需要顯示的欄位名稱，在 RunTime 時無法設定這個屬性。
Format ： 用於設定欄位的顯示格式，此處以 格式字符串格式來輸入。設定方法請參考 Format 表達式說明 ，在 RunTime 時無法設定這個屬性。
Group( 分組方式 ) ： 用於設定報表的群組模式，我們共分為 3 種： None( 不分組 ) 、 Normal( 即 EasilyReport 的分組統計功能 ) 、 Excel( 即 Excel 自帶的分組統計功能 ) 。
GroupTotalCaption ( 分組匯總抬頭 ) ： 用於設定按群組匯總後，統計值前的顯示標題，如：小計等訊息。
NewLin e( 換行 ) ： 是否將目前列印欄位放到新的一行中 ， 如果為 False 則會排在前一個欄位的右方。
NewLinePosition ( 換行對齊位置 ) ： 用於設定換行後，要往上對齊那一個欄位位置，該數值從 1 開始。
Order( 排序 ) ： 用於設定該欄位的排序方式，共分為 None( 不排序 ) 、 Ascend( 升序 ) 及 Descend( 降序 ) 三種。
Sum( 匯總類型 ) ： 用于設定該欄位的匯總計算方式，此方法也可配合 Group 來作群組計算，提供了 None( 不計算 ) 、 Sum( 加總 ) 、 Count( 計數 ) 、 Max( 最大值 ) 、 Min( 最小值 ) 和 Average( 平均值 ) 等計算模式等。
SuppressIfDuplicate ( 群組重復則不顯示 ) ： 用於設定欄位值與上一筆資料重復時不顯示，該屬性需值配合 Group 為 Normal 的設定。
TotalCaption ( 抬頭樣式 ) ： 用於設定匯總後，統計值前的顯示標題，如：總計等訊息。
Width( 寬度 ) ： 用于設定欄位顯示的寬度，注意這裡是字元單位。
3. 其他
DataSource ( 資料源 ) ： 用於多 Detail( 多個明細資料表 ) 的情況下，區分 Detail 的索引位置，該索引是以 DataSources 屬性集合中的 Index 為參照，以 0 開始。
CaptionStyle ( 抬頭樣式 ) ： 用於設定報表欄位是以標簽形式顯示 ( 標題放在欄位內容的左方 ) ，還是以表格形式放在欄位內容的上方。當選擇 ColumnHeader 時，以表格形式顯示；當選擇 RowHeader 時，以標簽形式顯示。
GroupGap ( 分組間隙 ) ： 用於設定群組間的間隔。提供了
None 、 EmptyRow 空出一列 ( pdf 及 Excel 兼用 ) 、 SingleLine 畫一條線 ( pdf 使用 ) 、 DoubleLine 畫雙條線 ( pdf 使用 ) Page 跳頁 ( pdf 及 Excel 兼用 ) 、 Sheet 用標籤分開 (Excel 使用 )
GroupTotal ( 匯總抬頭 ) ： 用於設定群組是否要列印群組加總抬頭。
1. Report Setting( 報表設定 )
2. Page
Setting ( 頁面設定 )
用於設定列印報表的信息。
Page Size( 頁面尺寸 ) ： 用於設定列印頁面的大小，該屬性值有在 pdf 的輸出模式時才會有效。
Header Repeat ( 重復表頭 ) ： 用于設定 Header 和 Footer 是否在每頁重復， true 表示每頁都會重復印出， false 則 Header 只會在第一頁才會印，而 Footer 則會在最後一頁才會印。
Print
Orientation( 打印方向 ) ： 用於設定列印報表紙張的方向，
Horizontal 為橫印， Vertical 為豎印，該屬性值有在 pdf 的輸出模式時有效。
Page
Records( 每頁資料筆數 ) ： 用於設定一頁中能列印的最大資料筆數，當該屬性與 Page Height 同時設定時，以先滿足條件的設定為優先。
Page Heigh t( 頁的高度 ) ： 用於設定頁高，該屬性以 inch 為單位。如果為 A4 的 Size ，一般建議設定頁高為 9.5inch ( 須扣除表頭與表尾的占用高度 ) 。
Page
Margin( 頁邊距 ) ： 用於設定輸出報表的有效列印邊距。其中， Left ：左邊距， Right ：右邊距， Top ：上邊距， Botton ：下邊距。這些設定以 Inch 為單位，本設定只針對 pdf 有效果。
3. E-mail Config( 電子郵件設定 )
用於設定發送 E-Mail 的信息，該屬性需配合 Output Mode 為 Email 時使用。
E-Mail
Title( 抬頭 ) ： 發送 Mail 的主題。
E-Mail
Address( 收件人 ) ： Mail 的收件人。
寄件人： 用於設定寄件人的 Mail 地址，只在 RunTime 執行模式中才能設定。
密碼： 用於設定寄件人的 Mail 密碼，只在 RunTime 執行模式中才能設定。 伺服器：用於設定寄件人的 Mail 的伺服器，只在 RunTime 執行模式中才能設定。
4. Outpu t Setting( 輸出設定 )
用於設定輸出格式。
Output FileName( 輸出檔案名 ) ： 用於設定輸出檔案名稱。
Output FilePath( 輸出路徑 ) ： 用於設定輸出檔案路徑。
Output
Mode( 輸出模式 ) ： 用於設定報表的輸出後的打開模式，共分為三種 None( 輸出後不打開 ) ， Launch( 輸出後自動打開 ) 、 Email( 輸出後由 Mail 發出 ) 。
Export
Format( 導出格式 ) ： 用於輸出檔案的格式，共分為兩種： excel 以及 pdf 。
2.
Template 文件管理
Read From Template( 讀取模板 ) ： 用於讀取已經存在的模板，讀入後會將目前的報表設定覆蓋。
Save Template( 保存模板 ) ： 用於將目前的報表設定存檔到以此 ReportID 為名稱的模板上。
Save As Template( 另存模板 ) ： 用於將目前的設定另存到一個新的模板上。
請注意，在 RunTime 的時期， User 可以將一個 ReportID 透過 Save As 存成多個模板，下次透過 Read 即可讀取，但不同的 ReportID 是無法共通的，只能是同一張報表可以互通模板。但是，如果在 DesignTime 設計模式中，就可以不管 ReportID ，所有的模板都可以透通，但須注意因為不同報表的 DataSource 欄位不同，必須自行重新抓取，否則會發生錯誤。