INTERNET-DRAFT S. Legg
draft-legg-xed-asd-xerei-00.txt eB2Bcom
Intended Category: Standards Track April 12, 2005
ASN.1 Schema Representation for XER Encoding Instructions
Copyright (C) The Internet Society (2005).
Status of this Memo
By submitting this Internet-draft, each author represents that any
applicable patent or other IPR claims of which he or she is aware
have been or will be disclosed, and any of which he or she becomes
aware will be disclosed, in accordance with Section 6 of BCP 79.
By submitting this Internet-draft, I accept the provisions of Section
3 of BCP 78.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that
other groups may also distribute working documents as
Internet-Drafts.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress".
The list of current Internet-Drafts can be accessed at
http://www.ietf.org/1id-abstracts.html
The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html
Technical discussion of this document should take place on the XED
developers mailing list <xeddev@eb2bcom.com>. Please send editorial
comments directly to the editor <steven.legg@eb2bcom.com>. Further
information is available on the XED website: www.xmled.info.
This Internet-Draft expires on 12 October 2005.
Abstract
ASN.1 Schema is a semantically equivalent Extensible Markup Language
(XML) representation for Abstract Syntax Notation One (ASN.1)
specifications. This document specifies the ASN.1 Schema
Legg Expires 12 October 2005 [Page 1]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
representation for the XML Encoding Rules (XER) encoding
instructions.
Legg Expires 12 October 2005 [Page 2]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . 4
3. EncodingInstructionAssignmentList Translation. . . . . . . . . 5
4. EncodingInstruction Translation. . . . . . . . . . . . . . . . 6
4.1. TargetList Translation . . . . . . . . . . . . . . . . . 6
4.1.1. TypeIdentification Translation . . . . . . . . . 6
4.1.2. BuiltInTypeIdentification Translation. . . . . . 8
4.1.3. IdentifiersInContext Translation . . . . . . . . 9
4.1.4. ImportedTypesIdentification Translation. . . . . 9
4.2. NamespaceRestriction Translation . . . . . . . . . . . . 10
4.3. AnyAttributesInstruction Translation . . . . . . . . . . 10
4.4. AnyElementInstruction Translation. . . . . . . . . . . . 11
4.5. AttributeInstruction Translation . . . . . . . . . . . . 11
4.6. Base64Instruction Translation. . . . . . . . . . . . . . 11
4.7. DecimalInstruction Translation . . . . . . . . . . . . . 11
4.8. DefaultForEmptyInstruction Translation . . . . . . . . . 11
4.9. ElementInstruction Translation . . . . . . . . . . . . . 11
4.10. EmbedValuesInstruction Translation . . . . . . . . . . . 12
4.11. ListInstruction Translation. . . . . . . . . . . . . . . 12
4.12. NameInstruction Translation. . . . . . . . . . . . . . . 12
4.13. NamespaceInstruction Translation . . . . . . . . . . . . 12
4.14. PIOrCommentInstruction Translation . . . . . . . . . . . 13
4.15. TextInstruction Translation. . . . . . . . . . . . . . . 13
4.16. UntaggedInstruction Translation. . . . . . . . . . . . . 13
4.17. UseNilInstruction Translation. . . . . . . . . . . . . . 14
4.18. UseNumberInstruction Translation . . . . . . . . . . . . 14
4.19. UseOrderInstruction Translation. . . . . . . . . . . . . 14
4.20. UseQNameInstruction Translation. . . . . . . . . . . . . 14
4.21. UseTypeInstruction Translation . . . . . . . . . . . . . 14
4.22. UseUnionInstruction Translation. . . . . . . . . . . . . 14
4.23. WhiteSpaceInstruction Translation. . . . . . . . . . . . 14
5. Parameterized Definitions. . . . . . . . . . . . . . . . . . . 15
5.1. Pre-processing Step. . . . . . . . . . . . . . . . . . . 15
5.2. Translation Step . . . . . . . . . . . . . . . . . . . . 18
5.3. Post-processing Step . . . . . . . . . . . . . . . . . . 20
6. Security Considerations. . . . . . . . . . . . . . . . . . . . 22
7. IANA Considerations. . . . . . . . . . . . . . . . . . . . . . 23
Appendix A. ASN.1 for XER Encoding Instruction Notation. . . . . . 23
Appendix B. ASN.1 Schema for XER Encoding Instruction Notation . . 31
Normative References . . . . . . . . . . . . . . . . . . . . . . . 52
Informative References . . . . . . . . . . . . . . . . . . . . . . 53
Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 53
Full Copyright Statement . . . . . . . . . . . . . . . . . . . . . 54
1. Introduction
Legg Expires 12 October 2005 [Page 3]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
ASN.1 Schema [ASD] is a semantically equivalent Extensible Markup
Language (XML) [XML] representation for Abstract Syntax Notation One
(ASN.1) [X.680] specifications. The ASN.1 Schema representation for
the ASN.1 basic notation [X.680] [X.680-1] is described elsewhere
[ASD].
The grammar of ASN.1 also permits the application of encoding
instructions [X.680-1], through type prefixes and encoding control
sections, that modify how abstract values are encoded by nominated
encoding rules.
The generic notation for type prefixes and encoding control sections
is defined by the ASN.1 basic notation, however the notation for
specific encoding instructions i.e., the
EncodingInstructionAssignmentList and EncodingInstruction productions
of the notation, are defined separately for each set of encoding
rules using encoding instructions. This document specifies the
ASN.1 Schema representation for EncodingInstructionAssignmentList and
EncodingInstruction as they are defined for the XML Encoding Rules
(XER) [X.693][X.693-1].
ASN.1 Schema is defined in terms of rules for translating from an
ASN.1 specification. This does not preclude an ASN.1 Schema document
being written directly without a pre-existing ASN.1 specification,
however such an ASN.1 Schema document is considered valid if and only
if there exists in principle an ASN.1 specification which when
translated would yield the ASN.1 Schema document.
By design, an ASN.1 Schema document is also the Robust XML Encoding
Rules (RXER) [RXER] encoding of an ASN.1 abstract value. The ASN.1
type definitions for such abstract values, insofar as they pertain to
the ASN.1 basic notation, are provided elsewhere [ASD], however this
document provides the ASN.1 type definitions for representing XER
encoding instructions as abstract values. These definitions appear
in Appendix A.
The ASN.1 Schema translation of the ASN.1 module in Appendix A is
presented in Appendix B.
2. Conventions
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY" and "OPTIONAL" in this
document are to be interpreted as described in, BCP 14, RFC 2119
[BCP14].
A reference to an ASN.1 production [X.680] (e.g., Type, NamedType) is
a reference to the text in an ASN.1 specification corresponding to
Legg Expires 12 October 2005 [Page 4]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
that production.
The description of the translation of XER encoding instructions into
ASN.1 Schema makes use of definitions from the XML Information Set
(Infoset) [ISET]. In particular, information item property names are
presented per the Infoset, e.g., [local name]. In the sections that
follow, the term "element" shall be taken to mean an Infoset element
information item and "attribute" shall be taken to mean an Infoset
attribute information item.
The [namespace name] of any element or attribute generated by the
translation from an ASN.1 specification has no value unless specified
otherwise.
3. EncodingInstructionAssignmentList Translation
As described in the specification for ASN.1 Schema [ASD], the
translation of an EncodingControlSection for XER is an element with
the [local name] "encodingControl-XER". The translation of the
EncodingInstructionAssignmentList in such an EncodingControlSection
determines the content of the <encodingControl-XER> element.
If the EncodingInstructionAssignmentList contains an
EncodingInstruction that is a PositiveInstruction that is a
GlobalDefaultsInstruction where the DefaultSetting is "MODIFIED-
ENCODINGS" then an attribute with the [local name]
"modifiedEncodings" and [normalized value] "true" or "1" SHALL be
added to the [attributes] of the <encodingControl-XER> element.
otherwise an attribute with the [local name] "modifiedEncodings" and
[normalized value] "false" or "0" MAY be added to the [attributes] of
the <encodingControl-XER> element.
If the EncodingInstructionAssignmentList contains an
EncodingInstruction that is a PositiveInstruction that is a
GlobalDefaultsInstruction where the DefaultSetting is a
ControlNamespace then the translation of the ControlNamespace SHALL
be added to the [children] of the <encodingControl-XER> element.
The translation of a ControlNamespace is an element with the
[local name] "controlNamespace". An attribute with the [local name]
"name" SHALL be added to the [attributes] of the <controlNamespace>
element. The [normalized value] of this attribute is the Uniform
Resource Identifier (URI) [URI] in the QuotedURI in the
ControlNamespace. If the ControlNamespace contains a Prefix then an
attribute with the [local name] "prefix" SHALL be added to the
[attributes] of the <controlNamespace> element. The
[normalized value] of this attribute is the NCName in the
QuotedNCName in the Prefix.
Legg Expires 12 October 2005 [Page 5]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
The translation of each EncodingInstruction in the
EncodingInstructionAssignmentList, excluding any
GlobalDefaultsInstruction, is appended to the [children] of the
<encodingControl-XER> element.
4. EncodingInstruction Translation
The translation of an EncodingInstruction for XER can appear in the
translation of an EncodingInstructionAssignmentList (see the previous
section) or an EncodingPrefix. The translation for an EncodingPrefix
is described by the specification for ASN.1 Schema [ASD].
The translation of an EncodingInstruction is the translation of the
contained PositiveInstruction or NegatingInstruction.
The translation of a PositiveInstruction is the translation of the
contained AnyAttributeInstruction, AnyElementInstruction,
AttributeInstruction, Base64Instruction, DecimalInstruction,
DefaultForEmptyInstruction, EmbedValuesInstruction, ListInstruction,
NameInstruction, NamespaceInstruction, PIOrCommentInstruction,
TextInstruction, UntaggedInstruction, UseNilInstruction,
UseNumberInstruction, UseOrderInstruction, UseQNameInstruction,
UseTypeInstruction, UseUnionInstruction or WhitespaceInstruction.
ASIDE: A GlobalDefaultsInstruction is ignored here. It is
considered in Section 4.
The translation of a NegatingInstruction that is an
ElementInstruction is the translation of that ElementInstruction.
The translation of a NegatingInstruction that is not an
ElementInstruction is an element with the [local name] "not". The
translation of the PositiveInstruction in the NegatingInstruction
SHALL be added to the [children] of the <not> element.
4.1. TargetList Translation
The TargetList production is common to all the encoding instructions.
The translation of a TargetList is the concatenation of the
translations of each of the contained Targets.
The translation of a Targets is an element with the [local name]
"target". The content of the <target> element is the translation of
the contained TypeIdentification, BuiltInTypeIdentification,
IdentifiersInContext or ImportedTypesIdentification.
4.1.1. TypeIdentification Translation
Legg Expires 12 October 2005 [Page 6]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
The translation of a TypeIdentification of the "ALL" form is an
element with the [local name] "allTypes", otherwise the translation
of a TypeIdentification is the translation of the
ModuleAndTypeReference followed by the translation of the
ComponentReference, if present, followed by the translation of the
QualifyingInformationPart, if present.
The translation of a ModuleAndTypeReference is an attribute with the
[local name] "type". The [normalized value] of this attribute is the
qualified name corresponding to the typereference in the
ModuleAndTypeReference (see Section 5.1 of [ASD]).
The translation of a ComponentReference is an attribute with the
[local name] "component" and, if the final ComponentId in the
ComponentIdList in the ComponentReference is "ALL", an element with
the [local name] "allTextuallyPresent". The [normalized value] of
the attribute is a "/" (U+002F) separated list of the translations of
the ComponentId instances, excluding "ALL" if present.
If a ComponentId identifies the Type in a NamedType then the
translation of the ComponentId is the RXER encoding [RXER] of the
effective name [RXEREI] of the NamedType. If the NamedType is
subject to an RXER ATTRIBUTE or ATTRIBUTE-REF encoding instruction
[RXEREI] then a "@" (U+0040) character is prefixed to the
translation.
If a ComponentId identifies a Type that is not in a NamedType (the
component type for a SEQUENCE OF or SET OF type) then the translation
of the ComponentId is the character string "item".
If a ComponentId does not identify a Type and the ComponentId is an
identifier then the translation of the ComponentId is the identifier.
If a ComponentId does not identify a Type and the ComponentId is "*"
then the translation of the ComponentId is the character string
"item".
The translation of a QualifyingInformationPart is the translation of
the contained QualifyingInformation.
The translation of a QualifyingInformation of the "identifier" form
is an element with the [local name] "identifier". An attribute with
the [local name] "name" SHALL be added to the [attributes] of the
<identifier> element. If the ModuleTypeAndReference and
ComponentReference (if present) identify a BIT STRING, ENUMERATED, or
INTEGER type where the associated BitStringType, EnumeratedType or
IntegerType (respectively) is subject to an RXER VALUES encoding
instruction then the [normalized value] of the attribute is the
Legg Expires 12 October 2005 [Page 7]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
replacement name [RXEREI] for the identifier, otherwise the
[normalized value] is the identifier.
The translation of a QualifyingInformation of the "ALL" form is an
element with the [local name] "allIdentifiers".
4.1.2. BuiltInTypeIdentification Translation
The translation of a BuiltInTypeIdentification is the translation of
the BuiltInTypeName followed by the translation of the
BuiltInTypeQualifyingInformationPart, if present.
If the BuiltInTypeName is "BIT STRING", "BOOLEAN",
"CHARACTER STRING", "EMBEDDED PDV", "EXTERNAL", "GeneralizedTime",
"INTEGER", "NULL", "ObjectDescriptor", "OBJECT IDENTIFIER",
"OCTET STRING", "REAL", "RELATIVE-OID" or "UTCTime" then the
translation of the BuiltInTypeName is an attribute with the
[local name] "type". The [normalized value] of this attribute is a
qualified name with the namespace name being
"http://xmled.info/ns/ASN.1" and the local part being the
BuiltInTypeName with any white space separators replaced by a single
hyphen character (U+002D), e.g. BIT STRING becomes BIT-STRING.
If the BuiltInTypeName is a RestrictedCharacterStringType then the
translation of the BuiltInTypeName is an attribute with the
[local name] "type". The [normalized value] of this attribute is a
qualified name with the namespace name being
"http://xmled.info/ns/ASN.1" and the local part being the
RestrictedCharacterStringType, i.e., BMPString, GeneralString,
GraphicString, IA5String, ISO646String, NumericString,
PrintableString, TeletexString, T61String, UniversalString,
UTF8String, VideotexString or VisibleString.
If the BuiltInTypeName is "CHOICE" then the translation of the
BuiltInTypeName is an element with the [local name] "choice".
If the BuiltInTypeName is "ENUMERATED" then the translation of the
BuiltInTypeName is an element with the [local name] "enumerated".
If the BuiltInTypeName is "INSTANCE OF" then the translation of the
BuiltInTypeName is an element with the [local name] "instanceOf".
If the BuiltInTypeName is "SEQUENCE" then the translation of the
BuiltInTypeName is an element with the [local name] "sequence".
If the BuiltInTypeName is "SEQUENCE OF" then the translation of the
BuiltInTypeName is an element with the [local name] "sequenceOf".
Legg Expires 12 October 2005 [Page 8]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
If the BuiltInTypeName is "SET" then the translation of the
BuiltInTypeName is an element with the [local name] "set".
If the BuiltInTypeName is "SET OF" then the translation of the
BuiltInTypeName is an element with the [local name] "setOf".
The translation of a BuiltInTypeQualifyingInformationPart is the
translation of the contained BuiltInTypeQualifyingInformation.
The translation of a BuiltInTypeQualifyingInformation of the
"identifier" form is an element with the [local name] "identifier".
An attribute with the [local name] "name" SHALL be added to the
[attributes] of the <identifier> element. The [normalized value] of
this attribute is the actual identifier.
The translation of a BuiltInTypeQualifyingInformationPart of the
"ALL" form is an element with the [local name] "allIdentifiers".
4.1.3. IdentifiersInContext Translation
The translation of an IdentifiersInContext is an element with the
[local name] "components".
If the IdentifierList in the IdentifiersInContext is not of the "ALL"
or "COMPONENTS" form then, for each identifier in the IdentifierList,
an element with the same [local name] (i.e., "attribute", "element",
"content", "member" or "item") as the translation of the NamedType
corresponding to the identifier SHALL be added to the [children] of
the <components> element. An attribute with the [local name] "name"
SHALL be added to the [attributes] of each <attribute>, <element>,
<content>, <member> or <item> element, as appropriate. The
[normalized value] of each of these attributes is the RXER encoding
of the effective name [RXEREI] of the NamedType corresponding to the
identifier.
If the IdentifierList in the IdentifiersInContext is of the "ALL"
form then an element with the [local name] "allTextuallyPresent"
SHALL be added to the [children] of the <components> element.
If the IdentifierList in the IdentifiersInContext is of the
"COMPONENTS" form then an element with the [local name]
"allFirstLevel" SHALL be added to the [children] of the <components>
element.
4.1.4. ImportedTypesIdentification Translation
The translation of an ImportedTypesIdentification is an element with
the [local name] "allImportsFrom". An attribute with the
Legg Expires 12 October 2005 [Page 9]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
[local name] "name" SHALL be added to the [attributes] of the
<allImportsFrom> element. The [normalized value] of this attribute
is the modulereference in the ImportedTypesIdentification.
If the module identified by the modulereference has a non-empty
DefinitiveIdentifier in the ModuleIdentifier in its ModuleDefinition
then an attribute with the [local name] "identifier" SHOULD be added
to the [attributes] of the <allImportsFrom> element. The
[normalized value] of this attribute is the RXER encoding of the
DefinitiveIdentifier.
If the module identified by the modulereference has an RXER
SCHEMA-IDENTITY encoding instruction then an attribute with the
[local name] "schemaIdentity" SHALL be added to the [attributes] of
the <allImportsFrom> element. The [normalized value] of this
attribute is the character string specified by the AnyURIValue of the
SCHEMA-IDENTITY encoding instruction.
4.2. NamespaceRestriction Translation
The NamespaceRestriction production is common to
AnyAttributesInstruction and AnyElementInstruction.
The translation of a NamespaceRestriction of the "FROM URIList" form
is an element with the [local name] "from". The translation of each
QuotedURIorAbsent in the URIList is appended to the [children] of the
<from> element.
The translation of a NamespaceRestriction of the "EXCEPT URIList"
form is an element with the [local name] "except". The translation
of each QuotedURIorAbsent in the URIList is appended to the
[children] of the <except> element.
The translation of a QuotedURIorAbsent that is a QuotedURI is an
element with the [local name] "namespace". The content of the
<namespace> element is (ignoring comment and processing instruction
items) the URI in the QuotedURI.
The translation of a QuotedURIorAbsent of the "ABSENT" form is an
element with the [local name] "local".
4.3. AnyAttributesInstruction Translation
The translation of an AnyAttributesInstruction is an element with the
[local name] "anyAttributes". The translation of the TargetList in
the AnyAttributesInstruction SHALL be added to the [children] of the
<anyAttributes> element. If a NamespaceRestriction is present then
the translation of the NamespaceRestriction is appended to the
Legg Expires 12 October 2005 [Page 10]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
[children] of the <anyAttributes> element.
4.4. AnyElementInstruction Translation
The translation of an AnyElementInstruction is an element with the
[local name] "anyElement". The translation of the TargetList in the
AnyElementInstruction SHALL be added to the [children] of the
<anyElement> element. If a NamespaceRestriction is present then the
translation of the NamespaceRestriction is appended to the [children]
of the <anyElement> element.
4.5. AttributeInstruction Translation
The translation of an AttributeInstruction is an element with the
[local name] "attribute". The translation of the TargetList in the
AttributeInstruction SHALL be added to the [children] of the
<attribute> element.
4.6. Base64Instruction Translation
The translation of a Base64Instruction is an element with the
[local name] "base64". The translation of the TargetList in the
Base64Instruction SHALL be added to the [children] of the <base64>
element.
4.7. DecimalInstruction Translation
The translation of a DecimalInstruction is an element with the
[local name] "decimal". The translation of the TargetList in the
DecimalInstruction SHALL be added to the [children] of the <decimal>
element.
4.8. DefaultForEmptyInstruction Translation
The translation of a DefaultForEmptyInstruction is an element with
the [local name] "defaultForEmpty". The translation of the
TargetList in the DefaultForEmptyInstruction SHALL be added to the
[children] of the <defaultForEmpty> element. If the Value is present
in the DefaultForEmptyInstruction then the translation of the Value
is appended to the content of the <defaultForEmpty> element.
4.9. ElementInstruction Translation
The translation of an ElementInstruction is an element with the
[local name] "element". The translation of the TargetList in the
ElementInstruction SHALL be added to the [children] of the <element>
element.
Legg Expires 12 October 2005 [Page 11]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
4.10. EmbedValuesInstruction Translation
The translation of an EmbedValuesInstruction is an element with the
[local name] "embedValues". The translation of the TargetList in the
EmbedValuesInstruction SHALL be added to the [children] of the
<embedValues> element.
4.11. ListInstruction Translation
The translation of a ListInstruction is an element with the
[local name] "list". The translation of the TargetList in the
ListInstruction SHALL be added to the [children] of the <list>
element.
4.12. NameInstruction Translation
The translation of a NameInstruction is an element with the
[local name] "name". The translation of the TargetList in the
NameInstruction SHALL be added to the [children] of the <name>
element.
If a NewNameOrKeyword is present in the NameInstruction and the
NewNameOrKeyword is a NewName then an attribute with the [local name]
"newName" SHALL be added to the [attributes] of the <name> element.
The [normalized value] of this attribute is the character string
value of the NewName.
If a NewNameOrKeyword is present in the NameInstruction and the
NewNameOrKeyword is a Keyword then an attribute with the [local name]
"conversion" SHALL be added to the [attributes] of the <name>
element. The [normalized value] of this attribute is the keyword in
Keyword, i.e., "CAPITALIZED", "UNCAPITALIZED", "UPPERCASED" or
"LOWERCASED".
4.13. NamespaceInstruction Translation
The translation of a NamespaceInstruction is an element with the
[local name] "namespace". The translation of the TargetList in the
NamespaceInstruction SHALL be added to the [children] of the
<namespace> element.
If a NamespaceSpecification is present then an attribute with the
[local name] "name" SHALL be added to the [attributes] of the
<namespace> element. The [normalized value] of this attribute is the
URI in the QuotedURI in the NamespaceSpecification.
If a Prefix is present in the NamespaceSpecification then an
attribute with the [local name] "prefix" SHALL be added to the
Legg Expires 12 October 2005 [Page 12]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
[attributes] of the <namespace> element. The [normalized value] of
this attribute is the NCName in the QuotedNCName in the Prefix.
4.14. PIOrCommentInstruction Translation
The translation of a PIOrCommentInstruction is an element with the
[local name] "piOrComment". The translation of the TargetList in the
PIOrCommentInstruction SHALL be added to the [children] of the
<piOrComment> element.
If a RestrictedCharacterStringValue is present in the
PIOrCommentInstruction then an attribute with the [local name] "text"
SHALL be added to the [attributes] of the <piOrComment> element. The
[normalized value] of this attribute is the character string of the
RestrictedCharacterStringValue.
If a Position is present in the PIOrCommentInstruction then an
attribute with the [local name] "position" SHALL be added to the
[attributes] of the <piOrComment> element. The [normalized value] of
this attribute is the keyword in the Position, i.e., "BEFORE-TAG",
"BEFORE-VALUE", "AFTER-VALUE" or "AFTER-TAG".
4.15. TextInstruction Translation
The translation of a TextInstruction is an element with the
[local name] "text". The translation of the TargetList in the
TextInstruction SHALL be added to the [children] of the <text>
element.
If a TextToBeUsed is present in the TextInstruction and the
NewNameOrKeyword in the TextToBeUsed is a NewName then an attribute
with the [local name] "newName" SHALL be added to the [attributes] of
the <text> element. The [normalized value] of this attribute is the
character string value of the NewName.
If a TextToBeUsed is present in the TextInstruction and the
NewNameOrKeyword in the TextToBeUsed is a Keyword then an attribute
with the [local name] "conversion" SHALL be added to the [attributes]
of the <name> element. The [normalized value] of this attribute is
the keyword in Keyword, i.e., "CAPITALIZED", "UNCAPITALIZED",
"UPPERCASED" or "LOWERCASED".
4.16. UntaggedInstruction Translation
The translation of an UntaggedInstruction is an element with the
[local name] "untagged". The translation of the TargetList in the
UntaggedInstruction SHALL be added to the [children] of the
<untagged> element.
Legg Expires 12 October 2005 [Page 13]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
4.17. UseNilInstruction Translation
The translation of a UseNilInstruction is an element with the
[local name] "useNil". The translation of the TargetList in the
UseNilInstruction SHALL be added to the [children] of the <useNil>
element.
4.18. UseNumberInstruction Translation
The translation of a UseNumberInstruction is an element with the
[local name] "useNumber". The translation of the TargetList in the
UseNumberInstruction SHALL be added to the [children] of the
<useNumber> element.
4.19. UseOrderInstruction Translation
The translation of a UseOrderInstruction is an element with the
[local name] "useOrder". The translation of the TargetList in the
UseOrderInstruction SHALL be added to the [children] of the
<useOrder> element.
4.20. UseQNameInstruction Translation
The translation of a UseQNameInstruction is an element with the
[local name] "useQName". The translation of the TargetList in the
UseQNameInstruction SHALL be added to the [children] of the
<useQName> element.
4.21. UseTypeInstruction Translation
The translation of a UseTypeInstruction is an element with the
[local name] "useType". The translation of the TargetList in the
UseTypeInstruction SHALL be added to the [children] of the <useType>
element.
4.22. UseUnionInstruction Translation
The translation of a UseUnionInstruction is an element with the
[local name] "useUnion". The translation of the TargetList in the
UseUnionInstruction SHALL be added to the [children] of the
<useUnion> element.
4.23. WhiteSpaceInstruction Translation
The translation of a WhiteSpaceInstruction is an element with the
[local name] "whiteSpace". The translation of the TargetList in the
WhiteSpaceInstruction SHALL be added to the [children] of the
<whiteSpace> element.
Legg Expires 12 October 2005 [Page 14]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
If a WhiteSpaceAction is present in the WhiteSpaceInstruction then an
attribute with the [local name] "action" SHALL be added to the
[attributes] of the <whiteSpace> element. The [normalized value] of
this attribute is the keyword in the WhiteSpaceAction, i.e.,
"REPLACE" or "COLLAPSE".
5. Parameterized Definitions
The translation of an ASN.1 specification into ASN.1 Schema [ASD]
replaces any DummyReference [X.683] or reference to a parameterized
definition [X.683] with the definition expanded in-line. For
example, a ParameterizedObject is replaced by the Object on the right
hand side of the referenced ParameterizedObjectAssignment.
When a DummyReference or parameterized reference is replaced by the
definition it references, the encoding control section applying to
any nested type definitions may no longer accord with the original
ASN.1 specification. This section describes a procedure for adding
additional information to an ASN.1 Schema document so that type
definitions are interpreted with respect to the appropriate XER
encoding control section.
For convenience, the procedure is described as a pre-processing step
in which the original ASN.1 specifications are annotated with
additional encoding instructions, and an optional post-processing
step in which redundant encoding instruction translations are
removed. Implementations are not required to explicitly perform the
pre-processing and post-processing provided they produce the same net
effect.
5.1. Pre-processing Step
The pre-processing step requires two additional XER encoding
instructions that are defined here. Note well: these encoding
instructions are for translation purposes only and MUST NOT be used
except in the pre-processing step in the translation of an ASN.1
specification into an ASN.1 Schema document.
The notation for the additional XER encoding instructions is defined
as follows:
AssumeReferenceInstruction ::=
"ASSUME-REFERENCE" typereference
AssumeModuleInstruction ::=
"ASSUME-MODULE" GlobalModuleReference ?
The GlobalModuleReference and typereference productions are defined
Legg Expires 12 October 2005 [Page 15]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
by the ASN.1 basic notation [X.680].
The ASSUME-MODULE encoding instruction (described by
AssumeModuleInstruction) indicates that the prefixed type and all
nested types (excluding any types within the EncodingPrefixedType for
a nested ASSUME-MODULE encoding instruction) are to be regarded as
belonging to the nominated module and therefore subject to its XER
encoding control section. If no module is nominated then no XER
encoding control section applies to the types.
The ASSUME-REFERENCE encoding instruction (described by
AssumeReferenceInstruction) indicates that the prefixed type is to be
regarded as the right hand side of a ParameterizedTypeAssignment with
the nominated reference name.
The remainder of this section describes how ASN.1 specifications are
annotated with the ASSUME-REFERENCE and ASSUME-MODULE encoding
instructions before translation.
The Type of each ParameterizedTypeAssignment (i.e., the Type
immediately to the right hand side of the "::=") in a module with an
encoding control section for XER is prefixed with an ASSUME-REFERENCE
encoding instruction. The typereference in the ASSUME-REFERENCE
encoding instruction is the typereference of the
ParameterizedTypeAssignment.
Each Type on or within the right hand side of a parameterized
assignment (regardless of whether the module has an encoding control
section for XER) that is not textually within another Type is
prefixed with an ASSUME-MODULE encoding instruction. Where a Type is
prefixed with both an ASSUME-REFERENCE and an ASSUME-MODULE encoding
instruction, the ASSUME-MODULE encoding instruction is outermost.
Each Type in an ActualParameter that is not textually within another
Type in the same ActualParameter is prefixed with an ASSUME-MODULE
encoding instruction.
If the module in which an ASSUME-MODULE encoding instruction appears
does not have an encoding control section for XER then the
GlobalModuleReference SHALL be absent from the encoding instruction,
otherwise the GlobalModuleReference SHALL be present with the
modulereference and DefinitiveIdentifier of the module.
Example
Suppose these two modules are about to be translated into
ASN.1 Schema:
Legg Expires 12 October 2005 [Page 16]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
ThisModule DEFINITIONS AUTOMATIC TAGS ::= BEGIN
IMPORTS
ThatTypeA FROM ThatModule;
ThisTypeA ::= ThatTypeA {
ENUMERATED { stop, go } }
ThisTypeB { TypeParam } ::=
SEQUENCE { component TypeParam }
ThisTypeC ::= ThisTypeB {
BOOLEAN }
ENCODING-CONTROL XER
MODIFIED-ENCODINGS
END
ThatModule DEFINITIONS AUTOMATIC TAGS ::= BEGIN
ThatTypeA { TypeParam } ::=
SEQUENCE { component TypeParam }
ThatTypeB ::= ThatTypeA {
BOOLEAN }
END
These modules look like the following after pre-processing:
ThisModule DEFINITIONS AUTOMATIC TAGS ::= BEGIN
IMPORTS
ThatTypeA FROM ThatModule;
ThisTypeA ::= ThatTypeA {
[XER:ASSUME-MODULE ThisModule]
ENUMERATED { stop, go } }
ThisTypeB { TypeParam } ::=
[XER:ASSUME-MODULE ThisModule]
[XER:ASSUME-REFERENCE ThisTypeB]
SEQUENCE { component TypeParam }
ThisTypeC ::= ThisTypeB {
[XER:ASSUME-MODULE ThisModule]
BOOLEAN }
Legg Expires 12 October 2005 [Page 17]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
ENCODING-CONTROL XER
MODIFIED-ENCODINGS
END
ThatModule DEFINITIONS AUTOMATIC TAGS ::= BEGIN
ThatTypeA { TypeParam } ::=
[XER:ASSUME-MODULE]
SEQUENCE { component TypeParam }
ThatTypeB ::= ThatTypeA {
[XER:ASSUME-MODULE]
BOOLEAN }
END
5.2. Translation Step
Following the pre-processing step, all the ASN.1 modules are
translated as normal [ASD].
The ASSUME-REFERENCE and ASSUME-MODULE encoding instructions have
translations into ASN.1 Schema.
The translation of an AssumeReferenceInstruction is an element with
the [local name] "assumeReference". An attribute with the
[local name] "name" SHALL be added to the [attributes] of the
<assumeReference> element. The [normalized value] of this attribute
is the typereference.
The translation of an AssumeModuleInstruction is an element with the
[local name] "assumeModule". If the GlobalModuleReference is present
then an attribute with the [local name] "name" SHALL be added to the
[attributes] of the <assumeModule> element. The [normalized value]
of this attribute is the modulereference in the
GlobalModuleReference. If the GlobalModuleReference is present and
the AssignedIdentifier is not empty then an attribute with the
[local name] "identifier" SHALL be added to the [attributes] of the
<assumeModule> element. The [normalized value] of this attribute is
the RXER [RXER] encoding of the AssignedIdentifier. If the
GlobalModuleReference is present and the referenced module has an
RXER SCHEMA-IDENTITY encoding instruction then an attribute with the
[local name] "schemaIdentity" SHALL be added to the [attributes] of
the <assumeModule> element. The [normalized value] of this attribute
is the character string specified by the AnyURIValue of the
SCHEMA-IDENTITY encoding instruction.
Legg Expires 12 October 2005 [Page 18]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
If the GlobalModuleReference is absent then the <assumeModule>
element is said to reference no module.
Example
Continuing the example from the previous section, the translated
modules look like the following:
<asn1:schema xmlns:asn1="http://xmled.info/ns/ASN.1"
name="ThisModule">
<namedType name="ThisTypeA">
<type>
<prefixed>
<XER><assumeModule/></XER>
<type>
<sequence>
<element name="component">
<type>
<prefixed>
<XER><assumeModule name="ThisModule"/></XER>
<type>
<enumerated>
<enumeration name="stop"/>
<enumeration name="go"/>
</enumerated>
</type>
</prefixed>
</type>
</element>
</sequence>
</type>
</prefixed>
</type>
</namedType>
<namedType name="ThisTypeC">
<type>
<prefixed>
<XER>
<assumeModule name="ThisModule"/>
<assumeReference name="ThisTypeB"/>
</XER>
<type>
<sequence>
<element name="component">
<type>
<prefixed>
Legg Expires 12 October 2005 [Page 19]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
<XER><assumeModule name="ThisModule"/></XER>
<type ref="asn1:BOOLEAN"/>
</prefixed>
</type>
</element>
</sequence>
</type>
</prefixed>
</type>
</namedType>
<encodingControl-XER modifiedEncodings="true"/>
</asn1:schema>
<asn1:schema xmlns:asn1="http://xmled.info/ns/ASN.1"
name="ThatModule">
<namedType name="ThatTypeB">
<type>
<prefixed>
<XER><assumeModule/></XER>
<type>
<sequence>
<element name="component">
<type>
<prefixed>
<XER><assumeModule/></XER>
<type ref="asn1:BOOLEAN"/>
</prefixed>
</type>
</element>
</sequence>
</type>
</prefixed>
</type>
</namedType>
</asn1:schema>
5.3. Post-processing Step
In the post-processing step, redundant <assumeModule> elements may be
removed.
Definition: The superior element for an <assumeModule> element, if it
exists, is the nearest preceding <assumedModule> element with the
same, or an enclosing, grandparent <prefixed> element.
Legg Expires 12 October 2005 [Page 20]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
An <assumedModule> element MAY be removed if:
(a) it has a superior element and both elements reference the same
module, or both elements reference no module, or
(b) it does not have a superior element and it appears in the
translation of the module it references, or
(c) it does not have a superior element and it references no module
and it appears in the translation of a module that does not have
an <encodingControl-XER> element.
If a removed <assumedModule> element is the last child element of an
<XER> element then the <XER> element MUST be removed.
If the removal of an <XER> element causes a <prefixed> element to
have only a <type> child element then the <type> parent element of
the <prefixed> element SHALL be replaced by the <type> child element
of the <prefixed> element.
If the removal of an <XER> element causes a <prefixed> element to
have no child elements then an attribute with the [local name] "ref"
SHALL be added to the <type> parent element of the <prefixed>
element. The [normalized value] of this attribute is the
[normalized value] of the type attribute of the <prefixed> element.
The <prefixed> element SHALL be removed. If appropriate for the
context, the <type> element (an element form translation of a type
reference) MAY be replaced by the equivalent attribute form
translation [ASD].
Example
Continuing the example from the previous section, the translated
modules may be post-processed to the following:
<asn1:schema xmlns:asn1="http://xmled.info/ns/ASN.1"
name="ThisModule">
<namedType name="ThisTypeA">
<type>
<prefixed>
<XER><assumeModule/></XER>
<type>
<sequence>
<element name="component">
<type>
<prefixed>
<XER><assumeModule name="ThisModule"/></XER>
Legg Expires 12 October 2005 [Page 21]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
<type>
<enumerated>
<enumeration name="stop"/>
<enumeration name="go"/>
</enumerated>
</type>
</prefixed>
</type>
</element>
</sequence>
</type>
</prefixed>
</type>
</namedType>
<namedType name="ThisTypeC">
<type>
<prefixed>
<XER><assumeReference name="ThisTypeB"/></XER>
<type>
<sequence>
<element name="component" type="asn1:BOOLEAN"/>
</sequence>
</type>
</prefixed>
</type>
</namedType>
<encodingControl-XER modifiedEncodings="true"/>
</asn1:schema>
<asn1:schema xmlns:asn1="http://xmled.info/ns/ASN.1"
name="ThatModule">
<namedType name="ThatTypeB">
<type>
<sequence>
<element name="component" type="asn1:BOOLEAN"/>
</sequence>
</type>
</namedType>
</asn1:schema>
6. Security Considerations
The ASN.1 Schema translation of an XER encoding instruction is
Legg Expires 12 October 2005 [Page 22]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
semantically equivalent to the original XER encoding instruction.
The security considerations that apply to an application built from
an original ASN.1 specification with XER encoding instructions apply
equally to an application built from the ASN.1 Schema translation of
the ASN.1 specification.
7. IANA Considerations
This document has no actions for IANA.
Appendix A. ASN.1 for XER Encoding Instruction Notation
This appendix is normative.
XER-EncodingInstructionSchema
{ iso(1) identified-organization(3) dod(6)
internet(1) private(4) enterprise(1)
xmled(21472) asn1(1) module(0) xer-ei-schema(3) }
-- Copyright (C) The Internet Society 2005. This version of
-- this ASN.1 module is part of RFC XXXX; see the RFC itself
-- for full legal notices.
DEFINITIONS
RXER INSTRUCTIONS
AUTOMATIC TAGS
EXTENSIBILITY IMPLIED ::= BEGIN
IMPORTS
AnySimpleType,
AnyURI,
NCName,
QName
FROM AdditionalBasicDefinitions
{ iso(1) identified-organization(3) dod(6)
internet(1) private(4) enterprise(1)
xmled(21472) asn1(1) module(0) basic(0) }
ModuleReference,
DefinitiveIdentifier,
TypeReference,
Value
FROM ASN1-Schema
{ iso(1) identified-organization(3) dod(6)
internet(1) private(4) enterprise(1)
xmled(21472) asn1(1) module(0) schema(1) }
;
-- An XER encoding instruction in a type prefix
Legg Expires 12 October 2005 [Page 23]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
-- must have an empty TargetList.
XER-EncodingInstruction ::= XER-GeneralEncodingInstruction
(WITH COMPONENTS { ...,
positive (WITH COMPONENTS { ...,
anyAttributes (WITH COMPONENTS { ..., targetList ABSENT }),
anyElement (WITH COMPONENTS { ..., targetList ABSENT }),
attribute (WITH COMPONENTS { ..., targetList ABSENT }),
base64 (WITH COMPONENTS { ..., targetList ABSENT }),
decimal (WITH COMPONENTS { ..., targetList ABSENT }),
defaultForEmpty (WITH COMPONENTS { ..., targetList ABSENT }),
embedValues (WITH COMPONENTS { ..., targetList ABSENT }),
list (WITH COMPONENTS { ..., targetList ABSENT }),
name (WITH COMPONENTS { ..., targetList ABSENT }),
namespace (WITH COMPONENTS { ..., targetList ABSENT }),
piOrComment (WITH COMPONENTS { ..., targetList ABSENT }),
text (WITH COMPONENTS { ..., targetList ABSENT }),
untagged (WITH COMPONENTS { ..., targetList ABSENT }),
useNumber (WITH COMPONENTS { ..., targetList ABSENT }),
useOrder (WITH COMPONENTS { ..., targetList ABSENT }),
useQName (WITH COMPONENTS { ..., targetList ABSENT }),
useType (WITH COMPONENTS { ..., targetList ABSENT }),
useUnion (WITH COMPONENTS { ..., targetList ABSENT }),
whiteSpace (WITH COMPONENTS { ..., targetList ABSENT })
}),
not (WITH COMPONENTS { ...,
anyAttributes (WITH COMPONENTS { ..., targetList ABSENT }),
anyElement (WITH COMPONENTS { ..., targetList ABSENT }),
attribute (WITH COMPONENTS { ..., targetList ABSENT }),
base64 (WITH COMPONENTS { ..., targetList ABSENT }),
decimal (WITH COMPONENTS { ..., targetList ABSENT }),
defaultForEmpty (WITH COMPONENTS { ..., targetList ABSENT }),
embedValues (WITH COMPONENTS { ..., targetList ABSENT }),
list (WITH COMPONENTS { ..., targetList ABSENT }),
name (WITH COMPONENTS { ..., targetList ABSENT }),
namespace (WITH COMPONENTS { ..., targetList ABSENT }),
piOrComment (WITH COMPONENTS { ..., targetList ABSENT }),
text (WITH COMPONENTS { ..., targetList ABSENT }),
untagged (WITH COMPONENTS { ..., targetList ABSENT }),
useNil (WITH COMPONENTS { ..., targetList ABSENT }),
useNumber (WITH COMPONENTS { ..., targetList ABSENT }),
useOrder (WITH COMPONENTS { ..., targetList ABSENT }),
useQName (WITH COMPONENTS { ..., targetList ABSENT }),
useType (WITH COMPONENTS { ..., targetList ABSENT }),
useUnion (WITH COMPONENTS { ..., targetList ABSENT }),
whiteSpace (WITH COMPONENTS { ..., targetList ABSENT })
}),
element (WITH COMPONENTS { ..., targetList ABSENT }) })
Legg Expires 12 October 2005 [Page 24]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
XER-EncodingInstructionAssignmentList ::= SEQUENCE {
modifiedEncodings [ATTRIBUTE] BOOLEAN DEFAULT FALSE,
controlNamespace XER-ControlNamespace OPTIONAL,
instructions [CONTENT] XER-ECS-EncodingInstructions
OPTIONAL
} (WITH COMPONENTS { ..., modifiedEncodings (TRUE) } |
WITH COMPONENTS { ..., controlNamespace PRESENT } |
WITH COMPONENTS { ..., instructions PRESENT })
XER-ControlNamespace ::= SEQUENCE {
name [ATTRIBUTE] AnyURI,
prefix [ATTRIBUTE] NCName OPTIONAL
}
XER-ECS-EncodingInstructions ::= SEQUENCE SIZE (1..MAX) OF
instruction [CONTENT] XER-ECS-EncodingInstruction
-- An XER encoding instruction in an encoding control section
-- must not have an empty TargetList.
XER-ECS-EncodingInstruction ::= XER-GeneralEncodingInstruction
(WITH COMPONENTS { ...,
positive (WITH COMPONENTS { ...,
anyAttributes (WITH COMPONENTS { ..., targetList PRESENT }),
anyElement (WITH COMPONENTS { ..., targetList PRESENT }),
attribute (WITH COMPONENTS { ..., targetList PRESENT }),
base64 (WITH COMPONENTS { ..., targetList PRESENT }),
decimal (WITH COMPONENTS { ..., targetList PRESENT }),
defaultForEmpty (WITH COMPONENTS { ..., targetList PRESENT }),
embedValues (WITH COMPONENTS { ..., targetList PRESENT }),
list (WITH COMPONENTS { ..., targetList PRESENT }),
name (WITH COMPONENTS { ..., targetList PRESENT }),
namespace (WITH COMPONENTS { ..., targetList PRESENT }),
piOrComment (WITH COMPONENTS { ..., targetList PRESENT }),
text (WITH COMPONENTS { ..., targetList PRESENT }),
untagged (WITH COMPONENTS { ..., targetList PRESENT }),
useNil (WITH COMPONENTS { ..., targetList PRESENT }),
useNumber (WITH COMPONENTS { ..., targetList PRESENT }),
useOrder (WITH COMPONENTS { ..., targetList PRESENT }),
useQName (WITH COMPONENTS { ..., targetList PRESENT }),
useType (WITH COMPONENTS { ..., targetList PRESENT }),
useUnion (WITH COMPONENTS { ..., targetList PRESENT }),
whiteSpace (WITH COMPONENTS { ..., targetList PRESENT })
}),
not (WITH COMPONENTS { ...,
anyAttributes (WITH COMPONENTS { ..., targetList PRESENT }),
anyElement (WITH COMPONENTS { ..., targetList PRESENT }),
attribute (WITH COMPONENTS { ..., targetList PRESENT }),
base64 (WITH COMPONENTS { ..., targetList PRESENT }),
Legg Expires 12 October 2005 [Page 25]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
decimal (WITH COMPONENTS { ..., targetList PRESENT }),
defaultForEmpty (WITH COMPONENTS { ..., targetList PRESENT }),
embedValues (WITH COMPONENTS { ..., targetList PRESENT }),
list (WITH COMPONENTS { ..., targetList PRESENT }),
name (WITH COMPONENTS { ..., targetList PRESENT }),
namespace (WITH COMPONENTS { ..., targetList PRESENT }),
piOrComment (WITH COMPONENTS { ..., targetList PRESENT }),
text (WITH COMPONENTS { ..., targetList PRESENT }),
untagged (WITH COMPONENTS { ..., targetList PRESENT }),
useNil (WITH COMPONENTS { ..., targetList PRESENT }),
useNumber (WITH COMPONENTS { ..., targetList PRESENT }),
useOrder (WITH COMPONENTS { ..., targetList PRESENT }),
useQName (WITH COMPONENTS { ..., targetList PRESENT }),
useType (WITH COMPONENTS { ..., targetList PRESENT }),
useUnion (WITH COMPONENTS { ..., targetList PRESENT }),
whiteSpace (WITH COMPONENTS { ..., targetList PRESENT })
}),
element (WITH COMPONENTS { ..., targetList PRESENT }),
assumeReference ABSENT,
assumeModule ABSENT })
XER-GeneralEncodingInstruction ::= CHOICE {
positive [CONTENT] XER-PositiveInstruction,
not XER-NegatingInstruction,
element XER-ElementInstruction,
assumeReference XER-AssumeReferenceInstruction,
assumeModule XER-AssumeModuleInstruction
}
XER-PositiveInstruction ::= CHOICE {
anyAttributes XER-AnyAttributesInstruction,
anyElement XER-AnyElementInstruction,
attribute XER-AttributeInstruction,
base64 XER-Base64Instruction,
decimal XER-DecimalInstruction,
defaultForEmpty XER-DefaultForEmptyInstruction,
embedValues XER-EmbedValuesInstruction,
list XER-ListInstruction,
name XER-NameInstruction,
namespace XER-NamespaceInstruction,
piOrComment XER-PIOrCommentInstruction,
text XER-TextInstruction,
untagged XER-UntaggedInstruction,
useNil XER-UseNilInstruction,
useNumber XER-UseNumberInstruction,
useOrder XER-UseOrderInstruction,
useQName XER-UseQNameInstruction,
useType XER-UseTypeInstruction,
Legg Expires 12 October 2005 [Page 26]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
useUnion XER-UseUnionInstruction,
whiteSpace XER-WhiteSpaceInstruction
}
XER-NegatingInstruction ::= XER-PositiveInstruction
(WITH COMPONENTS { ...,
anyAttributes (WITH COMPONENTS { targetList OPTIONAL }),
anyElement (WITH COMPONENTS { targetList OPTIONAL }),
defaultForEmpty (WITH COMPONENTS { targetList OPTIONAL }),
name (WITH COMPONENTS { targetList OPTIONAL }),
namespace (WITH COMPONENTS { targetList OPTIONAL }),
piOrComment (WITH COMPONENTS { targetList OPTIONAL }),
text (WITH COMPONENTS { targetList OPTIONAL }),
whiteSpace (WITH COMPONENTS { targetList OPTIONAL })
})
XER-TargetList ::= SEQUENCE SIZE (1..MAX) OF target XER-Targets
XER-Targets ::= CHOICE {
allTypes NULL,
identifiedTypes [CONTENT] XER-QualifiedTypeIdentification,
components XER-IdentifiersInContext,
allImportsFrom XER-ImportedTypesIdentification
}
-- TypeIdentification and BuiltInTypeIdentification
XER-QualifiedTypeIdentification ::= SEQUENCE {
types [CONTENT] CHOICE {
specificType [CONTENT] XER-SpecificTypeIdentification,
choice NULL,
enumerated NULL,
instanceOf NULL,
sequence NULL,
sequenceOf NULL,
set NULL,
setOf NULL
},
qualification [CONTENT] XER-QualifyingInformationPart OPTIONAL
}
XER-SpecificTypeIdentification ::= SEQUENCE {
type [ATTRIBUTE] QName,
component [ATTRIBUTE] AnySimpleType OPTIONAL,
allTextuallyPresent NULL OPTIONAL
}
XER-QualifyingInformationPart ::= CHOICE {
allIdentifiers NULL,
Legg Expires 12 October 2005 [Page 27]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
identifier SEQUENCE {
name [ATTRIBUTE] NCName
}
}
XER-IdentifiersInContext ::= SEQUENCE {
identifiers [CONTENT] XER-IdentifierList,
in CHOICE {
allTypes NULL,
specificType [CONTENT] XER-SpecificTypeIdentification
}
}
XER-IdentifierList ::= CHOICE {
allTextuallyPresent NULL,
allFirstLevel NULL,
list [CONTENT] XER-IdentifiedComponents
}
XER-IdentifiedComponents ::= SEQUENCE SIZE (1..MAX) OF
component [CONTENT] XER-IdentifiedComponent
XER-IdentifiedComponent ::= CHOICE {
attribute XER-GenericIdentifiedComponent,
element XER-GenericIdentifiedComponent,
content XER-GenericIdentifiedComponent,
member XER-GenericIdentifiedComponent,
item XER-GenericIdentifiedComponent
}
XER-GenericIdentifiedComponent ::= SEQUENCE {
name [ATTRIBUTE] QName
}
XER-ImportedTypesIdentification ::= SEQUENCE {
name [ATTRIBUTE] ModuleReference,
identifier [ATTRIBUTE] DefinitiveIdentifier OPTIONAL,
schemaIdentity [ATTRIBUTE] AnyURI OPTIONAL
}
XER-WildcardInstruction ::= SEQUENCE {
targetList [CONTENT] XER-TargetList OPTIONAL,
namespaceRestriction [CONTENT] XER-NamespaceRestriction OPTIONAL
}
XER-NamespaceRestriction ::= CHOICE {
from XER-URIList,
except XER-URIList
Legg Expires 12 October 2005 [Page 28]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
}
XER-URIList ::= SEQUENCE SIZE(1..MAX) OF
uriOrAbsent [CONTENT] XER-QuotedURIorAbsent
XER-QuotedURIorAbsent ::= CHOICE {
namespace AnyURI,
local NULL
}
XER-AnyAttributesInstruction ::= XER-WildcardInstruction
XER-AnyElementInstruction ::= XER-WildcardInstruction
XER-SimpleInstruction ::= SEQUENCE {
targetList [CONTENT] XER-TargetList OPTIONAL
}
XER-AttributeInstruction ::= XER-SimpleInstruction
XER-Base64Instruction ::= XER-SimpleInstruction
XER-DecimalInstruction ::= XER-SimpleInstruction
XER-DefaultForEmptyInstruction ::= SEQUENCE {
targetList [CONTENT] XER-TargetList OPTIONAL,
value [CONTENT] Value OPTIONAL
}
XER-ElementInstruction ::= XER-SimpleInstruction
XER-EmbedValuesInstruction ::= XER-SimpleInstruction
XER-ListInstruction ::= XER-SimpleInstruction
XER-NameInstruction ::= SEQUENCE {
targetList [CONTENT] XER-TargetList OPTIONAL,
newNameOrKeyword [CONTENT] XER-NewNameOrKeyword OPTIONAL
}
XER-NewNameOrKeyword ::= CHOICE {
newName [ATTRIBUTE] UTF8String,
conversion [ATTRIBUTE] XER-Conversion
}
XER-Conversion ::= [VALUES ALL UPPERCASED] ENUMERATED {
capitalized (0),
uncapitalized (1),
Legg Expires 12 October 2005 [Page 29]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
uppercased (2),
lowercased (3)
}
XER-NamespaceInstruction ::= SEQUENCE {
targetList [CONTENT] XER-TargetList OPTIONAL,
name [ATTRIBUTE] AnyURI OPTIONAL,
prefix [ATTRIBUTE] NCName OPTIONAL
}
XER-PIOrCommentInstruction ::= SEQUENCE {
targetList [CONTENT] XER-TargetList OPTIONAL,
text [ATTRIBUTE] UTF8String OPTIONAL,
position [ATTRIBUTE] XER-Position OPTIONAL
}
XER-Position ::= [VALUES ALL UPPERCASED] ENUMERATED {
before-tag (0),
before-value (1),
after-value (2),
after-tag (3)
}
XER-TextInstruction ::= SEQUENCE {
targetList [CONTENT] XER-TargetList OPTIONAL,
newNameOrKeyword [CONTENT] XER-NewNameOrKeyword OPTIONAL
}
XER-UntaggedInstruction ::= XER-SimpleInstruction
XER-UseNilInstruction ::= XER-SimpleInstruction
XER-UseNumberInstruction ::= XER-SimpleInstruction
XER-UseOrderInstruction ::= XER-SimpleInstruction
XER-UseQNameInstruction ::= XER-SimpleInstruction
XER-UseTypeInstruction ::= XER-SimpleInstruction
XER-UseUnionInstruction ::= XER-SimpleInstruction
XER-WhiteSpaceInstruction ::= SEQUENCE {
targetList [CONTENT] XER-TargetList OPTIONAL,
action [ATTRIBUTE] XER-WhiteSpaceAction OPTIONAL
}
XER-WhiteSpaceAction ::= [VALUES ALL UPPERCASED] ENUMERATED {
Legg Expires 12 October 2005 [Page 30]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
replace (0),
collapse (1)
}
XER-AssumeReferenceInstruction ::= SEQUENCE {
name [ATTRIBUTE] TypeReference
}
XER-AssumeModuleInstruction ::= SEQUENCE {
name [ATTRIBUTE] ModuleReference,
identifier [ATTRIBUTE] DefinitiveIdentifier OPTIONAL,
schemaIdentity [ATTRIBUTE] AnyURI OPTIONAL
}
ENCODING-CONTROL RXER
SCHEMA-IDENTITY
"http://xmled.info/id/ASN.1/XER-EncodingInstructionSchema"
TARGET-NAMESPACE "http://xmled.info/ns/ASN.1"
END
Appendix B. ASN.1 Schema for XER Encoding Instruction Notation
This appendix is non-normative.
<?xml version="1.0"?>
<asn1:schema
xmlns:asn1="http://xmled.info/ns/ASN.1"
xmlns:asd="http://xmled.info/ns/ASN.1"
name="XER-EncodingInstructionSchema"
identifier="1.3.6.1.4.1.21472.1.0.3"
schemaIdentity=
"http://xmled.info/id/ASN.1/XER-EncodingInstructionSchema"
xmlns:xer="http://xmled.info/ns/ASN.1"
targetNamespace="http://xmled.info/ns/ASN.1"
extensibilityImplied="true">
<!-- Copyright (C) The Internet Society 2005. This version of
this ASN.1 Schema is part of RFC XXXX; see the RFC itself
for full legal notices. -->
<import name="ASN1-Schema"
identifier="1.3.6.1.4.1.21472.1.0.1"
schemaIdentity="http://xmled.info/id/ASN.1/Schema"
namespace="http://xmled.info/ns/ASN.1"
schemaLocation="ASN1-Schema.asd"/>
Legg Expires 12 October 2005 [Page 31]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
<namedType name="XER-EncodingInstruction">
<type>
<constrained type="xer:XER-GeneralEncodingInstruction">
<withComponents partial="true">
<content name="positive">
<withComponents partial="true">
<element name="anyAttributes">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="anyElement">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="attribute">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="base64">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="decimal">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="defaultForEmpty">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="embedValues">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="list">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="name">
<withComponents partial="true">
Legg Expires 12 October 2005 [Page 32]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="namespace">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="piOrComment">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="text">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="untagged">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="useNumber">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="useOrder">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="useQName">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="useType">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="useUnion">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
Legg Expires 12 October 2005 [Page 33]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
<element name="whiteSpace">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
</withComponents>
</content>
<element name="not">
<withComponents partial="true">
<element name="anyAttributes">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="anyElement">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="attribute">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="base64">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="decimal">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="defaultForEmpty">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="embedValues">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="list">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
Legg Expires 12 October 2005 [Page 34]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
</element>
<element name="name">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="namespace">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="piOrComment">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="text">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="untagged">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="useNil">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="useNumber">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="useOrder">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="useQName">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="useType">
<withComponents partial="true">
Legg Expires 12 October 2005 [Page 35]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="useUnion">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
<element name="whiteSpace">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
</withComponents>
</element>
<element name="element">
<withComponents partial="true">
<content name="targetList" use="ABSENT"/>
</withComponents>
</element>
</withComponents>
</constrained>
</type>
</namedType>
<namedType name="XER-EncodingInstructionAssignmentList">
<type>
<constrained>
<type>
<sequence>
<optional>
<attribute name="modifiedEncodings" type="asn1:BOOLEAN"/>
<default literal="false"/>
</optional>
<optional>
<element name="controlNamespace"
type="xer:XER-ControlNamespace"/>
</optional>
<optional>
<content name="instructions"
type="xer:XER-ECS-EncodingInstructions"/>
</optional>
</sequence>
</type>
<union>
<withComponents partial="true">
<attribute name="modifiedEncodings">
<value>true</value>
Legg Expires 12 October 2005 [Page 36]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
</attribute>
</withComponents>
<withComponents partial="true">
<element name="controlNamespace" use="PRESENT"/>
</withComponents>
<withComponents partial="true">
<content name="instructions" use="PRESENT"/>
</withComponents>
</union>
</constrained>
</type>
</namedType>
<namedType name="XER-ControlNamespace">
<type>
<sequence>
<attribute name="name" type="asn1:AnyURI"/>
<optional>
<attribute name="prefix" type="asn1:NCName"/>
</optional>
</sequence>
</type>
</namedType>
<namedType name="XER-ECS-EncodingInstructions">
<type>
<sequenceOf minSize="1">
<content name="instruction"
type="xer:XER-ECS-EncodingInstruction"/>
</sequenceOf>
</type>
</namedType>
<namedType name="XER-ECS-EncodingInstruction">
<type>
<constrained type="xer:XER-GeneralEncodingInstruction">
<withComponents partial="true">
<content name="positive">
<withComponents partial="true">
<element name="anyAttributes">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="anyElement">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
Legg Expires 12 October 2005 [Page 37]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
</element>
<element name="attribute">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="base64">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="decimal">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="defaultForEmpty">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="embedValues">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="list">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="name">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="namespace">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="piOrComment">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="text">
<withComponents partial="true">
Legg Expires 12 October 2005 [Page 38]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="untagged">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="useNil">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="useNumber">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="useOrder">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="useQName">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="useType">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="useUnion">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="whiteSpace">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
</withComponents>
</content>
<element name="not">
<withComponents partial="true">
<element name="anyAttributes">
Legg Expires 12 October 2005 [Page 39]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="anyElement">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="attribute">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="base64">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="decimal">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="defaultForEmpty">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="embedValues">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="list">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="name">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="namespace">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
Legg Expires 12 October 2005 [Page 40]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
</element>
<element name="piOrComment">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="text">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="untagged">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="useNil">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="useNumber">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="useOrder">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="useQName">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="useType">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="useUnion">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="whiteSpace">
<withComponents partial="true">
Legg Expires 12 October 2005 [Page 41]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
</withComponents>
</element>
<element name="element">
<withComponents partial="true">
<content name="targetList" use="PRESENT"/>
</withComponents>
</element>
<element name="assumeReference" use="ABSENT"/>
<element name="assumeModule" use="ABSENT"/>
</withComponents>
</constrained>
</type>
</namedType>
<namedType name="XER-GeneralEncodingInstruction">
<type>
<choice>
<content name="positive" type="xer:XER-PositiveInstruction"/>
<element name="not" type="xer:XER-NegatingInstruction"/>
<element name="element" type="xer:XER-ElementInstruction"/>
<element name="assumeReference"
type="xer:XER-AssumeReferenceInstruction"/>
<element name="assumeModule"
type="xer:XER-AssumeModuleInstruction"/>
</choice>
</type>
</namedType>
<namedType name="XER-PositiveInstruction">
<type>
<choice>
<element name="anyAttributes"
type="xer:XER-AnyAttributesInstruction"/>
<element name="anyElement" type="xer:XER-AnyElementInstruction"/>
<element name="attribute" type="xer:XER-AttributeInstruction"/>
<element name="base64" type="xer:XER-Base64Instruction"/>
<element name="decimal" type="xer:XER-DecimalInstruction"/>
<element name="defaultForEmpty"
type="xer:XER-DefaultForEmptyInstruction"/>
<element name="embedValues"
type="xer:XER-EmbedValuesInstruction"/>
<element name="list" type="xer:XER-ListInstruction"/>
<element name="name" type="xer:XER-NameInstruction"/>
<element name="namespace" type="xer:XER-NamespaceInstruction"/>
<element name="piOrComment"
Legg Expires 12 October 2005 [Page 42]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
type="xer:XER-PIOrCommentInstruction"/>
<element name="text" type="xer:XER-TextInstruction"/>
<element name="untagged" type="xer:XER-UntaggedInstruction"/>
<element name="useNil" type="xer:XER-UseNilInstruction"/>
<element name="useNumber" type="xer:XER-UseNumberInstruction"/>
<element name="useOrder" type="xer:XER-UseOrderInstruction"/>
<element name="useQName" type="xer:XER-UseQNameInstruction"/>
<element name="useType" type="xer:XER-UseTypeInstruction"/>
<element name="useUnion" type="xer:XER-UseUnionInstruction"/>
<element name="whiteSpace" type="xer:XER-WhiteSpaceInstruction"/>
</choice>
</type>
</namedType>
<namedType name="XER-NegatingInstruction">
<type>
<constrained type="xer:XER-PositiveInstruction">
<withComponents partial="true">
<element name="anyAttributes">
<withComponents>
<content name="targetList" use="OPTIONAL"/>
</withComponents>
</element>
<element name="anyElement">
<withComponents>
<content name="targetList" use="OPTIONAL"/>
</withComponents>
</element>
<element name="defaultForEmpty">
<withComponents>
<content name="targetList" use="OPTIONAL"/>
</withComponents>
</element>
<element name="name">
<withComponents>
<content name="targetList" use="OPTIONAL"/>
</withComponents>
</element>
<element name="namespace">
<withComponents>
<content name="targetList" use="OPTIONAL"/>
</withComponents>
</element>
<element name="piOrComment">
<withComponents>
<content name="targetList" use="OPTIONAL"/>
</withComponents>
</element>
Legg Expires 12 October 2005 [Page 43]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
<element name="text">
<withComponents>
<content name="targetList" use="OPTIONAL"/>
</withComponents>
</element>
<element name="whiteSpace">
<withComponents>
<content name="targetList" use="OPTIONAL"/>
</withComponents>
</element>
</withComponents>
</constrained>
</type>
</namedType>
<namedType name="XER-TargetList">
<type>
<sequenceOf minSize="1">
<element name="target" type="xer:XER-Targets"/>
</sequenceOf>
</type>
</namedType>
<namedType name="XER-Targets">
<type>
<choice>
<element name="allTypes" type="asn1:NULL"/>
<content name="identifiedTypes"
type="xer:XER-QualifiedTypeIdentification"/>
<element name="components" type="xer:XER-IdentifiersInContext"/>
<element name="allImportsFrom"
type="xer:XER-ImportedTypesIdentification"/>
</choice>
</type>
</namedType>
<namedType name="XER-QualifiedTypeIdentification">
<type>
<sequence>
<content name="types">
<type>
<choice>
<content name="specificType"
type="xer:XER-SpecificTypeIdentification"/>
<element name="choice" type="asn1:NULL"/>
<element name="enumerated" type="asn1:NULL"/>
<element name="instanceOf" type="asn1:NULL"/>
<element name="sequence" type="asn1:NULL"/>
Legg Expires 12 October 2005 [Page 44]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
<element name="sequenceOf" type="asn1:NULL"/>
<element name="set" type="asn1:NULL"/>
<element name="setOf" type="asn1:NULL"/>
</choice>
</type>
</content>
<optional>
<content name="qualification"
type="xer:XER-QualifyingInformationPart"/>
</optional>
</sequence>
</type>
</namedType>
<namedType name="XER-SpecificTypeIdentification">
<type>
<sequence>
<attribute name="type" type="asn1:QName"/>
<optional>
<attribute name="component" type="asn1:AnySimpleType"/>
</optional>
<optional>
<element name="allTextuallyPresent" type="asn1:NULL"/>
</optional>
</sequence>
</type>
</namedType>
<namedType name="XER-QualifyingInformationPart">
<type>
<choice>
<element name="allIdentifiers" type="asn1:NULL"/>
<element name="identifier">
<type>
<sequence>
<attribute name="name" type="asn1:NCName"/>
</sequence>
</type>
</element>
</choice>
</type>
</namedType>
<namedType name="XER-IdentifiersInContext">
<type>
<sequence>
<content name="identifiers" type="xer:XER-IdentifierList"/>
<element name="in">
Legg Expires 12 October 2005 [Page 45]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
<type>
<choice>
<element name="allTypes" type="asn1:NULL"/>
<content name="specificType"
type="xer:XER-SpecificTypeIdentification"/>
</choice>
</type>
</element>
</sequence>
</type>
</namedType>
<namedType name="XER-IdentifierList">
<type>
<choice>
<element name="allTextuallyPresent" type="asn1:NULL"/>
<element name="allFirstLevel" type="asn1:NULL"/>
<content name="list" type="xer:XER-IdentifiedComponents"/>
</choice>
</type>
</namedType>
<namedType name="XER-IdentifiedComponents">
<type>
<sequenceOf minSize="1">
<content name="component" type="xer:XER-IdentifiedComponent"/>
</sequenceOf>
</type>
</namedType>
<namedType name="XER-IdentifiedComponent">
<type>
<choice>
<element name="attribute"
type="xer:XER-GenericIdentifiedComponent"/>
<element name="element"
type="xer:XER-GenericIdentifiedComponent"/>
<element name="content"
type="xer:XER-GenericIdentifiedComponent"/>
<element name="member"
type="xer:XER-GenericIdentifiedComponent"/>
<element name="item" type="xer:XER-GenericIdentifiedComponent"/>
</choice>
</type>
</namedType>
<namedType name="XER-GenericIdentifiedComponent">
<type>
Legg Expires 12 October 2005 [Page 46]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
<sequence>
<attribute name="name" type="asn1:QName"/>
</sequence>
</type>
</namedType>
<namedType name="XER-ImportedTypesIdentification">
<type>
<sequence>
<attribute name="name" type="asd:ModuleReference"/>
<optional>
<attribute name="identifier" type="asd:DefinitiveIdentifier"/>
</optional>
<optional>
<attribute name="schemaIdentity" type="asn1:AnyURI"/>
</optional>
</sequence>
</type>
</namedType>
<namedType name="XER-WildcardInstruction">
<type>
<sequence>
<optional>
<content name="targetList" type="xer:XER-TargetList"/>
</optional>
<optional>
<content name="namespaceRestriction"
type="xer:XER-NamespaceRestriction"/>
</optional>
</sequence>
</type>
</namedType>
<namedType name="XER-NamespaceRestriction">
<type>
<choice>
<element name="from" type="xer:XER-URIList"/>
<element name="except" type="xer:XER-URIList"/>
</choice>
</type>
</namedType>
<namedType name="XER-URIList">
<type>
<sequenceOf minSize="1">
<content name="uriOrAbsent" type="xer:XER-QuotedURIorAbsent"/>
</sequenceOf>
Legg Expires 12 October 2005 [Page 47]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
</type>
</namedType>
<namedType name="XER-QuotedURIorAbsent">
<type>
<choice>
<element name="namespace" type="asn1:AnyURI"/>
<element name="local" type="asn1:NULL"/>
</choice>
</type>
</namedType>
<namedType name="XER-AnyAttributesInstruction"
type="xer:XER-WildcardInstruction"/>
<namedType name="XER-AnyElementInstruction"
type="xer:XER-WildcardInstruction"/>
<namedType name="XER-SimpleInstruction">
<type>
<sequence>
<optional>
<content name="targetList" type="xer:XER-TargetList"/>
</optional>
</sequence>
</type>
</namedType>
<namedType name="XER-AttributeInstruction"
type="xer:XER-SimpleInstruction"/>
<namedType name="XER-Base64Instruction"
type="xer:XER-SimpleInstruction"/>
<namedType name="XER-DecimalInstruction"
type="xer:XER-SimpleInstruction"/>
<namedType name="XER-DefaultForEmptyInstruction">
<type>
<sequence>
<optional>
<content name="targetList" type="xer:XER-TargetList"/>
</optional>
<optional>
<content name="value" type="asd:Value"/>
</optional>
</sequence>
</type>
Legg Expires 12 October 2005 [Page 48]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
</namedType>
<namedType name="XER-ElementInstruction"
type="xer:XER-SimpleInstruction"/>
<namedType name="XER-EmbedValuesInstruction"
type="xer:XER-SimpleInstruction"/>
<namedType name="XER-ListInstruction"
type="xer:XER-SimpleInstruction"/>
<namedType name="XER-NameInstruction">
<type>
<sequence>
<optional>
<content name="targetList" type="xer:XER-TargetList"/>
</optional>
<optional>
<content name="newNameOrKeyword"
type="xer:XER-NewNameOrKeyword"/>
</optional>
</sequence>
</type>
</namedType>
<namedType name="XER-NewNameOrKeyword">
<type>
<choice>
<attribute name="newName" type="asn1:UTF8String"/>
<attribute name="conversion" type="xer:XER-Conversion"/>
</choice>
</type>
</namedType>
<namedType name="XER-Conversion">
<type>
<enumerated>
<enumeration name="CAPITALIZED" identifier="capitalized"
number="0"/>
<enumeration name="UNCAPITALIZED" identifier="uncapitalized"
number="1"/>
<enumeration name="UPPERCASED" identifier="uppercased"
number="2"/>
<enumeration name="LOWERCASED" identifier="lowercased"
number="3"/>
</enumerated>
</type>
</namedType>
Legg Expires 12 October 2005 [Page 49]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
<namedType name="XER-NamespaceInstruction">
<type>
<sequence>
<optional>
<content name="targetList" type="xer:XER-TargetList"/>
</optional>
<optional>
<attribute name="name" type="asn1:AnyURI"/>
</optional>
<optional>
<attribute name="prefix" type="asn1:NCName"/>
</optional>
</sequence>
</type>
</namedType>
<namedType name="XER-PIOrCommentInstruction">
<type>
<sequence>
<optional>
<content name="targetList" type="xer:XER-TargetList"/>
</optional>
<optional>
<attribute name="text" type="asn1:UTF8String"/>
</optional>
<optional>
<attribute name="position" type="xer:XER-Position"/>
</optional>
</sequence>
</type>
</namedType>
<namedType name="XER-Position">
<type>
<enumerated>
<enumeration name="BEFORE-TAG" identifier="before-tag"
number="0"/>
<enumeration name="BEFORE-VALUE" identifier="before-value"
number="1"/>
<enumeration name="AFTER-VALUE" identifier="after-value"
number="2"/>
<enumeration name="AFTER-TAG" identifier="after-tag" number="3"/>
</enumerated>
</type>
</namedType>
<namedType name="XER-TextInstruction">
<type>
Legg Expires 12 October 2005 [Page 50]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
<sequence>
<optional>
<content name="targetList" type="xer:XER-TargetList"/>
</optional>
<optional>
<content name="newNameOrKeyword"
type="xer:XER-NewNameOrKeyword"/>
</optional>
</sequence>
</type>
</namedType>
<namedType name="XER-UntaggedInstruction"
type="xer:XER-SimpleInstruction"/>
<namedType name="XER-UseNilInstruction"
type="xer:XER-SimpleInstruction"/>
<namedType name="XER-UseNumberInstruction"
type="xer:XER-SimpleInstruction"/>
<namedType name="XER-UseOrderInstruction"
type="xer:XER-SimpleInstruction"/>
<namedType name="XER-UseQNameInstruction"
type="xer:XER-SimpleInstruction"/>
<namedType name="XER-UseTypeInstruction"
type="xer:XER-SimpleInstruction"/>
<namedType name="XER-UseUnionInstruction"
type="xer:XER-SimpleInstruction"/>
<namedType name="XER-WhiteSpaceInstruction">
<type>
<sequence>
<optional>
<content name="targetList" type="xer:XER-TargetList"/>
</optional>
<optional>
<attribute name="action" type="xer:XER-WhiteSpaceAction"/>
</optional>
</sequence>
</type>
</namedType>
<namedType name="XER-WhiteSpaceAction">
<type>
Legg Expires 12 October 2005 [Page 51]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
<enumerated>
<enumeration name="REPLACE" identifier="replace" number="0"/>
<enumeration name="COLLAPSE" identifier="collapse" number="1"/>
</enumerated>
</type>
</namedType>
<namedType name="XER-AssumeReferenceInstruction">
<type>
<sequence>
<attribute name="name" type="asd:TypeReference"/>
</sequence>
</type>
</namedType>
<namedType name="XER-AssumeModuleInstruction">
<type>
<sequence>
<attribute name="name" type="asd:ModuleReference"/>
<optional>
<attribute name="identifier" type="asd:DefinitiveIdentifier"/>
</optional>
<optional>
<attribute name="schemaIdentity" type="asn1:AnyURI"/>
</optional>
</sequence>
</type>
</namedType>
</asn1:schema>
Normative References
[BCP14] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[URI] Berners-Lee, T., Fielding, R. and L. Masinter, "Uniform
Resource Identifiers (URI): Generic Syntax", STD 66, RFC
3986, January 2005.
[RXER] Legg, S. and D. Prager, "Robust XML Encoding Rules (RXER)
for Abstract Syntax Notation One (ASN.1)",
draft-legg-xed-rxer-xx.txt, a work in progress, April
2005.
[RXEREI] Legg, S., "Encoding Instructions for the Robust XML
Encoding Rules (RXER)", draft-legg-xed-rxer-ei-xx.txt, a
work in progress, April 2005.
Legg Expires 12 October 2005 [Page 52]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
[ASD] Legg, S. and D. Prager, "ASN.1 Schema: An XML
Representation for Abstract Syntax Notation One (ASN.1)
Specifications", draft-legg-xed-asd-xx.txt, a work in
progress, April 2005.
[X.680] ITU-T Recommendation X.680 (07/02) | ISO/IEC 8824-1:2002,
Information technology - Abstract Syntax Notation One
(ASN.1): Specification of basic notation
[X.680-1] Amendment 1: to ITU-T Rec. X.680 | ISO/IEC 8824-1
[X.683] ITU-T Recommendation X.683 (07/02) | ISO/IEC 8824-4:2002,
Information technology - Abstract Syntax Notation One
(ASN.1): Parameterization of ASN.1 specifications
[X.693-1] Amendment 1: (to ITU-T Rec. X.693 | ISO/IEC 8825-4) XER
encoding instructions and EXTENDED-XER
[XML] Bray, T., Paoli, J., Sperberg-McQueen, C., Maler, E. and
F. Yergeau, "Extensible Markup Language (XML) 1.0 (Third
Edition)", W3C Recommendation,
http://www.w3.org/TR/2004/REC-xml-20040204, February 2004.
[XMLNS] Bray, T., Hollander, D. and A. Layman, "Namespaces in
XML", http://www.w3.org/TR/1999/REC-xml-names-19990114,
January 1999.
[ISET] Cowan, J. and R. Tobin, "XML Information Set", W3C
Recommendation, http://www.w3.org/TR/2001/REC-xml-
infoset-20011024, October 2001.
Informative References
[X.693] ITU-T Recommendation X.693 (12/01) | ISO/IEC 8825-4:2002,
Information technology - ASN.1 encoding rules: XML
encoding rules (XER)
Author's Address
Dr. Steven Legg
eB2Bcom
Suite 3, Woodhouse Corporate Centre
935 Station Street
Box Hill North, Victoria 3129
AUSTRALIA
Phone: +61 3 9896 7830
Fax: +61 3 9896 7801
Legg Expires 12 October 2005 [Page 53]
INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005
EMail: steven.legg@eb2bcom.com
Full Copyright Statement
Copyright (C) The Internet Society (2005).
This document is subject to the rights, licenses and restrictions
contained in BCP 78, and except as set forth therein, the authors
retain all their rights.
This document and the information contained herein are provided on an
"AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Intellectual Property
The IETF takes no position regarding the validity or scope of any
Intellectual Property Rights or other rights that might be claimed to
pertain to the implementation or use of the technology described in
this document or the extent to which any license under such rights
might or might not be available; nor does it represent that it has
made any independent effort to identify any such rights. Information
on the procedures with respect to rights in RFC documents can be
found in BCP 78 and BCP 79.
Copies of IPR disclosures made to the IETF Secretariat and any
assurances of licenses to be made available, or the result of an
attempt made to obtain a general license or permission for the use of
such proprietary rights by implementers or users of this
specification can be obtained from the IETF on-line IPR repository at
http://www.ietf.org/ipr.
The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary
rights that may cover technology that may be required to implement
this standard. Please address the information to the IETF at
ietf-ipr@ietf.org.
Legg Expires 12 October 2005 [Page 54]