office¶
Office
represents the office associated with a contest or district (e.g. Alderman, Mayor,
School Board, et al).
Tag | Data Type | Required? | Repeats? | Description | Error Handling |
---|---|---|---|---|---|
contact_information_id | xs:IDREF |
Optional | Repeats | Links to the contact_information element associated with the office. | If the element is invalid or not present, then the implementation is required to ignore it. |
description | xs:string |
Optional | Single | A brief description of the office and its purpose. | If the element is invalid or not present, then the implementation is required to ignore it. |
electoral_district_id | xs:IDREF |
Required | Single | Links to the electoral_district element associated with the office. | If the field is invalid or not present,
the implementation is required to ignore
the Office element containing it. |
external_identifiers | xs:IDREF |
Optional | Single | Other identifiers that link this office to other related datasets (e.g. campaign finance systems, OCD IDs, et al.). | If the element is invalid or not present, then the implementation is required to ignore it. |
filing_deadline | xs:date |
Optional | Single | Specifies the date and time when a candidate must have filed for the contest for the office. | If the field is invalid or not present, then the implementation is required to ignore it. |
is_partisan | xs:boolean |
Optional | Single | Indicates whether the office is partisan. | If the field is invalid or not present, then the implementation is required to ignore it. |
name | xs:string |
Required | Single | The name of the office. | If the field is invalid or not present,
the implementation is required to ignore
the Office element containing it. |
office_holder_person_ids | xs:IDREFS |
Optional | Single | Links to the person element(s) that hold additional information about the current office holder(s). | If the field is invalid or not present, then the implementation is required to ignore it. |
term | term | Optional | Single | Defines the term the office can be held. | If the element is invalid or not present, then the implementation is required to ignore it. |
1 2 3 4 | id,electoral_district_id,external_identifier_type,external_identifier_othertype,external_identifier_value,filing_deadline,is_partisan,name,office_holder_person_ids,term_type,term_start_date,term_end_date
off001,ed001,,,,,true,Deputy Chief of Staff,per50003,full-term,2002-01-21,
off002,ed001,,,,,true,Deputy Deputy Chief of Staff,per50001,unexpired-term,2002-01-21,
off003,ed001,,,,,false,General Secretary of Secretaries,per50004,full-term,2002-01-21,
|
term¶
Tag | Data Type | Required? | Repeats? | Description | Error Handling |
---|---|---|---|---|---|
term_type | office_term_type | Optional | Single | Specifies the type of office term (see office_term_type for valid values). | If the field is invalid or not present,
the implementation is required to ignore
the Office element containing it. |
term_start_date | xs:date |
Optional | Single | Specifies the start date for the current term of the office. | If the field is invalid or not present, then the implementation is required to ignore it. |
term_end_date | xs:date |
Optional | Single | Specifies the end date for the current term of the office. | If the field is invalid or not present, then the implementation is required to ignore it. |
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
|