General Electric MUSE CCG Master-Patient Index Server Configuration_SM_2076576-008_A MUSE Cardiology Information System CCG Master-Patient Index Server Configuration Software Version CCG v9.2 2059568-024 Revision B

GEHealthcare
MUSE™CardiologyInformationSystem
CCGMaster-PatientIndexServerConguration
SoftwareVersionCCGv9.2 2076576-008RevisionA
English ©2014GeneralElectricCompany. AllRightsReserved.
TheinformationinthismanualappliesonlytotheMUSESystemVersion8.0.Itdoesnotapplytoearlierproductversions.Duetocontinuing productinnovation,specicationsinthismanualaresubjecttochangewithoutnotice.
MUSEandMACaretrademarksownedbyGEMedicalSystemsInformationTechnologies,Inc.,aGeneralElectricCompanygoingtomarket asGEHealthcare.Allothertrademarkscontainedhereinarethepropertyoftheirrespectiveowners.
Thisproductcomplieswiththerequirementsconcerningmedicaldevicesfromthefollowingregulatorybodies:
Thedocumentpartnumberandrevisionareatthebottomofeachpage.Therevisionidentiesthedocument’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
25February2014Customerrelease.
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.
Denneservicemanualndeskunpå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.
Ezengyelmeztetésgyelmenkí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áraosti,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åndbokennnesbarepå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ärservicehandbokennnsbaratillgä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)
CNHBÁO (VI)
Данекерівництвозсервісногообслуговуванняпостачаєтьсявиключноанглійськоюмовою.
Якщосервіснийінженерпотребуєкерівництвоіншоюмовою,користувачзобов'язаний
забезпечитипослугиперекладача.
Ненамагайтесяздійснюватитехнічнеобслуговуванняданогообладнання,якщо
винечитали,абонезрозумілиінформацію,наданувкерівництвізсервісного обслуговування.
Недотриманняцьогозастереженняможепризвестидотравмуваннясервісного
інженера,користувачаданогообладнанняабопацієнтавнаслідокелектричногошоку, механічногоушкодженняабозіншихпричинневірногообслуговуванняобладнання.
TàiLiuHướngDnSaChachỉcóbntiếngAnh.
Nếucácđơnvịcungcpdchvụchokháchhàngyêucumtngônngữnàokháctiếng
Anh,thìkháchhàngsẽcótráchnhimcungcpcácdchvụdchthut.
KhôngđượcsachathiếtbịtrừkhiđãthamkhovàhiuTàiliuHướngdnSacha.
Khôngtuânthủnhngcnhbáonàycóthểdếncáctnthươngchongườithc
hinsacha,ngườivnhànhhaybnhnhân,doscđin,cácrirovềcơkhíhay cácrirokhác.
8
MUSE™CardiologyInformationSystem
2076576-008A
25February2014
Contents
1Introduction
ManualInformation..................................................................................11
IntendedAudience..................................................................................11
ManualPurpose......................................................................................11
DocumentConventions.............................................................................11
RelatedDocuments..................................................................................12
AdditionalAssistance................................................................................12
InterfaceOverview....................................................................................13
2ConnectingtheMUSESystemtoaMaster-PatientIndex
Server(MPI)
InstallationandCongurationProcedures...............................................16
InstallingCCG,MUSESites,andHL7toSoapTemplateCloverleafSite.....................16
CreatinganSSLSecurityCerticate..............................................................17
ConguringCloverleafApplicationAdaptorWebServices
(CAA-WS)...................................................................................................20
CreatingaNewSOAPClient........................................................................21
ConguringXMLinthehl7_soap_singreqSite..................................................23
AddinganHTTPConduittotheCongurationFile.............................................24
ImportinganXMLSchemaintoCloverleaf.......................................................25
GeneratingXSDFiles.................................................................................27
CreatingaRequestTranslationFile...............................................................30
CreatingaResponseTranslationFile.............................................................33
ConguringCloverleafTranslationRoutes.......................................................34
ConnectingtheMUSESitetothehl7_soap_singreqSite......................................36
ConrmingCAA-WSandCloverleafConguration.............................................39
FinalizingtheConguration........................................................................44
PerformingCleanup..................................................................................44
3Troubleshooting
CommonProblems....................................................................................45
ASupportMaterial
OpeningtheWSConguratorInterface...................................................49
CreatingaNewClientCongurationFile..................................................50
CreatingaNewServerCongurationFile.................................................50
UsingtheLogicalandPhysicalViews.......................................................51
2076576-008A
MUSE™CardiologyInformationSystem
9
EditingaFile..............................................................................................52
UsingtheLogicalandPhysicalView.........................................................52
CreatingandDeletingElements...............................................................54
UsingthePropertiesChild.........................................................................55
CreatingaNewSOAPServer.....................................................................56
UsingtheLogicalandPhysicalViews.......................................................58
BViewTrustedCerticates
ViewCerticatesintheTrustedRootCerticationAuthorities................61
10
MUSE™CardiologyInformationSystem
2076576-008A
1

Introduction

Thischapterprovidesgeneralinformationrequiredfortheproperuseofthesystem andthismanual.Familiarizeyourselfwiththisinformationbeforeusingthesystem.

ManualInformation

Thissectionprovidesinformationforthecorrectuseofthismanual. Keepthismanualwiththeequipmentatalltimesandperiodicallyreviewit.You
shouldrequesttrainingassistancefromGEHealthcare,ifneeded.

IntendedAudience

ThismanualisintendedforusebyGEHealthcareFieldServiceEngineers.

ManualPurpose

DocumentConventions

TypographicalConventions
ThismanualprovidestheinformationneededtoinstallandconguretheCloverleaf ApplicationAdapter-WebServices(CAA-WS).Thismanualalsoprovidesinformation ontroubleshooting.
Thismanualusesthefollowingconventions.
ConventionDescription BoldTextIndicateskeysonthekeyboard,texttoenter,orhardwareitemssuchas
buttonsorswitchesontheequipment.
Italicized-Bold
Text
CTRL+ESC
Indicatessoftwaretermsthatidentifymenuitems,buttonsoroptionsin variouswindows.
Indicatesakeyboardoperation.Aplus(+)signbetweenthenamesoftwo keysindicatesthatwhileholdingtherstkey,youshouldpressandrelease thesecondkey.Forexample,PressCTRL+ESCmeanstopressandholdthe CTRLkeyandthenpressandreleasetheESCkey.
2076576-008A
MUSE™CardiologyInformationSystem
11
Introduction
ConventionDescription
<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> OptionstoopentheOptionActivationwindow”replacesthefollowing:
1.Fromthemainmenu,selectSystemtoopentheSystemmenu.
2.FromtheSystemmenu,selectSetuptoopentheSetupmenu.
3.FromtheSetupmenu,selectOptionstoopentheOptionActivation window.
Illustrations
Notes

RelatedDocuments

AdditionalAssistance

Allillustrationsinthemanualareprovidedasexamplesonly.Dependingonsystem conguration,screensinthemanualmaydifferfromthescreensonyoursystem.
Allpatientnamesanddataarectitious.Anysimilaritytoactualpersonsis coincidental.
Notesprovideapplicationtipsoradditionalinformationthat,whileuseful,arenot essentialtothecorrectoperationofthesystem.Theyarecalledoutfromthebody textthroughaagwordandindentation,asfollows:
NOTE:
ThetiporadditionalinformationisindentedbelowtheNOTEagword.
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_multreqsite(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’swithastringthatappropriatelyidentiesthetargetMPI site.
ThecongurationofMPIsupport(CCGCAA-WS:CloverleafApplicationAdapterWeb Services)requiresthefollowing:
•Atexteditor ,suchasMSNotepadorNotepad++.DonotuseMS-Wordpador MS-Word.
•AvalidatingXMLeditor(optional).
CompletethefollowingtaskstoinstallandcongureaCCGsystemwithCAA-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.CreateSSLsecuritycerticates(requiredonlyifhttpsisusedtoaccesstheweb
service).See“CreatinganSSLSecurityCerticate”onpage17.
5.CongureCAA-WS.See“ConguringCloverleafApplicationAdaptorWebServices
(CAA-WS)”onpage20.
6.ImportschemadocumentsspecictotheMPIwebsiteintoCloverleaf.See
“ImportinganXMLSchemaintoCloverleaf”onpage25.
7.CongureCloverleafoutboundtranslationofHL7toSOAPrequestmessage.
See“CreatingaRequestTranslationFile”onpage30.
8.CongureCloverleafinboundtranslationofSOAPresponsemessagetoHL7.
SeeAppendix“CreatingaRequestTranslationFile”onpage30.
9.ConnecttheMUSEsitetothehl7_soap_singreqorhl7_soap_multreqsite.See
“ConnectingtheMUSESitetothehl7_soap_singreqSite”onpage36.
10.Finalizetheconguration.See“FinalizingtheConguration”onpage44.
11.Performcleanup.See“PerformingCleanup”onpage44.
2076576-008A
MUSE™CardiologyInformationSystem
15
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
InstallationandCongurationProcedures
UsethefollowingprocedurestoinstallandconguretheCCG,MUSE,Cloverleafsites, andcreatinganSSLSecurityCerticate.
InstallingCCG,MUSESites,andHL7toSoapTemplate CloverleafSite
UsethefollowingproceduretoinstalltheCCG,MUSEsites,andHL7toSoaptemplate Cloverleafsite.
1.InstalltheCCGfollowingtheinstructionsintheMUSECardiologyInformation
SystemInstallationGuide. AutostartandSchedulingcongurationareperformedaftertheMPIinterfaceis
createdandcongured.
2.AfterinstallingtheCCG,copythestandardMUSE-CCGInterfaceziples
fromtheCCGSitesdirectoryontheMUSEV8SystemApplicationDVDto c:\gehc-it\ccg\extras\interfacesontheCCGserver.
3.IntheCCGSitesdirectoryoftheMUSECCGCD,copyoneofthefollowinglesto
c:\gehc-it\ccg\extras\interfacesontheCCGserver:
•IfmorethanonerequesthastobesenttotheWebServicetorequestfor patientinformation,locateandcopyhl7_soap_multreq.zip.
•IfonlyonerequesthastobesenttotheWebServicetorequestforpatient information,locateandcopyhl7_soap_singreq.zip.
NOTE:
Thedefaultsiteshl7_soap_multreqandhl7_soap_singreqincludeXML, XSDandOCMleswhicharetobeusedassamplesandwillrequireyouto customizethemforthecustomer.Refertosection“CreatingaNewSOAP
Client”onpage21forgeneratingnewXMLles.Refertosection“Generating XSDFiles”onpage27forcreatingtherequiredXSDles.OCMlesare
generatedwhentheXSDlesarecompiled.
4.InstalltheMUSEinterfacesasrequiredbythesitefollowingtheprocedures documentedintheMUSECardiologyInformationSystemsDevicesandInterfaces
Manual.
NOTE:
Onlythemuse_prodsite(muse_prod.zip)isrequiredbytheMPIinterface.
5.InstalltheHL7-to-soapsitethatyoucopiedinstep3.
NOTE:
Thisdocumentassumesthatthehl7_soap_singreqsiteisinstalled.Ifthe hl7_soap_multreqsiteisinstalled,youcanfollowthesameinstructionsas
forthehl7_soap_singreqsite.
16
MUSE™CardiologyInformationSystem
2076576-008A
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
6.Inhl7–soap-singreq/tclprocs/http_query.tclandhl7–soap-multreq/ tclprocs/http_query.tcl,procedureExtractTokenAndRequestFindPatient,has
hard-codeddetailsspecictotheMPIserveryouareusing. Updatethefollowingeldsasappropriateforthecustomersite.
setUserName“webservice”
setFriendlyName“WSGeApp”
setSystemCode“GEApp”
setSystemLocation“SG033827”
NOTE:
TheSavehl7elds.tcl.hasadelayconguredtopreventaracecondition betweentwoADTqueryrequests.Congurethedelayasappropriatefor thecustomersitesothatanytworequestsareprocessedoneafterthe otherbutassoonaspossible.Thedelayconguredisinmilliseconds.Inthe examplebelowitsconguredas10,000milliseconds
Usethefollowinginformationtocongurethedelay.IfthepatientID.txt leexists,itindicatesthatarequestisbeingprocessedandyouwillneed towaituntilitisdone.
if{[fileexists"patientID.txt"]}{ #echo"insideIFloop" after
10000
}
NOTE:
ThereisaknownissuewiththeSavehl7elds.tclinthehl7-soap-singreq templatewhichwillbexedinasubsequentrelease.Inthistemplatethe codeusesa“while”blockwhenitshouldhaveusedan“If”blockasthecode snippetshownabove.Aworkaroundistochangethe"while"to"if"orthe entiresectionofcodewritingthePatientIDtoaleandreadingfromit canberemovedfromthistemplate.
7.Appropriateerrorhandlingneedstobeaddedtothetclprocparsingthe responsefromtheMPIServer.
Errorhandlingisrequiredinbothcases:whenTPStranslationisusedorwhen theCloverLeafXLATEisused.
8.TheSourceinthedefaultalertsofallthetemplateswillneedtobemodied accordinglyiftheCCG/CloverleafinstalldirectoryisnotondriveC.Thedefault alertleforasiteislocatedatCL_INSTALL_DIR\integrator\[SITENAME]\Alerts.
9.IftheconnectiontotheservicesusesaSecureSockletLevel(SSL)connection, proceedtothenextsection“CreatinganSSLSecurityCerticate”.
IftheconnectiontotheservicesdoesnotuseSSL,proceedto“Conguring
CloverleafApplicationAdaptorWebServices(CAA-WS)”onpage20.
CreatinganSSLSecurityCerticate
IftheconnectiontotheserviceusesaSecureSocketLevel(SSL)connectionsuchas https,youneedtoperformthefollowingproceduretocreateakeystorethatallows CAA-WStoestablishasecureconnectiontotheWebService.
2076576-008A
MUSE™CardiologyInformationSystem
17
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
IfthereisnoSSLconnection,skipthissectionandproceedto“ConguringCloverleaf
ApplicationAdaptorWebServices(CAA-WS)”onpage20.
1.ObtainthesecuritycerticatefortheWebServiceswherepatientdataisobtained.
ThefollowingprocedureisforInternetExplorer8.Theprocedureforother browsersmaybesimilar .
a.UsingInternetExplorer8,navigatetothewebaddressoftheservice.
Thefollowingerrorpageisdisplayed:CerticateError:NavigationBlocked.
b.Clickonthefollowinglink:Continuetothiswebsite(notrecommended).
Thefollowingmessageisdisplayed:PagecannotbefoundHTTP:404error. NexttotheURLdrop-downeld,thefollowingmessageisdisplayed:
CerticateError. c.ClickCerticateError. d.ClickViewCerticates. e.UnderCerticateDetails,selectCopytoFile…. f.WhentheCerticateExportWizardopens,clickNextandselectDER
encodedbinary. g.ClickNextandnavigatetoatemporarydirectory. h.NametheleXXXXCerticate.cer,replacingtheXXXXwithaname
appropriatetotheMPIsite. i.ClickSave. j.ClickNext>Finishtocompletethesecuritycerticateexport.
2.CopythesecuritycerticatetoatemporarydirectoryontheCCGServer.
3.Openacommandwindowandchangetothedirectorywhereyousavedyourle.
4.Inthecommandwindow,typethefollowingcommandtocreateakeystore:
C:\gehc-it\_jre\bin\keytool–importcert–leXXXXCerticate.cer–storepass PPPPPP–trustcacerts–storetypeJKS–keystoreXXXXKey.keystore
Thekeystorecontainsthecerticateusingthejavakeytoolcommandreplacing PPPPPPwiththepasswordyouareusingtoprotectthekeystore.
NOTE:
Thepasswordneedstobeaminimumofsixcharacterslong.Rememberthe passwordbecauseitisrequiredwheneditingtheCAA-WSCCGconguration le.
5.Whenthekeytoolruns,adialogboxasksifyoutrustthecerticate;clickYES.
6.Copythekeystorele,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“ConvertingaCerticatefromP12toJKS”.
ConvertingaCerticatefromP12toJKS
UsethefollowingproceduretoconvertasecuritycerticatefromP12toJKS.The assumptionisthatyoualreadyhavethecerticatetest.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>usethepasswordforthetest.p12 certicate.
Theresultsaredependentonthelanguageoftheoperatingsystem,the followingisanexamplefromaSwedishoperatingsystem:
Intheexamplethevaluefor-srcaliasisrsekgprod. ThiscommandwillalsolisttheinformationoftheCerticateAuthorityand
thecerticate(s)used.Thisinformationwillbeusefulforsubsequentsteps (especiallystep6)whereyouwillhavetoobtaintherequiredcerticates.
SeeAppendixB“ViewTrustedCerticates”onpage61fortheinformation onusingtheMicrosoftManagementConsolemmc.exetoviewthetrusted certicatesinstalledonyourmachine.
2.TocreatetheJKSfromtheP12le,runthefollowingcommandinthecommand prompt:
keytool-importkeystore-srckeystoretest.p12
-destkeystoretest.jks-srcstoretypePKCS12
-deststoretypeJKS-srcstorepass<passwordofP12>
-deststorepass<passwordofJKS>-srcalias<P12alias>
-destalias<JKSalias>-srckeypass<P12storepassword>
-destkeypass<JKSstorepassword>
3.ConrmthattheJKSwascreatedsuccessfullybyrunningthefollowing command:
keytool-v-list-keystoretest.jks-storetypejks
4.Enterthepasswordwhenprompted. TheconsoleliststhecontentoftheJKSle.
5.Createatextlecalledcerticate.peminanytexteditor. Allthepubliccerticatesneedtobeinasinglele.Theseincluderoot,
intermediate,andCAcerticates.SinceP12isaWindows-basedcerticate,all certicatesmustbeavailable.
6.Downloadorobtainallpossiblecerticatesfromtheclient.
2076576-008A
MUSE™CardiologyInformationSystem
19
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
7.DownloadandinstallOpenSSLfromthefollowinglocation:
http://gnuwin32.sourceforge.net/packages/openssl.htm.
8.Openeachavailablecerticate,one-by-one,inanytexteditor. Thecerticates(.cer/.crtle)shouldbeBase64encodedsothatyoucanuse
theminthePEMleyoucreatedearlier.ABase64encodedcerticatelookslike thefollowingsample:
-----BEGINCERTIFICATE----­MIIFazCCA1OgAwIBAgIRAIC/ GIYrVi9G9NoHXIniK9EwDQYJKoZIhvcNAQEFBQAw . HDFQu+mEswKUJrN/ ug2rIThaKdqkwe9iVDI9yAZD6aF8P2WRO9q7IYgbAs4/F7Q=
-----ENDCERTIFICATE---–
•Ifthecontentisinthisformat,copyandpasteitintothecerticate.pemle.
NOTE:
YouneedtocopyallofthecontentandtagsbetweentheBegin CerticateandEndCerticatetags.
•Ifthecontentisnotinthisformat,youneedtoconvertitintoBase64using
OpenSSL,whichyoudownloadedandinstalledearlier.Usethefollowing commandforeachnon-Base64encodedcerticate:
opensslx509-inxyz.crt-informder-outformpem-out abc.pem
9.OpenthenewlycreatedPEMleanditscontentshouldbesimilartothe exampleinstep8.
10.Copyandpastethecontentintothecerticate.pemle.
11.UsethefollowingcommandtoimportallofthecerticatestotheJKSle.
keytool-import-keystoretest.jks-alias muse-client-cert-filecertificate.pem
a.Typethekeystorepasswordwhenprompted. b.Typeyeswhenpromptedifyoutrustthiscerticate.
12.ToconrmthatthecerticatesimportedsuccessfullywithJKS,runthefollowing command:
keytool-v-list-keystoretest.jks-storetypejks
13.Proceedtothenextsection“ConguringCloverleafApplicationAdaptorWeb
Services(CAA-WS)”.
ConguringCloverleafApplicationAdaptorWeb Services(CAA-WS)
UsethefollowingprocedurestoconguretheCAA-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_singreqleandrenameCCG-CAAWS-cong.xmlwithadifferent
namesothatitissavedasabackupletorefertolater.
2.OpentheWSConguratortool. Double-clickthejarlefromalebrowserorrunjava-jarWSCongurator.jar
fromthecommandlineafterchangingthedirectorytowhere WSCongurator.jarislocated.
Thisisfoundatintegrator/CAA/ws/tool/WSCongurator.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.
.
TheServiceeldispopulatedfromtheWSDL.Sincethereisonlyoneentry, thesystemautomaticallyselectsit.
SelectingaServicepopulatesthePorteld.Sincethereisonlyoneportinthe example,itisautoselected.
6.UsetheAddresseldforanyaddressoverrides. Intheexample,theAddresseldisemptybecausetheaddressintheWSDL
URLeldiscorrect. IftheserverimplementsawidelyavailableWSDLbasedonastandardwhere
theaddressisgeneric,usetheAddresseldtooverrideitwiththeaddressof theserverwithwhichthissystemisinteracting.
7.SelecttheServiceMode>MESSAGE(bydefaulttheServiceModeissetto PAYLOAD).
MESSAGE
•IndicatesthesystemuserissendingandreceivingtheentireSOAP Envelope.
•Thisallowsgreaterexibility,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.SavethecongurationleinthefolderC:\gehc-it\ccg\quovadx\cis6.0\
integrator\hl7_soap_singreq\javadriver\hl7_adt_soap_singreq\as CCG-CAAWS-cong.xml.Thejavadriverwilllookforthecongurationxml
inthislocation.
NOTE:
Ifusingadifferentname,remembertochangethenameconguredinthe threadsthatcommunicatewithCAA-WS.Seethenextsection,“Conguring
XMLinthehl7_soap_singreqSite”.
ConguringXMLinthehl7_soap_singreqSite
1.OpenCloverleafIDE.
2.Makesureyouareatthehl7_soap_singreqorhl7_soap_multreqsite.
3.ClickononeofthejavathreadsthatcommunicatewithCAA-WS.
4.AtthePropertiestab,clickthePropertiesbutton. TheJavaDriverProtocolPropertieswindowopens.
5.MakesurethedoStartmethodisselectedandtypethenameofthe congurationxmlleintheArgumenteld.
6.SelectSkipJVMshutdownhookswhenthethreadexits.
7.ClickOK.
2076576-008A
MUSE™CardiologyInformationSystem
23
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
AddinganHTTPConduittotheCongurationFile
IftheWebServicerequiresSSL(forexample,ifitisanhttpsconnection),thenyouneed tocongureHTTP-conduitinthexmlcongurationle.AnHTTPConduitiscreated withthehelperdialog.
1.OpentheWSConguratortoolandopentheCCG-CAAWS-cong.xmlle.
2.ClickClient>NewHTTPConduit. TheAddHTTPConduitwindowopens.
3.IntheNameeld,typethePortname. TheportnamefromtheSOAPClienttabcanbeused.
NOTE:
Theportnameshouldendwith.http-conduit.
4.ClickOK. TheAddHTTPConduitwindowclosesandanewtabforhttpconduitisadded
intheLogicalViewandPhysicalView.
5.Usetheinformationinthefollowingtabletocompletetheeldsonthewindow.
HTTPConduit
FieldValue
TLSSecuredSelectthecheckbox. SecureSocketProtocolSelectTLSv1. DisableCommonNameCheckSelectFalse.
24
MUSE™CardiologyInformationSystem
2076576-008A
HTTPConduit(cont'd.)
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
FieldValue
SSLCacheTimeoutLeaveblank. KeyPasswordEntertheCerticatePassword. KeystoreFile,Password,TypeEntertheinformationineacheld,appropriatefor
yoursystem. See“CreatinganSSLSecurityCerticate”onpage
17forvaluesforkeystoreelds.
TruststoreFileEntertheinformationappropriateforyoursystem.
See“CreatinganSSLSecurityCerticate”onpage
17forvaluesfortruststoreelds.
NOTE:
LeavealloftheeldsintheClientSettingseldblank.
NOTE:
IftheKeystoreisstoredintheexec/process/[SiteName]directory,then theentirepathtothecerticateisnotrequiredintheKeystoreFileand TruststoreFileelds.
6.SelectFile>Save.
7.OpentheXMLcongurationleinatexteditorandensurethatthehttpconduit sectionwasadded.
TheHTTPConduitcanapplyitssettingstooneormoreClients,oronlytospecic URLswithinasingleClient.
TheHTTPConduithaschildren,suchasClient,whichcongureTLSforthosesame matchedrequests.
ReviewtheHelpsectionforalistofallClientproperties.

ImportinganXMLSchemaintoCloverleaf

BeforetheCCGisabletosendorreceiveanXMLmessage,suchastheSOAP messagesusedbyanMPIwebservice,Cloverleafrequiresaschemadocumentthat describestheformatoftheXMLmessage.
2076576-008A
MUSE™CardiologyInformationSystem
25
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
CreatinganXMLPackageinCloverleaf
NOTE:
IfusingtheXMLpackagefolderMPI_Schemashippedwiththehl7_soap_multreq/ hl7_soap_singreqthenthissectioncanbeskipped.TheMPI_Schemashipped
withthetemplateisforreference.Itcanbebackedupwithadifferentnameand thefollowingstepscanbeusedtocreateanewXMLPackageMPI_Schema.
UsethefollowingproceduretocreateanXMLpackageinCloverleaf.
1.OntheCCGserver,starttheCloverleafIDE.
2.OntheToolspane,ontheleftsideofthescreen,clickCongurationtoexpand theCongurationtoolbar .
3.ClicktheXMLicon . TheCLOVERLEAF(R)IntegrationServices:XMLPackageManagerwindow
opens.
4.OntheServerPackageViewerpane,highlightandright-clickonthexmlfolder.
26
MUSE™CardiologyInformationSystem
2076576-008A
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
5.SelectNewPackage/Folder. TheCreateaNewFolderwindowopens.
6.IntheNewFolderNameeld,enterMPI_Schema.
7.IntheFolderType:eld,verifythatXMLisselected. IfXMLisnotselected,usethedrop-downlisttoselectit.
8.ClickOK.
9.ToviewtheMPI_Schemaxmlfolder,youmayneedtoexpandtheHostServer> xmlfolders.

GeneratingXSDFiles

UsethefollowingproceduresandinformationtogenerateXSDles.
2076576-008A
MUSE™CardiologyInformationSystem
27
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
WhyGenerateXSDFiles?
Whenyouaccessawebservicefromthesystem,usetheWSDLthatdescribesthe webservicethesystemisattemptingtoaccess.ThiscreatesanXSDlethatdescribes themessagesyouwanttosendbackandforth.
YoucancompiletheXSDleinasystemXMLpackageforcreatingtransformations betweentheSOAPmessagessenttoandfromthewebservice,andwhatevertarget messageformatyouuseinternallytoprocesstherequest.
TheXSDWSDLtoolreadstheWSDL,generatestheXSDlesforinputandoutput messagestotheservice,andcompilesthenewly-generatedXSDles.
BeforeYouRuntheXSDWSDLTool
ThefollowingtasksmustbecompletedbeforerunningtheXSDWSDLtooltogenerate andcompileXSDles:
•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,inthecommandwindowrunthefollowingbatchle
commandtostartthetool:xsdWsdlToolClientGUI.bat. TheinterfaceopensandallentriesareblankwiththeWSDLURIeldselected.
2.EntertheURItotheWSDLyouwanttouse.
3.Selectoneofthefollowingcheckboxes:
Showfullyqualiednames
28
MUSE™CardiologyInformationSystem
2076576-008A
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
ThenamesfromtheWSDLthathaveanamespaceassociatedwiththemare printedwiththenamespaceprexedbeforethename.
PrintWSDLcontentsafterloading
PrintstheWSDLtextcontentsafterloading.
4.ClickLoadWSDL. TheprogramattemptstoreadtheWSDLfromthelocationspecied.
•IfitcannotndtheWSDL,anerrorprintsintheResultssection.
•IfitndstheWSDLandcanparseit,theServicedrop-downeldpopulates
withthelistofservicesintheWSDL.
5.SelecttheappropriateServicefromthelist.
NOTE:
Ifthereisonlyonechoiceinthedrop-downlist,itisautomaticallyselected.
ThePortlistpopulates.
6.SelecttheappropriatePort. TheBindingandPortTypeeldsdisplaythenameoftheBindingandPortType
associatedwiththechosenportfromtheWSDL.
7.SelecttheOperationtoinvokeit. TheInputMessageandOutputMessagearepopulatedwiththenamesofthe
messagesforthisoperation.
8.SelecttheTargetXMLPackage. ThisistheXMLpackageinyoursitewhereyouwanttogenerateandcompile
theXSDs.
9.EntertheTargetXSDFilename. TheFullInputFilenameandFullOutputFilenameeldsdisplaythefullpath
namesoftheresultingXSDlesthataregenerated.
10.ClickGenerateandCompileTargetXSDs. Thistakestheselectedsettings,pullstherelevantinformationfromtheWSDL,
andcreatestwoXSDles:InputandOutput.
2076576-008A
MUSE™CardiologyInformationSystem
29
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
TheseleshaveSOAPenvelopesaroundthecontentchosensotransformations inthesystemcangeneratetheentireSOAPenvelopetosendtoawebservice andparsetheresponseSOAPenvelope.
ThesystemcompilestheXSDsintoOCMles,whicharewhatthesystemuses directlytoallowtranslationinthegivenXMLstructure.
•Ifthegenerationorcompilationfail,anexceptionmessagedisplaysa
descriptionoftheproblem.
•Ifthegenerationandcompilationsucceed,theresultlookssimilartothe
followingscreen,conrmingthattheXSDgenerationandcompilationwere successful.
NOTE:
The.OCMlesandthe.XSDlesaregeneratedbythetoolatthefollowing location:<C:\gehc-it\ccg\quovadx\cis6.0\integrator\hl7_soap_singreq\
formats\xml\MPI_Schema>

CreatingaRequestTranslationFile

NOTE:
IthasbeenobservedthatCloverLeafXLATEdoesn'talwaysworkwithcustomer providedXSD.TPStranslationwillberequiredifthisdoesnotwork.
ThemappingofHL7andXMLeldsisdependentuponthecustomersite.This procedureisageneralguidelinedescribinghowtocreatearequesttranslationle. TheITPSteammayneedtobeinvolvedincreatingarequesttranslationleto properlymaptheelds.
1.OntheCCGserver,starttheCloverleafIDE.
2.OntheToolspane,clickCongurationtoexpandtheCongurationtoolbar.
3.ClicktheTranslationConguratoricon TheCLOVERLEAF®IntegrationServices:TranslationConguratorwindow
opens.
30
MUSE™CardiologyInformationSystem
.
2076576-008A
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
4.PressCtrl+Ntocreateanewtranslationle. 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.MaptheHL7eldstotheappropriateXMLelds. Forexample,maptheQRD-WhoSubjectFilter-IDNumber(whichisthe
PatientID)totherequesteldthatistocontainthePatientIDnumber).Work withtheITPSteamtocompletethisstep.
9.TheXMLmessagerequiresyoutodeneanumberofconstants. Asaminimum,youneedtodenethexmlversion,xmlencodingandsoap
envelopenamespace(xmlns)elds.WorkwiththeITPSteamtocompletethis step.
Constantsareenteredbyprecedingtheconstantvaluewithanequalssign(=). Forexample,usethefollowingvaluesorXMLversionandencoding:
•Version=1.0.
•Encoding=UTF-8.
32
MUSE™CardiologyInformationSystem
2076576-008A
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
Youmayobtaintheconstantsneededforthesoapenv:Envelopexmlnselds fromtheXXXXRequest.xmlle.
10.Aftertheappropriateelds(includingthesoapenv:Envelopeelds)aremapped, savetheleasQ01_to_XXXXRequest.xlt.

CreatingaResponseTranslationFile

ThemappingofHL7andXMLeldsisdependentuponthecustomersite.This procedureisageneralguidelineofhowtocreatearesponsetranslationle.The ITPSteammayneedtoassistincreatingaresponsetranslationletoproperlymap theelds.
1.OntheCCGserver,starttheCloverleafIDE.
2.OntheToolspane,clickCongurationtoexpandtheCongurationtoolbar.
3.ClicktheTranslationConguratoricon
.
TheCLOVERLEAF®IntegrationServices:TranslationConguratorwindow opens.
4.PressCtrl+Ntocreateanewtranslationle. TheChooseFileFormatswindowopens.
5.TocreateanInputRecordFormatselectthefollowingvaluesforeacheld:
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.MaptheXMLeldstotheappropriateHL7elds. Thisstepiscustomer-specicandvariesfromcustomertocustomer .Workwith
theITPSteamtocompletethisstep. Asaminimum,thefollowingADT_A19eldsmustbemapped:
AAmappedtoMSA.#1(Acknowledgementcode)
PatientIDtoPID.#3(InternalID)
Visitnumber(orPIDifvisitnumberisnotavailable)toPV1(VisitNumber)
NOTE:
Wherethereisapatientfounderror,thetranslationlogicbuildingthe ADT_A19messageshouldleavethePIDblanksothatthehl7_soap_singreq site'srestoreA19SiteID.tclscriptcanapplytheproperMSAerrorcoding.
9.Whenalloftherequiredeldsaremapped,savetheleas XXXXResponse_to_A19.xlt.
ConguringCloverleafTranslationRoutes
UsethefollowingproceduretoconguretheCloverleaftranslationroutes.
1.OntheCCGserver,starttheCloverleafIDE.
2.OntheToolspane,clickCongurationtoexpandtheCongurationtoolbar.
3.SelecttheNetworkConguratoricon TheNetcongtabopens.
.
34
MUSE™CardiologyInformationSystem
2076576-008A
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
4.Right-clickonthehl7_adtquerythreadandselectThreadProperties. TheThreadConguration—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.xltleandclickApply.
11.ClickOK.
12.ClickOKtoclosetheThreadCongurationwindow. IfaCreateDirectorywindowopens,clickYes.
13.Right-clickonthesoap_adtquerythreadandselectThreadProperties. TheThreadCongurationwindowopens.
14.SelecttheRouteRepliestab.
15.SelectXlateandclickProperties.
2076576-008A
MUSE™CardiologyInformationSystem
35
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
16.NexttotheDestinationeld,clicktheListbutton.
17.Selecthl7_adtqueryfromthelist.
18.NexttotheXlateeld,clicktheListbutton.
19.SelecttheXXXXResponse_to_A19.xltle. TheXlateRouteDetailswindowopens.
20.ClickOK.
21.ClickOKtoclosetheThreadCongurationwindow.
22.PressCtrl+StosavetheNetCong.
23.SavethecurrentCCGviewbyselectingView>SaveViews.

ConnectingtheMUSESitetothehl7_soap_singreqSite

UsethefollowingproceduretochangeCloverleafsitesandconnecttheMUSEsite tothehl7_soap_singreqsite.
1.OntheCLOVERLEAF(R)...window,selectServer>Change. Ifawarningmessageisdisplayed,clickYes. TheCLOVERLEAF(R)IntegrationServiceswindowopens.
2.Selectthemuse_prodsiteandclickApply. TheNetcongtabopenswithastandardMUSEsitedisplayedinthewindow.
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.Congurethepropertiesofmuse_adtquerytochangeEncodingtobinaryfor allcountrieswhichusespecialcharacterslikeGermany,Sweden,Denmark andsoon.
ThedefaultvalueisUTF-8.
38
MUSE™CardiologyInformationSystem
2076576-008A
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
5.InplaceofaHIS,attachthemuse_prodsite’shis_adtquerytothe hl7_soap_singreqsite.
Toattachthesites,setthehis_adtquerythread’sprotocolpropertiesHostto
localhostandPortto9100asshowninthefollowingscreen:
6.ClickOKtoclosethePDLTCP/IPProtocolPropertieswindow.
7.SelectView>SaveViewstosavethepresentCCGview.
ConrmingCAA-WSandCloverleafConguration
ConrmthattheInforCloverleaf
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> Startuptostarttheprocess.
Inthefollowingsamplescreen,itisthehl7_soap_singreqbutton.
6.Conrmthattheprocessesandthreadsdisplayedchangefromredtogreen, andthatthethreadsdisplaythestatusofeitherOpeningorUp.
7.Right-clickagainonthegreenhl7_soap_singreqbuttonandselectControl> Full.
TheProcess'hl7_soap’Cont...windowopens.
8.ClickEOcongtochangetheCloverleafprocesslogginglevel. TheEOCongwindowopens.
40
MUSE™CardiologyInformationSystem
2076576-008A
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
9.ClickList…. Adialogboxopens.
10.Selectenable_all_infoandclickApply. TheEOAliaswindowopens.
11.Selectenable_all_infoandclickApply. TheEOCongwindowopens.
12.ClickOKtoclosetheEOCongwindow.
13.DonotclosetheFullControlwindow. Clickthewatchoutputbutton. TheWatchLogleforprocessadtquerywindowopenscontaininglog
messages.
Ifthereisaproblemwiththetesting,viewthislogtotroubleshoottheissue.
2076576-008A
MUSE™CardiologyInformationSystem
41
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
14.OntheMUSECCGCD,locatetheHL7TestTool.zipleandextractthecontentsof thezipleintoyourtemporarydirectory.
TheresultshouldbeanHL7TestTooldirectorycontainingHL7testtoolles.
15.OntheMUSECCGCD,locatetheQRY_Q01.hl7leandcopytheletoyourMy Documentsdirectory.
16.NavigatetotheHL7TestTool\bindirectory.
17.Locateandeditthelaunchpad.batle. EditthelebyaddingtheJVMpathoftheCCG(c:\gehc-it\_jvm\bin\)tothe
javacommand.
18.Savethelaunchpad.batle.
19.OpenanExplorerwindow.
20.Navigateandopenthefolderthatcontainsthelaunchpad.batle.
21.Double-clickthelaunchpad.batle. TheHL7TestTool:...windowopens.
22.SelecttheMessageEditortab.
23.IntheRemoteSystemhostnameeld,enterthecomputernameoftheCCG Server.
24.InthePortNumbereld,enter9100.
25.ClickSelectHL7File,selecttheQRY_Q01.hl7lethatisinyourMyDocuments 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_adtquerythreadisnotrunningbyconrmingthatitisred. Ifthethreadisrunning,stopthethread:
1.Right-clickontheadtquerybutton.
2.SelectControl>Shutdown.
31.ConrmthatanA19messagewithexpecteddataisdisplayedintheresponse 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.Conrmthattheadtqueryprocessesandthreadturnfromredtogreen,and thatthethreadsdisplayastatusofeitherOpeningorUp.
2076576-008A
MUSE™CardiologyInformationSystem
43
ConnectingtheMUSESystemtoaMaster-PatientIndexServer(MPI)
37.IntheHL7Testtool,makesurethattheMessageEditortabisselected. a.IntheRemoteSystemhostname,enterthecomputernameoftheCCG
Server.
b.InthePortNumbereld,entertheportthemuse_adtqueryuses(the
defaultis9005).
38.ClickSelectHL7File.
39.SelecttheQRY_Q01.hl7leinyourMyDocumentsfolder,andclickOpen.
40.ClickSend.
41.ConrmthatanA19messagedisplaystheexpecteddataintheresponse window.
Themessageshouldbeaversion2.4HL7message.
FinalizingtheConguration
Usethefollowingproceduretonalizetheconguration.
1.FollowtheinstructionsintheMUSECardiologyInformationSystemInstallation GuidetocongureCCGAutostart.

PerformingCleanup

Remembertoaddthehl7_soap_singreqsitetotheautostartscript.
2.Addthehl7_soap_singreqsitetotheSmatCycle.
Oncethesystemisoperatingsmoothly,youmayarchiveordeletethetemporary lesyoucreated.
44
MUSE™CardiologyInformationSystem
2076576-008A

Troubleshooting

CommonProblems

3
Usethissectiontoresolvecommonproblemsyoumayencounterduringthe congurationoftheCCGMPIserver.Ifyourproblemisnotlistedinthefollowingtable, contacttheITPSteamortheonlinecenter.
Followingisalistofcommonproblemsandtheirsolutions.
2076576-008A
MUSE™CardiologyInformationSystem
45
Troubleshooting
Symptom
Noresponse,andthelog fortheprocessdisplaysan errormessagesimilartothe following:
ProbableCauseSolution
ThereareXMLeldsthat arenotbeingdenedinthe
Q01_to_XXXXRequest.xlt
translationle.
Reviewthetranslationle 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 MonitorDaemonand 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.
ProbableCauseSolution
Theerrormessageindicates theADT^A19messagedoes notcontainapatientID numberthatmatchesthe originalrequest.Thismaybe aPIDmappingissue.
Usethefollowingprocedure toxCloverleaf:
1.Changetothesitethat hasthisproblemusing theServer>change optionintheQDXIDE.
2.IntheRuntimetab,click ontheShellwindowto openupacommand promptwindow.
3.Enterthefollowing commandtostopthe MonitorDaemon: hcisitectl-K.
4.Changethedirectory totheexecfolder anddeletethe sharedmemoryle monitorShmemFile.
5.Usethefollowing commandtorestart thehcimonitorandthe LockManager.:
hcisitectl-S
2076576-008A
MUSE™CardiologyInformationSystem
47
Troubleshooting
48
MUSE™CardiologyInformationSystem
2076576-008A
SupportMaterial
OpeningtheWSConguratorInterface
Usethefollowingproceduretoopentheinterface.
1.Toopentheinterface,double-clickthejarlefromalebrowserorrun
java-jarWSCongurator.jarfromthecommandline.Thisisfoundat integrator/CAA/ws/tools/WSCongurator.jar.
Theprogrampicksthedefaultdirectoryinwhichtoreadandsavelesby lookingatyourenvironmentvariablesandchoosingthelethatispresentas thedefault:
$HCISITEDIR
$CL_INSTALL_DIR
Ifneitheroftheselesarepresent,theprogramlooksforthehomedirectory.
A
2.IntheLogicalView,openanexistingcongurationle(File>Open),orstarta newcongurationle.
2076576-008A
MUSE™CardiologyInformationSystem
49
SupportMaterial
CreatingaNewClientCongurationFile
StartanewclientcongurationbyaddingClientlogicalobjects.
1.OpentheWebServices(WS)Conguator.
2.SelecttheClienttab. Amenuisdisplayed.
3.UsethemenutoselecttheappropriateClientobjectsforyoursystem.
CreatingaNewServerCongurationFile
Startanewservercongurationbyaddingnewserverobjects.
1.OpentheWSConguator.
2.SelecttheServertab. Amenuisdisplayed.
3.UsethemenutoselecttheappropriateServerobjectsforyoursystem.
50
MUSE™CardiologyInformationSystem
2076576-008A

UsingtheLogicalandPhysicalViews

Afteraddingclientandserverobjects,theLogicalViewlookssimilartothefollowing screen:
ThePhysicalViewlookssimilartothefollowingscreen:
SupportMaterial
PhysicalViewPanels
Panel
LeftpanelAtreeviewdisplayinghestructureoftheXMLdocumentthatyouare
RightpanelThepropertiesofanyelementthatisselectedontheleftpanel. BottompanelContext-sensitivehelpthatdisplayshelpforthelasttimeselectedon
2076576-008A
Description
building.
eithersidepanel.
MUSE™CardiologyInformationSystem
51
SupportMaterial
Afteryousavethecongurationle,thenameisdisplayedintherootnodeofthe PhysicalView.
NOTE:
Fromthispointon,youcanopenthecongurationleandcontinueeditingit usingeitherview,oryoucantogglebetweenthetwoviewsatanytime.

EditingaFile

IftheClientisdeployedtoanotherdevice,theWSDLmustbeavailableatthesame absolutepathoritneedstobearelativepath.RelativepathsbeginfromtheJava Driverthread’sworkingdirectory.
Forexample,whenthesitehastheworkingdirectorylistedasWSunderthesite:
•IftheWSDLisinthatdirectory,setp:wsdlLocationtothelenameoftheWSDL.
•Ifitisinasubdirectory(forexamplewsdls),setthelocationtoarelativepath(for
examplewsdls/myWsdl.wsdl).
Whenthesiteisdeployedonanotherserver,itusestherelativepathwithinthesite insteadofanabsolutepaththatmightnotexistonthatdevice.
NOTE:
ThisisnotaproblemforWSDLsatanHTTPURL,assumingthesameURLis availablefrombothdevices.
ToedittheexistingcongurationXMLfromthehl7_soap_singreqsite, openthexmllefromthepathC:\gehc-it\ccg\quovadx\cis6.0\integrator\ hl7_soap_singreq\javadriver\hl7_adt_soap_singreq\usingtheWSCongurator.

UsingtheLogicalandPhysicalView

Therearetwoviewsthatyoucanusetosetupaconguration.Thedifference betweenthePhysicalViewandLogicalViewhighlightsthecomplexityoftheXML structureinthecongurationle.
LogicalView
ThepropertiesoftheClientaredisplayedontherightpane.Usethisviewtoenter orselecttheproperties. YoudonotneedknowledgeoftheactualXMLelementstosetupaconguration usingthisview.
52
MUSE™CardiologyInformationSystem
2076576-008A
SupportMaterial
Hoveringoverapropertyopensatooltipexplainingtheproperty.Thisprovidesan easierviewwithwhichtowork.
PhysicalView
ThisviewprovidesdetaileddescriptionsoftheXMLelementsandtheirmeaning, anddisplayswhatyoucanexpectfromtheequivalentXMLandtheoperationsthat youcanperforminthatview. UsethisviewasalearningtooltodisplayhowtheactionstakenontheLogical ViewtranslateintotheactualXMLstructure.
Inthisexample,twoelementswerecreated(XMLelementsfromtheXMLletheWS Conguratorgenerates):
bean
jaxwsclient
NOTE:
Someelementshavepropertiesthataredisplayedintherightpanelwhenthat elementisselectedonthetree.ThesepropertiesareattributesintheXML letheWSConguratorgenerates.
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.OntheWSConguratorwindow,selectServer>NewSOAPServer.
TheAddSOAPServerwindowopens:
56
MUSE™CardiologyInformationSystem
2076576-008A
Thehelpinformationatthetopofthewindowexplainsthegeneralow.
2.IntheWSDLURIeld,entertheWSDLandanyreferencedXSDleswithin theworkingdirectoryfortheJavadriverthread(orasubdirectoryofit)and referenceitwitharelativepath.
Forexample,aWSDLXDS.b_DocumentRegistry.wsdlisinthe WS/XDSb.Support.Materias.v10/wsdldirectory,whereWSistheworking directory.
SupportMaterial
Ifthisserviceisdeployedtoanotherdeviceandthatsameexactpathdoesnot exist,theservicecannotndtheWSDLandfailstostart.
3.ClickBrowsetolocatethedirectorywhereWSDLispresent.
4.ClicktheLoadWSDLbuttontoloadtheWSDLle. TheServiceeldispopulatedfromtheWSDLafteritisloaded.Ifthereisonly
oneentry,theinterfaceautomaticallyselectsit. ThePorteldispopulatedafterselectingtheService.Ifthereisonlyoneport
usingthisservice,itisauto-selected. TheAddresseldisforaddressoverrides.Youmayleavethiseldblank.
5.PublishedAddressisanoptionaleldforpopulatingtheaddressinthe 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,enterhttp://cloud.amazing.com/myserviceinthePublished Addresseld.ThereturnedWSDLnowhasthecorrectserviceaddresstocalling
users.
6.ForServiceModeinformation,seestep7in“CreatingaNewSOAPClient”on
page21.

UsingtheLogicalandPhysicalViews

ThefollowinginformationdescribestheLogicalViewandPhysicalViewintheSOAP Server.
LogicalView
Thepropertiesofthisserverarefoundontherightpanelwhereyoucanenteror selectthemfromadrop-downlist.Hoveringoverapropertyopensthetooltipthat explainstheproperty.
PhysicalView
NOTE:
Thefollowingscreendisplaywhatyoucouldseefromtheequivalent PhysicalViewandthevariousoperationsperformedonthatview,withdetail descriptionsofmanyoftheXMLelementsandtheirmeaning.
ThisdifferencebetweenthePhysicalViewandLogicalViewhighlightsthe complexityoftheXMLstructureinthecongurationleandwhytheLogical Viewprovidesabetterview.
EndpointElement
58
MUSE™CardiologyInformationSystem
2076576-008A
SupportMaterial
ThePhysicalViewhasoneendpointelement,unlikeaClient,whichhasapaired beanelement.
SimilartotheClientelement,theEndpointelementcanhavefeaturesandproperties children,correspondingtotheeldsselectedorsetintheLogicalView.
Toseethecontext-sensitivehelp,whichisalistofallowablekeys:
1.Selectanentryintheleftpanel,andinthePropertiespanel,clickkey.
2.Clickvaluetoseetheallowablevaluesforthatkey.
SimilartotheClient,thecloverleaf-nameditemsarespecictoworkingwiththe system,andtherestareCXFgenericvalues.
2076576-008A
MUSE™CardiologyInformationSystem
59
SupportMaterial
60
MUSE™CardiologyInformationSystem
2076576-008A
ViewTrustedCerticates
ViewCerticatesintheTrustedRootCertication Authorities
InformationisprovidedforusingtheMicrosoftManagementConsole(mmc.exe)to viewthetrustedcerticatesinstalledonyourmachine.
1.ClickStart,intheStartSearch,typemmc,andthenpressEnter. TheUserAccountControlwindowmayopenaskingifyouwantallowchanges,
clickYes. MicrosoftManagementConsolewillopen.
2.ClickFile>Add/RemoveSnap-in. TheAddorRemoveSnap-inswindowopens.
B
3.InAvailablesnap-ins,clickCerticates,andthenclickAdd>. TheCerticatessnap-inwindowopens.
4.InThissnap-inwillalwaysmanagecerticatesfor:,selectComputeraccount, andclickNext.
TheSelectComputerwindowopens.
5.SelectLocalcomputerandclickFinish.
6.Ifyouhavenomoresnap-instoaddtotheconsole,clickOK.
7.Intheconsoletree,double-clickCerticates.
8.ClicktheTrustedRootCerticationAuthoritiesstore>Certicatestoviewall thetrustedrootcerticatesonthemachine.
2076576-008A
MUSE™CardiologyInformationSystem
61
Index
A
AddinHTTPConduitto
CongurationFile24
Assistance12
C
CommonDocumentation
Library(CDL)2 CommonProblems45 compliance2 ConguringCAA-WS
Overview
CreatingNewClient
CongurationFile50
CreatingNewServer
CongurationFile50 EditingaFile52 OpeningWSCongurator
Inferface49 UsingLogicaland
PhysicalViews51
ConguringCloverleaf
TranslationRoutes34
ConrmingCAA-WSand
CloverleafConguration39
ConnectingMUSESystem
toMPI15
ConnectingtheMUSESite
toHL7Site36
conventions
document11 illustrations12 Notes12 typographical11
ConvertingCerticatefrom
P12toJKS18
CreatingaRequest
TranslationFile30
CreatingaResponse
TranslationFile33
CreatingaSOAPClient
UsingLogicaland
PhysicalView52 UsingRight-ClickMenu54
UsingthePropertiesChild55 CreatingNewSOAPServer56 CreatingSSLSecurity
Certicate17
D
document
partnumber2
revision2 documentconventions11
F
FinalizingConguration44
G
GEHealthcare
CommonDocumentation
Library(CDL)2
manuals2 GeneratingXSDFiles28
I
illustrationconventions12 ImportingXMLSchemainto
Cloverleaf25
InstallingandConguring
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 InformationTechnologiesGmbH 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
Loading...