ابزار اعتبارسنجی فید

ما یک اعتبارسنجی فید منبع باز طراحی شده برای ارائه بازخورد خاص و عملی فراتر از اعتبارسنجی ساده XML داریم. اعتباردهنده از طریق ابزار استاندارد مدیریت بسته پایتون در دسترس است:

bash:~$ pip install civics_cdf_validator

مثال زیر نحوه استفاده از آن را نشان می دهد:

bash:~$ civics_cdf_validator validate your_feed.xml --xsd civics_cdf_specx.xsd --rule_set=RULE_SET

برای فهرستی از دستورات رایج، به README مراجعه کنید.

انواع فید پشتیبانی شده

اعتباردهنده انواع فید زیر را پشتیبانی می کند:

  • داده های قبل از انتخابات
  • نتایج انتخابات
  • صاحب دفتر

برای اطمینان از اینکه برخی از قوانین اعتبارسنجی را از دست ندهید، نوع فید خود را با RULE_SET مشخص کنید:

نوع خوراک مقدار RULE_SET
صاحب دفتر OFFICEHOLDER
داده های پیش از انتخابات / نتایج انتخابات ELECTION

سطوح بررسی اعتبار

ابزار اعتبارسنجی فید سه دسته از بررسی ها را اجرا می کند:

  • خطا: در صورت مشاهده هر گونه خطایی، گوگل نمی تواند فایل را تجزیه کند. قبل از ارسال داده های خود، تمام پیام های خطا را از فیدهای خود حذف کنید. اگر برای رسیدگی به پیام‌های خطا به کمک نیاز دارید، یک اشکال را در مؤلفه خود ثبت کنید.

  • اخطار: سناریوهای هشدارهایی که قرار نیست اتفاق بیفتند، تجربیات کاربر خوبی نیستند یا احتمالاً خطاهایی هستند که باید اصلاح شوند. به عنوان مثال، اگر نام نامزدها را با تمام حروف بزرگ ارائه دهید، هشدار داده می شود. سعی کنید همه اخطارهای داده شده را اصلاح کنید و از ما انتظار داشته باشید که اگر اعتبارسنجی هشدارهایی را در یک فید شناسایی کند، سؤالات بعدی بپرسیم.

  • اطلاعات: پیام‌های اطلاعات سناریوهایی را نشان می‌دهند که بر دریافت خودکار فید یا تجربه کاربر تأثیر نمی‌گذارند، اما به کسی کمک می‌کنند طرح‌بندی داده‌های شما را بخوانند و بفهمند. رفع پیام های اطلاعات اختیاری است.