עדכון

ישויות 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

צריך שתהיה גישה לקובץ הזה דרך אותו פתרון לאירוח קבצים שבו מאוחסן פיד המטא-נתונים, אבל הוא יכול להיות ריק לפני שהנתונים מוכנים.
SqsQueueName ‫0 או 1 string השם של תור SQS לפידים שהופעלו בהם התראות. פרטים נוספים זמינים במדריך למפתחים בנושא SQS. אם לא מגדירים את ההגדרה הזו, המערכת תמשוך את עדכוני הפיד.
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.
IsTest ‫0 או 1 boolean האם הפיד הוא פיד בדיקה של כרטיסי SIM. אם לא מציינים ערך, ברירת המחדל היא false.
ElectionEventCollection ‫0 או 1 ElectionEvent מכיל מידע על בחירות שמסוקרות בפיד הזה. ההגדרה הזו רלוונטית רק לסוגי הפידים PRE_ELECTION או ELECTION_RESULTS.
OfficeholderSubFeed ‫0 או 1 OfficeholderSubFeed מכיל מידע על בעלי התפקידים שמכוסים בפיד הזה. ההגדרה הזו רלוונטית רק לסוג הפיד OFFICEHOLDER.