通过

XML 约定

Analysis Services 脚本语言 (ASSL) 将对象层次结构表示为一组元素类型，其中每个元素类型定义了其可包含的子元素。

ASSL 使用以下 XML 约定来表示对象层次结构：

  • 标准 XML 特性（例如“xml:lang”）除外，所有对象和属性都表示为元素。

  • 元素名称和枚举值都遵循使用 Pascal 大小写格式且无下划线的 Microsoft .NET Framework 命名约定。

  • 保留所有值的大小写。枚举值也区分大小写。

除了此约定列表之外，ASSL 还遵循有关基数、继承、空格、数据类型和默认值的特定约定。

注意注意

有关每个元素的说明、类型、基数和默认值的详细信息，以及任何其他相关信息，请参阅Analysis Services 脚本语言 XML 元素 (ASSL)。

基数

当某个元素有一个大于 1 的基数时，将存在一个封装此元素的 XML 元素集合。该集合的名称使用集合中所包含元素的复数形式。例如，以下 XML 片段表示 Database 元素内的 Dimensions 集合：

<Database>

…

<Dimensions>

<Dimension>

...

</Dimension>

<Dimension>

...

</Dimension>

</Dimensions>

</Database>

 

元素的出现顺序并不重要。

继承

存在具有重叠但有显著不同的属性集的不同对象时，会使用继承。这种重叠但又不同的对象示例有虚拟多维数据集、链接多维数据集和常规多维数据集。对于重叠但又不同的对象，ASSL 会使用 XML 实例命名空间的标准 type 属性来表示继承。例如，以下 XML 片段显示 type 属性如何标识 Cube 元素是继承自常规多维数据集还是虚拟多维数据集：

<Cubes>

<Cube xsi:type=”RegularCube”>

<Name>Sales</Name>

...

</Cube>

<Cube xsi:type=”VirtualCube”>

<Name>SalesAndInventory</Name>

...

</Cube>

</Cubes>

当多个类型具有同一名称的属性时，通常不使用继承。例如，Name 和 ID 属性出现在许多元素中，但这些属性尚未提升为抽象类型。

空格

将保留元素值中的空格。但会始终删除前导空格和尾随空格。例如，下面的元素具有相同的文本，但该文本内的空格数量不同，因此，会将它们视为具有不同的值：

<Description>My text<Description>

<Description>My text<Description>

 

然而，下面的元素仅前导空格和尾随空格不同，因此，会将它们视为具有等效值：

<Description>My text<Description>

<Description> My text <Description>

 

数据类型

ASSL 使用以下标准 XML 架构定义语言 (XSD) 数据类型：

  • Int
    -231 到 231 – 1 范围内的整数值。

  • Long
    -263 到 263 – 1 范围内的整数值。

  • String
    符合以下全局规则的字符串值：

    • 去除控制字符。

    • 删除前导空格和尾随空格。

    • 保留内部空格。

    Name 和 ID 属性对字符串元素中的有效字符具有特殊限制。有关 Name 和 ID 约定的其他信息，请参阅对象和对象特征。

  • DateTime
    .NET Framework 中的 DateTime 结构。DateTime 值不能为 NULL。DataTime 数据类型支持的最早日期为 1601 年 1 月 1 日，程序员可将该日期作为 DateTime.MinValue。该最早支持日期指示缺少 DateTime 值。

  • Boolean
    仅具有两个值的枚举，例如 {true, false} 或 {0, 1}。

默认值

ASSL 使用下表中列出的默认值。

XML 数据类型

默认值

Boolean

False

String

""（空字符串）

Integer 或 Long

0（零）

Timestamp

0001 年 1 月 1 日中午 12:00:00（与 .NET Frameworks System.DateTime 相对应，时钟周期数为 0）

存在但为空的元素被解释为具有 Null 字符串值，而非默认值。

继承的默认值

对象上指定的某些属性可以向子对象或后代对象中的同一属性提供默认值。例如，Cube.StorageMode 可向 Partition.StorageMode 提供默认值。ASSL 为继承的默认值应用的规则与决策支持对象 (DSO) 8.0 中的规则相同。

  • 在 XML 中，如果子对象的属性为 Null，则该属性的值将默认为继承的值。但当您从服务器查询值时，服务器将会返回值为空的 XML 元素。

  • 无法通过编程方式来确定子对象属性是直接在子对象上设置的，还是直接继承的。

某些元素已定义当元素缺少时要应用的默认值。例如，以下 XML 片段中的 Dimension 元素是等效的，即使一个 Dimension 元素包含 Visible 元素，而另一个 Dimension 元素不包含。

<Dimension>

<Name>Product</Name>

</Dimension>

<Dimension>

<Name>Product</ Name>

<Visible>true</Visible>

</Dimension>

 

有关继承的默认值的详细信息，请参阅对象和对象特征。