チュートリアル: モジュール 1 - Windows SharePoint Services アダプターを使用したメッセージの送受信

  • [アーティクル]

このチュートリアルでは、Windows SharePoint Services アダプタとコンテンツ ベースのルーティング (CBR) を使用してメッセージを送受信できるように Windows SharePoint Services と BizTalk Server を構成する方法について説明します。 コンテンツ ベースのルーティングを使用すると、特定のポートに正確にバインドされたメッセージに対するメッセージ サブスクリプションが必要ではなくなります。 また、エンベロープのプロパティや受信ポートの構成プロパティに基づいてメッセージをルーティングするユーザーにとって、柔軟性も向上します。 Windows SharePoint Services アダプターの概要については、「Windows SharePoint Services アダプターとは」を参照してください。

前提条件

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

  • Windows Server 2008 SP2 または Windows Server 2008 R2 で実行されているBizTalk Serverを完全にインストールした単一サーバー展開が必要です。

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

Windows SharePoint Servicesの構成

ここでは、3 つのドキュメント ライブラリが含まれた、トップレベルの SharePoint Web サイトを作成します。 Windows SharePoint Services アダプターでは、これらのライブラリを使用して、メッセージをアップロード元のライブラリからアップロード先のライブラリに移動します。 このメッセージはドキュメント ライブラリにもアーカイブされます。 このチュートリアルで Windows Sharepoint Services アダプターによってアクセスする Windows SharePoint Services サイトを提供し、このサイトにアクセスするためのユーザー権限を設定するには、次の手順を実行する必要があります。

Windows SharePoint Services サイトの作成

  1. [スタート] ボタンをクリックし、[すべてのプログラム] をポイントし、[管理ツール] をポイントして、[SharePoint サーバーの全体管理] をクリックします。

  2. [ Virtual Server Configuration]\(仮想サーバーの構成\) で、[ Create a top-level Web site]\(トップレベル Web サイトの作成\) をクリックします。

  3. [仮想サーバーの一覧] で、Windows SharePoint Services アダプターをインストールした Web サイトを選択します。 たとえば、「 Default Web Site 」のように入力します。

  4. [ Web サイトのアドレス] セクションの [URL 名 ] フィールドに「」と入力します WSSAdapterWalkthrough。

  5. [ サイト コレクションの所有者 ] セクションの [ ユーザー名] フィールドに、 ユーザー名を入力します。 このユーザーが Web サイトの所有者になります。BizTalk Server の特別なアクセス許可は必要ありません。

  6. [ サイト コレクションの所有者 ] セクションの [ 電子メール ] フィールドに、電子メール アドレスを入力します。

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

  8. [ 最上位サイトが正常に作成されました ] ページで、先ほど作成した新しいトップレベル Web サイトをクリックします。 たとえば、「 http://<server_name>/sites/WSSAdapterWalkthrough 」のように入力します。

  9. テンプレートの一覧から [チーム サイト ] テンプレートを選択し、[OK] をクリック します。 これにより、チーム Web サイトのホーム ページが開きます。

"アップロード元" のドキュメント ライブラリの作成

  1. チーム Web サイトのホーム ページで、上部のナビゲーション バーの [ 作成] をクリックします。

  2. [ ドキュメント ライブラリ] で、[ ドキュメント ライブラリ] をクリックします。

  3. [名前と説明] セクションの [名前] フィールドに「」と入力します。Source

  4. [ ナビゲーション ] セクションで、[ はい ] を選択して、サイド リンク バーにこのフォーム ライブラリを表示します。

  5. [ ドキュメント テンプレート ] セクションの [ ドキュメント テンプレート ] ドロップダウン リストで、 を選択 Noneします。

  6. Create をクリックしてください。 ドキュメント ライブラリが作成され、空のライブラリにリダイレクトされます。

"アップロード先" のドキュメント ライブラリの作成

  1. チーム Web サイトのホーム ページで、上部のナビゲーション バーの [ 作成] をクリックします。

  2. [ ドキュメント ライブラリ] で、[ ドキュメント ライブラリ] をクリックします。

  3. [ 名前と説明 ] セクションの [ 名前] フィールドに「」と入力します Destination。

  4. [ ナビゲーション ] セクションで、[ はい ] を選択して、サイド リンク バーにこのフォーム ライブラリを表示します。

  5. [ ドキュメント テンプレート ] セクションの [ ドキュメント テンプレート ] ドロップダウン リストで、 を選択 Noneします。

  6. Create をクリックしてください。 ドキュメント ライブラリが作成され、空のライブラリにリダイレクトされます。

"アーカイブ" ドキュメント ライブラリの作成

  1. チーム Web サイトのホーム ページで、上部のナビゲーション バーの [ 作成] をクリックします。

  2. [ ドキュメント ライブラリ] で、[ ドキュメント ライブラリ] をクリックします。

  3. [ 名前 と説明] セクションの [ 名前] フィールドに「」と入力します Archive。

  4. [ ナビゲーション ] セクションで、[ はい ] を選択して、サイド リンク バーにこのフォーム ライブラリを表示します。

  5. [ ドキュメント テンプレート ] セクションの [ ドキュメント テンプレート ] ドロップダウン リストで、 を選択 Noneします。

  6. Create をクリックしてください。 ドキュメント ライブラリが作成され、空のライブラリにリダイレクトされます。

  7. Web サイトを WSSAdapterWalkthrough 閉じます。

  8. SharePoint サーバーの全体管理 Web サイトを閉じます。

Windows セキュリティの構成

  1. [ スタート] ボタンをクリックし、[ すべてのプログラム] をポイントし、[ 管理ツール] をポイントして、[ コンピューターの管理] をクリックします。

  2. コンソール ツリーで、[ローカル ユーザーとグループ] を展開し、[グループ] をクリックします。

  3. [SharePoint 対応ホスト] グループを右クリックし、[グループに追加] をクリックし、[追加] をクリックします。

  4. [ユーザー、コンピューター、またはグループの選択] ダイアログ ボックスの [選択するオブジェクト名を入力してください] で、BizTalk Serverホスト インスタンスを実行するように構成したアカウントの名前を入力し、[OK] をクリックします。

  5. コンソール ツリーで、[ サービスとアプリケーション] を展開し、[ サービス] をクリックします。

  6. [BizTalk Service BizTalk Group: <BizTalk_Host_Name>] を右クリックし、[再起動] をクリックします。

    Note

    <> BizTalk_Host_Nameはホストの名前です。 既定では、これは です BizTalkServerApplication。

    Note

    サービスを再起動するまで、メンバーシップは有効になりません。

  7. [コンピューターの管理] を閉じます。

SharePoint セキュリティの構成

  1. Web ブラウザを開き、作成したサイトの URL に移動します。 たとえば、「 http://<server_name>/sites/WSSAdapterWalkthrough 」のように入力します。

  2. チーム Web サイトのホーム ページで、上部のナビゲーション バーの [ サイトの設定] をクリックします。

  3. [ 管理] の [ ユーザーの管理] をクリックします。

  4. [ユーザーの追加] をクリックします。

  5. [手順 1: ユーザー] で、BizTalk Server ホスト インスタンスが実行されているアカウントの名前を入力します。

  6. [手順 2: サイト グループの選択] で、[閲覧者] ボックスと [共同作成者] チェック ボックスを選択します。

  7. [次へ] をクリックします。

  8. [次の電子メールを送信する] ボックスをオフにして、これらのユーザーに追加チェック許可する] ボックスをオフにし、[完了] をクリックします。

  9. Web サイトを WSSAdapterWalkthrough 閉じます。

BizTalk Server のポートの作成と構成

ここでは、Windows SharePoint Services アダプタ用に、BizTalk Server の受信ポート、受信場所、および送信ポートを作成および構成します。 これらのポートは、Windows Sharepoint Services アダプタによって送受信されたドキュメントが BizTalk Server で送受信される際のエントリ ポイントです。

受信ポートの作成

  1. [スタート]、[すべてのプログラム]、[Microsoft BizTalk Server 20xx] の順にクリックし、[BizTalk Server管理] をクリックします。

  2. [BizTalk Server管理] を展開し、[BizTalk グループ]、[アプリケーション]、[BizTalk アプリケーション 1] の順に展開し、[受信ポート] を右クリックし、[新規] をクリックして、[一方向の受信ポート] をクリックします。

  3. [受信ポートのプロパティ] ダイアログ ボックスの [全般] で、[名前] フィールドに「」と入力FromSourceします。

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

受信場所を作成する

  1. BizTalk 管理コンソールで、[受信場所] ノードを右クリックし、[新規] をクリックし、[一方向の受信場所] をクリックします。

  2. [ 受信ポートの選択 ] ダイアログ ボックスで、 を選択 FromSourceし、 [OK] をクリックします。

  3. [受信場所のプロパティ] ダイアログ ボックスの [全般] で、[名前] フィールドに「」と入力SourceLocationします。

  4. [ トランスポート ] セクションの [ 種類 ] ドロップダウン リストで、 を選択 Windows``SharePoint``Servicesします。

  5. [構成] をクリックして、Windows SharePoint Services アダプターのプロパティを構成します。

  6. [アダプター Web サービス ポート] プロパティに、Windows SharePoint Services アダプター Web サービスがインストールされた仮想サーバーのポート番号を入力します。 既定では、これはポート 80 です。

  7. [アーカイブの場所] プロパティに「」と入力Archiveします。

  8. [ポーリング間隔] プロパティに「」と入力10します。

  9. ShareP oint サイト URL プロパティに SharePointサイトの URL を入力します。 たとえば、「 http://<server_name>/sites/WSSAdapterWalkthrough 」のように入力します。

  10. [ソース ドキュメント ライブラリ] プロパティに「」と入力Sourceします。

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

  12. [受信場所のプロパティ] ダイアログ ボックスで、受信ハンドラーとして を選択BizTalkServerApplicationします。

  13. [ 受信パイプライン ] ドロップダウン リストで、 を選択 PassThruReceiveします。

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

送信ポートを作成する

  1. BizTalk 管理コンソールで、[送信ポート] ノードを右クリックし、[新規] をクリックし、[静的一方向送信ポート] をクリックします。

  2. [送信ポートのプロパティ] ダイアログ ボックスの [全般] で、[名前] フィールドに「」と入力SendToDestinationします。

  3. [ トランスポート ] セクションで、種類を選択 Windows SharePoint Services します。

  4. [構成] をクリックして、Windows SharePoint Services アダプターのプロパティを構成します。

  5. [アダプター Web サービス ポート] プロパティに、Windows SharePoint Services アダプター Web サービスがインストールされた仮想サーバーのポート番号を入力します。 既定では、これはポート 80 です。

  6. Destination[移動先フォルダー] プロパティに「」と入力します。

  7. Filename プロパティに PurchaseOrder1-%MessageID%.xml 「 」と 入力します。

  8. Overwrite プロパティを にYes設定します。

  9. SharePoint サイトの URL プロパティに、 SharePoint サイトの URL を 入力します。 たとえば、「 http://<server_name>/sites/WSSAdapterWalkthrough 」のように入力します。

  10. Microsoft Office Integration プロパティを に設定しますNo。

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

  12. [ 送信ポートのプロパティ] ダイアログ ボックスの [ 送信ハンドラー ] ドロップダウン リストで、 を選択 BizTalkServerApplicationします。

  13. [ パイプラインの送信 ] ドロップダウン リストで、 を選択 PassThruTransmitします。

  14. [フィルター] タブをクリックします。

  15. [プロパティ] フィールドで を選択WSS.InListNameします。

  16. [演算子] フィールドで を選択==します。

  17. [値] フィールドに「」と入力Sourceします。

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

受信場所と受信ポートの有効化と開始

ここでは、受信場所を有効にし、受信ポートを開始します。 Windows Sharepoint Services アダプターが指定された送信ポートおよび受信場所を使用してメッセージを送受信できるようにするには、次の手順を完了する必要があります。

受信場所の有効化

  1. BizTalk 管理コンソールで、[受信場所] ノードをクリックします。

  2. を右クリックし、[ SourceLocation有効にする] をクリックします。

送信ポートの開始

  1. BizTalk 管理コンソールで、[送信ポート] ノードをクリックします。

  2. を右クリックし、[SendToDestination開始] をクリックします。

  3. BizTalk 管理コンソールを閉じます。

システムを介したメッセージの送信

ここでは、XML ドキュメントを作成し、Windows SharePoint Services Web サイトにアップロードします。 そのメッセージは Windows SharePoint Services アダプターによって取得され、アーカイブ ドキュメント ライブラリにアーカイブされた後、アップロード先のドキュメント ライブラリに送信されます。 この手順は、Windows SharePoint Services アダプタを使用し、SharePoint Web サイトから、BizTalk Server を経由して SharePoint サービス Web サイトへと送信されるドキュメント フローを示しています。

作業ディレクトリを作成する

  • WSSAdapterWalkthrough という名前のディレクトリをコンピューターに作成します。 たとえば、「 C:\WSSAdapterWalkthrough 」のように入力します。

XML ファイルの作成

  1. [スタート] ボタンをクリックし、[すべてのプログラム] をポイントし、[アクセサリ] をポイントして、[メモ帳] をクリックします。

  2. 次のように入力します。

    <?xml version="1.0"?>  
<PurchaseOrder>  
    <ID>1001</ID>  
    <FirstName>John</FirstName>  
    <LastName>Doe</LastName>  
    <Amount>750</Amount>  
</PurchaseOrder>

  3. ファイルを作業ディレクトリに として PurchaseOrder1.xml保存します。 たとえば、「 C:\WSSAdapterWalkthrough\PurchaseOrder1.xml 」のように入力します。

XML ファイルのアップロード

  1. Web ブラウザーを開き、前の作業で作成したサイトの URL に移動します。 たとえば、「 http://<server_name>/sites/WSSAdapterWalkthrough 」のように入力します。

  2. 左側の [ ドキュメント] で、[ ソース] をクリックします。

  3. [ ドキュメントのアップロード] をクリックします。

  4. [ 名前 ] ボックスに、上で作成した XML ファイルを入力または参照します。 たとえば、 C:\WSSAdapterWalkthrough\PurchaseOrder1.xmlをクリックし、[ 保存して閉じる] をクリックします。 これで、ファイルが一覧内に表示されるようになります。

  5. ブラウザー ウィンドウを更新します。 このファイルは PurchaseOrder1.xml 、このライブラリに一覧表示されなくなります。

    Note

    ポーリング間隔が 10 秒に設定されているため、ブラウザーを数回更新する必要がある場合があります。

  6. 上部のナビゲーション バーで、[ ドキュメントとリスト] をクリックします。

  7. [ ドキュメント ライブラリ] の [ コピー先] をクリックします。

  8. 宛先ドキュメント ライブラリに、メッセージが一覧表示されます。 また、アーカイブ ドキュメント ライブラリにアーカイブされたコピーも表示されます。

    Note

    宛先ドキュメント ライブラリにメッセージが表示されない場合は、BizTalk Server ヘルプの「Windows SharePoint Services アダプターのトラブルシューティング」を参照してください。

まとめ

このチュートリアルでは、Windows SharePoint Services アダプタとコンテンツ ベースのルーティング (CBR) を使用してメッセージを送受信できるように Windows SharePoint Services と BizTalk Server を構成する方法について説明しました。

次の手順

このチュートリアルを完了したら、「チュートリアル: モジュール 2 - office と Windows SharePoint Services アダプターの統合」チュートリアルを実行します。このチュートリアルでは、このチュートリアルで行った作業を拡張し、Office と Windows SharePoint Services アダプターを統合する方法について説明します。

参照

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