قواعد XML العامة

قواعد عامة

فيما يلي القواعد العامة لرفع بيانات الشهادات بنجاح من خلال ملف XML:

تنسيق الملف	يجب أن يكون تنسيق الملف .xml
حجم الملف	الحد الأقصى لحجم ملفات XML هو 50 ميغابايت. إذا كان ملف XML الخاص بك أكبر من 50 ميغابايت، فيجب تقسيمه إلى ملفات متعددة يكون حجم كل ملف منها أقل من 50 ميغابايت ورفعها.
اسم الملف	توصي IAF CertSearch بتسمية الملفات باستخدام الصيغ التالية: ملف واحد: cb_certs.xml ملفات متعددة: cb_certs_1.xml، cb_certs_2.xml، cb_certs_3.xml
علامة الـ XML	يجب أن تكون علامات الـ XML هي نفسها مثل القالب. إذا تم تغييرها، لن يتعرف IAF CertSearcg على بيانات الحقل ولن يتم رفعها.
تسلسل علامات الـ XML	يجب أن تكون العلامات مرتبة وهي نفسها مثل القالب. إذا تم تغييرها، فإن IAF CertSearch لن يتعرف على الألسنة ولن يتم رفع البيانات في تلك الألسنة.

فهم تنسيق ملف 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 غير صالح خاطئ: <certification_body_identity_number>%VALUE GOES HERE صحيح: <certification_body_identity_number>%VALUE GOES HERE</certification_body_identity_number> \

4. يجب تضمين عناصر الـ XML بشكل صحيح

   في الـ XML، يجب أن تكون جميع العناصر مضمنة بشكل صحيح داخل بعضها البعض: خاطئ: <certification_identity_number> <certification>CERT-0001</certification_identity_number> </certification> صحيح: <certification> <certification_identity_number>CERT-0001</certification_identity_number></certification>\

5. العلامات لا يمكن أن تحتوي على مسافات فارغة مثال: <certification identity number> لن يعترف النظام بهذا الصيغة وسيتم إلقاء خطأ: تم تحميل ملف XML غير صالح\

6. يجب تضمين جميع العلامات الرئيسية عند رفع ملف XML, إذا كانت العلامات الرئيسية مفقودة، سيقوم النظام بإلقاء خطأ: تم تحميل ملف XML غير صالح\

7. إذا كانت علامة certification_standard_and_scheme وأطفالها فارغة, سيقوم النظام بإلقاء خطأ: تم تحميل ملف XML غير صالح\

8. علامات غير صالحة للحقول الاختيارية لن تُثير خطأ, لكن البيانات المضافة داخل العلامة لن يتم عرضها في النظام صحيح:<original_issue_date>01/20/2021</original_issue_date> خاطئ (من الملف): <orig_issued_date>01/20/2021</orig_issued_date> البيانات التي تم عرضها في النظام تاريخ الإصدار الأصلي: (فارغ)

القواعد والممنوعات عند تنسيق البيانات في ملف XML

أشياء يجب مراعاتها عند ملء البيانات في ملف XML.

يجب

1. إدخال قيمة بيانات واحدة لكل علامة

   تأكد من إدخال قيم البيانات الواحدة فقط في علامة واحدة. عند رفع قيم البيانات المتعددة، لا تضمن أكثر من قيمة بيانات واحدة في علامة واحدة.

2. ابقِ على تنسيق البيانات متسقًا

   التباين في المسافات، الحروف الكبيرة والصغيرة، وأنواع التنسيق الأخرى ستتسبب في حدوث خطأ ولن يتم مطابقة البيانات

3. ابقَ على صيغة المعتادة مثلما هو موجود في القالب

ممنوع

1. لا تترك الحقول الإلزامية فارغة

2. لا تضيف بيانات متعددة في علامة واحدة

3. لا تدمج بيانات متعددة في علامة واحدة