complexType "Reference"

Namespace:	http://www.ivoa.net/xml/VODML/v1
Content:	complex, 1 attribute, 5 elements
Defined:	globally in vo-dml.xsd; see XML source
Used:	at 1 location

XML Representation Summary

<...

xs:string

Content:

vodml-id, name, description?, datatype, multiplicity

</...>

Content Model Elements (5):

All Direct / Indirect Based Elements (1):

Known Usage Locations

As direct type of elements (1):
reference (type Reference)

A Reference is a Relation that indicates a kind of "usage" relationship between the target ObjectType and the owner of the reference, the "referrer". The referrer can be an ObjectType (typically) but also a DataType. The relation is looser than the composition relationship, acting like a semantically meaningful pointer rather than indicating a component of the referrer. Consequently, in general many referrers can point at the same target instance, and ObjectType-s can be the target in different reference definitions. The lifecycle of the target is not bound to that of the referrer. Often the target instance is used to provide a context for the definition of the referrer. For example a coordinate frame may be referenced to provide context to coordinate values. TBD more needed ...?

Type Definition Detail

Type Derivation Tree

ReferableElement (extension)

Role (extension)

Relation (extension)

Reference

XML Source (see within schema source)

<xsd:complexType name="Reference">

<xsd:annotation>

<xsd:documentation>

A Reference is a Relation that indicates a kind of "usage" relationship
between the target ObjectType and the owner of the reference, the "referrer".
The referrer can be an ObjectType (typically) but also a DataType.
The relation is
looser than the composition relationship, acting like a
semantically meaningful pointer rather than indicating a component of the referrer.
Consequently, in general many referrers can point at the same target instance,
and ObjectType-s can
be the target in different reference definitions.
The lifecycle of the target is not bound to that of the referrer.
Often the target instance is used to provide a context for the definition of
the referrer. For example a coordinate frame may be
referenced to provide context to coordinate values.
TBD more needed ...?

</xsd:documentation>

</xsd:annotation>

<xsd:complexContent>

<xsd:extension base="Relation">

<xsd:annotation>

<xsd:documentation>

TBD Should have multiplicity 0..1 or 1?

</xsd:documentation>

</xsd:annotation>

</xsd:extension>

</xsd:complexContent>

</xsd:complexType>

Attribute Detail (all declarations; 1)

Type:	xsd:string
Use:	optional
Defined:	locally within ReferableElement complexType

A referencable element may be given an @id attribute to reflect an identifier defined in some source document form which a VO-DML model may have been derived.

XML Source (see within schema source)

<xsd:attribute name="id" type="xsd:string" use="optional">

<xsd:annotation>

<xsd:documentation>

A referencable element may be given an @id attribute to reflect an identifier
defined in some source document form which a VO-DML model may have been derived.

</xsd:documentation>

</xsd:annotation>

</xsd:attribute>

Content Element Detail (all declarations; 5)

Type:	ElementRef, complex content
Defined:	locally within Role complexType

Reference to the type that plays the role represented by this Role.

XML Source (see within schema source)

<xsd:element name="datatype" type="ElementRef">

<xsd:annotation>

<xsd:documentation>

Reference to the type that plays the role represented by this Role.

</xsd:documentation>

</xsd:annotation>

</xsd:element>

Type:	xsd:string, simple content
Defined:	locally within ReferableElement complexType

Human readable description of the model element.

XML Source (see within schema source)

<xsd:element minOccurs="0" name="description" type="xsd:string">

<xsd:annotation>

<xsd:documentation>

Human readable description of the model element.

</xsd:documentation>

</xsd:annotation>

</xsd:element>

Type:	Multiplicity, complex content
Defined:	locally within Role complexType

The multiplicity of the role (also called cardinality) indicates whether it must have a value or may be without value, or possibly how many values are allowed.

XML Source (see within schema source)

<xsd:element name="multiplicity" type="Multiplicity">

<xsd:annotation>

<xsd:documentation>

The multiplicity of the role (also called cardinality) indicates whether it must have a
value or may be without value, or possibly how many values are allowed.

</xsd:documentation>

</xsd:annotation>

</xsd:element>

Type:	VODMLName, simple content
Defined:	locally within ReferableElement complexType

The name of the model element. MUST NOT be an empty string.

XML Source (see within schema source)

<xsd:element minOccurs="1" name="name" type="VODMLName">

<xsd:annotation>

<xsd:documentation>

The name of the model element.
MUST NOT be an empty string.

</xsd:documentation>

</xsd:annotation>

</xsd:element>

Type:	VODMLID, simple content
Defined:	locally within ReferableElement complexType

Identifier for its containing element. Extracted as a separate type so that we can easily adapt to a different identifier design.

XML Source (see within schema source)

<xsd:element minOccurs="1" name="vodml-id" type="VODMLID">

<xsd:annotation>

<xsd:documentation>

Identifier for its containing element.
Extracted as a separate type so that we can easily adapt to a different identifier design.

</xsd:documentation>

</xsd:annotation>

</xsd:element>

This XML schema documentation has been generated with DocFlex/XML RE 1.8.0 using DocFlex/XML XSDDoc 2.2.0 template set.

DocFlex/XML RE is a reduced edition of DocFlex/XML, which is a tool for programming and running highly sophisticated documentation and reports generators by the data obtained from any kind of XML files. The actual doc-generators are implemented in the form of special templates that are designed visually using a high quality Template Designer GUI basing on the XML schema (or DTD) files describing the data source XML.

DocFlex/XML XSDDoc is a commercial template application of DocFlex/XML that implements a high-end XML Schema documentation generator with simultaneous support of framed multi-file HTML, single-file HTML and RTF output formats. (More formats are planned in the future).

A commercial license for "DocFlex/XML XSDDoc" will allow you:

To configure the generated documentation so much as you want. Thanks to our template technology, it was possible to support more than 300 template parameters (working the same as "options" of an ordinary doc-gen), which will give you an unprecedented control over the generated content!
To use certain features disabled in the free mode (such as the full documenting of substitution groups).
To enable/disable documenting of the initial, imported, included and redefined XML schemas selectively.
To document local element components both globally and locally (similar to attributes).
To enable/disable reproducing of namespace prefixes.
To format your annotations with XHTML tags and reproduce that formatting both in HTML and RTF output.
To insert images in your annotations using XHTML <img> tags (supported both in HTML and RTF output).
To use PlainDoc.tpl main template to generate all the XML schema documentation in the form of a single HTML file.
To use the same template to generate the incredible quality RTF documentation.
To document only selected XML schema components specified by name.
To remove this very advertisement text

Once having only such a license, you will be able to run the fully-featured XML schema documentation generator both with DocFlex/XML SDK and with DocFlex/XML RE, which is a reduced free edition containing only the template interpretor / output generator. No other licenses will be required!

But this is not all. In addition to it, a commercial license for DocFlex/XML SDK will allow you to modify the XSDDoc templates themselves as much as you want. You will be able to achieve whatever was impossible to do with the template parameters only. And, of course, you could develop any template applications by your own!

Please note: By purchasing a license for this software, you not only acquire a useful tool, you will also make an important investment in its future development, the result of which you could enjoy later by yourself. Every single your purchase matters and makes a difference for us!

To buy a license, please follow this link: http://www.filigris.com/shop/