Identificadores estáveis

Identificadores estáveis são um identificador exclusivo externo estável para um determinado objeto. Eles permitem que os consumidores de dados reconciliem objetos em um formato de dados comum (CDF) com outros repositórios de dados. Na linguagem do banco de dados, os identificadores são uma forma de chave externa que permite que os consumidores de dados vinculem objetos em um feed CDF para outros bancos de dados.

Por exemplo, se "Robert Brady" é um candidato, um consumidor de dados pode não imediatamente vinculam essa pessoa a "Bob Brady" no banco de dados de imagens. No entanto, os dados de CDF e o banco de dados de imagens podem indicar que essa pessoa está legislador 01469, conforme identificado pelo banco de dados THOMAS da Biblioteca do Congresso. Depois, o consumidor de dados pode vincular a imagem ao candidato.

As condições a seguir precisam ser atendidas para todos os identificadores estáveis:

  • Estabilidade:o identificador estável de uma determinada entidade exclusiva, como um Person ou Party, não podem ser alterados nas diferentes versões dos dados se alimentam. Em outras palavras, o ID estável não pode mudar ao longo do tempo para um com uma entidade conhecida.
  • Exclusividade:nunca reutilize um identificador estável para uma entidade diferente, mesmo se a entidade original não estiver mais no feed.
  • Consistência:é preciso usar o mesmo conjunto de identificadores estáveis para candidatos, partidos ou distritos para ambas as simulações, se necessário, e durante o ciclo eleitoral.

Formatação de dados

Forneça os identificadores estáveis no seguinte formato:

<ExternalIdentifier>
  <Type>other</Type>
  <OtherType>stable</OtherType>
  <Value>match the regex ^[a-zA-Z0-9_-]+$</Value>
</ExternalIdentifier>

Alguns bons exemplos de IDs estáveis são os identificadores únicos universais (UUIDs) e Identificadores exclusivos globais (GUIDs, na sigla em inglês). Elas terão esta aparência:

e55b7dd4-cc98-11ec-9d64-0242ac120002

Para melhorar a legibilidade dos dados, é melhor adicionar mais prefixos e e sufixos para dividir ainda mais as entidades. Por exemplo, adicione o prefixo per- pessoas ou off- para escritórios como IDs estáveis não devem estar em conformidade com nenhuma padrão.

Recomendado:per-e55b7dd4-cc98-11ec-9d64-0242ac120002

Recomendado:off-7849514a-e8bc-11ec-8fea-0242ac120002

Recomendado:por 123456789012345

Não recomendado:por joão-silva

  • Risco: outra pessoa com o mesmo nome pode ter o mesmo ID.
  • Risco: a alteração nos dados pode afetar o ID estável.

Não recomendado:off-presidento-of-us

Onde usar IDs estáveis

Os identificadores estáveis são obrigatórios para os seguintes elementos: