Reference 元素可用于向 BAM 活动添加一个或多个关系。 如果要将指针(如主键、ID 或 URL)附加到相关消息,这非常有用。 例如,您可能会在采购订单活动中存储对发货批次的引用。
格式
该 Reference
元素同时支持 Data 和 LongData 子元素,其中包含指定要附加到 BAM 活动的数据的表达式。 可以使用 Data 和 LongData 的任意组合来满足跟踪要求。
特性
属性名称 | DESCRIPTION |
---|---|
名称 | 将附加到 BAM 活动的关系的名称。 |
类型 | 指定将附加到 BAM 活动的关系类型的任意字符串。 支持任意字符串和以下预定义 BAM 类型: - BizTalkService - 消息ID -活动 - DocumentUrl - 实例ID |
子元素
执行状态 | DESCRIPTION |
---|---|
数据 | 指定如何提取最多 128 个字符的字符串数据,并将其附加到 BAM 活动中。 |
LongData | 指定如何提取任意长的字符串数据,以便附加到 BAM 活动中。 |
注释
元素 Reference
可以根据需要组合一个或多个 Data 和 LongData 子元素。
注解
在引用表达式中,不允许以下常见操作:
和
等于
示例:
在以下示例中,使用 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>