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 multi-csv-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 multi-csv-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 multi-csv-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 |
multi-csv-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. |
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,
Tag |
Data Type |
Required? |
Repeats? |
Description |
Error Handling |
term_type |
multi-csv-office-term-type |
Optional |
Single |
Specifies the type of office term (see multi-csv-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. |
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. multi-csv-election-administration
, multi-csv-office
, multi-csv-person
, multi-csv-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.
<multi-csv-name-address-line-usage> |
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. |
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 |
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 multi-csv-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 |
multi-csv-lat-lng |
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.
<multi-csv-name-address-line-usage> |
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. |
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