Child pages
  • API Statistics - Migration von JSON Webservice zu API Statistics

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

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

...

  • .

...

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:

Code Block
{ "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".

Anchor
DECOMMISSION
DECOMMISSION
Methoden, Parameter und Elemente, die in

...

API Statistics 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:

...

  • 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)

Anchor
JSON_DIFF
JSON_DIFF
Unterschiede

...

zwischen WDDS 2.1 JSON und

...

API Statistics JSON

Unterschiede in den TIME_PERIOD-Werten

...

Differenztyp

TSV-Dateien im Legacy-Bulk-Download

WDDS 2.1 JSON


API Statistics JSONTSV-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

...

in die Felder

  • Die Feldreihenfolge:

WDDS 2.1

Legacy JSON

API Statistics

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

WDDS 2.1

Legacy JSON

API Statistics

JSONJSON-stat 2.1 WDDS Translator

Eurostat

ESTAT


  • “updated” Eigenschaftsformat:

WDDS 2.1

Legacy JSON

API Statistics

JSONJSON-stat 2.1 WDDS Translator

YYYY-MM-DD

yyyy-MM-ddTHH:mm:ssZ


  • “extension” Feld

WDDS 2.1

Legacy JSON

API Statistics

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

WDDS 2.1

JSON

API Statistics

JSON

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

WDDS 2.1

Legacy JSON

API Statistics

JSON-stat 2.1 WDDS Translator

"freq" ist nicht vorhanden

"freq" ist vorhanden


  • “size” Feld

WDDS 2.1

Legacy JSON

API Statistics

JSON-stat 2.1 WDDS Translator

Das Feld "size" enthält nicht die Dimension "freq"

Das Feld "size" enthält die Dimension "freq"