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 del elemento

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

Comentarios

Cada elemento que se utiliza para definir un objeto (una instancia de Microsoft SQL Server Analysis Services, una jerarquía, un atributo, etc.) 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 se incluyen espacios al principio o al final del valor de un elemento Name, Analysis Services los quitará implícitamente.

• 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.

  Para los objetos creados mediante el método GetNewName en SQL Server 2012, AMO comprueba y posteriormente quita todos los caracteres de control, espacios iniciales o espacios finales del nombre. Por esta razón, el método recomendado para establecer nombres de objeto es mediante GetNewName.

  Sin embargo, si establece la propiedad Name directamente, no se realizan las mismas comprobaciones de validación, pudiendo dar lugar a 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 2012 Analysis Services (SSAS) omitirá los caracteres de control en un nombre de objeto para evitar que las soluciones anteriores dejen de funcionar.

• 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 utilizar dentro del valor de un elemento Name, en función del elemento primario.

Elemento primario	Caracteres no válidos
Server	El nombre debe seguir las reglas de los nombres de equipo de Microsoft Windows. Las direcciones IP no son válidas.
DataSource	:/\*|?"()[]{}<>
Level, elemento Attribute	.,;'`:/\*|?"&%$!+=[]{}<>
Todos los demás elementos primarios	.,;'`:/\*|?"&%$!+=()[]{}<>

Vea también

Referencia

Elemento ID (ASSL)

Propiedades (ASSL)