Procesar mensajes de instancia con promoción de propiedades

La promoción de propiedades mediante el método Campo de propiedad requiere la creación de un esquema de propiedades. Para obtener más información sobre cómo crear un esquema de propiedades, vea How to Create Property Schemas. Al igual que con todas las promociones de propiedades, se usa el cuadro de diálogo Promover propiedades , al que se puede acceder mediante la propiedad Promover propiedades del nodo Esquema en esquemas de mensaje.

Nota

Para obtener acceso a las propiedades promocionadas y usarlas, debe seleccionar una canalización que promocione propiedades. Por ejemplo, si usa la canalización PassthruReceive, no se promocionarán propiedades; esto ocasionará que el enrutamiento basado en contenido y otras funciones no actúen según lo esperado.

En el cuadro de diálogo Promover propiedades , asegúrese de que la pestaña Campos de propiedad está seleccionada en el lado derecho del cuadro de diálogo. A continuación, asegúrese de que el esquema de propiedades adecuado se incluye en la lista esquemas de propiedades de la parte superior de la pestaña Campos de propiedad. Si es necesario, use el botón carpeta para seleccionar el esquema de propiedades adecuado mediante el cuadro de diálogo Selector de tipos de BizTalk . A continuación, expanda los nodos del árbol de esquema en el lado izquierdo del cuadro de diálogo para buscar y seleccionar el nodo Elemento de campo o el nodo Atributo de campo que desea promover como campo de propiedad y, a continuación, haga clic en Agregar. Por último, use la lista desplegable de la columna Property de la tabla de diccionario Property-Fields para seleccionar un nodo Elemento de campo en un esquema de propiedades con el que asociar la propiedad promocionada. Para obtener instrucciones paso a paso sobre cómo promover propiedades a campos de propiedad mediante el cuadro de diálogo Promover propiedades ox, vea How to Copy Data to the Message Context as Property Fields.

Nota

También puede promover un nodo Record a un nodo Elemento de campo en el esquema de propiedades, pero solo si la propiedad Content Type del nodo Record está establecida en SimpleContent.

Nota

Una propiedad se puede promocionar varias veces dentro de un esquema si dichas promociones se realizan en nodos raíz diferentes. Esto es así porque el mensaje se valida con respecto a un nodo raíz individual y únicamente las propiedades promocionadas en ese nodo raíz se evalúan en tiempo de ejecución.

Para quitar un nodo Elemento de campo o un nodo Atributo de campo del conjunto de propiedades que se promueven como campos de propiedad, seleccione la propiedad promocionada en la tabla diccionario Property-Fields de la pestaña Campos de propiedad y, a continuación, haga clic en Quitar.

La columna Ruta de acceso del nodo de la tabla de diccionario Property-Fields muestra el XPath en el nodo de esquema correspondiente a la propiedad promocionada. Puede editar este valor directamente mediante el cuadro de diálogo Editar XPath de instancia . Para abrir este cuadro de diálogo, haga clic en el botón de puntos suspensivos (...) que aparece al final derecho de la celda correspondiente al seleccionar esa celda. Preste atención cuando edite valores XPath directamente, ya que los XPath que no puede resolver el Editor de BizTalk impedirán realizar correctamente operaciones de validación.

El Editor de BizTalk también proporciona un comando simplificado para promover propiedades mediante el mecanismo Campo de propiedad . Este comando se denomina Promoción rápida y está disponible mediante Promote | Comando Promoción rápida en los menús contextuales y biztalk. Este comando promueve el nodo Campo seleccionado (o Nodo De registro ) a un campo de propiedad que se crea automáticamente en el esquema de propiedades especificado por la propiedad Nombre de esquema de propiedad predeterminado en el cuadro de diálogo Páginas de propiedades para el esquema contenedor. Para obtener instrucciones paso a paso sobre cómo promover propiedades a campos de propiedad mediante el comando Promoción rápida, vea Cómo copiar datos en el contexto de mensaje como campos de propiedad.

Cuando promocione una propiedad mediante el mecanismo de campos de propiedades, se agregarán dos fragmentos del lenguaje de definición de esquemas XML (XSD) a la representación XSD del esquema de mensaje. El primer fragmento XSD es un fragmento de anotación asociado al elemento de esquema que identifica el esquema de propiedades correspondiente, como en el ejemplo siguiente:

<xs:annotation>  
    <xs:appinfo>  
        <b:imports>  
            <b:namespace prefix="ns0"  
                uri="http://BizTalk_Server_Project1.PropertySchema1"  
                location=".\propertyschema1.xsd" />  
        </b:imports>  
    </xs:appinfo>  
</xs:annotation>  

El segundo fragmento XSD es un fragmento de anotación asociado al elemento Raíz (independientemente de si se ha cambiado el nombre) que identifica los valores de nodo Elemento de campo o Atributo de campo que se han promocionado mediante el mecanismo de campo de propiedad, como en el ejemplo siguiente:

<xs:annotation>  
    <xs:appinfo>  
        <b:properties>  
            <b:property name="ns0:PromProp1"  
                xpath="/*[local-name()='Root' and namespace-  
                 uri()='http://BizTalk_Server_Project1.Schema2']/  
                 *[local-name()='MyRec1']/@*[local-  
                 name()='Field_x0020_1']" />  
            <b:property name="ns0:PromProp2"  
                xpath="/*[local-name()='Root' and namespace-  
                 uri()='http://BizTalk_Server_Project1.Schema2']/  
                 *[local-name()='MyRec1']/*[local-  
                 name()='ProgramManager']/*[local-name()='Name']" />  
        </b:properties>  
    </xs:appinfo>  
</xs:annotation>  

Consulte también

Modos de usar el contenido de los mensajes para controlar el procesamiento de los mensajes
Cómo copiar datos en el contexto del mensaje como campos de propiedad