# XML常规规则

### 通用规则 <a href="#general-rule" id="general-rule"></a>

以下是成功通过XML文件上传认证数据的通用规则：

<table data-header-hidden><thead><tr><th width="222"></th><th></th></tr></thead><tbody><tr><td><strong>文件格式</strong></td><td>文件格式必须为<code>.xml</code></td></tr><tr><td><strong>文件大小</strong></td><td>XML文件的最大文件大小为50MB。如果您的XML文件超过50MB，则需要拆分并上传多个小于50MB的文件。</td></tr><tr><td><strong>文件名</strong></td><td>IAF CertSearch建议您使用以下格式命名文件：单个文件：<code>cb_certs.xml</code>多个文件：<code>cb_certs_1.xml</code>、<code>cb_certs_2.xml</code>、<code>cb_certs_3.xml</code></td></tr><tr><td><strong>XML标记</strong></td><td>XML标记必须与模板中的标记相同。如果更改，IAF CertSearch将无法识别字段数据并且将无法上传<strong>。</strong></td></tr><tr><td><strong>XML标记顺序</strong></td><td>标记应按顺序排列，并且必须与模板中的标记相同。如果更改，IAF CertSearch将无法识别标签和这些标签中的数据将无法上传。</td></tr></tbody></table>

## 了解XML文件格式

### 重要提示

1. **XML文档必须包含一个作为所有其他元素的父元素的根元素：**\
   对于证书上传，根元素是`<client_certs></client_certs>`\\
2. 此行称为**XML prolog**（XML前言）：`<?xml version="1.0" encoding="UTF-8?">`\
   XML prolog是可选的。如果存在，它必须位于文档的最前面。XML文档可以包含国际字符，如挪威语的øæå或法语的êèé。为避免错误，应指定所使用的编码，或将XML文件保存为UTF-8编码。UTF-8是XML文档的默认字符编码。\\
3. **所有XML元素都必须有一个闭合标记**\
   XML标记是区分大小写的。`<tag>`与`<Tag>`是不同的标记。开放和闭合标记必须以相同的大小写方式书写：\
   \
   没有关闭的标记将导致错误：**上传的XML文件无效**\ <mark style="color:red;">**错误的：**</mark> <mark style="color:red;">`<certification_body_identity_number>%VALUE GOES HERE`</mark>\
   \ <mark style="color:green;">**正确的：**</mark> <mark style="color:green;">`<certification_body_identity_number>%VALUE GOES HERE</certification_body_identity_number>`</mark>\
   \\
4. **XML元素必须正确嵌套**

   在XML中，所有元素必须正确嵌套在彼此之内：\
   \ <mark style="color:red;">**错误的：**</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;">**正确的：**</mark>\ <mark style="color:green;">\<certification></mark>\ <mark style="color:green;">\<certification\_identity\_number></mark>CERT-0001<mark style="color:green;">\</certification\_identity\_number>\</certification></mark>\\
5. **标记不能包含空格**\
   **例如：** <mark style="color:red;">`<certification identity number>`</mark>\
   系统将不会识别此语法并会抛出错误：**上传的XML文件无效**\\
6. **在上传XML文件时，应包括所有父标记**，如果缺少父标记，系统将抛出错误：**上传的XML文件无效**\\
7. **如果certification\_standard\_and\_scheme及其子项为空**，系统将抛出错误：**上传的XML文件无效**\\
8. **对于可选字段的无效标记不会触发错误**，但标记内部添加的数据将不会在系统中显示\
   \ <mark style="color:green;">**正确的：**</mark><mark style="color:green;">`<original_issue_date>01/20/2021</original_issue_date>`</mark>\ <mark style="color:red;">**错误的（来自文件）：**</mark> <mark style="color:red;">\<orig\_issued\_date>01/20/2021\</orig\_issued\_date></mark>\
   \
   **在系统中显示的数据**\
   原始发布日期：*(空)*

### 在XML中格式化数据时的注意事项

在将数据填充到XML文件中时，请牢记以下要点。

### <mark style="color:green;">**要做的事**</mark>

1. **每个标记只能输入单个数据值**

   确保只将单个数据值输入到一个标记中。当上传多个数据值时，不要在一个标记中包含多个数据值。
2. **保持数据格式一致**

   空格、大写字母和其他类型的格式不一致将导致错误，数据将无法匹配。
3. **保持语法与模板提供的类似**

### <mark style="color:red;">**不要做的事**</mark>

1. **不要将被要求的字段留空或为空**
2. **不要将多个数据添加到一个标记中**
3. **不要将多个数据合并到一个标记中**

#### &#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-zh/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.
