Formats de données et formats de sortie

Last modified: 26. janvier 2021

Aperçu

L’étendue des données à produire par les exportations et l’API est identique pour chaque combinaison de format de données et de format de sortie. Autrement dit, quel que soit le format de sortie choisi, le contenu des données dans le format de données est toujours identique.

Toutefois, il existe une limite par exportation dépendant du contrat pour toutes les combinaisons de format de données et de format de sortie.

Les types de format suivants sont autorisés et utilisent les identificateurs de format spécifiés. Le schéma xsd des formats de sortie disponibles peut être récupéré via la méthode info.

Formats de données / formats de sortiecsvjsonxmlDomaine d’applicationLangue
standard*xxxProduits et recherche de produitsune langue
standardUpdatexxxProduits et recherche de produitsune langue
developer**xxxProduits et recherche de produitsjusqu’à 6
developerUpdatexxxProduits et recherche de produitsune langue
deal xxCommandesEn allemand
quote xxDevisEn allemand
company xxFabricants et fournisseursEn allemand
producttype xxCatégoriesEn allemand
ORDER, ORDERRESPONSE,
DISPATCHNOTIFICATION, INVOICE
  xCommande de documents OpenTrans 2.1En allemand
QUOTE  xCommande de documents OpenTrans 2.1En allemand
  • profil recommandé par ITscope, qui couvre presque tous les domaines d’application sera

** uniquement recommandé aux professionnels qui sont familiers avec la structure des données de l’ITscope. Uniquement recommandé avec les conseils techniques d’ITscope.

Formats de données pour les pièces jointes aux articles

standard

Ce profil est recommandé pour couvrir presque toutes les connexions d’ITscope. Ce type ne contient que des données sélectionnées, conçues pour être suffisantes pour la plupart des objectifs sans générer un trop grand volume de données. Les données du profil sont agrégées, c’est-à-dire que tout est pré-rempli pour une utilisation immédiate. Ids, images, textes, clés, prix, propriétés techniques.

Ce profil fournit les données dans un format facile à utiliser – sous forme de fichiers CSV plats, ou en XML, ou en format JSON avec des données sur les produits, les fournisseurs, les biens et les ventes croisées.

Ce profil est recommandé pour l’ajustement quotidien.

developer

Toutes les données disponibles dans la plate-forme ITscope pour un produit sont produites, y compris le contenu complet. Ce profil n’est vraiment destiné qu’aux professionnels, aux utilisateurs qui connaissent la structure complète des données de l’ITscope et qui sont prêts à l’apprendre.

Nous vous recommandons de toujours consulter ITscope pour obtenir des conseils techniques. Grâce à une introduction appropriée à la structure des données et à la signification des objets de données respectifs directement à vos besoins, des efforts inutiles sont économisés.

Les formats tabulaires existent sous la forme d’un tableau unique pour ce type de données. Pour les relations 1:1 pertinentes, l’enregistrement référencé a été inclus dans le tableau. Pour chaque relation 1:n, un certain nombre de références ont été spécifiées pour être incluses. Le même nombre de champs est toujours utilisé dans le tableau global. Si seulement trois des quatre références configurées existent, les entrées de champ sont générées pour les quatre, mais restent vides pour le quatrième enregistrement manquant. Pour les champs répétitifs, les noms des champs sont numérotés consécutivement avec un compteur.

Ce profil est recommandé pour l’ajustement quotidien.

Formats de données pour la mise à jour des articles

standardUpdate

Le profil de mise à jour correspond toujours à son profil principal et ne fournit que les données de transaction pour la mise à jour, telles que les prix, les niveaux de stock, les dates de livraison. Le volume de données est inférieur au profil principal et sert principalement à tenir à jour les données de transaction du système cible.

Ce profil peut être utilisé pour une comparaison horaire efficace des prix et des disponibilités.

developerUpdate

Le profil de mise à jour correspond toujours à son profil principal et ne fournit que les données de transaction pour la mise à jour, telles que les prix, les niveaux de stock, les dates de livraison. Le volume de données est inférieur au profil principal et sert principalement à tenir à jour les données de transaction du système cible.

Ce profil peut être utilisé pour une comparaison horaire efficace des prix et des disponibilités.

Propriétés du format de sortie


Les données produites par les exportations et l’API peuvent être écrites dans les formats suivants.

  • Format tabulaire : CSV
  • format hiérarchique : XML, JSON

Propriétés générales pour tous les formats de sortie :

  • pas de Carriage Returns (CR) ou de Linefeeds (LF) dans les colonnes ou les éléments
  • toutes les données sont codées en UTF-8

L’ordre des contenus dans tous les formats (CSV, JSON, XML) sont clairement regroupés dans les catégories suivantes :

Format de sortie CSV

Ce type de données exige que les formats tabulaires contiennent plus d’un tableau car les objets se référencent les uns les autres. Ces formats ont toujours un identifiant unique pour chaque enregistrement et référencent ces identifiants à partir des enregistrements qui leur sont liés.

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

  • Les données sont toujours compressées et fournies sous forme de paquet ZIP
  • Les enregistrements de données sont séparés par des sauts de ligne (CRLF)
  • Les champs sont séparés par une tabulatrice (\t)
  • La première ligne est constituée des noms des champs, également séparés par une tabulatrice (\t)
  • Les chaînes n’ont pas de guillemets, c’est-à-dire que les différentes colonnes ne sont pas citées par des apostrophes (« )
  • Ni les tabulations ni les sauts de ligne n’apparaissent dans les chaînes de caractères
  • 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.

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

Format de sortie XML

Les formats hiérarchiques contiennent toutes les informations, mais les objets correspondants sont subordonnés à l’objet de référence intégré dans le parent.

 
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, mais sont SEULEMENT compressés par HTTP gzip si l’en-tête Accept-Encoding est défini. Pour plus d’informations sur les réponses API compressées, cliquez ici. Ils peuvent y être consultés directement lorsqu’ils sont appelés via le navigateur. Les informations de journal pour les produits filtrés sont jointes à la fin sous la forme d’éléments .

Format de sortie 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.

JSON 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 JSON. Les objets référencés ont déjà été résolus et sont directement inclus dans l’élément parent.

Les fichiers JSON sont transmis directement, sans fichiers supplémentaires, mais sont UNIQUEMENT compressés par HTTP gzip si l’en-tête Accept-Encoding est défini. Pour plus d’informations sur les réponses API compressées, cliquez ici. Ils peuvent y être consultés directement lorsqu’ils sont appelés via le navigateur. Les informations de journal pour les produits filtrés sont jointes sous la forme de éléments à la fin.

Was this article helpful?
Dislike 0
Views: 96