Identyfikator zewnętrzny

Element ExternalIdentifier pozwala twórcom kanałów na kojarzenie dowolnych zbiorów pary źródło-wartość z określonymi obiektami. ExternalIdentifier często kod jurysdykcji w systemie zewnętrznym używanym do powiązania obiektów określonych w jurysdykcji, takich jak kandydaci, urzędy czy jednostki geopolityczne.

Pole Type elementu ExternalIdentifier służy do opisywania źródło identyfikatora, a nie identyfikowanego obiektu. Na przykład 2 z tych wbudowane typy to fips. To skrót od „informacji federalnych” Przetwarzanie Standardu i state. Mimo że dwucyfrowe kody FIPS mogą być używany do opisania stanów, docelowa wartość Type w tej sytuacji to fips a nie state. Dzieje się tak, ponieważ fips opisuje źródło identyfikatora.

Identyfikatory zewnętrzne są wykorzystywane w całym pliku danych w tych celach:

  • Podaj stabilny identyfikator.
  • Podaj kanoniczny identyfikator z zasobu zewnętrznego, takiego jak Open Civic Identyfikatory danych lub kod FIPS.
  • Podaj dodatkowe atrybuty, które nie są natywne dla schematu CDF NIST.

Gdy służy do podania dodatkowych danych lub kontekstu obiektu, zewnętrzne dane W identyfikatorach musi być używany element Type o wartości other. Obejmują one również: OtherType i Value, które zależą od rodzaju dostarczonych danych. Dla na przykład tego, jak można udostępniać dane w ten sposób, Office

Atrybuty

W tabeli poniżej znajdziesz atrybuty związane z ExternalIdentifier:

Atrybut Wymagana? Typ Opis
label Opcjonalnie string Etykieta informacyjna. Do użytku w razie potrzeby.

Elementy

Poniższa tabela zawiera elementy odpowiadające kolumnie ExternalIdentifier:

Element Mnogość Typ Opis
Type 1 IdentifierType Podaje typ identyfikatora.
OtherType 0 lub 1 string Używana, gdy wartość IdentifierType wynosi other
Value 1 string Identyfikator używany w danej jurysdykcji.

Przykłady

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