Công cụ xác thực nguồn cấp dữ liệu

Chúng tôi duy trì một trình xác thực nguồn cấp dữ liệu nguồn mở được thiết kế để cung cấp phản hồi cụ thể, thiết thực ngoài việc xác thực XML đơn giản. Trình xác thực được cung cấp thông qua công cụ quản lý gói Python tiêu chuẩn:

bash:~$ pip install civics_cdf_validator

Ví dụ sau đây minh hoạ cách sử dụng:

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

Để biết danh sách các lệnh phổ biến, hãy xem README.

Các loại nguồn cấp dữ liệu được hỗ trợ

Trình xác thực hỗ trợ các loại nguồn cấp dữ liệu sau đây:

  • Dữ liệu trước bầu cử
  • Kết quả bầu cử
  • Viên chức

Để đảm bảo bạn không bỏ lỡ một số quy tắc xác thực, hãy chỉ định loại nguồn cấp dữ liệu bằng RULE_SET:

Loại nguồn cấp dữ liệu Giá trị RULE_SET
Viên chức OFFICEHOLDER
Dữ liệu trước bầu cử / Kết quả bầu cử ELECTION

Các cấp kiểm tra xác thực

Công cụ xác thực nguồn cấp dữ liệu chạy ba lớp kiểm tra:

  • Lỗi: Nếu bạn thấy bất kỳ lỗi nào, thì Google không thể phân tích cú pháp của tệp đó. Khử tất cả thông báo lỗi trong nguồn cấp dữ liệu trước khi bạn gửi dữ liệu. Nếu bạn cần để xử lý thông báo lỗi, báo cáo lỗi trong thành phần của bạn.

  • Cảnh báo: Các tình huống gắn cờ cảnh báo không nên xảy ra trải nghiệm người dùng tuyệt vời hoặc có thể là lỗi cần khắc phục. Cho ví dụ: hệ thống sẽ đưa ra cảnh báo nếu bạn cung cấp tên ứng cử viên bằng CHỮ HOA TOÀN BỘ CHỮ IN HOA. Hãy cố gắng khắc phục tất cả các cảnh báo được đưa ra và chờ chúng tôi hỏi những câu hỏi tiếp theo liên quan đến việc trình xác thực có xác định được các cảnh báo trong một nguồn cấp dữ liệu hay không.

  • Thông tin: Thông báo thông tin cho biết các trường hợp không ảnh hưởng đến truyền dẫn nguồn cấp dữ liệu hoặc trải nghiệm người dùng nhưng giúp người dùng đọc và hiểu bố cục của dữ liệu. Bạn không bắt buộc phải sửa thông báo thông tin.