ExternalIdentifiers

The ExternalIdentifiers element allows VIP data to connect with external datasets (e.g. candidates with campaign finance datasets, electoral geographies with OCD-IDs that allow for greater connectivity with additional datasets, etc...). Examples for ExternalIdentifiers can be found on the objects that support them:

Tag Data Type Required? Repeats? Description Error Handling
ExternalIdentifier ExternalIdentifier Required Repeats Defines the identifier and the type of identifier it is (see ExternalIdentifier for complete information). At least one valid ExternalIdentifier must be present for ExternalIdentifiers to be valid. If no valid ExternalIdentifier is present, the implementation is required to ignore the ExternalIdentifiers element.

ExternalIdentifier

Tag Data Type Required? Repeats? Description Error Handling
Type IdentifierType Required Single Specifies the type of identifier. Must be one of the valid types as defined by IdentifierType. If the field is invalid or not present, the implementation is required to ignore the ElectionIdentifier containing it.
OtherType xs:string Optional Single Allows for cataloging an ExternalIdentifier type that falls outside the options listed in IdentifierType. Type should be set to “other” when using this field. If the field is invalid or not present, then the implementation is required to ignore it.
Value xs:string Required Single Specifies the identifier. If the field is invalid or not present, the implementation is required to ignore the ElectionIdentifier containing it.
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
<ExternalIdentifiers>
   <ExternalIdentifier>
      <Type>ocd-id</Type>
      <Value>ocd-division/country:us/state:nc/county:durham</Value>
   </ExternalIdentifier>
   <ExternalIdentifier>
      <Type>FIPS</Type>
      <Value>37063</Value>
   </ExternalIdentifier>
   <ExternalIdentifier>
      <Type>OTHER</Type>
      <OtherType>GNIS</OtherType>
      <Value>1008550</Value>
   </ExternalIdentifier>
   <external_identifer>
      <Type>OTHER</Type>
      <OtherType>census</OtherType>
      <Value>99063</Value>
   </ExternalIdentifier>
</ExternalIdentifiers>