Cube PerspectiveGet
Returns the definition of the specified perspective.
Request
<Alea:Document xmlns:Alea="http://www.misag.com">
<Alea:Request RequestID="170.2" Class="Cube" Method="PerspectiveGet">
<Alea:Perspective Name="SalesPerspectiveLC1" CheckValidity="true" />
</Alea:Request>
</Alea:Document>
This table describes the XML attributes of the <Alea:Perspective>
XML element:
XML attribute | Description |
---|---|
Name |
Name of the perspective. Perspective names are unique. You are not required to specify the cube on which the perspective was based. |
CheckValidity |
Indicates whether the definition is checked for validity. This attribute is
optional. The default is false. If it is set to true then these checks are
performed:
|
Answer
<Alea:Document xmlns:Alea="http://www.misag.com">
<Alea:Request RequestID="170.2">
<Alea:Return>
<Alea:Perspective Name="SalesPerspectiveLC1" Cube="SALES" ContextRelated="true">
<Alea:Dimension Name="CURRTYPE">
<Alea:ExcludeDimension Hierarchy="CURRTYPE" Element="LC" />
</Alea:Dimension>
<Alea:Dimension Name="PRODUCT" DefaultHierarchy="Tire Size">
<Alea:Hierarchy Name="Speed Rating">
<Alea:DefaultMember Name="Q (99 mph 160 km/h)" />
</Alea:Hierarchy>
<Alea:Hierarchy Name="Tire Size">
<Alea:DefaultMember Name="AS700/205" />
</Alea:Hierarchy>
</Alea:Dimension>
<Alea:Translations>
<Alea:Translation LocaleIdentifier="0">
<Alea:Caption>Sales cube context LC1</Alea:Caption>
<Alea:Description>Sales cube - the perspective for the context local currency 1</Alea:Description>
</Alea:Translation>
<Alea:Translation LocaleIdentifier="7">
<Alea:Caption>Verkaufs-Cube Kontext LW1</Alea:Caption>
<Alea:Description>Verkaufs-Cube - die Perspektive für den Kontext Lokale Währung 1</Alea:Description>
</Alea:Translation>
</Alea:Translations>
</Alea:Perspective>
<Alea:Errors />
</Alea:Return>
</Alea:Request>
</Alea:Document>
If CheckValidity
is set to
true then possible errors are listed within the <Alea:Errors>
XML element. For example, if the base cube of the
perspective does not exist , the answer looks similar to this:
<Alea:Document xmlns:Alea="http://www.misag.com">
<Alea:Request RequestID="170.2">
<Alea:Return>
<Alea:Perspective Name="SalesPerspectiveLC1" Cube="SALES" ContextRelated="true">
<Alea:Dimension Name="CURRTYPE">
<Alea:ExcludeDimension Hierarchy="CURRTYPE" Element="LC" />
</Alea:Dimension>
<Alea:Dimension Name="PRODUCT" DefaultHierarchy="Tire Size">
<Alea:Hierarchy Name="Speed Rating">
<Alea:DefaultMember Name="Q (99 mph 160 km/h)" />
</Alea:Hierarchy>
<Alea:Hierarchy Name="Tire Size">
<Alea:DefaultMember Name="205" />
</Alea:Hierarchy>
</Alea:Dimension>
<Alea:Translations>
<Alea:Translation LocaleIdentifier="0">
<Alea:Caption>Sales cube context LC1</Alea:Caption>
<Alea:Description>Sales cube - the perspective for the context local currency 1</Alea:Description>
</Alea:Translation>
<Alea:Translation LocaleIdentifier="7">
<Alea:Caption>Verkaufs-Cube Kontext LW1</Alea:Caption>
<Alea:Description>Verkaufs-Cube - die Perspektive für den Kontext Lokale Währung 1</Alea:Description>
</Alea:Translation>
</Alea:Translations>
</Alea:Perspective>
<Alea:Errors>
<Alea:GenericError ErrorID="47" />
</Alea:Errors>
</Alea:Return>
</Alea:Request>
</Alea:Document>
Error
In case of general errors, for example if the perspective does not exist, this error is returned:
<Alea:Document xmlns:Alea="http://www.misag.com">
<Alea:Request RequestID="170.2">
<Alea:Return>
<Alea:Error ErrorID="error_code" />
</Alea:Return>
</Alea:Request>
</Alea:Document>
If CheckValidity
is set to false in the request then the
complete <Alea:Errors>
section is omitted.
The meaning of each XML object is explained in the Cube PerspectiveCreate
XML function topic.