反饋已提交

網絡繁忙

元件簡介

1. 概述

1.1 版本

報表伺服器版本功能變更
11.0

-

1.2 應用場景

在報表的具體應用中,經常使用「元件」來實現不同的功能。根據使用方式可將元件分為填報元件和參數元件兩大類,填報時使用的元件為填報元件,參數介面使用的元件為參數元件,這兩種元件的型別基本相同,只是在使用方面略微有所不同。本文整理元件相關文檔,使用者可根據本文快速尋找所需元件文檔。

注:元件事件具體介紹請參見:元件事件

2. 元件分類

元件型別詳細統計如下表所示:

注1:所有元件的「元件名稱」均不支援為空或重複。名稱要遵循規則,否則會導致範本錯誤,命名規則可參考:參數命名規則

注2:元件的「屬性」設定介面,所有輸入框型別的位置都不支援寫 HTML ,如 

元件型別

具體元件元件簡介參考文檔
參數元件/填報元件文字元件

用於填寫或者輸入短文字,一般用於暱稱、名稱、字數少且固定的內容的填寫。

文字元件
文字域元件

相比文字元件支援換行符,當使用者需要輸入或編輯較長文字時可使用該元件,比如簡歷中的工作經驗、個人特長等。

文字域元件
數字元件

可透過該元件輸入數字資訊(整數、負數、小數),當使用者想要使用數值時可以使用,比如填寫銷量,訂單數量這種場景。

數字元件
密碼元件

在輸入過程中不會直接顯示出輸入內容,一般可透過該元件輸入密碼資訊,錄入密碼。

密碼元件
按鈕元件

呈現一個按鈕形式,一般用於點選操作。給按鈕新增一些事件導致點選後可觸發某些報表操作,如點選按鈕查詢,點選按鈕提交、刪除、插入一行、展開報表等等。

按鈕元件
複選按鈕元件

一個按鈕,兩個值,勾選和不勾選,分別對應選擇與不選擇,適合用於判斷“是”、“否”選項的場景。

複選按鈕元件
單選按鈕組元件

可以有多個按鈕,每個按鈕對應一個值,在多個按鈕組成的按鈕組中選擇其中一個,適合多個選項選一個的場景,比如選擇請假型別。

單選按鈕組元件
複選按鈕組元件

可以有多個按鈕,每個按鈕對應一個值,在多個按鈕組成的按鈕組中可以選擇多個,適合多個選項選擇數可以大於 1 的場景。

複選按鈕組元件
下拉框元件

可以有多個值,展開選項後下拉選擇一個值,一般用於選擇某個選項資訊,從多個選項中選擇其中一個。

下拉框元件
下拉複選框元件

可以有多個值,展開選項後下拉可以選擇多個值,一般用於從多個選項中選擇幾個選項。

下拉複選框元件
日期元件

當使用者需要輸入一個時間,可以使用日期元件,彈出時間面板進行選擇。

日期元件
下拉樹元件

可以有多個值,展開選項後下拉選擇一個值,選項值是具有多層樹狀結構的資料。

下拉樹元件
檢視表樹元件

可以有多個值,選擇一個值,選項值是具有多層樹狀結構的資料。和下拉樹比較,選項不是下拉的,是直接呈現出來的。

檢視表樹元件
填報元件檔案元件

用於上傳附件,比如圖片,Word、PDF等附件。

檔案元件
列表元件

允許多個選項值,列表展示,可選擇其中的一個選項值。

列表元件
網頁框元件

一般用於在報表頁面中嵌入其他網頁,如報表中嵌入一個官網網頁。

網頁框元件
參數元件標籤元件

一般可以寫一些提示、標題的內容,不能輸入內容,和文字框相比沒有邊框,只有文字。

標籤元件
查詢按鈕

點選該按鈕後可查詢資料,屬性和按鈕一致,但是內建了查詢,不用自己設定查詢。

-
預定義元件

一般應用於自訂比較複雜且需要重複使用元件,自己定義一個元件,之後可以重複使用。

元件管理

3. 元件與參數的綁定方式

1)在使用參數元件時,當已經完成全局參數、範本參數或資料集參數設定後,編輯參數面板,選擇全部新增即可新增與參數綁定的參數元件,如下圖所示:

2)編輯參數面板,選擇需要的元件,設定參數元件的名稱為對應的參數名也可以完成元件與參數綁定。例如:設定範本參數為貨主地區,編輯參數面板,拖入下拉框元件,設定元件名稱為貨主地區。如下圖所示:

3)填報元件與參數綁定範例可參考:JS实现使用填报页面的控件查询 。

4. 注意事項

4.1 瀏覽器推薦

推薦使用谷歌核心瀏覽器或者高版本的ie瀏覽器,比如Google Chrome、Microsoft Edge、IE11等。對於低版本IE瀏覽器,比如IE8和IE相容模式,部分元件相關功能可能無法使用。

4.2 資料字典聯動會清空元件值

當前功能設計下,元件在觸發資料字典聯動時,會清空被聯動元件的值。


4.3 有元件值的參數面板元件在初始化時就會計算資料字典

帶有資料字典設定的參數面板元件,如果沒有預設值,則其資料字典會在點選元件觸發選項時才會計算;如果有預設值,則在元件初始化的時候就會計算資料字典。所以當資料字典的 sql 執行速度較慢的情況下,設定預設值會對範本整體載入速度有明顯影響。

4.4 文字和數字元件輸入不符合校驗規則的值後,會傳回上一次輸入值

設定了校驗規則的文字或者數字元件,當輸入值不符合規則的時候,會有相應提示,並且當前輸入值會被清空,傳回上一次輸入值。

1.gif

4.5 元件資料字典的數字丟失精度

問題描述

注:11.0.6 及之後的版本,元件的資料字典數字體別精度更加準確,不會再出現以下問題。

當元件資料字典使用的欄位型別為數字體別時,例如 bigint,有可能會出現丟失精度的問題,如圖所示:

解決方案

需要將數字體別轉為字串型別,例如下圖所示在 sql 中進行轉換。


附件列表


主題: 參數應用
已經是第一篇
已經是最後一篇
  • 有幫助
  • 沒幫助
  • 只是瀏覽
  • 圖片不清晰
  • 用語看不懂
  • 功能說明看不懂
  • 操作說明太簡單
  • 內容有錯誤
中文(繁體)

文 檔回 饋

滑鼠選中內容,快速回饋問題

滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

不再提示

10s後關閉