<localTypeDeclaration>

[SJagodzinski]

Local Type Declaration

• add attributes:
  @audience
@localType
@scriptOfElement
@valueURI
@vocabularySource
@vocabularySourceURI
• review attributes:
  a) remove xml namespace
• keep name and scope

Creator of issue

1. Silke Jagodzinski
2. TS-EAS: EAC-CPF subgroup
3. [email protected]

Related issues / documents

EAD3 Reconciliation

Additional EAD 3 attributes
@altrender - Optional
@audience - Optional (values limited to: external, internal)
@encodinganalog - Optional
@script - Optional

Context

<localTypeDeclaration> is used to declare any local conventions used in @localType in the EAC-CPF instance.

May contain: <abbreviation> , <citation> , <descriptiveNote>
May occur within: <control>
Attributes: @xml:id, @xml:lang - all optional
Availability: Optional, Repeatable

Solution documentation

Rephrasing Summary, Description and Usage and Attribute usage needed?

May contain: <shortCode> , <reference> , <descriptiveNote>
May occur within: <control>
Attributes:
@audience - optional (values limited to: external, internal)
@id - optional
@languageOfElement - optional
@scriptOfElement - optional
@valueURI - optional
@vocabularySource - optional
@vocabularySourceURI - optional
Availability: Optional, repeatable

• New or other example needed
• Topic for Best Practise Guide

Example encoding

<control>
 <recordId>records identifier</recordId>
 <maintenanceStatus value="new"/>
 <publicationStatus value="inprocess"/>
 <maintenanceAgency> [...] </maintenanceAgency>
 <localTypeDeclaration audience="external" id="localTypeDeclaration1" languageOfElement="en" scriptOfElement="lat" valueURI="conventionURI" vocabularySource="source" vocabularySourceURI="sourceURI">
  <shortCode>acronym, abbreviation or short code of the local type</shortCode>
  <reference>externe reference to the local type</reference>
  <descriptiveNote>
   <p>descriptive note for the local type</p>
  </descriptiveNote>
 </localTypeDeclaration>
 <maintenanceHistory>  [...] </maintenanceHistory>
</control>

[ailie-s]

Tag Library Text:

Summary: An optional child element of <control> used to declare any local conventions or controlled vocabularies used in @localType in the EAC-CPF instance.
May contain: <descriptiveNote> (0..1), <reference> (1..1), <shortCode> (0..1)
May occur within:
Attributes:
@audience - optional (values limited to: external, internal)
@id - optional
@languageOfElement - optional
@scriptOfElement - optional
@target - optional
@valueURI - optional
@vocabularySource - optional
@vocabularySourceURI - optional
Description and Usage:
<localTypeDeclaration> specifies the local conventions and controlled vocabularies used in @localType attributes in the EAC-CPF instance.
The child <reference> must be used to cite the resource that lists the local rules or controlled terms. Any notes relating to how these rules or conventions have been used may be given in <descriptiveNote>. The child <shortCode> may be used to identify any abbreviation or code representing the local convention or controlled vocabulary.
It may not be necessary to include <localTypeDeclaration> if @localType values are documented externally.
Availability: Optional, repeatable

[kerstarno]

Tested as part of Schema Team's schema testing:

• <localTypeDeclaration> is an optional sub-element of <control>
• <localTypeDeclaration> can be repeated
• <localTypeDeclaration> requires the sub-element <reference> to be present
• <localTypeDeclaration> furthermore allows for the optional sub-elements <shortCode> and <descriptiveNote>
• None of the sub-element of <localTypeDeclaration> can be repeated
• <localTypeDeclaration> also allows for the optional attributes @audience, @id, @target, @languageOfElement, @scriptOfElement, @valueURI, @vocabularySource, and @vocabularySourceURI
• Lastly, <localTypeDeclaration> allows for optional attributes from other namespaces (tested with XLink)

The above applies to RNG and XSD schemas.

The element is ready.

@ailie-s - the draft TL above is currently missing @target.