[Major revision] Updates to <recordId>

kerstarno commented 4 years ago

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

<recordId>, the description identifier, is a mandatory, not repeatable sub-element of <control>. It can contain text, which - in EAG 2012 - is restricted to follow the structure defined by ISO 15511, and allows for an optional @source attribute to be used.

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.

In the context of alignment with EAC-CPF and EAD, the restriction on <recordId> following a specific format is lifted, i.e. the content of <recordId> can be any text and doesn't have to comply to ISO 15511 anymore. However, there is another restriction set for <recordId> in as far as the element cannot be empty. Furthermore, the optional attributes @audience (with values "external" and "internal"), @id, @target, @languageOfElement, and @scriptOfElement, as well as an option to include an attribute from any other namespace are added, while the attribute @source is removed without replacement. As <recordId> is meant to carry the description identifier used within the system where the EAG file resides, the source of such identifier will always be this system, hence it would seem unnecessary to mention the source specifically in this case.

Change requests from the community

This section lists change requests sent in by the community.

n/a

Encoding examples from the community

Please include your examples below.

<recordId>
</recordId>

kerstarno commented 4 years ago

An updated encoding for the element <recordId> could then look like this:

<control>
 <recordId audience="external" id="e3" target="e2"
 languageOfElement="spa" scriptOfElement="Latn">12345</recordId>
</control>

kerstarno commented 1 year ago

With EAG 2012 being more restrictive than EAG 3.0, the conversion for <recordId> itself should be straight forward. If @source exists in EAG 2012, this will be removed during conversion without replacement. It might be worth considering an according note to be added in the converted file.

If @source indicates that the <recordId> stems from a system other than the current holding system, the content of <recordId> should actually be moved into a new <otherRecordId>, where the value of @source could then be used as the value of @vocabularySource. In this case, the conversion should create a new <recordId> according to the rules set up for the description identifier by the current holding system.

ArchivesPortalEuropeFoundation / EAG2012