英語で読む

次の方法で共有


リファレンス

Reference 要素を使用して、BAM アクティビティに 1 つ以上のリレーションシップを追加できます。 この機能は、主キー、ID、URL などのポインタを関連するメッセージに追加する必要がある場合に便利です。 たとえば、出荷バッチへの参照を発注アクティビティに保存できます。

フォーマット

要素は Reference 、BAM アクティビティにアタッチするデータを指定する式を含む Data 子要素と LongData 子要素の両方をサポートします。 データLongData の任意の組み合わせを使用して、追跡要件を満たすことができます。

属性

属性名 説明
名前 BAM アクティビティに追加されるリレーションシップの名前です。
Type BAM アクティビティに追加されるリレーションシップの種類を指定する任意の文字列です。 任意の文字列だけでなく、以下の定義済みの BAM の種類もサポートされています。

- BizTalkService
-Messageid
- Activity
- DocumentUrl
-Instanceid

子要素

実行状態 説明
データ BAM アクティビティに追加される最大 128 文字の文字列データを抽出する方法を指定します。
LongData BAM アクティビティに追加される任意の長さの文字列データを抽出する方法を指定します。

注意

要素は Reference 、必要に応じて、1 つ以上の 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 サービスから取得され、リレーションシップ "Long and Short Data" に型 "MyType" として書き込まれます。 note フィールドは 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 メソッド