Person

Person defines information about a person. The person may be a candidate, election administrator, or elected official. These elements reference Person:

Tag

Data Type

Required?

Repeats?

Description

Error Handling

ContactInformation

ContactInformation

Optional

Repeats

Refers to the associated ContactInformation.

If the element is invalid or not present, then the implementation is required to ignore it.

DateOfBirth

xs:date

Optional

Single

Represents the individual’s date of birth.

If the field is invalid or not present, then the implementation is required to ignore it.

ExternalIdentifiers

ExternalIdentifiers

Optional

Single

Identifiers for this person.

If the element is invalid or not present, then the implementation is required to ignore it.

FirstName

xs:string

Optional

Single

Represents an individual’s first name.

If the field is invalid or not present, then the implementation is required to ignore it.

FullName

InternationalizedText

Optional

Single

Specifies a person’s full name (NB: this information is InternationalizedText because it sometimes appears on ballots in multiple languages).

If the element is invalid or not present, then the implementation is required to ignore it.

Gender

xs:string

Optional

Single

Specifies a person’s gender.

If the field is invalid or not present, then the implementation is required to ignore it.

LastName

xs:string

Optional

Single

Represents an individual’s last name.

If the field is invalid or not present, then the implementation is required to ignore it.

MiddleName

xs:string

Optional

Repeats

Represents any number of names between an individual’s first and last names (e.g. John Ronald Reuel Tolkien).

If the field is invalid or not present, then the implementation is required to ignore it.

Nickname

xs:string

Optional

Single

Represents an individual’s nickname.

If the field is invalid or not present, then the implementation is required to ignore it.

PartyId

xs:IDREF

Optional

Single

Refers to the associated Party. This information is intended to be used by feed consumers to help them disambiguate the person’s identity, but not to be presented as part of any ballot information. For that see Candidate PartyId.

If the field is invalid or not present, then the implementation is required to ignore it.

Prefix

xs:string

Optional

Single

Specifies a prefix associated with a person (e.g. Dr.).

If the field is invalid or not present, then the implementation is required to ignore it.

Profession

InternationalizedText

Optional

Single

Specifies a person’s profession (NB: this information is InternationalizedText because it sometimes appears on ballots in multiple languages).

If the element is invalid or not present, then the implementation is required to ignore it.

Suffix

xs:string

Optional

Single

Specifies a suffix associated with a person (e.g. Jr.).

If the field is invalid or not present, then the implementation is required to ignore it.

Title

InternationalizedText

Optional

Single

A title associated with a person (NB: this information is InternationalizedText because it sometimes appears on ballots in multiple languages).

If the element is invalid or not present, then the implementation is required to ignore it.

 1<Person id="per50001">
 2   <ContactInformation label="ci60002">
 3     <Email>rwashburne@albemarle.org</Email>
 4     <Phone>4349724173</Phone>
 5   </ContactInformation>
 6   <FirstName>RICHARD</FirstName>
 7   <LastName>WASHBURNE</LastName>
 8   <MiddleName>J.</MiddleName>
 9   <Nickname>JAKE</Nickname>
10   <Title>
11     <Text language="en">General Registrar Physical</Text>
12   </Title>
13</Person>

ContactInformation

For defining contact information about objects such as persons, boards of authorities, organizations, etc. ContactInformation is always a sub-element of another object (e.g. ElectionAdministration, Office, Person, Source). ContactInformation has an optional attribute label, which allows the feed to refer back to the original label for the information (e.g. if the contact information came from a CSV, label may refer to a row ID).

Tag

Data Type

Required?

Repeats?

Description

Error Handling

AddressLine

xs:string

Optional

Repeats

The “location” portion of a mailing address. See usage note.

If the field is invalid or not present, then the implementation is required to ignore it.

Directions

InternationalizedText

Optional

Single

Specifies further instructions for locating this entity.

If the element is invalid or not present, then the implementation is required to ignore it.

Email

xs:string

Optional

Repeats

An email address for the contact.

If the field is invalid or not present, then the implementation is required to ignore it.

Fax

xs:string

Optional

Repeats

A fax line for the contact.

If the field is invalid or not present, then the implementation is required to ignore it.

Hours [deprecated]

InternationalizedText

Optional

Single

Contains the hours (in local time) that the location is open (NB: this element is deprecated in favor of the more structured :ref:`multi-xml-hours-open` element. It is strongly encouraged that data providers move toward contributing hours in this format).

If the element is invalid or not present, then the implementation is required to ignore it.

HoursOpenId

xs:IDREF

Optional

Single

References an HoursOpen element, which lists the hours of operation for a location.

If the field is invalid or not present, then the implementation is required to ignore it.

LatLng

LatLng

Optional

Single

Specifies the latitude and longitude of this entity.

If the element is invalid or not present, then the implementation is required to ignore it.

Name

xs:string

Optional

Single

The name of the location or contact. See usage note.

If the field is invalid or not present, then the implementation is required to ignore it.

Phone

xs:string

Optional

Repeats

A phone number for the contact.

If the field is invalid or not present, then the implementation is required to ignore it.

Uri

xs:anyURI

Optional

Repeats

An informational URI for the contact or location.

If the field is invalid or not present, then the implementation is required to ignore it.

Name and AddressLine Usage Note

The Name and AddressLine fields should be chosen so that a display or mailing address can be constructed programmatically by joining the Name and AddressLine fields together. For example, for the following address:

Department of Elections
1 Dr. Carlton B. Goodlett Place, Room 48
San Francisco, CA 94102

The name could be “Department of Elections” and the first address line could be “1 Dr. Carlton B. Goodlett Place, Room 48.”

However, VIP does not yet support the representation of mailing addresses whose “name” portion spans more than one line, for example:

California Secretary of State
Elections Division
1500 11th Street
Sacramento, CA 95814

For addresses like the above, we recommend choosing a name like, “California Secretary of State, Elections Division” with “1500 11th Street” as the first address line. This would result in a programmatically constructed address like the following:

California Secretary of State, Elections Division
1500 11th Street
Sacramento, CA 95814
1<ContactInformation label="ci10861a">
2   <AddressLine>1600 Pennsylvania Ave</AddressLine>
3   <AddressLine>Washington, DC 20006</AddressLine>
4   <Email>president@whitehouse.gov</Email>
5   <Phone>202-456-1111</Phone>
6   <Phone annotation="TDD">202-456-6213</Phone>
7   <Uri>http://www.whitehouse.gov</Uri>
8</ContactInformation>