1. 概述
1.1 版本
| 報表伺服器版本 | 插件版本 |
|---|---|
| 11.0 | V1.0 |
1.2 應用場景
在使用者選擇下拉框或多選框時，有時需要查看字典表中的更多欄位來決定選擇的選項。當前的解決方案是透過 JS實現彈窗後資料回填 來實現，雖然可以達到類似效果，但在大量場景中使用這種方案會顯得繁瑣且耗時較久。
本文提供了一種透過安裝「聯動查詢元件插件」來實現該效果的方案。這種方案不僅簡化了操作流程，還能大大節省時間，提高效率。如下圖所示：
1.3 注意事項
1）不支援行動端。
2）不支援新前端樣式。
3）不支援元件顯示增強功能。
4）支援在參數面板和儲存格中使用，在儲存格中使用時不支援給擴展的元件賦值。
2. 插件介紹
2.1 插件安裝
點選下載插件：聯動查詢元件插件
設計器插件安裝方法參照 設計器插件管理
伺服器安裝插件方法參照 伺服器插件管理
2.2 插件使用
插件安裝完成後，新增「聯動查詢元件」，拖曳至「參數面板」即可新增該元件，如下圖所示：
2.3 元件屬性
聯動查詢元件屬性與按鈕元件屬性基本一致，詳情請參見 按鈕元件 。
新增功能如下所示：
配置項說明：
| 配置項 | 詳細介紹 |
|---|---|
| 聯動主元件名 | 填寫接收聯動查詢元件回傳值的元件名稱 |
| 聯動表配置 | 綁定元件的待選擇項，必須設定，否則元件不顯示選項，「類型設定、資料庫、模式、選擇資料庫表」設定可參考：資料字典 鍵值欄位：元件勾選後，其值傳回給「聯動主元件」的欄位 參考欄位：勾選時進行參考、輔助篩選的欄位
|
| 支援多選 | 勾選後，聯動查詢元件支援選擇多個選項 |
| 每頁記錄數 | 彈出框每頁顯示的列數，預設為10 |
彈出框高度 彈出框寬度 | 彈出框的高度和寬度，高度預設為500px，寬度預設為750px |
| 傳回字串 | 是否以字串形式將值傳回給聯動主元件 |
3. 範例
3.1 範例場景說明
我們需要查詢某個客戶的訂單詳情，並希望在查詢程式中識別同一客戶在相近時間段內的多筆訂單。
為此，我們可以透過設定聯動查詢元件，利用客戶ID和訂購時間等欄位，來篩選出所需的訂單ID。
3.2 資料准備
添加如下資料集：
訂單：SELECT * FROM S訂單
訂單&明細：SELECT * FROM S訂單,S訂單明細 WHERE S訂單.訂單ID=S訂單明細.訂單ID ${if(len(ID) == 0,"","and S訂單.訂單ID in ('" + ID + "')")}
3.3 報表設計
3.3.1 添加參數面板元件
設計參數面板如下圖所示：
1）聯動查詢元件按鈕設定如下所示：
2）下拉復選框名稱設定為ID，傳回值類型選擇字串，分隔符設定為','，如下圖所示：
3）其他元件設定此處不過多贅述。
3.3.2 設計報表主體
將對應欄位拖入儲存格A2~D2，如下圖所示：
3.4 效果查看
點擊「填報預覽」，效果如下所示：
4. 範本下載
已完成範本：關聯查詢元件.cpt
