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 | Azione ,Aggregazione , AggregationDesign, AlgorithmParameter, Annotation , Assembly, ClrAssemblyFile, Cube, CubeDimension, CubeHierarchy, Database, DataSource , DataSourceView, Dimension, DimensionAttribute, Group , Hierarchy, Hierarchy, Kpi , MdxScript, MeasureGroup , MemberProperty, MiningModel, MiningModelColumn, MiningStructure , MiningStructureColumn, Partition, Permission, Perspective, PerspectiveCalculation, ReportFormatParameter, ReportParameter, Role, 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 del computer di Windows. Gli indirizzi IP non sono validi. |
| DataSource | :/\\*|?"()[]{}<> ` |
| Level, elemento Attribute | .,;':/\\*|?"&%$!+=[]{}<> ` |
| Tutti gli altri elementi padre | .,;':/\\*|?"&%$!+=()[]{}<> ` |