Conventions XML d'ASSL

Analysis Services Scripting Language (ASSL) représente la hiérarchie des objets sous la forme d’un ensemble de types d’éléments, chacun définissant les éléments enfants qu’ils peuvent contenir.

Pour représenter la hiérarchie d’objets, ASSL utilise les conventions XML suivantes :

• Tous les objets et propriétés sont représentés en tant qu’éléments, à l’exception des attributs XML standard tels que « xml :lang ».

• Les noms d’éléments et les valeurs d’énumération suivent la convention d’affectation de noms Microsoft .NET Framework de La casse Pascal sans trait de soulignement.

• La casse de toutes les valeurs est conservée. Les valeurs des énumérations respectent également la casse.

En plus de cette liste de conventions, Analysis Services suit également certaines conventions concernant la cardinalité, l’héritage, l’espace blanc, les types de données et les valeurs par défaut.

Cardinalité

Lorsqu’un élément a une cardinalité supérieure à 1, il existe une collection d’éléments XML qui encapsule cet élément. Le nom de la collection utilise la forme plurielle des éléments contenus dans la collection. Par exemple, le fragment XML suivant représente la Dimensions collection dans un Database élément :

<Database>

...

<Dimensions>

<Dimension>

...

</Dimension>

<Dimension>

...

</Dimension>

</Dimensions>

</Database>

``

L’ordre dans lequel les éléments apparaissent n’est pas important.

Héritage

L’héritage est utilisé lorsqu’il existe des objets distincts qui se chevauchent mais qui ont des ensembles de propriétés nettement différents. Par exemple, ces objets se chevauchent mais sont des cubes virtuels, des cubes liés et des cubes réguliers. Pour le chevauchement mais l’objet distinct, Analysis Services utilise l’attribut standard type de l’espace de noms d’instance XML pour indiquer l’héritage. Par exemple, le fragment XML suivant montre comment l’attribut type identifie si un élément hérite d’un Cube cube normal ou d’un cube virtuel :

<Cubes>

<Cube xsi:type="RegularCube">

<Name>Sales</Name>

...

</Cube>

<Cube xsi:type="VirtualCube">

<Name>SalesAndInventory</Name>

...

</Cube>

</Cubes>

``

L’héritage n’est généralement pas utilisé lorsque plusieurs types ont une propriété du même nom. Par exemple, les Name propriétés apparaissent ID sur de nombreux éléments, mais ces propriétés n’ont pas été promues en un type abstrait.

Espace blanc

L’espace blanc dans une valeur d’élément est conservé. Toutefois, les espaces blancs de début et de fin sont toujours coupés. Par exemple, les éléments suivants ont le même texte, mais des quantités différentes d’espaces blancs dans ce texte, et sont donc traités comme s’ils ont des valeurs différentes :

<Description>My text<Description>

<Description>My text<Description>

``

Toutefois, les éléments suivants varient uniquement en espaces blancs de début et de fin, et sont donc traités comme s’ils ont des valeurs équivalentes :

<Description>My text<Description>

<Description> My text <Description>

``

Types de données

Analysis Services utilise les types de données XSD (Xml Schema Definition Language) standard suivants :

Int
Valeur entière dans la plage de -231 à 231 à 1.

Long
Valeur entière comprise entre -263 et 263 - 1.

String
Valeur de chaîne conforme aux règles globales suivantes :

• Les caractères de contrôle sont supprimés.

• L’espace blanc de début et de fin est coupé.

• L’espace blanc interne est conservé.

Name et ID les propriétés ont des limitations spéciales sur les caractères valides dans les éléments de chaîne. Pour plus d’informations sur Name les conventions et ID les conventions, consultez objets et caractéristiques d’objet ASSL.

DateTime
Structure DateTime du .NET Framework. Une DateTime valeur ne peut pas être NULL. La date la plus basse prise en charge par le DataTime type de données est le 1er janvier 1601, qui est disponible pour les programmeurs en tant que DateTime.MinValue. La date prise en charge la plus basse indique qu’une DateTime valeur est manquante.

Boolean
Énumération avec seulement deux valeurs, telles que {true, false} ou {0, 1}.

Valeurs par défaut

Analysis Services utilise les valeurs par défaut répertoriées dans le tableau suivant.

Un élément présent, mais vide, est interprété comme ayant une valeur d’une chaîne Null, et non comme la valeur par défaut.

Valeurs par défaut héritées

Certaines propriétés spécifiées sur un objet fournissent des valeurs par défaut pour la même propriété sur les objets enfants ou descendants. Par exemple, Cube.StorageMode fournit la valeur par défaut pour Partition.StorageMode. Les règles que Analysis Services applique pour les valeurs par défaut héritées sont les suivantes :

• Lorsque la propriété de l’objet enfant a la valeur Null dans le code XML, sa valeur est définie par défaut sur la valeur héritée. Toutefois, si vous interrogez la valeur du serveur, le serveur retourne la valeur Null de l’élément XML.

• Il n’est pas possible de déterminer par programme si la propriété d’un objet enfant a été définie directement sur l’objet enfant ou héritée.

Certains éléments ont défini des valeurs par défaut qui s’appliquent lorsque l’élément est manquant. Par exemple, les Dimension éléments du fragment XML suivant sont équivalents même si un Dimension élément contient un Visible élément, mais l’autre Dimension élément ne le fait pas.

<Dimension>

<Name>Product</Name>

</Dimension>

<Dimension>

<Name>Product</ Name>

<Visible>true</Visible>

</Dimension>

Pour plus d’informations sur les valeurs par défaut héritées, consultez Objets ASSL et Caractéristiques d’objet.