# 字典選項 Dictionary option

## 字典新增與編輯

* **新增字典**：字典可透過 [字典管理](https://cgmh-kj.gitbook.io/strucmed/biao-dan-gong-ju/zi-dian-guan-li-zhi-nan) 新增編輯。
* **自動建立**：在匯入外部舊表單或是增加控制項的過程中，也可以自動建立字典。
* **綁定字典**：建立後的字典可以綁定到表單內的控制項，使得控制項內的資料以結構化形式匯入資料倉儲管理，參見下一步驟。

## 綁定字典的步驟

1. **新增字典**：首先，在相應界面上新增字典，參見上一步驟。
2. **控制項添加**：編輯表單時添加控制項，並點擊控制項打開選項。
3. **進行綁定**：點擊字典設定旁的"向下展開"圖示，進行控制項字典綁定。

<figure><img src="https://1792893123-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdwFoogk3W80yJlNR060h%2Fuploads%2Fd1XloqG9Dtndw8k4ZYWS%2F2024-01-28_dic.gif?alt=media&#x26;token=768ae890-04eb-42fe-8da1-61144ffe2830" alt=""><figcaption><p>字典綁定示範 (GIF)</p></figcaption></figure>

### 字典下拉選單功能

* 支持自動完成（Autocomplete）功能，可以輸入字典類別、科部代號進行進一步篩選，提升查找效率。
* 從下拉選單選擇或自行輸入字典後，點擊"Link to ID"進行綁定。

<figure><img src="https://1792893123-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdwFoogk3W80yJlNR060h%2Fuploads%2FqYFS52HikjPHzsWEoNoY%2Fdic2.jpg?alt=media&#x26;token=4f461bc7-1ea7-4473-b430-c0ae6f2b9c94" alt=""><figcaption><p>設定字典屬性</p></figcaption></figure>

### **新增刪除字典綁定**

* **新增字典**：如果新增的字典名稱不在字典資料庫中，"new"按鈕會出現讓使用者新增並自動綁定ID。
* **刪除字典綁定**：要解除字典綁定，進入字典選項並清除內容，點擊"Clear ID"按鈕即可。

<figure><img src="https://1792893123-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdwFoogk3W80yJlNR060h%2Fuploads%2FaV6Ib54LhcRBB9t5xGfa%2F2024-01-28_newdic.gif?alt=media&#x26;token=e045473a-06ce-465e-b190-1e819b1115ba" alt=""><figcaption><p><strong>新增字典</strong></p></figcaption></figure>

<figure><img src="https://1792893123-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdwFoogk3W80yJlNR060h%2Fuploads%2FHDzhsTHyybTvlULHGIvL%2F2023-10-30_00-06-17.jpg?alt=media&#x26;token=466e9ca2-2a17-4c01-9bcb-1cbbeabf9e0d" alt=""><figcaption><p><strong>刪除字典綁定</strong></p></figcaption></figure>

### 字典角色選擇

在綁定字典後，可以設定字典與表單的互動關係，如僅讀取、僅寫入或可讀寫。

1. 無: 單純定義字典名稱，可提供 HIS 函數調用。
2. 僅寫入: 將欄位資料在表單存檔時自動寫入倉儲。
3. 僅讀取: 表單開啟時讀取該字典在倉儲的資料。
4. 可讀寫: 讓表單開啟跟存檔時，分別進行讀取跟寫入倉儲的動作。

<figure><img src="https://1792893123-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdwFoogk3W80yJlNR060h%2Fuploads%2FwYETd8tBMEXAn7UPZOnZ%2Fdict_option4.jpg?alt=media&#x26;token=82eae916-5e23-47ba-95a3-52ec19305460" alt=""><figcaption><p>設定字典讀寫屬性</p></figcaption></figure>

綁定字典後，表單編輯器上的控制項顏色會依照字典的角色給出相應的顏色，可讀取為藍色，可寫入為綠色，可讀寫為橘色，無則顯示為白色。

<figure><img src="https://1792893123-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdwFoogk3W80yJlNR060h%2Fuploads%2FsnEVeymWylWi1WkhD6D6%2Fdic5.jpg?alt=media&#x26;token=1c4e7749-501c-491b-ac52-a16f1d78459e" alt=""><figcaption><p>綁定字典角色</p></figcaption></figure>
