# Règles générales pour XML

### Règles générales <a href="#general-rule" id="general-rule"></a>

Voici les règles générales à suivre pour télécharger avec succès des données de certification via un fichier XML :

<table data-header-hidden><thead><tr><th width="222"></th><th></th></tr></thead><tbody><tr><td><strong>Format de fichier</strong></td><td>Le format de fichier doit être <code>.xml</code></td></tr><tr><td><strong>Taille de fichier</strong></td><td>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.</td></tr><tr><td><strong>Nom de fichier</strong></td><td>IAF CertSearch vous recommande de nommer vos fichiers selon les formats suivants :Un seul : <code>cb_certs.xml</code>Plusieurs fichiers : <code>cb_certs_1.xml</code>, <code>cb_certs_2.xml</code>, <code>cb_certs_3.xml</code></td></tr><tr><td><strong>Balise XML</strong></td><td>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<strong>.</strong></td></tr><tr><td><strong>Séquence des balises XML</strong></td><td>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.</td></tr></tbody></table>

## Comprendre le format de fichier XML

### Notes importantes

1. **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>`
2. 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.
3. **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é**\ <mark style="color:red;">**Incorrect :**</mark> <mark style="color:red;">`<certification_body_identity_number>%VALUE GOES HERE`</mark>\\

   <mark style="color:green;">**Correct :**</mark> <mark style="color:green;">`<certification_body_identity_number>%VALUE GOES HERE</certification_body_identity_number>`</mark>
4. **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 :

   <mark style="color:red;">**Incorrect :**</mark>\ <mark style="color:red;">`<certification_identity_number>`</mark>\ <mark style="color:red;">`<certification>`</mark>`CERT-0001`<mark style="color:red;">`</certification_identity_number>`</mark>\ <mark style="color:red;">`</certification>`</mark>

   <mark style="color:green;">**Correct :**</mark>\
   \ <mark style="color:green;">\<certification\_identity\_number></mark>CERT-0001<mark style="color:green;">\</certification\_identity\_number>\</certification></mark>
5. **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é**
6. **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é**
7. **Si certification\_standard\_and\_scheme et ses enfants sont vides**, le système produira une erreur : **Fichier XML non valide téléchargé**
8. **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

<mark style="color:green;">**Correct :**</mark><mark style="color:green;">`<original_issue_date>01/20/2021</original_issue_date>`</mark>\ <mark style="color:red;">**Incorrect (à partir du fichier) :**</mark> <mark style="color:red;">\<orig\_issued\_date>01/20/2021\</orig\_issued\_date></mark>

**Données affichées dans le système**\
Date d'émission d'origine : *(vide)*

### Ce qu'il faut faire et ne pas faire lors de la mise en forme des données dans un fichier XML

Voici quelques points à prendre en compte lors de la saisie de vos données dans un fichier XML.

### <mark style="color:green;">**Ce qu'il faut faire**</mark>

1. **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.
2. **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.
3. **Maintenez une syntaxe similaire à celle fournie dans le modèle**

### <mark style="color:red;">**Ce qu'il ne faut pas faire**</mark>

1. **Ne laissez pas les champs obligatoires vides ou vides**
2. **Ne pas ajouter plusieurs données à une seule balise**
3. **Ne pas fusionner plusieurs données dans une seule balise**

#### &#x20;<a href="#dos-and-donts-when-formatting-data-in-an-xml" id="dos-and-donts-when-formatting-data-in-an-xml"></a>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.iafcertsearch.org/certification-bodies/cb-fr/data-management/data-import/certification-templates/xml-general-rules.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.