ASSL-XML-Konventionen

Analysis Services Scripting Language (ASSL) stellt die Hierarchie von Objekten als eine Reihe von Elementtypen dar, von denen jede die untergeordneten Elemente definiert, die sie enthalten können.

Um die Objekthierarchie darzustellen, verwendet ASSL die folgenden XML-Konventionen:

• Alle Objekte und Eigenschaften werden als Elemente dargestellt, mit Ausnahme von Standard-XML-Attributen wie "xml:lang".

• Sowohl Elementnamen als auch Enumerationswerte folgen der Benennungskonvention von Microsoft .NET Framework bei Pascal-Groß-/Kleinschreibung ohne Unterstriche.

• Die Groß-/Kleinschreibung aller Werte wird beibehalten. Bei Enumerationen wird auch die Groß-/Kleinschreibung beachtet.

Zusätzlich zu dieser Liste der Konventionen folgt Analysis Services auch bestimmten Konventionen hinsichtlich Kardinalität, Vererbung, Leerzeichen, Datentypen und Standardwerten.

Mächtigkeit

Wenn ein Element eine Kardinalität aufweist, die größer als 1 ist, gibt es eine XML-Elementauflistung, die dieses Element kapselt. Der Name der Auflistung verwendet die Pluralform der In der Auflistung enthaltenen Elemente. Beispielsweise stellt das folgende XML-Fragment die Dimensions Auflistung innerhalb eines Database Elements dar:

<Database>

...

<Dimensions>

<Dimension>

...

</Dimension>

<Dimension>

...

</Dimension>

</Dimensions>

</Database>

``

Die Reihenfolge, in der Elemente angezeigt werden, ist unwichtig.

Vererbung

Vererbung wird verwendet, wenn es unterschiedliche Objekte gibt, die sich überlappende, aber erhebliche Sätze von Eigenschaften aufweisen. Beispiele für solche überlappenden, aber unterschiedlichen Objekte sind virtuelle Würfel, verknüpfte Cubes und normale Cubes. Bei überlappenden, aber unterschiedlichen Objekten verwendet Analysis Services das Standard-Attribut type aus dem XML-Instanznamespace, um die Vererbung anzugeben. Das folgende XML-Fragment zeigt beispielsweise, wie das type Attribut identifiziert, ob ein Cube Element von einem regulären Cube oder von einem virtuellen Cube erbt:

<Cubes>

<Cube xsi:type="RegularCube">

<Name>Sales</Name>

...

</Cube>

<Cube xsi:type="VirtualCube">

<Name>SalesAndInventory</Name>

...

</Cube>

</Cubes>

``

Vererbung wird in der Regel nicht verwendet, wenn mehrere Typen über eine Eigenschaft mit demselben Namen verfügen. Beispielsweise werden die Eigenschaften und ID Eigenschaften Name für viele Elemente angezeigt, diese Eigenschaften wurden jedoch nicht zu einem abstrakten Typ heraufgestuft.

Leerzeichen

Leerzeichen innerhalb eines Elementwerts bleiben erhalten. Führende und nachfolgende Leerzeichen werden jedoch immer gekürzt. Die folgenden Elemente weisen beispielsweise denselben Text auf, unterscheiden sich jedoch in unterschiedlichen Leerzeichen innerhalb dieses Texts und werden daher so behandelt, als hätten sie unterschiedliche Werte:

<Description>My text<Description>

<Description>My text<Description>

``

Die folgenden Elemente unterscheiden sich jedoch nur in führenden und nachfolgenden Leerzeichen und werden daher so behandelt, als hätten sie gleichwertige Werte:

<Description>My text<Description>

<Description> My text <Description>

``

Datentypen

Analysis Services verwendet die folgenden standardmäßigen XSD-Datentypen (XML Schema Definition Language):

Int
Ein ganzzahliger Wert im Bereich von -231 bis 231 - 1.

Long
Ein ganzzahliger Wert im Bereich von -263 bis 263 - 1.

String
Ein Zeichenfolgenwert, der den folgenden globalen Regeln entspricht:

• Steuerzeichen werden entfernt.

• Führende und nachfolgende Leerzeichen werden gekürzt.

• Interner Leerraum wird beibehalten.

Name und ID Eigenschaften haben besondere Einschränkungen für gültige Zeichen in Zeichenfolgenelementen. Weitere Informationen Name und ID Konventionen finden Sie unter ASSL-Objekte und -Objektmerkmale.

DateTime
Eine DateTime Struktur aus .NET Framework. Ein DateTime Wert darf nicht NULL sein. Das niedrigste vom Datentyp unterstützte Datum ist der DataTime 1. Januar 1601, der programmierern als DateTime.MinValue. Das niedrigste unterstützte Datum gibt an, dass ein DateTime Wert fehlt.

Boolean
Eine Aufzählung mit nur zwei Werten, z. B. {true, false} oder {0, 1}.

Standardwerte

Analysis Services verwendet die in der folgenden Tabelle aufgeführten Standardwerte.

Ein Element, das vorhanden, aber leer ist, wird als Wert einer NULL-Zeichenfolge interpretiert, nicht als Standardwert.

Geerbte Standardwerte

Einige Eigenschaften, die für ein Objekt angegeben werden, stellen Standardwerte für dieselbe Eigenschaft für untergeordnete oder untergeordnete Objekte bereit. Stellt z. B Cube.StorageMode . den Standardwert für Partition.StorageMode. Die Regeln, die Analysis Services für geerbte Standardwerte gilt, sind wie folgt:

• Wenn die Eigenschaft für das untergeordnete Objekt im XML-Code null ist, wird der Wert standardmäßig auf den geerbten Wert festgelegt. Wenn Sie jedoch den Wert vom Server abfragen, gibt der Server den Nullwert des XML-Elements zurück.

• Es ist nicht möglich, programmgesteuert zu bestimmen, ob die Eigenschaft eines untergeordneten Objekts direkt für das untergeordnete Objekt festgelegt oder geerbt wurde.

Einige Elemente haben Standardeinstellungen definiert, die angewendet werden, wenn das Element fehlt. Beispielsweise sind die Dimension Elemente im folgenden XML-Fragment gleichwertig, obwohl ein Dimension Element ein Visible Element enthält, das andere Dimension Element jedoch nicht.

<Dimension>

<Name>Product</Name>

</Dimension>

<Dimension>

<Name>Product</ Name>

<Visible>true</Visible>

</Dimension>

Weitere Informationen zu geerbten Standardwerten finden Sie unter ASSL-Objekte und -Objektmerkmale.