1. 概述
1.1 版本
| 報表服務器版本 | App 版本 | 功能變更 |
|---|---|---|
| 11.0 | - | - |
| 11.0.21 | 11.0.85 | 「密碼控件」移動端新增「允許一鍵清空」功能和「允許顯示密碼」功能 |
| 11.0.30 | 11.0.94 | 標籤名稱支援使用公式，詳情參見 2.1.2 節 |
1.2 應用場景
1.2.1 填報元件
填報報表中可以透過該元件輸入密碼資訊，錄入密碼，如下圖所示：
1.2.2 參數元件
參數面板處可以透過該元件輸入密碼資訊，鍵入查詢參數，「密碼元件」一般不用於參數查詢。
注：「密碼元件」在傳輸程式中是加密的，而在傳輸結束後是解密的，保證了傳輸程式的安全。
1.3 如何新增
1.3.1 填報元件
被菜儲存格後，點選右側屬性面板的「元件設定」，「選擇元件」處下拉選擇「密碼元件」，如下圖所示：
1.3.2 參數元件
將參數面板元件工具欄中的「密碼元件」拖入到參數面板中，如下圖所示：
2. 元件介紹
2.1 屬性
2.1.1 填報元件
「密碼元件」的屬性設定介面如下圖所示：
各屬性設定項的詳細介紹如下：
注：「密碼元件」在填報應用時，可透過在儲存格中新增值的方式設定預設值。
| 分類 | 設定項 | 詳細介紹 | |
|---|---|---|---|
| 基本 | 元件名稱 | 元件的名稱，手動輸入，通常與參數結合使用，如透過元件名獲取元件後將元件值傳遞給對應參數，預設為空。 | |
| 可 用 | 元件是否可用，勾選後，填報時元件可編輯；不勾選，填報時元件灰化，不可編輯，預設勾選。 | ||
| 可 見 | 元件是否可見，勾選後，填報時頁面顯示元件；不勾選，填報時頁面不顯示元件，預設勾選。 | ||
| 進階 | 水 印 | 填報時元件內顯示的淺灰色水印文字，手動輸入，以提示使用者需要輸入資訊，點選元件編輯區域後消失，預設為空。 | |
| 校驗 | 允許為空 | 是否允許元件為空值，勾選後，允許元件為空值；不勾選，填報校驗和提交時會提示，預設勾選。 | |
| 錯誤提示 | 不勾選「允許為空」時出現的設定項，可自訂提示資訊。預設情況下將顯示：不能為空 | ||
| 填寫規則 | 元件輸入值需要符合的規則，若不符合規則，則提示錯誤資訊。 支援的校驗規則共有 3 種，如下： 1）無：不限制校驗規則。 2）長度：定義密碼輸入框的長度區間，校驗密碼長度。 3）自訂：正則表式自訂校驗規則，詳細內容參見文檔：正則表式定義規則。 預設為無 | ||
2.1.2 參數元件
「密碼元件」的屬性設定介面如下圖所示：
各屬性設定項的詳細介紹如下：
| 分類 | 設定項 | 詳細介紹 | ||
|---|---|---|---|---|
| 基本 | 元件名稱 | 元件的名稱，手動輸入，通常與參數結合使用，如透過元件名獲取元件後將元件值傳遞給對應參數，預設為 password# 。 | ||
| 可 用 | 元件是否可用，勾選後，填報時元件可編輯；不勾選，填報時元件灰化，不可編輯，預設勾選。 | |||
| 可 見 | 元件是否可見，勾選後，填報時頁面顯示元件；不勾選，填報時頁面不顯示元件，預設勾選。 | |||
| 進階 | 標籤名稱 | 元件的標籤屬性是用在行動端的，行動端不支援參數面板上的「標籤元件」，識別的是普通元件的「標籤名稱」屬性，所以行動端可以用元件的標籤名稱來實現標籤 。 FineReport 11.0.30 及以上版本，標籤名稱支援使用公式。編輯框內輸入公式正文（等號開頭），自動計算公式結果作為最終標籤名稱。 注：使用 i18n 函式實現標籤名稱根據語言顯示時，多語言插件需更新至 V2.2.2 版本。若範本中使用的 key (範本內或平台內的 key )更新，需手動重新整理範本才可生效。 | ||
| 控 件 值 | 元件初始化時的預設值，支援字串、欄位、公式，預設為空。 字串：字元文字，例如：華北
欄位：資料集欄位，資料集包括範本資料集和伺服器資料集。例如：資料集 ds1 的City欄位
公式：設計器支援的公式，例如： A1 儲存格的值
| |||
| 水 印 | 填報時元件內顯示的淺灰色水印文字，手動輸入，以提示使用者需要輸入資訊，點選元件編輯區域後消失，預設為空。 | |||
| 字體大小 | 正文框中輸入字體的大小，預設為12 。 | |||
| 校驗 | 允許為空 | 是否允許元件為空值，勾選後，允許元件為空值；不勾選，填報校驗和提交時會提示，預設勾選。 | ||
| 錯誤提示 | 不勾選「允許為空」時出現的設定項，可自訂提示資訊。預設情況下將顯示：不能為空 | |||
| 填寫規則 | 元件輸入值需要符合的規則，若不符合規則，則提示錯誤資訊。 支援的校驗規則共有 3 種，如下： 1）無：不限制校驗規則。 2）長度：定義密碼輸入框的長度區間，校驗密碼長度。 3）自訂：正則表式自訂校驗規則，詳細內容參見文檔：正則表式定義規則。 預設為無 | |||
| 座標.尺寸 | 元件位置 | 元件在參數面板中的位置，透過橫縱座標調整，座標會根據元件在參數面板中的位置自動顯示。 | ||
| 元件大小 | 元件的大小，透過寬度、高度調整，若透過拖曳調整，高寬度也隨着自動調整。 | |||
2.2 事件
事件設定介面可以為元件新增事件實現某些效果，「密碼元件」支援的事件有初始化後、編輯前、編輯後、編輯結束。如下圖所示：
選擇一種事件型別後，即可新增事件內容，「密碼元件」支援的事件響應方式有 JavaScript 腳本、提交入庫、傳送郵件。如下圖所示：
選擇對應的事件響應方式新增即可，不同響應方式差別可參考：事件的響應方式
2.3 行動端
「密碼元件」支持行動端「允許一鍵清空」功能。如下圖所示：
