Nombre de nodo (propiedad node de todos los esquemas)

 

Use la propiedad Nombre de nodo para mostrar el nombre del nodo tal 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, Equivalent, Equivalent Child

Categoría

General

Valores permitidos

Los nombres de nodo deben cumplir los requisitos de nombre de XSD y XML. Para los nodos para los que se puede cambiar el valor de la propiedad Nombre de nodo, si escribe un nombre de nodo que no se ajusta a 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 utilizado 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 de nodo tiene valores predeterminados diferentes para distintos tipos de nodos, como se muestra 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 de forma monótona a partir de cero (0)
Elemento Any <Any>
Cualquier atributo <AnyAttribute>
Tipo de datos de XPath <Tipo de datos de XPath>
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 que lo contiene.

Persistencia xsd

La propiedad Nombre de nodo se conserva de forma diferente en xsd para distintos tipos de nodos, como se muestra 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 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 secuencia y como el 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 opció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 todo el grupo y como el atributo name de la definición global del grupo.
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.
Elemento Any Como un elemento any.
Cualquier atributo Como un 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.

Observaciones

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

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

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

Los nodos Registro del mismo nivel y Elemento de campo 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 es una declaración global) y los nodos atributo de campo del mismo espacio de nombres nunca pueden tener el mismo valor de propiedad nombre de nodo.
Grupo de secuencias, Grupo de opciones y Todos los grupos Solo lectura. Sin embargo, cualquier valor que no está en la página en 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 Referencia de grupo en el valor "BillingAddress", la propiedad Nombre de nodo 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 Referencia de grupo en el valor "ProductDimensions", la propiedad Nombre de nodo se convertirá en "AttrGroup:ProductDimensions".
Elemento Any Solo lectura. Siempre se establece en "<Cualquiera>".
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 complejo 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