• Article

Name Element (ASSL)

Contains the name of the parent element.

Syntax

<Action> <!-- or one of the elements listed below in the Element Relationships table -->
   ...
   <Name>...</Name>
   ...
</Action>

Element Characteristics

Characteristic

Description

Data type and length

String (up to 100 characters)

Default value

Varies

Cardinality

1-1: Required element that occurs once and only once

Remarks

Every element that is used to define an object (an instance of Microsoft SQL Server Analysis Services, a hierarchy, an attribute, and so on) has a Name element as a property. The value of a Name element has the following restrictions:

  • The value cannot contain leading or trailing spaces. If leading or trailing spaces are included in the value of a Name element, those spaces will be implicitly removed by Analysis Services.

  • The value cannot contain control characters. If control characters are included in the value of a Name element, those characters will be implicitly removed by Analysis Services.

  • The following reserved values cannot be used:

    • AUX

    • CLOCK$

    • COM1 through COM9 (COM1, COM2, COM3, and so on)

    • CON

    • LPT1 through LPT9 (LPT1, LPT2, LPT3, and so on)

    • NUL

    • PRN

The following table lists additional characters that cannot be used within the value of a Name element, depending on the parent element.

Parent element

Invalid Characters

Server

The name must follow the rules for Microsoft Windows computer names. IP addresses are not valid.

DataSource

:/\*|?"()[]{}<>

Level, Attribute Element

.,;'`:/\*|?"&%$!+=[]{}<>

All other parent elements

.,;'`:/\*|?"&%$!+=()[]{}<>