Suchen
Geben Sie mindestens zwei Zeichen ohne persönliche Daten ein.

    BibliothekArtikel und FAQs Ihr ProjektFordern Sie ein Angebot an
    SpracheDE ▾
    Praktische Anleitungen

    Veröffentlichen Sie verständliche, dokumentierte Open Data

    Herunterladbare Daten sind noch keine verständlichen Daten. Ein Wiederverwender muss wissen, wer es produziert hat, was es abdeckt, was er ausschließt und wie er seine Felder interpretiert.

    Siehe die Methode

    Illustration — Veröffentlichen Sie verständliche, dokumentierte Open Data
    KI-generierte Illustration

    Provenienz und Umfang schaffen

    Beschreiben Sie den Produzenten, das Sammelverfahren, den Zeitraum und die geografische oder thematische Abdeckung. Unterscheiden Sie Extraktions-, Aktualisierungs- und Messdaten. Eine heute veröffentlichte Datei kann eine frühere Messung beschreiben. Die Veröffentlichung ändert ihr Bezugsjahr nicht.

    Geben Sie fehlende Bereiche und ungefähre Werte an, in denen die Quelle sie identifiziert. Füllen Sie keine Lücke mit einer unbekannten Schätzung. Die Dokumentations-Leitfaden von data.gouv.fr richten sich an den Produktionskontext, die Struktur und mögliche Inkonsistenzen.

    Geben Sie ein Wörterbuch und ein Beispiel an

    Erklären Sie jedes Feld, jede Einheit, jeden Typ, jeden fehlenden Wert und Referenzcode. Geben Sie ein kleines lesbares Beispiel an, das mit dem vollständigen Datensatz übereinstimmt. Wobei Bezeichner Tabellen, Dokumentbeziehungen und möglicherweise nicht übereinstimmende Zeilen verbinden.

    Entitäten von ihren Etiketten unterscheiden. Eine Gemeinde kann mehrere Postleitzahlen und ein Produkt mehrere Varianten haben. Die Dokumentation sollte helfen, irreführende Aggregation oder Deduplizierung zu verhindern, die eine nützliche Beziehung entfernt.

    Bei Geodaten Referenzsystem und Koordinatenreihenfolge dokumentieren, nicht nur das Format. RFC 7946 definiert GeoJSON mit WGS 84 und Dezimalgrad; die ersten beiden Positionswerte sind Längen- und Breitengrad. Im fiktiven Beispiel darf Point [2.35,48.86] nicht zu [48.86,2.35] werden. Beide Arrays sind lesbares JSON mit plausiblen Werten; reine Syntaxprüfung erkennt die Vertauschung nicht.

    Ein nicht lokalisiertes Objekt von einem bekannten Punkt unterscheiden. Eine nicht lokalisierte GeoJSON Feature darf geometry: null haben; das ist weder ein Point mit null-Koordinaten noch der Ersatz unbekannter Daten durch die reale Position [0,0]. Auch die Bedeutung beschreiben: beobachteter Eingang, geokodierte Adresse oder berechneter Mittelpunkt, jeweils mit Herkunft und Datum. Zusätzliche Dezimalstellen machen eine Schätzung nicht sicherer.

    Scrollen Sie die Tabelle horizontal, um alle Spalten zu lesen. Mit der Tastatur fokussieren Sie den Tabellenbereich und verwenden die Pfeiltasten.

    Fiktive Übung: Bedeutung über lesbares JSON hinaus prüfen
    FallBedeutungSinnvolle Prüfung
    Point · coordinates: [2.35,48.86]Längengrad 2.35; Breitengrad 48.86Mit benannten Quellfeldern vergleichen
    Point · coordinates: [48.86,2.35]Plausible Zahlen, im Beispiel vertauschtBedeutung prüfen; Syntax reicht nicht
    Feature · geometry: nullNicht lokalisiertes Objekt; StrukturfragmentFehlenden Wert dokumentieren, keinen Punkt erfinden
    Position [0,0]Existierende Koordinaten, kein FehlenNicht automatisch für unbekannte Werte einsetzen

    Überprüfen Sie die Veröffentlichung und Wiederverwendung

    Identifizieren Sie die Quellenwiederverwendungsbedingungen und die Attributionsinformationen, um sie aufzubewahren. Lassen Sie die entsprechenden Prüfer die Veröffentlichungsrechte und mögliche personenbezogene Daten vor der Veröffentlichung beurteilen. Eine an anderer Stelle sichtbare Adresse macht nicht automatisch jede Kopie für die Veröffentlichung geeignet.

    Testen Sie Downloads ohne interne Tools oder spezielle Konten, wenn der öffentliche Zugriff versprochen wird. Überprüfen Sie Format, Codierung und Integrität. Geben Sie eine Versionsreferenz oder eine Prüfsumme an, damit Feedback an die heruntergeladene Datei gebunden werden kann.

    Versionen und Korrekturen pflegen

    Wählen Sie eine realistische Überprüfungshäufigkeit und einen Kontakt für Probleme. Beschreiben Sie hinzugefügte, entfernte oder neu definierte Felder, wenn sich Schemas ändern. Unterscheiden Sie Korrekturen von neuen Messungen, um falsche Änderungen in einer Zeitreihe zu vermeiden.

    Bewahren Sie nützliche Versionen und Notizen mit einer klaren Ersatzrichtlinie auf. Die Veröffentlichungsdokumentation sollte eine andere Person die Extraktion reproduzieren oder ihre Grenzen verstehen. Ein Download-Zähler ersetzt nicht die Dokumentationsqualität.

    Primärdokumentation: data.gouv.fr : Bien documenter un jeu de données.

    Unterscheiden Sie Datensatz und Distributionen. Eine CSV- und JSON-Datei können denselben Datensatz in zwei Formaten darstellen; zählen Sie sie nicht automatisch als unabhängige Messungen. DCAT beschreibt eine Distribution als konkrete Darstellung eines Datensatzes. Vergleichen Sie dennoch Abdeckung, Präzision, Felder und Version: Zwei Distributionen sind nicht unbedingt verlustfrei gleichwertig.

    Ergänzen Sie Versionskennung und Änderungshistorie. Eine Adresse für die „neueste Version“ kann stabil bleiben, doch die tatsächlich verwendete Version muss identifizierbar sein. Trennen Sie auch Korrektur und neue Beobachtung: Die Messung eines neuen Monats korrigiert nicht allein dadurch den vorherigen. Erläutern Sie den Zusammenhang zwischen Versionen und Reihen vor einem Zahlenvergleich.

    Scrollen Sie die Tabelle horizontal, um alle Spalten zu lesen. Mit der Tastatur fokussieren Sie den Tabellenbereich und verwenden die Pfeiltasten.

    Datenveröffentlichung: Gegenstand, Format und Revision kennzeichnen
    DokumentationselementWas es unterscheidetNützliche Prüfung
    DatensatzBeschriebenes Thema, Umfang und Beobachtungen.Seine Identität ist unabhängig vom Dateiformat verständlich.
    CSV- oder JSON-DistributionEine konkrete Darstellung des Datensatzes.Felder, Präzision und Abdeckung vor einer Gleichwertigkeitsannahme vergleichen.
    Identifizierte VersionEinen bestimmten Zustand und seine Änderungshistorie.Zitierte Version wiederfinden, auch wenn eine aktuelle Adresse aktualisiert wurde.
    Korrektur oder neuer ZeitraumÜberarbeiteten Wert oder andere Beobachtung.Einen neuen Monat nicht als automatische Korrektur des vorherigen darstellen.

    Inhalt aktualisiert

    Dokumentierte Grundlagen zu diesem Thema

    Dokumentierte Grundlagen zu diesem Thema
    ReferenzWert oder SyntaxGeltungsbereich
    RFC 4180 · CSV
    text/csv · "a,b"Felder mit Kommas, Anführungszeichen oder Zeilenumbrüchen werden eingefasst; innere Anführungszeichen verdoppelt.
    RFC 8259 · JSON
    application/json · UTF-8Standard-JSON erlaubt weder Kommentare noch abschließende Kommas; Zeichenfolgen nutzen doppelte Anführungszeichen.

    Die Daten geben die Prüfung der Quellen an. Diese Hinweise sind weder ein Website-Audit noch eine umfassende Konformitätserklärung.

    Funktionale Validierungsmatrix zur Projektanpassung

    Diese vorgeschlagenen Kontrollen verwenden fiktive Fälle. Entscheiden Sie, welches Verhalten mit dem Team zu erwarten ist, schreiben Sie das Ergebnis auf und weisen Sie vor der Veröffentlichung ungelöste Abweichungen zu.

    Scrollen Sie die Tabelle horizontal, um alle Spalten zu lesen. Mit der Tastatur fokussieren Sie den Tabellenbereich und verwenden die Pfeiltasten.

    Testfälle, erwartete Ergebnisse und nützliche Beweise
    FallErwartetes ErgebnisBeweis zu behalten
    Beworbener öffentlicher DownloadEine externe Person erhält eine lesbare Datei ohne interne Tools.Adresse, Format, Größe und erfolgreiche Eröffnung in einem gemeinsamen Leser.
    Prüffeld und EinheitDas Beispiel und die vollständige Datei verwenden dieselbe Definition.Wörterbuch, Stichprobe und Vergleich bekannter Werte über beide Darstellungen.
    Unbekannter und unübertroffener BezeichnerEinschränkungen bleiben sichtbar, ohne einen plausiblen Wert zu ersetzen.Betroffene Zeilen und dokumentierte Regeln zur Darstellung unbekannter oder nicht übereinstimmender Informationen.
    Veröffentlichte KorrekturEin Wiederverwender kann eine Korrektur von einer neuen Messung unterscheiden.Version, Änderungsbeschreibung und Referenzdaten, die mit der veröffentlichten Datei beibehalten werden.

    Häufig gestellte Fragen

    Welches Datum sollte einer Datei beiliegen?

    Gegebenenfalls Extraktion, letzte Änderung und abgedeckte Periode als separat benannte Daten anzeigen. Die Download-Zeit nicht automatisch als Referenzjahr einer Population oder einer anderen Messung angeben.

    Macht eine Lizenz allein Daten nutzbar?

    Es definiert Wiederverwendungsbedingungen, aber Felder, Einheiten, Kennungen, Abdeckung, Qualität und Versionen müssen ebenfalls erklärt werden. Eine andere Person sollte in der Lage sein, die Verwendung zu reproduzieren oder zumindest zu verstehen.