Feed

Una entidad Feed representa un solo flujo activo o próximo de archivos de datos del CDF a lo largo del tiempo que corresponden a un país específico y a un tipo de feed del CDF. Para obtener más detalles, consulta Tipos de feeds. Un FeedDeliveryReport puede contener varias entidades Feed para un país y un tipo de feed determinados, siempre que sus alcances no se superpongan, ya sea por alcance geográfico, período o nivel de oficina. A continuación, se muestran ejemplos de combinaciones válidas:

  • Un solo FeedDeliveryReport puede contener tanto un Feed de funcionarios públicos de EE.UU. como un Feed de elecciones previas a las elecciones de EE.UU. (perenne).
  • Un solo FeedDeliveryReport puede contener un Feed previo a las elecciones de EE.UU. (2022) y un Feed previo a las elecciones de EE.UU. (2024).
  • Un solo FeedDeliveryReport puede contener un Feed de las elecciones previas a las elecciones de EE.UU. (solo a nivel federal en 2022) y un Feed de las elecciones previas a las elecciones de EE.UU. (solo a nivel estatal en 2022).
  • Un solo FeedDeliveryReport puede contener un titular de cargo de EE.UU. Feed y un Feed de Japón previo a las elecciones (solo a nivel nacional del 2022), pero solo si ambos países están dentro del alcance.

Un Feed tiene una duración limitada, ya que hay una fecha de finalización esperada (por ejemplo, 60 días después de una elección), o es "perenne", lo que significa que no hay una fecha de finalización esperada y se actualiza continuamente.

Espera hasta 60 días después de la FeedInactiveDate de un feed antes de quitarlo del feed de metadatos.

Elementos

Elemento Multiplicidad Tipo Descripción
FeedId 1 string Es un identificador único y estable para la vida útil del feed. No se puede reutilizar en diferentes feeds.
FeedName 1 string Es una descripción breve del feed, como "Funcionarios públicos de EE.UU. 2023".
FeedType 1 FeedType Indica qué tipo de feed de CDF es.
FeedLongevity 1 FeedLongevity Indica la vida útil del feed.
SourceDirPath 0 o 1 FeedSourcePathUri Es el URI de la ruta de acceso de origen completamente calificado del archivo XML del feed.

Se admiten las siguientes soluciones de hosting de archivos:

  • s3
  • ftp y sftp
  • http y https

Debe ser accesible a través de la misma solución de alojamiento de archivos que el feed de metadatos, pero puede estar vacío antes de que los datos estén listos.
SqsQueueName 0 o 1 string Nombre de la cola de SQS para los feeds con notificaciones push habilitadas. Para obtener más detalles, consulta la guía para desarrolladores de SQS. Si no se establece este parámetro, se extraerán las actualizaciones del feed.
CountryCode 0 o 1 string Es el código de país ISO 3166-1 alpha-2 que abarca este feed. Obligatorio si FeedType no es election-dates o voter-information.
FeedInactiveDate 0 o 1 date Es una fecha en formato ISO-8601 que indica cuándo dejará de actualizarse el feed y cuándo ya no se deberá transferir.
  • En el caso de los feeds de evergreen, lo más probable es que no se deba configurar en absoluto, a menos que el feed esté en desuso.
  • En el caso de los feeds de limited, este valor debe establecerse en dos semanas después de la fecha de finalización del último ElectionEvent del feed o dos semanas después de la última actualización posterior a las elecciones prevista. Ten en cuenta que, si se cancela un ElectionEvent sin actualizaciones esperadas, el FeedInactiveDate puede preceder al EndDate del ElectionEvent.
  • En el caso de los feeds de yearly, al igual que con los feeds de limited, este valor debe establecerse al menos dos semanas después de la fecha de finalización del último ElectionEvent, pero tampoco debe ser anterior a dos semanas después del final del año para el que se genera el feed. Por ejemplo, para un feed del 2024, el valor de FeedInactiveDate debe establecerse en 2025-01-14 en el caso común en el que todas las elecciones hayan finalizado el 2024-12-31 o antes. Se puede establecer incluso más tarde si se posponen las elecciones, si hay segundas vueltas en 2025 o si los eventos electorales continúan en 2025.
IsTest 0 o 1 boolean Indica si el feed es de prueba para simulaciones. Se supone que es false si no se especifica.
ElectionEventCollection 0 o 1 ElectionEvent Contiene información sobre las elecciones que abarca este feed. Esto solo se respeta para los tipos de feeds PRE_ELECTION o ELECTION_RESULTS.
OfficeholderSubFeed 0 o 1 OfficeholderSubFeed Contiene información sobre los funcionarios públicos incluidos en este feed. Esto solo se respeta para el tipo de feed OFFICEHOLDER.