チュートリアル: モジュール 3 - オーケストレーションから SharePoint プロパティへのアクセス

[アーティクル]
07/21/2023

このチュートリアルは、「チュートリアル: モジュール 2 - Office と Windows SharePoint Services アダプターの統合」の続きであり、実行時に受信メッセージのWindows SharePoint Services コンテキストプロパティにアクセスし、動的ポートを使用してプロパティに基づいてそのメッセージの送信先を決定する方法について説明します。オーケストレーション。 Windows SharePoint Services アダプターの概要については、「Windows SharePoint Services アダプターとは」を参照してください。

前提条件

このトピックの手順を実行するための前提条件は、次のとおりです。

Windows Server 2008 SP2 または Windows Server 2008 R2 で実行されているBizTalk Serverの完全なインストールを含む単一のサーバー展開が必要です。
「チュートリアル: モジュール 1 - Windows SharePoint Services アダプターを使用したメッセージの送受信」および「チュートリアル: モジュール 2 - Office と Windows SharePoint Services アダプターの統合」のチュートリアルを完了する必要があります。

マルチサーバー展開でのWindows SharePoint Services アダプターの使用については、「Windows SharePoint Services アダプターのセットアップと展開」を参照してください。

BizTalk プロジェクトの変更

この手順では、「チュートリアル: モジュール 2 - Office と Windows SharePoint Services アダプターの統合」で PurchaseOrder スキーマを変更します。この手順は、スキーマプロパティを昇格させ、BizTalk オーケストレーションで容易にアクセスできるようにする方法を示しています。

PurchaseOrder.xsd スキーマの変更

Microsoft Visual Studio を起動します。
[ ファイル] をクリックし、[ 開く] をクリックし、[ プロジェクト/ソリューション] をクリックします。
ファイルを OrderProcess.sln 参照し、[ 開く] をクリックします。
ソリューションエクスプローラーでファイルをOrderProcessSchema.xsd右クリックし、[開く] をクリックします。
BizTalk エディターで、を展開しますPurchaseOrder。
を右クリックし、[Amount昇格] をクリックし、[クイックプロモーション] をクリックします。
[OK] をクリックします。

注意

Visual Studio は、現在のプロジェクトでこのプロパティスキーマを作成します。
PurchaseOrder.xsd を保存します。

オーケストレーションの作成

ここでは、新しい BizTalk オーケストレーションを作成します。この手順により、Windows SharePoint Services アダプターが受信したメッセージを処理するためのオーケストレーションが作成されます。

BizTalk オーケストレーションの追加

ソリューションエクスプローラーでプロジェクトをOrderProcess右クリックし、[追加] をクリックし、[新しい項目] をクリックします。
[ カテゴリ] で、[ オーケストレーションファイル] を選択します。
[ テンプレート] で、[ BizTalk オーケストレーション] を選択します。
[名前] フィールドに「」と入力MyCompanyOrderProcessingし、[追加] をクリックします。

受信情報の作成

ここでは、オーケストレーションの新しいメッセージ、受信ポート、受信図形を作成します。この手順は、BizTalk Server からメッセージを受信するオーケストレーションの構成方法を示しています。

新しいメッセージの作成

オーケストレーションビューで、[メッセージ] を右クリックし、[新しいメッセージ] をクリックします。これにより、という名前 Message_1の新しいメッセージが生成されます。
を右クリックし、[Message_1名前の変更] をクリックして、「」と入力Message_POします。
を右クリックし、[Message_POプロパティウィンドウ] をクリックします。
[ メッセージの種類 ] プロパティで、[ スキーマ] を展開し、[スキーマ] を選択 OrderProcess.OrderProcessSchema します。

オーケストレーションへの受信ポートの追加

[ツールボックス] の [ BizTalk オーケストレーション ] で、[ ポート] 図形を [ポート] サーフェスにドラッグします。ポート構成ウィザードが起動します。
[ようこそ] 画面で、 [次へ] をクリックします。
[名前] フィールドに「」と入力ReceivePurchaseOrderし、[次へ] をクリックします。
[ 新しいポートの種類の作成] を選択します。
[ポートの種類名] フィールドに「」と入力PurchaseOrderPTし、[次へ] をクリックします。
[ ポートバインド] 画面で、既定値のままにして、[ 次へ] をクリックします。
[完了] をクリックします。
[オーケストレーションビュー] の [ポートの種類] で、ポートの種類をPurchaseOrderPT展開します。
を右クリックし、[Operation_1名前の変更] をクリックして、「」と入力PurchaseOrderOperationします。

オーケストレーションへの受信図形の追加

[ツールボックス] の [ BizTalk オーケストレーション ] で、[ 受信 ] 図形を [オーケストレーション] にドラッグします。
[受信] 図形を右クリックし、[ プロパティウィンドウ] をクリックします。
Activate プロパティをにTrue設定します。

Note

"アクティブ化" プロパティを false に設定すると、"エラー X2214: 自己関連付けを行わないポート上での非アクティベーション受信に対して、既に初期化されている関連付けセットを少なくとも 1 つ指定する必要があります" というエラーが表示されます。
[名前] フィールドに「」と入力Receive_POします。
[ プロパティ] ウィンドウで、Message プロパティを選択 Message_PO します。
Operation プロパティを選択ReceivePurchaseOrder.PurchaseOrderOperation.Requestします。オーケストレーションデザイナの受信図形にポートが連結されます。

送信情報の作成

ここでは、オーケストレーションに新しいメッセージ、送信ポート、判断構造を作成します。この手順は、判断ロジックを使ったオーケストレーションの構成方法、および、メッセージを送信ポートに送るようにオーケストレーションを構成する方法を示しています。

新しいメッセージの作成

オーケストレーションビューで、[メッセージ] を右クリックし、[新しいメッセージ] をクリックします。これにより、という名前 Message_1の新しいメッセージが生成されます。
を右クリックし、[Message_1名前の変更] をクリックして、「」と入力Message_Taskします。
を右クリックし、[Message_Taskプロパティウィンドウ] をクリックします。
[ メッセージの種類 ] プロパティで、[ スキーマ] を展開し、[スキーマ] を選択 OrderProcess.OrderProcessSchema します。

オーケストレーションへの送信ポートの追加

[ツールボックス] の [ BizTalk オーケストレーション ] で、[ ポート] 図形を [ポート] サーフェスにドラッグします。ポート構成ウィザードが起動します。
[ようこそ] 画面で、 [次へ] をクリックします。
[名前] フィールドに「」と入力SendPurchaseOrderし、[次へ] をクリックします。
[ 既存のポートの種類を使用する] を選択します。
[ 使用可能なポートの種類] で、を選択 OrderProcess.PurchaseOrderPTし、 [ 次へ] をクリックします。
[ ポートバインド] 画面の [ 通信のポートの方向] で、を選択 I'll always be sending messages on this portし、 [ 次へ] をクリックします。
[完了] をクリックします。

オーケストレーションへの送信図形の追加

[ツールボックス] の [BizTalk オーケストレーション] で、[送信] 図形を [オーケストレーション] Designerにドラッグします。 [受信] 図形の下に Receive_PO 配置します。
[送信] 図形を右クリックし、[ プロパティウィンドウ] をクリックします。
[名前] フィールドに「」と入力Send_POします。
Message プロパティを選択Message_POします。
Operation プロパティを選択SendPurchaseOrder.PurchaseOrderOperation.Requestします。オーケストレーションデザイナの送信図形にポートが連結されます。

オーケストレーションへの判断図形の追加

[ツールボックス] の [BizTalk オーケストレーション] で、[決定] 図形を [オーケストレーション] Designerにドラッグします。 [送信] 図形の下に Send_PO 配置します。
[決定] 図形を右クリックし、[プロパティウィンドウ] をクリック します。
[名前] フィールドに「」と入力NeedsApprovalします。
[オーケストレーション] Designerで、[決定] 図形の [Rule_1] をクリックします。
[プロパティ] ウィンドウで、Name プロパティに「」と入力ApprovalRequiredします。
[ 式 ] プロパティフィールドをクリックし、省略記号 (...) ボタンをクリックします。
BizTalk 式エディタで、以下の式を入力またはコピーします。
```
Message_PO(OrderProcess.PropertySchema.Amount) > 1000  
```
[OK] をクリックします。

オーケストレーションへの別の送信ポートの追加

[ツールボックス] の [ BizTalk オーケストレーション ] で、[ ポート] 図形を [ポート] サーフェスにドラッグします。ポート構成ウィザードが起動します。
[ようこそ] 画面で、 [次へ] をクリックします。
[名前] フィールドに「」と入力SendToTasksListし、[次へ] をクリックします。
[ 既存のポートの種類を使用する] を選択します。
[ 使用可能なポートの種類] で、を選択 OrderProcess.PurchaseOrderPTし、 [ 次へ] をクリックします。
[ ポートバインド] 画面の [ 通信のポート方向] で、を選択します I'll always be sending messages on this port。
[ ポートバインド] で、を選択 Dynamicし、 [ 次へ] をクリックします。
[完了] をクリックします。

判断図形への送信図形の追加

[ツールボックス] の [BizTalk オーケストレーション] で、[送信] 図形を [オーケストレーション] Designerにドラッグします。図形の下に配置します ApprovalRequired 。
[送信] 図形を右クリックし、[プロパティウィンドウ] をクリックします。
[名前] フィールドに「」と入力CreateApprovalTaskします。
Message プロパティを選択Message_Taskします。
Operation プロパティを選択SendToTasksList.PurchaseOrderOperation.Requestします。オーケストレーションデザイナの送信図形にポートが連結されます。

式の作成

ここでは、To Do パス値を変数に代入する式図形をソリューションに追加します。この手順は、動的送信ポートのプロパティを変更するためのロジックをオーケストレーションに追加する方法を示しています。

新しい式の作成

[ツールボックス] の [ BizTalk オーケストレーション ] で、[送信] 図形の前に [式 ] 図形を CreateApprovalTask ドラッグします。
[式] 図形を右クリックし、[プロパティウィンドウ] をクリック します。
[名前] フィールドに「」と入力SetPortDestinationします。
[ 式 ] プロパティフィールドをクリックし、省略記号 (...) ボタンをクリックします。

BizTalk 式エディターで、次のように入力します。

SendToTasksList(Microsoft.XLANGs.BaseTypes.Address) = "wss://localhost/sites/WSSAdapterWalkthrough/Lists/Tasks/";

[OK] をクリックします。

新しいメッセージの構築

ここでは、ある種類のメッセージの新しいインスタンスをオーケストレーションに構築する、メッセージ構築図形をソリューションに追加します。この手順は、受信メッセージをコピーして新しいメッセージを作成し、そのコンテキストプロパティを変更する方法を示しています。 BizTalk 内ではメッセージは不変である、つまり、作成した後に元のメッセージに変更を加えることはできないため、この手順が必要になります。

メッセージ構築図形の追加

[ツールボックス] の [ BizTalk オーケストレーション ] で、[メッセージの 構築] 図形を [式] 図形の前に SetPortDestination ドラッグします。
[メッセージの構築] 図形を右クリックし、[プロパティウィンドウ] をクリックします。
[名前] フィールドに「」と入力ConstructTaskMessageします。
[Messages Constructed]\(メッセージ構築済み\) プロパティを選択Message_Taskします。
[ツールボックス] の [BizTalk オーケストレーション] で、[メッセージの割り当て] 図形を [メッセージの構築]ConstructTaskMessage 図形にドラッグします。
[プロパティ] ウィンドウで、[名前] フィールドに「」と入力InitTaskMessageします。
[ 式 ] プロパティフィールドをクリックし、省略記号 (...) ボタンをクリックします。

BizTalk 式エディターで、次のように入力またはコピーします。

Message_Task = Message_PO;  
Message_Task(WSS.ConfigOverwrite) = "no";  
Message_Task(WSS.ConfigNamespaceAliases)= "orchns='http://OrderProcess.PurchaseOrder'";  
Message_Task(WSS.ConfigPropertiesXml) = "<ConfigPropertiesXml><PropertyName1>Title</PropertyName1><PropertySource1>Approve %XPATH=//orchns:PurchaseOrder/orchns:PurchaseOrderID%</PropertySource1><PropertyName3>Status</PropertyName3><PropertySource3>Not Started</PropertySource3><PropertyName4>Priority</PropertyName4><PropertySource4>(1) High</PropertySource4></ConfigPropertiesXml>";

重要

上記のコンテキストプロパティに指定する値は、大文字と小文字が区別されます。コンテキストプロパティを持つ動的ポートの構成値を設定する場合は、適切なケースを使用するか、BizTalk が指定された送信ポートにドキュメントをルーティングしようとしたときにエラーが発生することを確認する必要があります。

[OK] をクリックします。
[ファイル] をクリックして、 [すべて保存] をクリックします。

BizTalk プロジェクトのビルド

ここでは、BizTalk プロジェクトをビルドして配置します。 BizTalk Server によって実行時に使用されるアセンブリを作成および配置するために、この手順が必要になります。

ソリューションのビルドおよび配置

[ ビルド] をクリックし、[ Build OrderProcess] をクリックします。
[ ビルド] をクリックし、[ Deploy OrderProcess]$OrderProcess のデプロイ$ をクリックします。
Microsoft Visual Studio を閉じます。

受信場所と送信ポートの変更

ここでは、既存の受信場所と送信ポートを、パイプラインで XML 処理を行うように変更します。受信 XML パイプラインでは、オーケストレーション処理中に使用されたメッセージプロパティが保持されます。また、送信 XML パイプラインでは、オーケストレーションで適用されたメッセージプロパティ (後でメッセージルーティングに使用される) が保持されます。

受信場所を変更する

[スタート] ボタンをクリックし、[すべてのプログラム] をポイントし、[MicrosoftBizTalk Server] をポイントして、[BizTalk Server管理] をクリックします。
[MicrosoftBizTalk ServerAdministration SnapIn]、[BizTalk グループ]、[アプリケーション]、[BizTalk アプリケーション 1] の順に展開し、[受信場所] ノードをクリックします。
を右クリックし、[SourceLocationプロパティ] をクリックします。
[受信場所のプロパティ] ダイアログボックスの [全般] で、[受信パイプライン] プロパティを選択XMLReceiveします。
[OK] をクリックします。

送信ポートの変更

[ 送信ポート] ノードをクリックします。
を右クリックし、[SendToDestinationプロパティ] をクリックします。
[送信ポートのプロパティ] ダイアログボックスの [全般] で、[送信パイプライン] プロパティを選択XMLTransmitします。
[ フィルター ] タブを選択します。
既存の条件を選択し、DELETE キーを押して、[OK] をクリック します。

新しい送信ポートの開始

[ 送信ポート] ノードをクリックします。
を右クリックし、[OrderProcess_1.0.0.0_OrderProcess.MyCompanyOrderProcess_SendToTasksList_<GUID>開始] をクリックします。

Note

これが表示されない場合は、コンソールを更新する必要がある場合があります。

オーケストレーションをバインドする

ここでは、指定したポートにオーケストレーションをバインドします。ビルドと配置が済んだオーケストレーションに対し、物理ポートを関連付けるために、この手順が必要になります。

オーケストレーションをバインドする

BizTalk Server管理コンソールで、[オーケストレーション] ノードをクリックします。
オーケストレーションを OrderProcess.MyCompanyOrderProcessing 右クリックし、[ プロパティ] をクリックします。
[バインド] タブを選択します。
[ホスト] で、[ホスト] フィールドを選択BizTalkServerApplicationします。
[バインド] で、[受信論理ポート] ReceivePurchaseOrder を選択FromSourceします。
[バインド] で、[送信論理ポート] SendPurchaseOrder を選択SendToDestinationします。
[OK] をクリックします。
オーケストレーションを右クリックし、[OrderProcess.MyCompanyOrderProcessing開始] をクリックします。

システムからのメッセージ送信

ここでは、InfoPath フォームを作成し、Windows SharePoint Services Web サイトにアップロードします。そのメッセージは Windows SharePoint Services アダプターによって取得され、アーカイブドキュメントライブラリにアーカイブされた後、アップロード先のドキュメントライブラリに送信されます。このメッセージを処理する間、送信先を判断するために Windows SharePoint Services のコンテキストプロパティにアクセスします。

システムから送信する InfoPath フォームの作成

Web ブラウザを開き、作成したサイトの URL に移動します。たとえば、「 http://<server_name>/sites/WSSAdapterWalkthrough 」のように入力します。
[サイドリンクバー] メニューの [] をクリックします InfoPathSolutions。
ファイルを PurchaseOrder クリックして [ ファイルのダウンロード ] ダイアログボックスを表示し、[ 開く] をクリックします。フォームが読み込まれます。
[ 発注書 ID ] フィールドに、「」と入力します 1003。
[ 請求対象 ] フィールドに「」と入力します John Doe。
[ 金額 ] フィールドに「」と入力します 1750。
[ 発注書の日付] フィールドに、「」と入力します 1/3/2005。
[保存] をクリックします。
[名前を付けて保存] ダイアログボックスで、ファイル名フィールドに「」と入力http://<server_name>/sites/WSSAdapterWalkthrough/Sourceし、Enter キーを押します。
ファイル名フィールドに「」と入力PurchaseOrder3.xmlし、[保存] をクリックします。
InfoPath を終了します。
Web ブラウザーで、[ ドキュメントとリスト] をクリックします。
[ ドキュメントライブラリ] の [ コピー先] をクリックします。
宛先ドキュメントライブラリに、このライブラリにメッセージが一覧表示されます。アーカイブされたコピーは、アーカイブドキュメントライブラリにも表示されます。
[ホーム] をクリックします。
[ リスト] の [ タスク] をクリックします。
To Do リストに、新しく作成した承認済みのアイテムが表示されます。

Note

注文書の総額が $1,000.00 を超えていたので、タスクが作成されます。

まとめ

このチュートリアルでは、Windows SharePoint Services のコンテキストプロパティにアクセスする方法、および動的ポートを経由してメッセージの送信先を判断する方法を確認しました。

次の手順

Windows SharePoint Services アダプターセクションの残りの部分に進んでください。詳細については、「関連項目」の該当するトピックを参照してください。

参照

Windows SharePoint Services アダプターについて
 Windows SharePoint Services アダプターのチュートリアル

次の方法で共有

チュートリアル: モジュール 3 - オーケストレーションから SharePoint プロパティへのアクセス

前提条件

BizTalk プロジェクトの変更

PurchaseOrder.xsd スキーマの変更

オーケストレーションの作成

BizTalk オーケストレーションの追加

受信情報の作成

新しいメッセージの作成

オーケストレーションへの受信ポートの追加

オーケストレーションへの受信図形の追加

送信情報の作成

新しいメッセージの作成

オーケストレーションへの送信ポートの追加

オーケストレーションへの送信図形の追加

オーケストレーションへの判断図形の追加

オーケストレーションへの別の送信ポートの追加

判断図形への送信図形の追加

式の作成

新しい式の作成

新しいメッセージの構築

メッセージ構築図形の追加

BizTalk プロジェクトのビルド

ソリューションのビルドおよび配置

受信場所と送信ポートの変更

受信場所を変更する

送信ポートの変更

新しい送信ポートの開始

オーケストレーションをバインドする

オーケストレーションをバインドする

システムからのメッセージ送信

システムから送信する InfoPath フォームの作成

まとめ

次の手順

参照

フィードバック

フィードバック

その他のリソース