ฟีด

เอนทิตี Feed แสดงถึงสตรีมไฟล์ข้อมูล CDF ที่ใช้งานอยู่หรือกำลังจะมาถึงเพียงรายการเดียวเมื่อเวลาผ่านไป ซึ่งสอดคล้องกับประเทศและประเภทฟีด CDF ที่เฉพาะเจาะจง ดูรายละเอียดเพิ่มเติมได้ที่ประเภทฟีด FeedDeliveryReport สามารถมีเอนทิตี Feed หลายรายการสำหรับประเทศ และประเภทฟีดที่กำหนด ตราบใดที่ขอบเขตของเอนทิตีเหล่านั้นไม่ทับซ้อนกัน ไม่ว่าจะเป็นขอบเขตทางภูมิศาสตร์ กรอบเวลา หรือระดับสำนักงาน ตัวอย่างการผสมผสานที่ถูกต้องมีดังนี้

  • FeedDeliveryReport รายการเดียวสามารถมีทั้ง Feed ของผู้ดำรงตำแหน่งในสหรัฐอเมริกาและ Feed ก่อนการเลือกตั้งในสหรัฐอเมริกา (ตลอดกาล)
  • FeedDeliveryReport รายการเดียวสามารถมี Feed ก่อนการเลือกตั้งในสหรัฐอเมริกา (2022) และ Feed ก่อนการเลือกตั้งในสหรัฐอเมริกา (2024)
  • FeedDeliveryReport รายการเดียวสามารถมี Feed ก่อนการเลือกตั้งในสหรัฐอเมริกา (ระดับรัฐบาลกลางเท่านั้นในปี 2022) และ Feed ก่อนการเลือกตั้งในสหรัฐอเมริกา (ระดับรัฐเท่านั้นในปี 2022)
  • FeedDeliveryReport รายการเดียวสามารถมี Feed ของผู้ดำรงตำแหน่งในสหรัฐอเมริกาและ Feed ก่อนการเลือกตั้งในญี่ปุ่น (ระดับประเทศเท่านั้นในปี 2022) แต่เฉพาะในกรณีที่ทั้ง 2 ประเทศอยู่ในขอบเขต

Feed จะมีระยะเวลาจำกัดเนื่องจากมีวันที่สิ้นสุดที่คาดไว้ (เช่น 60 วันหลังการเลือกตั้ง) หรือเป็น "ตลอดกาล" ซึ่งหมายความว่าไม่มีวันที่สิ้นสุดที่คาดไว้และจะมีการรีเฟรชอย่างต่อเนื่อง

รอจนกว่าจะผ่านไป 60 วันหลังจาก FeedInactiveDate ของฟีดแล้วจึงนำฟีดออกจากฟีดข้อมูลเมตา

องค์ประกอบ

องค์ประกอบ ความหลากหลาย ประเภท คำอธิบาย
FeedId 1 string ตัวระบุที่ไม่ซ้ำกันและเสถียรตลอดอายุการใช้งานของฟีด ใช้ซ้ำในฟีดไม่ได้
FeedName 1 string คำอธิบายสั้นๆ สำหรับฟีด เช่น "ผู้ดำรงตำแหน่งในสหรัฐอเมริกา 2023"
FeedType 1 FeedType ระบุประเภทฟีด CDF
FeedLongevity 1 FeedLongevity ระบุอายุการใช้งานของฟีด
SourceDirPath 0 หรือ 1 FeedSourcePathUri URI เส้นทางแหล่งที่มาที่สมบูรณ์ในตัวเองของไฟล์ XML ของฟีด

ระบบรองรับโซลูชันการโฮสต์ไฟล์ต่อไปนี้

  • s3
  • ftp และ sftp
  • http และ https

ต้องเข้าถึงได้ผ่านโซลูชันการโฮสต์ไฟล์เดียวกับ ฟีดข้อมูลเมตา แต่สามารถเว้นว่างไว้ได้ก่อนที่ข้อมูลจะพร้อม
SqsQueueName 0 หรือ 1 string ชื่อทรัพยากร Amazon (ARN) ที่สมบูรณ์ในตัวเองของคิว SQS สำหรับฟีดที่เปิดใช้ข้อความ Push (เช่น arn:aws:sqs:region:account-id:queue-name) ดูรายละเอียดเพิ่มเติมได้ที่คู่มือนักพัฒนาซอฟต์แวร์ SQS หากไม่ได้ตั้งค่า ระบบจะดึงข้อมูลอัปเดตฟีดแทน
CountryCode 0 หรือ 1 string รหัสประเทศในรูปแบบ ISO 3166-1 Alpha-2 ที่ฟีดนี้ครอบคลุม ต้องระบุหาก FeedType ไม่ใช่ election-dates หรือ voter-information
FeedInactiveDate 0 หรือ 1 date วันที่ในรูปแบบ ISO-8601 ที่ระบุว่าฟีดจะไม่อัปเดตอีกต่อไปและไม่ควรนำเข้าอีกต่อไป
  • สำหรับฟีด evergreen ส่วนใหญ่แล้วไม่ควร ตั้งค่านี้เลย เว้นแต่จะเลิกใช้งานฟีด
  • สำหรับฟีด limited ควรตั้งค่านี้เป็น 2 สัปดาห์ หลังจากวันที่สิ้นสุดของ ElectionEvent ใน ฟีด หรือ 2 สัปดาห์หลังจากที่คาดว่าจะมีการอัปเดตหลังการเลือกตั้งครั้งสุดท้าย โปรดทราบว่าหากมีการยกเลิก ElectionEvent โดยไม่มี การอัปเดตที่คาดไว้ FeedInactiveDate อาจมาก่อน EndDate ของ ElectionEvent
  • สำหรับฟีด yearly เช่นเดียวกับฟีด limited ควรตั้งค่านี้เป็นอย่างน้อย 2 สัปดาห์หลังจากวันที่สิ้นสุด ของ ElectionEvent สุดท้าย แต่ก็ไม่ควร เร็วกว่า 2 สัปดาห์หลังจากสิ้นปีที่ฟีดนั้นมีไว้ ตัวอย่างเช่น สำหรับฟีดปี 2024 ควรตั้งค่า FeedInactiveDate เป็น 2025-01-14 ในกรณีทั่วไปที่ การเลือกตั้งทั้งหมดสิ้นสุดลงในวันที่ 2024-12-31 หรือก่อนหน้านั้น อาจตั้งค่าให้ช้าลงได้หากมีการเลื่อนการเลือกตั้ง หากมีการเลือกตั้งรอบที่ 2 ในปี 2025 หรือหากกิจกรรมการเลือกตั้งดำเนินต่อไปจนถึงปี 2025
IsTest 0 หรือ 1 boolean ระบุว่าฟีดเป็นฟีดทดสอบสำหรับซิมหรือไม่ ระบบจะถือว่าเป็น false หากไม่ได้ระบุ
ElectionEventCollection 0 หรือ 1 ElectionEvent มีข้อมูลเกี่ยวกับการเลือกตั้งที่ฟีดนี้ครอบคลุม ระบบจะพิจารณาข้อมูลนี้สำหรับฟีดประเภท PRE_ELECTION หรือ ELECTION_RESULTS เท่านั้น
OfficeholderSubFeed 0 หรือ 1 OfficeholderSubFeed มีข้อมูลเกี่ยวกับผู้ดำรงตำแหน่งที่ฟีดนี้ครอบคลุม ระบบจะพิจารณาข้อมูลนี้สำหรับฟีดประเภท OFFICEHOLDER เท่านั้น