Skip to main content
FHIR 端口允許你透過推送或拉取 FHIR 中的資料,將 FHIR 整合到工作流程中。

核心功能

  • 支援快速醫療保健互操作性資源(FHIR)標準,用於合規的醫療資料交換
  • 整合 RESTful API 與醫療特定的資料格式,處理患者記錄、觀察結果和臨床資料
  • 支援標準資料庫操作(Select、Lookup、Upsert 和預存程序)以進行資料操作
按照以下步驟將 連線到 FHIR。

建立連線

允許 端口從 FHIR 資料庫中使用資料,首先需要建立一個到 FHIR 的連線。有以下兩種方式:
  • 新增一個 FHIR 端口到工作流程中,然後點選連線下拉框旁邊的建立按鈕。
  • 開啟 系統設定頁面,然後開啟連線索引標籤。點選建立,選擇 FHIR 並下一步建立。
  • 這僅僅是第一次建立的時候需要。
  • 到 FHIR 的連線可以被多個端口重複利用。

輸入連線配置

在開啟的連線配置對話方塊,進行如下步驟:
  1. 提供需要的資訊:
    • 名稱 — 連線的名稱。填一個期望的值。
    • 型別 — 預設設定為 FHIR。
    • Connection Type — 你要使用的 FHIR API 實現。選項有 Generic(用於 FHIR API 的任何自定義實現)、Azure、AWS 和 Google。
    • Auth Scheme — 用於連線的身分驗證方案。選項有 None(預設選項)、OAUTH、Azure AD 和 AwsRootKeys。
    • URL — 要使用的 FHIR 伺服器的 URL。
  2. 根據你選擇的身分驗證方案建立連線:
    • None — 不使用任何身分驗證。
    • OAUTH — 輸入你的 OAuth 用戶端 ID 和 OAuth 用戶端密碼。
    • AzureAD — 輸入你的 OAuth 用戶端 ID 和 OAuth 用戶端密碼。
    • AwsRootKeys — 輸入你的 AWS 存取金鑰和 AWS 金鑰。
  3. 如果需要,點選高階來開啟高階配置。這在大多數情況下不需要。
  4. 點選連線來確保這個連線可以正常連線到 FHIR 伺服器。如果發生錯誤,請再次排查。
  5. 點選建立連線來儲存連線。
  6. 在連線下拉選單中選擇剛剛建立的連線。
  7. 點選儲存變更。

選擇一個操作

與 FHIR 建立連線後,你必須選擇 FHIR 端口將執行的操作。下表概觀了每個操作及其在 工作流程中的所屬位置。

進階選項卡

高階索引標籤上的許多設定是從你正在使用的資料來源動態載入的,因此本文件不對其進行說明。你可以在我們網站的線上幫助檔案頁面上找到適用於你的資料來源的詳細資訊。 以下描述的選項適用於所有資料來源。

訊息

儲存至 Sent 資料夾和Sent 資料夾方案設定已棄用,預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本,請在工作流程中右鍵單擊該端口,選擇顯示成功路徑,然後將成功路徑連線到File 端口。

進階設定

進階設定 是依賴任意資料庫驅動(例如 Database、CData 和 API 端口)連線到各種資料來源的端口的通用設定。

其他設定

其他設定 適用於特定使用場景。

代理設定

自動化索引標籤

自動化設定

與端口自動處理檔案相關的設定。

效能

與端口資源分配相關的設定。

告警索引標籤

與配置告警相關的設定。 在執行服務級別協議(SLA)之前,你需要設定電子郵件告警通知。預設情況下, 使用告警索引標籤上的全域設定。若要為此端口使用其他設定,請開啟覆蓋全域設定。 預設情況下,錯誤告警已啟用,這意味著每當發生錯誤時都會傳送電子郵件。若要關閉,請取消選中啟用核取方塊。 輸入主題(必填),然後可選填入以逗號分隔的收件人電子郵件清單。

SLA 索引標籤

與配置服務級別協議(SLA)相關的設定。 SLA 允許你配置期望工作流程中端口傳送或接收的資料量,並設定期望在該時間範圍內滿足該資料量。 會在 SLA 未滿足時傳送電子郵件警告使用者,並將 SLA 標記為_風險中_,表示如果 SLA 不久內仍未滿足,將被標記為_已違反_。這給使用者一個機會介入,確定 SLA 未滿足的原因,並採取適當的行動。如果 SLA 在風險期結束時仍未滿足,SLA 將被標記為已違反,並再次通知使用者。 要定義 SLA,開啟預期資料量,然後點選設定索引標籤。 空 SLA 配置
  • 如果你的端口具有單獨的傳送和接收操作,請使用選項按鈕指定 SLA 涉及的方向。
  • 在視窗的至少預期部分:
    • 設定你期望處理的最小交易數(資料量)
    • 使用每欄位指定時間範圍
    • 指示 SLA 何時生效。如果選擇從…開始,請填寫日期和時間欄位。
    • 勾選你希望 SLA 生效的星期幾的核取方塊。如有必要,使用下拉功能表選擇每天。
  • 在視窗的**設定狀態為”風險中”**部分,指定 SLA 何時應標記為風險中。
    • 預設情況下,在 SLA 違反之前不會傳送通知。若要更改此設定,勾選傳送”風險中”通知。
以下範例顯示了一個為端口配置的 SLA,該端口預計每天週一至週五接收 1000 個檔案。如果在時間段結束前 1 小時仍未收到 1000 個檔案,則傳送風險通知。 SLA 配置範例
如有必要,你可以關閉 SLA 告警。這在維護視窗期間很有用。在導覽列中點選設定,然後導航到告警 > 常規告警。點選鉛筆圖示進行編輯,並取消勾選 SLA 告警設定。

宏

在檔案命名策略中使用宏可以提升組織效率並加深對資料的瞭解。透過在檔名中融入宏,你可以動態包含識別碼、時間戳和訊息頭資訊等相關資訊,為每個檔案提供有價值的上下文。這有助於確保檔名反映對你的組織重要的詳細資訊。 支援以下宏,所有宏均使用以下語法:%Macro%。

範例

有些宏(如 %Ext% 和 %ShortDate%)不需要參數,而其他宏需要參數。所有帶參數的宏均使用以下語法:%Macro:argument% 以下是一些帶參數的宏範例:
  • %Header:headername%:其中 headername 是訊息上訊息頭的名稱。
  • %Header:mycustomheader% 解析為輸入訊息上設定的 mycustomheader 訊息頭的值。
  • %Header:ponum% 解析為輸入訊息上設定的 ponum 訊息頭的值。
  • %RegexFilename:pattern%:其中 pattern 是規則運算式模式。例如,%RegexFilename:^([\w][A-Za-z]+)% 匹配並解析為檔名中的第一個詞(不區分大小寫,test_file.xml 解析為 test)。
  • %Vault:vaultitem%:其中 vaultitem 是保險庫中某個專案的名稱。例如,%Vault:companyname% 解析為保險庫中儲存的 companyname 專案的值。
  • %DateFormat:format%:其中 format 是接受的日期格式(詳情請參見日期格式範例)。例如,%DateFormat:yyyy-MM-dd-HH-mm-ss-fff% 解析為檔案的日期和時間戳。
你還可以建立更復雜的宏,如以下範例所示:
  • 在一個檔名中組合多個宏:%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%%EXT%
  • 在宏外部包含文字:MyFile_%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%
  • 在宏內部包含文字:%DateFormat:'DateProcessed-'yyyy-MM-dd_'TimeProcessed-'HH-mm-ss%