Compartir a través de


Uso de campos distintivos y campos de propiedades

los campos distintivos son datos de mensaje de especial interés que se usan principalmente para tomar decisiones o manipular datos de 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 transporte o mensaje definidas por el sistema o bien puede definir sus propias propiedades mediante la referencia a campos de esquema desde un esquema de propiedades. Las propiedades se usan en 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 .NET como campo distintivo al decorarlo con el atributo DistinguishedField o como propiedad con el atributo Property.

Usar campos distintivos

Los campos distintivos se denominan mediante la ruta al campo en el mensaje, con puntos para separar el nombre del mensaje, los nombres de los registros que cierran el campo y el propio nombre del campo:

MyMessage.MyRecord.MySubrecord.MyDistinguishedField  

Usar campos de propiedades

Una vez que ha 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 propiedad, 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 de los mensajes se denominan mediante el nombre del mensaje seguido del espacio de nombres (el esquema) y el nombre de la 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 compilar la orquestación. Para solucionarlo, debe agregar manualmente una @ delante del subrayado doble. 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, basta con colocar un asterisco entre paréntesis después de los dos nombres de mensaje, igual que si colocara una propiedad entre paréntesis:

MyMessage2(*)=MyMessage1(*);  

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

Consulte también

Promoción de propiedades
Uso de filtros con la forma Recibir mensaje
Uso de mensajes en orquestaciones
Propiedades de contexto de mensaje de BizTalk