Identificatore esterno

L'entità ExternalIdentifier consente agli autori di feed di associare insiemi arbitrari di in coppia valore-origine con determinati oggetti. ExternalIdentifier è un di una giurisdizione in un sistema esterno utilizzato per associare giurisdizione con oggetti quali candidati, cariche o unità geopolitiche.

Il campo Type di un'entità ExternalIdentifier viene utilizzato per descrivere: source dell'identificatore, non dell'oggetto da identificare. Ad esempio, due di i tipi integrati sono fips, un'abbreviazione di "Federal Information" Standard di elaborazione" codice e state. Anche se i codici FIPS a due cifre possono essere utilizzato per descrivere gli stati, il valore Type previsto per questa situazione è fips e non state. Questo perché fips descrive la fonte dell'identificatore.

Gli identificatori esterni vengono utilizzati in tutto il feed per i seguenti scopi:

  • Fornisci un identificatore stabile.
  • Fornisci un identificatore canonico da una risorsa esterna, come Open Civic Identificatori di dati o codice FIPS.
  • Fornisci attributi aggiuntivi che non sono nativi dello schema CDF del NIST.

Quando utilizzato per fornire dati o contesto aggiuntivi per un oggetto, identificatori devono usare un Type di other. Includono anche OtherType e un valore Value, entrambi dipendono dal tipo di dati forniti. Per un esempio di come i dati possono essere forniti in questo modo, vedi Office

Attributi

Nella tabella seguente vengono descritti gli attributi per ExternalIdentifier:

Attributo Obbligatorio? Tipo Descrizione
label Facoltativo string Un'etichetta informativa. Da utilizzare in base alle esigenze.

Elementi

La seguente tabella mostra gli elementi per ExternalIdentifier:

Elemento Molteplicità Tipo Descrizione
Type 1 IdentifierType Fornisce un tipo di identificatore.
OtherType 0 o 1 string Utilizzato quando il valore di IdentifierType è other.
Value 1 string L'identificatore utilizzato dalla giurisdizione.

Esempi

XML

    <ExternalIdentifiers>
     <ExternalIdentifier>
        <Type>other</Type>
        <OtherType>stable</OtherType>
        <Value>stable-gu-0081</Value>
      </ExternalIdentifier>
      <ExternalIdentifier>
        <Type>ocd-id</Type>
        <Value>ocd-division/country:ke/county:narok</Value>
      </ExternalIdentifier>
      <ExternalIdentifier>
        <Type>national-level</Type>
        <Value>33</Value>
      </ExternalIdentifier>
    </ExternalIdentifiers>

JSON

    "ExternalIdentifiers": {
      "ExternalIdentifier" : [
        {
          "Type": "other",
          "OtherType": "stable",
          "Value": "stable-gu-0081"
        },
        {
          "Type": "ocd-id",
          "Value": "ocd-division/country:ke/county:narok"
        },
        {
          "Type": "national-level",
          "Value": "33"
        }
      ]
    }