Соглашения по ASSL XML

Язык сценариев служб Analysis Services (ASSL) представляет иерархию объектов в виде набора типов элементов, каждый из которых определяет дочерние элементы, которые они могут содержать.

Для представления иерархии объектов ASSL использует следующие соглашения XML:

• Все объекты и свойства представлены как элементы, за исключением стандартных XML-атрибутов, таких как xml:lang.

• Имена элементов и значения перечисления соответствуют соглашению об именовании Microsoft .NET Framework регистра Pascal без подчеркивания.

• Регистр всех значений сохраняется. Значения перечислений также чувствительны к регистру.

Помимо этого списка соглашений, службы Analysis Services также следует определенным соглашениям относительно кратности, наследования, пробелов, типов данных и значений по умолчанию.

Мощность

Если элемент имеет кратность, превышающую 1, существует коллекция ЭЛЕМЕНТОВ XML, которая инкапсулирует этот элемент. Имя коллекции использует форму множественного числа элементов, содержащихся в коллекции. Например, следующий фрагмент XML представляет коллекцию Dimensions в элементе Database :

<Database>

...

<Dimensions>

<Dimension>

...

</Dimension>

<Dimension>

...

</Dimension>

</Dimensions>

</Database>

``

Порядок отображения элементов не имеет значения.

Наследство

Наследование используется при наличии различных объектов с перекрывающимися, но значительно разными наборами свойств. Примеры таких перекрывающихся, но уникальных объектов — виртуальные куби, связанные куби и обычные куби. Для перекрывающихся, но отдельных объектов службы Analysis Services используют стандартный type атрибут из пространства имен экземпляра XML, чтобы указать наследование. Например, следующий фрагмент XML показывает, как type атрибут определяет, наследует ли Cube элемент из обычного куба или из виртуального куба:

<Cubes>

<Cube xsi:type="RegularCube">

<Name>Sales</Name>

...

</Cube>

<Cube xsi:type="VirtualCube">

<Name>SalesAndInventory</Name>

...

</Cube>

</Cubes>

``

Наследование обычно не используется, если у нескольких типов есть свойство с одинаковым именем. Например, NameID свойства отображаются во многих элементах, но эти свойства не были повышены до абстрактного типа.

Пробелы

Пробелы в значении элемента сохраняются. Тем не менее, ведущие и конечные пробелы всегда обрезаны. Например, следующие элементы имеют один и тот же текст, но отличаются объемами пробелов в этом тексте и поэтому рассматриваются как если бы они имели разные значения:

<Description>My text<Description>

<Description>My text<Description>

``

Однако следующие элементы различаются только в начальных и конечных пробелах, поэтому рассматриваются как если бы они имели эквивалентные значения:

<Description>My text<Description>

<Description> My text <Description>

``

Типы данных

Службы Analysis Services используют следующие стандартные типы данных языка определения схемы XML (XSD):

Int
Целочисленное значение в диапазоне от -231 до 231 – 1.

Long
Целочисленное значение в диапазоне от -263 до 263 – 1.

String
Строковое значение, соответствующее следующим глобальным правилам:

• Символы элемента управления удаляются.

• Начальный и конечный пробел обрезаны.

• Внутренние пробелы сохраняются.

Name и ID свойства имеют особые ограничения на допустимые символы в строковых элементах. Дополнительные сведения о объектах и соглашениях см. в Name разделе "Объекты ASSL"ID и "Характеристики объектов".

DateTime
Структура DateTime из .NET Framework. DateTime Значение не может иметь значение NULL. Наименьшая дата, поддерживаемая типом DataTime данных, — 1 января 1601 г., которая доступна программистам.DateTime.MinValue Самая низкая поддерживаемая дата указывает на DateTime отсутствие значения.

Boolean
Перечисление с двумя значениями, такими как {true, false} или {0, 1}.

Значения по умолчанию

Службы Analysis Services используют значения по умолчанию, перечисленные в следующей таблице.

Тип данных XML	Значение по умолчанию
Boolean	Неправда
String	"" (пустая строка)
Integer или Long	0 (ноль)
Timestamp	12:00:00, 1/1/0001 (соответствующий .NET Frameworks System.DateTime с 0 галками)

Элемент, который присутствует, но пустой, интерпретируется как значение null-строки, а не значение по умолчанию.

Унаследованные значения по умолчанию

Некоторые свойства, указанные в объекте, предоставляют значения по умолчанию для одного и того же свойства для дочерних или потомков объектов. Например, Cube.StorageMode предоставляет значение по умолчанию для Partition.StorageMode. Правила, которые службы Analysis Services применяются для унаследованных значений по умолчанию, приведены следующим образом:

• Если свойство дочернего объекта равно NULL в XML, его значение по умолчанию является унаследованным значением. Однако при запросе значения с сервера сервер возвращает значение NULL xml-элемента.

• Невозможно программно определить, задано ли свойство дочернего объекта непосредственно на дочернем объекте или наследуется.

Некоторые элементы определили значения по умолчанию, которые применяются при отсутствии элемента. Например, элементы в следующем фрагменте XML эквивалентны, Dimension даже если один Dimension элемент содержит Visible элемент, но другой Dimension элемент не является.

<Dimension>

<Name>Product</Name>

</Dimension>

<Dimension>

<Name>Product</ Name>

<Visible>true</Visible>

</Dimension>

Дополнительные сведения о унаследованных значениях по умолчанию см. в разделе "Объекты ASSL" и "Характеристики объектов".