Daten- und Ausgabeformate für API 1.0

Last modified: 5. Mai 2022

Die von Exporten und der API ausgegebenen Daten können in folgenden Formatkombinationen geschrieben werden

Datentyp /
Ausgabeformat
XMLJSONCSVXSLXHTMLPDF
FULL2x*x*x
FULLx*x*x
SMALLxxxx
PRICES2x*x*x
PRICESx*x*x
SOURCESxx*x
DEEPLINK x
DATASHEET xx

*nicht im Export, nur für die API.

CSV (zip)

Das CSV-Format ist ein tabellarisches Format, das von ITscope wie folgt geschrieben wird:

  • Datensätze werden durch Zeilenumbrüche (CRLF) getrennt.
  • Felder werden durch Komma (,) getrennt.
  • Die erste Zeile besteht aus den Feldnamen, ebenfalls von Kommas getrennt.
  • Zeichenketten stehen nur dann in doppelten Anführungszeichen, wenn der Inhalt ein solches Quoting erfordert.
  • In durch doppelte Anführungszeichen markierten Zeichenketten sind Zeilenumbrüche erlaubt und gelten nicht als Datensatztrenner.
  • Taucht ein doppeltes Anführungszeichen als Inhalt in einer Zeichenkette auf, wird es durch Voranstellen eines weiteren doppelten Anführungszeichen maskiert.
  • Ein leeres Textfeld enthält keine doppelten Anführungszeichen, sondern bleibt ganz leer
  • Fließkommazahlen enthalten einen Dezimalpunkt und kein Tausendertrennzeichen.
  • Datumswerte liegen als „dd.MM.yyyy hh:mm“ vor, wie in „12.05.2013 08:02“.
  • CSV-Dateien sind UTF-8-kodiert.

CSV-Downloads werden grundsätzlich als ZIP-Datei komprimiert ausgeliefert. Multi-File CSV-Formate enthalten im ZIP-Archiv mehrere CSV-Dateien, die einander referenzieren. Auch in Fällen wo nur eine einzige Datei als Ergebnis geliefert wird, kann das ZIP-Archiv mehrere Dateien enthalten.

  1. log.csv: enthält eine Liste der Produkte, die herausgefiltert wurden und der Grund für diese Filterung – diese Informationen sind für den ITscope Support gedacht, um bei Problemen besser rechercheiren zu können.
  2. ERROR.txt: ist vorhanden, wenn Fehler aufgetreten sind; in einem fehlerfreien Export ist die Datei nicht enthalten; ist die Datei vorhanden aber leer konnte der Grund nicht ermittelt werden.

XML

XML ist ein hierarchisches Format, in welchem ein übergeordnetes Objekt untergeordnete Objekte einbettet.

Die Feldnamen werden als Namen für die XML-Elemente verwendet. Referenzierte Objekte wurden bereits aufgelöst und sind direkt im übergeordneten Element eingebunden.

XML-Dateien werden direkt übertragen, ohne zusätzliche Dateien und unkomprimiert. Sie können beim Aufruf über den Browser direkt im Browser betrachtet werden. Die Log-Informationen zu herausgefilterten Produkten werden als <log>-Elemente am Ende angehängt.

JSON

JSON ist wie XML ein hierarchisches Format, das jedoch eine etwas platzsparendere Syntax verwendet. Die beiden Formate ähneln sich vom Aufbau her stark.

XLSX (Excel)

Eine Alternative zu CSV ist das XLSX-Format, das von Microsoft Excel verwendet wird. Es handelt sich um ein tabellarisches Format, das für einige Exporte zur Verfügung steht, die eine einzelne Tabelle ausgeben.

Was this article helpful?
Dislike 0
Views: 136