نحن نحافظ على أداة التحقّق من الخلاصات المفتوحة المصدر لتوفير ملاحظات محددة وقابلة للتنفيذ تتجاوز عملية التحقق من XML البسيطة. يتوفر المدقّق من خلال أداة إدارة حزمة Python العادية:
bash:~$ pip install civics_cdf_validator
يوضّح المثال التالي كيفية استخدام هذه الميزة:
bash:~$ civics_cdf_validator validate your_feed.xml --xsd civics_cdf_specx.xsd --rule_set=RULE_SET
للحصول على قائمة بالأوامر الشائعة، راجع قراءة
أنواع الخلاصات المتوافقة
تتيح أداة التدقيق استخدام أنواع الخلاصات التالية:
- بيانات الانتخابات التمهيدية
- نتائج الانتخابات
- مسؤول
لضمان عدم تفويت بعض قواعد التحقّق، حدِّد نوع الخلاصة مع
RULE_SET:
| نوع الخلاصة | قيمة RULE_SET |
|---|---|
| مسؤول | OFFICEHOLDER |
| بيانات الانتخابات التمهيدية / نتائج الانتخابات | ELECTION |
مستويات عمليات التحقّق من الصحة
تتيح أداة التحقّق من صحة الخلاصة إجراء ثلاث فئات من عمليات التحقّق:
الخطأ: إذا ظهرت لك أي أخطاء، يعني هذا أنه يتعذّر على Google تحليل الملف. الحذف كل رسائل الخطأ من خلاصاتك قبل إرسال بياناتك. إذا كنت بحاجة المساعدة في معالجة رسائل الخطأ، والإبلاغ عن خطأ في المكون.
تحذير: تشير التحذيرات إلى السيناريوهات التي من غير المفترض حدوثها، وليس أو تجارب مستخدم رائعة، أو تكون محتملًا، وتحتاج إلى إصلاح. بالنسبة على سبيل المثال، يتم إرسال تحذير في حال إدخال أسماء المرشحين بأحرف كبيرة بالكامل. الرسائل حاوِل حلّ كل التحذيرات المقدّمة، وتوقَّع أن نسألك إذا رصدت المدقّق تحذيرات في الخلاصة
المعلومات: تشير رسائل المعلومات إلى سيناريوهات لا تؤثر في التشغيل التلقائي نقل الخلاصة أو تجربة المستخدم ولكنها تساعد شخصًا ما في قراءة فهم تخطيط بياناتك. إنّ تعديل رسائل المعلومات هو إجراء اختياري.