Distributionen
Überblick¶
Eine Distribution ist eine verfügbare Form des Datensatzes. Ein Datensatz kann beispielsweise gleichzeitig über eine API und als CSV-Datei verfügbar sein, was bedeutet, dass der Datensatz zwei verschiedene Distributionen aufweist. Es gibt keine Begrenzung für die Anzahl der Distributionen pro Datensatz, aber es sollte nicht mehr als eine Distribution mit demselben Inhalt und Dateiformat für einen Datensatz geben. Eine Distribution kann jedoch aus mehreren Dateien im gleichen Format bestehen, was sich besonders für Zeitreihen eignet die kontinuierlich aktualisiert werden.
Distribution erstellen¶
Um eine Distribution zu erstellen, gehen Sie zur Übersichtsseite des Datensatzes und klicken Sie auf die Schaltfläche "+" neben "Distributionen". Wählen Sie dann "Distribution erstellen".
Wenn bereits ein Datendienst mit einer Schicht vorhanden ist, den Sie zum Erstellen der Distribution verwenden möchten, wählen Sie stattdessen "Distribution aus Datendienst erstellen".
Als Nächstes können Sie auswählen, ob Sie einen Link (Webadresse) eingeben oder eine Datei hochladen möchten.
Datei hochladen¶
Um eine Datei hochzuladen, klicken Sie auf "Datei" und dann auf das Lupensymbol. Die maximale Dateigröße beträgt 24 MB. Wenn Ihre Datei größer ist, empfehlen wir, die Daten in mehrere Dateien aufzuteilen. Es kann Ausnahmen von dieser Größenbeschränkung geben, wenn Sie eine maßgeschneiderte EntryScape Catalog-Lösung haben.
Wenn Sie die empfohlenen und optionalen Felder aktivieren, können Sie die Distribution genauer beschreiben.
Im Folgenden werden einige der empfohlenen und optionalen Felder erläutert. Wenn Sie auf den Titel eines Eingabefeldes klicken, erhalten Sie auch eine Felderklärung mit einer kurzen Beschreibung der erwarteten Eingabe.
Empfohlene Felder¶
Titel: Der Name der Distribution. Um einen Titel in einer anderen Sprache hinzuzufügen, klicken Sie auf + Titel. Es wird eine neue Zeile mit Eingabefeldern angezeigt, in der Sie andere Sprachen auswählen können.
Beschreibung: Eine ausführlichere Beschreibung der Distribution.
Format: Beschreiben Sie das Format Ihrer Distribution. Sie können aus Listen wie "Allgemeine Medientypen" wie CSV und JSON oder "Geografische Medientypen" wie WMS oder TIFF wählen.
Verfügbarkeit: Die Verfügbarkeit gibt an, wie lange die Daten zugänglich sein werden. "Experimentell" bedeutet, dass die Daten kurzfristig verfügbar bleiben. "Stabil" bedeutet, dass die Daten langfristig verfügbar bleiben. "Temporär" bedeutet, dass die Daten jederzeit verschwinden können. "Verfügbar" bedeutet, dass die Daten mittelfristig (einige Jahre) verfügbar bleiben.
Lizenz: Wählen Sie die Lizenz, die für die Distribution gilt, auch wenn Sie diese bereits für den Datensatz angegeben haben. Creative Commons Zero Public Domain 1.0 (CC0 1.0) ist oft Standard für offene Daten und Organisationen.
Optionale Felder¶
Zeitauflösung: Der kleinste unterscheidbare Zeitraum in der Distribution, zum Beispiel "Monate: 3".
Veröffentlichungsdatum: Das Datum, an dem die Distribution erstellt wurde. Mit dem rechten Datumsmenü können Sie auswählen, ob Sie nur das Jahr, nur das Datum oder Datum und Uhrzeit eingeben möchten. Dann geben Sie das gewünschte Jahr/Datum/Uhrzeit in den linken Feldern ein.
Anwendbare Gesetzgebung: Ob die Distribution zu einem wertvollen Datensatz gehört oder nicht. Bei dem Datensatz selbst, zu dem die Distribution gehört, sollten Sie auswählen, zu welcher Kategorie wertvoller Datensätze er gehört.
Dokumentation: Eine Seite oder ein Dokument über die beschriebene Distribution. Wenn Sie die Distribution mit einem bereits vorhandenen Dokument in EntryScape Catalog verknüpfen möchten, muss es vom Dokumenttyp "Dokumentation" sein. Unter Dokumente erfahren Sie mehr darüber, wie Sie Dokumente erstellen und mit Distributionen verknüpfen.
Verknüpfte Schemata: Ein etabliertes Schema, dem die beschriebene Distribution folgt. Wenn Sie verknüpfte Schemata verwenden, sollte es als Ergänzung zum Format (Medientypen) dienen, wobei Sie mehr über die Datenstruktur der Distribution berichten. Typischerweise handelt es sich um ein XML-Schema, JSON-Schema oder eine API-Beschreibung (z.B. gemäß OpenAPI-Spezifikation). Manchmal kann es sinnvoll sein, auf eine Ontologie, ein Datenmodell oder ein Profil zu verweisen. Beachten Sie, dass wenn das, worauf Sie verweisen, formatunabhängig ist, es möglicherweise besser ist, das Feld "Entspricht" auf Datensatzebene zu verwenden.
Detaillierte Informationen anzeigen¶
Wenn Sie detailliertere Informationen zu Ihrer Distribution anzeigen möchten, klicken Sie auf das Informationssymbol.
Es wird ein Dialog angezeigt mit Metadaten, sowie Informationen zu allen Objekten die auf Ihre Distribution verweisen oder von ihr ausgehen. Lesen Sie mehr über detaillierte Informationen.
Distribution bearbeiten¶
Sie können die Distribution bearbeiten, indem Sie auf den Bleistift klicken.
Dateien entfernen, ersetzen und aktualisieren¶
Um die zu einer Distribution gehörenden Dateien zu verwalten, klicken Sie unter Distributionen auf das Dreipunktmenü und wählen Sie "Dateien verwalten" aus.
Auf der Übersichtsseite der Distribution können Sie eine neue Datei (z.B. Daten für ein neues Jahr) hinzufügen oder eine vorhandene Datei ersetzen oder entfernen.
Vergessen Sie nicht die Metadatenbeschreibung auf dem neuesten Stand zu halten damit sie immer mit den hochgeladenen Dateien übereinstimmt. "Geändert am" ist ein optionales, aber nützliches, Eingabefeld für Distributionen.
Sie können auch zu "Datensätze" gehen und "Bearbeiten" auswählen um das empfohlene Feld "Zeitraum" so zu ändern, dass es dem Zeitraum der Daten in der neuen Datei entspricht.
Distribution kopieren¶
Wenn Sie eine oder mehrere Kopien einer Distribution erstellen möchten, ohne die Metadaten erneut eingeben zu müssen, klicken Sie im Dreipunktmenü der Distribution auf "Kopieren".
Dadurch werden die Metadaten der Distribution kopiert und Sie haben die Möglichkeit, entweder eine neue Datei hochzuladen oder einen neuen Link zu den Daten anzugeben. Es ist daher möglich, das Format der neuen Kopie der Distribution zu ändern.
Erstellen einer API mithilfe von Tabellendaten (CSV)¶
Eine Distribution mit Tabellendaten (CSV-Dateien) kann zur automatischen Erstellung einer API verwendet werden.
Damit die API-Erstellung funktioniert, müssen einige Bedingungen erfüllt sein:
- Die erste Zeile der Tabelle sollte Titel für jede Spalte enthalten, da diese in der API als Variablenbezeichner verwendet werden. Die Spaltentitel werden beim Import getrimmt und in Kleinbuchstaben umgewandelt.
- Zeichenkettenwerte wie Spaltentitel oder Zellinhalte dürfen nur Unicode-Zeichen enthalten.
- Als Spaltentrennzeichen müssen Kommas (
,) verwendet werden. CSV-Dateien, die Semikolons (;) als Trennzeichen verwenden, können zwar erkannt werden, es wird jedoch empfohlen, Kommas zu verwenden. - Verwenden Sie Anführungszeichen des Schreibmaschinensatzes (
"). - Verwenden Sie den doppelten Backslash (
\\) als Escape-Zeichen. - Zeilenvorschub (
\n) oder Wagenrücklauf gefolgt von Zeilenvorschub (\r\n) muss verwendet werden, um eine neue Zeile anzuzeigen.
Eine automatisch generierte API ist über dessen REST-Schnittstelle verfügbar, und über einen Webbrowser kann auf eine einfache Webschnittstelle zugegriffen werden. Die Webschnittstelle enthält Links zu einer ausführlicheren Swagger-basierten API-Dokumentation.
API für eine Distribution aktivieren¶
Es ist von Vorteil die API für eine Dateidistribution zu aktivieren wenn dies möglich ist. Wenn Sie eine Datei als Distribution hochgeladen haben, können Sie sie für die Verwendung über die API aktivieren. Gehen Sie dazu zur Übersicht des Datensatzes, klicken Sie auf das Dreipunktmenü auf der rechten Seite der Distribution und dann auf API aktivieren.
Wenn der Datensatz noch nicht veröffentlicht wurde, erscheint die Warnung, dass der Datensatz veröffentlicht wird, wenn Sie mit der Aktivierung der API-Erstellung beginnen. Wenn Sie damit einverstanden sind, klicken Sie auf "Ja".
Anschließend beginnt die API-Generierung.
Sobald die API generiert wurde, klicken Sie auf "Schließen".
Ihre neue API ist jetzt als Distribution mit dem Namen "Automatisch generierte API" im JSON-Format vorhanden. Klicken Sie auf den Bleistift, wenn Sie sie umbenennen möchten. Über das Dreipunktmenü können Sie die API-Informationen (URL für die API) anzeigen, die API entfernen oder – wenn Sie Änderungen an der ursprünglichen Distribution (CSV-Datei) vorgenommen haben – die API aktualisieren, um die neuen Änderungen zu übernehmen.
Link zu externen APIs oder Dateien¶
Wenn bereits eine externe API oder eine externe Datei zu dem in EntryScape beschriebenen Datensatz vorhanden ist, können Sie als externe Distribution eine Verknüpfung von Ihrem Datensatz zu der Datei oder API erstellen. Das externe System ist für die Aktualisierung seiner Dateien und APIs verantwortlich, im Gegensatz zu einer Distribution, die durch das Hochladen einer eigenen Datei in EntryScape erstellt wurde.
Um eine Verbindung zu einer API oder externen Datei herzustellen, klicken Sie auf die Plus-Schaltfläche neben "Distributionen".
Geben Sie dann die externe Webadresse ein, beginnend mit "http" oder "https" und endend mit beispielsweise ".json". Klicken Sie dann auf "Erstellen".
Dadurch wird eine externe Distribution mit dem temporären Namen "Zugangspunkt" erstellt.
Sie können auf den Bearbeitungsstift klicken, um den Namen zu ändern und die Distribution besser zu beschreiben, um sie leichter von anderen Distributionen unterscheiden zu können. Geben Sie einen Titel, eine Beschreibung und vorzugsweise auch das Dateiformat, die Barrierefreiheit und die Lizenz ein.
Visualisierungen¶
Sie können Visualisierungen Ihrer Daten in EntryScape in Form von Balkendiagrammen, Kreisdiagrammen, Liniendiagrammen, Karten und Tabellen erstellen. Wenn Sie die Visualisierungen auch extern in EntryScape Blocks verwenden dann werden Ihre Visualisierungen nach Ihren Änderungen automatisch in Blocks übernommen.
Kartenbeispiel: Altstadt in Stockholm. Dächer mit geeigneter Sonneneinstrahlung für die Installation von Photovoltaik.
Um eine Visualisierung erstellen zu können, muss eine Distribution mit einer hochgeladenen CSV-Datei oder einem Web Map Service (WMS) vorhanden sein. Klicken Sie auf die Schaltfläche "Plus" neben "Visualisierungen", um eine neue Visualisierung zu erstellen.
Wählen Sie dann die Distribution aus, aus der die Visualisierung erstellt werden soll.
Anschließend beschreiben Sie die Visualisierung, indem Sie die Pflichtfelder Titel, Diagrammtyp und Diagrammachsen ausfüllen. Um eine Kartenvisualisierung erstellen zu können, müssen in Ihrer Datendatei oder Ihrem WMS-Dienst geografische Koordinaten enthalten sein.
Wenn Sie die Pflichtfelder ausgefüllt haben, wird unten im selben Fenster eine Vorschau der Visualisierung angezeigt.
Hinweis! Wenn Sie in Ihrer Visualisierung seltsame Zeichen sehen, liegt wahrscheinlich eine Inkompatibilität zwischen der Kodierung der hochgeladenen Datei und der in EntryScape ausgewählten Kodierung vor. Sie können versuchen, die Kodierung in EntryScape zu ändern, bis die Vorschau in Ordnung ist. Wenn es sich um eine große Datei handelt, sollten Sie mehrere Seiten und nicht nur die erste Seite überprüfen, um einzelne seltsame Zeichen zu bemerken.
Über das Dreipunktmenü können Sie Visualisierungen bearbeiten, in der Vorschau anzeigen und entfernen.
