EHDS Studio: Metadaten des Datensatzes veröffentlichen
Diese Seite beschreibt die aktuellen Funktionen von EHDS Studio und den EHDS-Diensten. Sie stellt keine Aussage darüber dar, ob Ihre Organisation oder die Plattform die Verordnung (EU) 2025/327 erfüllt. Die Einhaltung der Verordnung ist eine rechtliche Prüfung; diese Seite informiert Sie über die vorhandenen technischen Komponenten, damit Sie diese Prüfung selbst vornehmen können.
EHDS Studio unterstützt Dateninhaber bei der Beschreibung, Überprüfung, Validierung und Veröffentlichung von Metadaten ihrer Datensätze im HealthDCAT-AP Release 6-Format, beim Export und bei der Bereitstellung eines Katalogs für die Öffentlichkeit. Der Zugriff auf die zugrundeliegenden Daten erfolgt über einen separaten Dienst (DAAMS), die organisationsübergreifende gemeinsame Nutzung über einen optionalen Datenbereichskonnektor.
Welcher Dienst macht was?
| Komponente | Was es tut | Quelle |
|---|---|---|
EHDS Studio (Web-App, Route /ehds) | Die Bildschirme. Sie haben keine eigenen Regeln. | tietai-frontend-service |
| EHDS service provider | HealthDCAT-AP-Katalog, Datensatzrevisionen und der Überprüfungsworkflow, Validierung, RDF- und Parquet-Export, Aufnahme aufbereiteter Daten, Audit-Ereignisse. | tietai-ehds-service-provider |
| DAAMS | Anträge auf Datenzugriff, Genehmigungen, grenzüberschreitende Anfragen an die Nationale Kontaktstelle (NCP), Beschwerden, Unterschriften. Dies ist die Seite der Stelle für den Zugriff auf Gesundheitsdaten (HDAB). | tietai-daams-service |
| Dataspace connector | IDS Dataspace Protocol 2025-1 Katalog, Vertragsverhandlung und -übertragung mit ODRL-Richtlinien und DCP-Identität. | tietai-dataspace |
Öffnen Sie EHDS Studio
Öffnen Sie EHDS Studio in der Seitenleiste. Sie benötigen read:ehds oder manage:ehds. Die Einträge in der Seitenleiste sind:
| Eintrag | Route | Bedürfnisse |
|---|---|---|
| Überblick | /ehds/dashboard | read:ehds oder manage:ehds |
| Datensatz veröffentlichen | /ehds/workflow | read:ehds oder manage:ehds |
| Meine Arbeit | /ehds/work | read:ehds oder manage:ehds |
| Datensätze | /ehds/datasets | read:ehds.datasets, read:ehds oder manage:ehds |
| Quellen | /ehds/data-sources | read:ehds.sources, read:ehds oder manage:ehds |
| Einrichtung & Verwaltung | /ehds/setup | manage:ehds |
| Öffentlicher Katalog | /ehds/catalogue | keine (öffentliche Seite) |
Seite Setup & Admin besteht aus acht Karten: Kataloge, Datenakteure (Herausgeber, Inhaber von Gesundheitsdaten und Stellen für den Zugang zu Gesundheitsdaten), Datensatzreihen, Vokabulare (schreibgeschützt), Verteilungen, Nachweise zur Einhaltung von Vorschriften, Exporte und Datenbereiche. Sie verfügt über keine eigenen Einstellungen.
Einen Datensatz veröffentlichen
Metadatenänderungen werden niemals direkt in einem veröffentlichten Datensatz bearbeitet. Jede eingereichte Änderung ist eine Revision – eine unveränderliche Momentaufnahme mit einem Inhalts-Hash. Revisionen durchlaufen eine vom Dienst selbst und nicht nur vom Bildschirm durchgeführte Überprüfung.
Die Seite Publish Dataset führt einen Datensatz durch sechs Phasen. Wählen Sie links einen Datensatz aus (Entwürfe werden zuerst angezeigt) oder wählen Sie Create dataset.
- Aufbereitete Daten. Wählen Sie eine konfigurierte Quelle aus und importieren Sie das vom Workflow-System vorbereitete Artefakt. Quelltypen sind S3, FHIR, Kanal und Upload.
- Verteilung. Ein veröffentlichter Datensatz muss mindestens eine Verteilung enthalten.
- Metadatenkatalog. Der Datensatz muss einem Katalog angehören, damit er abgerufen werden kann.
- Beschreiben und klassifizieren Sie die Daten. Verwenden Sie für die Kennzeichnung des Datensatzes ein kontrolliertes Vokabular. Die Platzhalterkategorie
OTHERallein gilt nicht als klassifiziert. - Metadaten der Version 6 prüfen. Zeigt den Bericht mit den Pflichtfeldern (
missingundwarnings). - Prüfen, genehmigen und veröffentlichen. Die Überarbeitung einreichen, genehmigen lassen und dann veröffentlichen.
Die Überprüfungsmaßnahmen und wer sie durchführen darf (durchgesetzt vom Dienst):
| Aktion | Zulässige Rollen | Regel |
|---|---|---|
| Zur Überprüfung einreichen | metadata_steward, data_steward, tenant_admin, admin | Aus dem Entwurfs- oder Änderungsantragsformular. |
| Änderungen anfordern | metadata_reviewer, tenant_admin, admin | Eine Begründung ist erforderlich. Nur die letzte Überarbeitung kann berücksichtigt werden. |
| Genehmigen | metadata_reviewer, tenant_admin, admin | Der Ersteller einer Revision kann seine eigene Revision nicht genehmigen. |
| Veröffentlichen | publishing_officer, tenant_admin, admin | Siehe unten. |
| Zurückziehen | publishing_officer, tenant_admin, admin | Nur veröffentlichte Datensätze; eine ausstehende Überarbeitung muss zuerst abgeschlossen werden. |
Eine Veröffentlichung ist nur dann erfolgreich, wenn alle diese Bedingungen erfüllt sind:
- Die neueste Revision ist APPROVED;
- Für den Datensatz wurde eine erfolgreiche offizielle HealthDCAT-AP Release 6-Validierung für genau diese Revision und seinen serialisierten RDF-Graphen aufgezeichnet (der Dienst vergleicht Inhalts-Hashes, daher bedeutet eine Bearbeitung nach der Validierung eine erneute Validierung);
- Die Person, die die Veröffentlichung vornimmt, ist nicht die Person, die diese Änderung genehmigt hat.
Andernfalls antwortet der Dienst mit einem Konflikt, beispielsweise latest revision and graph require a successful official HealthDCAT-AP Release 6 validation oder approving reviewer cannot publish the same revision. Durch die Veröffentlichung einer neuen Revision wird die zuvor veröffentlichte Revision ersetzt.
Um die offizielle Validierung durchzuführen, öffnen Sie den Datensatz und validieren Sie ihn (die Ergebnisse für jeden Datensatz werden auf Seite Compliance evidence angezeigt). Falls der Validierungsdienst nicht erreichbar ist, schlägt die Anfrage mit dem official HealthDCAT-AP validator unavailable fehl. Beheben Sie das Problem mit dem Validierungsdienst und umgehen Sie es nicht.
Was die Metadatenregeln prüfen
Der Dienst zielt auf HealthDCAT-AP Release 6 ab und validiert anhand des offiziellen Profils, das der Zugriffsebene (public, restricted oder non-public) des Datensatzes entspricht. Zusätzlich wird eine schnellere, integrierte Regelprüfung ausgeführt:
| Regel | Schwere |
|---|---|
| Kennung, Titel, Beschreibung, gültige Zugriffsrechte, Herausgeber vorhanden | Fehler |
applicable_legislation beinhaltet http://data.europa.eu/eli/reg/2025/327/oj | Fehler |
| Mindestens eine Gesundheitskategorie | Fehler |
NON_PUBLIC Datensatznamen einer Health Data Access Body (hdab_id) | Fehler |
| Der Datensatz mit personenbezogenen Daten gibt mindestens eine Rechtsgrundlage an. | Fehler |
| Mindestens eine Verteilung | Fehler |
| Der zeitliche Erfassungszeitraum beginnt nicht nach dem Ende; Altersspanne und Anzahl der Datensätze sind plausibel. | Fehler |
Jeder Eintrag conforms_to stellt eine gültige URI dar. | Fehler |
| Eine Gesundheitskategorie außerhalb der untenstehenden Liste | Warnung |
Zugriffsebenen
Jeder Datensatz hat einen Zugriffswert. Im öffentlichen Katalog werden sie wie abgebildet angezeigt.
| Wert | Öffentliches Katalogetikett | Bedeutung |
|---|---|---|
PUBLIC | Offener Zugang | Der Datensatz ist unter den veröffentlichten Bedingungen verfügbar. |
RESTRICTED | Beschränkter Zugriff | Metadaten sind öffentlich; der Zugriff erfordert ein genehmigtes Verfahren. |
NON_PUBLIC | Nicht öffentlich zugänglich | Metadaten sind öffentlich; die Daten selbst nicht. Benötigt eine benannte HDAB. |
Gesundheitsdatenkategorien
Das kontrollierte Vokabular enthält 18 Kategorien: EHR, CLAIMS, PRESCRIPTIONS, DISPENSATIONS, REGISTRIES, BIOBANKS, SURVEYS, CLINICAL_TRIALS, GENOMICS, PROTEOMICS, METABOLOMICS, MEDICAL_DEVICES, LIFESTYLE, ENVIRONMENTAL, PUBLIC_HEALTH, REIMBURSEMENT, SOCIAL_DATA, OTHER Mindestens eine Kategorie ist obligatorisch. Das Vokabular ist im Code als „EHDS Artikel 51 Gesundheitsdatenkategorien“ bezeichnet; überprüfen Sie die Kategorienliste anhand des endgültigen Verordnungstextes, bevor Sie sich darauf verlassen.
Rechtsgrundlagen
Die Rechtsgrundlagen sind CONSENT, CONTRACT, LEGAL_OBLIGATION, VITAL_INTERESTS, PUBLIC_TASK (Art. 6 Abs. 1 Buchst. e), PUBLIC_INTEREST (Art. 9 Abs. 2 Buchst. i), LEGITIMATE_INTERESTS und SCIENTIFIC_RESEARCH (Art. 9 Abs. 2 Buchst. j). Der Dienst speichert die Auswahl im Datensatz und verlangt eine solche Angabe, wenn der Datensatz personenbezogene Daten enthält. Er prüft nicht, ob die Rechtsgrundlage für Ihren Fall rechtmäßig ist.
Kodierungssysteme
Das Vokabular anerkannter URIs von Kodierungssystemen umfasst ICD-10, ICD-11, SNOMED CT, LOINC, ATC, ICPC-2, NDC, CPT, ICD-O-3, HPO, Orphanet und RxNorm. Es handelt sich um eine Nachschlageliste für Metadaten, nicht um eine Validierung der kodierten Daten.
Metadaten exportieren
Einzelne Datensätze: GET /export/rdf/{id} gibt einen Datensatz als Turtle, JSON-LD oder RDF/XML (von ?format= oder Accept) zurück; GET /export/parquet/{id} gibt Parquet zurück. Katalogexporte erfordern eine Authentifizierung.
Die Seite Exports exportiert Datensätze, Kataloge oder Verteilungen im Batch-Verfahren auf den vom Server konfigurierten Speicher (lokale Festplatte, AWS S3, Google Cloud Storage oder Azure Blob). Der Dienst unterstützt die folgenden Formate: parquet, turtle, json-ld, rdf-xml. Auf der Seite werden auch Schaltflächen für CSV und JSON angezeigt; diese werden jedoch vom Dienst nicht als unterstützt aufgeführt.
Es werden außerdem ein einfacher SPARQL-Abfrageendpunkt (/sparql, eine Teilmenge von SPARQL) und ein Harvest-Endpunkt (GET /healthdcat-ap/catalogue, nur veröffentlichte Datensätze, keine Anmeldung erforderlich) bereitgestellt. Der Dienst kann HealthDCAT-AP-RDF importieren und Daten aus einem CKAN-Katalog einbinden.
Öffentlicher Katalog
/ehds/catalogue erfordert keine Anmeldung. Es durchsucht veröffentlichte. Datensätze anhand von Text, Zugriffsstatus (Alle Zugriffsbedingungen, Offener Zugriff, Eingeschränkter Zugriff, Nicht öffentlich zugänglich), Gesundheitskategorie und geografischer Abdeckung und zeigt eine Datensatzseite unter /ehds/catalogue/<id> an. Der Hinweis auf der Seite verdeutlicht dies: Die Katalogsuche gewährt niemals Zugriff.
Bei einem eingeschränkten Datensatz verlinkt die Schaltfläche Open access portal zum DAAMS-Portal, sofern dieses konfiguriert ist. Bei einem nicht zugänglichen Datensatz wird außerdem ein Dialogfeld EHDS data access application angezeigt (Antragsteller, Organisation, Zweck, angeforderte Daten, Rechtsgrundlage, Ethik). Dieses Dialogfeld sendet Daten an /public/catalogue/{id}/access-requests. Da kein Dienst in diesem Repository diesen Pfad unterstützt, ist das Dialogfeld erst nach erfolgreicher Verbindung nutzbar. Verwenden Sie stattdessen Request access auf der Datensatzseite in Studio.
Zugang zu nicht-öffentlichen Daten beantragen
In Studio verfügt die Seite eines nicht-öffentlichen Datensatzes über eine Schaltfläche Request access. Dort werden der wissenschaftliche Zweck (erforderlich), die Dauer in Monaten und ein Kennzeichen für grenzüberschreitende Nutzung abgefragt. Anschließend wird in DAAMS ein Entwurf für einen Antrag (Typ daa) erstellt, der bereits mit den Gesundheitskategorien des Datensatzes vorausgefüllt ist. Die Fertigstellung erfolgt im DAAMS-Portal.
Was DAAMS selbst über seine API-Routen bereitstellt:
- Applications: Erstellen, Aktualisieren, Anhänge, Zuweisen eines Beauftragten, Überprüfungen, Zeitplan, Team und Unterzeichnung der Datenverwendungsvereinbarung, Risikobewertung und Datenschutz-Folgenabschätzung. Status:
draft,submitted,initial_review,risk_assessment,pre_screening,processing,awaiting_info,decision_issued,appealed,withdrawn. Entscheidungsergebnis:approved,rejectedoderconditional. - Permits: Ausstellung nach Genehmigung eines Antrags, Annahme (Forschender), Widerruf, Aussetzung, Wiedereinsetzung, Verlängerungen, Änderungen, PDF und Ansicht der überprüfbaren Berechtigung. Status:
pending_acceptance,active,expired,revoked,suspended,pending_renewal. Für die öffentliche Genehmigungsliste ist keine Anmeldung erforderlich. - NCP: Grenzüberschreitende Anfragen und eine Länderliste. Appeals: Es existieren außerdem eIDAS-Signaturaufrufe, ein Hash-verkettetes Audit-Log und Routen für eine sichere Verarbeitungsumgebung.
Einige DAAMS-Pakete sind zwar geschrieben und getestet, aber nicht angebunden. Das Paket für die Ausschussprüfung (internal/committee) hat keinen Aufrufer im Dienst. Die Ausschussprüfung sollte nicht als funktionierende Funktion beschrieben werden.
Dataspace-Verträge
Die Karte Data spaces im Setup öffnet die Registerkarten Identität, Assets, Richtlinien, Verträge, Verhandlungen, Übertragungen und Einstellungen. Diese verwalten den optionalen Konnektor tietai-dataspace, der das IDS Dataspace Protocol 2025-1 (Katalog, Vertragsverhandlung, Übertragung), ODRL-Richtlinien und die DCP-Identität mit did:web verifizierbaren Präsentationen implementiert.
- Ein Asset ist ein Workflow oder ein Connect-Kanal.
- Eine Zugriffsrichtlinie legt fest, ob ein Produkt im Katalog eines Verbrauchers erscheint; eine Vertragsrichtlinie regelt die Vereinbarung.
- Verhandlungszustände:
OFFERED,AGREED,FINALIZED,TERMINATED. Übertragungszustände:STARTED,COMPLETED,TERMINATED. Übertragungen können per PULL oder PUSH erfolgen. - Richtlinienbeschränkungen können diese Angaben aus einer verifizierbaren Präsentation verwenden:
Membership,HealthDataAccess.purpose,DataAccess.level,headquarter_location,hdab_permit_id,legalBasis,gaiax_compliantund die aktuelle Zeit. Operatoren:eq,neq,isPartOf,gteq,lteq(die letzten beiden für Datums- und Zeitangaben).
DAAMS verfügt über eigene IDSA-Angebote und Vertragsrouten (/api/v1/idsa); diese sind von diesem Konnektor getrennt.
Prüfung
Der EHDS-Dienst protokolliert für jede authentifizierte Erstellung, Aktualisierung oder Löschung einen Prüfeintrag: Organisation, Akteur, HTTP-Methode, Route, Ressourcen-ID, Anforderungs-ID, Statuscode (SUCCEEDED oder FAILED, Client-IP-Adresse und User-Agent. Die Einträge werden mit GET /audit-events Rollen gelesen (auditor, tenant_admin, admin). Entscheidungen zu Revisionen werden als Anfügedatensätze gespeichert. Es handelt sich dabei um eigene Datensätze des Dienstes, nicht um FHIR- AuditEvent Ressourcen.
Bürger-Abmeldung: nicht funktionsfähig
Der Code enthält ein Opt-out-Modell für Bürger zur Sekundärnutzung (global oder zweckbezogen, wirksam fünf Werktage nach Erstellung, widerrufbar) und eine Datenbankmigration für eine Tabelle citizen_optouts Nichts davon ist miteinander verbunden:
- Der Opt-out-Dienst speichert Datensätze nur im Arbeitsspeicher, sodass diese beim Neustart verschwinden und nichts in die Tabelle geschrieben wird;
- DAAMS stellt keine Route
/citizen/opt-outbereit, obwohl das DAAMS-Portal eine Seite enthält, die eine solche Route aufruft. - Es findet keine Überprüfung einer Abmeldung statt, wenn Daten extrahiert oder ein Datensatz erstellt wird.
Sagen Sie den Bürgern nicht, dass sie sich über Tietai abmelden können, und verlassen Sie sich nicht darauf als Kontrollinstrument gemäß Artikel 71.
Nicht verfügbar
- Bürger-Opt-out (siehe oben).
- Erstellung einer internationalen Patientenzusammenfassung. In den EHDS-Diensten wurde kein IPS-Code gefunden.
- FHIR
AuditEventAusgabe für EHDS-Aktionen. - Ein für den Benutzer sichtbarer HDAB-Prüfbildschirm in EHDS Studio. Die Genehmigungsprüfung erfolgt in DAAMS.
- Der Anwendungsdialog für den Zugriff auf den öffentlichen Katalog (keine Bereitstellungsroute).
- Ausschussprüfung in DAAMS (Paket nicht verbunden).
Fehlerbehebung
| Symptom | Ursache und Lösung |
|---|---|
latest revision must be APPROVED before publication | Reichen Sie die Überarbeitung zunächst ein und genehmigen Sie sie. |
approving reviewer cannot publish the same revision | Frage eine andere publishing_officer. |
revision creator cannot approve their own revision | Fragen Sie einen anderen Rezensenten. |
requesting changes requires a reason | Füllen Sie Decision reason. |
official HealthDCAT-AP validator unavailable | Der SHACL-Validierungsdienst ist nicht verfügbar oder nicht konfiguriert. Stellen Sie ihn wieder her und führen Sie die Validierung erneut durch. |
| Validierung erfolgreich, Veröffentlichung weiterhin fehlgeschlagen. | Der Datensatz bzw. dessen Graph hat sich nach der Validierung geändert. Validieren Sie die neueste Version erneut. |
| Einrichtung & Administration fehlt | Sie benötigen manage:ehds. |
Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..