1. 概述
1.1 版本
| 報表伺服器版本 | 功能變更 |
|---|---|
| 11.0 | - |
| 11.0.31 | 新增參數$fine_role_id，避免角色重新命名導致權限配置失效 |
1.2 應用場景
程式開發語言中涉及到一些關鍵字，編程中自訂變數是禁止使用這些關鍵字的。
出於特定需求，FineReport 在設計時會給出特定的系統參數。
使用者自訂參數時，需避免使用這些系統參數，否則可能會因為變數衝突而導致一系列的錯誤。
2. 系統參數
| 參數名 | 定義 | 具體應用參考 |
|---|---|---|
| $page_number | 報表當前存取的頁碼 | 具體應用請參考： |
| $totalPage_number | 報表的總頁數 | |
| $fine_username | 在使用權限時儲存帳號的參數 | 具體應用請參考： |
| $fine_role | 在使用權限時儲存角色的參數 | |
| $fine_role_id | 獲取登入系統的角色ID | |
| $fine_position | 在使用權限時儲存使用者所屬的組織機構集合的參數 注：參數面板不支援獲取$fine_position | |
| $fine_password | 在使用權限時儲存使用者登入密碼的參數 注：使用 $fine_password 獲取值時，值不會顯示出來 | |
| $fine_display_name | 在使用權限時儲存姓名的參數 | |
| $__count__ | 內建參數，表示總數 | 結果集篩選分欄 |
| NULL | 空值參數，表示不可用或不存在的資料 | 通俗的說，就是資料沒有值，是不區分大小寫，使用範圍廣泛 |
| NOFILTER | 是專門用來比較的變數，且只可用作比較。 任何值與 NOFILTER 比較均傳回 true。 | 這裏的比較包括「大於，等於，小於，大於等於，小於等於」等等，不區分大小寫 |
| reportname | 普通報表在工程reportlets資料夾中的存放路徑 | 例如：doc/Form/FreeFrom/自由填報範本.cpt |
| formletname | 決策報表在工程reportlets資料夾中的存放路徑 | 例如：doc/Form/FreeFrom/自由填報範本.frm |
| address | websocket 用於獲取遠端地址的參數 | |
| ENTRYID | 開啟「超級連結繼承權限」功能，基本無使用者使用場景，這裏列出主要是提醒使用者定義參數時避免使用此名稱。 | - |
| 注：以下參數應用均以 http://localhost:8075/webroot/decision/view/report?viewlet=workbook1.cpt 為例 | ||
| servletURL | 獲取報表的相對路徑 servletURL 意指 /webroot/decision/view/report | 具體應用請參考： |
| serverSchema | 協定名稱。 serverSchema 意指 http | |
| serverName | 伺服器地址或名稱。 serverName 意指 localhost，即 IP。 | |
| serverPort | 存取的埠。 serverPort 意指 8075 | |
| serverURL | 存取服務的 URL serverURL 意指 http://localhost:8075 | |
| contextPath | 絕對路徑的伺服器別名，即虛擬目錄。 contextPath 意指 /webroot | |
| sessionID | 在建立對話時，伺服器會為每一個對話生成一個單獨的標識，對話標識以長字串資料類型傳回。sessionID 等於本次對話 ID 的記錄。 | sessionID 多用於 WEB 頁面的統計 |
| 注：以下參數均為帆軟內部定義的參數，使用者應避免使用 | ||
| widgetVersion | 帆軟內部定義的參數 | - |
| cid | 帆軟內部定義的參數 | - |
_PAPERHEIGHT | 帆軟內部定義的參數 | - |
| _PAPERWIDTH | 帆軟內部定義的參數 | - |
