GEHealthcare
MUSE™CardiologyInformationSystem
CCGMaster-PatientIndexServerConguration
SoftwareVersionCCGv9.2
2076576-008RevisionA
English
© 2014GeneralElectricCompany.
AllRightsReserved.
PublicationInformation
TheinformationinthismanualappliesonlytotheMUSESystemVersion8.0.Itdoesnotapplytoearlierproductversions.Duetocontinuing
productinnovation,specicationsinthismanualaresubjecttochangewithoutnotice.
MUSEandMACaretrademarksownedbyGEMedicalSystemsInformationTechnologies,Inc.,aGeneralElectricCompanygoingtomarket
asGEHealthcare.Allothertrademarkscontainedhereinarethepropertyoftheirrespectiveowners.
Thisproductcomplieswiththerequirementsconcerningmedicaldevicesfromthefollowingregulatorybodies:
Thedocumentpartnumberandrevisionareatthebottomofeachpage.Therevisionidentiesthedocument’supdatelevel.Therevision
historyofthisdocumentissummarizedinthefollowingtable.
Revision
A
ToaccessotherGEHealthcareDiagnosticCardiologymanuals,gototheCommonDocumentationLibrary(CDL),locatedat
http://www.gehealthcare.com/usen/service/biomed_tech_selfservice/services_user_doc/products/support.html
ToaccessOriginalEquipmentManufacturer(OEM)manuals,gotothedevicemanufacturer'sWebsite.
Date
25February2014 Customerrelease.
Comments
,andclickCardiology.
ServiceManualLanguageInformation
WARNING
(EN)
ПРЕДУПРЕЖДЕНИЕ
(BG)
警告
ZH-CN
警告
(ZH-TW)
ThisservicemanualisavailableinEnglishonly.
•Ifacustomer'sserviceproviderrequiresalanguageotherthanEnglish,itisthecustomer's
responsibilitytoprovidetranslationservices.
•Donotattempttoservicetheequipmentunlessthisservicemanualhasbeenconsulted
andisunderstood.
•Failuretoheedthiswarningmayresultininjurytotheserviceprovider ,operator ,orpatient,
fromelectricshock,mechanicalorotherhazards.
Товаупътванезаработаеналичносамонаанглийскиезик.
•Акодоставчикътнауслугатанаклиентаизискадругезик,задължениенаклиентае
даосигурипревод.
•Неизползвайтеоборудването,предидастесеконсултиралииразбралиупътването
заработа.
•Неспазванетонатовапредупреждениеможедадоведедонараняваненадоставчика
науслугата,оператораилипациентврезултатнатоковударилимеханичнаили
другаопасност.
本维修手册仅提供英文版本。
•如果维修服务提供商需要非英文版本,客户需自行提供翻译服务。
•未详细阅读和完全理解本维修手册之前,不得进行维修。
•忽略本警告可能对维修人员,操作员或患者造成触电、机械伤害或其他形式的伤害。
本維修手冊只提供英文版。
•如果客戶的維修人員有英語以外的其他語言版本需求,則由該客戶負責提供翻
譯服務。
•除非您已詳閱本維修手冊並了解其內容,否則切勿嘗試對本設備進行維修。
•不重視本警告可能導致維修人員、操作人員或病患因電擊、機械因素或其他因素
而受到傷害。
2
MUSE™CardiologyInformationSystem
2076576-008A
25February2014
ServiceManualLanguageInformation(cont'd.)
UPOZORENJE
(HR)
VAROVÁNÍ
(CS)
ADVARSEL
(DA)
WAARSCHUWING
(NL)
HOIATUS
(ET)
VAROITUS
(FI)
Oveuputezaservisiranjedostupnesusamonaengleskomjeziku.
•Ukolikokorisničkiserviszahtijevanekidrugijezik,korisnikovajeodgovornostosigurati
odgovarajućiprijevod.
•Nemojtepokušavatiservisiratiopremuukolikonistekonzultiraliirazumjelioveupute.
•Nepoštivanjeovogupozorenjamožerezultiratiozljedamaservisnogosoblja,korisnikaili
pacijentaprouzročenimelektričnimudaromtemehaničkimilinekimdrugimopasnostima.
Tentoprovoznínávodexistujepouzevanglickémjazyce.
•Vpřípadě,žeexterníslužbazákazníkůmpotřebujenávodvjinémjazyce,jezajištění
překladudoodpovídajícíhojazykaúkolemzákazníka.
•Nesnažteseoúdržbutohotozařízení,anižbystesipřečetlitentoprovoznínávoda
pochopilijehoobsah.
•Vpřípaděnedodržovánítétovarovánímůžedojítkporaněnípracovníkaprodejního
servisu,obslužnéhopersonálunebopacientůvlivemelektrickéhoproudu,respektive
vlivemmechanickýchčijinýchrizik.
Denneservicemanualndeskunpåengelsk.
•Hvisenkundesteknikerharbrugforetandetsprogendengelsk,erdetkundensansvar
atsørgeforoversættelse.
•Forsøgikkeatservicereudstyretmedmindredenneservicemanualharværetkonsulteret
ogerforstået.
•Manglendeoverholdelseafdenneadvarselkanmedføreskadepågrundafelektrisk,
mekaniskellerandenfareforteknikeren,operatørenellerpatienten.
DezeservicemanualisalleeninhetEngelsverkrijgbaar.
•Indienhetonderhoudspersoneeleenanderetaalnodigheeft,danisdeklant
verantwoordelijkvoordevertalingervan.
•Probeerdeapparatuurnietteonderhoudenvoordatdezeservicemanualgeraadpleegd
enbegrepenis.
•Indiendezewaarschuwingnietwordtopgevolgd,zouhetonderhoudspersoneel,de
gebruikerofeenpatiëntgewondkunnenrakenalsgevolgvaneenelektrischeschok,
mechanischeofanderegevaren.
Käesolevteenindusjuhendonsaadavalainultinglisekeeles.
•Kuiklienditeeninduseosutajanõuabjuhenditinglisekeelesterinevaskeeles,vastutab
klienttõlketeenuseosutamiseeest.
•Ärgeüritageseadmeidteenindadaenneeelnevaltkäesolevateenindusjuhendiga
tutvumistjasellestarusaamist.
•Käesolevahoiatuseeiraminevõibpõhjustadateenuseosutaja,operaatorivõipatsiendi
vigastamistelektrilöögi,mehaanilisevõimuuohutagajärjel.
Tämähuolto-ohjeonsaatavillavainenglanniksi.
•Josasiakkaanhuoltohenkilöstövaatiimuutakuinenglanninkielistämateriaalia,tarvittavan
käännöksenhankkiminenonasiakkaanvastuulla.
•Äläyritäkorjatalaitteistoaennenkuinoletvarmastilukenutjaymmärtänyttämän
huolto-ohjeen.
•Mikälitätävaroitustaeinoudateta,seurauksenavoiollahuoltohenkilöstön,laitteiston
käyttäjäntaipotilaanvahingoittuminensähköiskun,mekaanisenviantaimuun
vaaratilanteenvuoksi.
2076576-008A
MUSE™CardiologyInformationSystem
3
ServiceManualLanguageInformation(cont'd.)
ATTENTION
(FR)
WARNUNG
(DE)
ΠΡΟΕΙΔΟΠΟΙΗΣΗ
(EL)
FIGYELMEZTETÉS
(HU)
AÐVÖRUN
(IS)
PERINGATAN
(ID)
Cemanueltechniquen'estdisponiblequ'enanglais.
•Siunservicetechniqueclientsouhaiteobtenircemanueldansuneautrelangueque
l'anglais,ildevraprendreenchargelatraductionetlaresponsabilitéducontenu.
•Nepastenterd'intervenirsurleséquipementstantquelemanueltechniquen'apasété
consultéetcompris.
•Lenon-respectdecetavertissementpeutentraînerchezletechnicien,l'opérateuroule
patientdesblessuresduesàdesdangersélectriques,mécaniquesouautres.
DieseServiceanleitungistnurinenglischerSpracheverfügbar.
•FallsderKundendiensteineandereSprachebenötigt,musserfüreineentsprechende
Übersetzungsorgen.
•KeineWartungdurchführen,ohnedieseServiceanleitunggelesenundverstandenzu
haben.
•BeiZuwiderhandlungkanneszuVerletzungendesKundendiensttechnikers,des
AnwendersoderdesPatientendurchStromschläge,mechanischeodersonstigeGefahren
kommen.
Τοπαρόνεγχειρίδιοσέρβιςδιατίθεταιστααγγλικάμόνο.
•Εάντοάτομοπαροχήςσέρβιςενόςπελάτηαπαιτείτοπαρόνεγχειρίδιοσεγλώσσαεκτός
τωναγγλικών,αποτελείευθύνητουπελάτηναπαρέχειυπηρεσίεςμετάφρασης.
•Μηνεπιχειρήσετετηνεκτέλεσηεργασιώνσέρβιςστονεξοπλισμόεκτόςεάνέχετε
συμβουλευτείκαιέχετεκατανοήσειτοπαρόνεγχειρίδιοσέρβις.
•Εάνδενλάβετευπόψητηνπροειδοποίησηαυτή,ενδέχεταιναπροκληθείτραυματισμός
στοάτομοπαροχήςσέρβις,στοχειριστήήστονασθενήαπόηλεκτροπληξία,μηχανικούς
ήάλλουςκινδύνους.
Ezaszervizkézikönyvkizárólagangolnyelvenérhetőel.
•Haavevőszervizellátójaangoltóleltérőnyelvretartigényt,akkoravevőfelelőssége
afordításelkészíttetése.
•Nepróbáljaelkezdenihasználniaberendezést,amígaszervizkézikönyvbenleírtakat
nemértelmeztékésértettékmeg.
•Ezengyelmeztetésgyelmenkívülhagyásaaszervizellátó,aműködtetővagyapáciens
áramütés,mechanikaivagyegyébveszélyhelyzetmiattisérüléséteredményezheti.
Þessiþjónustuhandbókereingöngufáanlegáensku.
•Efaðþjónustuveitandiviðskiptamannsþarfnastannarstungumálsenensku,erþaðskylda
viðskiptamannsaðskaffatungumálaþjónustu.
•Reyniðekkiaðafgreiðatækiðnemaþessiþjónustuhandbókhefurveriðskoðuðogskilin.
•Brotáaðsinnaþessariaðvörungeturleitttilmeiðslaáþjónustuveitanda,stjórnandaeða
sjúklingifráraosti,vélrænumeðaöðrumáhættum.
ManualservisinihanyatersediadalambahasaInggris.
•JikapenyediajasaservispelangganmemerlukanbahasalainselaindariBahasaInggris,
merupakantanggungjawabdaripenyediajasaservistersebutuntukmenyediakan
terjemahannya.
•Janganmencobamelakukanservisterhadapperlengkapankecualitelahmembacadan
memahamimanualservisini.
•Mengabaikanperingataninibisamengakibatkancederapadapenyediaservis,operator ,
ataupasien,karenaterkenakejutlistrik,bahayamekanisataubahayalainnya.
4
MUSE™CardiologyInformationSystem
2076576-008A
25February2014
ServiceManualLanguageInformation(cont'd.)
AVVERTENZA
(IT)
警告
(JA)
경고
(KO)
BRĪDINĀJUMS
(LV)
ĮSPĖJIMAS
(LT)
ADVARSEL
(NO)
IlpresentemanualedimanutenzioneèdisponibilesoltantoinInglese.
•Seunaddettoallamanutenzionerichiedeilmanualeinunalinguadiversa,ilclienteè
tenutoaprovvederedirettamenteallatraduzione.
•Siprocedaallamanutenzionedell'apparecchiaturasolodopoaverconsultatoilpresente
manualeedavernecompresoilcontenuto.
•Ilnonrispettodellapresenteavvertenzapotrebbefarcompiereoperazionidacuiderivino
lesioniall'addetto,allamanutenzione,all'utilizzatoreedalpazienteperfolgorazione
elettrica,perurtimeccaniciodaltririschi.
このサービスマニュアルは英語版しかありません。
•サービスを担当される業者が英語以外の言語を要求される場合、翻訳作業はその業
者の責任で行うものとさせていただきます。
•このサービスマニュアルを熟読し、十分に理解をした上で装置のサービスを
行ってください。
•この警告に従わない場合、サービスを担当される方、操作員あるいは患者が、感電
や機械的又はその他の危険により負傷する可能性があります。
본서비스지침서는영어로만이용하실수있습니다.
• 고객의서비스제공자가영어이외의언어를요구할경우,번역서비스를제공하는것
은고객의책임입니다.
•본서비스지침서를참고했고이해하지않는한은해당장비를수리하려고시도하
지마십시오 .
•이경고에유의하지않으면전기쇼크,기계상의혹은다른위험으로부터서비스제
공자 ,운영자혹은환자에게위해를가할수있습니다.
Šīapkalpotājurokasgrāmatairpieejamatikaiangļuvalodā.
•Jaapkalpošanassniedzējamnepieciešamainformācijacitā,nevisangļu,valodā,klienta
pienākumsirnodrošināttāstulkošanu.
•Neveicietaprīkojumaapkopi,neizlasotunnesaprototapkalpotājurokasgrāmatu.
•Šībrīdinājumaneievērošanavarradītelektriskāsstrāvastrieciena,mehāniskuvaiciturisku
izraisītutraumuapkopessniedzējam,operatoramvaipacientam.
Šiseksploatavimovadovasyraprieinamastikanglųkalba.
•Jeiklientopaslaugųtiekėjasreikalaujavadovokitakalba-neanglų,numatytivertimo
paslaugasyraklientoatsakomybė.
•Nemėginkiteatliktiįrangostechninėspriežiūros,nebentatsižvelgėteįšįeksploatavimo
vadovąirjįsupratote.
•Jeineatkreipsitedėmesioįšįperspėjimą,galimisužalojimaidėlelektrosšoko,mechaninių
arkitųpaslaugųtiekėjui,operatoriuiarpacientui.
Denneservicehåndbokennnesbarepåengelsk.
•Hviskundensserviceleverandørtrengeretannetspråk,erdetkundensansvaråsørge
foroversettelse.
•Ikkeforsøkåreparereutstyretutenatdenneservicehåndbokenerlestogforstått.
•Manglendehensyntildenneadvarselenkanføretilatserviceleverandøren,operatøren
ellerpasientenskadespågrunnavelektriskstøt,mekaniskeellerandrefarer.
2076576-008A
MUSE™CardiologyInformationSystem
5
ServiceManualLanguageInformation(cont'd.)
OSTRZEŻENIE
(PL)
Niniejszypodręcznikserwisowydostępnyjestjedyniewjęzykuangielskim.
•Jeślidostawcausługklientawymagajęzykainnegoniżangielski,zapewnienieusługi
tłumaczeniajestobowiązkiemklienta.
•Nienależyserwisowaćwyposażeniabezzapoznaniasięizrozumienianiniejszego
podręcznikaserwisowego.
•Niezastosowaniesiędotegoostrzeżeniamożespowodowaćurazydostawcyusług,
operatoralubpacjentawwynikuporażeniaelektrycznego,zagrożeniamechanicznego
bądźinnego.
AVISO
(PT-BR)
Estemanualdeassistênciatécnicasóseencontradisponíveleminglês.
•SeoserviçodeassistênciatécnicadoclientenãoforGE,eprecisardeoutroidioma,será
daresponsabilidadedoclientefornecerosserviçosdetradução.
•Nãotenterepararoequipamentosemterconsultadoecompreendidoestemanualde
assistênciatécnica.
•Onãocumprimentodesteavisopodeporemperigoasegurançadotécnico,operadorou
pacientedevidoachoqueselétricos,mecânicosououtros.
AVISO
(PT-PT)
Estemanualtécnicosóseencontradisponíveleminglês.
•Seaassistênciatécnicadoclientesolicitarestesmanuaisnoutroidioma,éda
responsabilidadedoclientefornecerosserviçosdetradução.
•Nãotenterepararoequipamentosemterconsultadoecompreendidoestemanual
técnico.
•Onãocumprimentodesteavisopodeprovocarlesõesaotécnico,aoutilizadorouao
pacientedevidoachoqueseléctricos,mecânicosououtros.
AVERTISMENT
(RO)
Acestmanualdeserviceestedisponibilnumaiînlimbaengleză.
•Dacăunfurnizordeserviciipentruclienţinecesităoaltălimbădecâtceaengleză,estede
datoriaclientuluisăfurnizezeotraducere.
•Nuîncercaţisăreparaţiechipamentuldecâtulteriorconsultăriişiînţelegeriiacestui
manualdeservice.
•Ignorareaacestuiavertismentarputeaducelarănireadepanatorului,operatoruluisau
pacientuluiînurmapericolelordeelectrocutare,mecanicesaudealtănatură.
ПРЕДУПРЕЖДЕНИЕ
(RU)
Настоящееруководствопообслуживаниюпредлагаетсятольконаанглийскомязыке.
•Еслисервисномуперсоналуклиентанеобходиморуководствоненаанглийском,ана
каком-тодругомязыке,клиентуследуетобеспечитьпереводсамостоятельно.
•Преждечемприступатькобслуживаниюоборудования,обязательнообратитеськ
настоящемуруководствуивнимательноизучитеизложенныевнемсведения.
•Несоблюдениетребованийданногопредупрежденияможетпривестиктому,что
специалистыпообслуживанию,операторыилипациентыполучатударэлектрическим
током,механическуютравмуилидругоеповреждение.
UPOZORENJE
(SR)
Ovoservisnouputstvojedostupnosamonaengleskomjeziku.
•Akoklijentovserviserzahtevanekidrugijezik,klijentjedužandaobezbediprevodilačke
usluge.
•Nepokušavajtedaopraviteuređajakonistepročitaliirazumeliovoservisnouputstvo.
•Zanemarivanjeovogupozorenjamožedovestidopovređivanjaservisera,rukovaocaili
pacijentausledstrujnogudara,ilimehaničkihidrugihopasnosti.
6
MUSE™CardiologyInformationSystem
2076576-008A
25February2014
ServiceManualLanguageInformation(cont'd.)
VAROVANIE
(SK)
OPOZORILO
(SL)
ADVERTENCIA
(ES)
VARNING
(SV)
UYARI
(TR)
Tentonávodnaobsluhujekdispozíciilenvangličtine.
•Akzákazníkovposkytovateľslužiebvyžadujeinýjazykakoangličtinu,poskytnutie
prekladateľskýchslužiebjezodpovednosťouzákazníka.
•Nepokúšajtesaoobsluhuzariadeniaskôr ,akosineprečítatenávodnaobsluhua
neporozumietemu.
•Zanedbanietohtovarovaniamôževyústiťdozraneniaposkytovateľaslužieb,obsluhujúcej
osobyalebopacientaelektrickýmprúdom,mechanickýmaleboinýmnebezpečenstvom.
Taservisnipriročnikjenavoljosamovangleškemjeziku.
•Čeponudnikstoritvestrankepotrebujepriročnikvdrugemjeziku,morastrankazagotoviti
prevod.
•Neposkušajteservisiratiopreme,četegapriročnikanistevcelotiprebraliinrazumeli.
•Četegaopozorilaneupoštevate,selahkozaradielektričnegaudara,mehanskihalidrugih
nevarnostipoškodujeponudnikstoritev,operateralibolnik.
Estemanualdeserviciosóloexisteeninglés.
•Sielencargadodemantenimientodeunclientenecesitaunidiomaquenoseaelinglés,el
clientedeberáencargarsedelatraduccióndelmanual.
•Nosedeberádarserviciotécnicoalequipo,sinhaberconsultadoycomprendidoeste
manualdeservicio.
•Lanoobservanciadelpresenteavisopuededarlugaraqueelproveedordeservicios,el
operadoroelpacientesufranlesionesprovocadasporcausaseléctricas,mecánicaso
deotranaturaleza.
Denhärservicehandbokennnsbaratillgängligpåengelska.
•Omenkundsserviceteknikerharbehovavettannatspråkänengelskaansvararkunden
föratttillhandahållaöversättningstjänster.
•Försökinteutföraservicepåutrustningenomduinteharlästochförstårdenhär
servicehandboken.
•Omduintetarhänsyntilldenhärvarningenkandetresulteraiskadorpåserviceteknikern,
operatörenellerpatiententillföljdavelektriskastötar,mekaniskafarorellerandrafaror.
Buserviskılavuzununsadeceİngilizcesimevcuttur .
•Eğermüşteriteknisyenibukılavuzuİngilizcedışındabirbaşkalisandantalepederse,bunu
tercümeettirmekmüşteriyedüşer.
•Serviskılavuzunuokuyupanlamadanekipmanlaramüdahaleetmeyiniz.
•Buuyarıyauyulmaması,elektrik,mekanikveyadiğertehlikelerdendolayıteknisyen,
operatörveyahastanınyaralanmasınayolaçabilir.
2076576-008A
MUSE™CardiologyInformationSystem
7
ServiceManualLanguageInformation(cont'd.)
ЗАСТЕРЕЖЕННЯ
(UK)
CẢ NHBÁO
(VI)
Данекерівництвозсервісногообслуговуванняпостачаєтьсявиключноанглійськоюмовою.
•Якщосервіснийінженерпотребуєкерівництвоіншоюмовою,користувачзобов'язаний
забезпечитипослугиперекладача.
•Ненамагайтесяздійснюватитехнічнеобслуговуванняданогообладнання,якщо
винечитали,абонезрозумілиінформацію,наданувкерівництвізсервісного
обслуговування.
•Недотриманняцьогозастереженняможепризвестидотравмуваннясервісного
інженера,користувачаданогообладнанняабопацієнтавнаслідокелектричногошоку,
механічногоушкодженняабозіншихпричинневірногообслуговуванняобладнання.
TàiLiệ uHướ ngDẫ nSử aChữ achỉcóbả ntiế ngAnh.
•Nế ucácđơ nvịcungcấ pdị chvụchokháchhàngyêucầ umộ tngônngữnàokháctiế ng
Anh,thìkháchhàngsẽcótráchnhiệ mcungcấ pcácdị chvụdị chthuậ t.
•Khôngđượ csử achữ athiế tbịtrừkhiđãthamkhả ovàhiể uTàiliệ uHướ ngdẫ nSử achữ a.
•Khôngtuânthủnhữ ngcả nhbáonàycóthểdẫ nđế ncáctổ nthươ ngchongườ ithự c
hiệ nsử achữ a,ngườ ivậ nhànhhaybệ nhnhân,dosố cđiệ n,cácrủ irovềcơkhíhay
cácrủ irokhác.
8
MUSE™CardiologyInformationSystem
2076576-008A
25February2014
Contents
1 Introduction
ManualInformation..................................................................................11
IntendedAudience..................................................................................11
ManualPurpose......................................................................................11
DocumentConventions.............................................................................11
RelatedDocuments..................................................................................12
AdditionalAssistance................................................................................12
InterfaceOverview....................................................................................13
2 ConnectingtheMUSESystemtoaMaster-PatientIndex
Server(MPI)
InstallationandCongurationProcedures...............................................16
InstallingCCG,MUSESites,andHL7toSoapTemplateCloverleafSite.....................16
CreatinganSSLSecurityCerticate..............................................................17
ConguringCloverleafApplicationAdaptorWebServices
(CAA-WS)...................................................................................................20
CreatingaNewSOAPClient........................................................................21
ConguringXMLinthehl7_soap_singreqSite..................................................23
AddinganHTTPConduittotheCongurationFile.............................................24
ImportinganXMLSchemaintoCloverleaf.......................................................25
GeneratingXSDFiles.................................................................................27
CreatingaRequestTranslationFile...............................................................30
CreatingaResponseTranslationFile.............................................................33
ConguringCloverleafTranslationRoutes.......................................................34
ConnectingtheMUSESitetothehl7_soap_singreqSite......................................36
ConrmingCAA-WSandCloverleafConguration.............................................39
FinalizingtheConguration........................................................................44
PerformingCleanup..................................................................................44
3 Troubleshooting
CommonProblems....................................................................................45
A SupportMaterial
OpeningtheWSConguratorInterface...................................................49
CreatingaNewClientCongurationFile..................................................50
CreatingaNewServerCongurationFile.................................................50
UsingtheLogicalandPhysicalViews.......................................................51
2076576-008A
MUSE™CardiologyInformationSystem
9
EditingaFile..............................................................................................52
UsingtheLogicalandPhysicalView.........................................................52
CreatingandDeletingElements...............................................................54
UsingthePropertiesChild.........................................................................55
CreatingaNewSOAPServer.....................................................................56
UsingtheLogicalandPhysicalViews.......................................................58
B ViewTrustedCerticates
ViewCerticatesintheTrustedRootCerticationAuthorities................61
10
MUSE™CardiologyInformationSystem
2076576-008A
1
Introduction
Thischapterprovidesgeneralinformationrequiredfortheproperuseofthesystem
andthismanual.Familiarizeyourselfwiththisinformationbeforeusingthesystem.
ManualInformation
Thissectionprovidesinformationforthecorrectuseofthismanual.
Keepthismanualwiththeequipmentatalltimesandperiodicallyreviewit.You
shouldrequesttrainingassistancefromGEHealthcare,ifneeded.
IntendedAudience
ThismanualisintendedforusebyGEHealthcareFieldServiceEngineers.
ManualPurpose
DocumentConventions
TypographicalConventions
ThismanualprovidestheinformationneededtoinstallandconguretheCloverleaf
ApplicationAdapter-WebServices(CAA-WS).Thismanualalsoprovidesinformation
ontroubleshooting.
Thismanualusesthefollowingconventions.
Convention Description
BoldText Indicateskeysonthekeyboard,texttoenter,orhardwareitemssuchas
buttonsorswitchesontheequipment.
Italicized-Bold
Text
CTRL+ESC
Indicatessoftwaretermsthatidentifymenuitems,buttonsoroptionsin
variouswindows.
Indicatesakeyboardoperation.Aplus(+)signbetweenthenamesoftwo
keysindicatesthatwhileholdingtherstkey,youshouldpressandrelease
thesecondkey.Forexample,PressCTRL+ESCmeanstopressandholdthe
CTRL keyandthenpressandreleasetheESCkey.
2076576-008A
MUSE™CardiologyInformationSystem
11
Introduction
Convention Description
<space>
Enter
>
Indicatesthatyoumustpressthespacebar.Wheninstructionsaregiven
fortypingaprecisetextstringwithoneormorespaces,thepointwhere
youmustpressthespacebarisindicatedas<space>.Thisensuresthat
thecorrectnumberofspacesisinsertedinthecorrectpositionswithin
theliteraltextstring.Thepurposeofthe<>bracketsistodistinguishthe
commandfromtheliteraltextwithinthestring.
IndicatesthatyoumustpresstheEnterorReturnkeyonthekeyboard.Do
nottypeEnter.
Thegreaterthansymbol,orrightanglebracket,isaconcisemethodto
indicateasequenceofmenuselections.
Forexample,thestatement“Fromthemainmenu,selectSystem>Setup>
Options toopentheOptionActivationwindow”replacesthefollowing:
1. Fromthemainmenu,selectSystemtoopentheSystemmenu.
2. FromtheSystemmenu,selectSetuptoopentheSetupmenu.
3. FromtheSetupmenu,selectOptionstoopentheOptionActivation
window.
Illustrations
Notes
RelatedDocuments
AdditionalAssistance
Allillustrationsinthemanualareprovidedasexamplesonly.Dependingonsystem
conguration,screensinthemanualmaydifferfromthescreensonyoursystem.
Allpatientnamesanddataarectitious.Anysimilaritytoactualpersonsis
coincidental.
Notesprovideapplicationtipsoradditionalinformationthat,whileuseful,arenot
essentialtothecorrectoperationofthesystem.Theyarecalledoutfromthebody
textthroughaagwordandindentation,asfollows:
NOTE:
ThetiporadditionalinformationisindentedbelowtheNOTEagword.
Foracompletelistofrelatedmanuals,refertotheRelatedManualsappendixinthe
MUSECardiologyInformationSystemsServiceManual .
GEHealthcaremaintainsatrainedstaffofapplicationandtechnicalexpertstoanswer
questionsandrespondtoissuesandproblemsthatmayariseduringtheinstallation,
maintenance,anduseofthissystem.
ContactyourlocalGEHealthcarerepresentativetorequestadditionalassistance.
12
MUSE™CardiologyInformationSystem
2076576-008A
InterfaceOverview
TheMaster-PatientIndex(MPI)interfaceiscomposedofthreecomponents.
•CloverleafApplicationAdapter-WebServices(CAA-WS,theCCGwebservices)–
UsedtoestablishasecureconnectiontotheMPIserverandhandlesauthentication.
•hl7_soap_singreq/hl7_soap_multreqCloverleafSite–Usedtotranslatebetween
HL7messageformatsandtheWebService’sSOAPmessageformat.
•muse_prodCloverleafSite–ThestandardMUSECCGsiteusedtointerfacewith
theHospitalInformationSystems(HIS).
Introduction
FromtheMUSEstandpoint,theADTQuerypathisthesameaswhentheMUSEis
connectedtoaHIS(viaaCCG).TheMUSEsystemsendsastandardQRY^Q01ADT
QuerymessagetotheCCG’sCloverleafMUSEsite.
TheCloverleafMUSEsitethenforwardsthemessagetothehl7_soap_singreqor
hl7_soap_multreq site(alsoinCloverleaf),whichsavestheMUSESiteIDofthe
outgoingrequestandtranslatestheQRY^Q01HL7messageintoaSOAPmessage
appropriatefortheMPIwebserver.
AfterthequerymessageisconvertedtoaSOAPmessage,themessageisreadyfor
theMPIwebserver.Themessagenegotiateswebsitesecurityprotocols,suchas
https,anduserauthentication.CAA-WScompletestheseoperations.
Whenthewebsiterepliestothequery,theresponseisreturnedtoCAA-WS,which
forwardstheresponsetotheCloverleafhl7_soap_singreqorhl7_soap_multreqsite.
TheCloverleafhl7_soap_singreqorhl7_soap_multreqsiteconvertstheresponse
fromtheSOAPformatintoanHL7ADT^A19message.Afterconvertingtheresponse
messageintoanHL7message,thehl7_soap_singreqorhl7_soap_multreqsite
reattachestheMUSESiteIDtothemessage,andsendstheA19messagetotheMUSE
site.TheMUSEsitereturnstheresponsetotheMUSEsystemasifitwerearesponse
fromaHIS.
2076576-008A
MUSE™CardiologyInformationSystem
13
Introduction
14
MUSE™CardiologyInformationSystem
2076576-008A
ConnectingtheMUSESystemtoa
Master-PatientIndexServer(MPI)
NOTE:
ThroughoutthisprocedureyouwillnoticesomeitemsarelabeledwithfourX’s
(XXXX).ReplacetheseX’swithastringthatappropriatelyidentiesthetargetMPI
site.
ThecongurationofMPIsupport(CCGCAA-WS:CloverleafApplicationAdapterWeb
Services)requiresthefollowing:
•Atexteditor ,suchasMSNotepadorNotepad++.DonotuseMS-Wordpador
MS-Word.
•AvalidatingXMLeditor(optional).
CompletethefollowingtaskstoinstallandcongureaCCGsystemwithCAA-WS.
1. InstallaCCGsystemwithCloverleafApplicationAdaptorWebServices(CAA-WS).
See“InstallingCCG,MUSESites,andHL7toSoapTemplateCloverleafSite”on
page16.
2. InstalltheMUSEsites.See“InstallingCCG,MUSESites,andHL7toSoapTemplate
CloverleafSite”onpage16.
2
3. InstalltheHL7tothesoaptemplateCloverleafsite.See“InstallingCCG,MUSE
Sites,andHL7toSoapTemplateCloverleafSite”onpage16.
4. CreateSSLsecuritycerticates(requiredonlyifhttpsisusedtoaccesstheweb
service).See“CreatinganSSLSecurityCerticate”onpage17.
5. CongureCAA-WS.See“ConguringCloverleafApplicationAdaptorWebServices
(CAA-WS)”onpage20.
6. ImportschemadocumentsspecictotheMPIwebsiteintoCloverleaf.See
“ImportinganXMLSchemaintoCloverleaf”onpage25.
7. CongureCloverleafoutboundtranslationofHL7toSOAPrequestmessage.
See“CreatingaRequestTranslationFile”onpage30.
8. CongureCloverleafinboundtranslationofSOAPresponsemessagetoHL7.
SeeAppendix“CreatingaRequestTranslationFile”onpage30.
9. ConnecttheMUSEsitetothehl7_soap_singreqorhl7_soap_multreqsite.See
“ConnectingtheMUSESitetothehl7_soap_singreqSite”onpage36.
10.Finalizetheconguration.See“FinalizingtheConguration”onpage44.
11.Performcleanup.See“PerformingCleanup”onpage44.
2076576-008A
MUSE™CardiologyInformationSystem
15
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
InstallationandCongurationProcedures
UsethefollowingprocedurestoinstallandconguretheCCG,MUSE,Cloverleafsites,
andcreatinganSSLSecurityCerticate.
InstallingCCG,MUSESites,andHL7toSoapTemplate
CloverleafSite
UsethefollowingproceduretoinstalltheCCG,MUSEsites,andHL7toSoaptemplate
Cloverleafsite.
1. InstalltheCCGfollowingtheinstructionsintheMUSECardiologyInformation
SystemInstallationGuide .
AutostartandSchedulingcongurationareperformedaftertheMPIinterfaceis
createdandcongured.
2. AfterinstallingtheCCG,copythestandardMUSE-CCGInterfaceziples
fromtheCCGSitesdirectoryontheMUSEV8SystemApplicationDVDto
c:\gehc-it\ccg\extras\interfaces ontheCCGserver.
3. IntheCCGSitesdirectoryoftheMUSECCGCD,copyoneofthefollowinglesto
c:\gehc-it\ccg\extras\interfaces ontheCCGserver:
•IfmorethanonerequesthastobesenttotheWebServicetorequestfor
patientinformation,locateandcopyhl7_soap_multreq.zip.
•IfonlyonerequesthastobesenttotheWebServicetorequestforpatient
information,locateandcopyhl7_soap_singreq.zip.
NOTE:
Thedefaultsiteshl7_soap_multreqandhl7_soap_singreqincludeXML,
XSDandOCMleswhicharetobeusedassamplesandwillrequireyouto
customizethemforthecustomer.Refertosection“CreatingaNewSOAP
Client”onpage21forgeneratingnewXMLles.Refertosection“Generating
XSDFiles”onpage27forcreatingtherequiredXSDles.OCMlesare
generatedwhentheXSDlesarecompiled.
4. InstalltheMUSEinterfacesasrequiredbythesitefollowingtheprocedures
documentedintheMUSECardiologyInformationSystemsDevicesandInterfaces
Manual.
NOTE:
Onlythemuse_prodsite(muse_prod.zip )isrequiredbytheMPIinterface.
5. InstalltheHL7-to-soapsitethatyoucopiedinstep3.
NOTE:
Thisdocumentassumesthatthe hl7_soap_singreqsiteisinstalled.Ifthe
hl7_soap_multreqsiteisinstalled,youcanfollowthesameinstructionsas
forthehl7_soap_singreqsite.
16
MUSE™CardiologyInformationSystem
2076576-008A
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
6. In hl7–soap-singreq/tclprocs/http_query.tclandhl7–soap-multreq/
tclprocs/http_query.tcl,procedureExtractTokenAndRequestFindPatient,has
hard-codeddetailsspecictotheMPIserveryouareusing.
Updatethefollowingeldsasappropriateforthecustomersite.
•setUserName“webservice”
•setFriendlyName“WSGeApp”
•setSystemCode“GEApp”
•setSystemLocation“SG033827”
NOTE:
TheSavehl7elds.tcl.hasadelayconguredtopreventaracecondition
betweentwoADTqueryrequests.Congurethedelayasappropriatefor
thecustomersitesothatanytworequestsareprocessedoneafterthe
otherbutassoonaspossible.Thedelayconguredisinmilliseconds.Inthe
examplebelowitsconguredas10,000milliseconds
Usethefollowinginformationtocongurethedelay.IfthepatientID.txt
leexists,itindicatesthatarequestisbeingprocessedandyouwillneed
towaituntilitisdone.
if{[fileexists"patientID.txt"]}{
#echo"insideIFloop"
after
10000
}
NOTE:
ThereisaknownissuewiththeSavehl7elds.tclinthehl7-soap-singreq
templatewhichwillbexedinasubsequentrelease.Inthistemplatethe
codeusesa“while”blockwhenitshouldhaveusedan“If”blockasthecode
snippetshownabove.Aworkaroundistochangethe"while"to"if"orthe
entiresectionofcodewritingthePatientIDtoaleandreadingfromit
canberemovedfromthistemplate.
7. Appropriateerrorhandlingneedstobeaddedtothetclprocparsingthe
responsefromtheMPIServer.
Errorhandlingisrequiredinbothcases:whenTPStranslationisusedorwhen
theCloverLeafXLATEisused.
8. TheSourceinthedefaultalertsofallthetemplateswillneedtobemodied
accordinglyiftheCCG/CloverleafinstalldirectoryisnotondriveC.Thedefault
alertleforasiteislocatedatCL_INSTALL_DIR\integrator\[SITENAME]\Alerts.
9. IftheconnectiontotheservicesusesaSecureSockletLevel(SSL)connection,
proceedtothenextsection“CreatinganSSLSecurityCerticate”.
IftheconnectiontotheservicesdoesnotuseSSL,proceedto“Conguring
CloverleafApplicationAdaptorWebServices(CAA-WS)”onpage20.
CreatinganSSLSecurityCerticate
IftheconnectiontotheserviceusesaSecureSocketLevel(SSL)connectionsuchas
https,youneedtoperformthefollowingproceduretocreateakeystorethatallows
CAA-WStoestablishasecureconnectiontotheWebService.
2076576-008A
MUSE™CardiologyInformationSystem
17
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
IfthereisnoSSLconnection,skipthissectionandproceedto“ConguringCloverleaf
ApplicationAdaptorWebServices(CAA-WS)”onpage20.
1. ObtainthesecuritycerticatefortheWebServiceswherepatientdataisobtained.
ThefollowingprocedureisforInternetExplorer8.Theprocedureforother
browsersmaybesimilar .
a. UsingInternetExplorer8,navigatetothewebaddressoftheservice.
Thefollowingerrorpageisdisplayed:CerticateError:NavigationBlocked.
b. Clickonthefollowinglink:Continuetothiswebsite(notrecommended).
Thefollowingmessageisdisplayed:PagecannotbefoundHTTP:404error.
NexttotheURLdrop-downeld,thefollowingmessageisdisplayed:
CerticateError .
c. ClickCerticateError.
d. ClickViewCerticates.
e. UnderCerticateDetails,selectCopytoFile….
f. WhentheCerticateExportWizardopens,clickNextandselectDER
encodedbinary .
g. ClickNextandnavigatetoatemporarydirectory.
h. NametheleXXXXCerticate.cer,replacingtheXXXXwithaname
appropriatetotheMPIsite.
i. ClickSave.
j. ClickNext>Finishtocompletethesecuritycerticateexport.
2. CopythesecuritycerticatetoatemporarydirectoryontheCCGServer.
3. Openacommandwindowandchangetothedirectorywhereyousavedyourle.
4. Inthecommandwindow,typethefollowingcommandtocreateakeystore:
C:\gehc-it\_jre\bin\keytool–importcert–leXXXXCerticate.cer–storepass
PPPPPP–trustcacerts–storetypeJKS–keystoreXXXXKey.keystore
Thekeystorecontainsthecerticateusingthejavakeytoolcommandreplacing
PPPPPP withthepasswordyouareusingtoprotectthekeystore.
NOTE:
Thepasswordneedstobeaminimumofsixcharacterslong.Rememberthe
passwordbecauseitisrequiredwheneditingtheCAA-WSCCGconguration
le.
5. Whenthekeytoolruns,adialogboxasksifyoutrustthecerticate;clickYES.
6. Copythekeystorele,XXXXKey.keystore,totheC:\gehc-it\ccg\quovadx\cis6.0\
integrator\hl7_soap_multreqorC:\gehc-it\ccg\quovadx\cis6.0\integrator\
hl7_soap_singreqdirectoryontheCCGServer.
7. Proceedtothenextsection“ConvertingaCerticatefromP12toJKS”.
ConvertingaCerticatefromP12toJKS
UsethefollowingproceduretoconvertasecuritycerticatefromP12toJKS.The
assumptionisthatyoualreadyhavethecerticatetest.p12oftypePKCS12andyou
areconvertingittotest.JKSoftypeJKS.
1. First,youwillneedtodeterminethevaluetoenterfor-srcalias.
Openacommandwindowandtypethefollowing:
18
MUSE™CardiologyInformationSystem
2076576-008A
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
keytool-v-list-keystoretest.p12-storepass
<MyPassWord>-storetypePKCS12
NOTE:
Forthevariable<MyPassword>usethepasswordforthe test.p12
certicate.
Theresultsaredependentonthelanguageoftheoperatingsystem,the
followingisanexamplefromaSwedishoperatingsystem:
Intheexamplethevaluefor-srcaliasisrsekgprod.
ThiscommandwillalsolisttheinformationoftheCerticateAuthorityand
thecerticate(s)used.Thisinformationwillbeusefulforsubsequentsteps
(especiallystep6)whereyouwillhavetoobtaintherequiredcerticates.
SeeAppendixB“ViewTrustedCerticates”onpage61fortheinformation
onusingtheMicrosoftManagementConsolemmc.exetoviewthetrusted
certicatesinstalledonyourmachine.
2. TocreatetheJKSfromtheP12le,runthefollowingcommandinthecommand
prompt:
keytool-importkeystore-srckeystoretest.p12
-destkeystoretest.jks-srcstoretypePKCS12
-deststoretypeJKS-srcstorepass<passwordofP12>
-deststorepass<passwordofJKS>-srcalias<P12alias>
-destalias<JKSalias>-srckeypass<P12storepassword>
-destkeypass<JKSstorepassword>
3. ConrmthattheJKSwascreatedsuccessfullybyrunningthefollowing
command:
keytool-v-list-keystoretest.jks-storetypejks
4. Enterthepasswordwhenprompted.
TheconsoleliststhecontentoftheJKSle.
5. Createatextlecalledcerticate.peminanytexteditor.
Allthepubliccerticatesneedtobeinasinglele.Theseincluderoot,
intermediate,andCAcerticates.SinceP12isaWindows-basedcerticate,all
certicatesmustbeavailable.
6. Downloadorobtainallpossiblecerticatesfromtheclient.
2076576-008A
MUSE™CardiologyInformationSystem
19
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
7. DownloadandinstallOpenSSLfromthefollowinglocation:
http://gnuwin32.sourceforge.net/packages/openssl.htm.
8. Openeachavailablecerticate,one-by-one,inanytexteditor.
Thecerticates(.cer/.crtle)shouldbeBase64encodedsothatyoucanuse
theminthePEMleyoucreatedearlier.ABase64encodedcerticatelookslike
thefollowingsample:
-----BEGINCERTIFICATE----MIIFazCCA1OgAwIBAgIRAIC/
GIYrVi9G9NoHXIniK9EwDQYJKoZIhvcNAQEFBQAw
.
HDFQu+mEswKUJrN/
ug2rIThaKdqkwe9iVDI9yAZD6aF8P2WRO9q7IYgbAs4/F7Q=
-----ENDCERTIFICATE---–
•Ifthecontentisinthisformat,copyandpasteitintothecerticate.pemle.
NOTE:
Youneedtocopyallofthecontentandtagsbetweenthe Begin
CerticateandEndCerticatetags.
•Ifthecontentisnotinthisformat,youneedtoconvertitintoBase64using
OpenSSL ,whichyoudownloadedandinstalledearlier.Usethefollowing
commandforeachnon-Base64encodedcerticate:
opensslx509-inxyz.crt-informder-outformpem-out
abc.pem
9. OpenthenewlycreatedPEMleanditscontentshouldbesimilartothe
exampleinstep8.
10. Copyandpastethecontentintothecerticate.pemle.
11. UsethefollowingcommandtoimportallofthecerticatestotheJKSle.
keytool-import-keystoretest.jks-alias
muse-client-cert-filecertificate.pem
a. Typethekeystorepasswordwhenprompted.
b. Typeyeswhenpromptedifyoutrustthiscerticate.
12. ToconrmthatthecerticatesimportedsuccessfullywithJKS,runthefollowing
command:
keytool-v-list-keystoretest.jks-storetypejks
13. Proceedtothenextsection“ConguringCloverleafApplicationAdaptorWeb
Services(CAA-WS)”.
ConguringCloverleafApplicationAdaptorWeb
Services(CAA-WS)
UsethefollowingprocedurestoconguretheCAA-WS.
20
MUSE™CardiologyInformationSystem
2076576-008A
CreatingaNewSOAPClient
UsethefollowingproceduretocreateanewSOAPclient.
1. AttheC:drive,openthefolderatC:\gehc-it\ccg\quovadx\cis6.0\
integrator\hl7_soap_multreq\javadriver\hl7_adt_soap_multreq\or
C:\gehc-it\ccg\quovadx\cis6.0\integrator\hl7_soap_singreq\javadriver\
hl7_adt_soap_singreqleandrenameCCG-CAAWS-cong.xmlwithadifferent
namesothatitissavedasabackupletorefertolater.
2. OpentheWSConguratortool.
Double-clickthejarlefromalebrowserorrunjava-jarWSCongurator.jar
fromthecommandlineafterchangingthedirectorytowhere
WSCongurator.jar islocated.
Thisisfoundatintegrator/CAA/ws/tool/WSCongurator.jar.
TheLogicalViewwindowopens.
3. SelectClient>NewSOAPClient.
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
TheAddSOAPClientwindowopens:
4. EntertheWSDLURL.
•UsingaWSDLatanHTTPaddresscanbeunstableiftheWSDLbecomes
unavailable,causingtheClientservicetofailtostart.
•ItisrecommendedthatyousaveacopyofaWSDLtothelocalharddrive
andaccessitfromthere.
2076576-008A
MUSE™CardiologyInformationSystem
21
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
Inthefollowingexample,thefollowingWSDLisenteredintoWSDLURL:
http://soap.amaqmzon.com/schemas2/AmazonWebSerices.wsdl
5. ClickLoadWSDL.
.
TheServiceeldispopulatedfromtheWSDL.Sincethereisonlyoneentry,
thesystemautomaticallyselectsit.
SelectingaServicepopulatesthePorteld.Sincethereisonlyoneportinthe
example,itisautoselected.
6. UsetheAddresseldforanyaddressoverrides.
Intheexample,theAddresseldisemptybecausetheaddressintheWSDL
URL eldiscorrect.
IftheserverimplementsawidelyavailableWSDLbasedonastandardwhere
theaddressisgeneric,usetheAddresseldtooverrideitwiththeaddressof
theserverwithwhichthissystemisinteracting.
7. SelecttheServiceMode>MESSAGE(bydefaulttheServiceModeissetto
PAYLOAD ).
•MESSAGE
•IndicatesthesystemuserissendingandreceivingtheentireSOAP
Envelope.
•Thisallowsgreaterexibility,butisalsomorecomplicatedanderrorprone.
•PAYLOAD
•ThistellsthesystemtosendandreceiveonlythecontentsoftheSOAP
BodyelementandthatCXFtakescareoftheSOAPEnvelope/Header.
•UsePAYLOADmodeunlessthereisinformationintheSOAPHeaderthat
thesystemneedstosend,whichCXFdoesnotalreadyhandle.
8. ClickOK.
9. MakesurethecheckboxnexttoMessageLoggingEnabledisnotselected
topreventthelargelogsmessages.
10. SelectSOAPACTIONforCloverleafTrxIDDetermination.
22
MUSE™CardiologyInformationSystem
2076576-008A
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
11. ClickFile>SaveAs.
TheSavewindowopens.
12. SavethecongurationleinthefolderC:\gehc-it\ccg\quovadx\cis6.0\
integrator\hl7_soap_singreq\javadriver\hl7_adt_soap_singreq\as
CCG-CAAWS-cong.xml.Thejavadriverwilllookforthecongurationxml
inthislocation.
NOTE:
Ifusingadifferentname,remembertochangethenameconguredinthe
threadsthatcommunicatewithCAA-WS.Seethenextsection,“Conguring
XMLinthehl7_soap_singreqSite”.
ConguringXMLinthehl7_soap_singreqSite
1. OpenCloverleafIDE.
2. Makesureyouareatthehl7_soap_singreqorhl7_soap_multreqsite.
3. ClickononeofthejavathreadsthatcommunicatewithCAA-WS.
4. AtthePropertiestab,clickthePropertiesbutton.
TheJavaDriverProtocolPropertieswindowopens.
5. MakesurethedoStartmethodisselectedandtypethenameofthe
congurationxmlleintheArgumenteld.
6. SelectSkipJVMshutdownhookswhenthethreadexits.
7. ClickOK.
2076576-008A
MUSE™CardiologyInformationSystem
23
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
AddinganHTTPConduittotheCongurationFile
IftheWebServicerequiresSSL(forexample,ifitisanhttpsconnection),thenyouneed
tocongureHTTP-conduitinthexmlcongurationle.AnHTTPConduitiscreated
withthehelperdialog.
1. OpentheWSConguratortoolandopentheCCG-CAAWS-cong.xmlle.
2. ClickClient>NewHTTPConduit.
TheAddHTTPConduitwindowopens.
3. IntheNameeld,typethePortname.
TheportnamefromtheSOAPClienttabcanbeused.
NOTE:
Theportnameshouldendwith.http-conduit.
4. ClickOK.
TheAddHTTPConduitwindowclosesandanewtabforhttpconduitisadded
intheLogicalViewandPhysicalView.
5. Usetheinformationinthefollowingtabletocompletetheeldsonthewindow.
HTTPConduit
Field Value
TLSSecured Selectthecheckbox.
SecureSocketProtocol SelectTLSv1.
DisableCommonNameCheck SelectFalse.
24
MUSE™CardiologyInformationSystem
2076576-008A
HTTPConduit(cont'd.)
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
Field Value
SSLCacheTimeoutLeaveblank.
KeyPasswordEntertheCerticatePassword.
KeystoreFile,Password,TypeEntertheinformationineacheld,appropriatefor
yoursystem.
See“CreatinganSSLSecurityCerticate”onpage
17forvaluesforkeystoreelds.
TruststoreFile Entertheinformationappropriateforyoursystem.
See“CreatinganSSLSecurityCerticate”onpage
17forvaluesfortruststoreelds.
NOTE:
LeavealloftheeldsintheClientSettingseldblank.
NOTE:
IftheKeystoreisstoredintheexec/process/[SiteName]directory,then
theentirepathtothecerticateisnotrequiredintheKeystoreFileand
TruststoreFile elds.
6. SelectFile>Save.
7. OpentheXMLcongurationleinatexteditorandensurethatthehttpconduit
sectionwasadded.
TheHTTPConduitcanapplyitssettingstooneormoreClients,oronlytospecic
URLswithinasingleClient.
TheHTTPConduithaschildren,suchasClient,whichcongureTLSforthosesame
matchedrequests.
ReviewtheHelpsectionforalistofallClientproperties.
ImportinganXMLSchemaintoCloverleaf
BeforetheCCGisabletosendorreceiveanXMLmessage,suchastheSOAP
messagesusedbyanMPIwebservice,Cloverleafrequiresaschemadocumentthat
describestheformatoftheXMLmessage.
2076576-008A
MUSE™CardiologyInformationSystem
25
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
CreatinganXMLPackageinCloverleaf
NOTE:
IfusingtheXMLpackagefolder MPI_Schemashippedwiththehl7_soap_multreq/
hl7_soap_singreqthenthissectioncanbeskipped.TheMPI_Schemashipped
withthetemplateisforreference.Itcanbebackedupwithadifferentnameand
thefollowingstepscanbeusedtocreateanewXMLPackageMPI_Schema.
UsethefollowingproceduretocreateanXMLpackageinCloverleaf.
1. OntheCCGserver,starttheCloverleafIDE.
2. OntheToolspane,ontheleftsideofthescreen,clickCongurationtoexpand
theCongurationtoolbar .
3. ClicktheXMLicon .
TheCLOVERLEAF(R)IntegrationServices:XMLPackageManagerwindow
opens.
4. OntheServerPackageViewerpane,highlightandright-clickonthexmlfolder.
26
MUSE™CardiologyInformationSystem
2076576-008A
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
5. SelectNewPackage/Folder.
TheCreateaNewFolderwindowopens.
6. IntheNewFolderNameeld,enterMPI_Schema.
7. IntheFolderType:eld,verifythatXMLisselected.
IfXMLisnotselected,usethedrop-downlisttoselectit.
8. ClickOK.
9. ToviewtheMPI_Schemaxmlfolder,youmayneedtoexpandtheHostServer>
xml folders.
GeneratingXSDFiles
UsethefollowingproceduresandinformationtogenerateXSDles.
2076576-008A
MUSE™CardiologyInformationSystem
27
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
WhyGenerateXSDFiles?
Whenyouaccessawebservicefromthesystem,usetheWSDLthatdescribesthe
webservicethesystemisattemptingtoaccess.ThiscreatesanXSDlethatdescribes
themessagesyouwanttosendbackandforth.
YoucancompiletheXSDleinasystemXMLpackageforcreatingtransformations
betweentheSOAPmessagessenttoandfromthewebservice,andwhatevertarget
messageformatyouuseinternallytoprocesstherequest.
TheXSDWSDLtoolreadstheWSDL,generatestheXSDlesforinputandoutput
messagestotheservice,andcompilesthenewly-generatedXSDles.
BeforeYouRuntheXSDWSDLTool
ThefollowingtasksmustbecompletedbeforerunningtheXSDWSDLtooltogenerate
andcompileXSDles:
•BoththesystemandCAA-WSmustbeinstalledproperly.
•TheremustbeanXMLpackagedirectory.
See“ImportinganXMLSchemaintoCloverleaf”onpage25.
•Acommandwindowmustbeopentothefollowingdirectory:
CCG_INSTALL_DIR\quovadx\cis6.0\integrator\CAA\ws\tool\xsdWsdlToolClient .
•Inthecommandwindow,runsetroot.
•Inthecommandwindow,runsetsitehl7_soap_singreqorhl7_soap_multreq.
RunningtheXSDWSDLTool
UsethefollowingproceduretoruntheXSDWSDLtooltogenerateandcompileXSD
les.
1. Aftersettingtherootandthesiteasreferencedin“BeforeYouRuntheXSD
WSDLTool”onpage28,inthecommandwindowrunthefollowingbatchle
commandtostartthetool:xsdWsdlToolClientGUI.bat.
TheinterfaceopensandallentriesareblankwiththeWSDLURIeldselected.
2. EntertheURItotheWSDLyouwanttouse.
3. Selectoneofthefollowingcheckboxes:
•Showfullyqualiednames
28
MUSE™CardiologyInformationSystem
2076576-008A
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
ThenamesfromtheWSDLthathaveanamespaceassociatedwiththemare
printedwiththenamespaceprexedbeforethename.
•PrintWSDLcontentsafterloading
PrintstheWSDLtextcontentsafterloading.
4. ClickLoadWSDL.
TheprogramattemptstoreadtheWSDLfromthelocationspecied.
•IfitcannotndtheWSDL,anerrorprintsintheResultssection.
•IfitndstheWSDLandcanparseit,theServicedrop-downeldpopulates
withthelistofservicesintheWSDL.
5. SelecttheappropriateServicefromthelist.
NOTE:
Ifthereisonlyonechoiceinthedrop-downlist,itisautomaticallyselected.
ThePortlistpopulates.
6. SelecttheappropriatePort.
TheBindingandPortTypeeldsdisplaythenameoftheBindingandPortType
associatedwiththechosenportfromtheWSDL.
7. SelecttheOperationtoinvokeit.
TheInputMessageandOutputMessagearepopulatedwiththenamesofthe
messagesforthisoperation.
8. SelecttheTargetXMLPackage.
ThisistheXMLpackageinyoursitewhereyouwanttogenerateandcompile
theXSDs.
9. EntertheTargetXSDFilename.
TheFullInputFilenameandFullOutputFilenameeldsdisplaythefullpath
namesoftheresultingXSDlesthataregenerated.
10. ClickGenerateandCompileTargetXSDs.
Thistakestheselectedsettings,pullstherelevantinformationfromtheWSDL,
andcreatestwoXSDles:InputandOutput.
2076576-008A
MUSE™CardiologyInformationSystem
29
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
TheseleshaveSOAPenvelopesaroundthecontentchosensotransformations
inthesystemcangeneratetheentireSOAPenvelopetosendtoawebservice
andparsetheresponseSOAPenvelope.
ThesystemcompilestheXSDsintoOCMles,whicharewhatthesystemuses
directlytoallowtranslationinthegivenXMLstructure.
•Ifthegenerationorcompilationfail,anexceptionmessagedisplaysa
descriptionoftheproblem.
•Ifthegenerationandcompilationsucceed,theresultlookssimilartothe
followingscreen,conrmingthattheXSDgenerationandcompilationwere
successful.
NOTE:
The.OCMlesandthe.XSDlesaregeneratedbythetoolatthefollowing
location:<C:\gehc-it\ccg\quovadx\cis6.0\integrator\hl7_soap_singreq\
formats\xml\MPI_Schema>
CreatingaRequestTranslationFile
NOTE:
IthasbeenobservedthatCloverLeafXLATEdoesn'talwaysworkwithcustomer
providedXSD.TPStranslationwillberequiredifthisdoesnotwork.
ThemappingofHL7andXMLeldsisdependentuponthecustomersite.This
procedureisageneralguidelinedescribinghowtocreatearequesttranslationle.
TheITPSteammayneedtobeinvolvedincreatingarequesttranslationleto
properlymaptheelds.
1. OntheCCGserver,starttheCloverleafIDE.
2. OntheToolspane,clickCongurationtoexpandtheCongurationtoolbar.
3. ClicktheTranslationConguratoricon
TheCLOVERLEAF®IntegrationServices:TranslationConguratorwindow
opens.
30
MUSE™CardiologyInformationSystem
.
2076576-008A
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
4. PressCtrl+Ntocreateanewtranslationle.
TheChooseFileFormatswindowopens.
5. SelectthefollowingforInputRecordFormat:
•Format=HL7
•Version=2.4
•Message=QRY_Q01
6. SelectthefollowingfortheOutputRecordFormat:
•Format=XML
•Package=MPI_Schema
•XML=[nameoftheXMLschema]
•Root=[nameofSOAPEnvelopeentity]
2076576-008A
MUSE™CardiologyInformationSystem
31
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
Thecompleteddialogboxshouldlooksimilartothefollowingscreen:
7. ClickOK.
8. MaptheHL7eldstotheappropriateXMLelds.
Forexample,maptheQRD-WhoSubjectFilter-IDNumber(whichisthe
PatientID)totherequesteldthatistocontainthePatientIDnumber).Work
withtheITPSteamtocompletethisstep.
9. TheXMLmessagerequiresyoutodeneanumberofconstants.
Asaminimum,youneedtodenethexmlversion,xmlencodingandsoap
envelopenamespace(xmlns) elds.WorkwiththeITPSteamtocompletethis
step.
Constantsareenteredbyprecedingtheconstantvaluewithanequalssign(= ).
Forexample,usethefollowingvaluesorXMLversionandencoding:
•Version=1.0.
•Encoding=UTF-8.
32
MUSE™CardiologyInformationSystem
2076576-008A
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
Youmayobtaintheconstantsneededforthesoapenv:Envelopexmlnselds
fromtheXXXXRequest.xmlle.
10. Aftertheappropriateelds(includingthesoapenv:Envelopeelds)aremapped,
savetheleasQ01_to_XXXXRequest.xlt.
CreatingaResponseTranslationFile
ThemappingofHL7andXMLeldsisdependentuponthecustomersite.This
procedureisageneralguidelineofhowtocreatearesponsetranslationle.The
ITPSteammayneedtoassistincreatingaresponsetranslationletoproperlymap
theelds.
1. OntheCCGserver,starttheCloverleafIDE.
2. OntheToolspane,clickCongurationtoexpandtheCongurationtoolbar.
3. ClicktheTranslationConguratoricon
.
TheCLOVERLEAF®IntegrationServices:TranslationConguratorwindow
opens.
4. PressCtrl+Ntocreateanewtranslationle.
TheChooseFileFormatswindowopens.
5. TocreateanInputRecordFormatselectthefollowingvaluesforeacheld:
•Format=XML
•Package=MPI_Schema
•XML=[nameofXMLschema]
•Root=[nameofSOAPEnvelopeentity]
2076576-008A
MUSE™CardiologyInformationSystem
33
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
6. SelectthefollowingfortheOutputRecordFormat.
•Format=HL7
•Version=2.2
•Variant=muse_IB_22
•Message=ADT_A19
7. ClickOK.
8. MaptheXMLeldstotheappropriateHL7elds.
Thisstepiscustomer-specicandvariesfromcustomertocustomer .Workwith
theITPSteamtocompletethisstep.
Asaminimum,thefollowingADT_A19eldsmustbemapped:
•AAmappedtoMSA.#1(Acknowledgementcode)
•PatientIDtoPID.#3(InternalID)
•Visitnumber(orPIDifvisitnumberisnotavailable)toPV1(VisitNumber)
NOTE:
Wherethereisapatientfounderror,thetranslationlogicbuildingthe
ADT_A19 messageshouldleavethePIDblanksothatthehl7_soap_singreq
site'srestoreA19SiteID.tclscriptcanapplytheproperMSAerrorcoding.
9. Whenalloftherequiredeldsaremapped,savetheleas
XXXXResponse_to_A19.xlt .
ConguringCloverleafTranslationRoutes
UsethefollowingproceduretoconguretheCloverleaftranslationroutes.
1. OntheCCGserver,starttheCloverleafIDE.
2. OntheToolspane,clickCongurationtoexpandtheCongurationtoolbar.
3. SelecttheNetworkConguratoricon
TheNetcongtabopens.
.
34
MUSE™CardiologyInformationSystem
2076576-008A
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
4. Right-clickonthehl7_adtquerythreadandselectThreadProperties.
TheThreadConguration—hl7_adtquerywindowopens.
5. SelecttheRouteMessagestab.
6. IntheQRY_Q01routefolder,selectsoap_adtquery.
7. Double-clickontheQRY_Q01folderandhighlightsoap_adtquery.
8. SelectXlateandclickProperties.
TheXlateRouteDetailswindowopens.
9. NexttotheXlate:eld,clicktheListbutton.
10. SelecttheQ01_to_XXXXRequest.xltleandclickApply.
11. ClickOK.
12. ClickOKtoclosetheThreadCongurationwindow.
IfaCreateDirectorywindowopens,clickYes.
13. Right-clickonthesoap_adtquerythreadandselectThreadProperties.
TheThreadCongurationwindowopens.
14. SelecttheRouteRepliestab.
15. SelectXlateandclickProperties.
2076576-008A
MUSE™CardiologyInformationSystem
35
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
16. NexttotheDestinationeld,clicktheListbutton.
17. Selecthl7_adtqueryfromthelist.
18. NexttotheXlateeld,clicktheListbutton.
19. SelecttheXXXXResponse_to_A19.xltle.
TheXlateRouteDetailswindowopens.
20. ClickOK.
21. ClickOKtoclosetheThreadCongurationwindow.
22. PressCtrl+StosavetheNetCong.
23. SavethecurrentCCGviewbyselectingView>SaveViews.
ConnectingtheMUSESitetothehl7_soap_singreqSite
UsethefollowingproceduretochangeCloverleafsitesandconnecttheMUSEsite
tothehl7_soap_singreqsite.
1. OntheCLOVERLEAF(R)...window,selectServer>Change.
Ifawarningmessageisdisplayed,clickYes.
TheCLOVERLEAF(R)IntegrationServiceswindowopens.
2. Selectthemuse_prodsiteandclickApply.
TheNetcongtabopenswithastandardMUSEsitedisplayedinthewindow.
36
MUSE™CardiologyInformationSystem
2076576-008A
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
3. ToconnecttheMUSEADTQueryfeaturetotheMUSEprodsite’smuse_adtquery
thread,asiftheMUSEsystemwereinteractingwithaHIS,followtheinstructions
intheMUSECardiologyInformationSystemInstallationGuide.
2076576-008A
MUSE™CardiologyInformationSystem
37
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
4. Congurethepropertiesofmuse_adtquerytochangeEncodingtobinaryfor
allcountrieswhichusespecialcharacterslikeGermany,Sweden,Denmark
andsoon.
ThedefaultvalueisUTF-8.
38
MUSE™CardiologyInformationSystem
2076576-008A
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
5. InplaceofaHIS,attachthe muse_prodsite’shis_adtquerytothe
hl7_soap_singreqsite.
Toattachthesites,setthe his_adtquerythread’sprotocolpropertiesHostto
localhost andPortto9100asshowninthefollowingscreen:
6. ClickOKtoclosethePDLTCP/IPProtocolPropertieswindow.
7. SelectView>SaveViewstosavethepresentCCGview.
ConrmingCAA-WSandCloverleafConguration
ConrmthattheInforCloverleaf
1. OntheCCGIDECloverleafmenubar,changeCloverleafsitesbyselectingServer
>Change.
Ifawarningisdisplayed,clickYes.
2. Selectthehl7_soap_singreqserverandclickApply.
3. OntheToolsmenu,selectRuntimetoexpandtheRuntimetoolbar .
2076576-008A
MUSE™CardiologyInformationSystem
®
IntegrationServices6.0serviceisrunning.
39
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
4. ClicktheNetworkMonitoricon .
TheNetworkMonitortabopens.
5. Right-clickonthebuttonwiththenameofyourprocessandselectControl>
Startup tostarttheprocess.
Inthefollowingsamplescreen,itisthehl7_soap_singreqbutton.
6. Conrmthattheprocessesandthreadsdisplayedchangefromredtogreen,
andthatthethreadsdisplaythestatusofeitherOpeningorUp.
7. Right-clickagainonthegreenhl7_soap_singreqbuttonandselectControl>
Full .
TheProcess'hl7_soap’Cont...windowopens.
8. ClickEOcongtochangetheCloverleafprocesslogginglevel.
TheEOCongwindowopens.
40
MUSE™CardiologyInformationSystem
2076576-008A
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
9. ClickList….
Adialogboxopens.
10. Selectenable_all_infoandclickApply.
TheEOAliaswindowopens.
11. Selectenable_all_infoandclickApply.
TheEOCongwindowopens.
12. ClickOKtoclosetheEOCongwindow.
13. DonotclosetheFullControlwindow.
Clickthewatchoutputbutton.
TheWatchLogleforprocessadtquerywindowopenscontaininglog
messages.
Ifthereisaproblemwiththetesting,viewthislogtotroubleshoottheissue.
2076576-008A
MUSE™CardiologyInformationSystem
41
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
14. OntheMUSECCGCD,locatetheHL7TestTool.zipleandextractthecontentsof
thezipleintoyourtemporarydirectory.
TheresultshouldbeanHL7TestTooldirectorycontainingHL7testtoolles.
15. OntheMUSECCGCD,locatetheQRY_Q01.hl7leandcopytheletoyourMy
Documents directory.
16. NavigatetotheHL7TestTool\bindirectory.
17. Locateandeditthelaunchpad.batle.
EditthelebyaddingtheJVMpathoftheCCG(c:\gehc-it\_jvm\bin\ )tothe
javacommand.
18. Savethelaunchpad.batle.
19. OpenanExplorerwindow.
20. Navigateandopenthefolderthatcontainsthelaunchpad.batle.
21. Double-clickthelaunchpad.batle.
TheHL7TestTool:...windowopens.
22. SelecttheMessageEditortab.
23. IntheRemoteSystemhostnameeld,enterthecomputernameoftheCCG
Server.
24. InthePortNumbereld,enter9100.
25. ClickSelectHL7File,selecttheQRY_Q01.hl7lethatisinyourMyDocuments
folder,andclickOpen.
26. ClickSend.
IftheHL7Testtoolisissuingaconnectionerror ,youmayhavealreadyactivated
themuse_adtquerythreadintheCloverleafmuse_prodsite.Completethe
followingsteps:
1. Shutdownthemuse_adtquerythread.
2. Returntothehl7_soap_singreqsite.
3. SelectNetworkMonitor.
4. Reopenthewatchoutputwindow.
27. OntheCloverleafmenubaroftheCloverleafIDE,changesitesbyselecting
Server >change .
42
MUSE™CardiologyInformationSystem
2076576-008A
28. Selectthemusesite.
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
29. ClickontheNetworkMonitoricon
.
TheCLOVERLEAF(R)IntegrarionServices:NetworkMonitor...windowopens.
30. Ensurethatthemuse_adtquerythreadisnotrunningbyconrmingthatitisred.
Ifthethreadisrunning,stopthethread:
1. Right-clickontheadtquerybutton.
2. SelectControl>Shutdown.
31. ConrmthatanA19messagewithexpecteddataisdisplayedintheresponse
window.
Thisisaversion2.2HL7message.
Ifthatmessageisnotdisplayeddothefollowingsteps:
1. ExaminetheCloverleaflogwindowforerrormessages.
2. Correcttheerrorsbeforecontinuingwiththisprocedure.
32. OntheCloverleafmenubar,changeCloverleafsitesbyselectingServer>
Change .
Ifawarningwindowopens,selectYes.
33. Selectthemuse_prodsiteandclickApply.
34. ClicktheNetworkMonitoricon
.
TheCLOVERLEAF(R)IntegrationServices:NetworkMonitor...windowopens.
35. Starttheadtqueryprocess:
a. Right-clickontheadtqueryprocessbutton.
b. SelectControl>Startup .
36. Conrmthattheadtqueryprocessesandthreadturnfromredtogreen,and
thatthethreadsdisplayastatusofeitherOpeningorUp.
2076576-008A
MUSE™CardiologyInformationSystem
43
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
37. IntheHL7Testtool,makesurethattheMessageEditortabisselected.
a. IntheRemoteSystemhostname,enterthecomputernameoftheCCG
Server.
b. InthePortNumbereld,entertheportthemuse_adtqueryuses(the
defaultis9005).
38. ClickSelectHL7File.
39. SelecttheQRY_Q01.hl7leinyourMyDocumentsfolder,andclickOpen.
40. ClickSend.
41. ConrmthatanA19messagedisplaystheexpecteddataintheresponse
window.
Themessageshouldbeaversion2.4HL7message.
FinalizingtheConguration
Usethefollowingproceduretonalizetheconguration.
1. FollowtheinstructionsintheMUSECardiologyInformationSystemInstallation
Guide tocongureCCGAutostart.
PerformingCleanup
Remembertoaddthehl7_soap_singreqsitetotheautostartscript.
2. Addthehl7_soap_singreqsitetotheSmatCycle.
Oncethesystemisoperatingsmoothly,youmayarchiveordeletethetemporary
lesyoucreated.
44
MUSE™CardiologyInformationSystem
2076576-008A
Troubleshooting
CommonProblems
3
Usethissectiontoresolvecommonproblemsyoumayencounterduringthe
congurationoftheCCGMPIserver.Ifyourproblemisnotlistedinthefollowingtable,
contacttheITPSteamortheonlinecenter.
Followingisalistofcommonproblemsandtheirsolutions.
2076576-008A
MUSE™CardiologyInformationSystem
45
Troubleshooting
Symptom
Noresponse,andthelog
fortheprocessdisplaysan
errormessagesimilartothe
following:
ProbableCause Solution
ThereareXMLeldsthat
arenotbeingdenedinthe
Q01_to_XXXXRequest.xlt
translationle.
Reviewthetranslationle
formissingconstantsor
mappings.
[xpm:xlt:WARN/
0:adtquery_soaper_xlate:06/
04/200914:35:18]Message
encodewarnings:Error
generatedduringparsing.–
Notenoughelementsto
matchcontentmodel:
‘(soap:Header,soap:Body)’
forelement‘soap:Envelope’
–Line1,Col367
Siteprocessesdonotstart. Usethefollowingprocedure
toresetCloverleaf.
1. Switchtothesitewhich
hasthisproblemusing
theServer>Change
optionintheQDXIDE.
2. OntheRuntimetab,
clicktheShellwindow
toopenupacommand
promptwindow.
3. Enterthefollowing
commandstostopthe
MonitorDaemon and
reinitializethedatabase:
hcienginestop-p
process_name
hcisitectl-K
hcidbinit-AC
4. Usethefollowing
commandstorestart
thehcimonitorandthe
LockManager :
hcisitectl-S
hcienginerun-p
process_name
46
MUSE™CardiologyInformationSystem
2076576-008A
Troubleshooting
Symptom
Noresponse,andthelog
fortheprocessdisplays
anerrormessagesimilar
to:restoreMuseA19SiteID:
InvalidPatientID...Squelch
Response...Checktheerror
database
Monitor/Processdoesnot
startafterasystemcrash.
ProbableCause Solution
Theerrormessageindicates
theADT^A19messagedoes
notcontainapatientID
numberthatmatchesthe
originalrequest.Thismaybe
aPIDmappingissue.
Usethefollowingprocedure
toxCloverleaf:
1. Changetothesitethat
hasthisproblemusing
theServer>change
optionintheQDXIDE.
2. IntheRuntimetab,click
ontheShellwindowto
openupacommand
promptwindow.
3. Enterthefollowing
commandtostopthe
MonitorDaemon:
hcisitectl-K .
4. Changethedirectory
totheexecfolder
anddeletethe
sharedmemoryle
monitorShmemFile .
5. Usethefollowing
commandtorestart
thehcimonitorandthe
LockManager .:
hcisitectl-S
2076576-008A
MUSE™CardiologyInformationSystem
47
Troubleshooting
48
MUSE™CardiologyInformationSystem
2076576-008A
SupportMaterial
OpeningtheWSConguratorInterface
Usethefollowingproceduretoopentheinterface.
1. Toopentheinterface,double-clickthejarlefromalebrowserorrun
java-jarWSCongurator.jarfromthecommandline.Thisisfoundat
integrator/CAA/ws/tools/WSCongurator.jar.
Theprogrampicksthedefaultdirectoryinwhichtoreadandsavelesby
lookingatyourenvironmentvariablesandchoosingthelethatispresentas
thedefault:
•$HCISITEDIR
•$CL_INSTALL_DIR
Ifneitheroftheselesarepresent,theprogramlooksforthehomedirectory.
A
2. IntheLogicalView,openanexistingcongurationle(File>Open),orstarta
newcongurationle.
2076576-008A
MUSE™CardiologyInformationSystem
49
SupportMaterial
CreatingaNewClientCongurationFile
StartanewclientcongurationbyaddingClientlogicalobjects.
1. OpentheWebServices(WS)Conguator.
2. SelecttheClienttab.
Amenuisdisplayed.
3. UsethemenutoselecttheappropriateClientobjectsforyoursystem.
CreatingaNewServerCongurationFile
Startanewservercongurationbyaddingnewserverobjects.
1. OpentheWSConguator.
2. SelecttheServertab.
Amenuisdisplayed.
3. UsethemenutoselecttheappropriateServerobjectsforyoursystem.
50
MUSE™CardiologyInformationSystem
2076576-008A
UsingtheLogicalandPhysicalViews
Afteraddingclientandserverobjects,theLogicalViewlookssimilartothefollowing
screen:
ThePhysicalViewlookssimilartothefollowingscreen:
SupportMaterial
PhysicalViewPanels
Panel
Leftpanel AtreeviewdisplayinghestructureoftheXMLdocumentthatyouare
Rightpanel Thepropertiesofanyelementthatisselectedontheleftpanel.
Bottompanel Context-sensitivehelpthatdisplayshelpforthelasttimeselectedon
2076576-008A
Description
building.
eithersidepanel.
MUSE™CardiologyInformationSystem
51
SupportMaterial
Afteryousavethecongurationle,thenameisdisplayedintherootnodeofthe
PhysicalView .
NOTE:
Fromthispointon,youcanopenthecongurationleandcontinueeditingit
usingeitherview,oryoucantogglebetweenthetwoviewsatanytime.
EditingaFile
IftheClientisdeployedtoanotherdevice,theWSDLmustbeavailableatthesame
absolutepathoritneedstobearelativepath.RelativepathsbeginfromtheJava
Driverthread’sworkingdirectory.
Forexample,whenthesitehastheworkingdirectorylistedasWSunderthesite:
•IftheWSDLisinthatdirectory,setp:wsdlLocationtothelenameoftheWSDL.
•Ifitisinasubdirectory(forexamplewsdls),setthelocationtoarelativepath(for
examplewsdls/myWsdl.wsdl).
Whenthesiteisdeployedonanotherserver,itusestherelativepathwithinthesite
insteadofanabsolutepaththatmightnotexistonthatdevice.
NOTE:
ThisisnotaproblemforWSDLsatanHTTPURL,assumingthesameURLis
availablefrombothdevices.
ToedittheexistingcongurationXMLfromthehl7_soap_singreqsite,
openthexmllefromthepathC:\gehc-it\ccg\quovadx\cis6.0\integrator\
hl7_soap_singreq\javadriver\hl7_adt_soap_singreq\ usingtheWSCongurator.
UsingtheLogicalandPhysicalView
Therearetwoviewsthatyoucanusetosetupaconguration.Thedifference
betweenthePhysicalViewandLogicalViewhighlightsthecomplexityoftheXML
structureinthecongurationle.
•LogicalView
ThepropertiesoftheClientaredisplayedontherightpane.Usethisviewtoenter
orselecttheproperties.
YoudonotneedknowledgeoftheactualXMLelementstosetupaconguration
usingthisview.
52
MUSE™CardiologyInformationSystem
2076576-008A
SupportMaterial
Hoveringoverapropertyopensatooltipexplainingtheproperty.Thisprovidesan
easierviewwithwhichtowork.
•PhysicalView
ThisviewprovidesdetaileddescriptionsoftheXMLelementsandtheirmeaning,
anddisplayswhatyoucanexpectfromtheequivalentXMLandtheoperationsthat
youcanperforminthatview.
UsethisviewasalearningtooltodisplayhowtheactionstakenontheLogical
View translateintotheactualXMLstructure.
Inthisexample,twoelementswerecreated(XMLelementsfromtheXMLletheWS
Conguratorgenerates):
•bean
•jaxwsclient
NOTE:
Someelementshavepropertiesthataredisplayedintherightpanelwhenthat
elementisselectedonthetree.ThesepropertiesareattributesintheXML
letheWSConguratorgenerates.
2076576-008A
MUSE™CardiologyInformationSystem
53
SupportMaterial
CreatingandDeletingElements
Theright-clickmenuiswhereyoudeleteanelementandaddchildelements.
Right-clickingaClientelementdisplaysitsavailablechoices.
Selectingfeaturescreatesanemptyfeatureselement,asdisplayedinthefollowing
screen:
Atthebottomofthewindow,thecontext-sensitivehelpdisplaysthefeaturesavailable
forthistypeofClient.
TheSOAPClientsupportsWS-Addressing,whichsendsWS-Addressingheadershaving
appropriatevaluesbasedontheWSDLandthemessagebeingsent,aswellasa
loggingfeaturethatlogsinboundandoutboundmessages.
1. Toaddfeatures,selectthefeatureselement.
2. Right-clicktheitemsyouwanttocreate.
54
MUSE™CardiologyInformationSystem
2076576-008A
UsingthePropertiesChild
ApropertieschildelementcanexistunderClientelements.Thishasaarrayofentry
elementsunderitthatchangethebehavioroftheClientinanumberofways.
Whenyouselectthekeypropertyoftheentry,theHelpinformationatthebottomof
thewindowprovidesalistofsuggestedvalues:
•Cloverleaf
Valuesstartingwithcloverleaf-affecthowtheClientinteractswiththesystem.
SupportMaterial
•CXF
OthervaluescomefromCXFandmodifyCXFbehavior.Thesystemonlylists
currentlyknownones.
YoucanenterothervaluesfoundintheCXFdocumentationorcode,eventhough
theinterfacedoesnotmentionthem.
•Knownvalues
Enteringoneoftheknowvaluesandclickingthevaluepropertydisplaysthe
context-sensitivehelpforthatkey.
Inthefollowingscreen,thevalidvaluesaredisplayedtosetforthecloverleaf-trxid
propertyinordertocontrolthetrxIDfromthemessageinthesystem.
2076576-008A
MUSE™CardiologyInformationSystem
55
SupportMaterial
CreatingaNewSOAPServer
UsethefollowingproceduretocreateanewSOAPServer(Provider).
1. OntheWSConguratorwindow,selectServer>NewSOAPServer.
TheAddSOAPServerwindowopens:
56
MUSE™CardiologyInformationSystem
2076576-008A
Thehelpinformationatthetopofthewindowexplainsthegeneralow.
2. IntheWSDLURIeld,entertheWSDLandanyreferencedXSDleswithin
theworkingdirectoryfortheJavadriverthread(orasubdirectoryofit)and
referenceitwitharelativepath.
Forexample,aWSDLXDS.b_DocumentRegistry.wsdlisinthe
WS/XDSb.Support.Materias.v10/wsdl directory,whereWSistheworking
directory.
SupportMaterial
Ifthisserviceisdeployedtoanotherdeviceandthatsameexactpathdoesnot
exist,theservicecannotndtheWSDLandfailstostart.
3. ClickBrowsetolocatethedirectorywhereWSDLispresent.
4. ClicktheLoadWSDLbuttontoloadtheWSDLle.
TheServiceeldispopulatedfromtheWSDLafteritisloaded.Ifthereisonly
oneentry,theinterfaceautomaticallyselectsit.
ThePorteldispopulatedafterselectingtheService.Ifthereisonlyoneport
usingthisservice,itisauto-selected.
TheAddresseldisforaddressoverrides.Youmayleavethiseldblank.
5.PublishedAddressisanoptionaleldforpopulatingtheaddressinthe
generatedWSDLwhenaClientadds?wsdltotheserviceaddress.
Forexample,aserviceresidesonadevicewithinacompany’s
rewallnamedamagin42,buttheoutsideworldisroutedintothis
deviceusingtheDNSnamecloud.amazing.com.Iftheserviceisat
http://amazing42/myservce ,youcanreachtheWSDLwithinthenetworkby
callinghttp://amazing42/myservice?wsdl.ThisgeneratesaWSDLwiththe
serviceaddressasexpected:http://amazing42/myservice.
Thisworksforinternaltesting,butwhentheoutsideworldcallsitat
http://cllud.amazing.com/myservicce?wsdl ,apublicserviceaddressother
thanhttp://amazing42/myserviceneedstobereturnedortheirClientsfail
withoutaddressoverrides.
2076576-008A
MUSE™CardiologyInformationSystem
57
SupportMaterial
Inthiscase,enter http://cloud.amazing.com/myserviceinthePublished
Addresseld.ThereturnedWSDLnowhasthecorrectserviceaddresstocalling
users.
6. ForServiceModeinformation,seestep7in“CreatingaNewSOAPClient”on
page21.
UsingtheLogicalandPhysicalViews
ThefollowinginformationdescribestheLogicalViewandPhysicalViewintheSOAP
Server.
•LogicalView
Thepropertiesofthisserverarefoundontherightpanelwhereyoucanenteror
selectthemfromadrop-downlist.Hoveringoverapropertyopensthetooltipthat
explainstheproperty.
•PhysicalView
NOTE:
Thefollowingscreendisplaywhatyoucouldseefromtheequivalent
PhysicalView andthevariousoperationsperformedonthatview,withdetail
descriptionsofmanyoftheXMLelementsandtheirmeaning.
ThisdifferencebetweenthePhysicalViewandLogicalViewhighlightsthe
complexityoftheXMLstructureinthecongurationleandwhytheLogical
View providesabetterview.
EndpointElement
58
MUSE™CardiologyInformationSystem
2076576-008A
SupportMaterial
The PhysicalViewhasoneendpointelement,unlikeaClient,whichhasapaired
beanelement.
SimilartotheClientelement,theEndpointelementcanhavefeaturesandproperties
children,correspondingtotheeldsselectedorsetintheLogicalView.
Toseethecontext-sensitivehelp,whichisalistofallowablekeys:
1. Selectanentryintheleftpanel,andinthePropertiespanel,clickkey.
2. Clickvaluetoseetheallowablevaluesforthatkey.
SimilartotheClient,thecloverleaf-nameditemsarespecictoworkingwiththe
system,andtherestareCXFgenericvalues.
2076576-008A
MUSE™CardiologyInformationSystem
59
SupportMaterial
60
MUSE™CardiologyInformationSystem
2076576-008A
ViewTrustedCerticates
ViewCerticatesintheTrustedRootCertication
Authorities
InformationisprovidedforusingtheMicrosoftManagementConsole(mmc.exe )to
viewthetrustedcerticatesinstalledonyourmachine.
1. ClickStart,intheStartSearch,typemmc,andthenpressEnter.
TheUserAccountControlwindowmayopenaskingifyouwantallowchanges,
clickYes.
MicrosoftManagementConsolewillopen.
2. ClickFile>Add/RemoveSnap-in.
TheAddorRemoveSnap-inswindowopens.
B
3. InAvailablesnap-ins,clickCerticates,andthenclickAdd>.
TheCerticatessnap-inwindowopens.
4. InThissnap-inwillalwaysmanagecerticatesfor:,selectComputeraccount,
andclickNext.
TheSelectComputerwindowopens.
5. SelectLocalcomputerandclickFinish.
6. Ifyouhavenomoresnap-instoaddtotheconsole,clickOK.
7. Intheconsoletree,double-clickCerticates.
8. ClicktheTrustedRootCerticationAuthoritiesstore>Certicatestoviewall
thetrustedrootcerticatesonthemachine.
2076576-008A
MUSE™CardiologyInformationSystem
61
Index
A
AddinHTTPConduitto
CongurationFile24
Assistance12
C
CommonDocumentation
Library(CDL)2
CommonProblems45
compliance2
ConguringCAA-WS
Overview
CreatingNewClient
CongurationFile50
CreatingNewServer
CongurationFile50
EditingaFile52
OpeningWSCongurator
Inferface49
UsingLogicaland
PhysicalViews51
ConguringCloverleaf
TranslationRoutes34
ConrmingCAA-WSand
CloverleafConguration39
ConnectingMUSESystem
toMPI15
ConnectingtheMUSESite
toHL7Site36
conventions
document11
illustrations12
Notes12
typographical11
ConvertingCerticatefrom
P12toJKS18
CreatingaRequest
TranslationFile30
CreatingaResponse
TranslationFile33
CreatingaSOAPClient
UsingLogicaland
PhysicalView52
UsingRight-ClickMenu54
UsingthePropertiesChild55
CreatingNewSOAPServer56
CreatingSSLSecurity
Certicate17
D
document
partnumber2
revision2
documentconventions11
F
FinalizingConguration44
G
GEHealthcare
CommonDocumentation
Library(CDL)2
manuals2
GeneratingXSDFiles28
I
illustrationconventions12
ImportingXMLSchemainto
Cloverleaf25
InstallingandConguring
CCG,MUSE,HL7,and
CloverleafSites16
N
Notesconventions12
O
OEM2
OriginalEquipment
Manufacturer(OEM)2
P
partnumber
document2
62
MUSE™CardiologyInformationSystem
2076576-008A
PerformingCleanup44
R
revisionhistory2
T
Troubleshooting45
CommonProblems45
typographicalconventions11
2076576-008A
MUSE™CardiologyInformationSystem
63
64
MUSE™CardiologyInformationSystem
2076576-008A
GEMedicalSystems
InformationTechnologies ,Inc.
8200WestTowerAvenue
Milwaukee,WI53223USA
Tel: +14143555000
+18005587044(USOnly)
Fax:+14143553790
GEMedicalSystems
InformationTechnologies GmbH
MunzingerStraße5
D-79111FreiburgGermany
Tel: +497614543-0
Fax:+497614543-233
AsiaHeadquarters
GEMedicalSystems
InformationTechnologies ,Inc.
Asia;GE(China)Co.,Ltd.
1HuatuoRoad
ZhangjiangHi-techParkPudong
Shanghai,People'sRepublicofChina201203
Tel: +862138777888
Fax:+862138777451
GEMedicalSystemsInformationTechnologies,Inc.,aGeneralElectricCompany,goingtomarketas
GEHealthcare.
www.gehealthcare.com