ฟีด

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 string ตัวระบุที่ไม่ซ้ำกันและเสถียรสำหรับอายุการใช้งานของฟีด ใช้ซ้ำในฟีดไม่ได้ 1
ชื่อฟีด FeedName string คำอธิบายสั้นๆ สำหรับฟีด เช่น "ผู้ดำรงตำแหน่งในสหรัฐอเมริกา ปี 2023" 1
ประเภทฟีด FeedType FeedType ระบุประเภทฟีด CDF 1
อายุการใช้งานของฟีด FeedLongevity FeedLongevity ระบุอายุการใช้งานของฟีด 1
ตำแหน่งฟีด SourceDirPath string URI ที่มีคุณสมบัติครบถ้วนของไฟล์ XML ของฟีด (รองรับเฉพาะ ftp และ http) ต้องเข้าถึงได้ผ่านโซลูชันการโฮสต์ไฟล์เดียวกันกับฟีดข้อมูลเมตา (แต่จะว่างเปล่าก่อนที่ข้อมูลจะพร้อมก็ได้) 0 หรือ 1
รหัสประเทศ CountryCode string รหัสประเทศ ISO 3166-1 alpha-2 ที่ฟีดนี้ครอบคลุม ต้องระบุหาก FeedType ไม่ใช่ election-dates หรือ voter-information 0 หรือ 1
วันที่ฟีดไม่ได้ใช้งาน FeedInactiveDate 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 หรือก่อนหน้านั้น โดยอาจตั้งค่าในภายหลังได้หากมีการเลื่อนการเลือกตั้ง หากมีการเลือกตั้งรอบชิง ในปี 2025 หรือหากกิจกรรมการเลือกตั้งยังคงดำเนินต่อไปในปี 2025
0 หรือ 1
การรวบรวมเหตุการณ์การเลือกตั้ง ElectionEventCollection ElectionEvent มีข้อมูลเกี่ยวกับการเลือกตั้งที่ฟีดนี้ครอบคลุม โดยจะใช้ได้กับฟีดประเภท PRE_ELECTION หรือ ELECTION_RESULTS เท่านั้น 0 หรือ 1
ฟีดย่อยของเจ้าหน้าที่ OfficeholderSubFeed OfficeholderSubFeed มีข้อมูลเกี่ยวกับผู้ดำรงตำแหน่งที่ฟีดนี้ครอบคลุม ระบบจะพิจารณาเฉพาะฟีดประเภท OFFICEHOLDER 0 หรือ 1