使用英语阅读

通过


参考

Reference 元素可用于向 BAM 活动添加一个或多个关系。 当要将诸如主键、ID 或 URL 之类的指针附加到相关消息时,这特别有用。 例如,可能要在“采购订单”活动中存储指向“发货批”的引用。

格式

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

属性

特性名 说明
名称 将附加到 BAM 活动的关系的名称。
类型 任意字符串,用于指定将附加到 BAM 活动的关系的类型。 任意字符串和以下预定义 BAM 类型均受支持:

- BizTalkService
- MessageID
- 活动
- DocumentUrl
- InstanceID

子元素

执行状态 说明
数据 指定如何提取将附加到 BAM 活动的最多为 128 个字符的字符串数据。
LongData 指定如何提取将附加到 BAM 活动的任意长度的字符串数据。

备注

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

注解

Reference 表达式中不允许使用以下常见运算:

  • 等于

示例

在下面的示例中,使用 GetUserData 为工作流创建名为“DocumentUrl”类型的“相关文档”的引用。 由于用户数据的长度应少于 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 元素支持 和 LongData 元素的Data混合。 在以下示例中,从 WCF 服务检索采购订单中的国家/地区名称和备注字段,并将其写入关系“长短数据”类型为“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 方法