[Major revision] <control>

Creator of issue

State your name, organisation and ways to reach you. Name: Kerstin Arnold Organisation: Archives Portal Europe Foundation, Working Group on Standards Email: standards@archivesportaleurope.net GitHub username (if applicable): @kerstarno

Current status

In EAG 2012, <control> is a mandatory, not repeatable sub-element of the root element <eag>. It includes the sub-elements <recordId> (mandatory), <otherRecordId> (optional), <maintenanceAgency> (mandatory), <maintenanceStatus> (mandatory), <maintenanceHistory> (mandatory), <languageDeclarations> (optional), <conventionDeclaration> (optional), <localControl> (optional), <localTypeDeclaration> (optional), <publicationStatus> (optional), <sources> (optional) and no attributes.

EAC-CPF / EAD3 reconciliation

This section relates the revision of EAG 2012 to the ongoing major revision of the related standard EAC-CPF. There also might be references to the expected major revision of EAD3 in future.

For reconciliation with EAC-CPF and EAD, optional attributes to define ISO standards for country encoding (https://github.com/SAA-SDT/eac-cpf-schema/issues/120), date encoding (https://github.com/SAA-SDT/eac-cpf-schema/issues/124), language encoding (https://github.com/SAA-SDT/eac-cpf-schema/issues/121), repository encoding (https://github.com/SAA-SDT/eac-cpf-schema/issues/122) and script encoding (https://github.com/SAA-SDT/eac-cpf-schema/issues/126) are to be added. Furthermore, the optional attributes @audience (https://github.com/SAA-SDT/eac-cpf-schema/issues/119), @base (https://github.com/SAA-SDT/eac-cpf-schema/issues/149), @id (https://github.com/SAA-SDT/eac-cpf-schema/issues/150), @target (https://github.com/SAA-SDT/eac-cpf-schema/issues/216), @languageOfElement (https://github.com/SAA-SDT/eac-cpf-schema/issues/151), @scriptOfElement (https://github.com/SAA-SDT/eac-cpf-schema/issues/152) are to be made available with <control>. A new optional attribute @detailLevel (https://github.com/SAA-SDT/eac-cpf-schema/issues/274) is to be added.
The element <maintenanceStatus> is to be removed and replaced by a new required attribute @maintenanceStatus (https://github.com/SAA-SDT/eac-cpf-schema/issues/155), while the element <publicationStatus> is to be removed and replaced by a new optional attribute @publicationStatus (https://github.com/SAA-SDT/eac-cpf-schema/issues/156). Furthermore, the plural element <languageDeclarations> is to be removed and the repeatable (and optional) <languageDeclaration> element is to be made available directly in <control> (same as the other <...Declaration> elements). Last, the element <localControl> is to be removed without a replacement.
The sequence of sub-elements is to be changed as follows:
- Fixed order for -
- <recordId> (mandatory, not repeatable)
- <maintenanceAgency> (mandatory, not repeatable)
- <maintenanceHistory> (mandatory, not repeatable)
- <sources> (optional, not repeatable)
- Flexible order for -
- <conventionDeclaration> (optional, repeatable)
- <languageDeclaration> (optional, repeatable)
- <localTypeDeclaration> (optional, repeatable)
- <otherRecordId> (optional, repeatable)
- <rightsDeclaration> (optional, repeatable)

An updated encoding for the element <control> (with indication of mandatory and optional sub-elements) could then look like this:

<control maintenanceStatus="new" audience="external" base="http://censoarchivos.mcu.es/CensoGuia/" 
id="e2" target="cD1" languageOfElement="spa" scriptOfElement="Latn" publicationStatus="inProcess" detailLevel="extended" countryEncoding="iso3166-1" dateEncoding="iso8601" languageEncoding="ietf-bcp-47" 
repositoryEncoding="iso15511" scriptEncoding="iso15924">
 <recordId>...</recordId>
 <maintenanceAgency>
  <agencyCode>...</agencyCode>
  <agencyName>...</agencyName>
 </maintenanceAgency>
 <maintenanceHistory>
  <maintenanceEvent>
   <agent agentType="human">...</agent>
   <eventDateTime>...</eventDateTime>
  </maintenanceEvent>
 </maintenanceHistory>
 <sources>
  <source>...</source>
 </sources>
 <otherRecordId>...</otherRecordId>
 <languageDeclaration languageCode="..." scriptCode="..."/>
 <conventionDeclaration>
  <reference>...</reference>
 </conventionDeclaration>
 <rightsDeclaration>
  <reference>...</reference>
 </rightsDeclaration>
 <localTypeDeclaration>
  <reference>...</reference>
 </localTypeDeclaration>
</control>

Subject to further review and decision of the Archives Portal Europe Foundation's Working Group on Standards.

For conversion, the main aspects to keep in mind are:

Turning <maintenanceStatus> and, if used, <publicationStatus> into attributes of <control> using the elements' contents as the attributes' values.
Moving any <languageDeclaration> elements that might exist out of <languageDeclarations> and directly into <control>, while removing the plural wrapper element <languageDeclarations>.
Removing <localControl> without any replacement. If possible, have the conversion script add a note about this removal.
Making sure, the elements appear in the newly prescribed order. This is likely to mainly affect <otherRecordId>, which now can only appear after <recordId>, <maintenanceAgency>, <maintenanceHistory> and <sources>, and <sources>, which should now appear before the optional and repeatable elements <conventionDeclaration>, <languageDeclaration>, <localTypeDeclaration>, <otherRecordId>, and <rightsDeclaration>.

ArchivesPortalEuropeFoundation / EAG2012