موجودیتهای OfficeholderSubFeed ویژگیهای یک Officeholder Feed را توصیف میکنند. آنها مشخص میکنند که چه مناطق جغرافیایی و سطوح اداری شامل میشوند و چه زمانی محتوای واقعی در Feed در دسترس است.
عناصر
| عنصر | چندگانگی | نوع | توضیحات |
|---|---|---|---|
DebugName | ۰ یا ۱ | string | یک نام توصیفی برای این فیدِ صاحبمنصب. |
OfficeScopeCollection | ۱ | ناموجود | عنصر پوششی برای تعاریف OfficeScope که تمام دفاتر تحت اختیار دارندگان دفتر را در این OfficeholderSubFeed مشخص میکند. |
InitialDeliveryDate | ۱ | PartialDate | وقتی شریک انتظار دارد اولین پیشنویس فید را ارسال کند. |
FullDeliveryDate | ۰ یا ۱ | PartialDate | وقتی فهرست کامل صاحبان مناصب ارائه شود اما برخی از ویژگیها هنوز نهایی نشده باشند. |
ExpectedOfficeholders | ۰ یا ۱ | integer | تعداد غیر صفر صاحبان منصب. یک تخمین تقریبی اشکالی ندارد. اگر تعداد نامعلوم باشد یا اگر اطمینان کمی به تخمین دارید، این موجودیت میتواند خالی باشد. |
مثالها
مثال زیر یک Feed است که شامل یک OfficeholderSubFeed با OfficeScope است. این نشان میدهد که Feed در ژانویه ۲۰۲۴ تحویل داده خواهد شد و شامل Officeholderهای سطح ملی و ایالتی برای استرالیا خواهد بود:
XML
<OfficeholderSubFeed> <DebugName>AU national and state level officeholders</DebugName> <OfficeScopeCollection> <OfficeScope> <DebugName>National level OH</DebugName> <OfficeLevel>Country</OfficeLevel> <JurisdictionOcdId>ocd-division/country:au</JurisdictionOcdId> <OfficeRoles>lower house</OfficeRoles> <OfficeRoles>upper house</OfficeRoles> </OfficeScope> <OfficeScope> <DebugName>South Austria OH</DebugName> <OfficeLevel>Administrative Area 1</OfficeLevel> <JurisdictionOcdId>ocd-division/country:au/state:sa</JurisdictionOcdId> <OfficeRoles>state lower house</OfficeRoles> </OfficeScope> ... </OfficeScopeCollection> <InitialDeliveryDate>2024-01</InitialDeliveryDate> </OfficeholderSubFeed>
جیسون
{ "OfficeholderSubFeed": { "DebugName": "US national level officholders", "OfficeScopeCollection": { "OfficeScope": [ { "DebugName": "National level OH", "OfficeLevel": "Country", "JurisdictionOcdId": "ocd-division/country:au", "OfficeRoles": [ "lower house", "upper house" ] }, { "DebugName": "South Austria OH", "OfficeLevel": "Administrative Area 1", "JurisdictionOcdId": "ocd-division/country:au/state:sa", "OfficeRoles": [ "state lower house" ] } ... ] } "InitialDeliveryDate": "2024-01" } }