元件實際值和顯示值

1.1 版本

1.2 功能簡介

元件應用中，當原始資料中儲存的欄位不適宜展現在報表上；或需要根據不同的原始資料在報表中顯示不同的值時，部分元件支援透過使用資料字典功能將實際值和顯示值做巧妙變換。如下圖所示：

支援資料字典功能，有實際值和顯示值區分的元件如下表所示：

那在使用中，這部分元件傳值和引用值的程式中，傳的是實際值，還是顯示值呢？本章將具體介紹這些有實際值與顯示值區分的元件，在使用時的傳值邏輯。

1）元件綁定資料字典，傳值的時候傳的都是實際值；顯示值只是用來顯示，傳值的時候不會被傳遞。如下圖所示。

2）參數和元件綁定，透過$參數名（元件名），獲取到的值也是實際值，不是顯示值。如下圖所示：

3）通常實際值和顯示值是一一對應的關係，但也會存在不一一對應的情況，即多個顯示值對應一個實際值；多個實際值對應多個顯示值。

• 一個實際值對應多個顯示值時，元件會列表展示所有的顯示值，不會將同樣的值合併。如下圖所示：

• 一個顯示值對應多個實際值時，元件會將所有顯示值顯示出來。如下圖所示：

傳遞值時都會傳遞實際值，按順序對應，不會合並。

4）元件預設值處可以填寫顯示值，也可以填寫實際值。填寫顯示值也可以匹配到選項，但傳遞值時傳遞的依舊是實際值。

如果實際值和顯示值不一一對應，情況如下圖所示：

• 元件值處寫入顯示值，這個顯示值對應多個實際值：傳值時，將會按順序傳遞第一個實際值。

• 元件值處寫入實際值，這個實際值對應多個顯示值：顯示時，單選情況下只會選中第一個顯示值。

範例完成一個實際值和顯示值不一樣的查詢範本，示範實際值和顯示值不一樣時，值的傳輸規則。

3.1 建立資料集

建立範本，建立資料集 ds1,SQL 語句為：SELECT * FROM 銷量 where 英文簡稱 = '${sale}'，如下圖所示：

銷量表如下圖所示：

3.2 新增參數元件

點選參數面板，將 sale 參數新增到參數面板，元件選擇「下拉框」元件。如下圖所示：

3.3 綁定資料字典

點選「下拉框」元件，為其綁定資料字典，實際值和預設值選擇銷量表不同的資料列。如下圖所示：

3.4 設計報表

設計報表，在 A1 儲存格中輸入公式 $sale 。如下圖所示：

3.5 效果預覽

儲存範本，點選「分頁預覽」，如下圖所示，元件選項顯示銷售員的名稱，但實際傳遞的值為英文簡稱。

元件實際值與顯示值常見問題及解決方案可參考：元件實際值與顯示值常見問題