參考文獻

Reference 元素可用來將一或多個關聯性加入 BAM 活動。 當您想要將指標如主鍵、標識碼或 URL 附加至相關訊息時，這會很有用。 例如，您可能會在一項採購訂單活動中儲存對出貨批次的參考。

格式

元素 Reference 同時支援 Data 和 LongData 子專案，其中包含指定要附加至 BAM 活動之數據的運算式。 您可以使用 Data 和 LongData 的任何組合，以符合您的追蹤需求。

屬性

屬性名稱	說明
名稱	與 BAM 活動相關的關係名稱。
類型	任意指定的字串，用於指定將附加至 BAM 活動的關聯性類型。 支援任何字串與下列預先定義的 BAM 型態： - BizTalkService - 訊息識別碼 -活動 - 文件網址 - InstanceID

子專案

執行狀態	說明
資料	指定如何將最多 128 個字元的字串數據附加至 BAM 活動。
LongData	指定如何擷取將附加至 BAM 活動的任意長字串數據。

備註

元素 Reference 可以視需要結合一或多個 Data 和 LongData 子專案。

備註

參考表示式中不允許下列常見作業：

• 和

• 等於

範例

在下列範例中，將使用 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 元素支援 混合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 方法