MedCom Webservice proxy - Teknisk beskrivelse

Transkript

1 MedCom Webservice proxy - Teknisk beskrivelse MedCom Webservice proxy MedComWSProxy Applikation CVS Systemkrav Installation Opsætning Webservice Certifikat Periodisk kørsel Opsamling af data Indberetning af data Fra test til drift Fejlhåndtering Krav til at køre Medcom Integration: I samarbejde med MedCom har Sundhedsstyrelsen og KL fået lavet en webservice der gør det muligt for udviklerne af børnejournalsystemerne at indberette sundhedsdata løbende. Mere information, samt adgang til testcenter, kan findes på MedComWSProxy Applikation TMCare's løsning på udfordringen er en batchafviklet process der bør køres med regelmæssige intervaller for at opsamle data fra systemet og indberette til sundhedsstyrelsen. Systemet har to tasks der kan køres uafhængnigt afhinanden: Opsamling af data og overførsel til lokal DGWS database. Indberetning af opsamlet data til Sundhedsstyrelsen. Systemet skal køres intervalbaseret gennem f.eks. windows Scheduled Tasks CVS /home/tmcare/medcomwsproxy Systemkrav Medcom integrationen kræver.net 3.0 eller 3.5 der kan downloades fra microsoft på Installation Pak filen MedcomIntegration.zip ud i en folder på den maskine der er koblet til sundhedsnettet. Hvis det er første gang Medcom Integrationen sættes op, skal der oprettes en ny database på databaseserveren. Dette gøres ved at køre scriptet DGWSCreateStructure?.sql på databaseserveren. Den nye database kommer til at hedde "DGWS". Denne database bruges til at lægge data i kø, samt registrere savr på indsendte indberetninger. Struktur scriptet til denne findes her Lav herefter kataloget C:\BatchRun\Output Opsætning Derefter skal der rettes i filen TaskRunner.exe.config <?xml version="1.0" encoding="utf-8"?> <configuration> <connectionstrings> 1

2 <add name="tmcare" connectionstring="data Source=localhost,1433;MultipleActiveResultSets=True;Initial Catalog=TMCARE_DEV_2_20_0;User ID=sa;Password=Adm2Sund" /> <add name="dgws" connectionstring="data Source=localhost,1433;MultipleActiveResultSets=True;Initial Catalog=dgws;User ID=sa;Password=Adm2Sund" /> </connectionstrings> <appsettings> <!--#################### GENERAL #######################--> <add key="outputdirectory" value="c:\batchrun\output\" /> <add key="outputfile" value="{taskname}_{exportid}.txt" /> <!--#################### WEB SERVICE ##############--> <!-- <add key="url" value=" --> <add key="url" value=" > <add key="institutionidentifier" value="152000" /> <add key="issuer" value="tmcare" /> <add key="itsystemname" value="tmsund" /> <add key="careproviderid" value="079741" /> <add key="careprovideridformat" value="dgws:ynumber" /> <add key="careprovidername" value="testcenter, TMCare" /> <!--#################### WEB SERVICE CERTIFICATE ##############--> <add key="certpath" value="c:\\mikevalid.p12" /> <add key="certpass" value="test1234" /> <!--#################### settings #######################--> <add key =" Enabled" value ="true"/> <add key="smtphost" value="localhost" /> <add key="smtpport" value="25" /> <add key="mailfrom" /> <add key="mailto" /> <add key="clientsettingsprovider.serviceuri" value="" /> </appsettings> <system.web> <membership defaultprovider="clientauthenticationmembershipprovider"> <providers> <add name="clientauthenticationmembershipprovider" type="system.web.clientservices.providers.clientformsauthenticationmembershipprovider, System.Web.Extensions, Version= , Culture=neutral, PublicKeyToken=31bf3856ad364e35" serviceuri="" /> </providers> </membership> <rolemanager defaultprovider="clientroleprovider" enabled="true"> <providers> <add name="clientroleprovider" type="system.web.clientservices.providers.clientroleprovider, System.Web.Extensions, 2

3 Version= , Culture=neutral, PublicKeyToken=31bf3856ad364e35" serviceuri="" cachetimeout="86400" /> </providers> </rolemanager> </system.web> </configuration> I ConnectionStrings skal der rettes til, så der peges på hhv driftsdatabasen og dgws databasen. Se evt for en forklaring på hvad man kan sætte i dette felt. Hvis Medcom Integrationen skal køre på den server der også er driftsserver for TMSund, vil det typisk være nok at rette "localhost" til det rigtige servernavn. Webservice I sektionen Webservice er der default sat medcoms testcenter ind. Man skal fortsat have et korrekt OCES certifikat, men man har mulighed for at lave en testkørsel før fuld drift optages. Når fuld drift skal igang, fjernes linien med testsystemet, og den rigtige sættes ind i stedet. Certifikat OCES Certifikatet skal være tilstede på maskinen. I "certpath" og "certpass" sættes hhv fuld sti til certifikat, samt evt passphrase. Hvis programmet oplever fejl eller data der ikke kan sendes, kan operatør få om dette ved at sætte rigtige værdier ind i afsnittet med . Periodisk kørsel Medcom integrationen skal sættes til at køre periodisk gennem Windows Schedule. Integrationen består af et antal trin, der alle er beskrevet i filen TaskConfig.xml Som standard ser den således ud <?xml version="1.0"?> <TaskConfig xmlns:xsi=" xmlns:xsd=" xmlns=" <Location>TaskRunner.Tasks.PrepareData.PrepareDataTask</Location> <Active>true</Active> <Location>TaskRunner.Tasks.SubmitMedcomData.SubmitMedComDataTask</Location> <Active>false</Active> <Location>TaskRunner.Tasks.Shutdown.ShutdownTask</Location> <Active>true</Active> </TaskConfig> Det ses, at der er 3 tasks, hvoraf task 2 er slået fra. Task 1 opsamler data fra driftssystemet og klargører det til afsendelse. Task 2 afsender data til Medcom Task 3 lukker Medcom Integrationen ned pænt. Task 2 er slået fra initielt indtil OCES certifikater og sundhedsadgang er på plads hos kunden. Når dette er korrekt sat op, kan man slå task 2 til igen, ved at ændre false til true. 3

4 Opsamling af data Opsamlingen af data sker ved først at hente en komplet liste over data der allerede er gemt til indberetning og derefter gennemløbe de respektive TMSund tabeller for de data der ikke allerede er gemt til indberetning. Hver gang nye data opdages, overføres de relavante informationer til DGWS databasen. Passiv rygning: Hentes fra Child.riskFactorPassiveSmoking 0 = Ikke oplyst 1 = Ja 2 = Nej Ammeperiode: Hentes fra kostskemaet, i databasen repræsenteret gennem et interventionsresultat med tilhørende resultatinfoelementer. TMSALA016 = Uger TMSALA015 = Måneder Vækstdata : Hentes fra vækstskemaet, i databasen repræsenteret gennem et interventionsresultat med tilhørende resultatinfoelementer. TMSAAA002 = Vægt TMSAAA003 = Højde Indberetning af data Indberetningen sker ved at gennemløbe tabellerne i DGWS tabellerne og indberette alle rows hvor AfsendtGUI? kolonnen er NULL. Ved succesfuld indberetning skrives returværdien til AfsendtGUI? feltet, og på den måde sikres det at den samme registrering ikke indberttes flere gange. Samtidig sikres det at der altid kan findes tilbage til den type registreringer som returnerer et unikt ID som sundhedsstyrelsen også gemmer. Dette GUID kan også bruges til at modificere og slette registreringer på senere tidspunkter, men det er p.t. ikke implementeret. Fra test til drift Hvis man har brug for at køre et testrun mod Medcom skal man være opmærksom på, at DGWS tabellerne bliver markeret som afsendt når testen er gennemført. Man kan vælge at slette indholdet i tabellerne, eller nulstille GUID'en på linierne med kommandoerne (enkeltvist) update vaegtreg set AfsendtGUID = null update PassivRygningReg set AfsendtGUID=null update AmningReg set AfsendtGUID = null Nu vil det opsamlede data blive fremsendt igen næste gang. Bemærk dette er ikke en god ide at gøre hvis man har kørt drift i en periode, da alle data i så fald vil blive genfremsendt. Fejlhåndtering Ved parsning af rå TMSund data og indberetning af data fra DGWS tabellen, fanges alle fejl som pæne fejlbeskrivelser og samles i en liste. Såfremt denne liste ikke er tom ved endt gennemløb af de to respektive tasks, sendes en til adressen specificeret i app.config under nøglen "mailto". Alle andre "unhandled exceptions" opfanges også og samme modtager vil få en mail med exception message og stacktrace. Under alle fejlhåndteringer, logges den specifikke exception så den ikke går tabt. Af sikkerhedsmæssige årsager sendes kun patientid og ikke CPR, da sidstnævnte ikke er tilladt at sende over en ukrypteret forbindelse. Ovenstående fejlhåndtering giver mening da man altid ønsker at servicen kører videre, uanset eventuelle fejl forsaget af ugyldig data i TMSund databasen. Dette gælder også for indberetningen, da man godt kunne forestille sig at webservicen på nogle tidspunkter ikke var i stand til at svare korrekt, eller inden for timeout perioden. 4

5 Krav til at køre Medcom Integration: OCES Virksomhedscertifikat (Kopieres til serveren og peges på fra app.config) Se evt. hvis kunden er i tvivl om dette. Opkobling til Sundhedsdatanettet (SDN). Kunden skal selv sørge for at få denne forbindelse etableret. MedComWSProxy? kræver at der er forbindelse til MedCom? Hosting som kun kan tilgås gennem dette net. Det er almindeligvis en vpn forbindelse der er tale om. 5