IBM(R) WebSphere(R) Business Integration Collaborations for Healthcare 包含一組 14 種協同作業範本-「WebSphere Business Integration 醫療交易協同作業」。本文件說明如何安裝現行版本的「WebSphere Business Integration 醫療交易協同作業」,您可以從 Passport Advantage 下載。
本版的「醫療交易協同作業」是以可安裝的「電子軟體分配 (ESD)」套件提供,而不直接和 IBM WebSphere InterChange Server 4.2.1 版包裝在一起。 本文件提供了在 Microsoft(R) Windows(R) 和 AIX(R) UNIX 系統上安裝的指示。
附註:在本版中,「WebSphere Business Integration 醫療交易協同作業」在執行於 AIX 5.1 版、AIX 5.2 版或 Windows 2000 的 IBM WebSphere InterChange Server 4.2.1 版上受支援。
「IBM(R) WebSphere(R) Business Integration 醫療交易協同作業」是一套包含 14 個協同作業範本的集合 (有 8 個支援協同作業範本與 4 個範例協同作業範本),其設計目的是為了讓醫療單位及其他專業機構符合「健康資訊交換第七層協定 (Health Level Seven,HL7) 標準 2.4 版」傳訊標準。此外,它包含了超過 500 個通用商業物件,這些通用商業物件能支援建置與使用許多 HL7 訊息類型。
下列協同作業範本包含在「WebSphere Business Integration 醫療交易協同作業」中:
HL7 型協同作業範本
支援 HL7 的協同作業範本
範例協同作業範本
為了使用「WebSphere Business Integration 醫療交易協同作業」來實作一個解決方案,您可能需要參閱下列 WebSphere InterChange Server 文件中的其中一份以上 (請參閱 WebSphere Business Integration 圖書庫):
下列使用慣例用來意指目錄、名稱、ID 及密碼:
註釋 | 說明 | 範例 |
---|---|---|
<WICS> | 安裝 IBM WebSphere InterChange Server 的目錄 |
/usr/IBM/WebSphereICS 或 C:\IBM\WebSphereICS |
<WBI/Healthcare> | 安裝「WebSphere Business Integration 醫療交易協同作業」的目錄 | C:\IBM\ESD\HC |
<WICServer> | 安裝 IBM WebSphere InterChange Server 的伺服器名稱 |
wicserver |
<WICSADMINID> | IBM WebSphere InterChange Server 的管理者 ID | admin |
<WICSADMINPWD> | IBM WebSphere InterChange Server 的管理者密碼 | 空值 |
應該要正確地安裝 IBM WebSphere InterChange Server 及其必備軟體,AIX 5.1 版或 AIX 5.2 版平台的資訊記錄於「系統安裝手冊 UNIX 版」,Windows 2000 的資訊則記錄於「系統安裝手冊 Windows 版」。 必備軟體包含如下:
在遵循安裝程序之前,請確定您已從 Passport Advantage (www.lotus.com/passportadvantage) 下載您要安裝的軟體, 並已將它取出到適當的目錄中。下載指示請參閱 Passport Advantage。您必須遵循「WebSphere Business Integration 醫療交易協同作業」的 InstallShield 程序,才能繼續執行這些指示。
本節列出「WebSphere Business Integration 醫療交易協同作業」的內容。本節中所說明的所有檔案都應該解到您在 Passport Advantage InstallShield 程序中所指定的目錄內。若您尚未執行 InstallShield 安裝程序,請先執行後再繼續。
「醫療交易」檔案使用下列格式:
檔案名稱 | 說明 |
---|---|
BIA_BO_HealthCare.jar | 「IBM WebSphere Business Integration 商業物件」儲存庫檔案 |
BIA_CT_HealthCare.jar | 「IBM WebSphere Business Integration 協同作業範本」儲存庫檔案 |
BIA_ORG_HealthCare.zip | IBM WebSphere Modeler 匯入檔,包含 WebSphere MQ Workflow 模型定義 |
BIA_FDL_HealthCare.fdl | IBM WebSphere MQ Workflow FDL 檔,包含工作流程程序定義 |
BIA_Create_HLTHCARE_Databases.txt | Windows 版的 DB2 SQL 資料庫建立 script |
BIA_Create_HLTHCARE_Tables.txt | Windows 版的 DB2 SQL 表格建立 script |
BIA_Create_HLTHCARE.tar | DB2 TAR 檔,包含 Unix 的 SQL 資料庫與表格建立 script |
BIA_Demo_QTurn.zip | 範例程式碼。支援所提供範例的 QTurn 應用程式檔案 |
BIA_Demo_Support.zip | 範例程式碼。用來支援所提供範例的 QTurn 應用程式使用者輸入檔案 |
BIA_Demo_HealthCare.jar | 範例程式碼。包含四個範例協同作業的「WebSphere Business Integration 協同作業範本」儲存庫檔案 |
Healthcare_Passthru.bat | 「遵醫囑性報告」與「多層式醫囑」工作流程程序所使用的批次檔 |
BIA_PortalSample.zip | 範例程式碼。入口網站應用程式 (含原始檔),用來支援醫療範例,以便搭配 WebSphere Portal Server |
BIA_BO_X12_HealthCare.jar | 「IBM WebSphere Business Integration HIPAA 交易協同作業」通用商業物件的子集,用於「醫療電子病歷」範例 |
下表列出「WebSphere Business Integration 醫療交易協同作業」的內容:
檔案名稱 | 說明 |
---|---|
HC_QBP_Z01.cwt HC_QBP_Z01.java HC_QBP_Z01_en_US.txt |
協同作業範本檔案 |
MTQBP.xsd MQWF_QBP_Z01.xsd | 商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_RSP_Z01.cwt HC_RSP_Z01.java HC_RSP_Z01_en_US.txt |
協同作業範本檔案 |
MTRSP_Z01.xsd MQWF_RSP_Z01.xsd | 商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_OMP_O09.cwt HC_OMP_O09.java HC_OMP_O09_en_US.txt |
協同作業範本檔案 |
MQWF_OMP_O09.xsd MTOMP.xsd |
商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_ORP_O10.cwt HC_ORP_O10.java HC_ORP_O10_en_US.txt |
協同作業範本檔案 |
MTORP.xsd MQWF_ORP_O10.xsd |
商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_QRY_A19.cwt HC_QRY_A19.java HC_QRY_A19_en_US.txt |
協同作業範本檔案 |
MQWF_QRY_A19.xsd MTQRY.xsd |
商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_ADR_A19.cwt HC_ADR_A19.java HC_ADR_A19_en_US.txt |
協同作業範本檔案 |
MTADR.xsd MQWF_ADR_A19.xsd MTADR_action.xsd |
商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_OMG_O19.cwt HC_OMG_O19.java HC_OMG_O19_en_US.txt |
協同作業範本檔案 |
MQWF_OMG_O19.xsd MTOMG.xsd |
商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_ORG_O20.cwt HC_ORG_O20.java HC_ORG_O20_en_US.txt |
協同作業範本檔案 |
MTORG.xsd MQWF_ORG_O20.xsd |
商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_QBP_Z02.cwt HC_QBP_Z02.java HC_QBP_Z02_en_US.txt |
協同作業範本檔案 |
MQWF_QBP_Z02.xsd MTQBP.xsd | 商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_RSP_Z02.cwt HC_RSP_Z02.java HC_RSP_Z02_en_US.txt |
協同作業範本檔案 |
MTRSP_Z02.xsd MQWF_RSP_Z02.xsd | 商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_SRM_Resource.cwt HC_SRM_Resource.java HC_SRM_Resource_en_US.txt |
協同作業範本檔案 |
MQWF_SRM_Resource.xsd MTSRM.xsd |
商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_SRM_Service.cwt HC_SRM_Service.java HC_SRM_Service_en_US.txt |
協同作業範本檔案 |
MQWF_SRM_Service.xsd MTSRM.xsd |
商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_SRR.cwt HC_SRR.java HC_SRR_en_US.txt |
協同作業範本檔案 |
MTSRR.xsd MQWF_SRR.xsd |
商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_ACK.cwt HC_ACK.java HC_ACK_en_US.txt |
協同作業範本檔案 |
MTACK.xsd | 商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_Z01_Email.cwt HC_Z01_Email.java HC_Z01_Email_en_US.txt |
協同作業範本檔案 |
MQWF_Z01_Email.xsd | 商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_SaveOrder.cwt HC_SaveOrder.java HC_SaveOrder_en_US.txt |
協同作業範本檔案 |
EMR_UPDATE.xsd X12_A1_270.xsd |
商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_271RSP.cwt HC_271RSP.java HC_271RSP_en_US.txt |
協同作業範本檔案 |
X12_A1_271.xsd MQWF_EMR.xsd EMR_Struct_OMP_Email.xsd | 商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_EMR_Email.cwt HC_EMR_Email.java HC_EMR_Email_en_US.txt |
協同作業範本檔案 |
EMR_Struct_OMP_Email.xsd | 商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_EMR_Alert.cwt HC_EMR_Alert.java HC_EMR_Alert_en_US.txt |
協同作業範本檔案 |
MQWF_OMP_Alert.xsd OMP_EMR_ALERT.xsd |
商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_GetTask.cwt HC_GetTask.java HC_GetTask_en_US.txt |
協同作業範本檔案 |
MQWF_HC_GetTask.xsd MQWF_HC_GetTaskResponse.xsd | 商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_EMR_Update.cwt HC_EMR_Update.java HC_EMR_Update_en_US.txt |
協同作業範本檔案 |
MQWF_OMP_UpdateEMR.xsd MQWF_UpdateEMR.xsd |
商業物件檔 |
檔案名稱 | 說明 |
---|---|
HC_OMP_Email.cwt HC_OMP_Email.java HC_OMP_Email_en_US.txt |
協同作業範本檔案 |
MQWF_OMP_Email.xsd | 商業物件檔 |
下表列出範例協同作業範本中所包括的檔案:
檔案名稱 | 說明 |
---|---|
HCDemo_Notify.cwt HCDemo_Notify.java HCDemo_Notify_en_US.txt |
協同作業範本檔案 |
MTADR_action.xsd HCDemo_Notify_xml.xsd |
商業物件檔 |
檔案名稱 | 說明 |
---|---|
HCDemo_SRM_Resource.cwt HCDemo_SRM_Resource.java HCDemo_SRM_Resource_en_US.txt |
協同作業範本檔案 |
MTSRM.xsd MTSRM_Resource_Schedule.xsd MTSRM_Resource_Cancel.xsd |
商業物件檔 |
檔案名稱 | 說明 |
---|---|
HCDemo_SRM_Service.cwt HCDemo_SRM_Service.java HCDemo_SRM_Service_en_US.txt |
協同作業範本檔案 |
MTSRM.xsd MTSRM_Service_Schedule.xsd MTSRM_Service_Cancel.xsd |
商業物件檔 |
檔案名稱 | 說明 |
---|---|
HCDemo_Alert.cwt HCDemo_Alert.java HCDemo_Alert_en_US.txt |
協同作業範本檔案 |
OMP_EMR_ALERT.xsd | 商業物件檔 |
若要安裝「IBM WebSphere Business Integration 醫療交易協同作業」,請完成下列步驟:
fmcibie -iC:\IBM\ESD\HC\BIA_FDL_HealthCare.fdl -uADMIN -ppassword -o -t -l -f
若要建立協同作業物件,請完成下列步驟:
若要配置「醫療配接器」,以搭配「WebSphere Business Integration 醫療交易協同作業」使用, 請完成下列步驟:
名稱 | 類型 | 應用程式規格資訊 |
---|---|---|
MTQBP_Create | 字串 | OutputQueue=queue:// HOSTNAME.queue.manager/HCQBP |
MTOMP_Create | 字串 | OutputQueue=queue:// HOSTNAME.queue.manager/HCOMP |
MTSRM_Resource_Cancel_Create | 字串 | OutputQueue=queue:// HOSTNAME.queue.manager/HCSRMRC |
MTSRM_Resource_Schedule_Create | 字串 | OutputQueue=queue:// HOSTNAME.queue.manager/HCSRMRS |
MTSRM_Service_Schedule_Create | 字串 | OutputQueue=queue:// HOSTNAME.queue.manager/HCSRMSS |
MTSRM_Service_Cancel_Create | 字串 | OutputQueue=queue:// HOSTNAME.queue.manager/HCSRMSC |
MTOMG_Create | 字串 | OutputQueue=queue:// HOSTNAME.queue.manager/HCOMG |
MTQRY_Create | 字串 | OutputQueue=queue:// HOSTNAME.queue.manager/HCQRY |
名稱 | 類型 | 預設值 |
---|---|---|
ClassName | 字串 | com.ibm.adapters.datahandlers. hl7.HL7DataHandler |
BOPrefix | 字串 | HL7 |
Representation | 字串 | native |
FieldDelimiter | 字串 | | |
ComponentDelimiter | 字串 | ^ |
RepetitionDelimiter | 字串 | ~ |
EscapeDelimiter | 字串 | \ |
SubcomponentDelimiter | 字串 | & |
MTEventMap | 字串 |
file=C:\IBM\WebSphereICS\connectors\Healthcare\ dependencies\hl7\BIA_HL7MTEventMap.cfg |
I18N | 字串 |
file=C:\IBM\WebSphereICS\connectors\Healthcare\ dependencies\hl7\BIA_HL7I18N.cfg |
DummyKey | 字串 | dummy |
DefaultVerb | 字串 | Create |
EnableStackTrace | 字串 | true |
事件碼及對應的商業物件 |
---|
Event=Z01 ; MT=RSP ; BOName=MTRSP_Z01 |
Event=Z02 ; MT=RSP ; BOName=MTRSP_Z02 |
Event=S01 ; MT=SRR ; BOName=MTSRR |
Event=S04 ; MT=SRR ; BOName=MTSRR |
Event=A19 ; MT=ADR ; BOName=MTADR |
Event=O10 ; MT=ORP ; BOName=MTORP |
Event=O20 ; MT=ORG ; BOName=MTORG |
Event=O09 ; MT=OMP ; BOName=MTOMP |
內容 | 值 |
---|---|
AgentConnections | 0 |
AgentTraceLevel | 1 |
ApplicationName | HealthcareConnector |
BrokerType | ICS |
CharacterEncoding | ascii7 |
ConcurrentEventTriggeredFlows | 5 |
ControllerStoreAndForwardMode | true |
ControllerTraceLevel | 0 |
DeliveryTransport | MQ |
JvmMaxHeapSize | 128m |
JvmMaxNativeStackSize | 128k |
JvmMinHeapSize | 1m |
Locale | en_US |
LogAtInterchangeEnd | False |
MaxEventCapacity | 2,147,483,647 |
MessageFileName | BIA_HealthcareConnector.txt |
OADAutoRestartAgent | false |
OADMaxNumRetry | 1000 |
OADRetryTimeInterval | 10 |
PollEndTime | HH:MM |
PollFrequency | 2000 |
PollStartTime | HH:MM |
RepositoryDirectory | <REMOTE> |
RestartRetryCount | 3 |
RestartRetryInterval | 1 |
WireFormat | CwBO |
內容 | 值 |
---|---|
ApplicationUserName | |
LogFileName | STDOUT |
ArchiveQueue | queue://HOSTNAME.queue.manager/ MQCONNHC.ARCHIVE |
Channel | CHANNEL1 |
InputQueue | queue://HOSTNAME.queue.manager/ MQCONNHC.IN?targetClient=1 |
Port | HOSTNAME.queue.manager 埠號 |
DataHandlerConfigMO | BIA_MO_DataHandler_Healthcare |
DataHandlerMimeType | hl7 |
ReplyToQueue | queue://HOSTNAME.queue.manager/ MQCONNHC.REPLY?targetClient=1 |
DataHandlerClassName | com.ibm.adapters.datahandlers. hl7.HL7DataHandler |
InProgressQueue | queue://HOSTNAME.queue.manager/ MQCONNHC.IN_PROGRESS |
HostName | 系統主機名稱 |
ConfigurationMetaObject | BIA_STATIC_MO_HL7 |
ErrorQueue | queue://HOSTNAME.queue.manager/ MQCONNHC.ERROR |
ApplicationPassword | |
UnsubscribedQueue | queue://HOSTNAME.queue.manager/ MQCONNHC.UNSUBSCRIBED |
TraceFileName | STDOUT |
InDoubtEvents | Reprocess |
PollQuantity | 5 |
若要配置「WebSphere MQ Workflow 配接器」,以搭配「WebSphere Business Integration 醫療交易協同作業」使用, 請完成下列步驟:
內容 | 值 |
---|---|
AgentConnections | 0 |
AgentTraceLevel | 1 |
ApplicationName | WebSphereMQWorkflowConnector |
BrokerType | ICS |
CharacterEncoding | ascii7 |
ConcurrentEventTriggeredFlows | 5 |
ControllerStoreAndForwardMode | true |
ControllerTraceLevel | 0 |
DeliveryTransport | MQ |
JvmMaxHeapSize | 128m |
JvmMaxNativeStackSize | 128k |
JvmMinHeapSize | 1m |
Locale | en_US |
LogAtInterchangeEnd | False |
MaxEventCapacity | 2,147,483,647 |
MessageFileName | WebSphereMQWorkflowConnector.txt |
OADAutoRestartAgent | false |
OADMaxNumRetry | 1000 |
OADRetryTimeInterval | 10 |
PollEndTime | HH:MM |
PollFrequency | 2000 |
PollStartTime | HH:MM |
RepositoryDirectory | <REMOTE> |
RestartRetryCount | 3 |
RestartRetryInterval | 1 |
WireFormat | CwBO |
內容 | 值 |
---|---|
MQSeriesChannel | FMCQM.CL.TCP |
BOPrefix | MQWF_ |
WorkflowSystemName | FMCSYS |
MQSeriesAPITraceLevel | 0 |
MQSeriesHostName | 您的系統主機名稱 |
MQSeriesQueueManager | FMCQM |
ReplyToQueue | MQWFCONN.REPLY |
MQSeriesCCSID | |
JavaCorbaApi | false |
UnsubscribedQueue | MQWFCONN.UNSUBSCRIBED |
WorkflowAgentName | |
InDoubtEvents | Reprocess |
MQSeriesAPITraceFileName | STDOUT |
InProgressQueue | MQWFCONN.IN_PROGRESS |
DataHandlerConfigMO | MO_DataHandler_Default |
ArchiveQueue | MQWFCONN.ARCHIVE |
MQSeriesPort | 5010 |
DataHandlerMimeType | text/xml |
OutputQueue | FMC.FMCGRP.EXE.XML |
WorkflowAgentLocatorPolicy | LOC |
ErrorQueue | MQWFCONN.ERROR |
WorkflowSystemGroup | FMCGRP |
InputQueue | CWLDINPUTQ |
DataHandlerClassName | com.crossworlds.DataHandlers.text.xml |
ApplicationUserID | |
ApplicationPassword | |
PollQuantity | 5 |
注意事項:
大部分的協同作業都使用資料庫連線儲存池。如需建立連線儲存池的指示,請參閱 WebSphere InterChange Server 系統管理手冊。 請務必使用適當的使用者 ID 及密碼來定義資料庫連線儲存池。連線儲存池中定義的使用者 ID 應該與建立 HEALTHCARE_DB 資料庫和表格時的 ID 相同。 請注意,協同作業使用的預設連線儲存池名稱是 HEALTHCARE_DB。
下表顯示配置範例:
欄位名稱 | 值 |
---|---|
資料庫驅動程式 | 範例:DB2 (第二類型) |
資料庫連線名稱 | 範例:HLTHCAREDB |
主機名稱 | |
登入 | 現有的有效使用者 ID |
資料庫 | HLTHCARE |
密碼 | 有效的登入密碼 |
埠號 | |
最大連線數 | 至少 1 (若無限制) |
新的連線儲存池 | HEALTHCARE_DB |
最小連線數 | 1 |
若為「電子病歷」範例,則也需要 HIPAADB 資料庫連線定義。 如需建立此資料庫連線儲存池及 HIPAADB 資料庫的相關資訊,請參閱 Installing the HIPAA solution,位於 WebSphere Business Integration for HIPAA 產業解決方案文件。
針對每一個支援的作業系統,「醫療交易」提供了兩個 script 來幫助您設定資料庫及表格。這些 script 會設定 HLTHCARE 資料庫,這個資料庫由各種協同作業物件用來保留特定的狀態資料。
若要在 Windows 環境中建立資料庫及表格,請完成下列步驟:
db2 < BIA_Create_HLTHCARE_Database.txt
db2 < BIA_Create_HLTHCARE_Tables.txt
若要在 AIX 環境中建立資料庫及表格,請完成下列步驟:
tar -xvf BIA_Create_HLTHCARE.tar
db2 < BIA_Create_HLTHCARE_Database
db2 < BIA_Create_HLTHCARE_Tables
注意事項:
請務必將下列每一個「醫療交易」元件都部署至 WebSphere InterChange Server: