参考
Reference 元素可用于向 BAM 活动添加一个或多个关系。 当要将诸如主键、ID 或 URL 之类的指针附加到相关消息时,这特别有用。 例如,可能要在“采购订单”活动中存储指向“发货批”的引用。
元素 Reference
支持 Data 和 LongData 子元素,这些子元素包含指定要附加到 BAM 活动的数据的表达式。 可以使用 Data 和 LongData 的任意组合来满足跟踪要求。
特性名 | 说明 |
---|---|
名称 | 将附加到 BAM 活动的关系的名称。 |
类型 | 任意字符串,用于指定将附加到 BAM 活动的关系的类型。 任意字符串和以下预定义 BAM 类型均受支持: - BizTalkService - MessageID - 活动 - DocumentUrl - InstanceID |
执行状态 | 说明 |
---|---|
数据 | 指定如何提取将附加到 BAM 活动的最多为 128 个字符的字符串数据。 |
LongData | 指定如何提取将附加到 BAM 活动的任意长度的字符串数据。 |
备注
元素 Reference
可以根据需要组合一个或多个 Data 和 LongData 子元素。
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>