> 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-ja/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ドキュメントには、他のすべての要素の親である1つのルート要素が含まれている必要があります：**\
   認証アップロードの場合、ルート要素は`<client_certs></client_certs>`です。\\
2. この行は**XML宣言**と呼ばれます：`<?xml version="1.0" encoding="UTF-8?">`\
   XML宣言はオプションです。存在する場合は、ドキュメントの最初に配置する必要があります。 XMLドキュメントには、ノルウェー語のøæåやフランス語のêèéなどの国際文字が含まれることがあります。エラーを回避するためには、使用されているエンコーディングを指定するか、XMLファイルをUTF-8で保存する必要があります。 UTF-8はXMLドキュメントのデフォルトの文字エンコーディングです。\\
3. **すべてのXML要素には終了タグが必要です**\
   XMLタグは大文字と小文字を区別します。タグはタグとは異なるものです。開始タグと終了タグは同じケースで書かれている必要があります：\
   \
   閉じられていないタグはエラーを引き起こします：**無効な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. **認証\_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でデータのフォーマットを行う際の DOs と DONTs

XMLファイルにデータを入力する際に考慮しなければならないこと。

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

1. **1つのタグに1つのデータ値のみを入力すること**

   複数のデータ値をアップロードする場合は、1つのタグに複数のデータ値を含めないでください。
2. **データ形式を一貫させる**

   スペース、大文字小文字の不一致など、他の種類のフォーマットの不一致はエラーを引き起こし、データが一致しません。
3. **テンプレートで提供されている構文に似た構文を使用すること**

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

1. **必須のフィールドを空白または空にしないこと**
2. **1つのタグに複数のデータを追加しないこと**
3. **1つのタグに複数のデータを結合しないこと**