ebir th Controlelijst Ziekenhuizen ebirth web service voor de zorgverleners van ziekenhuizen Versie 2.0

Transcriptie

1 ebir th ebirth web service voor de zorgverleners van ziekenhuizen Ziekenhuizen Versie 2.0

2 Inhoudsopgave 1 INLEIDING TE DOORLOPEN ETAPPES VOOR HET GEBRUIK VAN DE WEB SERVICE EBIRTH BIJLAGE: SAMENVATTENDE TABEL CONTROLELIJST ZIEKENHUIS... 7 Pagina 2

3 1 Inleiding Met behulp van dit document wensen we u alle informatie te verstrekken die u nodig hebt om de ebirthtoepassing te gebruiken. Dit document is bestemd voor de ebirth-contactpunten van de ziekenhuizen. Aan de ziekenhuizen worden twee mogelijkheden geboden om de toepassing te integreren: - De ebirth-toepassing gebruiken via een webtoepassing; d.w.z. toegang hebben tot de ebirthtoepassing via een internetbrowser (bv. Internet Explorer). - De ebirth-toepassing integreren via een web service; d.w.z. de ebirth-toepassing integreren in de bestaande software van de gemeente. De webtoepassing is bestemd voor de kleinere ziekenhuizen of voor de ziekenhuizen die niet over een kraamkliniek beschikken, alsook voor de zelfstandige zorgverleners die buiten de ziekenhuizen actief zijn. Ze maakt het mogelijk om de gegevens in te vullen via een web interface zonder dat de ziekenhuizen ze direct kunnen exploiteren in hun eigen interne oplossingen. De webtoepassing werd vooral ontwikkeld voor de zelfstandige zorgverleners en de ziekenhuizen die niet over een krachtige software beschikken waarin de ebirth-functionaliteiten zijn geïntegreerd. Om de digitalisering van de gegevenstransfer zo goed mogelijk te exploiteren heeft het project bijgevolg ook web services ontwikkeld waarmee de ziekenhuizen met kraamkliniek (die grote volumes gegevens verwerken) vanuit hun eigen toepassingen de inbreng van de geboortegegevens direct kunnen integreren via de ebirth web services. Dit document heeft tot doel alle voorafgaande etappes te beschrijven die u moet doorlopen voor een goede integratie van de web service in de toepassing van het ziekenhuis. Pagina 3

4 2 Te doorlopen etappes voor het gebruik van de web service ebirth We vestigen de aandacht op twee belangrijke punten: INTERNET: om toegang te hebben tot de ESB (Enterprise Service Bus) van ehealth is een internetverbinding absoluut noodzakelijk. De voornaamste taak van deze ESB bestaat erin de veiligheid in het kader van de uitwisseling van gegevens op homogene wijze te verzekeren en de toepassing die toegang wenst te hebben tot de ebirthtoepassing formeel te authenticeren. ESB-OMGEVINGEN: twee omgevingen staan tot uw beschikking op het niveau van de ESB bij ehealth. o o Acceptatieomgeving: deze omgeving laat u toe te controleren dat de integratie van de web service binnen het ziekenhuis werkt en stuurt de passende berichten (gelukt of mislukt) terug voor elke gedefinieerde situatie. Productieomgeving: deze omgeving wordt gebruikt in het kader van het effectieve gebruik van de web service. De toegang tot deze omgeving is slechts mogelijk na installatie door het ziekenhuis. We overlopen hierna alle etappes die noodzakelijk zijn voor de goede integratie van de web service in uw ziekenhuis. Etappe 1: terugsturen van het voorbereidend formulier voor het gebruik van ebirth Medical Stuur het Voorbereidend formulier voor het gebruik van ebirth Medical behoorlijk ingevuld terug naar de Service Desk van Fedict. Het formulier is te downloaden op de ehealth web site ( of het aan te vragen door een te sturen naar het adres servicedesk@fedict.belgium.be. Er liggen ten minste 2 maanden tussen het opsturen van uw formulier en de effectieve installatie in uw ziekenhuis. De installatie in het ziekenhuis gebeurt parallel met de installatie van de toepassing in de Burgerlijke Stand van uw gemeente en misschien in één of meer ziekenhuizen die verbonden zijn met uw gemeente. Etappe 2 : Over een ehealth-certificaat beschikken Dit certificaat is nodig zodat uw ziekenhuis geïdentificeerd en geauthenticeerd kan worden. Indien u al over een ehealth-certificaat beschikt, dan kan u tot etappe 3 overstappen. Indien u niet over een dergelijk certificaat beschikt, moet u een certificaat-aanvraag doorsturen naar ehealth. Alle informatie hieromtrent zijn ter uw beschikking op de ehealth web site onder Basisdiensten ehealth-certificaten : Pagina 4

5 Etappe 4: toegang tot de acceptatieomgeving Zodra u het ehealth-certificaat ontvangt, heeft u toegang tot de acceptatieomgeving. We herhalen dat deze omgeving u toelaat te controleren dat de integratie van de web service binnen uw ziekenhuis werkt en de passende berichten (gelukt of mislukt) terugstuurt voor elke gedefinieerde situatie. Etappe 5: implementatie en test van de web service binnen het ziekenhuis In deze etappe integreert (ontwikkelt) u de web service in de toepassing van uw ziekenhuis. Om u daarbij te helpen, stellen we een technische handleiding tot uw beschikking die een beschrijving bevat van alle specificaties, het formaat van de gegevens en de noodzakelijke validatieregels in de ebirth-toepassing. Dit document, EB_Handleiding Web Services Hospital en zijn bijlagen zijn beschikbaar op de ehealthwebsite ( Gelieve in verband hiermee ook contact op te nemen met uw softwareleverancier. U vindt hieronder een korte toelichting betreffende de bijlagen die op de ehealth web site tot uw beschikking worden gesteld: Bestand EB_Districts_1.0.xls EB_Countries_1.0.xls EB_Responsefields_1.0.xls EB_helpfields_1.0.xls EB-Hospital-schemas-clientv1.00.rar EB-Hospital-examples-v1.00.zip Uitleg Dit bestand bevat de districtcodes voor de gemeenten Antwerpen en Doornik. Dit bestand bevat de landenlijst volgens de GEOBEL- en ISO-code. Voor sommige vragen moet de zorgverlener van het ziekenhuis het juiste antwoord kiezen. Dit bestand bevat de antwoorden en de vertaling van de velden. Dit bestand bevat alle hulpvelden evenals hun vertaling. Dit bestand bevat de schema s WSDL en XML. Dit bestand bevat voorbeelden van de in- en uitgaande berichten van de web service via de ESB. Pagina 5

6 Etappe 6: terugsturen van de resultaten van de tests die worden uitgevoerd in de integratieomgeving van de ESB Wanneer alle ontwikkelingen zijn uitgevoerd, is het belangrijk om het resultaat mee te delen van de tests die in de integratieomgeving van de ESB zijn uitgevoerd. Het gaat om een bewijs dat de standaardtests zijn uitgevoerd en dat ze de passende berichten (gelukt of mislukt) terugsturen voor elke gedefinieerde situatie. Voor elke test moet u de datum vermelden waarop de test werd uitgevoerd evenals het verkregen resultaat. Op de ehealth-website ( vindt u een document met alle uit te voeren tests. De resultaten van de uitgevoerde tests zijn door te sturen naar de service desk van Fedict (servicedesk@fedict.belgium.be). Etappe 7: toegang tot de productieomgeving ESB De laatste etappe behelst de toegang tot de productieomgeving van de ESB. Zoals hierboven al gezegd, wordt dezelfde authenticatie certificaat gebruikt voor de integratie en productie omgeving. (zie etappe 3). Deze productieomgeving wordt gebruikt om de web service te gebruiken. U krijgt echter pas toegang tot deze omgeving op de datum die wordt vastgesteld voor de lancering in het ziekenhuis (zie etappe 1). Etappe 8: in geval van problemen te nemen maatregelen Voor elke vraag betreffende de toegang tot de ebirth-toepassing of het gebruik van de ebirth-toepassing kunt u zich wenden tot de contact center van ehealth. U kunt op verschillende manieren contact opnemen met Contact Center ehealth: telefonisch, op het nummer Onze medewerkers staan tot uw dienst van maandag tot vrijdag van tot uur. Via het contactformulier Buiten deze werkuren kunt u via het contactformulier van ehealth steeds vragen dat men contact met u opneemt. Pagina 6

7 3 Bijlage: samenvattende tabel Ziekenhuis U vindt hieronder een samenvattende tabel van alle etappes die in dit document worden beschreven. Het verdient aanbeveling om deze tabel te gebruiken teneinde geen enkele etappe over te slaan bij het installeren van de web service. ETAPPES AARD WIE? UITGEVOERD Noodzakelijke handelingen voor de integratie van de web service ebirth 1 Terugsturen van het voorbereidend formulier Verantwoordelijke Kraamkliniek / ITdepartement / Veiligheidsbeheerder 2 Over een ehealth-certificaat beschikken IT-departement / Veiligheidsbeheerder 4 Toegang tot de acceptatieomgeving van ESB 5 Implementatie en test van de web service in het ziekenhuis Departement ESB / ITdepartement Softwareleverancier van het ziekenhuis / IT-departement 6 Terugsturen van de resultaten van de tests uitgevoerd in de integratieomgeving van de ESB Softwareleverancier van het ziekenhuis / IT-departement 7 Toegang tot de productieomgeving van de ESB Departement ESB / ITdepartement Pagina 7