Alle Visualisierungsanwendungen müssen migriert werden, um den DissChain WDDS Translator verwenden zu können.
Bei der Migration muss Folgendes berücksichtigt werden:
Es gibt Methoden und Parameter, die außer Kraft genommen werden. Weitere Informationen finden Sie in diesem Kapitel.
Es gibt Unterschiede im JSON-Format. Weitere Informationen finden Sie in diesem Kapitel.
Unterschiede zwischen den WDDS-Versionen 1.1 und 2.1
Erste Änderung
Einer der Hauptunterschiede zwischen den beiden Versionen ist die Verwendung von Positionsparametern in 1.1 gegenüber benannten Parametern in 2.1, bei denen die Nullwerte nicht angezeigt werden. In Version 2.1 wird ein Index zum Sortieren der Werte bereitgestellt. Beide Änderungen helfen bei der Bereitstellung einer schnelleren / gefilterten Antwort.
Einige andere Änderungen, die im Ausgangszustand durchgeführt wurden:
"title" wurde im Stammverzeichnis in "label" umbenannt
"updated" wird anstelle von "lastUpdateDate" verwendet
Alle nicht standardmäßigen Eigenschaften (Dataset-ID, Sprache, Agentur, Beschreibung, Status) wurden in den Abschnitt "Erweiterung" verschoben
Der Standard „status“-Eigenschaft wurde aktualisiert und enthält nun alle Metadateninformationen auf Beobachtungsebene
Die möglichen Werte für "class" wurden aktualisiert und enthalten nun die Antwort "dataset" anstelle von "bundle" ("bundle" war vor Version 2.0 ein akzeptierter Wert)
JSON-stat Änderungen
JSON-stat 2.0-Unterstützung in WDDS:
Die Eigenschaft "version" wurde mit dem Wert 2.0 hinzugefügt
Die Eigenschaften "id", "size" und "role" wurden von der Dimensionsebene auf die Dataset-Ebene verschoben
JSON-stat-Statuseigenschaft:
Die Eigenschaft "status" wird nicht angezeigt, wenn sie keine Informationen enthält
Änderung der JSON-stat-Fehlermeldung für zu umfangreiche Extraktionen:
„Too many categories have been requested. Maximum is 50" Fehlermeldung wird angezeigt, falls der abzurufende Extraktion zu groß ist. Es ersetzt die vorherige Fehlermeldung "Maximum 50 datasets can be retrieved at a time" oder der Antwort des Abfrage-Generators "Maximum 50 sub-indicators can be retrieved at a time. Please filter your selection”
JSON-stat-Fehlerspezifikation:
Die übermittelte Fehlermeldung ist im JSON-Format anstelle von einfachem Text. Die Fehlerelemente sind:
status: Der HTTP-Statuscode
id: Der interne Fehlercode des Anbieters (optional)
href: Ein Link zu einer Webseite, auf der Informationen zu diesem Fehler veröffentlicht werden (optional)
label: Ein kurzer beschreibender Text zum Fehler
Beispiel:
{ "error": [\{"status": 400,"id": 100,"label": "NO_RESULTS: No data found"}]}
Das JSON-stat HREF-Element enthält alle Parameter:
Die HREF-Eigenschaft im Stammverzeichnis enthält die URL der Anforderung
JSON-stat “updated” Eigenschaft contains a date instead of timestamp:
Die JSON-stat-Eigenschaft "updated" enthält ein Datum anstelle eines Zeitstempels:
Wenn keine Uhrzeit angegeben ist, sollte der Wert von "updated" ein Datum und keinen Zeitstempel mit 0 für die Uhrzeit festgelegten Werten enthalten
Der JSON-stat-Quellwert ist "Eurostat" anstelle von "ESTAT".
Methoden, Parameter und Elemente, die in RENOV WDDS Translator außer Betrieb genommen werden sollen
In der folgenden Tabelle sind die Methoden, Parameter und Elemente aufgeführt, die in RENOV WDDS Translator außer Betrieb genommen werden:
target | Methode | |
filterNonGeo | Methode | |
getRegionalCategorization | Methode | Der Parameter "geo_categorical" wird für den UNICODE verwendet, der nicht mehr unterstützt wird. |
getCountryLabel | Methode | Der Parameter "country_label" wird für den UNICODE verwendet, der nicht mehr unterstützt wird. |
callBack | Methode | callBack wird durch CORS ersetzt. |
precision | Parameter | Der Parameter "precision" wird für den UNICODE verwendet, der nicht mehr unterstützt wird. |
shortLabel | Parameter | |
groupedIndicators | Parameter | |
unitLabel | Parameter | |
HREF | Antwort JSON-stat-Element | Nicht benutzt. |
Die Methoden und Parameter, die an den RENOV WDDS-Translator weitergegeben werden, sind:
lastTimePeriod
sinceTimePeriod
untilTimePeriod
geoLevel, kann mehrere sein und verfügbare Werte sind:
aggregate: Europäische Aggregate basierend auf einer weißen Liste – EU15, EU25, EU27_2007, EU27_2019, EU28, EA19 usw.
country: beliebiger Ländercode (EU-Mitgliedstaaten oder EFTA- oder Kandidatenländer oder andere Länder) – zwei beliebige Ziffern – d. h. FR
nuts1: NUTS 1 - beliebige 3 Ziffern - d. h. FR4 (siehe diese Seite für weitere Informationen zur NUTS-Klassifikation)
nuts2: NUTS 2 - beliebige 4 Ziffern - d. h. FR41 (siehe diese Seite für weitere Informationen zur NUTS-Klassifikation)
nuts3: NUTS 3 - beliebige 5 Ziffern - d. h. FR413 (siehe diese Seite für weitere Informationen zur NUTS-Klassifikation)
city: Code auf Stadtebene - beliebige 7 Ziffern - z. B. DE_DEL1 (Karlsruhe)
Unterschiede zwischen Legacy-JSON und RENOV-JSON
Unterschiede in den TIME_PERIOD-Werten zwischen älteren TSV-Dateien und RENOV-TSV-Dateien
Differenztyp | TSV-Dateien im Legacy-Bulk-Download | TSV-Dateien in der RENOV-API | |||
Änderung im Daten Zeitraumcode | Muster | Beispiel | Muster | Beispiel | Kommentar |
5 Jahre | YYYY | 2019 | YYYY | 2019 | Das angegebene Jahr ist das letzte der 5 Jahre. |
Jahr | YYYY | 2019 | YYYY | 2019 | |
Semester | YYYYSN | 2015S1 | YYYY-SN | 2015-S1 | |
Quartal | YYYYQN | 2015Q4 | YYYY-QN | 2015-Q4 | |
Monat | YYYYMNN | 2015M02 | YYYY-MM | 2015-02 | |
Woche | YYYYWNN | 2020W28 | YYYY-WNN | 2020-W28 | |
Tag | YYYYMNNDNN | 2019M06D13 | YYYY-MM-DD | 2015-12-31 |
Unterschiede zwischen älteren JSON-Dateien und JSON-stat 2.1 WDDS Translator-Dateien
Die Feldreihenfolge:
Legacy JSON | JSON-stat 2.1 WDDS Translator |
1.version 2.label 3.href 4.source 5.updated 6.status 7.extension 8.class 9.value 10.dimension 11.id 12.size | 1.version 2.class 3.label 4.source 5.updated 6.value 7.status 8.id 9.size 10.dimension 11.extension <<"href" ist in dieser Version nicht vorhanden>> |
“source” Eigenschaftswert
Legacy JSON | JSON-stat 2.1 WDDS Translator |
Eurostat | ESTAT |
“updated” Eigenschaftsformat:
Legacy JSON | JSON-stat 2.1 WDDS Translator |
YYYY-MM-DD | yyyy-MM-ddTHH:mm:ssZ |
“extension” Feld
Legacy JSON | JSON-stat 2.1 WDDS Translator |
"datasetId" Eigenschaftsname | “id” Egenschaftsname |
Die Eigenschaft "description" ist vorhanden | Die Eigenschaft "description" ist nicht vorhanden |
Die Eigenschaft "subTitle" ist vorhanden | Die Eigenschaft "subTitle" wird in den Abschnitt "annotation" verschoben - siehe unten. |
“annotiation” ist nicht vorhanden. | "annotation" ist vorhanden und enthält die folgenden zusätzlichen Felder: DISSEMINATION_OBJECT_TYPE OBS_COUNT OBS_PERIOD_OVERALL_OLDEST OBS_PERIOD_OVERALL_LATEST UPDATE_STRUCTURE UPDATE_DATA SUBTITLE SOURCE_INSTITUTIONS DISSEMINATION_PRESENTATIONS |
Kombinationen von flags sind nicht vorhanden | Kombinationen von flags sind vorhanden |
“dimension” Feld
Legacy JSON | JSON-stat 2.1 WDDS Translator |
Die Dimension "freq" ist nicht vorhanden | Die Dimension "freq" ist vorhanden |
Die Eigenschaft "label" enthält den Dimensionscode | Die Eigenschaft "label" enthält den Dimensionstitel |
“id” Feld
Legacy JSON | JSON-stat 2.1 WDDS Translator |
"freq" ist nicht vorhanden | "freq" ist vorhanden |
“size” Feld
Legacy JSON | JSON-stat 2.1 WDDS Translator |
Das Feld "size" enthält nicht die Dimension "freq" | Das Feld "size" enthält die Dimension "freq" |