Feed

Una entidad Feed representa una sola transmisión activa o próxima de archivos de datos de CDF a lo largo del tiempo que corresponden a un país específico y a un tipo de feed de 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 cargo. Los siguientes son ejemplos de combinaciones válidas:

  • Un solo FeedDeliveryReport puede contener un Feed de funcionarios electos de EE.UU. y un Feed de antes de las elecciones de EE.UU. (perdurable).
  • Un solo FeedDeliveryReport puede contener un Feed de antes de las elecciones de EE.UU. (2022) y un Feed de antes de las elecciones de EE.UU. (2024).
  • Un solo FeedDeliveryReport puede contener un Feed de antes de las elecciones de EE.UU. (solo a nivel federal) y un Feed de antes de las elecciones de EE.UU. (solo a nivel estatal).
  • Un solo FeedDeliveryReport puede contener un Feed de funcionarios electos de EE.UU. y un Feed de antes de las elecciones de Japón (solo a nivel nacional en 2022), pero solo si ambos países están dentro del alcance.

Un Feed tiene una duración limitada porque hay una fecha de finalización prevista (por ejemplo, 60 días después de una elección) o es "perdurable", lo que significa que no hay una fecha de finalización prevista 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 Un identificador único y estable para la vida útil del feed. No se puede volver a usar en los feeds.
FeedName 1 string Una breve descripción del feed, como "Funcionarios electos de EE.UU. 2023".
FeedType 1 FeedType Indica de qué tipo de feed de CDF se trata.
FeedLongevity 1 FeedLongevity Indica la vida útil del feed.
SourceDirPath 0 o 1 FeedSourcePathUri URI de la ruta de acceso de origen completamente calificada del archivo en formato XML del feed.

Se admiten las siguientes soluciones de hosting de archivos:

  • s3
  • ftp y sftp
  • http y https

Se debe poder acceder a este a través de la misma solución de hosting 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 El nombre de recurso de Amazon (ARN) completamente calificado de la cola de SQS para feeds con notificaciones push habilitadas (por ejemplo, arn:aws:sqs:region:account-id:queue-name). Para obtener más detalles, consulta la Guía para desarrolladores de SQS. Si no se configura, se extraerán las actualizaciones del feed.
CountryCode 0 o 1 string El código de país ISO 3166-1 alpha-2 que abarca este feed. Es obligatorio si FeedType no es election-dates ni voter-information.
FeedInactiveDate 0 o 1 date Una fecha en formato ISO-8601 que indica cuándo dejará de actualizarse el feed y ya no se debe ingerir.
  • En el caso de los feeds evergreen, lo más probable es que no se deba configurar en absoluto a menos que se dé de baja el feed.
  • En el caso de los feeds limited, se debe configurar dos semanas después de la fecha de finalización del último ElectionEvent en el feed o dos semanas después de que se espere la última actualización posterior a las elecciones. Ten en cuenta que, si se cancela un ElectionEvent sin actualizaciones previstas, la FeedInactiveDate puede preceder a la EndDate del ElectionEvent.
  • En el caso de los feeds yearly, al igual que con los feeds limited, se debe configurar al menos dos semanas después de la fecha de finalización del último ElectionEvent, pero tampoco debe ser antes de dos semanas después del final del año para el que es el feed. Por ejemplo, para un feed de 2024, la 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 configurar incluso más tarde si se posponen las elecciones, si se realizan segundas vueltas en 2025 o si los eventos electorales continúan en 2025.
IsTest 0 o 1 boolean Indica si el feed es un feed 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 feed PRE_ELECTION o ELECTION_RESULTS.
OfficeholderSubFeed 0 o 1 OfficeholderSubFeed Contiene información sobre los funcionarios electos que abarca este feed. Esto solo se respeta para el tipo de feed OFFICEHOLDER.