Règles générales pour XML
Last updated
Last updated
Voici les règles générales à suivre pour télécharger avec succès des données de certification via un fichier XML :
Les documents XML doivent contenir un élément racine qui est le parent de tous les autres éléments :
Pour le téléchargement de certificats, l'élément racine est <client_certs></client_certs>
Cette ligne est appelée prologue XML : <?xml version="1.0" encoding="UTF-8?">
Le prologue XML est facultatif. S'il existe, il doit être le premier dans le document. Les documents XML peuvent contenir des caractères internationaux, comme le øæå norvégien ou le êèé français. Pour éviter les erreurs, vous devez spécifier l'encodage utilisé ou enregistrer vos fichiers XML en UTF-8. UTF-8 est l'encodage de caractères par défaut pour les documents XML.
Tous les éléments XML doivent avoir une balise de fermeture Les balises XML sont sensibles à la casse. La balise est différente de la balise. Les balises d'ouverture et de fermeture doivent être écrites de la même façon :
Toute balise non fermée entraînera une erreur : Fichier XML non valide téléchargé
Incorrect : <certification_body_identity_number>%VALUE GOES HERE
\
Correct : <certification_body_identity_number>%VALUE GOES HERE</certification_body_identity_number>
Les éléments XML doivent être correctement imbriqués
En XML, tous les éléments doivent être correctement imbriqués les uns dans les autres :
Incorrect :
<certification_identity_number>
<certification>
CERT-0001
</certification_identity_number>
</certification>
Correct : <certification_identity_number>CERT-0001</certification_identity_number></certification>
Les balises ne peuvent pas contenir d'espace vide par ex. Le système ne reconnaîtra pas cette syntaxe et produira une erreur : Fichier XML non valide téléchargé
Toutes les balises parent doivent être incluses lors du téléchargement d'un fichier XML, si les balises parent sont manquantes, le système produira une erreur : Fichier XML non valide téléchargé
Si certification_standard_and_scheme et ses enfants sont vides, le système produira une erreur : Fichier XML non valide téléchargé
Les balises non valides pour les champs optionnels ne déclencheront pas d'erreur, mais les données ajoutées dans la balise ne seront pas affichées dans le système
Correct :<original_issue_date>01/20/2021</original_issue_date>
Incorrect (à partir du fichier) : <orig_issued_date>01/20/2021</orig_issued_date>
Données affichées dans le système Date d'émission d'origine : (vide)
Voici quelques points à prendre en compte lors de la saisie de vos données dans un fichier XML.
Une seule entrée de valeur de données par balise
Assurez-vous que seule une valeur de données unique est saisie dans une balise. Lorsque vous téléchargez plusieurs valeurs de données, ne incluez pas plus d'une valeur de données dans une balise.
Maintenez une cohérence dans le format des données
Des divergences dans les espaces, la capitalisation et autres types de formatage provoqueront une erreur et les données ne seront pas mises en correspondance.
Maintenez une syntaxe similaire à celle fournie dans le modèle
Ne laissez pas les champs obligatoires vides ou vides
Ne pas ajouter plusieurs données à une seule balise
Ne pas fusionner plusieurs données dans une seule balise
Format de fichier
Le format de fichier doit être .xml
Taille de fichier
La taille maximale des fichiers XML est de 50 Mo. Si votre fichier XML est supérieur à 50 Mo, vous devez le diviser et télécharger plusieurs fichiers, chacun étant inférieur à 50 Mo.
Nom de fichier
IAF CertSearch vous recommande de nommer vos fichiers selon les formats suivants :Un seul : cb_certs.xml
Plusieurs fichiers : cb_certs_1.xml
, cb_certs_2.xml
, cb_certs_3.xml
Balise XML
Les balises XML doivent être les mêmes que dans le modèle. Si elles sont modifiées, IAF CertSearcg ne reconnaîtra pas les données des champs et ne les téléchargera pas.
Séquence des balises XML
Les balises doivent être dans l'ordre et doivent être les mêmes que dans le modèle. Si elles sont modifiées, IAF CertSearch ne reconnaîtra pas les onglets et les données dans ces onglets ne seront pas téléchargées.