リファレンス
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>