Nombre de nodo (propiedad Node de todos los esquemas)

 

Utilice la propiedad Nombre de nodo para mostrar el nombre del nodo tal y como aparece en la vista de árbol de esquema en el Editor de BizTalk y para algunos tipos de nodos, para cambiar el nombre del nodo para describir su contenido.

Se aplica a los nodos de los tipos siguientes

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

Categoría

General

Valores permitidos

Los nombres de nodo deben cumplir los requisitos de nombre de XSD y XML. Para aquellos nodos para los que se puede cambiar el valor de la propiedad Nombre de nodo , si escribe un nombre de nodo que no cumple estos requisitos, se le pedirán las siguientes opciones:

  • Codificar el nombre no compatible para que cumpla los requisitos de XSD/XML.

  • Cancelar la operación de asignación de nombre y revertir al nombre anterior.

Para obtener información sobre el esquema de codificación usado por el Editor de BizTalk para codificar caracteres no XML, vea la documentación de .NET Framework para el método EncodeLocalName del System.Xml. Clase XmlConvert . El Editor de BizTalk usa el mismo esquema de codificación.

El número inicial y el carácter de espacio son dos situaciones comunes que necesitan codificación.

Valor predeterminado

La propiedad Nombre del nodo tiene valores predeterminados diferentes para distintos tipos de nodos, como se indica a continuación:

Tipo de nodo Valores predeterminados de nombre de nodo
Esquema <Esquema>
Registro Registro
Elemento Field Campo
Atributo field Campo
Grupo de secuencias <Secuencia>
Grupo de elecciones <Opción>
Todos los grupos <Todo>
Grupo de atributos <AttrGroup:attrGroupN>

donde "N" es un número que aumenta monotónicamente a partir de cero (0)
Cualquier elemento <Any>
Cualquier atributo <AnyAttribute>
Tipo de datos de XPath <Equivalente>
Secundario equivalente Los nombres del tipo complejo base y el conjunto de tipos complejos derivados, que se muestran entre corchetes angulares (<tipo>), asociados al nodo equivalente contenedor.

Persistencia de XSD

La propiedad Nombre del nodo se conserva de forma diferente en el XSD para distintos tipos de nodos, como se indica a continuación:

Tipo de nodo Persistencia XSD de nombre de nodo
Esquema Como elemento de esquema .
Registro Como valor del atributo name del elemento correspondiente.
Elemento Field Como valor del atributo name del elemento correspondiente.
Atributo field Como valor del atributo name del elemento de atributo correspondiente.
Grupo de secuencias Cuando la propiedad Referencia de grupo no tiene ningún valor, como un elemento de secuencia .

Cuando la propiedad Group Reference tiene un valor, la parte variable del nombre del nodo, que sigue a la subcadena "Group:" inicial, se conserva como el atributo ref de las instancias del uso del grupo de secuencia y como atributo name de la definición global del grupo de secuencia.
Grupo de elecciones Cuando la propiedad Referencia de grupo no tiene ningún valor, como elemento de elección .

Cuando la propiedad Referencia de grupo tiene un valor, la parte variable del nombre del nodo, que sigue a la subcadena "Group:" inicial, se conserva como el atributo ref de las instancias del uso del grupo de opciones y como el atributo name de la definición global del grupo de opciones.
Todos los grupos Cuando la propiedad Referencia de grupo no tiene ningún valor, como un elemento all .

Cuando la propiedad Referencia de grupo tiene un valor, la parte variable del nombre del nodo, que sigue a la subcadena "Group:" inicial, se conserva como el atributo ref de las instancias del uso de todos los grupos y como el atributo name de la definición global de todos los grupos.
Grupo de atributos La parte variable del nombre del nodo, que sigue a la subcadena "AttrGroup:", se conserva como el atributo ref de las instancias del uso del grupo de atributos y como el atributo name de la definición global del grupo de atributos.
Cualquier elemento Como elemento any .
Cualquier atributo Como elemento anyAttribute .
Elemento secundario equivalente y equivalente Los nodos secundarios equivalentes y equivalentes son construcciones del Editor de BizTalk y no forman parte del estándar XSD. Existen como ayuda a la visualización de la herencia que está presente entre los tipos base y los tipos derivados del esquema.

Comentarios

Puede examinar esta propiedad y, en algunos casos, establecer esta propiedad en el ventana Propiedades de Visual Studio al seleccionar un nodo en el Editor de BizTalk.

La propiedad Nombre del nodo se comporta de forma diferente para distintos tipos de nodos, como se indica a continuación:

Tipo de nodo Comportamiento de la propiedad Nombre de nodo
Esquema Solo lectura. Siempre se establece en "<Esquema>".
Atributo Record, Field y Field Lectura/escritura Puede cambiar el nombre de los nodos Record, Field Element y Field Attribute mediante la propiedad Node Name , o en contexto dentro del árbol de esquemas cuando los inserte por primera vez o cuando use el comando Rename en el menú contextual del nodo.

Los nodos Record y Field Element del mismo espacio de nombres solo pueden tener el mismo valor de propiedad Nombre de nodo si tienen el mismo tipo de datos (excepto cuando se trata de una declaración global) y los nodos atributo field del mismo espacio de nombres nunca pueden tener el mismo valor de propiedad Nombre de nodo .
Grupo de secuencia, Grupo de opciones y Todos los grupos Solo lectura. Sin embargo, cualquier valor distinto deblank de la propiedad Referencia de grupo correspondiente contribuye al valor de la propiedad Nombre de nodo para estos nodos de grupo de elementos. Por ejemplo, si establece la propiedad Group Reference en el valor "BillingAddress", la propiedad Node Name se convertirá en "Group:BillingAddress".
Grupo de atributos Solo lectura. Sin embargo, el valor de la propiedad Referencia de grupo correspondiente, ya sea el valor predeterminado o un valor que proporcione, contribuye al valor de la propiedad Nombre de nodo para los nodos del grupo de atributos. Por ejemplo, si establece la propiedad Group Reference en el valor "ProductDimensions", la propiedad Node Name se convertirá en "AttrGroup:ProductDimensions".
Cualquier elemento Solo lectura. Siempre se establece en "<Any>".
Cualquier atributo Solo lectura. Siempre se establece en "<AnyAttribute>".
Tipo de datos de XPath Solo lectura. Siempre se establece en "<Equivalente>".
Secundario equivalente Solo lectura. Siempre se establece en uno de los nombres de tipo complejos asociados al nodo equivalente primario, ya sea el nombre de tipo complejo base o uno de los nombres de tipo complejo derivados.

Consulte también

Propiedades de nodo de todos los esquemas