Identificador externo

La entidad ExternalIdentifier permite que los creadores de feeds asocien conjuntos arbitrarios de pares fuente-valor con ciertos objetos. ExternalIdentifier suele ser un código de jurisdicción en un sistema externo que se usa para asociar una jurisdicción con objetos como candidatos, cargos o unidades geopolíticas.

El campo Type de una entidad ExternalIdentifier se usa para describir la fuente del identificador, no el objeto que se identifica. Por ejemplo, dos de los tipos integrados son fips, una abreviatura del código "Federal Information Processing Standard" y state. Aunque los códigos de dos dígitos del FIPS se pueden usar para describir estados, el valor de Type previsto para esta situación es fips y no state. Esto se debe a que fips describe la fuente del identificador.

Los identificadores externos se usan en todo el feed para los siguientes fines:

  • Proporciona un identificador estable.
  • Proporciona un identificador canónico desde un recurso externo, como los identificadores de datos cívicos abiertos o el código del FIPS.
  • Proporciona atributos adicionales que no sean nativos del esquema de CDF del NIST.

Cuando se usan para proporcionar datos o contexto adicionales para un objeto, los identificadores externos deben usar un Type de other. También incluyen un OtherType y un Value que dependen del tipo de datos que se proporcionan. Para ver un ejemplo de cómo se pueden proporcionar los datos de esta manera, consulta Office.

Atributos

En la siguiente tabla, se describen los atributos de ExternalIdentifier:

Atributo ¿Es obligatorio? Tipo Descripción
label Opcional string Una etiqueta informativa. Para uso según sea necesario.

Elementos

En la siguiente tabla, se muestran los elementos de ExternalIdentifier:

Elemento Multiplicidad Tipo Descripción
Type 1 IdentifierType Proporciona un tipo de identificador.
OtherType 0 o 1 string Se usa cuando el valor de IdentifierType es other.
Value 1 string Es el identificador que usa la jurisdicción.

Ejemplos

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"
        }
      ]
    }