元件實際值和顯示值

1.1 版本

1.2 功能入口

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

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

3）例如，為下拉框元件設定資料字典，如下圖所示：

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

例如，設定下拉框元件的實際值為 英文簡稱 ，顯示值為 銷售員 ，如下圖所示：

當選擇顯示值銷售員時，傳遞的為實際值英文簡稱，如下圖所示：

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

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

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

注：一個顯示值對應多個實際值時，傳遞值時同樣傳遞實際值，按順序對應，不會合並。

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

如果實際值和顯示值不一一對應：

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

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

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

3.1 建立範本

建立普通報表，如下圖所示：

3.2 建立資料庫查詢

建立資料庫查詢 ds1，輸入SQL 語句：SELECT * FROM 銷量 where 英文簡稱 = '${sale}'，如下圖所示：

3.3 參數綁定元件

進入參數面板編輯介面，將 sale 參數新增到參數面板，綁定下拉框元件。如下圖所示：

3.4 設定資料字典

選中下拉框元件，設定資料字典，類型設定為資料庫表，資料庫為 FRDemo ，資料庫表為 銷量 ，實際值為 英文簡稱，顯示值為 銷售員 ，如下圖所示：

3.5 設計報表

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

3.6 效果預覽

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

點選下載已完成範本：元件實際值與顯示值.cpt

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