ฟีด

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

โดยต้องเข้าถึงได้ผ่านโซลูชันการโฮสต์ไฟล์เดียวกันกับฟีดข้อมูลเมตา แต่จะว่างเปล่าก่อนที่ข้อมูลจะพร้อมก็ได้
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 หรือก่อนหน้านั้น โดยอาจตั้งค่าในภายหลังได้หากมีการเลื่อนการเลือกตั้ง หากมีการเลือกตั้งรอบชิง ในปี 2025 หรือหากกิจกรรมการเลือกตั้งยังคงดำเนินต่อไปในปี 2025
ElectionEventCollection 0 หรือ 1 ElectionEvent มีข้อมูลเกี่ยวกับการเลือกตั้งที่ฟีดนี้ครอบคลุม โดยจะใช้ได้กับฟีดประเภท PRE_ELECTION หรือ ELECTION_RESULTS เท่านั้น
OfficeholderSubFeed 0 หรือ 1 OfficeholderSubFeed มีข้อมูลเกี่ยวกับผู้ดำรงตำแหน่งที่ฟีดนี้ครอบคลุม ระบบจะพิจารณาเฉพาะฟีดประเภท OFFICEHOLDER