元件實際值和顯示值

1

版本。

2

應用場景。

1. 在我們平時對元件的使用中，避免不了需要對元件值的引用，那麼在引用元件的值時，會涉及元件實際值和顯示值，本章將介紹具體哪些元件有實際值與顯示值之分，以及使用時的差別。

3

元件（值）對比。

1. 目前除了下拉框元件、單選按鈕組元件、複選框元件、下拉複選框元件、列儲存格件、下拉樹、檢視表樹，能透過設定資料字典來定義元件的實際值和顯示值不同外，其他元件實際值和顯示值均相同。具體請參考本章第1節。本節選擇正文元件與下拉框元件進行對比展示。

1

下拉框元件。

1. 在參數面板中建立【下拉框元件】，命名為【t1】，點選【資料字典】，型別設定為【自訂】，設定實際值與顯示值，如下圖1所示。

2. 在參數面板中建立【查詢按鈕】，選擇【事件】，新增【點擊】事件，如下圖2所示。

3. JavaScript 代碼：

   var Widget = this.options.form.getWidgetByName("t1"); //在參數介面獲取元件的方法，先獲取決策報表，
   再透過元件名稱來獲取元件 
   var value_1 =Widget.getValue(); //獲取元件實際值 
   alert('我的實際值是：'+value_1); //彈出元件實際值 
   var value_2 =Widget.getText(); //獲取元件顯示值 
   alert('我的顯示值是：'+value_2); //彈出元件顯示
   

4. 效果查看，如下圖3所示；同理分別對單選按鈕組元件、複選框元件、下拉複選框元件、下拉樹元件、檢視表樹元件進行設定可得到的相同的結果。

2

文字元件。

1. 文字元件無法透過資料字典來設定顯示值與實際值，僅可透過字串、欄位、公式對元件值進行設定。如下圖1所示；

2. 在參數面板中建立【文字元件】，命名為【t1】。如下圖2所示；

3. 在參數面板中建立【查詢按鈕】，選擇【事件】，新增點選事件，參見第三章第1節中的第二步。

4. 效果查看，如下圖3所示。

1. 參數介面的元件傳遞到後臺或在儲存格直接獲取，都是元件的實際值。本節選擇正文元件與下拉框元件進行對比展示。

2. 在參數面板中新增正文元件，命名為【t1】，新增下拉框元件，命名為【t2】，如下圖1所示；

3. 在儲存格 A1 中，插入公式【$t1】，在儲存格 B1 中，插入公式【$t2】 ,如下圖2所示。

4. 效果查看，如下圖3所示。

1. 如上述所展示，通常實際值和顯示值是一一對應的關系。但是也會有不同實際值對應相同顯示值的情況，就比如企業名稱可以相同但 ID 是唯一的，ID 與名稱就構成了多對一的關系。

2. 在 10.0 版本的設計器中元件在多個實際值對應相同顯示值情況下的處理邏輯如下。

   ①直接在元件裏選值時，支援實際值和顯示多對一的情況，即由所選的顯示值得到其對應的實際值。

   ②透過傳參賦予元件值時，如果傳參是實際值，則和直接在元件裏選值的邏輯保持一緻；如果傳遞的是顯示值，則元件預設選中第一個顯示值。下面進行舉例說明。

1

參數查詢。

1. 建立一個內建資料集，如下圖1所示。

2. 在參數設定介面新增下拉框、下拉複選框、單選按鈕組、複選按鈕組、檢視表樹以及查詢按鈕，如下圖2所示。

3. 設定元件名稱，依次給元件修改名稱，這裏按順序修改為：a、b、c、d、e。例如將下拉框元件命名為【a】，如下圖3所示。

4. 修改完名稱的元件如下圖4所示。

   注：formSubmit0 為查詢按鈕元件。

5. 設定資料字典，以下拉框元件 a 舉例說明，資料字典的型別設定為資料查詢；實際值為：【學號】；顯示值為：【姓名】。如下圖5所示。

6. 下拉複選框、單選按鈕組、複選按鈕組與下拉框設定方法相同。檢視表樹則稍有不同。

   ①注意首先將【多選】勾選上。

   ②設定資料字典：構建方式選擇【極速分層構建】；資料集選擇建立好的內建資料集；實際值選擇【學號】；顯示值選擇【姓名】。如下圖6所示。

7. 設定報表主體，分別在 A2-E2 儲存格內插入公式，輸入對應的【$ 元件名】。如下圖7所示；

8. 效果查看，實際值顯示值多對一的情況下，選擇同樣的顯示值依然可以準確得出不同的實際值。此外，可手動輸入值的元件（比如下拉複選框），手動輸入了多個相同的顯示值，則跟傳參一樣元件只選中第一個顯示值。如下圖8所示。

2

傳參賦予元件值。

1. 在透過傳參賦予元件值時，如果傳參是實際值，則和直接在元件裏選值的邏輯保持一緻；如果傳遞的是顯示值，則元件預設選中第一個顯示值。

2. 依舊需要使用上一小節建立的參數查詢報表。再建立一個報表，設計報表主體，A1~E1 儲存格填入內建資料集的實際值，F1 儲存格填入內建資料集的顯示值，如下圖1所示。

3. A1~F1 儲存格新增超級連結至 四.1 使用的參數查詢報表，連結開啟於【新視窗】，參數傳遞方式選擇【GET】，如下圖2所示。

   注：設定好 A1 儲存格超連結之後可以直接複制 A1 儲存格至 B1-F1中，再修改儲存格內容為“2-5、趙一”即可。

4. 在參數中增加參數和值，使參數 1 傳遞到各個元件中，如下圖3所示。

5. A1~E1 新增超級連結的設定均如上圖所示，故在此不多做贅述。

6. 效果查看，可以看到傳遞的是顯示值【孫三】時，元件預設選中第三個顯示值。如下圖4所示。