עדכון

ישות 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 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, צריך להגדיר את התאריך הזה לשבועיים אחרי תאריך הסיום של ElectionEvent האחרון בפיד, או לשבועיים אחרי התאריך שבו צפוי להתפרסם העדכון האחרון אחרי הבחירות. שימו לב: אם ElectionEvent בוטלה ולא צפויים עדכונים, יכול להיות שFeedInactiveDate יופיע לפני EndDate עבור ElectionEvent.
  • בפידים של yearly, כמו בפידים של limited, צריך להגדיר את התאריך הזה לפחות שבועיים אחרי תאריך הסיום של ElectionEvent האחרון, אבל גם לא לפני שבועיים אחרי סוף השנה שאליה מתייחס הפיד. לדוגמה, בפיד של שנת 2024, הערך של FeedInactiveDate צריך להיות 2025-01-14 במקרה הנפוץ שבו כל הבחירות הסתיימו בתאריך 2024-12-31 או לפניו. יכול להיות שהתאריך הזה יידחה אם הבחירות יידחו, אם ייערכו סיבובים שניים ב-2025 או אם אירועים שקשורים לבחירות יימשכו עד 2025.
ElectionEventCollection 0 או 1 ElectionEvent מכיל מידע על בחירות שמוצגות בפיד הזה. ההגדרה הזו רלוונטית רק לסוגי הפידים PRE_ELECTION או ELECTION_RESULTS.
OfficeholderSubFeed 0 או 1 OfficeholderSubFeed מכיל מידע על בעלי התפקידים שמכוסים בפיד הזה. ההגדרה הזו רלוונטית רק לסוג הפיד OFFICEHOLDER.