> For the complete documentation index, see [llms.txt](https://support.iafcertsearch.org/accreditation-bodies/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.iafcertsearch.org/accreditation-bodies/ab-ko/data-management/import-certification/certification-file-templates/xml-general-rules.md).

# 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 CertSearcg에서 필드 데이터를 인식하지 못하고 업로드되지 않습니다<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 프롤로그**라고 불립니다: `<?xml version="1.0" encoding="UTF-8?">`\
   XML 프롤로그는 선택 사항입니다. 존재하는 경우, 문서의 가장 앞에 있어야 합니다. 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>\
   \
   **시스템에 표시되는 데이터**\
   Original Issued Date: *(비어 있음)*

### XML에서 데이터 형식을 변경할 때 주의할 점

XML 파일에 데이터를 생성할 때 기억해야 할 사항입니다.

### <mark style="color:green;">**해야 할 일**</mark>

1. **하나의 태그 당 단일 데이터 값 입력**

   하나의 태그에 하나의 데이터 값만 입력되도록 확인하세요. 여러 데이터 값을 업로드할 때에는 하나의 태그에 둘 이상의 데이터 값을 포함하지 마세요.
2. **데이터 형식을 일관되게 유지**

   공백, 대소문자, 기타 형식의 불일치는 오류를 일으키고 데이터가 일치하지 않을 수 있습니다.
3. **템플릿에서 제공된 구문과 유사한 구문 사용**

### <mark style="color:red;">**하지 말아야 할 일**</mark>

1. **필수 필드를 비워 두지 마세요**
2. **하나의 태그에 여러 데이터를 추가하지 마세요**
3. **여러 데이터를 하나의 태그에 병합하지 마세요**
