Nome nodo (proprietà Node di tutti gli schemi)

  • Articolo

 

Utilizzare la proprietà Node Name per visualizzare il nome del nodo così come viene visualizzato nella visualizzazione struttura ad albero dello schema in Editor BizTalk e per alcuni tipi di nodi, per modificare il nome del nodo per descriverne il contenuto.

Si applica ai nodi di tipo

Schema, Record, Field Element, Field Attribute, Sequence Group, Choice Group, All Group, Attribute Group, Any Element, Any Attribute, Equivalent, Equivalent Child

Category

Generale

Valori consentiti

È necessario che i nomi dei nodi siano conformi ai requisiti dei nomi XSD e XML. Per i nodi per i quali è possibile modificare il valore della proprietà Node Name , se si digita un nome di nodo che non è conforme a questi requisiti, verranno richieste le opzioni seguenti:

  • Codificare il nome non conforme in modo che sia conforme ai requisiti XSD/XML.

  • Annullare l'operazione di denominazione e tornare al nome precedente.

Per informazioni sullo schema di codifica usato dall'editor BizTalk per codificare caratteri non XML, vedere la documentazione di .NET Framework per il metodo EncodeLocalName del System.Xml. Classe XmlConvert . In BizTalk Editor viene utilizzato lo stesso schema di codifica.

Due situazioni comuni che richiedono la codifica riguardano i numerali iniziali e gli spazi.

Valore predefinito

La proprietà Node Name ha valori predefiniti diversi per i diversi tipi di nodi, come indicato di seguito:

Tipo di nodo Valori predefiniti per il nome del nodo
Schema <Schema>
Record Registra
Elemento Field Campo
Attributo Field Campo
Gruppo di sequenze <Sequenza>
Gruppo di scelta <Scelta>
Gruppo all <Tutto>
Gruppo di attributi <AttrGroup:attrGroupN>

dove "N" è un numero in aumento monotonico a partire da zero (0)
Qualsiasi elemento <Any>
Qualsiasi attributo <AnyAttribute>
Equivalente <Equivalente>
Figlio equivalente Nomi del tipo complesso di base e del set di tipi complessi derivati, visualizzati tra parentesi angolari (<tipo>) associati al nodo equivalente contenitore.

Persistenza XSD

La proprietà Node Name viene mantenuta in modo diverso nell'XSD per diversi tipi di nodi, come indicato di seguito:

Tipo di nodo Persistenza XSD del nome del nodo
Schema Come elemento dello schema .
Record Come valore dell'attributo namedell'elemento corrispondente.
Elemento Field Come valore dell'attributo namedell'elemento corrispondente.
Attributo Field Come valore dell'attributo name dell'elemento attributo corrispondente.
Gruppo di sequenze Quando la proprietà Group Reference non ha alcun valore, come elemento sequenza .

Quando la proprietà Group Reference ha un valore, la parte variabile del nome del nodo, che segue la sottostringa "Group:" iniziale, viene mantenuta come attributo ref delle istanze dell'utilizzo del gruppo di sequenza e come attributo name della definizione globale del gruppo di sequenze.
Gruppo di scelta Quando la proprietà Group Reference non ha alcun valore, come elemento di scelta .

Quando la proprietà Group Reference ha un valore, la parte variabile del nome del nodo, che segue la sottostringa "Group:" iniziale, viene mantenuta come attributo ref delle istanze del gruppo di scelta e come attributo name della definizione globale del gruppo di scelta.
Gruppo all Quando la proprietà Group Reference non ha alcun valore, come tutti gli elementi.

Quando la proprietà Group Reference ha un valore, la parte variabile del nome del nodo, che segue la sottostringa "Group:" iniziale, viene mantenuta come attributo ref delle istanze dell'utilizzo di tutti i gruppi e come attributo name della definizione globale di tutti i gruppi.
Gruppo di attributi La parte variabile del nome del nodo, che segue la sottostringa "AttrGroup:" iniziale, viene mantenuta come attributo ref delle istanze dell'utilizzo del gruppo di attributi e come attributo name della definizione globale del gruppo di attributi.
Qualsiasi elemento Come qualsiasi elemento.
Qualsiasi attributo Come elemento anyAttribute .
Equivalente e figlio equivalente I nodi figlio equivalenti e equivalenti sono costrutti dell'editor BizTalk e non fanno parte dello standard XSD. Questi nodi consentono di visualizzare l'ereditarietà presente tra i tipi di base e i tipi derivati nello schema.

Commenti

È possibile esaminare questa proprietà e, in alcuni casi, impostare questa proprietà nel Finestra Proprietà di Visual Studio quando si seleziona un nodo in BizTalk Editor.

La proprietà Node Name si comporta in modo diverso per i diversi tipi di nodi, come indicato di seguito:

Tipo di nodo Comportamento della proprietà Nome del nodo
Schema Di sola lettura. È sempre impostato su "<Schema>".
Attributo Record, Elemento Field e Field Proprietà di lettura/scrittura. È possibile rinominare i nodi Record, Elemento campo e Attributo campo usando la proprietà Nome nodo o sul posto all'interno dell'albero dello schema quando vengono inseriti per la prima volta o quando si usa il comando Rinomina nel menu di scelta rapida per il nodo.

I nodi Record eElemento campo di pari livello dello stesso spazio dei nomi possono avere lo stesso valore della proprietà Node Name solo se hanno lo stesso tipo di dati (tranne quando si tratta di una dichiarazione globale) e i nodi attributo Field di pari livello dello stesso spazio dei nomi non possono mai avere lo stesso valore della proprietà Node Name .
Gruppo di sequenze, Gruppo di scelta e Tutti i gruppi Di sola lettura. Tuttavia, qualsiasi valore non vuoto nella proprietà Group Reference corrispondente contribuisce al valore della proprietà Node Name per questi nodi del gruppo di elementi. Ad esempio, se si imposta la proprietà Group Reference sul valore "BillingAddress", la proprietà Node Name diventerà "Group:BillingAddress".
Gruppo di attributi Di sola lettura. Tuttavia, il valore nella proprietà Group Reference corrispondente, indipendentemente dal valore predefinito o da un valore specificato, contribuisce al valore della proprietà Node Name per i nodi del gruppo di attributi . Ad esempio, se si imposta la proprietà Group Reference sul valore "ProductDimensions", la proprietà Node Name diventerà "AttrGroup:ProductDimensions".
Qualsiasi elemento Di sola lettura. È sempre impostato su "<Any>".
Qualsiasi attributo Di sola lettura. È sempre impostato su "<AnyAttribute>".
Equivalente Di sola lettura. È sempre impostato su "<Equivalente>".
Figlio equivalente Di sola lettura. Viene sempre impostato su uno dei nomi di tipi complessi associati al nodo equivalente padre, ovvero il nome del tipo complesso di base o uno dei nomi di tipi complessi derivati.

Vedere anche

Proprietà dei nodi di tutti gli schemi