Elemento Name (ASSL)
Contiene el nombre del elemento primario.
Sintaxis
<Action> <!-- or one of the elements listed below in the Element Relationships table -->
...
<Name>...</Name>
...
</Action>
Características de los elementos
| Característica | Descripción |
|---|---|
| Tipo y longitud de los datos | Cadena (hasta 100 caracteres) |
| Valor predeterminado | Varía |
| Cardinalidad | 1-1: Elemento necesario que se produce una vez y solo una vez |
Relaciones del elemento
| Relación | Elemento |
|---|---|
| Elementos primarios | Action, Aggregation, AggregationDesign, AlgorithmParameter, Annotation, Assembly, ClrAssemblyFile, Cube, CubeDimension, CubeHierarchy, Database, DataSource, DataSourceView, Dimension, DimensionAttribute, Group, Hierarchy, Kpi, Level, MdxScript, Measure, MeasureGroup, MemberProperty, MiningModel, MiningModelColumn, MiningStructure, MiningStructureColumn, Partition, Permission, Perspective, PerspectiveCalculation, ReportFormatParameter, ReportParameter, Role, Server, ServerProperty, Trace |
| Elementos secundarios | Ninguno |
Observaciones
Cada elemento que se usa para definir un objeto (una instancia de Analysis Services, una jerarquía, un atributo, entre otros) tiene un elemento Name como propiedad. El valor de un elemento Name tiene las restricciones siguientes:
El valor no puede contener espacios delante ni detrás. Si los espacios iniciales o finales se incluyen en el valor de un elemento Name,Analysis Services quitará implícitamente esos espacios.
El valor no debe contener caracteres de control. Se desaconseja la presencia de caracteres de control en un nombre, ya que a veces puede producir errores de validación XML.
En el caso de los objetos creados mediante el método GetNewName de SQL Server, AMO busca y, posteriormente, quita los caracteres de control, los espacios iniciales o los espacios finales del nombre. Por esta razón, el uso de GetNewName es el enfoque recomendado para establecer nombres de objeto.
Sin embargo, si establece la propiedad Name directamente, no se realizan las mismas comprobaciones de validación, lo que posiblemente provocará errores de validación XML. El hecho de que se produzca un error realmente depende del carácter de control que aparece en el nombre.
Aunque los caracteres de control nunca se deben usar en un nombre de objeto, Analysis Services no los impide expresamente. Las versiones anteriores de Analysis Services aceptaban algunas veces caracteres de control en un nombre de objeto. Por esta razón, SQL Server 2016 Analysis Services y versiones posteriores omitirán los caracteres de control de un nombre de objeto para evitar la separación de soluciones anteriores.
No se pueden utilizar los valores reservados siguientes:
AUX
CLOCK$
De COM1 a COM9 (COM1, COM2, COM3, etc.)
CON
De LPT1 a LPT9 (LPT1, LPT2, LPT3, etc.)
NUL
PRN
En la tabla siguiente se enumeran los caracteres adicionales que no se pueden usar dentro del valor de un elemento Name , dependiendo del elemento primario.
| Elemento primario | Caracteres no válidos |
|---|---|
| Server | El nombre debe seguir las reglas para los Windows de equipo. Las direcciones IP no son válidas. |
| DataSource | :/\\*|?"()[]{}<> ` |
| Level, Elemento Attribute | .,;':/\\*|?"&%$!+=[]{}<> ` |
| Todos los demás elementos primarios | .,;':/\\*|?"&%$!+=()[]{}<> ` |