Windows SharePoint Services アダプターについて

Windows SharePoint Services用のBizTalk Server アダプターは、Windows SharePoint Servicesと Microsoft Office InfoPath との緊密な統合を提供します。 このトピックでは、Windows SharePoint Services アダプタの機能および動作の概要について説明します。

Windows SharePoint Services アダプタの機能

Windows SharePoint Services アダプタの主要機能を次の一覧に示します。

• XML またはバイナリの BizTalk Server メッセージを SharePoint Services ドキュメント ライブラリに送信する機能。

• InfoPath との統合: 送信BizTalk Server XML メッセージを変換して、Windows SharePoint Services サイトから開いたときに InfoPath で自動的に開くことができます。

• Windows SharePoint Services に送信されるメッセージのプロパティの昇格。 オーケストレーション インスタンス ID、メッセージ ID、またはメッセージから抽出した値など、メッセージに関する BizTalk Server メタデータで、最大 16 列の SharePoint 列を更新できます。

• メッセージの内容および BizTalk Server プロパティに基づくファイル名の定義。

• (ドキュメント ライブラリではなく) 任意のリストにドキュメントを送信する機能: この場合、ドキュメント自体はWindows SharePoint Servicesに格納されませんが、プロパティの昇格が引き続き発生するため、新しいリスト アイテムが作成され、列の値がメッセージから取得されます。

• 任意のドキュメント ライブラリの任意のビューからメッセージを受信し、指定したファイル名を使用して指定したドキュメント ライブラリにアーカイブする機能。

• BizTalk ServerでのWindows SharePoint Services アダプタープロパティの昇格: Windows SharePoint Servicesファイル情報は、メッセージ コンテキスト プロパティとしてBizTalk Serverで使用できます。 メッセージ コンテキスト プロパティには、パイプライン、オーケストレーションなどからアクセスできます。カスタム SharePoint 列には WSS を介してアクセスできます。InPropertiesXml ドキュメント。

• 動的ポートの完全なサポート: 送信アダプターは、静的 URI バインディング (送信ポートの作成時にユーザーによって定義) または動的 URI バインディング (メッセージの送信時にオーケストレーションによって定義) をサポートできます。 物理送信ポートや動的送信ポートのすべての構成情報は、WSS.Filename、WSS.ConfigTimeout などのメッセージ コンテキスト プロパティから定義できます。

• パフォーマンス カウンター

Windows SharePoint Services アダプターのしくみ

Windows SharePoint Services用のBizTalk Server アダプターは、次の 3 つのメイン コンポーネントで構成されます。

• Windows SharePoint Services アダプタ Web サービス

• Windows SharePoint Services 受信アダプタ

• Windows SharePoint Services 送信アダプタ

  Windows SharePoint Services サーバーには、Windows SharePoint Services のライブラリおよび一覧にアクセスするための Web サービス (BTSharePointAdapterWS.asmx) がインストールされます。 この Web サービスは、SharePoint ライブラリのドキュメントを取得、配置、削除、およびアーカイブするメソッドを公開しています。 受信アダプタは Web サービスからファイルを受け取り、送信アダプタは Web サービスにファイルを渡します。

  次の図は、これらの機能を提供するWindows SharePoint Services用のBizTalk Server アダプターのメインコンポーネントを示しています。

  

Windows SharePoint Services からのドキュメントの受信

受信アダプタは、Windows SharePoint Services ドキュメント ライブラリのビューにポーリングして、 Windows SharePoint Services サーバーにある、Windows SharePoint Services オブジェクト モデルを使用する Web メソッドを呼び出し、ライブラリの参照、ファイルのチェックアウト、およびアダプタへのファイル データ返信を行います。 その後、BizTalk Server メッセージ ボックスにファイルを送信して、Windows SharePoint Services からファイルを削除またはアーカイブする別のメソッドを呼び出します。 Windows SharePoint Services ライブラリのファイルをフィルタ選択するため、アダプタが Windows SharePoint Services のビューから Windows SharePoint Services のライブラリにポーリングします。

ポーリングを一括して行うことで、BizTalk Server で構成できる単純な管理モデルが実現されます。 また、メッセージのバッチ処理が可能になり、パフォーマンスが向上します。

Windows SharePoint Services、Web サービス、および BizTalk Server ではプラットフォームレベルのトランザクションのサポートを利用できないので、チェックアウト メカニズムを使用して障害発生に伴うエラーを最小限に抑えます。 一定の条件下では、つまり、BizTalk Server メッセージ ボックス データベースにファイルが正常に送信されるものの、Windows SharePoint Services から削除できない場合は、ファイルは BizTalk Server に送信された後も Windows SharePoint Services サーバーでチェックアウトされたままになります。 エラーは BizTalk Server のイベント ログに記録されます。

Windows SharePoint Services へのドキュメントの送信

アダプタは、Windows SharePoint Services サーバーの Web メソッドを呼び出すことによって、Windows SharePoint Services にドキュメントを送信します。 Windows SharePoint Services サイトの URL、そのサイトから見たドキュメント ライブラリまたは一覧の相対 URL、ファイル、または一覧項目名と昇格させたプロパティを指定して、そのファイルに関連付けます。

ファイル名は、固定文字列またはドキュメントの XML データから派生した名前に設定できます。 派生した名前を使用すると、標準の名前付け規則を適用しやすくなります。 また、昇格させたファイル プロパティの値を列の値として設定できます。 ファイル名と同様に、昇格させたプロパティの値は、固定文字列またはドキュメントの XML データから派生した名前に設定できます。

重要

Windows SharePoint Services アダプタの昇格させたプロパティは、BizTalk Server の昇格させたプロパティや Windows SharePoint Services の昇格させたプロパティとは異なるエンティティです。

Windows SharePoint Services の昇格させたプロパティを使用すると、Windows SharePoint Services フォーム ライブラリを参照するときに XML 要素を表示できます。 InfoPath フォームを Windows SharePoint Services フォーム ライブラリに公開すると、主要な要素を自動的に昇格させるようフォーム ライブラリが構成されます。 この機能は、Windows SharePoint Services で InfoPath フォーム ライブラリ (同一の XSD スキーマと InfoPath ソリューションを使用した複数の InfoPath フォームを保存するドキュメント ライブラリ) を使用するときに限り使用できます。

Windows SharePoint Services アダプタでのプロパティの昇格を使用することで、スキーマが異なるドキュメントが同一のドキュメント ライブラリに保存されているときに、ユーザーが Windows SharePoint Services にプロパティを昇格できます。

オーケストレーションにはプロパティをメッセージのプロパティとして見せ、エンド ユーザーの UI には見せないようにする点では、BizTalk Server のプロパティの昇格も同様の考え方です。 BizTalk Server では、プロパティの値をドキュメントに戻して保存するときにプロパティを降格するという概念もサポートされています。

Windows SharePoint Services アダプタを (任意の XML およびドキュメント ライブラリではなく) InfoPath フォームおよびフォーム ライブラリと使用するときは、昇格させたプロパティを送信アダプタで設定する必要はありません。 代わりに、(メッセージを直接変更するか、降格するプロパティから間接的に変更して) ドキュメントをオーケストレーション内で変更できます。 値は Windows SharePoint Services により自動的に昇格されます。

Windows SharePoint Services アダプタのセキュリティに関する考慮事項

Windows SharePoint Services アダプタは、Windows SharePoint Services Web サイトで実行される BTSharePointAdapterWS Web サービスと、BizTalk Server ホスト インスタンス プロセス内の BizTalk Server で実行されるアダプタ ランタイムという 2 つのサブシステムから構成されています。 アダプタ ランタイムから呼び出す BTSharePointAdapterWS Web サービスには、Windows SharePoint Services 内の特定の作業を実行できるアクセス許可が必要です。 アダプタ ランタイムは呼び出し元として実行されるので、アクセス許可は呼び出し元に与える必要があります。 つまり、そのサイトからメッセージを送受信できるようにするには、BizTalk ホスト インスタンスを SharePoint サイトで 共同作成者 にする必要があります。 BTSharePointAdapterWS Web サービスは、 SharePoint 対応ホスト グループのメンバーのみが呼び出すことができます。 アダプター ランタイムを実行している BizTalk ホスト インスタンスが Web サービスと対話できるようにするには、ホスト インスタンスの Windows アカウントを SharePoint 対応ホスト グループのメンバーにする必要があります。 管理者は、このグループのアカウントを追加および削除し、ホスト インスタンス アカウントを SharePoint 共同作成者 ロールのメンバーにする必要があります。

コンポーネント	プロセス ID	権限
BTSharePointAdapterWS Web サービス	呼び出し元の ID	SharePoint Enabled Hosts グループに与えられた呼び出しアクセス許可
アダプタ ランタイム	BizTalk ホストの ID	該当なし
Windows SharePoint Services オブジェクト モデル	該当なし	SharePoint Enabled Hosts グループは、SharePoint Services の共同作成者ロールのメンバーである必要があります。

BizTalk Serverセットアップでは、SHAREPoint Enabled Hosts グループのメンバーであるアカウントのみがこの Web サービスにアクセスできるように、BTSharePointAdapterWS Web サービスに対するアクセス許可を構成します。 ホストでWindows SharePoint Services アダプターを実行する場合、管理者は、そのホストに関連付けられている NT グループを SharePoint 対応ホスト グループに追加し、SharePoint 対応ホスト グループを Windows SharePoint Services 共同作成者ロールに追加する必要があります。

Windows SharePoint Services のファイル、一覧、およびドキュメント ライブラリへのアクセス許可は、Windows SharePoint Services のセキュリティで制限します。 メッセージは、Windows SharePoint Services から直接 BizTalk Server に送信されます。 アダプタ ランタイムと Web サービスの間の通信は、HTTP または HTTPS 経由で行われます。

アダプタでは、BTSharePointAdapterWS Web サービスが Windows SharePoint Services サイトと同一の HTTP スキーマ (HTTP または HTTPS) を使用していることを前提としています。 つまり、セキュリティで保護された IIS Web サイトに Windows SharePoint Services サイトが作成されている場合、BTSSharePointAdapterWS Web サービスとの通信には HTTPS が使用され、サーバー証明書がない IIS Web サイトに Windows SharePoint Services サイトが作成されている場合、HTTP が使用されます。

参照

Windows SharePoint Services アダプターの設定と展開
Windows SharePoint Services アダプターの構成
Windows SharePoint Services アダプターのチュートリアル