閱讀英文

共用方式為


參考

Reference元素可用來將一或多個關聯性加入 BAM 活動。 當您想要將指標如主索引鍵、識別碼或 URL 附加到相關訊息時,這十分有用。 例如,您可以在訂單活動中儲存出貨批次的參考。

格式

專案 Reference 同時支援 DataLongData 子項目,其中包含指定要附加至 BAM 活動之資料的運算式。 您可以使用 DataLongData 的任何組合來符合您的追蹤需求。

屬性

屬性名稱 描述
名稱 將附加到 BAM 活動的關係名稱。
類型 任意字串,指定將附加到 BAM 活動的關係類型。 支援任意字串和下列預先定義的 BAM 類型:

- BizTalkService
- MessageID
- Activity
- DocumentUrl
- InstanceID

子元素

執行狀態 描述
資料 指定如何擷取將附加到 BAM 活動的字串資料 (最多 128 個字元)。
LongData 指定如何擷取將附加到 BAM 活動的任意長度字串資料。

注意

元素 Reference 可以視需要合併一或多個 DataLongData 子項目。

備註

Reference 運算式中不允許執行下列常見的運算:

  • Equals

範例

在下列範例中,會針對工作流程建立 GetUserData 名為 「Related Document」 類型的 「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元素支援 混合 DataLongData 元素。 在下列範例中,會從 WCF 服務擷取來自採購單的國家/地區名稱和記事欄位,並寫入關聯性 「Long 和 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>

另請參閱

攔截器 OnEvent 元素EventStream.AddRelatedActivity 方法