Uso de campos diferenciados y campos de propiedad

Los campos distintivos son datos de mensajes de interés especial que se usan principalmente para tomar decisiones o manipular datos en la orquestación.

Las propiedades del mensaje son datos(contenido del propio mensaje) o "metadatos", información de contexto sobre el mensaje, como marcas de tiempo o información de enrutamiento. Puede usar propiedades de contexto de mensaje definidas por el sistema o propiedades de contexto de transporte, o bien puede definir sus propias propiedades haciendo referencia a campos de esquema desde dentro de un esquema de propiedades. Las propiedades se utilizan en las suscripciones y correlaciones.

• Puede designar un campo en un esquema como campo distintivo o campo de propiedad mediante el cuadro de diálogo Promover propiedades desde el Editor. Para obtener más información, consulte Promoción de propiedades.

• Puede designar un campo en un tipo de .NET como un campo destacado decorándolo con el atributo DistinguishedField, o como una propiedad usando el atributo Property.

Uso de campos distintivos

La ruta de acceso al campo del mensaje hace referencia a los campos distintivos mediante puntos para separar el nombre del mensaje, los nombres de los registros que incluyen el campo y el nombre del propio campo:

MyMessage.MyRecord.MySubrecord.MyDistinguishedField  

Uso de campos de propiedad

Una vez que haya agregado un campo a un esquema de propiedades, se puede tener acceso a su valor en la orquestación con código y en expresiones de filtro. Para obtener más información sobre los esquemas de propiedades, vea Esquemas de propiedades.

Nota:

El contenido del mensaje o las propiedades de datos son básicamente accesos directos a los datos subyacentes: si modifica la propiedad , los datos se modificarán y viceversa.

Las propiedades del mensaje se conocen por el nombre del mensaje seguido del espacio de nombres (el esquema) y el nombre de propiedad entre paréntesis:

MyMessage(Invoice.PropertySchema.InvoiceID)  

Nota:

Cuando se usa una palabra clave reservada como nombre de un campo en un esquema y se promueve el campo seleccionando Promoción rápida, el nombre de propiedad del campo se cambia a __<Reserved Keyword>. (El carácter de subrayado doble se agrega antes del nombre de la propiedad). Sin embargo, si usa este nombre de propiedad en una expresión de orquestación, recibirá un error del compilador al intentar compilar la orquestación. Para solucionar este error, debe agregar manualmente @ antes del doble carácter de subrayado. Por ejemplo

MyMessage(Invoice.PropertySchema.@__Name) = "Product Name";

Conjuntos de propiedades

También puede asignar todas las propiedades de contexto de un mensaje (un conjunto de propiedades) a las propiedades de contexto de otro mensaje. Para asignar un conjunto de propiedades, simplemente coloque un asterisco entre paréntesis después de ambos nombres de mensaje, de la misma manera que colocaría una propiedad entre paréntesis:

MyMessage2(*)=MyMessage1(*);  

Después de asignar el conjunto de propiedades a MyMessage2 en el ejemplo, todas las propiedades de MyMessage2 contienen los mismos valores que las propiedades de MyMessage1.

Véase también

Promoción de propiedades
Usar filtros con la forma de mensaje de recepción
Uso de mensajes en orquestaciones
Acerca de las propiedades del contexto de mensaje de BizTalk