.. This file is auto-generated. Do not edit it by hand!
.. _multi-xml-person:
Person
======
``Person`` defines information about a person. The person may be a candidate, election administrator,
or elected official. These elements reference ``Person``:
* :ref:`multi-xml-candidate`
* :ref:`multi-xml-election-administration`
* :ref:`multi-xml-office`
+---------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| Tag | Data Type | Required? | Repeats? | Description | Error Handling |
+=====================+=========================================+==============+==============+==========================================+==========================================+
| ContactInformation | :ref:`multi-xml-contact-information` | Optional | Repeats | Refers to the associated | |
| | | | | :ref:`multi-xml-contact-information`. | |
+---------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| DateOfBirth | ``xs:date`` | Optional | Single | Represents the individual's date of | |
| | | | | birth. | |
+---------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| ExternalIdentifiers | :ref:`multi-xml-external-identifiers` | Optional | Single | Identifiers for this person. | |
+---------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| FirstName | ``xs:string`` | Optional | Single | Represents an individual's first name. | |
+---------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| FullName | :ref:`multi-xml-internationalized-text` | Optional | Single | Specifies a person's full name (**NB:** | |
| | | | | this information is | |
| | | | | :ref:`multi-xml-internationalized-text` | |
| | | | | because it sometimes appears on ballots | |
| | | | | in multiple languages). | |
+---------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| Gender | ``xs:string`` | Optional | Single | Specifies a person's gender. | |
+---------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| LastName | ``xs:string`` | Optional | Single | Represents an individual's last name. | |
+---------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| MiddleName | ``xs:string`` | Optional | Repeats | Represents any number of names between | |
| | | | | an individual's first and last names | |
| | | | | (e.g. John **Ronald Reuel** Tolkien). | |
+---------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| Nickname | ``xs:string`` | Optional | Single | Represents an individual's nickname. | |
+---------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| PartyId | ``xs:IDREF`` | Optional | Single | Refers to the associated | |
| | | | | :ref:`multi-xml-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 :ref:`multi-xml-candidate` | |
| | | | | **PartyId**. | |
+---------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| Prefix | ``xs:string`` | Optional | Single | Specifies a prefix associated with a | |
| | | | | person (e.g. Dr.). | |
+---------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| Profession | :ref:`multi-xml-internationalized-text` | Optional | Single | Specifies a person's profession (**NB:** | |
| | | | | this information is | |
| | | | | :ref:`multi-xml-internationalized-text` | |
| | | | | because it sometimes appears on ballots | |
| | | | | in multiple languages). | |
+---------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| Suffix | ``xs:string`` | Optional | Single | Specifies a suffix associated with a | |
| | | | | person (e.g. Jr.). | |
+---------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| Title | :ref:`multi-xml-internationalized-text` | Optional | Single | A title associated with a person | |
| | | | | (**NB:** this information is | |
| | | | | :ref:`multi-xml-internationalized-text` | |
| | | | | because it sometimes appears on ballots | |
| | | | | in multiple languages). | |
+---------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
.. code-block:: xml
:linenos:
rwashburne@albemarle.org
4349724173
RICHARD
WASHBURNE
J.
JAKE
<Text language="en">General Registrar Physical</Text>
.. _multi-xml-contact-information:
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.
:ref:`multi-xml-election-administration`, :ref:`multi-xml-office`,
:ref:`multi-xml-person`, :ref:`multi-xml-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. :ref:`See usage note. | |
| | | | | ` | |
+------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| Directions | :ref:`multi-xml-internationalized-text` | Optional | Single | Specifies further instructions for | |
| | | | | locating this entity. | |
+------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| Email | ``xs:string`` | Optional | Repeats | An email address for the contact. | |
+------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| Fax | ``xs:string`` | Optional | Repeats | A fax line for the contact. | |
+------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| Hours | :ref:`multi-xml-internationalized-text` | Optional | Single | Contains the hours (in local time) that | |
| **[deprecated]** | | | | 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)*. | |
+------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| HoursOpenId | ``xs:IDREF`` | Optional | Single | References an | |
| | | | | :ref:`multi-xml-hours-open` element, | |
| | | | | which lists the hours of operation for a | |
| | | | | location. | |
+------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| LatLng | :ref:`multi-xml-lat-lng` | Optional | Single | Specifies the latitude and longitude of | |
| | | | | this entity. | |
+------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| Name | ``xs:string`` | Optional | Single | The name of the location or contact. | |
| | | | | :ref:`See usage note. | |
| | | | | ` | |
+------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| Phone | ``xs:string`` | Optional | Repeats | A phone number for the contact. | |
+------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
| Uri | ``xs:anyURI`` | Optional | Repeats | An informational URI for the contact or | |
| | | | | location. | |
+------------------+-----------------------------------------+--------------+--------------+------------------------------------------+------------------------------------------+
.. _multi-xml-name-address-line-usage:
``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
.. code-block:: xml
:linenos:
1600 Pennsylvania Ave
Washington, DC 20006
president@whitehouse.gov
202-456-1111
202-456-6213
http://www.whitehouse.gov