Convenciones XML de ASSL

Se aplica a: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Analysis Services Scripting Language (ASSL) representa la jerarquía de objetos como un conjunto de tipos de elemento, cada uno de los cuales define los elementos secundarios que puede contener.

Para representar la jerarquía de objetos, ASSL utiliza las siguientes convenciones XML:

• Todos los objetos y propiedades se representan como elementos, excepto los atributos XML estándar, como "xml:lang".

• Tanto los nombres de elemento como los valores de enumeración siguen la convención de nomenclatura de Microsoft .NET Framework del método Pascal de mayúsculas y minúsculas sin caracteres de subrayado.

• Se conserva el uso de mayúsculas o minúsculas de todos los valores. Los valores de las enumeraciones también distinguen entre mayúsculas y minúsculas.

Además de esta lista de convenciones, Analysis Services sigue también ciertas convenciones con respecto a la cardinalidad, la herencia, el espacio en blanco, los tipos de datos y los valores predeterminados.

Cardinalidad

Cuando la cardinalidad de un elemento es mayor que 1, existe una colección de elementos XML que encapsula este elemento. El nombre de colección utiliza la forma plural de los elementos incluidos en la colección. Por ejemplo, el siguiente fragmento XML representa la colección Dimensions dentro de un elemento Database :

<Database>

...

<Dimensions>

<Dimension>

...

</Dimension>

<Dimension>

...

</Dimension>

</Dimensions>

</Database>

``

El orden en que aparecen los elementos no es significativo.

Herencia

La herencia se utiliza cuando existen objetos distintos con conjuntos de propiedades que se superponen pero son notablemente diferentes. Entre los ejemplos de tales objetos superpuestos pero distintos se encuentran los cubos virtuales, los cubos vinculados y los cubos normales. Para superponer pero distinto objeto, Analysis Services usa el atributo de tipo estándar del espacio de nombres de instancia XML para indicar la herencia. Por ejemplo, el siguiente fragmento XML muestra cómo el atributo de tipo identifica si un elemento Cube hereda de un cubo normal o de un cubo virtual:

<Cubes>

<Cube xsi:type="RegularCube">

<Name>Sales</Name>

...

</Cube>

<Cube xsi:type="VirtualCube">

<Name>SalesAndInventory</Name>

...

</Cube>

</Cubes>

``

Generalmente, la herencia no se utiliza cuando varios tipos tienen una propiedad con el mismo nombre. Por ejemplo, las propiedades Name e ID aparecen en muchos elementos, pero estas propiedades no se han promocionado a un tipo abstracto.

Espacio en blanco

El espacio en blanco dentro de un valor de elemento se conserva. Sin embargo, el espacio en blanco inicial y final siempre se recorta. Por ejemplo, los elementos siguientes tienen el mismo texto pero cantidades distintas de espacio en blanco dentro de dicho texto, por lo tanto se tratan como si tuvieran valores distintos:

<Description>My text<Description>

<Description>My text<Description>

``

Sin embargo, los elementos siguientes solo varían respecto al espacio en blanco inicial y final y, por lo tanto, se tratan como si sus valores fueran equivalentes:

<Description>My text<Description>

<Description> My text <Description>

``

Tipo de datos

Analysis Services utiliza los siguientes tipos de datos del lenguaje de definición de esquema XML (XSD) estándar:

Int
Valor entero en el intervalo de -231 a 231 - 1.

Long
Valor entero en el intervalo de -263 a 263 - 1.

String
Valor de cadena que se ajusta a las reglas globales siguientes:

• Se eliminan los caracteres de control.

• Se recorta el espacio en blanco inicial y final.

• Se conserva el espacio en blanco interno.

Las propiedades name e ID tienen limitaciones especiales sobre los caracteres válidos en los elementos de cadena. Para obtener más información sobre las convenciones de nombre e identificador , vea AsSL Objects and Object Characteristics.

DateTime
Estructura DateTime de .NET Framework. Un valor DateTime no puede ser NULL. La fecha más baja admitida por el tipo de datos DataTime es el 1 de enero de 1601, que está disponible para los programadores como DateTime.MinValue. La fecha admitida más baja indica que falta un valor DateTime .

Boolean
Enumeración con solo dos valores, como {true, false} o {0, 1}.

Valores predeterminados

Analysis Services usa los valores predeterminados que se muestran en la tabla siguiente.

Para un elemento que está presente pero vacío se interpreta que tiene un valor de cadena nula, no el valor predeterminado.

Valores predeterminados heredados

Algunas propiedades especificadas en un objeto proporcionan valores predeterminados para la misma propiedad en los objetos secundarios o descendientes. Por ejemplo, Cube.StorageMode proporciona el valor predeterminado para Partition.StorageMode. Las reglas que Analysis Services aplica para los valores predeterminados heredados son las siguientes:

• Cuando la propiedad del objeto secundario tiene el valor NULL en XML, su valor predeterminado es el valor heredado. Sin embargo, si consulta el valor en el servidor, éste devuelve el valor NULL del elemento XML.

• No es posible determinar mediante programación si la propiedad de un objeto secundario se ha establecido directamente en el objeto secundario o se ha heredado.

Algunos elementos tienen valores predeterminados definidos que se aplican cuando falta el elemento. Por ejemplo, los elementos Dimension del siguiente fragmento XML son equivalentes aunque un elemento Dimension contenga un elemento Visible , pero el otro elemento Dimension no.

<Dimension>

<Name>Product</Name>

</Dimension>

<Dimension>

<Name>Product</ Name>

<Visible>true</Visible>

</Dimension>

Para obtener más información sobre los valores predeterminados heredados, vea Objetos ASSL y Características de objeto.