• Chapter 1: Getting Started with Stylus Studio®
• Chapter 2: Editing and Querying XML
• Chapter 3: Converting Non-XML Files to XML
• Chapter 4: Working with XSLT
• Chapter 5: Creating XSLT Using the XSLT Mapper
• Chapter 6: Debugging Stylesheets
• Chapter 7: Defining XML Schemas
  • What Is an XML Schema?
  • Creating an XML Schema in Stylus Studio
  • Working with XML Schema in Stylus Studio
  • Getting Started with XML Schema in the Tree View
  • Defining simpleTypes in XML Schemas
  • Defining complexTypes in XML Schemas
  • Defining Elements and Attributes in XML Schemas
  • Defining Groups of Elements and Attributes in XML Schemas
  • Adding Comments, Annotation, and Documentation Nodes to XML Schemas
  • Defining Notations
  • Referencing External XML Schemas
    • Ways to Reference XML Schemas
      • Including an XML Schema
      • Importing an XML Schema
      • Redefining an XML Schema
    • Where You Can Reference XML Schemas
    • Referencing XML Schemas in the Diagram View
    • Referencing XML Schemas in the Tree View
    • Redefining Nodes
  • Generating Documentation for XML Schema
  • Generating JAXB Classes
  • About XML Schema Properties
• Chapter 8: Defining Document Type Definitions
• Chapter 9: Writing XPath Expressions
• Chapter 10: Working with XQuery in Stylus Studio
• Chapter 11: Composing Web Service Calls
• Chapter 12: Accessing Relational Data as XML
• Chapter 13: Building XML Pipelines
• Chapter 14: Publishing XML Data
• Chapter 15: Integrating with Third-Party File Systems
• Chapter 16: Extending Stylus Studio
• Chapter 17: The Stylus Studio Java API
• Chapter 18: Stylus Studio GUI Reference

Home > Online Product Documentation > Table of Contents > Ways to Reference XML Schemas

Ways to Reference XML Schemas

There are three ways to reference XML Schema:

This section describes each of these techniques and how they can be used. In these descriptions, we use the term referenced XML Schema to indicate the XML Schema that is being included, imported, or redefined; and base XML Schema to indicate the XML Schema in which the referenced schema is being included, imported, or redefined.

Including an XML Schema

When reference an XML Schema by including it, the included XML Schema augments the base XML Schema. Both documents are effectively combined, and they both define the same XML Schema. complexTypes defined in the included XML Schema can be used as the base for new types - you might use a periodicals complexType from the included XML Schema to define weekly and quarterly types for example. Both the included XML Schema and the base XML Schema must have the same target namespace. You can include multiple XML Schemas in a base XML Schema.

Importing an XML Schema

When you reference an XML Schema by importing it, the base XML Schema and the imported XML Schema must have difference namespaces. The base XML Schema can the reference parts of the imported XML schema using a prefix whose namespace is defined in the imported XML Schema, for example. You can import multiple XML Schemas in a base XML Schema.

Redefining an XML Schema

Referencing an XML Schema by redefining it is similar to including it, with one important difference: when you redefine an XML Schema in the base XML Schema, you can redefine the definitions of the referenced XML Schema's complexTypes, simpleTypes, groups, and attributeGroups. For example, suppose you release version 1 of an XML Schema. When you need to release version 2 of the XML Schema, you can reference version 1 by redefining it in version 2, which allows you to change the definition of a given node to include a new attribute.

The original complexTypes, simpleTypes, groups, and attributeGroups in the redefined XML Schema are completely masked. They are redefined using extensions and restrictions. An extension extends the base type - declaring a new element, for example. A restriction constrains the base type.