Referencia

El elemento Reference se puede usar para agregar una o varias relaciones a una actividad bam. Resulta útil cuando se desea adjuntar un puntero como una clave principal, un Id. o una URL a un mensaje relacionado. Por ejemplo, podría almacenar una referencia a un lote de envío en una actividad de pedido.

Formato

El Reference elemento admite los elementos secundarios Data y LongData que contienen una expresión que especifica los datos que se van a adjuntar a la actividad bam. Puede usar cualquier combinación de Data y LongData para satisfacer sus requisitos de seguimiento.

Atributos

Nombre del atributo	Descripción
Nombre	Nombre de la relación que se adjuntará a la actividad de BAM.
Tipo	Cadena arbitraria que especifica el tipo de relación que se adjuntará a la actividad de BAM. Se admiten las cadenas arbitrarias y los siguientes tipos de BAM predefinidos: - BizTalkService - MessageID - Activity (Actividad) - DocumentUrl - InstanceID

Elementos secundarios

Estado de ejecución	Descripción
data	Especifica cómo extraer los datos de la cadena hasta 128 caracteres que se adjuntará a la actividad de BAM.
LongData	Especifica cómo extraer los datos de cadenas largas arbitrariamente que se adjuntarán a la actividad de BAM.

Nota

Un Reference elemento puede combinar uno o varios elementos secundarios Data y LongData según sea necesario.

Comentarios

En expresiones de Reference, no se permiten las operaciones comunes siguientes:

• And

• Equals

Ejemplo

En el ejemplo siguiente, se crea una referencia denominada "Documento relacionado" de tipo "DocumentUrl" mediante GetUserData para un flujo de trabajo. Dado que se espera que los datos del usuario sean de menos de 1024 caracteres, el Data elemento se usa para contener el Expression elemento .

<ic:Reference Name="Related Document" Type="DocumentUrl">
  <ic:Data>
    <ic:Expression>
      <wf:Operation Name="GetUserData" />
    </ic:Expression>
  </ic:Data>
</ic:Reference>

El elemento Reference admite una combinación de Data elementos y LongData . En el ejemplo siguiente, los campos de nombre de país o región y nota de un pedido de compra se recuperan de un servicio WCF y se escriben en la relación "Datos largos y cortos" como tipo "MyType". Dado que el campo de nota admite más de 1024 caracteres, la expresión se incluye en un LongData elemento .

<ic:Reference Name="Long and Short Data" Type="MyType">
  <ic:Data>
    <ic:Expression>
      <ic:Operation Name="Constant">
        <ic:Argument>Country: </ic:Argument>
      </ic:Operation>
      <wcf:Operation Name="XPath">
        <wcf:Argument>//s:Body//po:Country</wcf:Argument>
      </wcf:Operation>
       <ic:Operation Name="Concatenate" />
    </ic:Expression>
  </ic:Data>
  <ic:LongData>
    <ic:Expression>
      <ic:Operation Name="Constant">
        <ic:Argument>Note: </ic:Argument>
      </ic:Operation>
      <wcf:Operation Name="XPath">
        <wcf:Argument>//s:Body//po:Note</wcf:Argument>
      </wcf:Operation>
      <ic:Operation Name="Concatenate" />
    </ic:Expression>
  </ic:LongData>
</ic:Reference>

Consulte también

Método EventStream.AddRelatedActivitydel elemento Interceptor OnEvent