API Statistics - Migration von WDDS zu API Statistics

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:

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

Unterschiede zwischen älteren JSON-Dateien und JSON-stat 2.1 WDDS Translator-Dateien

• Die Feldreihenfolge:

• “source” Eigenschaftswert

• “updated” Eigenschaftsformat:

• “extension” Feld

• “dimension” Feld

• “id” Feld

• “size” Feld