Externer Bezeichner

Mit der Entität ExternalIdentifier können Feedersteller beliebige Gruppen von Quell/Wert-Paare mit bestimmten Objekten. ExternalIdentifier ist häufig den Code der Gerichtsbarkeit in einem externen System, das zur Verknüpfung Rechtsordnung mit Objekten wie Kandidaten, Ämtern oder geopolitischen Einheiten.

Mit dem Feld Type einer ExternalIdentifier-Entität wird Folgendes beschrieben: Quelle der ID, nicht des identifizierten Objekts. Beispiel: Zwei der Die integrierten Typen sind fips, eine Abkürzung für „Federal Information“ Verarbeitungsstandard“ Code und state. Obwohl zweistellige FIPS-Codes zur Beschreibung von Stadien. Der vorgesehene Type-Wert in dieser Situation ist fips. und nicht state. Das liegt daran, dass fips die Quelle der ID beschreibt.

Externe IDs werden im gesamten Feed für folgende Zwecke verwendet:

  • Geben Sie eine stabile Kennung an.
  • Geben Sie eine kanonische Kennung von einer externen Ressource wie Open Civic an Daten-IDs oder FIPS-Code
  • Geben Sie zusätzliche Attribute an, die im NIST-CDF-Schema nicht nativ sind.

Wird verwendet, um zusätzliche Daten oder Kontext für ein Objekt bereitzustellen, werden externe IDs müssen als Type other verwendet werden. Sie enthalten auch eine OtherType und einem Value, die beide vom Typ der bereitgestellten Daten abhängen. Für eine Ein Beispiel dafür, wie Daten auf diese Weise bereitgestellt werden können, finden Sie unter Office

Attribute

In der folgenden Tabelle werden die Attribute für ExternalIdentifier beschrieben:

Attribut Erforderlich/Optional? Typ Beschreibung
label Optional string Ein informatives Label. Zur Verwendung bei Bedarf.

Elemente

In der folgenden Tabelle sind die Elemente für ExternalIdentifier aufgeführt:

Element Multiplizität Typ Beschreibung
Type 1 IdentifierType Stellt einen Kennungstyp bereit.
OtherType 0 oder 1 string Wird verwendet, wenn der Wert von IdentifierType gleich other.
Value 1 string Die von der Gerichtsbarkeit verwendete Kennung.

Beispiele

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