Formats de données et de sortie pour l’API 1.0

Last modified: 5. février 2021

Les données produites par les exportations et l’API peuvent être écrites dans les combinaisons de formats suivantes

Type de données / format de sortieXMLJSONCSVXSLXHTMLPDF
FULL2x*x*x
FULLx*x*x
SMALLxxxx
PRICES2x*x*x
PRICESx*x*x
SOURCESxx*x
DEEPLINK x
DATASHEET xx

* pas à l’exportation, seulement pour l’API.

CSV (zip)

Le format CSV est un format tabulaire écrit par ITscope comme suit :

  • Les enregistrements de données sont séparés par des sauts de ligne (CRLF)
  • Les champs sont séparés par des virgules (,)
  • La première ligne est constituée des noms des champs, également séparés par des virgules
  • Les chaînes de caractères ne sont mises entre guillemets que si le contenu nécessite une telle citation
  • Dans les chaînes de caractères marquées par des guillemets doubles, les sauts de ligne sont autorisés et ne sont pas considérés comme des séparateurs d’enregistrements
  • Si un caractère à double guillemet apparaît comme contenu dans une chaîne, il est masqué en le faisant précéder d’un autre caractère à double guillemet
  • Un champ de texte vide ne contient pas de guillemets, mais reste complètement vide
  • Les nombres à virgule flottante contiennent une virgule décimale et pas de séparateur de milliers
  • Les valeurs des dates sont présentées sous la forme « jj.MM.aaaa hh:mm », comme dans « 12.05.2013 08:02 »
  • Les fichiers CSV sont encodés en UTF-8.

Les téléchargements CSV sont toujours livrés compressés sous forme de fichier ZIP. Les formats CSV multi-fichiers contiennent plusieurs fichiers CSV dans l’archive ZIP qui se référencent les uns les autres. Même dans les cas où un seul fichier est livré en conséquence, l’archive ZIP peut contenir plusieurs fichiers.

  1. log.csv : contient une liste des produits qui ont été filtrés et la raison de ce filtrage – cette information est destinée au support ITscope pour mieux enquêter en cas de problèmes.
  2. ERROR.txt : est présent si des erreurs se sont produites ; dans une exportation sans erreur, le fichier n’est pas inclus ; si le fichier est présent mais vide, la raison n’a pas pu être déterminée.

XML

Le XML est un format hiérarchique dans lequel un objet parent intègre des objets enfants.

Les noms des champs sont utilisés comme noms pour les éléments XML. Les objets référencés ont déjà été résolus et sont directement inclus dans l’élément parent.

Les fichiers XML sont transférés directement, sans fichiers supplémentaires et non compressés. Ils peuvent être consultés directement dans le navigateur lorsqu’ils sont appelés par celui-ci. Les informations de journal pour les produits filtrés sont jointes à la fin sous la forme d’éléments .

JSON

JSON est un format hiérarchique comme XML, mais il utilise une syntaxe légèrement plus efficace en termes d’espace. Les deux formats sont très similaires dans leur structure.

XLSX (Excel)

Une alternative au CSV est le format XLSX utilisé par Microsoft Excel. Il s’agit d’un format tabulaire disponible pour certaines exportations qui produisent un tableau unique.

Was this article helpful?
Dislike 0
Views: 14