Elemento Name (ASSL)
Contiene il nome dell'elemento padre.
Sintassi
<Action> <!-- or one of the elements listed below in the Element Relationships table -->
...
<Name>...</Name>
...
</Action>
Caratteristiche elemento
| Caratteristica | Descrizione |
|---|---|
| Tipo di dati e lunghezza | Stringa (fino a 100 caratteri) |
| Valore predefinito | Varia |
| Cardinalità | 1-1: elemento obbligatorio che si presenta una sola volta. |
Relazioni elemento
| Relazione | Elemento |
|---|---|
| Elementi padre | 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 |
| Elementi figlio | nessuno |
Osservazioni
Ogni elemento usato per definire un oggetto (un'istanza di Analysis Services, una gerarchia, un attributo e così via) ha un elemento Name come proprietà. Il valore di un elemento Name presenta le restrizioni seguenti:
Il valore non deve contenere spazi iniziali o finali. Se nel valore di un elemento Name sono inclusi spazi iniziali o finali, tali spazi verranno rimossi in modo implicito daAnalysis Services.
Nel valore non dovrebbero essere contenuti caratteri di controllo. La presenza di caratteri di controllo in un nome è fortemente sconsigliata e può talvolta causare errori di convalida XML.
Per gli oggetti creati usando il metodo GetNewName in SQL Server, AMO verifica e successivamente rimuove eventuali caratteri di controllo, spazi iniziali o spazi finali nel nome. Per questo motivo, l'uso di GetNewName è l'approccio consigliato per l'impostazione dei nomi degli oggetti.
Tuttavia, se si imposta direttamente la proprietà Name , gli stessi controlli di convalida non vengono eseguiti, causando eventualmente errori di convalida XML. L'effettiva generazione di un errore dipende dal carattere di controllo visualizzato nel nome.
Sebbene i caratteri di controllo non debbano mai essere utilizzati nel nome di un oggetto, non vengono impediti espressamente da Analysis Services. Talvolta, nelle versioni precedenti di Analysis Services venivano accettati i caratteri di controllo nel nome di un oggetto. Per questo motivo, SQL Server 2016 Analysis Services e versioni successive ignoreranno i caratteri di controllo nel nome di un oggetto per evitare di interrompere le soluzioni meno recenti.
Impossibile utilizzare i seguenti valori riservati:
AUX
CLOCK$
COM1 tramite COM9 (COM1, COM2, COM3 e così via)
CON
LPT1 tramite LPT9 (LPT1, LPT2, LPT3 e così via)
NUL
PRN
Nella tabella seguente sono elencati i caratteri aggiuntivi che non possono essere utilizzati all'interno del valore di un elemento Name , a seconda dell'elemento padre.
| Elemento padre | Caratteri non validi |
|---|---|
| Server | Il nome deve seguire le regole per i nomi Windows computer. Gli indirizzi IP non sono validi. |
| DataSource | :/\\*|?"()[]{}<> ` |
| Elemento Level, Attribute | .,;':/\\*|?"&%$!+=[]{}<> ` |
| Tutti gli altri elementi padre | .,;':/\\*|?"&%$!+=()[]{}<> ` |