Identificatori stabili

Gli identificatori stabili sono un identificatore unico stabile esternamente per un determinato . Consentono ai consumatori dei dati di riconciliare gli oggetti in un formato dati comune (CDF) con altri repository di dati. Nel gergo dei database, Gli identificatori sono una forma di chiave esterna che consente ai consumatori di dati di collegare di oggetti in un feed CDF ad altri database.

Ad esempio, se "Robert Brady" un candidato, un consumatore di dati potrebbe non collegare immediatamente quella persona a "Bob Brady" nel proprio database di immagini. Tuttavia, i dati CDF e il database delle immagini potrebbero indicare che questa persona legislatore 01469 come identificato nel database della Biblioteca del Congresso THOMAS. Poi il consumatore dei dati può collegare l'immagine al candidato.

Per tutti gli identificatori stabili devono essere soddisfatte le seguenti condizioni:

  • Stabilità: l'identificatore stabile per una determinata entità univoca, ad esempio un Person o Party, non devono cambiare tra versioni diverse dei dati feed. In altre parole, l'ID stabile non deve cambiare nel tempo per uno specifico dell'oggetto.
  • Unicità: non riutilizzare mai un identificatore stabile per un'entità diversa, nemmeno se l'entità originale non è più presente nel feed.
  • Coerenza: devi utilizzare lo stesso insieme di identificatori stabili per candidati, partiti o distretti per entrambe le simulazioni, se necessario, e durante il ciclo elettorale.

Formattazione dei dati

Fornisci gli identificatori stabili nel seguente formato:

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

Alcuni buoni esempi di ID stabili sono gli identificatori univoci universali (UUID) e Identificatori univoci globali (GUID). L'URL potrebbe avere il seguente aspetto:

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

Per migliorare la leggibilità dei dati, è preferibile aggiungere prefissi e per suddividere ulteriormente le entità. Ad esempio, aggiungi il prefisso per- a persone o off- per uffici come documenti di identità stabili non devono essere conformi a qualsiasi standard.

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

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

Consigliato: per-123456789012345

Sconsigliato:per-mario-rossi

  • Rischio: un'altra persona con lo stesso nome potrebbe avere lo stesso ID.
  • Rischio: la modifica dei dati potrebbe influire sull'ID stabile.

Sconsigliato:fuori dal presidente

Dove utilizzare gli ID stabili

Gli identificatori stabili sono obbligatori per i seguenti elementi: