参考文献

Reference 元素可用于向 BAM 活动添加一个或多个关系。 如果要将指针(如主键、ID 或 URL)附加到相关消息,这非常有用。 例如,您可能会在采购订单活动中存储对发货批次的引用。

格式

Reference 元素同时支持 DataLongData 子元素,其中包含指定要附加到 BAM 活动的数据的表达式。 可以使用 DataLongData 的任意组合来满足跟踪要求。

特性

属性名称 DESCRIPTION
名称 将附加到 BAM 活动的关系的名称。
类型 指定将附加到 BAM 活动的关系类型的任意字符串。 支持任意字符串和以下预定义 BAM 类型:

- BizTalkService
- 消息ID
-活动
- DocumentUrl
- 实例ID

子元素

执行状态 DESCRIPTION
数据 指定如何提取最多 128 个字符的字符串数据,并将其附加到 BAM 活动中。
LongData 指定如何提取任意长的字符串数据,以便附加到 BAM 活动中。

注释

元素 Reference 可以根据需要组合一个或多个 DataLongData 子元素。

注解

在引用表达式中,不允许以下常见操作:

  • 等于

示例:

在以下示例中,使用 GetUserData 创建一个类型为“DocumentUrl”的“Related Document”引用以供工作流使用。 由于用户数据长度应少于 1024 个字符,因此该 Data 元素用于包含 Expression 该元素。

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

Reference 元素支持混合Data元素和LongData元素。 在下面的示例中,从 WCF 服务检索采购订单中的国家/地区名称和备注字段,并将其写入关系“Long and Short Data”作为类型“MyType”。 由于注释字段支持超过 1024 个字符,因此表达式包含在元素中 LongData

<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>

另请参阅

Interceptor OnEvent 元素EventStream.AddRelatedActivity 方法