עדכון

ישויות 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 שם המשאב המוגדר במלואו (ARN) של תור ה-SQS עבור פידים עם הפעלת התראות פוש (לדוגמה, arn:aws:sqs:region:account-id:queue-name). פרטים נוספים זמינים במדריך למפתחים בנושא 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 האם הפיד הוא פיד בדיקה לסימולציות. אם לא מציינים ערך, ברירת המחדל היא false.
ElectionEventCollection 0 או 1 ElectionEvent מכיל מידע על בחירות שמסוקרות בפיד הזה. ההגדרה הזו רלוונטית רק לסוגי הפידים PRE_ELECTION או ELECTION_RESULTS.
OfficeholderSubFeed 0 או 1 OfficeholderSubFeed מכיל מידע על בעלי התפקידים שמכוסים בפיד הזה. ההגדרה הזו רלוונטית רק לסוג הפיד OFFICEHOLDER.