עדכון

ישות Feed מייצגת זרם יחיד של קובצי נתוני CDF פעילים או עתידיים לאורך זמן, שתואמים למדינה ספציפית ולסוג פיד CDF. פרטים נוספים זמינים במאמר סוגי פידים. FeedDeliveryReport יכול להכיל כמה ישויות Feed למדינה ולסוג פיד נתונים מסוימים, כל עוד ההיקפים שלהן לא חופפים, בין אם לפי היקף גיאוגרפי, מסגרת זמן או רמת המשרד. דוגמאות לשילובים תקינים:

  • FeedDeliveryReport אחת יכולה להכיל גם Feed של בעלי תפקידים בארה"ב וגם Feed של בחירות בארה"ב (תמיד רלוונטית).
  • FeedDeliveryReport אחד יכול להכיל Feed לפני הבחירות בארה"ב (2022) וFeed לפני הבחירות בארה"ב (2024).
  • FeedDeliveryReport אחד יכול להכיל Feed בנושא בחירות בארה"ב לפני הבחירות (2022 ברמה הפדרלית בלבד) וFeed בנושא בחירות בארה"ב לפני הבחירות (2022 ברמת המדינה בלבד).
  • מודעה אחת FeedDeliveryReport יכולה להכיל מודעה בנושא בחירות בארה"ב Feed ומודעה בנושא בחירות ביפן Feed (ברמה הלאומית בלבד, 2022), אבל רק אם שתי המדינות כלולות בהיקף.

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, צריך להגדיר את התאריך הזה לשבועיים אחרי תאריך הסיום של ElectionEvent האחרון בפיד, או לשבועיים אחרי התאריך שבו צפוי להתפרסם העדכון האחרון אחרי הבחירות. הערה: אם ElectionEvent בוטל ולא צפויים עדכונים, יכול להיות שFeedInactiveDate יופיע לפני EndDate עבור ElectionEvent.
  • בפידים של yearly, כמו בפידים של limited, צריך להגדיר את התאריך הזה לפחות שבועיים אחרי תאריך הסיום של ElectionEvent האחרון, אבל גם לא לפני שבועיים אחרי סוף השנה שאליה מתייחס הפיד. לדוגמה, בפיד של 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