Share via

Promover propiedades (propiedad Node de todos los esquemas)

  • Artículo

 

Utilice la propiedad Promote Properties para definir las propiedades que desea promover al contenedor de contexto de propiedades e importar esquemas de propiedades para su uso junto con la promoción de propiedades.

Se aplica a los nodos de los tipos siguientes

Propiedades del nodo de esquema

Categoría

BizTalk

Valores permitidos

Para establecer los valores asociados a esta propiedad, haga clic en el botón de puntos suspensivos (...) situado a la derecha del campo de valor de propiedad para abrir el cuadro de diálogo Promover propiedades .

Los datos que se encuentran en mensajes de instancia se pueden promocionar como campos de propiedades o campos distintivos. Solo se obtiene acceso a los campos distintivos desde las orquestaciones de BizTalk. El acceso a los campos de propiedades se obtiene desde una gran variedad de componentes de BizTalk Server y éstos se pueden usar para el enrutamiento por contenidos. Para usar los campos de propiedades, debe crear o usar un esquema de propiedades existente que declare los campos de propiedades adecuados.

Los valores asociados a la promoción de propiedades, tal como se establece mediante el cuadro de diálogo Promover propiedades, son anotaciones de esquema que llevan la siguiente información, lo que permite que las propiedades designadas se "copien" en el contenedor de contexto de propiedades cuando comienza el procesamiento de mensajes, lo que permite un acceso más fácil a sus valores por una variedad de componentes de BizTalk Server:

  • En el caso de promociones de campos de propiedades, incluyen el nombre de la propiedad y el espacio de nombres de la propiedad correspondiente en un esquema de propiedades, así como el XPath de mensaje de instancia de la propiedad que se va a promocionar.

  • En el caso de promociones de campos distintivos, incluyen el XPath de mensaje de instancia de la propiedad que se va a promocionar.

Para obtener información conceptual y de procedimientos sobre la promoción de propiedades, vea Formas de usar el contenido del mensaje para controlar el procesamiento de mensajes. Consulte también Promoción de propiedades.

Persistencia de XSD

Dentro del nodo Registro raíz que contiene el nodo asociado a los datos que se van a promover, como un elemento de propiedad dentro del elemento element/annotation/appinfo/recordInfo/properties .

Observaciones

Puede examinar y establecer esta propiedad en el ventana Propiedades de Visual Studio al seleccionar el nodo Esquema en el Editor de BizTalk.

Solo se puede promover una propiedad determinada en el esquema en el que se define el nodo Elemento de campo o Atributo de campo correspondiente y no en ningún otro esquema en el que se importe la definición.

La promoción de campos de propiedades está sujeta a las siguientes limitaciones:

  • La promoción de un valor de cadena que sea superior a 256 caracteres de longitud puede provocar excepciones por desbordamiento en tiempo de ejecución.

  • La promoción de nodos de tipo de datos xs:integer que requieren más de 28 dígitos puede provocar excepciones de desbordamiento en tiempo de ejecución (debido al uso interno del tipo de datos .NET System.Decimal, que tiene un límite de 28 dígitos). Puede solucionar esta limitación si interpreta y promociona valores numéricos muy grandes como cadenas, con lo que aumenta el límite real a 256 dígitos.

  • No se admite la promoción de nodos del tipo de datos xs:long o xs:unsignedLong en tiempo de ejecución y puede provocar resultados inesperados. Para evitar este problema, considere la posibilidad de cambiar el tipo de datos de estos nodos promocionados a xs:string.

Para obtener información conceptual sobre la promoción de propiedades, vea Formas de usar contenido de mensajes para controlar el procesamiento de mensajes.

Para obtener información sobre el cuadro de diálogo Promover propiedades , vea Cómo abrir el cuadro de diálogo Promover propiedades.

Advertencia

No promocione propiedades del sistema. La promoción de propiedades del sistema, como ReceivePortName, produce un comportamiento imprevisible.

Consulte también

Propiedades de nodo de todos los esquemas