Leer en inglés

Compartir a través de


Esquemas de propiedades

En Microsoft BizTalk Server, las propiedades promocionadas permiten que varios componentes de BizTalk Server accedan a elementos clave de datos, conocidos en este contexto como campos distintivos y campos de propiedad que llegan dentro de un mensaje de instancia sin necesidad de saber cómo buscarlos dentro del propio mensaje. Puede determinar qué elementos de datos deben promocionarse a un nivel más visible para los distintos tipos de mensajes. En función de cómo elija promocionar esos campos, puede que tenga que crear y definir un esquema de propiedades asociado.

Nota

Las propiedades promocionadas se restringen a atributos o elementos que no son de repetición.

El acceso a los campos distintivos sólo se puede obtener desde las orquestaciones y estos campos no necesitan que se cree un esquema de propiedades correspondiente. Si solamente tiene que tener acceso a los datos promocionados de un mensaje desde una orquestación, puede promocionar los datos como uno o más campos distintivos.

El acceso a los campos de propiedades se obtiene desde varios componentes de BizTalk Server, incluidas las canalizaciones y las orquestaciones. Los campos de propiedades también se pueden utilizar para el enrutamiento de mensajes. Si necesita tener acceso a los datos promocionados de un mensaje desde contextos distintos a las orquestaciones, debe crear uno o más esquemas de propiedades para describir los datos que está promocionando.

Un esquema de propiedades es un esquema especial que el usuario asocia a un esquema de mensaje. Se utiliza para promocionar valores específicos de un mensaje de instancia en el contexto de mensaje. La promoción de propiedades ofrece un mecanismo centralizado de extraer bloques principales de información de un mensaje de instancia (los que defina el usuario) y facilitar notablemente su acceso a los componentes de BizTalk Server que manipulan el mensaje cuando éste pasa por BizTalk Server.

Introducción al esquema de creación de propiedades

Puede crear automáticamente un esquema de propiedades predeterminado mediante la característica Promoción rápida de BizTalk Server. Ésta es la forma más sencilla de crear el esquema de propiedades necesario para la promoción de los campos de propiedades. Para obtener más información sobre cómo realizar promociones rápidas, vea Cómo copiar datos en el contexto de mensaje como campos de propiedad.

También puede crear un nuevo esquema de propiedades. Cuando se abra un proyecto de BizTalk, seleccione el proyecto de BizTalk, haga clic con el botón derecho y seleccione Agregar, haga clic en Nuevo elemento y, a continuación, haga clic en Esquema.

Nota

  • Si un esquema de propiedades está asociado a un esquema de mensaje, ambos esquemas deben estar en el mismo proyecto de BizTalk. No se admite separar el esquema de propiedades del esquema de mensaje asociado en distintos proyectos de BizTalk.

  • Si tiene dos esquemas de propiedades que tienen el mismo espacio de nombres, aunque se definan en ensamblados diferentes, los esquemas no se resolverán correctamente en tiempo de ejecución. Producirá un error de enrutamiento en tiempo de ejecución.

Campos distintivos y campos de propiedad

Hay dos tipos de promoción de propiedades: campos distintivos y campos de propiedad. El último tipo utiliza esquemas de propiedades. En el Editor de BizTalk, se administran ambos tipos de promoción de propiedades mediante el cuadro de diálogo Promover propiedades , al que se accede mediante la propiedad Promover propiedades del nodo Esquema .

Nota

  • Existen algunas restricciones en cuanto a los valores que puede promocionar. Para obtener más información, vea la tabla en Promoción de propiedades.

  • Los campos distintivos no aparecen en las expresiones de filtro. Únicamente aparecen campos de propiedades en las expresiones de filtro.

Los esquemas de propiedades son sencillos si se comparan con los esquemas de mensaje. En el árbol de esquema, solo se le permite insertar nodos de elemento de campo como nodos secundarios inmediatos del nodo Esquema , creando una estructura que sea de dos niveles de profundidad. En la mayoría de las partes, se establecen las propiedades de los nodos Elemento de campo como lo haría para los nodos Elemento de campo que aparecen en un esquema de mensaje. Tiene no obstante una limitación: sólo puede utilizar tipos simples XSD.

Importante

No debe cambiar el nombre de ningún esquema que utilice otro esquema. Esto incluye los esquemas de propiedades para los que ya se han establecido promociones. Si lo hace, el esquema en uso no podrá encontrar el otro esquema porque el nombre que contiene ya no será exacto.

La propiedad Property Schema Base es única para los nodos elemento field , ya que aparecen en esquemas de propiedades. Esta propiedad está en blanco de forma predeterminada, pero se puede establecer en MessageDataPropertyBase o MessageContextPropertyBase, lo que da lugar a que se agregue un atributo propSchFieldBase al elemento de anotación fieldInfo con uno o el otro de estos valores.

Cuando el atributo propSchFieldBase se establece en MessageDataPropertyBase, significa que el valor de la propiedad promocionada corresponde a los datos del mensaje, como el valor de algún campo. Cuando el atributo propSchFieldBase se establece en MessageContextPropertyBase, significa que el valor de la propiedad promocionada puede ser de otro lugar, como un sobre, o que un componente de canalización puede establecerlo.

Los nodos elemento field de los esquemas de propiedad también tienen una propiedad denominada Información confidencial, que, cuando se establece en , impedirá que el valor correspondiente sea visible desde el Explorador de BizTalk y el seguimiento de eventos de mensajes y instancias de servicio, conservando así su naturaleza confidencial. Consulte Información confidencial en la guía de la interfaz de usuario y la referencia del espacio de nombres de api para desarrolladores para obtener más detalles.

La siguiente representación de un esquema de propiedades en el lenguaje de definición de esquemas XML (XSD) contiene una anotación asociada al elemento schema que identifica a este esquema como un esquema de propiedades (schema_type="property"). También contiene tres nodos de elemento field debajo del nodo Esquema . El primer nodo Elemento de campo , denominado PromProp1, no tiene un valor definido para su propiedad Property Schema Base , pero los dos últimos nodos Elemento de campo tienen esa propiedad establecida en MessageDataPropertyBase y MessageContextPropertyBase, respectivamente.

<?xml version="1.0" encoding="utf-16" ?>   
<xs:schema xmlns="http://BizTalk_Server_Project1.PropertySchema1"  
           xmlns:b="http://schemas.microsoft.com/BizTalk/2003"  
           targetNamespace="http://BizTalk_Server_Project1.PropertySchema1"  
           xmlns:xs="http://www.w3.org/2001/XMLSchema">  
    <xs:annotation>  
       <xs:appinfo>  
  
        </xs:appinfo>  
    </xs:annotation>  
    <xs:element name="" type="xs:string">  
        <xs:annotation>  
            <xs:appinfo>  
  
            </xs:appinfo>  
        </xs:annotation>  
    </xs:element>  
    <xs:element name="" type="xs:string">  
        <xs:annotation>  
            <xs:appinfo>  
  
            </xs:appinfo>  
        </xs:annotation>  
    </xs:element>  
    <xs:element name="" type="xs:string">  
        <xs:annotation>  
            <xs:appinfo>  
  
            </xs:appinfo>  
        </xs:annotation>  
    </xs:element>  
</xs:schema>  
  

Consulte también

Tipos de esquemas de BizTalk