Hartkleppen

Welkom op de pagina's met technische documentatie over het project "Hartkleppen" (voorheen "Transcatheter aortaklep implantatie"), aangeboden door de dienst healthdata.be (Sciensano).

Deze pagina's geven informatie over de technische processen van het project. De volgende onderdelen (zullen) worden verstrekt:

Algemene informatie over het project
De datacollectie
De gegevensoverdracht (documentatie in uitvoering)
De gegevensvalidatie (documentatie in uitvoering)
De gegevensanalyse (documentatie in uitvoering)
De rapportage en visualisatie van de gegevens (documentatie in uitvoering)

Voor wetenschappelijke informatie over het project kunt u contact opnemen met de primaire organisatie die toezicht houdt op de uitvoering van het project (zie hoofdstuk "Algemene projectinformatie").

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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!

johanvanbussel wo, 05/10/2023 - 14:21

Algemene informatie over het Hartkleppen project

Naam van het project

Hartkleppen

Eerder: Transkatheter aortaklep implantatie

Projectafkorting

TAVI

Projectcode

HDBP0245

Primaire organisatie die toezicht houdt op de uitvoering van het project

Rijksinstituut voor ziekte- en invaliditeitsverzekering (RIZIV)

Partnerorganisatie die deelneemt aan het project

Niet beschikbaar

Organisatie die opdracht heeft gegeven voor dit project

Rijksinstituut voor ziekte- en invaliditeitsverzekering (RIZIV)

Organisatie die financiële of materiële steun verleent

Rijksinstituut voor ziekte- en invaliditeitsverzekering (RIZIV)

Korte beschrijving van het project

De Commissie Tegemoetkoming Implantaten en Invasieve Medische Hulpmiddelen heeft een wijziging goedgekeurd van de vergoeding van chirurgische hartkleppen en percutane aortahartkleppen door wijziging van de indicaties om baat te hebben bij een percutane aortaklep en door vergoeding van de kleppen te laten registreren in een register. Momenteel moeten ziekenhuizen voor chirurgische hartkleppen een papieren formulier naar de verzekeraar sturen met enkele gegevens en is er een optionele registratie van percutane aortakleppen via een register bijgehouden door de wetenschappelijke vereniging. De wijziging in de vergoeding voorziet daarom in verplichte online registratie van medische gegevens en geïmplanteerde apparatuur voor implantaties van chirurgische en percutane aortahartkleppen, evenals monitoring van chirurgische en percutane aortakleppen (de codering van monitoring voor andere kleppen is optioneel). Deze verplichte registratie laat in het bijzonder toe zicht te hebben op alle implantaties van chirurgische kleppen alsook op de implantaties van geïmplanteerde percutane aortakleppen. De registratie van percutaan geïmplanteerde kleppen verzamelt ook informatie over de indicaties waarvoor is besloten om de aortaklep percutaan te vervangen in plaats van operatief. De twee betrokken wetenschappelijke verenigingen, BWGIC en BACTS, zullen om de twee jaar verslag uitbrengen op basis van de geregistreerde gegevens en deze aan de Commissie voorleggen.

Regelgevend kader van dit project

Raadpleeg de informatie over het regelgevingskader op de pagina's van fair.healthdata.be

Adelaide.DAmore do, 03/30/2023 - 14:41

De Hartkleppen datacollectie

Organisaties en/of personen die gegevens verstrekken

71000634	CHR de Namur
71000931	Ziekenhuisnetwerk Antwerpen - Campus ZNA Middelheim/Koningin Paola Kinderziekenhuis
71001030	Grand Hopital de Charleroi
71001723	AZ Maria Middelares
71003901	CHU UCL Namur - Mont-Godinne
71004988	AZ St-Jan Brugge-Oostende
71007661	CHU St-Pierre
71007760	CHU Brugmann
71009641	CHU Tivoli
71011027	Kliniek St-Jan - Clinique St-Jean
71011126	Europaziekenhuizen - Cliniques de l'Europe
71011720	AZ Delta
71012611	OLV Aalst
71014391	UZ Brussel
71014688	CH de Jolimont - Lobbes
71017658	ASZ Aalst
71024388	Jessaziekenhuis - Campus Virga Jesse
71030031	UZ Antwerpen
71032209	UZ Leuven
71037157	Ziekenhuis Oost-Limburg
71040325	UCL St-Luc
71040622	CUB Hopital Erasme
71041216	CHR de la Citadelle
71067049	UZ Gent
71068930	Imelda Ziekenhuis
71070613	Clinique St-Luc
71070712	CHU de Liege
71071801	Hopital Civil Marie-Curie

Begindatum van de gegevensverzameling

01/05/2023

Einddatum van de gegevensverzameling

Onbepaald

Periodiciteit van de gegevensverzameling

Continu

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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!

Adelaide.DAmore di, 04/04/2023 - 12:50

De Hartkleppen datacollectiedefinitie (HDBP0245)

In het onderstaande bestand vindt u de specificaties van de datacollectiedefinitie (DCD, data collection definition) van het project Hartkleppen. Het betreft een gedetailleerde beschrijving van de inhoud van 2 DCD's:

Implantatie
Follow-up

met veldnamen, formaten, waarden, validatieregels, helpteksten, waarschuwingsteksten, vertalingen etc. Deze specificaties werden gebruikt voor het opstellen van de formulieren, csv's en API's in dit project welke u ook in deze projecthandleiding kunt vinden.

Deze versie bevat redactionele wijzigingen.

HD_DCD_spec_HDBP0245_TAVI_1.0_20230414

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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!

Adelaide.DAmore di, 06/06/2023 - 11:44

De beschrijving van de Hartkleppen Dataflow

Hieronder beschrijven we (op hoog niveau) de Hartkleppen dataflow tussen de gegevensverstrekker en het healthdata.be-platform.

Stap 1. Automatische data export vanuit systemen van dataleverancier naar HD4DP v2 en prefill van formulieren indien niet volledig.

Stap 2. Handmatige registratie (de novo of aanvulling) van gegevens in formuliercomponent van HD4DP v2.

Stap 3. Directe real time overdracht van registervariabelen en technische ID van record van HD4DP v2 naar HD.

Stap 4. Overdracht van patiëntidentifiers en technische ID van dossier van HD4DP v2 naar eHBox-berichtenclient van HCO (HCO UM/EM).

Stap 5. Overdracht van patiëntidentifiers en technische ID van dossier van eHBox-berichtencliënt van HCO (HCO UM/EM) naar TTP-dienst van eHealth.

Stap 6. Overdracht van gepseudonimiseerde patiëntidentificatoren en technische ID van dossier van TTP-dienst van eHealth naar eHBox-berichtenclient van HD (HD UM/EM).

Stap 7. Overdracht van gepseudonimiseerde patiëntidentificatoren en technische ID van het dossier van de eHBox-client voor berichtenverkeer van HD (HD UM/EM) naar de HD-integratie-engine.

Stap 8. Samenvoeging en overdracht van gepseudonimiseerde patiënt-ID's, registervariabelen en technische ID's van records van de HD-integratie-engine naar de gegevensvalidatieomgeving op de DHW.

Stap 9 - Optie 1. Indirecte overdracht of patiëntidentificatoren en NIC-CIN-variabelen van HD4DP v2 Local via de MyCareNet-component van de HCO naar NIC-CIN (default).

Stap 9 - Optie 2. Directe realtime-overdracht van patiëntidentificatoren, NIC-CIN-variabelen en technische ID van het dossier van HD4DP v2 naar NIC-CIN (facultatief).

Adelaide.DAmore do, 03/30/2023 - 14:42

HD4DP v2

Voor het project "Hartkleppen" kan alleen de lokale versie van HD4DP v2 worden gebruikt. HD4DP v2 WEB is niet beschikbaar voor dit project.

Algemene beschrijving van de HD4DP v2 applicatie

HD4DP v2 is een lokale applicatie ontwikkeld door healthdata.be (Sciensano) en geïnstalleerd op de infrastructuur van de gegevensverstrekker. Met de applicatie kan de gegevensverstrekker gegevens uit het primaire systeem halen en deze koppelen aan een of meer gegevensverzamelingsprojecten.

De lokale HD4DP v2 applicatie is ook toegankelijk via een webbrowser. Vragen die niet kunnen worden beantwoord met gegevens uit de primaire systemen kunnen handmatig worden verwerkt in elektronische ("vooringevulde") formulieren.

Als de dossiers volledig zijn, kunnen de gegevens worden overgebracht naar het centrale dataplatform healthdata.be. Voor deze overdracht maakt HD4DP v2 verbinding met de ehealth messaging software van de gegevensverstrekker.

In de volgende paragrafen geven wij u informatie over hoe u te werk moet gaan:

Adelaide.DAmore do, 03/30/2023 - 14:53

Algemene beschrijving van de applicatie HD4DP v2

The HD4DP version 2.x Local is an electronic data capture (EDC) system: a computerized system designed for the collection of clinical data in electronic format for use in research supporting human public health policy. HD4DP (Health Data for Data providers) replaces the traditional paper-based data collection methodology and the proliferation of websites to streamline data collection and expedite the time to analysis and reporting.

Components and features

The HD4DP version 2.x Local application contains the following major components: NextGen Connect, Form.io, HD Connect (LOCAL Proxy), Local datawarehouse.

NextGen Connect

NextGen Connect is a health care integration engine that translates message standards into the standard required by the receiving system, including data formats and standards like HL7, DICOM, ANSI X12, ASCII, and XML. Main functionalities are filtering, transformation, extraction and routing.

The NextGen Connect component is used to handle all integrations within HD4DP 2.0 itself but also all integrations with the external world.

Data collections API: The form.io server offers a REST API which can be used to submit data for each known data collection. Data provider Master Systems cannot access this API directly but need to use the API exposed by the NextGen Connect component. This API is simply a proxy for the form.io API, but allows extra features on top of the form.io API such as security, monitoring, throttling, …

CSV API: For each data collection data can be submitted file-based using a CSV. A CSV can contain multiple data entries for a single data collection definition. These data entries are transformed and pushed by the NextGen Connect component towards the form.io server for potential manual post-processing and validation.

HL7 FHIR API: For some data collections an HL7 FHIR API will be available. The NextGen Connect component performs the transformation towards the Data Collections API and push the data into the form.io server.

Data delivery: the NextGen Connect component handles all routing of data towards the external world. This means it verifies the form.io server for completed data entries which have not yet been delivered. For each data entry that needs to be delivered, it determines where to send the data to, how it needs to be transformed and how it needs to be split. It performs all these actions in a guaranteed delivery fashion: it makes sure the data reaches its destination, possibly retrying when something went wrong.

Feedback: the NextGen Connect component coordinates the receival of feedback, potentially transforming it and pushing it towards the respective data collection entry using the data collections API.

Form.io

Form.io is a data management platform that includes a form builder with a drag and drop interface, management of data with complete API platform, management of users, offline forms, dynamic forms, automatic creation of API, and application embedding. In HD4DP v2, an Angular frontend application is available on top of the form.io server. This application provides a user interface to data providers in which they can see the different data collections for which they are allowed to record and submit data manually. A form.io backend server is responsible for providing the form definitions and registrations of new/updated entries.

HD Connect (LOCAL Proxy)

The HD Connect component is used to retrieve metadata from Master Data Management Database (MDM DB) residing on healthdata.be side.

Local datawarehouse

Each and every change in data entries on the form.io server is pushed towards the local datawarehouse (Local DWH) for easy reporting and data extraction. This local DWH consists of a PostgreSQL database.

Installation and maintenance

The application HD4DP v2 Local is provided without cost and installed remotely on the infrastructure of the healthcare organization by healthdata.be. Healthcare organizations are provided the system requirements for installation of HD4DP v2 application. Healthcare organizations that cannot provide the system requirements can opt to request access and use of a HD4DP v2 Local application of another healthcare organization. Healthcare organizations that cannot provide the system requirements and cannot access and use a HD4DP v2 Local application of another healthcare organization, can request access and use of HD4DP v2 WEB hosted by healthdata.be.

The application HD4DP v2 Local is maintained without cost remotely on the infrastructure of the healthcare organization by healthdata.be. The infrastructure on which the application HD4DP v2 Local is installed, should be maintained by the healthcare organization.

Bart.Servaes do, 03/30/2023 - 14:53

Positie van HD4DP v2 in HD Architectuur 2.0

Bart.Servaes do, 03/30/2023 - 14:55

Gebruikershandleiding van de applicatie HD4DP v2

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

Bart.Servaes do, 03/30/2023 - 22:37

Toegang tot een HD applicatie aanvragen voor een specifiek project

De applicaties van healthdata.be (zoals HD4DP v2 en healthstat.be) verwerken gevoelige persoonsgegevens. Daarom worden strikt gecontroleerde processen gebruikt om toegang te verlenen tot deze applicaties. De Entity Access Management (EAM) portal van healthdata.be faciliteert deze processen. In dit artikel beschrijven we hoe u deze kunt gebruiken

U vindt de EAM portal op het volgende webadres: https://eam.healthdata.be.

Selecteer een van de volgende hoedanigheden die bij uw functie past om toegang tot een HD applicatie te vragen:

Eindgebruiker (End-user)
IT SPOC (centraal IT aanspreekpunt)
Internationale gebruiker (eindgebruiker zonder NIS-nummer)

Standaard eindgebruikers

Om toegang aan te vragen tot applicaties van healthdata.be (zoals HD4DP v2 en healthstat.be) als standaard eindgebruiker, kunt u klikken op REQUEST ACCESS in het blauwe tekstvak in het midden van het scherm.

U belandt op de volgende pagina, waar u klikt op Log in with eID.

U wordt doorverwezen naar de Federal Authentication Service (FAS) van de overheid, waar u kunt inloggen met meerdere digitale sleutels zoals met eID en ItsMe.

Als u ervoor kiest om verbinding te maken met ItsMe, kunt u uw mobiele telefoonnummer invoeren.

Volg de instructies op uw mobiele toestel via de ItsMe-applicatie.

Nadat u de loginprocedure via ItsMe hebt doorlopen, klikt u in onderstaande scherm op de knop Profiel bevestigen om toegang te krijgen tot de Sciensano-omgeving.

Hierna bent u ingelogd in het EAM portaal. Bovenaan links op uw scherm ziet u de opties My profile en Log out.

Als u nu in het blauwe tekstvenster op REQUEST ACCESS klikt, om het toegangsaanvraagformulier te openen, verschijnt volgend bericht:

Klik in het bericht op My profile om naar uw persoonlijke profielpagina te gaan. Uw gebruikersprofiel moet aangevuld en gevalideerd worden, voordat u het toegangsaanvraagformulier kunt openen en invullen.

Selecteer het tabblad Edit om uw profielinformatie aan te vullen.

Behalve de profielinformatie die automatisch wordt ingevuld op basis van uw eID-gegevens, moet u de volgende velden aanvullen:

NIHDI Number: Uw RIZIV-nummer, indien beschikbaar.

Organization: Voer de organisatie(s) in, waaraan u ben verbonden. Dit veld bevat de naam en het RIZIV-nummer van de organisatie. Terwijl u tekst begint in te voeren, worden selectiemogelijkheden voorzien.

Email address: Verplicht in te vullen veld waarvoor de inhoud niet uit de eID kan worden opgehaald. Uw e-mailadres wordt gebruikt voor communicatie met betrekking tot de profielvalidatie en de toegangsaanvraag.

State: Selecteer een van de opties (zie afbeelding eronder):

Draft: Deze status geeft aan dat u nog niet klaar bent met het invullen van de profielvelden. Alleen u kunt in dit stadium de ingevulde gegevens zien. Het wijzigen van profielgegevens is alleen mogelijk in de status "Draft". U kunt de profielinformatie echter ook als "Draft" opslaan en later aanvullen en voor validatie verzenden.
Validation Requested: De ingevulde profielinformatie is volledig en u bent klaar om deze te verzenden voor validatie door de SPOC.

Klik op de knop Save om uw profielinformatie naar de SPOC te verzenden. Het bericht "Access denied" dat op uw scherm verschijnt, geeft aan dat u het ingevulde en verzonden profiel niet meer kunt wijzigen.

Als u terugkeert naar My profile ziet u dat het profiel "pending" is. Het profiel bevat ook geen tabblad Edit meer, zodat wijzigingen niet meer mogelijk zijn:

Uw profiel wordt spoedig gevalideerd door de SPOC, wat als volgt wordt weergegeven:

Na validatie van uw profiel door de SPOC selecteert u Home om terug te keren naar de EAM portaalpagina.
Let op: Selecteer hier niet de knop "Request access" (binnenkort: "Request SPOC rights"), omdat u hiermee het proces requesting access as a SPOC start.

Keer nu terug naar de EAM-portaal en selecteer opnieuw REQUEST ACCESS in het blauwgekleurde tekstframe.

Selecteer de organisatie waarvoor u toegang wenst tot de applicaties en projecten van healthdata.be.

Nu kunt u het toegangsaanvraagformulier "Request Access" als eindgebruiker invullen.

Vul alle verplichte velden in, aangeduid met een rode asterisk (*), selecteer de gewenste optie in de verplichte keuzelijsten en vink desgewenst de selectiehokjes aan voor aanvullende ondersteuning en/of informatie.

Veld Type of login:

Als u in het veld “Type of Login” de optie "Belgium resident" selecteert, is de invoer van het mobiele telefoonnummer optioneel.

Als u een "Non-Belgium resident" bent, dan moet u het veld Mobile phone number verplicht invullen, zodat een tweefactorauthenticatie (2FA) mogelijk is:

Veld Role of requestor in project

U moet uw rol in het project aangeven (Local Study Lead, Local Study Associate of Local Study Support). Uw rol bepaalt uw toegangsmogelijkheden in HD4DP2 voor het project. Lees hierover meer in Gebruikersrollen in HD4DP v2.

Als u de optie Local Study Support selecteert, moet u om privacyredenen de voornaam en familienaam van de Local Study Associate invullen.

Veld HD4DP2.0

Klik in het veld onder HD4DP2.0 als u de applicatie wilt gebruiken om registraties te maken voor het geselecteerde project:

Veld Healthstat.be

Klik in het veld onder healthstat.be als u de applicatie wilt gebruiken om toegang te hebben tot de rapportering voor het geselecteerde project:

Als u het toegangsaanvraagformulier volledig hebt ingevuld, klikt u op de knop Submit om het te verzenden. Na dit met succes te hebben verzonden, ontvangt u een bevestigingsbericht.

IT SPOC (centraal IT aanspreekpunt)

Een IT SPOC (single point-of-contact) is het centrale IT aanspreekpunt, een rol die ruimer is dan de functie van een VTE/RAE. Het kan namelijk om elke werknemer gaan binnen een organisatie aan wie deze rol is toegewezen.

Om toegang aan te vragen tot applicaties van healthdata.be, bijvoorbeeld HD4DP v2 en healthstat.be, in de hoedanigheid van IT SPOC, selecteert u GIVE ACCESS in het witte tekstvak rechts op uw scherm.

Mocht u nog nooit toegang hebben aangevraagd tot deze formulieren, en dus niet erkend bent als IT SPOC, dan ontvangt u volgend bericht:

Klik in dit geval op My Profile (bovenaan links op uw scherm) en vervolgens op de knop Request access.

Het scherm Request access [RAE] wordt geopend.

Fill in all requested fields and click on the Submit button.

Na verzending van het RAE formulier voeren de Support diensten van healthdata.be een identificatie- en autorisatieprocedure door betreffende uw SPOC-rol binnen de bewuste organisatie. Hierna ontvangt u een bevestigingse-mail met een speciale token. Hierna keert u terug naar de My Profile-pagina en klikt u op de knop Enter access token.

Het scherm Access token wordt geopend:

Vul de RIZIV-code voor uw organisatie in evenals de toegangstoken die u per e-mail hebt ontvangen. Na klikken op Submit wordt u doorverwezen naar de EAM portal, waar u opnieuw GIVE ACCESS selecteert.

Het formulier ACCESS REQUEST wordt geopend. Door de verplichte velden in te vullen, geeft de IT SPOC binnen de organisatie toegang aan gebruikers die toegang wensen tot een applicatie van healthdata.be (HD4DP2.0 of healthstat.be).

Als u het formulier Access Request volledig hebt ingevuld, klikt u op de knop Submit om het te verzenden. Na succesvolle verzending ontvangt u een bevestigingsbericht.

Het gebruikersprofiel op de pagina My Profile is nu uitgebreid met de naam en code van de organisatie. Er werd ook een extra tabblad Batch create requests toegevoegd.

Zie documentatie Toegang geven aan meerdere gebruikers in batch voor meer informatie.

Internationale gebruiker

Internationale gebruikers volgen onderstaande link naar een specifiek formulier:

https://eam.healthdata.be/forms/hd_eam_access_request_user_int

Deze link voert u naar een meer uitgebreid formulier Request Access. Vul alle verplichte velden (aangeduid met een rode asterisk *), selecteer de gewenste optie in de verplichte keuzelijsten en vink desgewenst de selectiehokjes aan voor aanvullende ondersteuning en/of informatie:

Na het verzenden van het formulier wordt een e-mail gestuurd naar de medewerkers van de Service diensten voor een identificatie- en autorisatieprocedure. Als de aanvraag wordt goedgekeurd, ontvangt de internationale gebruiker een e-mail met accountinformatie. Op dit moment kunnen internationale gebruikers echter niet inloggen noch overzichten van aanvragen consulteren.

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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 do, 03/30/2023 - 22:37

Gebruikersrollen in HD4DP v2

In de applicatie HD4DP v2 zijn verschillende gebruikersrollen mogelijk:

Local Study Lead: Deze rol is verantwoordelijk voor het onderzoek of het project binnen de deelnemende gezondheidszorginstelling. Vaak is dit het hoofd van de klinische afdeling die bij het onderzoek of project betrokken is. De Local Study Lead kan:

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

Local Study Associate (auteur): De Local Study Associate is een zorgverstrekker in de gezondheidszorg die deelneemt aan de studie of het project. Hij/zij rapporteert medische informatie aan de onderzoeker met behulp van HD4DP v2 en neemt daarbij de verantwoordelijkheid voor de juistheid van de gerapporteerde informatie. Hij/zij wordt beschouwd als de auteur van de registratie. Dit wordt weergegeven in het registratieformulier. De Local Study Associate kan:

registraties maken in HD4DP v2;
alleen zijn/haar eigen registraties zien, niet die van andere collega's van dezelfde zorgorganisatie die aan hetzelfde onderzoek of project deelnemen.

Local Study Support (co-auteur): Een Local Study Associate kan de inschrijving delegeren aan een Local Study Support. Vaak is dit een administratief medewerker of staf van een afdeling medische codering. De Local Study Associate wordt nog steeds beschouwd als de auteur van de registratie; de Local Study Support wordt beschouwd als co-auteur. De Local Study Associate kan aanmeldingen van Local Study Support inzien en wijzigen. De Local Study Support kan:

registraties maken in HD4DP v2;
ziet alleen zijn/haar eigen registraties, niet die van andere collega's van dezelfde zorginstelling die aan hetzelfde onderzoek of project deelnemen.

Er wordt standaard slechts 1 Local Study Lead aangemaakt door healthdata.be (Sciensano) voor elk project binnen elke organisatie. Dit betekent dat slechts 1 persoon alle aanmeldingen voor dat project binnen die organisatie kan zien. Dit beleid voorkomt dat gebruikers van HD4DP v2 persoonlijke en gevoelige informatie kunnen zien van personen met wie ze geen therapeutische relatie hebben.

In het geval dat organisaties meer dan 1 Local Study Lead creëren voor een project binnen die organisatie, zodat ze elkaars registraties kunnen zien, en dus persoonlijke en gevoelige informatie zien van personen met wie ze geen therapeutische relatie hebben, zijn de organisaties volledig verantwoordelijk en aansprakelijk voor deze beleidsafwijking. Healthdata.be (Sciensano) kan niet verantwoordelijk of aansprakelijk worden gesteld voor deze beleidsafwijking. Professionals die willen deelnemen aan projecten worden vriendelijk verzocht contact op te nemen met de Functionaris Gegevensbescherming (DPO) van hun organisatie om met hen te overleggen over deze bewuste beleidsafwijking.

Bart.Servaes do, 03/30/2023 - 15:09

Toegang verlenen tot een HD applicatie aan iemand van de organisatie

Om toegang te verlenen tot applicaties van healthdata.be, bijvoorbeeld HD4DP v2 en healthstat.be, klikt u op GIVE ACCESS in het witte tekstvak op de pagina van de EAM portal.

U kunt toegang tot een HD applicatie verlenen aan

een enkele gebruiker
meerdere gebruikers in batch

Toegang verlenen aan een enkele gebruiker

Na selectie van GIVE ACCESS in de EAM portal wordt het formulier ACCESS REQUEST weergegeven.

Het invullen van dit formulier gebeurt analoog aan dat van de Request Access voor standaard eindgebruikers. Het verschil is dat u nu in de hoedanigheid van IT SPOC het formulier invult voor een gebruiker binnen uw organisatie.

Veld Organization NIHDI number

Het RIZIV-nummer van de organisatie is automatisch ingevuld, omdat uw account aan deze organisatie gekoppeld is.

Veld Role in project

Bij selectie van Local Study Support moet u een optie selecteren in de keuzelijst van Author groups. Deze author groups zijn vastgelegd door de bewuste organisatie.

Veld HD4DP2.0

Klik in het veld onder HD4DP2.0 als u de applicatie wilt gebruiken om registraties te maken voor het geselecteerde project:

Veld Healthstat.be

Klik in het veld onder healthstat.be als u de applicatie wilt gebruiken om toegang te hebben tot de rapportering voor het geselecteerde project:

Als u het toegangsaanvraagformulier volledig hebt ingevuld, klikt u op de knop Submit om het te verzenden. Na een succesvolle verzending ontvangt u een bevestigingsbericht.

Via tabblad Profiles van het gevalideerde SPOC-profiel kunt u gebruikersprofielen zoeken, selecteren en sorteren. Geselecteerde gebruikersprofielen in de lijst kunnen worden gevalideerd (Validated) of geweigerd (Rejected) via het Action drop-down menu.

In het tabblad Requests kan de SPOC het overzicht van de aanvragen beheren. Meer informatie hierover vindt u in SPOC-acties na een aanvraag.

Zie documentatie onder Toegang verlenen aan meerdere gebruikers in batch voor meer informatie over het tabblad Batch create requests.

Het tabblad Edit (zie afbeelding hieronder) geeft de SPOC de mogelijkheid om de velden NIHDI number, Organization, Email address en State in het eigen profiel te wijzigen. Klik op Save om de nieuwe profielinformatie te bevestigen.

Ga naar Toegang verlenen aan meerdere gebruikers in batch om in één bewerking toegang te verlenen aan meerdere gebruikers.

Toegang verlenen aan meerdere gebruikers in batch

De persoon aan wie de rol van SPOC voor de gezondheidsinstelling is toegewezen, kan in één handeling toegang verlenen aan meerdere gebruikers. Hiervoor keert de SPOC terug naar de User profile-pagina en selecteert hij/zij het tabblad Batch create requests.

In het tabblad Batch create requests kan via de knop Bestand kiezen een CSV-bestand voor upload worden geselecteerd.

Selecteer het CSV-bestand en klik op de knop Run the batch creation. Hieronder vindt u een voorbeeld van de structuur van een CSV-bestand:

hd_eam_bulk_access_request_example-correct.csv Download

Per rij wordt nu een zogeheten master request gegenereerd, waarna de aanvraag in sub-requests wordt gesplitst (per applicatie en per project) en voor verdere verwerking in de healthdata.be DB2 wordt opgeslagen.

Een tabelschema (https://specs.frictionlessdata.io//table-schema/) is zeer geschikt om tabelgegevens in tekstformaten te verwerken en te valideren. Hieronder vindt u een voorbeeldbestand:

eam_csv_batch_requests_schema.json

Gebruikersrollen en overeenkomstige waarden

Er bestaan drie waarden om aan een rol toe te kennen:

1 = Local Study Lead: Healthdata.be kan slechts 1 Local Study Lead aanmaken voor elk register binnen elke organisatie.
2 = Local Study Associate (author). Omdat dit de default rol voor een gebruiker is, werd hier automatisch de waarde "2" ingevoerd.
3 = Local Study Support (co-author). Deze rol kan worden toegekend, indien deze beter aansluit bij de positie van de gebruiker. Een Support wordt steeds toegewezen aan een Associate.

Als u rol 1 en 2 (= Local Study Lead en Local Study Associate) selecteert, wordt de naam van de ‘Local Study Lead of Local Study Associate’ verwacht in het veld 'author_group'. De naam wordt ingevuld in het formaat <voornaam familienaam> van de Associate, met slechts 1 spatie tussen de twee namen).

Bij selectie van de waarde 3 (rol van Local Study Support) moet de naam van de ‘Local Study Associate’ in het veld author_group worden ingevuld. Het aangewezen formaat hiervoor is <voornaam familienaam> van de Associate, met 1 spatie (tab) tussen de twee namen).

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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 di, 03/14/2023 - 16:14

Overzicht van de aanvragen

Na verzending van de toegangsaanvragen en de ontvangst van het bevestigingsbericht kunt u de validatiestatus en andere informatie over de aanvragen consulteren via het tabblad Requests overview op de pagina My Profile.

Op basis van de omvang van de aanvragen die geconsulteerd kunnen worden, maken we een onderscheid tussen het aanvragenoverzicht voor:

een eindgebruiker
een IT SPOC (single point-of-contact).

Overzicht van de aanvragen voor eindgebruikers

Om de eigen aanvragen te bekijken, kunnen eindgebruikers de pagina My Profile openen en het tabblad Requests overview selecteren.

U kunt het weergegeven overzicht doorzoeken en via de bovenste rij naar believen sorteren (zie onderstaande figuur). Eindgebruikers zien enkel een lijst met aanvragen die ze voor zichzelf hebben gecreëerd.

Veld Request UUID

Dit veld bevat de unieke ID's van de aanvragen. Als eenzelfde unieke ID in meerdere rijen verschijnt, geeft dit aan dat de master request meerdere subrequests bevat, telkens een per project en per applicatie zoals geselecteerd in het aanvraagformulier. Deze subrequests worden dan voor verdere verwerking opgeslagen in de healthdata.be DB2.

Veld Status

Het statusveld geeft aan of de aanvraag werd aangemaakt (waarde “created”; wacht op goedkeuring door IT SPOC) of goedgekeurd (waarde “approved_rae”; aanvraag goedgekeurd door de SPOC en klaar voor verstrekken van credentials).

Veld Role in project

De waarden in dit veld zijn Local Study Lead, Local Study Associate en Local Study Support. Meer gedetailleerde informatie over deze rollen vindt u in Gebruikersrollen in HD4DP v2.

Veld Application

Dit veld bevat de applicatie die u hebt geselecteerd in het formulier Request Access (End-User) of het formulier Access Request voor toegang tot de volksgezondheidsprojecten: HD4DP2.0 of Healthstat.be.

Veld Project code

In dit veld voert u het nummer van het Healthdata.be businessproject (HDBPnnnn) in.

Als u dit nummer gebruikt in de zoekopdracht van de vrij toegankelijke FAIR portal (fair.healthdata.be), wordt de dataset voor dit project weergegeven.

U kunt dit nummer ook gebruiken in het veld Advanced search van de Healthdata.be docs pages, om de documentatie van het bewuste project te vinden.

Overzicht van de aanvragen voor IT SPOC's (IT single points-of-contact)

SPOC's kunnen alle aanvragen voor hun organisatie bekijken.

Om de status te bekijken van de aanvraag voor de gebruikers van hun organisatie, moet de IT SPOC op My Profile klikken en het tabblad Requests overview (zie onderstaand screenshot) selecteren. U kunt het overzicht doorzoeken en via de bovenste rij naar believen sorteren.

Veld Request UUID

Dit veld bevat de unieke ID's van de aanvragen. Als eenzelfde unieke ID in meerdere rijen verschijnt, geeft dit aan dat de master request meerdere sub-requests bevat, telkens een per project en per applicatie zoals geselecteerd in het aanvraagformulier. Deze sub-requests worden dan voor verdere verwerking opgeslagen in de healthdata.be DB2.

Veld Status

Het statusveld kan alleen de status “approved_rae” krijgen, omdat de aanvraag door de IT SPOC zelf gebeurde.

Veld Role in project

De waarden in dit veld zijn Local Study Lead, Local Study Associate en Local Study Support. Meer gedetailleerde informatie over deze rollen vindt u in Gebruikersrollen in HD4DP v2.

Veld Application

Veld Project code

In dit veld voert u het nummer van het Healthdata.be businessproject (HDBPnnnn) in.

Als u dit nummer gebruikt in de zoekopdracht van de vrij toegankelijke FAIR portal (fair.healthdata.be), wordt de dataset voor dit project weergegeven.

U kunt dit nummer ook invoeren als zoekopdracht in het veld Advanced search op de Healthdata.be docs pages om de overeenkomstige documentatie op te halen.

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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 di, 03/14/2023 - 16:06

SPOC actions

In this article, we cover the different actions of a SPOC in more detail.

SPOC actions upon a request

SPOCs will be notified in case a request for access was made by a colleague, allowing them to review the overview table to manage all requests for their organization.

To open the overview table, the SPOC needs to navigate to "My Profile" followed by selection of the "Requests" tab. The overview of the requests appears (see below).

In the Actions field an Approve/Reject selection button is displayed next to each request with the status created or approval_requested (framed in blue). Two actions are possible now: the SPOC can either approve or reject the user's request.

When selecting Approve, and after confirmation of this action, the status of the request changes to "approved_rae" and the dates in both fields Updated and Completed are updated accordingly as demonstrated in the screenshots below. Once the registry goes in production the account will be created automatically and the credentials will be shared to the user by e-mail.

Approve action:

Pop-up confirmation query:

Approved:

When returning to the overview, you will notice that the status of the request has changed to "approved_rae". The Approve/Reject button in the Actions field has disappeared.

When selecting Reject, and after confirmation of this action, the request receives the status "rejected", the dates in the fields Updated and Completed are updated accordingly. A rejected request remains in the overview for information purposes. Compare following screens:

Reject action:

Pop-up confirmation query:

Rejected:

The requester will also be notified of the rejected request by e-mail:

Dear,

Your request for access to EAM was rejected.

Please contact your HD4DP SPOC for more information.

Best regards
Healthdata Support

Bart.Servaes ma, 04/03/2023 - 17:40

Naar het Hartkleppen project navigeren

Als u bent ingelogd, ziet u de Welkomstpagina. In het linker donkerblauwe menu zie je alle studieprogramma's en projecten waartoe je toegang hebt.

Wanneer u het studieprogramma QERMID Hartziekten selecteert, ziet u het studieproject Hartkleppen.

Selecteer het studieproject Hartkleppen.

U zult zien dat het studieproject Hartkleppen uit twee delen bestaat: Implantatie en Follow-up.

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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!

Adelaide.DAmore do, 03/30/2023 - 15:15

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 "Account aanvragen voor HD4DP v2".

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 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 do, 03/30/2023 - 16:17

Een Hartkleppen registratie creëren

Het studieproject Hartkleppen bestaat uit twee delen: Implantatie en Follow-up.

Op de volgende pagina's wordt uitgelegd hoe u voor elke sectie een registratie creëert.

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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!

Adelaide.DAmore do, 03/30/2023 - 16:03

Een "Hartkleppen" "Implantatie" registratie creëren

Om een "Implantatie" registratie te creëren voor het studieproject Hartkleppen, selecteer "Implantatie" in het donkerblauwe linkermenu.

U zult het aantal versies van dit studieonderdeel zien. In dit geval is er maar één versie.

Wanneer u de hoogste versie van dit studieonderdeel voor de eerste keer selecteert, ziet u een lege overzichtstabel in het hoofdgedeelte van uw scherm. De tabel bevat onder andere de volgende items: Registratie ID, Vooruitgang, Auteur, Co-auteur, Unieke ID, Business Key, Registratiecode, Rijksregisternummer van de patiënt…

In de rechterbovenhoek van het scherm vindt u een groene knop "+ Nieuwe registratie". Druk op deze knop.

Nadat u op de knop "+ Nieuwe registratie" hebt gedrukt, wordt het hoofdscherm vervangen door 2 delen: een onderzoeksformulier (in het midden van het scherm) en een inhoudstafel (aan de rechterkant van het scherm).

Door het invullen van het onderzoeksformulier maakt u een "Implantatie" registratie aan voor het studieproject Hartkleppen.

De Inhoudstafel geeft aan welke onderdelen u moet invullen. U kunt de inhoudstafel ook gebruiken om door de vragenlijst te navigeren: door op een rubriek in de inhoudstafel te drukken, gaat u naar deze rubriek in de vragenlijst.

Door op het tabblad "Vooruitgang" aan de rechterkant van het scherm te drukken, wordt de inhoudstafel vervangen door een vooruitgangsbalk en een lijst van openstaande validatiefouten.

U kunt de lijst met openstaande validatiefouten gebruiken om door het onderzoeksformulier te navigeren: door op een validatiefout in de lijst te drukken, gaat u naar dit onderdeel in het onderzoeksformulier.

Als het onderzoeksformulier is ingevuld en er geen validatiefouten zijn, kunt u deze registratie Opslaan of Verzenden. Merk op dat de knop Verzenden helder groen is.

Als het onderzoeksformulier is ingevuld maar er zijn validatiefouten, dan kunt u deze registratie wel Opslaan maar niet Verzenden. Merk op dat de knop Verzenden schemerig groen is.

Wanneer het onderzoeksformulier is opgeslagen of verzonden, schakelt het scherm over naar de overzichtstabel. Deze tabel is nu niet meer leeg, maar toont de opgeslagen of verzonden registratie.

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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!

Adelaide.DAmore do, 03/30/2023 - 16:08

Een "Hartkleppen" "Follow-up" registratie creëren

Om een "Follow-up" registratie aan te maken voor het onderzoeksproject Hartkleppen, selecteer "Follow-up" in het donkerblauwe linkermenu.

U zult het aantal versies van dit studieonderdeel zien. In dit geval is er maar één versie.

Wanneer u de hoogste versie van dit studieonderdeel voor de eerste keer selecteert, ziet u een lege tabel in het hoofdgedeelte van uw scherm. De tabel bevat onder andere de volgende items: Registratie ID, Vooruitgang, Auteur, Co-auteur, Unieke ID, Business Key, Registratiecode, Rijksregisternummer van de patiënt…

In de rechterbovenhoek van het scherm vindt u een groene knop "+ Nieuwe registratie". Druk op deze knop.

Door het invullen van het onderzoeksformulier maakt u een "Follow-up" registratie aan voor het studieproject Hartkleppen.

Door op het tabblad "Vooruitgang" aan de rechterkant van het scherm te drukken, wordt de inhoudstafel vervangen door een vooruitgangsbalk en een lijst van openstaande validatiefouten.

Als het onderzoeksformulier is ingevuld en er geen validatiefouten zijn, kunt u deze registratie Opslaan of Verzenden. Merk op dat de knop Verzenden helder groen is.

Als het onderzoeksformulier is ingevuld maar er zijn validatiefouten, dan kunt u deze registratie wel Opslaan maar niet Verzenden. Merk op dat de knop Verzenden schemerig groen is.

Wanneer het onderzoeksformulier is opgeslagen of verzonden, schakelt het scherm over naar de overzichtstabel. Deze tabel is nu niet meer leeg, maar toont de opgeslagen of verzonden registratie.

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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!

Adelaide.DAmore do, 03/30/2023 - 16:08

Een "Hartkleppen" registratie vinden

Het studieproject Hartkleppen bestaat uit twee delen: Implantatie en Follow-up.

Op de volgende bladzijden wordt uitgelegd hoe u voor elke sectie een registratie kunt vinden.

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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!

Adelaide.DAmore do, 03/30/2023 - 16:09

Een "Hartkleppen" "Implantatie" registratie vinden

Om een "Implantatie" registratie te vinden voor het studieproject Hartkleppen, selecteer "Implantatie" in het donkerblauwe linkermenu.

Wanneer u een versie van dit studieonderdeel selecteert, ziet u de samenvattende tabel in het hoofdgedeelte van uw scherm. Deze tabel bevat onder andere: Registratie ID, Vooruitgang, Auteur, Co-auteur, Unieke ID, Business Key, Registratiecode, Rijksregisternummer van de patiënt…

In de koptekst van de overzichtstabel kunt u het filter onder elk kolomlabel gebruiken. In het onderstaande voorbeeld is in het filter (tekstveld) de achternaam "Khan" ingevoerd: als resultaat wordt alleen het record met "Khan" weergegeven.

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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!

Adelaide.DAmore do, 03/30/2023 - 16:09

Een "Hartkleppen" "Follow-up" registratie vinden

Om een "Follow-up" registratie te vinden voor het studieproject Hartkleppen, selecteert u "Follow-up" in het donkerblauwe linkermenu.

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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!

Adelaide.DAmore do, 03/30/2023 - 16:09

Een "Hartkleppen" registratie bijwerken

Het studieproject Hartkleppen bestaat uit twee delen: Implantatie en Follow-up.

Op de volgende pagina's wordt uitgelegd hoe u een registratie voor elke rubriek kunt bijwerken.

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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!

Adelaide.DAmore do, 03/30/2023 - 16:09

Een "Hartkleppen" "Implantatie"registratie bijwerken

Een "Implantatie" registratie kan worden bijgewerkt zolang de registratie nog niet is verzonden. Als de status van een registratie "Opgeslagen" is, kan de registratie nog worden bijgewerkt.

Om een "Implantatie" registratie bij te werken voor het studieproject Hartkleppen, selecteer "Implantatie" in het donkerblauwe linkermenu.

Wanneer u een versie van dit studieonderdeel selecteert, ziet u de overzichtstabel in het hoofdgedeelte van uw scherm. Deze tabel bevat onder andere: Registratie ID, Vooruitgang, Auteur, Co-auteur, Unieke ID, Business Key, Registratiecode, Rijksregisternummer van de patiënt…

Gebruik de filters in de kop van de tabel om de registratie te vinden die u wilt bijwerken.

Als u de registratie hebt gevonden, kunt u het onderzoeksformulier openen door op de overeenkomstige rij in de overzichtstabel te klikken.

U kunt de ontbrekende velden invullen en / of de eerder ingevulde velden in het onderzoeksformulier wijzigen.

Aan het eind van het onderzoeksformulier kunt u de registratie "Opslaan" of "Verzenden".

Als u de registratie opslaat, kunt u deze nog bewerken. Een verzonden registratie kan niet meer worden gewijzigd of verwijderd.

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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!

Adelaide.DAmore do, 03/30/2023 - 16:09

Een "Hartkleppen" "Follow-up"registratie bijwerken

Een "PRE-campagne" registratie kan worden bijgewerkt zolang de registratie nog niet is verzonden. Als de status van een registratie "Opgeslagen" is, kan de registratie nog worden bijgewerkt.

Om een "Follow-up" registratie bij te werken voor het studieproject Hartkleppen, selecteer "Follow-up" in het donkerblauwe linkermenu.

Gebruik de filters in de kop van de tabel om de registratie te vinden die u wilt bijwerken.

Als u de registratie hebt gevonden, kunt u het onderzoeksformulier openen door op de overeenkomstige rij in de overzichtstabel te klikken.

U kunt de ontbrekende velden invullen en / of de eerder ingevulde velden in het onderzoeksformulier wijzigen.

Aan het eind van het onderzoeksformulier kunt u de registratie "Opslaan" of "Verzenden".

Als u de registratie opslaat, kunt u deze nog bewerken. Een verzonden registratie kan niet meer worden gewijzigd of verwijderd.

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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!

Adelaide.DAmore do, 03/30/2023 - 16:09

Een "Hartkleppen" registratie verwijderen

Het studieproject Hartkleppen bestaat uit twee delen: Implantatie en Follow-up.

Op de volgende pagina's wordt uitgelegd hoe u een registratie voor elke rubriek kunt verwijderen.

This documentation is under construction. We try to provide as correct, complete and clear as possible information on these pages. Nevertheless, if you see anything in the documentation that is not correct, does not match your experience or requires further clarification, please send us an email via support.healthdata@sciensano.be to report this documentation issue. Please, do not forget to mention the URL or web address of the page with the documentation issue. We will then adjust the documentation as soon as possible. Thank you!

Adelaide.DAmore do, 03/30/2023 - 16:10

Een "Hartkleppen" "Implantatie" registratie verwijderen

Een "Implantatie" registratie kan worden verwijderd zolang de registratie nog niet is verzonden. Als de status van een registratie "Open" is, kan de registratie nog steeds worden verwijderd.

Om een "Implantatie" registratie te verwijderen voor het studieproject Hartkleppen, selecteer "Implantatie" in het donkerblauwe linkermenu.

Gebruik de filters in de kop van de tabel om de registratie te vinden dat u wilt verwijderen.

Als u de registratie hebt gevonden dat u wilt verwijderen, moet u de registratie selecteren door het selectievakje aan het begin van de rij in het overzichtstabel aan te vinken.

Vervolgens moet u op de knop "Acties" rechtsboven in de overzichtstabel drukken

Twee opties zijn nu beschikbaar: "Registraties verzenden" en "Registraties verwijderen". Druk nu op "Registraties verwijderen".

Nadat u op "Registraties verwijderen" hebt gedrukt, verschijnt een popup venster enster waarin u wordt gevraagd de verwijdering van de geselecteerde registratie(s) te bevestigen. Als u zeker bent van deze actie, drukt u op "Bevestig". Zo niet, druk dan op "Annuleer".

Als u de registratie verwijdert, kunt u de status of inhoud ervan niet meer wijzigen.

De verwijderde registratie wordt niet uit de overzichtstabel verwijderd. Het blijft aanwezig, maar de status is veranderd van "Open" in "Verwijderd".

Als u alleen open en verzonden registraties wilt zien, kunt u het filter op het item "Status" in de overzichtstabel aanpassen.

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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!

Adelaide.DAmore do, 03/30/2023 - 16:10

Een "Hartkleppen" "Follow-up" registratie verwijderen

Een "Follow-up" registratie kan worden verwijderd zolang de registratie nog niet is verzonden. Als de status van een registratie "Open" is, kan de registratie nog steeds worden verwijderd.

Om een "Follow-up" registratie voor het onderzoeksproject Hartkleppen te verwijderen, selecteert u "Follow-up" in het donkerblauwe linkermenu.

Gebruik de filters in de kop van de tabel om de registratie te vinden dat u wilt verwijderen.

Als u de registratie hebt gevonden dat u wilt verwijderen, moet u de registratie selecteren door het selectievakje aan het begin van de rij in het overzichtstabel aan te vinken.

Vervolgens moet u op de knop "Acties" rechtsboven in de overzichtstabel drukken

Twee opties zijn nu beschikbaar: "Registraties verzenden" en "Registraties verwijderen". Druk nu op "Registraties verwijderen".

Als u de registratie verwijdert, kunt u de status of inhoud ervan niet meer wijzigen.

De verwijderde registratie wordt niet uit de overzichtstabel verwijderd. Het blijft aanwezig, maar de status is veranderd van "Open" in "Verwijderd".

Als u alleen open en verzonden registraties wilt zien, kunt u het filter op het item "Status" in de overzichtstabel aanpassen.

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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!

Adelaide.DAmore do, 03/30/2023 - 16:10

Een "Hartkleppen" registratie verzenden

Het studieproject Hartkleppen bestaat uit twee delen: Implantatie en Follow-up.

Op de volgende pagina's wordt uitgelegd hoe u voor elk onderdeel een registratie kunt verzenden.

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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!

Adelaide.DAmore do, 03/30/2023 - 16:15

Een "Hartkleppen" "Implantatie" registratie verzenden

Een "Implantatie" registratie kan aan het einde van het creatieproces worden verzonden met behulp van het onderzoeksformulier (zie: Een "Hartkleppen" "Implantatie" registratie creëren).

Als de registratie via het studieformulier is voltooid, opgeslagen en er geen validatiefouten meer zijn, kan de registratie ook via de overzichtstabel worden verzonden. Deze methode kan handig zijn om meerdere registraties in dezelfde actie te verzenden.

Om een "Implantatie" registratie te verzenden voor het studieproject Hartkleppen via de overzichtstabel, selecteer "Implantatie" in het donkerblauwe linkermenu.

Gebruik de filters in de koptekst van de tabel om de registratie(s) te vinden die u wilt verzenden. U kunt bijvoorbeeld de filters "Status" (ingesteld op "Open") en "Validatiefouten" (ingesteld op "0") gebruiken om de registraties te krijgen die kunnen worden verzonden.

Als u de registratie(s) hebt gevonden die u wilt verzenden, moet u de registratie(s) selecteren door het selectievakje aan het begin van de rij in de overzichtstabel aan te vinken.

Vervolgens moet u op de knop "Acties" rechtsboven in de overzichtstabel drukken.

Twee opties zijn nu beschikbaar: "Registraties verzenden" en "Registraties verwijderen". Druk nu op "Registraties verzenden".

Als u de indiening bevestigt, kunt u de inhoud van de registratie(s) niet meer wijzigen. Verzonden registraties kunnen ook niet meer worden gewist.

De verzonden registratie blijft in de overzichtstabel, maar de status ervan is gewijzigd van "Open" in "Verzonden".

Als u alleen "open" registraties wilt zien, kunt u het filter op het item "Status" in de overzichtstabel aanpassen.

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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!

Adelaide.DAmore do, 03/30/2023 - 16:15

Een "Hartkleppen" "Follow-up" registratie verzenden

Een "Follow-up" registratie kan aan het einde van het creatieproces worden verzonden met behulp van het onderzoeksformulier (zie: Een "Hartkleppen" "Follow-up" registratie creëren).

Om een "Follow-up" registratie te verzenden voor het studieproject Hartkleppen via de overzichtstabel, selecteer "Follow-up" in het donkerblauwe linkermenu.

Als u de registratie(s) hebt gevonden die u wilt verzenden, moet u de registratie(s) selecteren door het selectievakje aan het begin van de rij in de overzichtstabel aan te vinken.

Vervolgens moet u op de knop "Acties" rechtsboven in de overzichtstabel drukken.

Twee opties zijn nu beschikbaar: "Registraties verzenden" en "Registraties verwijderen". Druk nu op "Registraties verzenden".

Als u de indiening bevestigt, kunt u de inhoud van de registratie(s) niet meer wijzigen. Verzonden registraties kunnen ook niet meer worden gewist.

De verzonden registratie blijft in de overzichtstabel, maar de status ervan is gewijzigd van "Open" in "Verzonden".

Als u alleen "open" registraties wilt zien, kunt u het filter op het item "Status" in de overzichtstabel aanpassen.

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 verzoek aan (type: verzoek om informatie) via ons portaal (https://sciensano.service-now.com/sp) 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!

Adelaide.DAmore do, 03/30/2023 - 16:11

Send a correction registration

Suppose you want to send a correction to a submitted registration. In that case you need to navigate in the dark blue left menu to the study program and next to the study project concerned. Then, select the respective part.

Important: A correction registration can only be added, if the status of the registration is submitted.

A correction registration can be added in two ways:

via the overview table;
via the preview page of a registration.

Send a correction via the Overview table

When the registration was submitted, the correction registration can be added via the overview table. This table will appear in the main part of your screen, when selecting a version of a study section. It contains, among others, the following items: Registration ID, Progress, Author, Co-author, Unique ID, Business Key, Registration Code, National Registry ID of the patient…

Use the filters in the table header to find the registrations that need a correction. For example, you can use the "Status" (set to "Sent") filter to get only submitted registrations.

Then, you must select the "Action" button at the top right of the overview table.

Three options are displayed: "Submit", "Delete" and "Add correction", but only the option "Add correction" is available for submitted registrations. Now select "Add selection".

After you have selected "Add correction", a pop-up window will appear asking you to confirm the action of adding a correction registration for the selected registration. If you are sure of this action, click on "Confirm". If not, click on "Cancel".

If you confirm, you will be redirected to the correction registration form.

The correction DCD only contains:

Business key of original registration,
The name of Data Collection,
The field or variable which is wrong,
The correction value,
Comment field.

Some fields are automatically filled with values of the original registration, e.g "Data collection " and "Business_KEY" .

The number of fields to correct in the same correction registration is limited to three. You can add another field to correct by clicking on "Add another".

When you finish filling the correction registration, you can add a comment and send the correction by clicking on the "Submit" button.

Send a correction via the Preview page

We can also add a correction form in the preview page of a registration. Therefore, open the overview table and click on the registration you want to correct. Now, you will be redirected to the preview page.

Click on the "Add correction" button to add a correction for current registration.

Follow same steps described in previous section (See "Send a correction via the Overview table")

Preview a correction registration

The correction form is a generic form available in the left dark blue menu for all projects and DCDs.

If you want to preview "correction registrations" already submitted, you navigate to the study program Correction form and then to the study project Correction form. Finally, you select the last version of "Correction form" in the dark blue left menu.

All correction registrations (of different projects) will be displayed. You can use the filters in the table header to find a specific registration.

If you want to preview a correction registration, you need to click on the desired registration in the overview table. You will now be redirected to the preview page.

Bart.Servaes Mon, 04/03/2023 - 14:59

Registration statuses 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 ma, 04/03/2023 - 15:02

Technische handleiding van de applicatie HD4DP v2

This information is only available in English. For linguistic coherence within the project navigation the titles of the respective components have been translated in NL and FR. Please select the EN language button in the top-right corner of your screen, when you are still in the NL or FR environment.

Bart.Servaes di, 04/04/2023 - 12:24

Technische gebruikersrollen in HD4DP v2

Bart.Servaes do, 03/30/2023 - 16:26

Installatie van HD4DP v2

Bart.Servaes di, 04/04/2023 - 12:30

Instructies voor de HD4DP v2 infrastructuur

Bart.Servaes di, 04/04/2023 - 12:42

Informatieblad HD4DP v2 Infrastructuur

Bart.Servaes do, 03/30/2023 - 16:39

HD4DP v2 S2S API

Bart.Servaes do, 03/30/2023 - 16:43

S2S API voor Hartkleppen Implantatie

Bart.Servaes do, 03/30/2023 - 17:19

S2S API voor Hartkleppen Follow-up

Bart.Servaes do, 03/30/2023 - 17:24

HD4DP v2 CSV Upload

Bart.Servaes do, 03/30/2023 - 17:24

CSV Upload voor Hartkleppen Implantatie

Bart.Servaes do, 03/30/2023 - 17:25

CSV Upload voor Hartkleppen Follow-up

Bart.Servaes do, 03/30/2023 - 17:25

HD4DP v2 MyCareNet

Bart.Servaes do, 03/30/2023 - 17:25

MyCareNet XML Export voor hartkleppen

Bart.Servaes do, 03/30/2023 - 17:26

MyCareNet XML Export voor Hartkleppen Implantatie

Bart.Servaes do, 03/30/2023 - 16:52

MyCareNet XML Export voor Hartkleppen Follow-up

Bart.Servaes do, 03/30/2023 - 17:26

MyCareNet integratie in HD4DP v2

Bart.Servaes do, 03/30/2023 - 17:28

Hartkleppen data ophalen uit het local datawarehouse (LocalDWH) van HD4DP v2

Bart.Servaes do, 04/13/2023 - 12:36

HD4DP v2 Online Acceptance Environment

Introduction

To support development and validation of data transfers using S2S API or CSV upload, a central Online Acceptance Environment is available for the IT services or IT partners of data providers. It is meant to replace the locally installed acceptance environments at the side of the data providers. With the Online Acceptance Environment the three types of data transfer can be tested and validated: data transfer via an API platform, via an SFTP client and via manual input in the study form.

In order to keep the acceptance environment light, it is redeployed once a week, deleting all data that were entered for testing. The data are stored locally and will not be sent to Healthdata.be infrastructure. The testing is limited to the upload to the HD4DP v2 application.

Application URLs and port

Front-End Application URL: https://hd4dp.acceptance.healthdata.be
SFTP URL: sftp.acceptance.healthdata.be and port 2220
S2S API: https://hd4dp.acceptance.healthdata.be/proxy/api/dcd/payload/submit?organization-id=00&dcd-id=00&version=1

Navigate to and access the Online Acceptance Environment

The Online Acceptance Environment can be found on https://hd4dp.acceptance.healthdata.be, which is a publically accessible URL.

On the homepage you are requested to select your organization from the drop-down list in order to proceed.

Since the list of organizations to choose from is limited, you might not find your organization in it. In that case we advise you to request your credentials through our service portal at https://sciensano.service-now.com/sp via the Request something tab and subsequently the Request for Information box.

When requesting an account for this acceptance environment you will receive 3 types of credentials:
⦁ credentials to log in to the front end of the online acceptance environment
⦁ credentials to use the API (-> authorization tab in Postman)
⦁ credentials for the SFTP server you use to test the CSV Upload

Once logged in, the layout looks very familiar: to the left you will find the navigation panel with all running projects and projects that have passed the user acceptance testing (UAT) phase. Note that the list of projects featuring in our Online Acceptance Environment is not filtered out for the organization you have selected.

The data transfer methods

As mentioned above, the Online Acceptance Environment enables the testing of the uploads for the following three types of data transfer. They are described in order of preference underneath:

Data transfer via an API platform

The data are extracted directly from the EPD systems and sent to HD4DP v2 local using S2S API before they are sent to healthdata.be. This transfer method requires the use of an API development platform, such as Postman (freely available).

The endpoint (URL) to send your payload to for testing is

https://hd4dp.acceptance.healthdata.be/proxy/api/dcd/payload/submit

This endpoint is to be completed with some parameters, such as the ID of an organization, the ID of a dcd, the version number:

https://hd4dp.acceptance.healthdata.be/proxy/api/dcd/payload/submit?organization-id=6&dcd-id=18&Version=1

Click on the Send button to post the payload. A succesful submission is indicated with the status message “202 Accepted”. This can also be checked visually in the front end of the Online Acceptance Environment.

The field Data source in the top selection bar indicates whether the data were transferred via S2S API, CSV Upload or manually with HD4DP.

In the production environment records sent through API are sent directly to the healthdata.be infrastructure (status “Submitted” in the Progress field).

Next to posting payloads (POST) you can also retrieve information (GET). Examples of such "calls":

The call https://hd4dp.acceptance.healthdata.be/proxy/api/organization (see below) will return an organization id:

The call https://hd4dp.acceptance.healthdata.be/proxy/api/dcd/menu/structure?organization-id=6 (see below) will return the menu structure with all projects your organization is registered for.

More information about the API data transfer can be found at https://docs.healthdata.be/documentation/hd4dp-v2-health-data-data-providers/hd4dp-v2-s2s-api

Data transfer via an SFTP client

The csv upload is the second type of data transfer. The data are transferred to an SFTP server and subsequently picked up by the healthdata.be system. This transfer method requires the use of an SFTP client, such as WinSCP (freely available).

When logging in to WinSCP, you will need to navigate to the correct csv folder : csv/<project>/<dcd>. Here you need to drag and drop the csv you want to upload from the left panel to the right panel. The CSV file will now be picked up by the polling system of the CSV Uploader, which checks for new CSV files every minute.

The folders Archive and Result will only be created after the first CSV file has been uploaded for testing.

The Result folder shows a log file containing CSV Upload reports. The status Error Count shows technical errors such as incorrect name, code …

CSV files that were uploaded in Architecure 1 can be reused in Architecture 2. Prerequisite for this is the addition of necessary fields that are typical for Architecture 2, e.g.:

Author Group (TX_AUTHOR_GR)
Author (TX_AUTHOR)
Coauthor (TX_COAUTHOR).

To further facilitate the process of reusing CSV files a mapping table with old and new CSV names is provided.

Next to adding fields, you can also leave out fields, which is indicated in the log file reports as a warning.

Once again the back-end process can be checked in the study forms on the front-end interface. You want to refresh the window to update to the newest status.

More information about the CSV data transfer can be found at https://docs.healthdata.be/documentation/hd4dp-v2-health-data-data-providers/hd4dp-v2-csv-upload.

Manual input in the study form

The third data transfer method is the form entry, carried out manually. For this you can use a common browser such as Google Chrome. This method can also be used to validate data sent via S2S API or CSV Upload.

Bart.Servaes Thu, 05/25/2023 - 17:41

Requesting access

A request for access to the online acceptance environment will be made available in the Entity Access Management tool available via eam.healthdata.be. See also https://docs.healthdata.be/EAM

This feature is foreseen to be added to the EAM portal during the summer of 2023. In the meantime or when the EAM portal should be unavailable, you can use the service portal to request access to the online acceptance environment by creating an incident and clearly mentioning you are an IT Department or IT partner of a data provider requesting access to the online acceptance environment.

More information on how to create an incident in the service portal is available on https://docs.healthdata.be/documentation/hd4dp-v2-health-data-data-providers/how-report-incident

You will receive 3 types of credentials:

Credentials for the HD4DP2 web form application.
Credentials for the API data transfer.
Credentials for the SFTP server to upload CSV files.

Bart.Servaes Thu, 05/25/2023 - 17:41

MongoDb Postgres Backup Restore & Retention

To make sure the data is persistent on both Hd side and DP side the backup plan was confirmed and developed and tested as well, the postgres and the Mongodb will be taken the whole backup on the daily basis, this will be taken care of the timer-service that has been recently introduced.

Last 30 days Backup will be kept in the same server share or in the local path, to enable the backup we have introduced the new ansible role called “mongo-postgres-backup”, and to invoke the backup option the following variables needs to be defined on the “Host_var” file on hd-inventory to the specific deployment.

Enabling the backup part on the target server: As soon as the ansible role added to the respective playbook and the above backup type added to the hd-inventory host vars to the main/master branch, this can be enabled automatically on the hd-updater daily run or manually triggering the hd-updater on the target side server.

When DP do not have the external share, then it’s better to keep the backup of the postgres-mongodb dumps, on different directory on the same server. To enable this backup type, we must add the below variable on to the respective host-vars in the hd-inventory.

backup_mount_type: "VmBackup"

----Default backup path is "/hd4dp-backup"

2. When DP do not have both external share and Vm backup , then it’s better to keep backup of the postgres-mongodb dumps, on different directory on the same server. To enable this backup type, we have to add the below variable on to the respective host-vars in the hd-inventory.

backup_mount_type : "local"

local_mount_path : /tmpBackup

3. When DP have External share (samba) then the below variable needs to be added to the respective hd-inventory host_var file.

backup_mount_type: "samba"

backup_mount_type: “samba”

samba_bkup_username: “user_name”

samba_bkup_domain: “example.com”

4. When DP provides External share (nfs) then the below variable needs to be added to the respective hd-inventory host_var file.

backup_mount_type: "nfs"

nfs_bkup_src: "0.0.0.0:/nfs/mount-share"

----Default backup path is "/hd4dp-backup"

Restore:

AS of the agreed approach is to restore the backup-dump manually by using the retention-script (restore_mongodb.sh & restore_postgresdb.sh) it can be found on the target server “/opt/hd-all/hd-backup”, by default it will restore the latest backup but if we wish to restore the particular date back this can be given as a input parameter refer below.

Restore Script Path on the target serever:

/opt/hd-all/hd-backup

Mongo Restore Input param:

"Provide bkp file with full path name for restore e.g. ${local_mount_path}/hd4dp-backup/mongodbBackup/mongo-20220510_2004.tar.gz" & ) to the script.

Mongo restore script:

restore_mongodb.sh

Postrges restore input Param:

"Provide bkp file with fullpath name for pg_wal restore e.g. ${local_mount_path}/hd4dp-backup/postgresBackup/pg_wal_latest.tar.gz"

“Provide bkp file with fullpath name for pg_wal restore e.g. {local_mount_path}/hd4dp-backup/postgresBackup/base_latest.tar.gz

Postgres restore script:

restore_postgresdb.sh

Note:

The postgres backup service timer will be scheduled by 15:00 aprox, the Mongodb backup service timer will be scheduled by 22:00, backup retention will perform few basic checks ex it will check if the space is sufficient to store the current day backup.

Bart.Servaes Thu, 05/25/2023 - 17:41

Apache Superset

The person with the login can see all the data stored in the database. This means the personal data of the patient is VISIBLE to that user.

Superset

Sciensano uses Apache Superset to provide the Data provider with a user-friendly UI for data exploration and visualization from the Local DWH database. Superset allows the user to export data into a CSV, and create their own queries, …

Prerequirements

URL: https://superset.<domain> or http://<ip>:3030 is available. If this is not the case, your IT department needs to open the port or add the domain to the DNS server.

Username/Password: Our Servicedesk will forward, via a secure link, the username and password.

Login

Superset is available on the local installation via the URL: https://superset.<domain> or via http://<ip>:3030.

Use the credentials provided by the servicedesk of Healthdata.

Home page

The first time you login to the application, an empty home folder will be shown. The more you use the application, the more tiles will be shown in your home dashoard. You see multiple subcategories like Favorite, Mine and Examples.

Favorite will show all the Dashboards, Charts or Queries you marked as a favorite.

Mine will show all the Dashboards, Charts or Queries you have created.

Examples leave it as is. You don't need to use this.

Dashboards

Dashboards are created under the dashboard menu (on the top menu). A list of shared and personal dashboard will be visible.

Default the dashboard Local DWH will be visible at first login.

Local DWH

The local DWH dashboard will provide you a dashboard with some information on how particular features are working inside Superset and an option to show registrations based on the data collection name.

Remark: if you are not able to see the Filters column, click on the "wifi" icon or arrow on the left side of your screen.

Information page of the Local DWH dashboard

Under the Data tab you will see 3 tables that are empty. With the filter (on the left side), you need to select what you want to see. You can select more Data collection at once and click on Apply FILTERS (bottom of the page).

After applying the filter, the data is now visible.

You can easily download each table by clicking on the 3 dots next to the filter icon in table:

A zip file will be created with the data provided in the table.

Remark: only the last 10000 records will be visible in the table. Downloading a higher amount of data can be done via the SQL Lab editor.

SQL Editor

The SQL Editor allows you to run your own query on the database.

Go to SQL Lab > SQL editor

On the left side you can choose the database, the schema and the table.

Database Local DWH is the database you want to use. Use the Public schema and select one of the tables. You can choose between local_dwhmessage, local_dwhmessage_key_value and local_dwhmessage_key_value_plus.

Example of the local_dwhmessage with a preview of the data

The preview of the data is something you are not able to export. You still need to write your own query before you can export data from the database. You can limit the number of records (with a max of 100 000 records at once). After running your query, the button DOWNLOAD TO CSV will become available.

Remark: you can save your query by clicking on SAVE AS. With a proper name and description you can easily find the query back in you home or under SQL LAB > Saved Queries.

Query examples

With the following information, you will be able to link multiple tables with eachother.

local_dwhmessage_key_value column msg_document_id refer to the document_id of local_dwhmessage.

local_dwhmessage_key_value_plus column key_value_id refer to the id of local_dwhmessage_key_value.

Query 1: Get all registrations from Orthopride Knee resection from the last 15 days.

SELECT * from local_dwhmessage WHERE data_collection_name = 'OP_KNEE_RESEC' and created_on > current_date - interval '15' day;

Query 2: Get all registrations and key value from Orthopride Knee resection.

SELECT * from local_dwhmessage as ldm left join local_dwhmessage_key_value as ldmkv on ldmkv.msg_document_id = ldm.document_id WHERE data_collection_name = 'OP_KNEE_RESEC';

Query 3: Get all registrations, key value and key value plus from Orthopride Knee resection.

SELECT * from local_dwhmessage as ldm left join local_dwhmessage_key_value as ldmkv on ldmkv.msg_document_id = ldm.document_id left join local_dwhmessage_key_value_plus as ldmkvp on ldmkvp.key_value_id = ldmkv.id WHERE data_collection_name = 'OP_KNEE_RESEC';

Bart.Servaes Thu, 05/25/2023 - 17:42