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 . Please send editorial comments directly to the editor . 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 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 element. otherwise an attribute with the [local name] "modifiedEncodings" and [normalized value] "false" or "0" MAY be added to the [attributes] of the 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 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 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 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 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 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 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 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 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 element. An attribute with the [local name] "name" SHALL be added to the [attributes] of each , , , or 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 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 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 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 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 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 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 element. The translation of a QuotedURIorAbsent that is a QuotedURI is an element with the [local name] "namespace". The content of the 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 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 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 element. If a NamespaceRestriction is present then the translation of the NamespaceRestriction is appended to the [children] of the 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 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 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 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 element. If the Value is present in the DefaultForEmptyInstruction then the translation of the Value is appended to the content of the 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. 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 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 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 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 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 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 element. If a NamespaceSpecification is present then an attribute with the [local name] "name" SHALL be added to the [attributes] of the 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 element is said to reference no module. Example Continuing the example from the previous section, the translated modules look like the following: Legg Expires 12 October 2005 [Page 19] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 5.3. Post-processing Step In the post-processing step, redundant elements may be removed. Definition: The superior element for an element, if it exists, is the nearest preceding element with the same, or an enclosing, grandparent element. Legg Expires 12 October 2005 [Page 20] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 An 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 element. If a removed element is the last child element of an element then the element MUST be removed. If the removal of an element causes a element to have only a child element then the parent element of the element SHALL be replaced by the child element of the element. If the removal of an element causes a element to have no child elements then an attribute with the [local name] "ref" SHALL be added to the parent element of the element. The [normalized value] of this attribute is the [normalized value] of the type attribute of the element. The element SHALL be removed. If appropriate for the context, the 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: Legg Expires 12 October 2005 [Page 21] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 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. Legg Expires 12 October 2005 [Page 31] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 Legg Expires 12 October 2005 [Page 32] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 Legg Expires 12 October 2005 [Page 33] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 Legg Expires 12 October 2005 [Page 34] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 Legg Expires 12 October 2005 [Page 35] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 true Legg Expires 12 October 2005 [Page 36] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 Legg Expires 12 October 2005 [Page 37] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 Legg Expires 12 October 2005 [Page 38] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 Legg Expires 12 October 2005 [Page 39] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 Legg Expires 12 October 2005 [Page 40] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 Legg Expires 12 October 2005 [Page 41] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 Legg Expires 12 October 2005 [Page 43] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 Legg Expires 12 October 2005 [Page 44] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 Legg Expires 12 October 2005 [Page 45] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 Legg Expires 12 October 2005 [Page 46] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 Legg Expires 12 October 2005 [Page 47] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 Legg Expires 12 October 2005 [Page 48] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 Legg Expires 12 October 2005 [Page 49] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 Legg Expires 12 October 2005 [Page 50] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 Legg Expires 12 October 2005 [Page 51] INTERNET-DRAFT ASN.1 Schema: XER Encoding Instructions April 12, 2005 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]