[Major revision] <control>

[kerstarno]

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 (@countryEncoding SAA-SDT/eac-cpf-schema#120), date encoding (@dateEncoding SAA-SDT/eac-cpf-schema#124), language encoding (@languageEncoding SAA-SDT/eac-cpf-schema#121), repository encoding (@repositoryEncoding SAA-SDT/eac-cpf-schema#122) and script encoding (@scriptEncoding SAA-SDT/eac-cpf-schema#126) are to be added. Furthermore, the optional attributes @audience (@audience SAA-SDT/eac-cpf-schema#119), @base (@xml:base SAA-SDT/eac-cpf-schema#149), @id (@xml:id SAA-SDT/eac-cpf-schema#150), @target (@target SAA-SDT/eac-cpf-schema#216), @languageOfElement (@xml:lang SAA-SDT/eac-cpf-schema#151), @scriptOfElement (@scriptOfElement SAA-SDT/eac-cpf-schema#152) are to be made available with <control>. A new optional attribute @detailLevel (@detailLevel SAA-SDT/eac-cpf-schema#274) is to be added.
• The element <maintenanceStatus> is to be removed and replaced by a new required attribute @maintenanceStatus (@maintenanceStatus SAA-SDT/eac-cpf-schema#155), while the element <publicationStatus> is to be removed and replaced by a new optional attribute @publicationStatus (@publicationStatus SAA-SDT/eac-cpf-schema#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)

[kerstarno]

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.

[kerstarno]

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>.