# Allgemeine XML-Regeln

### Allgemeine Regeln <a href="#general-rule" id="general-rule"></a>

Hier sind die allgemeinen Regeln, um Zertifizierungsdaten erfolgreich über eine XML-Datei hochzuladen:

<table data-header-hidden><thead><tr><th width="222"></th><th></th></tr></thead><tbody><tr><td><strong>Dateiformat</strong></td><td>Das Dateiformat muss <code>.xml</code> sein.</td></tr><tr><td><strong>Dateigröße</strong></td><td>Die maximale Dateigröße für XML-Dateien beträgt 50 MB. Wenn Ihre XML-Datei größer als 50 MB ist, müssen Sie sie aufteilen und mehrere Dateien hochladen, die jeweils weniger als 50 MB groß sind.</td></tr><tr><td><strong>Dateiname</strong></td><td>IAF CertSearch empfiehlt, Ihre Dateien nach folgendem Format zu benennen: Einzelne Datei: <code>cb_certs.xml</code> Mehrere Dateien: <code>cb_certs_1.xml</code>, <code>cb_certs_2.xml</code>, <code>cb_certs_3.xml</code></td></tr><tr><td><strong>XML-Tag</strong></td><td>XML-Tags müssen mit dem Vorlagen-Tag übereinstimmen. Wenn sie geändert werden, erkennt IAF CertSearcg die Felddaten nicht und sie werden nicht hochgeladen.<strong>.</strong></td></tr><tr><td><strong>XML-Tag-Reihenfolge</strong></td><td>Tags sollten in der richtigen Reihenfolge und mit den gleichen Tags wie in der Vorlage sein. Wenn sie geändert werden, erkennt IAF CertSearch die Tabs nicht und die Daten in diesen Tabs werden nicht hochgeladen.</td></tr></tbody></table>

## Verständnis des XML-Dateiformats

### Wichtige Hinweise

1. **XML-Dokumente müssen ein Wurzelelement enthalten, das das übergeordnete Element aller anderen Elemente ist:**\
   Für den Zertifikatshochlad ist das Wurzelelement `<client_certs></client_certs>`\\
2. Diese Zeile wird als **XML-Prolog** bezeichnet: `<?xml version="1.0" encoding="UTF-8?">`\
   Der XML-Prolog ist optional. Wenn er vorhanden ist, muss er als erstes im Dokument stehen. XML-Dokumente können internationale Zeichen wie das norwegische øæå oder das französische êèé enthalten. Um Fehler zu vermeiden, sollten Sie die verwendete Codierung angeben oder Ihre XML-Dateien als UTF-8 speichern. UTF-8 ist die Standard-Zeichenkodierung für XML-Dokumente.\\
3. **Alle XML-Elemente müssen über ein Abschlusstag verfügen**\
   XML-Tags unterscheiden zwischen Groß- und Kleinschreibung. Das Tag unterscheidet sich vom Tag. Die öffnenden und schließenden Tags müssen in der gleichen Schreibweise geschrieben werden:\
   \
   Alle Tags, die nicht geschlossen sind, führen zu einem Fehler: **Ungültige XML-Datei hochgeladen**\ <mark style="color:red;">**Falsch:**</mark> <mark style="color:red;">`<certification_body_identity_number>%WERT HIER EINFÜGEN`</mark>\
   \ <mark style="color:green;">**Richtig:**</mark> <mark style="color:green;">`<certification_body_identity_number>%WERT HIER EINFÜGEN</certification_body_identity_number>`</mark>\
   \\
4. **XML-Elemente müssen ordnungsgemäß geschachtelt sein**

   In XML müssen alle Elemente ordnungsgemäß ineinander geschachtelt sein:\
   \ <mark style="color:red;">**Falsch:**</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;">**Richtig:**</mark>\
   \ <mark style="color:green;">\<certification\_identity\_number></mark>CERT-0001<mark style="color:green;">\</certification\_identity\_number>\</certification></mark>\\
5. **Tags dürfen keine Leerzeichen enthalten**\
   **z.B.** <mark style="color:red;">`<certification identity number>`</mark>\
   Das System erkennt diese Syntax nicht und gibt einen Fehler aus: **Ungültige XML-Datei hochgeladen**\\
6. **Alle übergordneten Tags sollten beim Hochladen einer XML-Datei enthalten sein,** wenn die übergordneten Tags fehlen, gibt das System einen Fehler aus: **Ungültige XML-Datei hochgeladen**\\
7. **Wenn die certification\_standard\_and\_scheme und ihre Untertags leer sind**, gibt das System einen Fehler aus: **Ungültige XML-Datei hochgeladen**\\
8. **Ungültige Tags für optionale Felder lösen keinen Fehler aus**, aber die innerhalb des Tags hinzugefügten Daten werden nicht im System angezeigt\
   \ <mark style="color:green;">**Richtig:**</mark><mark style="color:green;">`<original_issue_date>01/20/2021</original_issue_date>`</mark>\ <mark style="color:red;">**Falsch (aus der Datei):**</mark> <mark style="color:red;">\<orig\_issued\_date>01/20/2021\</orig\_issued\_date></mark>\
   \
   **Im System angezeigte Daten**\
   Ursprüngliches Ausstellungsdatum: *(leer)*

### DOs und DONTs beim Formatieren von Daten in einer XML-Datei

Dinge, die Sie beachten sollten, wenn Sie Ihre Daten in einer XML-Datei erfassen.

### <mark style="color:green;">**DOs**</mark>

1. **Nur ein einzelner Datenwert pro Tag eingeben**

   Stellen Sie sicher, dass nur einzelne Datenwerte in einen Tag eingegeben werden. Wenn Sie mehrere Datenwerte hochladen, fügen Sie nicht mehr als einen Datenwert in einen Tag ein.
2. **Halten Sie das Datenformat konsistent**

   Eine Abweichung bei Leerzeichen, Groß- und Kleinschreibung und anderen Formatierungen führt zu einem Fehler und die Daten werden nicht abgeglichen.
3. **Halten Sie die Syntax ähnlich wie in der Vorlage**

### <mark style="color:red;">**DONTs**</mark>

1. **Lassen Sie die vorgeschriebenen Felder nicht leer**
2. **Fügen Sie nicht mehrere Daten in ein Tag ein**
3. **Fügen Sie keine mehreren Daten in ein Tag zusammen**