قواعد عامة للتنسيق بتنسيق 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 prolog ": <? xml version="1.0" encoding="UTF-8?"> الـ XML prolog اختياري. إذا كان موجودًا ، يجب أن يأتي أولاً في الوثيقة. يمكن أن تحتوي وثائق 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. لا تدمج بيانات متعددة في علامة واحدة