# قواعد 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 بتسمية الملفات باستخدام الصيغ التالية: ملف واحد: <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 على بيانات الحقل ولن يتم رفعها.</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 بأحرف الأبجدية الأصغر والأكبر (حالة الحروف الكبيرة والحروف الصغيرة). يجب كتابة العلامات المفتوحة والمغلقة بنفس الحالة:\
   \
   أي علامات غير مغلقة ستؤدي إلى خطأ: **تم تحميل ملف 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. **لا تدمج بيانات متعددة في علامة واحدة**


---

# 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/accreditation-bodies/ab-ar/data-management/import-certification/certification-file-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.