# 函數(巨集專用)
FunctionComment
APPLYPRESETBYNAME(presetName)依預設名稱 presetName 帶入 表單預設 內容。表單預設設定方式請參考 門診結構化2.0 >填寫表單 > 表單預設。
CUSTOMFUNC("customFunction1", "arg1", "arg2"...)呼叫 customFunc('customFunction1', '參數1', '參數2'...)，請自行在表單選項中的 javasacript 區塊定義 customFunction1。
HISQUERY("id, queryString; id2, queryString2...")

手動執行HIS函數查詢，
1. 沒有參數時，會依照表單計算示控制項中的 HIS函數設定，手動帶回HIS資料。
ex: HISQUERY()
2. 設定參數時，會依照 queryString 條件 (參見 HIS 參照函數 說明)，手動帶回HIS資料到 控制項 id。

HISquery("id1,query1;id2,query2...");

HISquery("1,OPDDATA.InDays(180).GetLatestString()")

LLMQUERY(id, prompt, model)大語言函數，僅能在巨集按鈕控制項中使用，使用 prompt 呼叫 醫院推論中心的 LLM api，並將回應指定到 id 控制項:
[id]: LLM 呼叫結果回傳控制項ID
[prompt]: LLM 呼叫的提示詞。
(model): LLM模型語言偏好，項目選填，預設為英文，中文請指定 "tw"。
LOADDOC()從結構化倉儲取出目前收件號最近一次存檔的表單以及內容。
LOADXML()從結構化倉儲取出目前收件號現況表單的最近一次存檔內容。
LOOKUPDEFAULTSETTING(req, condition, duration)設定表單預設查詢倉儲條件，於 表單開啟時 自動查詢帶入資料，參數定義:
[req]: 映射參數 "dicName1:fieldID1; dicName2:fieldID2..." ，其中 dicName 為屬性名稱，fieldID 為應對表單ID (required)。
[condition]: 條件參數 "opdno:null;sheetid:nurse;recType:ACER;recNo:0025302" 用來指定 metadata 條件 (option)
[duration] 查詢日數 30, 0.5 (day, default 7 days) 用來指定資料查詢日數 (option)
LOOKUPDW(req, condition, duration)設定表單按須查詢倉儲條件，於 巨集執行時 自動查詢帶入資料，參數定義:
[req]: 映射參數 "dicName1:fieldID1; dicName2:fieldID2..." ，其中 dicName 為屬性名稱，fieldID 為應對表單ID (required)。
[condition]: 條件參數 "opdno:null;sheetid:nurse;recType:ACER;recNo:0025302" 用來指定 metadata 條件 (option)
[duration] 查詢日數 30, 0.5 (day, default 7 days) 用來指定資料查詢日數 (option)
LOOKUPIOT(sheetid, recType, recNo, req)

設定IOT查詢條件，於 巨集執行時 自動查詢帶入資料，參數定義:

[sheetid]: 廠商/IOT名稱 (required)

[recType]: 資料子集名稱 (required)
[recNo]: 廠商IOT資料序號 (required)
[req]: 映射參數 (required)

MACRO(id, formula)執行 formula 函式，並將結果放到 itemid = id 的控制項
OPENURL(urlstring)打開指定網址，例如 UpToDate，或是癌或是癌症指引等。
[urlstring]: 網址，例如 "HTTPS://google.com/"
SAVEDOC(option)儲存目前表單內到結構化倉儲。
option: 'overwrite' 覆寫目前這筆紀錄 (預設值)
option: 'new' 新增一筆紀錄;
SETDICTATIONBYID(id)將 語音筆記小助手 的暫存資料，引入欄位 id。
SETIOTHEADER(sheetid, recType, recNo, status, user)用來設定IOT header，HIS會預先帶入 病歷號，收件號，科部代號資料進 header，其他資料可通過這個function 設定
SETVALUEBYID(id,val)將內容 val 帶入 id的欄位。
{% hint style="warning" %} 說明中提到的 巨集專用函數 ( 包括倉儲，巨集，大語言函數等)，可利用 [巨集按鈕控制項](https://cgmh-kj.gitbook.io/strucmed/biao-dan-bian-ji/jin-jie-kong-zhi-xiang/ju-ji-an-niu-kong-zhi-xiang)，按需執行，無法使用在計算式控制項。 {% endhint %}