تشرح هذه المقالة كيفية الكتابة بشكل جيد XML من خلال عرض مثال. تتم كتابة النشرة الإخبارية Web Writer باستخدام أحد أشكال XML ؛ نسميها AML أو حول لغة الترميز. على الرغم من أن هذه وثيقة عمل ، إلا أنها ليست وثيقة XML جيدة التنسيق أو صالحة.
حسن التشكيل
هناك بعض القواعد المحددة لإنشاء مستند XML جيد التنسيق:
- يجب أن يأتي إعلان XML أولاً في كل مستند.
- التعليقات ليست صالحة داخل العلامة. لا يجوز أن تحتوي التعليقات على واصلتين متتاليتين ، بخلاف بداية التعليق ونهايته.
- يجب أن تحتوي العلامات على علامة نهاية ، أو أن يتم إغلاقها داخل العلامة المفردة نفسها ، على سبيل المثال.
- يجب وضع علامات اقتباس لجميع سمات العلامات ، ويفضل أن تكون علامات اقتباس مزدوجة ما لم تحتوي السمة نفسها على اقتباس مزدوج.
- يجب أن يحتوي كل مستند XML على عنصر واحد يحتوي بالكامل على جميع العناصر الأخرى.
هناك مشكلتان فقط في المستند تجعله غير منسق بشكل جيد:
- أول ما تحتاجه وثيقة مكافحة غسل الأموال هو بيان إعلان XML.
- المشكلة الأخرى هي أنه لا يوجد عنصر واحد يحيط بالكامل بجميع العناصر الأخرى. لإصلاح ذلك ، سنضيف عنصر حاوية خارجيًا:
سيؤدي إجراء هذين التغييرين البسيطين (والتأكد من احتواء جميع العناصر على CDATA فقط) إلى تحويل المستند غير المنسق جيدًا إلى مستند جيد التكوين.
يتم التحقق من صحة مستند XML صالح مقابل تعريف نوع المستند (DTD) أو مخطط XML. هذه مجموعة من القواعد التي أنشأها المطور أو مؤسسة المعايير التي تحدد دلالات وثيقة XML. هذه تخبر الكمبيوتر بما يجب فعله بالعلامات.
في حالة حول لغة توصيف النصنظرًا لأن هذه ليست لغة XML قياسية ، مثل XHTML أو SMIL ، فسيتم إنشاء DTD بواسطة المطور. من المرجح أن يكون DTD على نفس الخادم مثل مستند XML والمشار إليه في أعلى المستند.
قبل أن تبدأ في تطوير DTD أو مخطط للمستندات الخاصة بك ، يجب أن تدرك أنه ببساطة من خلال تشكيلها بشكل جيد ، فإن مستند XML يصف نفسه بنفسه ، وبالتالي لا يحتاج إلى DTD.
على سبيل المثال ، مع وثيقة مكافحة غسل الأموال المُنسقة جيدًا ، توجد العلامات التالية:
إذا كنت معتادًا على النشرة الإخبارية لـ Web Writer ، فقد تتعرف على الأقسام المختلفة للنشرة الإخبارية. هذا يجعل من السهل جدًا إنشاء مستندات XML جديدة باستخدام نفس التنسيق القياسي. نضع دائمًا العنوان الكامل في العلامة وعنوان URL للقسم الأول في العلامة.
DTDs
إذا طُلب منك كتابة مستند XML صالح ، إما لاستخدام البيانات أو لمعالجتها ، فيمكنك تضمينه في المستند الخاص بك مع العلامة. في هذه العلامة ، تقوم بتعريف علامة XML الأساسية في المستند وموقع DTD (عادةً ما يكون Web URI).
على سبيل المثال:
أحد الأشياء الرائعة في إعلانات DTD هو أنه يمكنك التصريح بأن DTD محلي للنظام حيث يكون ملف مستند XML مع "SYSTEM." يمكنك أيضًا الإشارة إلى DTD عام ، مثل مستند HTML 4.0:
عندما تستخدم كلاهما ، فأنت تخبر المستند باستخدام DTD محدد (المعرف العام) ومكان العثور عليه (معرف النظام).
أخيرًا ، يمكنك تضمين DTD داخلي مباشرةً في المستند ، ضمن علامة DOCTYPE. على سبيل المثال (هذا ليس DTD كاملًا لوثيقة AML):
مخطط XML
لإنشاء مستند XML صالح ، يمكنك أيضًا استخدام مستند XML Schema لتعريف XML الخاص بك. مخطط XML هو مستند XML يصف مستندات XML. تعلم كيفية كتابة مخطط.
ملحوظة
إن مجرد الإشارة إلى DTD أو مخطط XML لا يكفي. يجب أن يتبع XML الموجود في المستند القواعد الموجودة في DTD أو المخطط. يعد استخدام محلل التحقق طريقة بسيطة للتحقق من أن XML الخاص بك يتبع قواعد DTD. يمكنك العثور على العديد من هؤلاء المحللين عبر الإنترنت.