> For the complete documentation index, see [llms.txt](https://support.iafcertsearch.org/certification-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/certification-bodies/cb-ar/data-management/data-import/certification-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 هو 50 ميجابايت. إذا كان ملف XML الخاص بك أكبر من 50 ميجابايت ، فيجب عليك تقسيمه إلى ملفات متعددة كل منها أقل من 50 ميجابايت وتحميلها.</td></tr><tr><td><strong>اسم الملف</strong></td><td>يوصي IAF CertSearch بأن تسمي ملفاتك باستخدام الصيغ التالية:<br>ملف واحد: <code>cb_certs.xml</code><br>ملفات متعددة: <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 prolog ": `<? xml version="1.0" encoding="UTF-8?">`\
   الـ XML prolog اختياري. إذا كان موجودًا ، يجب أن يأتي أولاً في الوثيقة. يمكن أن تحتوي وثائق 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. **إذا كانت شهادة الـ 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>