HD4DP v2

HD4DP v2 Bart.Servaes di, 11/21/2023 - 15:29

Algemene beschrijving van de applicatie HD4DP v2

De HD4DP v2.x Local is een elektronisch gegevensregistratiesysteem (EDC): een geautomatiseerd systeem dat is ontworpen voor het verzamelen van klinische gegevens in elektronisch formaat voor gebruik in onderzoek ter ondersteuning van het volksgezondheidsbeleid. HD4DP (Health Data for Data providers) vervangt de traditionele op papier, spreadsheet, e-mail gebaseerde methode voor het verzamelen van gegevens en de wildgroei aan websites om het verzamelen van gegevens te stroomlijnen en de tijd tot analyse en rapportage te versnellen.

Componenten en functies

De HD4DP v2.x Local applicatie bevat de volgende hoofdcomponenten: NextGen Connect, Form.io, HD Connect (LOCAL Proxy), Local datawarehouse.

NextGen Connect

NextGen Connect is een integratiemotor voor de gezondheidszorg die berichtstandaarden vertaalt naar de standaard die vereist is door het ontvangende systeem, inclusief gegevensformaten en -standaarden zoals HL7, DICOM, ANSI X12, ASCII en XML. Belangrijkste functionaliteiten zijn filteren, transformeren, extraheren en routeren.

De NextGen Connect component wordt gebruikt om alle integraties binnen HD4DP v2.0 zelf af te handelen, maar ook alle integraties met de buitenwereld.

API voor gegevensverzamelingen: De form.io server biedt een REST API die kan worden gebruikt om gegevens in te dienen voor elke bekende gegevensverzameling. Gegevensprovider Master Systems heeft geen rechtstreekse toegang tot deze API, maar moet de API gebruiken die wordt weergegeven door de NextGen Connect-component. Deze API is gewoon een proxy voor de form.io API, maar biedt extra functies bovenop de form.io API zoals beveiliging, monitoring, throttling, …

CSV API: Voor elke dataverzameling kunnen gegevens file-based worden ingediend met behulp van een CSV. Een CSV kan meerdere ingevoerde gegevens bevatten voor een enkele definitie van gegevensverzameling. Deze gegevensinvoer wordt getransformeerd en door de NextGen Connect-component naar de form.io-server geduwd voor mogelijke handmatige naverwerking en validatie.

HL7 FHIR API: Voor sommige gegevensverzamelingen zal een HL7 FHIR API beschikbaar zijn. Het NextGen Connect-onderdeel voert de transformatie naar de API voor gegevensverzamelingen uit en pusht de gegevens naar de form.io-server.

Levering van de gegevens: de NextGen Connect-component zorgt voor alle routering van gegevens naar de buitenwereld. Dit betekent dat het de form.io-server verifieert op voltooide gegevensinvoer die nog niet is afgeleverd. Voor elke gegevensinvoer die moet worden afgeleverd, wordt bepaald waar de gegevens naartoe moeten worden gestuurd, hoe ze moeten worden getransformeerd en hoe ze moeten worden gesplitst. Hij voert al deze acties uit op een gegarandeerde leveringswijze: hij zorgt ervoor dat de gegevens hun bestemming bereiken, en probeert zo nodig opnieuw als er iets mis ging.Feedback: de NextGen Connect-component coördineert de ontvangst van feedback, transformeert deze mogelijk en duwt deze naar de respectieve invoer voor gegevensverzameling met behulp van de API voor gegevensverzamelingen.

Form.io

Form.io is een gegevensbeheerplatform met een formulierbouwer met een interface voor slepen en neerzetten, gegevensbeheer met een volledig API-platform, beheer van gebruikers, offline formulieren, dynamische formulieren, automatisch aanmaken van API en insluiten van applicaties. In HD4DP v2.0 is een Angular frontend-applicatie beschikbaar bovenop de form.io-server. Deze applicatie biedt een gebruikersinterface voor gegevensproviders waarin ze de verschillende gegevensverzamelingen kunnen zien waarvoor ze gegevens handmatig mogen registreren en indienen. Een backend-server van form.io is verantwoordelijk voor het leveren van de formulierdefinities en registraties van nieuwe/bijgewerkte items.

HD Connect (LOCAL Proxy)

De component HD Connect wordt gebruikt om metadata op te halen uit de Master Data Management Database (MDM DB) die zich aan de kant van healthdata.be bevindt.

Local datawarehouse

Elke wijziging in de gegevensinvoer op de form.io-server wordt naar het lokale datawarehouse (Lokale DWH) gepusht voor eenvoudige rapportage en gegevensextractie. Deze lokale DWH werkt met een PostgreSQL-database.

Installatie en onderhoud

De applicatie HD4DP v2.0 Local wordt gratis ter beschikking gesteld en op afstand geïnstalleerd op de infrastructuur van de zorgorganisatie door healthdata.be. Zorgorganisaties krijgen de systeemvereisten voor de installatie van de HD4DP v2.0 applicatie. Zorgorganisaties die niet aan de systeemeisen kunnen voldoen, kunnen ervoor kiezen om toegang en gebruik te vragen van een HD4DP v2.0 Local applicatie van een andere zorgorganisatie. Zorgorganisaties die niet aan de systeemvereisten kunnen voldoen en geen toegang hebben tot en gebruik kunnen maken van een HD4DP v2.0 Local applicatie van een andere zorgorganisatie, kunnen toegang tot en gebruik vragen van HD4DP v2 WEB gehost door healthdata.be.

De applicatie HD4DP v2.0 Local wordt door healthdata.be kosteloos op afstand onderhouden op de infrastructuur van de zorgorganisatie. De infrastructuur waarop de applicatie HD4DP v2.0 Local is geïnstalleerd, dient door de zorgorganisatie te worden onderhouden.

Bart.Servaes wo, 11/22/2023 - 09:50

Positie van HD4DP v2 in HD Architectuur 2.0

Bart.Servaes wo, 11/22/2023 - 09:53

Gebruikershandleiding van de applicatie HD4DP v2

In deze handleiding beschrijven we de volgende functies van de applicatie HD4DP v2:

Bart.Servaes vr, 06/07/2024 - 10:35

Toegang tot een HD applicatie aanvragen voor een specifiek project

Applicaties van healthdata.be zoals HD4DP v2.0 en healthstat.be verwerken gevoelige persoonlijke informatie. Daarom worden nauwkeurig gecontroleerde processen gebruikt om toegang te verlenen tot deze applicaties. De Entity Access Management (EAM) portal van healthdata.be vergemakkelijkt deze processen.

Zorg steeds dat u gebruikt maakt van de huidige versie van het EAM-systeem. De gebruikersdocumentatie vindt u hier.

Deze documentatie wordt regelmatig bijgewerkt. We proberen de informatie zo correct, volledig en zo duidelijk mogelijk weer te geven. Als u desondanks iets in de documentatie ziet dat niet correct is, niet overeenkomt met uw ervaring, of verdere verduidelijking vereist, maak dan een support ticket via ons portaal (https://healthdatabe.atlassian.net/servicedesk/customer/portals) of stuur ons een e-mail via support.healthdata@sciensano.be om dit documentatieprobleem te melden. Vergeet niet de URL of het webadres van de pagina met het documentatieprobleem te vermelden. Wij zullen de documentatie dan aanpassen. Bedankt!

Bart.Servaes vr, 06/07/2024 - 10:35

Gebruikersrollen in HD4DP v2

Elke gezondheidszorgorganisatie heeft een Access Manager die waakt over de toegangsrechten tot de applicaties van de eigen organisatie en deze beheert in het HD Entity Access Management (EAM) systeem. In dit proces worden toegangsaanvragen van medewerkers van gezondheidszorgorganisaties geanalyseerd en gevalideerd als ze legitiem zijn. Het niveau van de verleende toegang kan verschillen, wat tot uiting komt in verschillende gebruikersrollen. Op basis van toegangsrechten kunnen de volgende drie gebruikersrollen worden onderscheiden:

Local Study Lead (auteur):

De Local Study Lead kan:

alle registraties van collega's (ongeacht hun rol) voor de studie of het project zien en bewerken;
registraties maken in HD4DP v2.

Deze rol kan, maar hoeft niet beperkt te zijn tot, de verantwoordelijke voor het onderzoek of project binnen de deelnemende gezondheidszorgorganisatie.

Local Study Associate (auteur):

De Local Study Associate kan:

alleen de eigen registraties bekijken en bewerken, niet die van andere collega's van dezelfde gezondheidszorgorganisatie die aan hetzelfde onderzoek of project deelnemen. De aangeduide registraties zijn beperkt tot de patiënten die behandeld worden door de Local Study Associate;
registraties maken in HD4DP v2.

De Local Study Associate is een gezondheidszorgverstrekker die deelneemt aan de studie of het project.

Local Study Support (co-auteur):

De Local Study Support kan:

alleen de registraties zien en bewerken die behoren tot de auteursgroep waaraan hij/zij is gekoppeld;
registraties maken in HD4DP v2.

Een Local Study Associate en Local Study Lead kunnen registratietaken delegeren aan een Local Study Support. Dit kan, maar hoeft niet beperkt te zijn tot, een administratief medewerker of personeel van een afdeling voor medische codering. De Local Study Associate en Local Study Lead worden nog steeds beschouwd als de auteur van de registratie. De Local Study Associate en Local Study Lead kunnen de gegevens van de Local Study Support bekijken en wijzigen.

De toegangsrechten zijn bedoeld om te voorkomen dat gebruikers van HD4DP v2 persoonlijke en gevoelige informatie zien van personen met wie ze geen therapeutische relatie hebben. De toegangsrechten weerspiegelen daarom niet noodzakelijk de hiërarchie binnen de gezondheidszorgorganisatie. Het personeel van de gezondheidszorgorganisatie kan de Data Protection Officer (DPO) raadplegen voor meer gedetailleerde informatie over deze toegangsrechten. Het is aan de Access Manager om rollen goed te keuren of te wijzigen van/naar Local Study Lead, Local Study Associate en Local Study Support. Deze verzoeken worden in het EAM-systeem uitgevoerd door de Access managers van elke gezondheidszorgorganisatie.

Opmerkingen:

Het niveau van de toegangsrechten weerspiegelt niet noodzakelijkerwijs de hiërarchie binnen uw gezondheidszorgorganisatie.
Het is aan de Access manager om de rollen van Local Study Lead, Local Study Associate en Local Study Support onderling te wijzigen. Deze acties gebeuren in het EAM-systeem.

Bart.Servaes wo, 11/22/2023 - 10:05

Toegang tot de applicatie HD4DP v2

Om toegang te krijgen tot de applicatie HD4DP v2 (zowel de lokale versie als de website versie), moet u eerst een account aanvragen. Als u nog geen account heeft, lees dan eerst het artikel "Toegang tot een HD applicatie aanvragen voor een specifiek project".

Zodra uw account is aangemaakt, ontvangt u een e-mail met de volgende informatie (let op: de tekst tussen de [ ] wordt aangepast.):

Organisatie: [RIZIV nummer - Naam]
Login: [email]
Wachtwoord: [wachtwoord]
Applicatie URL: [url]

Met deze referenties heeft u toegang tot de applicatie HD4DP v2.0 van uw organisatie:

Ga naar de url vermeld in de mail
Selecteer "uw organisatie" uit de lijst
Uw organisatie: [RIZIV nummer–Naam]
Klik op "Volgende"
Vul uw "username" en "password"
Klik op "Log in"

Bart.Servaes vr, 06/07/2024 - 10:36

Naar het BRBDR project navigeren

Naar het BRBDR project navigeren Adelaide.DAmore vr, 06/07/2024 - 10:36

Een BRBDR registratie creëren

Een BRBDR registratie creëren Bart.Servaes vr, 06/07/2024 - 10:37

Een BRBDR registratie vinden

Een BRBDR registratie vinden Bart.Servaes vr, 06/07/2024 - 10:37

Een BRBDR registratie bijwerken

Een BRBDR registratie bijwerken Bart.Servaes vr, 06/07/2024 - 10:38

Een BRBDR registratie verwijderen

Een BRBDR registratie verwijderen Bart.Servaes vr, 06/07/2024 - 10:38

Een BRBDR registratie verzenden

Een BRBDR registratie verzenden Bart.Servaes vr, 06/07/2024 - 10:39

Een correctie van een registratie verzenden

Om een correctie voor een registratie te verzenden, moet u de volledige record opnieuw verzenden.

De functie (en knop) Correctie toevoegen op het registratieformulier is afgeschaft. Ze is niet meer beschikbaar via de overzichtstabel, noch via de voorbeeldpagina van een registratie.

De volledige record opnieuw verzenden

De beste manier om een correctie voor een registratie te verzenden bestaat erin het registratieformulier volledig ingevuld met de juiste waarden opnieuw te verzenden. De meest recente versie van de record die healthdata.be dan ontvangt, wordt als de correcte beschouwd.

Of een record al dan niet in aanmerking komt, wordt bepaald door de zogeheten business key. Dit is een unieke set waarden uit specifieke velden per record, bijvoorbeeld een combinatie van de patiënt-ID en de hospitalisatiedatum, of van de NISS-code en de staal-ID. De business key wordt aangemaakt bij verzending van de originele record en zorgt dat meest recente record wordt geïdentificeerd bij ontvangst ervan in de healthdata.be-database.

Opgelet: Als een van de velden die de business key vormen, moet worden gecorrigeerd, zal de opnieuw verzonden record een andere business key hebben. De originele en de nieuwe records worden bijgevolg als correct beschouwd, precies omdat de business key niet identiek is.
We kunnen uw foutieve registratie spijtig genoeg niet onmiddellijk verwijderen. We zoeken naar een oplossing om dit op termijn toch te kunnen doen.

Er zijn twee opties om een record opnieuw te verzenden:

Optie 1: Verzenden via S2S API / CSV Upload

De waarden worden rechtstreeks in het json- of csv-bestand gecorrigeerd. De procedure om de volledige record opnieuw te verzenden via de back-end vindt u op de desbetreffende technische documentatiepagina's. In de onderstaande links vindt u voorbeelden voor Pacemaker Primo-Implantatie:

Voor het verzenden van de volledige record als een .json-bestand via S2S API, klik hier.
Voor het verzenden van de volledige record als een .csv-bestand via CSV Upload, klik hier.

Optie 2: Verzenden via de webapplicatie HD4DP v2.0

Open eerst de webapplicatie HD4DP v2.0, navigeer naar het studieprogramma en selecteer het gewenste studieproject in het linker donkerblauwe menu. Vul het volledige registratieformulier vervolgens handmatig in met de juiste waarden en verzend het opnieuw.

De vorige verzonden record is niet meer relevant op basis van de business key.

Bart.Servaes vr, 06/07/2024 - 10:40

Registratiestatussen in HD4DP v2

Dit artikel licht de verschillende registratiestatussen in HD4DP v2 toe.

De statussen worden weergegeven in de kolom Status

U kunt de kolommen die u wenst weer te geven, selecteren via het menu Zichtbare kolommen selecteren in de rechterbovenhoek:

Selecteer de kolommen die u wenst weer te geven en klik op Toepassen.

Beschrijving van de statussen:

Open: Registratie is aangemaakt en opgeslagen. Ze is niet verzonden.

Verwijderd: Registratie is verwijderd.

Verzonden: Registratie is ingediend en verzonden.

Bart.Servaes wo, 11/22/2023 - 11:19

Wachtwoord voor HD4DP v2 resetten

Nadat u uw credentials hebt ontvangen om in te loggen op de HD4DP 2.0 applicatie, kunt u overwegen om uw wachtwoord opnieuw in te stellen en er een te kiezen dat u makkelijker kunt onthouden.

Ga naar URL https://hd4dp.healthdata.be/, selecteer uw organisatie en klik op de knop Volgende.

Vul uw e-mailadres en het ontvangen wachtwoord in. Klik op de knop Log in.

Het hoofdmenu van de applicatie HD4DP 2.0 wordt weergegeven. Links vindt u het navigatiemenu met studieprogramm's en studieprojecten, terwijl u rechts de sectie ziet waarin de respectieve registraties beschikbaar zullen zijn.

Bovenaan rechts op het scherm ziet u de link Wachtwoord opnieuw instellen. Klik op deze link.

Stel het wachtwoord dat u hebt ontvangen opnieuw in door het gewenste wachtwoord in te voeren. Herhaal het nieuwe wachtwoord in het verificatieveld en klik op de knop Verzenden.

U keert terug naar het hoofdmenu, en het wachtwoord wordt automatisch opnieuw ingesteld. U hoeft hier niet opnieuw in te loggen.

Wanneer u opnieuw inlogt voor een volgende registratiesessie, maakt u gebruik van uw nieuwe wachtwoord.

Jonas.VanBussel vr, 06/07/2024 - 10:40

Technische handleiding van de applicatie HD4DP v2

Technische handleiding van de applicatie HD4DP v2 Bart.Servaes di, 10/08/2024 - 08:17

Technische gebruikersrollen in HD4DP v2

IT administrator: Een IT administrator heeft het hoogste niveau van alle rollen en machtigingen en kan:

inloggen met actieve directory;
toegang verlenen aan een Local Study Lead, een Local Study Associate en een Local Study Support;
alle projecten selecteren en openen;
een registratie aanmaken, zoeken, bijwerken, verwijderen, indienen (bij healthdata.be, MyCareNet en andere bestemmingen) en corrigeren met de form.io componenten;
een registratie aanmaken, bijwerken, indienen en corrigeren met behulp van API data collectie;
een registratie aanmaken, bijwerken, indien en corrigeren met behulp van CSV upload;
een MyCareNet-registratie aanmaken en indienen met behulp van MyCareNet XML;
alle registraties voor alle projecten bekijken;
alle registraties voor alle projecten uit de Local DWH verzamelen met behulp van de PostgreSQL-database

Bart.Servaes do, 04/25/2024 - 15:31

Installatie van HD4DP v2