Starting with an input genericode file.

Create a suite of output files copying the input ODS file.

Parameter c:baseDir as="xsd:string"

The base directory in the input ODS where the file is found.

Parameter c:modelName as="xsd:string" required="yes"

The name of the model.

These ODS elements are not to be preserved.

Accommodate an output table

Accommodate an output table

Parameter c:modelName tunnel="yes" as="xsd:string" required="yes"

The name of the model.

The current node is a genericode row, make a table row out of it

Parameter c:tableRows as="element(table:table-row)*"

The raw rows from which a new row is created

Parameter c:columnTitles as="xsd:string*"

The columns being included in the spreadsheet

Modify the skeleton row with the content from the gcRow

Parameter c:columnTitles as="xsd:string*"

The list of strings of column titles, in column order.

Parameter c:gcRow as="element(Row)"

The genericode row being output.

Massage a table formula based on the current row number.

Parameter c:oldRowNumber as="xsd:integer" tunnel="yes"

The row being matched.

Parameter c:newRowNumber as="xsd:integer" tunnel="yes"

The row being generated.

Create as many map entries as there are tables.

Reflect the name of the table in the configuration

Parameter c:modelName tunnel="yes" as="xsd:string" required="yes"

The name of the model.

Reflect the name of the table as active

Parameter c:modelName tunnel="yes" as="xsd:string" required="yes"

The name of the model.

Elide any personal content.

The identity template is used to copy all nodes not already being handled by other template rules.

Apply, in order, regular expressions on a string.

Parameter c:value as="xsd:string?"

The value to be massaged.

Apply, in order, regular expressions on a string.

Parameter c:value as="xsd:string?"

The value to be massaged.

Parameter c:pass as="element(pass)?"

A pass of the conversion

This is the location of the common configuration file used to express where common components are found when creating extension or additional document schemas. No schema fragments are created for the artefacts described in this file, only the artefacts in the config-uri= file. It is assumed that the base output directory expressed by this configuration file is the same as that expressed by the main configuration file, such that common subdirectories can be matched.

The model details; when using Saxon use +details=filename

The filename of the main configuration file as a URI. A relative URI is resolved relative to the base URI of the input genericode file.

The configuration file describes all of the directories and files that are created or files that are needed by the files that are created. The file types are indicated using the type= attribute. The files that are created are:

• CVA - created context/value association file
  • there are as many of these entries as CVA files need to be created
  • each CVA file points to a skeleton CVA file in which <Context> elements have annotations that signal the modification of the address= attribute with the union of all BBIE elements, by name, using the BBIE namespace prefix

  • <Annotation>
      <AppInfo>
        <c:DataType>Measure. Type</c:DataType>
      </AppInfo>
    </Annotation>

• SABIE - created supplemental library ABIE schema file
• SBBIE - created supplemental library BBIE schema file
• XABIE - created extension point ABIE schema file
• AABIE - created additional document ABIE schema file
• CABIE - created common library ABIE schema file
• CBBIE - created common library BBIE schema file
• DABIE - created document ABIE schema file
  • there are as many of these DABIE entries as document schemas need to be created
  • when supplemental/extension/additional schema files are being created, and only one set of such schema files can be created in any given execution, the common schema files are not created
  • when the element name is <file>, a single file is created with the given file name
  • when the element name is <files>, all document ABIE files are created using the name and namespace as a substitution pattern where "%n" is replaced with the name of the document ABIE (not the model name)
  • note that the <files> directive will not create a file for a document ABIE for which there is a corresponding <file> directive

The files that are referenced are:

• QDT - referenced qualified data types file
• UDT - referenced unqualified data types file
• DOC - documentation namespace (no actual file)
• EXT - referenced extension content file (optional)
  • the child of this entry is an XSD reference to the extension point to be included in every document schema as the first child of the document element

The configuration file is organized by multiple directory parent elements that are used to calculate relative URI references for XSD import directives. There need not be any directory entries. The directory entry with the attribute runtime-name= triggers the recreation of the suite of contained files in the given alternative directory, but with XSD documentation constructs removed.

All allowed abbreviations must be itemized as these are the portions of element names that do not satisfy the UpperCamelCase convention.

All allowed unqualified data types must be itemized to ensure nothing unsupported is asked for.

A common comment can be defined for all files for which a specific comment is not provided. This comment is placed at the start of the file created. There are a number of substitution variables available for this comment:

• %% - a single percent sign
• %f - the output filename (with config path)
• %n - the output ABIE name (no config path)
• %t - the local time of file creation
• %z - the UTC (Zulu) time of file creation

The example for a test file similar to the UBL project (but modified to illustrate distinctions between <files> and <file> for documents) is as follows:

<!DOCTYPE configuration
[
<!ENTITY versionDisplay "2.1 OS">
<!ENTITY versionDirectory   "os-UBL-2.1">
<!ENTITY versionDate        "04 November 2013">
]>
<configuration xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <!--
    This is the configuration of the base schema fragments for UBL 2.1
  -->
 <ndr>
  <abbreviations>
    <abbreviation short="CV2">Card Verification Value</abbreviation>
    <abbreviation short="ID">Identifier</abbreviation>
    <abbreviation short="URI">Uniform Resource Identifier</abbreviation>
    <abbreviation short="UNDG">United Nations Development Group</abbreviation>
    <abbreviation short="UBL">Universal Business Language</abbreviation>
    <abbreviation short="UUID">Universally Unique Identifier</abbreviation>
    <abbreviation short="XPath">XML Path Language</abbreviation>
  </abbreviations>
  <equivalences>
    <equivalence>
      <primary-noun>URI</primary-noun>
      <representation-term>Identifier</representation-term>
    </equivalence>
    <equivalence>
      <primary-noun>UUID</primary-noun>
      <representation-term>Identifier</representation-term>
    </equivalence>
  </equivalences>
  <expected-maindoc-BIEs>
    <property-term type="BBIE" cardinality="0..1" order="1"
                                  >UBL Version Identifier</property-term>
    <property-term type="BBIE" cardinality="0..1" order="2"
                                  >Customization Identifier</property-term>
    <property-term type="BBIE" cardinality="0..1" order="3"
                                  >Profile Identifier</property-term>
    <property-term type="BBIE" cardinality="0..1" order="4"
                                  >Profile Execution Identifier</property-term>
    <property-term type="ASBIE" cardinality="0..n"
                                  >Signature</property-term>
  </expected-maindoc-BIEs>
  <types>
    <type>Amount</type>
    <type>Binary Object</type>
    <type>Code</type>
    <type>Date Time</type>
    <type>Date</type>
    <type>Graphic</type>t
    <type>Identifier</type>
    <type>Indicator</type>
    <type>Measure</type>
    <type>Name</type>
    <type>Numeric</type>
    <type>Percent</type>
    <type>Picture</type>
    <type>Quantity</type>
    <type>Rate</type>
    <type>Sound</type>
    <type>Text</type>
    <type>Time</type>
    <type>Value</type>
    <type>Video</type>
  </types>
 </ndr>
 <schema version="2.1">
<comment>
  Library:           OASIS Universal Business Language (UBL) &versionDisplay;
                     http://docs.oasis-open.org/ubl/&versionDirectory;/
  Release Date:      &versionDate;
  Module:            %f
  Generated on:      %z
  Copyright (c) OASIS Open 2013. All Rights Reserved.
</comment>
    <copyright position="end">
  OASIS takes no position regarding the validity or scope of any 
  intellectual property 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; neither does it represent that it has 
  made any effort to identify any such rights. Information on OASIS's 
  procedures with respect to rights in OASIS specifications can be 
  found at the OASIS website. Copies of claims of rights made 
  available for publication 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 
  implementors or users of this specification, can be obtained from 
  the OASIS Executive Director.

  OASIS invites any interested party to bring to its attention any 
  copyrights, patents or patent applications, or other proprietary 
  rights which may cover technology that may be required to 
  implement this specification. Please address the information to the 
  OASIS Executive Director.
  
  This document and translations of it may be copied and furnished to 
  others, and derivative works that comment on or otherwise explain 
  it or assist in its implementation may be prepared, copied, 
  published and distributed, in whole or in part, without restriction of 
  any kind, provided that the above copyright notice and this 
  paragraph are included on all such copies and derivative works. 
  However, this document itself may not be modified in any way, 
  such as by removing the copyright notice or references to OASIS, 
  except as needed for the purpose of developing OASIS 
  specifications, in which case the procedures for copyrights defined 
  in the OASIS Intellectual Property Rights document must be 
  followed, or as required to translate it into languages other than 
  English. 

  The limited permissions granted above are perpetual and will not be 
  revoked by OASIS or its successors or assigns. 

  This document and the information contained herein is provided on 
  an "AS IS" basis and OASIS DISCLAIMS 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.    
</copyright>
    <type-documentation>
      <ccts:Component xmlns:ccts="urn:un:unece:uncefact:documentation:2">
         <ccts:ComponentType>ComponentType</ccts:ComponentType>
         <ccts:DictionaryEntryName>DictionaryEntryName</ccts:DictionaryEntryName>
         <ccts:Version>Version</ccts:Version>
         <ccts:Definition>Definition</ccts:Definition>
         <ccts:Cardinality>Cardinality</ccts:Cardinality>
         <ccts:ObjectClassQualifier>ObjectClassQualifier</ccts:ObjectClassQualifier>
         <ccts:ObjectClass>ObjectClass</ccts:ObjectClass>
         <ccts:PropertyTermQualifier>PropertyTermQualifier</ccts:PropertyTermQualifier>
         <ccts:PropertyTerm>PropertyTerm</ccts:PropertyTerm>
         <ccts:AssociatedObjectClass>AssociatedObjectClass</ccts:AssociatedObjectClass>
         <ccts:RepresentationTerm>RepresentationTerm</ccts:RepresentationTerm>
         <ccts:DataTypeQualifier>DataTypeQualifier</ccts:DataTypeQualifier>
         <ccts:DataType>DataType</ccts:DataType>
         <ccts:AlternativeBusinessTerms>AlternativeBusinessTerms</ccts:AlternativeBusinessTerms>
         <ccts:Examples>Examples</ccts:Examples>
      </ccts:Component>
    </type-documentation>
    <dir name="xsd" runtime-name="xsdrt">
      <dir name="common">
        <file type="CABIE" name="UBL-CommonAggregateComponents-2.1.xsd"
              prefix="cac"
namespace="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"/>
        <file type="CBBIE" name="UBL-CommonBasicComponents-2.1.xsd"
              prefix="cbc"
namespace="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2"/>
        <file type="QDT" name="UBL-QualifiedDataTypes-2.1.xsd"
              prefix="qdt"
namespace="urn:oasis:names:specification:ubl:schema:xsd:QualifiedDataTypes-2"/>
        <file type="UDT" name="UBL-UnqualifiedDataTypes-2.1.xsd"
              prefix="udt"
namespace="urn:oasis:names:specification:ubl:schema:xsd:UnqualifiedDataTypes-2"/>
        <file type="EXT" name="UBL-CommonExtensionComponents-2.1.xsd"
              prefix="ext"
namespace="urn:oasis:names:specification:ubl:schema:xsd:CommonExtensionComponents-2">
          <elements>
           <xsd:element ref="ext:UBLExtensions" minOccurs="0" maxOccurs="1">
              <xsd:annotation>
                 <xsd:documentation>A container for all extensions present in the document.</xsd:documentation>
              </xsd:annotation>
           </xsd:element>
          </elements>
        </file>
      </dir>
      <dir name="maindoc">
        <files type="DABIE" name="UBL-%n-2.1.xsd"
               namespace="urn:oasis:names:specification:ubl:schema:xsd:%n-2">
          <element-documentation>This element MUST be conveyed as the root element in any instance document based on this Schema expression</element-documentation>
        </files>
      </dir>
    </dir>
 </schema>
</configuration>

The example for a user-defined extension for UBL 2.1 is as follows for the committee's signature extension (note how there is no duplication needed for the copyright or other metadata to be reused from UBL 2.1):

<configuration xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               version="2.1">
    <dir name="xsd" runtime-name="xsdrt">
      <dir name="common">
        <file type="XABIE" name="UBL-CommonSignatureComponents-2.1.xsd"
              abie="UBLDocumentSignatures"
namespace="urn:oasis:names:specification:ubl:schema:xsd:CommonSignatureComponents-2"/>
        <file type="SABIE" name="UBL-SignatureAggregateComponents-2.1.xsd"
              prefix="sac"
namespace="urn:oasis:names:specification:ubl:schema:xsd:SignatureAggregateComponents-2">
          <imports>

   <!-- ===== Incorporate W3C signature specification-->
   <xsd:import namespace="http://www.w3.org/2000/09/xmldsig#" 
               schemaLocation="UBL-xmldsig-core-schema-2.1.xsd"/>

   <!-- ===== Incorporate ETSI signature specifications-->
   <xsd:import namespace="http://uri.etsi.org/01903/v1.3.2#" 
               schemaLocation="UBL-XAdESv132-2.1.xsd"/>
   <xsd:import namespace="http://uri.etsi.org/01903/v1.4.1#"
               schemaLocation="UBL-XAdESv141-2.1.xsd"/>
          </imports>
          <elements xmlns:ds="http://www.w3.org/2000/09/xmldsig#"
                    abie="SignatureInformation">
         <xsd:element ref="ds:Signature" minOccurs="0" maxOccurs="1">
           <xsd:annotation>
             <xsd:documentation>This is a single digital signature as defined by the W3C specification.</xsd:documentation>
           </xsd:annotation>
         </xsd:element>
          </elements>
        </file>
        <file type="SBBIE" name="UBL-SignatureBasicComponents-2.1.xsd"
              prefix="sbc"
namespace="urn:oasis:names:specification:ubl:schema:xsd:SignatureBasicComponents-2"/>
      </dir>
    </dir>
  </configuration>

The example for a user-defined additional document for UBL 2.1 is as follows for a fictional pair of Return Authorization documents:

<configuration xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               version="2.1">
  <!--
    This is the configuration of an example of additional documents for UBL 2.1
  -->
    <comment>
  Library:           My library of Return Authorization documents
  Module:            %f
  Generated on:      %z
</comment>
    <copyright position="end">
  Test copyright
</copyright>
    <dir name="cva">
      <file type="CVA" name="MyRA-Qualifications.cva"
            skeleton-uri="UBL-2.1-CVA-Skeleton.cva"/>
    </dir>
    <dir name="xsd" runtime-name="xsdrt">
      <dir name="mydoc">
        <file type="SABIE" name="MyRAAggregateComponents.xsd" prefix="raa"
      namespace="urn:X-MyCompany:xsd:MyRARequestResponse:AggregateComponents"/>
        <file type="SBBIE" name="MyRABasicComponents.xsd" prefix="rab" 
          namespace="urn:X-MyCompany:xsd:MyRARequestResponse:BasicComponents"/>
        <files type="AABIE" name="My%n.xsd"
               namespace="urn:X-MyCompany:xsd:My%n"/>
      </dir>
    </dir>
  </configuration>

This is the access to the "main" configuration file as a node tree.

This is the access to the file specifications from the

This is the access to the "other" configuration file as a node tree.

This is the access to the combination configuration file as a node tree.

Index the files in the directory structure of the configuration file.

Determine the library model from all models in the common genericode file for an extension/addition.

Summary set of all document ABIEs.

Summary list of all document ABIE names.

Summary set of all document ABIEs.

Summary list of document model names is found by the name of every ABIE that is not in the common library.

Summary list of documents classes is found by the name of every ABIE that is not in the common library.

Handy prefix definition so as not to keep looking it up.

Handy prefix definition so as not to keep looking it up.

Handy prefix definition so as not to keep looking it up.

Handy prefix definition so as not to keep looking it up.

Substitute key replacement strings in a given string

Parameter name as="xsd:string"

That value to use to substitute for the ABIE name value

Parameter string as="xsd:string"

The string in which are found the substitution requests.

Report a start tag for error messages.

Parameter this as="element()"

The element being reported

Return a row's column value based on a column reference

Parameter row as="element(Row)"

The row of the genericode file.

Parameter col as="xsd:string*"

The column reference of the value in the row. Note that multiple column references are allowed, but only one of the column references is allowed to match. If the row matches more than one column name given, this will abend in a runtime error.

Return a compressed value from a string

Parameter item as="item()?"

The value to be compressed.

Return a compressed value from a column

Parameter row as="element(Row)"

The row of the genericode file.

Parameter col as="xsd:string+"

The column reference of the value in the row. Note that multiple column references are allowed, but only one of the column references is allowed to match. If the row matches more than one column name given, this will abend in a runtime error.