[Major revision] Updates to <access> and its subelements

Provide a general summary of the issue in the Title above. Delete the part of the issue template that does not apply depending on whether you describe a change to an existing element / attribute or the addition of a new one.

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

Changes to existing element / attribute

Give the current name of the element / attribute. Include the tag name and the full name. Name: <access>, <restaccess>, <termsOfUse>

Change in name

Indicate any changes in name. New name:

Rename <restaccess> to <accessConditions>
Rename <termsOfUse> to <useConditions>

Change in context

List all parent elements to which the element / attribute should be added. Furthermore, list all parent elements from which the element / attribute should be removed.

Remove from

Parent element(s): Remove <access> from <repository>

Add to

Parent element(s): Add <access> to <description> (1..n)

Change in availability

For elements, give an indication of their changed availability within each affected parent element ("1..1" for required but not repeatable, "1 (or another number)..n" for required and repeatable, "0..1" for optional but not repeatable", "0..n" for optional and repeatable). For added attributes, indicate their changed availability with "1" for required or "0" for optional within each affected parent element. Changed availability: <access> remains mandatory, but becomes repeatable; <access> has to appear after <places> and before all other sub-elements of <description>

Change in content model (elements)

List all sub-elements and attributes that should be removed from or added to the element's content model.

Remove

Sub-element(s): Remove <restaccess> and <termsOfUse> from <access> Attributes (with default values, if applicable): Remove @xml:lang and @source from <restaccess> - respectively the renamed <accessConditions> - and <termsOfUse> - respectively the renamed <useConditions> (see details for replacement below)

Add

Sub-element(s): Add <accessConditions> and <useConditions> to <access> (both 0..n) Attributes (with default values, if applicable):

Extend the values predefined for the attribute @question with <access> by including "yes (conditions apply)"
Add @audience with values "external", "internal" (0), @id (0), @languageOfElement (0), @scriptOfElement (0), @target (0); @conventionDeclarationReference (0), @maintenanceEventReference (0), @sourceReference (0); option to include attributes from any other namespace to <access>, <accessConditions>, and <useConditions>
In the cases of <accessConditions> and <useConditions>, @languageOfElement replaces @xml:lang and @sourceReference replaces @source (from <restaccess> and <termsOfUse>)
Add @href, @linkRole, and @linkTitle to <access>
Also add @linkRole and @linkTitle to <accessConditions> and <useConditions> and move @href over from <restaccess> and <termsOfUse> appropriately

For conversion, the current encoding

<access question="[yes or no]">
  <restaccess xml:lang="[language of restaccess1]" source="[source of restaccess1]" href="[link for restaccess1]">restaccess1</restaccess>
  <restaccess xml:lang="[language of restaccess2]" source="[source of restaccess2]" href="[link for restaccess2]">restaccess2</restaccess>
  <termsOfUse xml:lang="[language of termsOfUse1]" source="[source of termsOfUse1]" href="[link for termsOfUse1]">termsOfUse1</termsOfUse>
  <termsOfUse xml:lang="[language of termsOfUse2]" source="[source of termsOfUse2]" href="[link for termsOfUse2]">termsOfUse2</termsOfUse>
</access>

becomes

<control>
  [...]
  <sources>
    <source id="source1">
      <reference>source of restaccess1</reference>
    </source>
    <source id="source2">
      <reference>source of restaccess2</reference>
    </source>
    <source id="source3">
      <reference>source of termsOfUse1</reference>
    </source>
    <source id="source4">
      <reference>source of termsOfUse2</reference>
    </source>
  </sources>
  [...]
</control>
[...]
<access question="[yes or no]">
  <accessConditions languageOfElement="[language of restaccess1]" sourceReference="#source1" href="[link for restaccess1]">restaccess1</accessConditions>
  <accessConditions languageOfElement="[language of restaccess2]" sourceReference="#source2" href="[link for restaccess2]">restaccess2</accessConditions>
  <useConditions languageOfElement="[language of termsOfUse1]" sourceReference="#source3" href="[link for termsOfUse1]">termsOfUse1</useConditions>
  <useConditions languageOfElement="[language of termsOfUse2]" sourceReference="#source4" href="[link for termsOfUse2]">termsOfUse2</useConditions>
</access>

ArchivesPortalEuropeFoundation / EAG2012