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 |
|---|---|---|---|---|---|
| contact_information_id | xs:IDREF |
Optional | Repeats | Refers to the associated contact_information. | If the element is invalid or not present, then the implementation is required to ignore it. |
| date_of_birth | 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. |
| external_identifiers | external_identifiers | Optional | Single | Identifiers for this person. | If the element is invalid or not present, then the implementation is required to ignore it. |
| first_name | 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. |
| full_name | xs:string |
Optional | Single | Specifies a person’s full name (NB: this information is internationalized_text 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. |
| last_name | 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. |
| middle_name | 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. |
| party_id | 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 | xs:string |
Optional | Single | Specifies a person’s profession (NB: this information is internationalized_text 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 | xs:string |
Optional | Single | A title associated with a person (NB: this information is internationalized_text 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 2 3 4 5 | id,date_of_birth,first_name,gender,last_name,middle_name,nickname,party_id,prefix,profession,suffix,title
per50001,1961-08-04,Barack,male,Obama,Hussein,,par02,,President,II,Mr. President
per50002,1985-11-21,Carly,female,Jepsen,Rae,,par01,,Recording Artist,,
per50003,1926-09-23,John,male,Coltrane,William,Trane,par02,,Recording Artist,Saint,
per50004,1926-05-26,Miles,male,Davis,Dewey,,par01,,Recording Artist,III,
|
contact_information¶
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.
election_administration, 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 |
|---|---|---|---|---|---|
| address_line | 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 | xs:string |
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. |
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 | xs:string |
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-csv-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. |
| hours_open_id | xs:IDREF |
Optional | Single | References an hours_open 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. |
| lat_long | lat_long | 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. |
1 2 3 | id,address_line_1,address_line_2,address_line_3,directions,email,fax,hours,hours_open_id,latitude,longitude,latlng_source,name,phone,uri,parent_id
ci0827,The White House,1600 Pennsylvania Ave,,,josh@example.com,,Early to very late,,,,,Josh Lyman,555-111-2222,http://lemonlyman.example.com,off001
ci0828,The White House,1600 Pennsylvania Ave,,,josh@example.com,,Early to very late,,,,,Josh Lyman,555-111-2222,http://lemonlyman.example.com,vs01
|