2.2.4.2.2.8.3 Relationship
The Relationship complex type specifies a relationship between in-memory Dimensions.<75>
The following elements are defined in the eng300_300 namespace.
-
<xsd:complexType name="Relationship"> <xsd:sequence> <xsd:element name ="ID" type="xsd:string" /> <xsd:element name="Visible" type="xsd:boolean" /> <xsd:element name="FromRelationshipEnd" type="eng300_300:RelationshipEnd" /> <xsd:element name="ToRelationshipEnd" type="eng300_300:RelationshipEnd" /> </xsd:sequence> </xsd:complexType> <xsd:complexType name="RelationshipEnd"> <xsd:sequence> <xsd:element name="Role" type="xsd:string"/> <xsd:element name="Multiplicity" > <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:enumeration value="One" /> <xsd:enumeration value="Many" /> </xsd:restriction> </xsd:simpleType> </xsd:element> <xsd:element name="DimensionID" type="xsd:string"/> <xsd:element name="Attributes" minOccurs="0" > <xsd:complexType> <xsd:sequence> <xsd:element name="Attribute" minOccurs="0" maxOccurs="unbounded"> <xsd:complexType> <xsd:sequence> <xsd:element name="AttributeID" type="xsd:string"/> </xsd:sequence> </xsd:complexType> </xsd:element> </xsd:sequence> </xsd:complexType> </xsd:element> <xsd:element name="Translations" minOccurs="0"> <xsd:complexType> <xsd:sequence> <xsd:element name="Translation" type="eng300_300:RelationshipEndTranslation" minOccurs="0" maxOccurs="unbounded"/> </xsd:sequence> </xsd:complexType> </xsd:element> <xsd:element name="VisualizationProperties" type="eng300:RelationshipEndVisualizationProperties" minOccurs="0" maxOccurs="1" /> </xsd:sequence> </xsd:complexType> <xsd:complexType name="RelationshipEndTranslation"> <xsd:all> <xsd:element name="Language" type="xsd:unsignedInt"/> <xsd:element name="Caption" type="xsd:string" minOccurs="0"/> <xsd:element name="CollectionCaption" type="xsd:string"/> <xsd:element name="Description" type="xsd:string" minOccurs="0"/> <xsd:element name="DisplayFolder" type="xsd:string" minOccurs="0"/> <xsd:element name="Annotations" minOccurs="0"> <xsd:complexType> <xsd:sequence> <xsd:element name="Annotation" type="eng300_300:Annotation" minOccurs="0" maxOccurs="unbounded"/> </xsd:sequence> </xsd:complexType> </xsd:element> </xsd:all> </xsd:complexType> <xsd:complexType name="Annotation"> <xsd:all> <xsd:element name="Name" type="xsd:string"/> <xsd:element name="Visibility" minOccurs="0"> <xsd:simpleType> <xsd:restriction base="xsd:string" > <xsd:enumeration value="SchemaRowset" /> <xsd:enumeration value="None" /> </xsd:restriction> </xsd:simpleType> </xsd:element> <xsd:element name="Value" type="xsd:anyType" /> </xsd:all> </xsd:complexType>
The following elements are defined in the namespace eng300:
-
<xsd:complexType name="RelationshipEndVisualizationProperties"> <xsd:sequence> <!-- we do not put displayfolder in visualization properties because it already is in plain udm on other objects --> <!--<xsd:element name="DisplayFolder" type="xsd:boolean" minOccurs="0" maxOccurs="1"/>--> <xsd:element name="FolderPosition" type="xsd:integer" minOccurs="0" maxOccurs="1" default="-1"/> <xsd:element name="ContextualNameRule" minOccurs="0" maxOccurs="1" default="None"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:enumeration value="None" /> <xsd:enumeration value="Context" /> <xsd:enumeration value="Merge" /> </xsd:restriction> </xsd:simpleType> </xsd:element> <xsd:element name="DefaultDetailsPosition" type="xsd:integer" minOccurs="0" maxOccurs="1" default="-1"/> <xsd:element name="DisplayKeyPosition" type="xsd:integer" minOccurs="0" maxOccurs="1" default="-1"/> <xsd:element name="CommonIdentifierPosition" type="xsd:integer" minOccurs="0" maxOccurs="1" default="-1"/> <xsd:element name="IsDefaultMeasure" type="xsd:boolean" minOccurs="0" maxOccurs="1" default="false"/> <xsd:element name="IsDefaultImage" type="xsd:boolean" minOccurs="0" maxOccurs="1" default="false"/> <xsd:element name="SortPropertiesPosition" type="xsd:integer" minOccurs="0" maxOccurs="1" default="-1"/> </xsd:sequence> </xsd:complexType>
Element |
Read-Only |
Default value |
Description |
---|---|---|---|
ID |
|
[Required] |
The object ID string. |
Visible |
|
|
Provides a hint to client applications that this Relationship is not to be exposed. |
FromRelationshipEnd |
|
|
A collection of properties that defines the characteristics of the Relationship-End. |
ToRelationshipEnd |
|
|
A collection of properties that defines the characteristics of the Relationship-End. |
Role |
|
|
Identifies one end of a one-to-many relationship |
Multiplicity |
|
|
Indicates whether the RelationshipEnd is at the "one" side or the "many" side of a relationship. The enumeration values are:
|
DimensionID |
|
|
The Dimension associated with this end of the relationship. |
Attributes |
|
|
A collection of DimensionAttribute complex types that denote the columns that are participating in this key. |
Translations |
|
Empty |
A collection of Translation objects. |
VisualizationProperties |
|
|
A collection of properties that can be used by tools to specify the set of visualization and enhanced formatting information of the Relationship. |
Language |
|
[Required] |
The locale ID of the language. For more details on locale identifiers, see [MS-LCID]. |
Caption |
|
Empty |
The caption of the object in the language represented by the Language element. |
CollectionCaption |
|
Empty |
The caption of a collection of objects. |
Description |
|
Empty |
The object description. |
DisplayFolder |
|
Empty |
The folder in which the object is displayed. |
Annotations |
|
Empty |
A collection of Annotation objects. |
FolderPosition |
|
-1 |
Provides a hint to client applications to suggest the position that this relationship might hold among the other elements that share the same display folder. |
ContextualNameRule |
|
"None" |
Provides a hint to client applications to suggest how to create unambiguous names for this attribute. The following values are allowed:
§ "Merge" – Attending to language grammar, concatenate the incoming relationship name and the attribute name. |
DefaultDetailsPosition |
|
-1 |
Provides a hint to client applications to suggest the position that this relationship might hold among the other elements that can be used to summarize a record. |
DisplayKeyPosition |
|
-1 |
Provides a hint to client applications to suggest the position that this relationship might hold among the other user-readable elements that uniquely identify the record. |
CommonIdentifierPosition |
|
-1 |
Provides a hint to client applications to suggest the position that this relationship might hold among the other common elements that can be used to identify the record. |
IsDefaultMeasure |
|
False |
An indication if this measure is automatically used to summarize the dimension. |
IsDefaultImage |
|
False |
An indication if this image is used to represent a record. |
SortPropertiesPosition |
|
-1 |
Provides the ability to place this relationship in the Sort Properties collection of the Dimension. |