Windows SharePoint Services 用 BizTalk Server アダプターは、Windows SharePoint Services および Microsoft Office InfoPath とのより緊密な統合を提供します。 次のトピックでは、Windows SharePoint Services アダプターの機能と概要について説明します。
Windows SharePoint Services アダプターの機能
次の一覧では、Windows SharePoint Services アダプターの重要な機能について説明します。
BizTalk Server XML およびバイナリ メッセージを SharePoint ドキュメント ライブラリに送信する機能。
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 サーバーには、Web サービス (BTSharePointAdapterWS.asmx) がインストールされ、Windows SharePoint Services のライブラリとリストにアクセスできます。 Web サービスは、SharePoint ライブラリからドキュメントを取得、配置、削除、アーカイブするメソッドを公開します。 受信アダプターは Web サービスからファイルを取得し、送信アダプターはファイルを送信します。
次の図は、これらの機能を提供する Windows SharePoint Services 用 BizTalk Server アダプターの主要なコンポーネントを示しています。
Windows SharePoint Services からのドキュメントの受信
受信アダプターは、Windows SharePoint Services ドキュメント ライブラリ ビューをポーリングします。 Windows SharePoint Services オブジェクト モデルを使用してライブラリを参照し、ファイルをチェックアウトし、ファイル データをアダプターに返す Windows SharePoint Services サーバー上の Web メソッドを呼び出します。 次に、アダプターは BizTalk Server メッセージ ボックスにファイルを送信し、別の Web メソッドを呼び出して Windows SharePoint Services からファイルを削除またはアーカイブします。 Windows SharePoint Services ライブラリ内のファイルをフィルター処理するために、アダプターは Windows SharePoint Services ビューを介して Windows SharePoint Services ライブラリをポーリングします。
集中型 (ポーリング) アプローチでは、BizTalk サーバーで構成を行う単純な管理モデルが提供されます。 また、メッセージのバッチ処理が可能であるため、パフォーマンスも向上します。
プラットフォーム レベルのトランザクション サポートは Windows SharePoint Services、Web サービス、BizTalk Server では利用できないので、チェックアウト メカニズムを使用して、エラー状態に関連するエラーを最小限に抑えます。 特定の条件下 (つまり、ファイルは BizTalk Server メッセージ ボックス データベースに正常に送信されますが、Windows SharePoint Services から削除することはできません) では、BizTalk Server に送信された場合でも、ファイルは Windows SharePoint Services サーバーでチェックアウトされたままになります。 エラーは BizTalk サーバーのイベント ログに記録されます。
Windows SharePoint Services へのドキュメントの送信
アダプターは、Windows SharePoint Services サーバーで Web メソッドを呼び出して、Windows SharePoint Services にドキュメントを送信します。 アダプターは、Windows SharePoint Services サイトの URL、ドキュメント ライブラリ、またはリスト URL を、サイト、ファイル、またはリスト アイテム名に対して相対的に指定し、ファイルに関連付ける昇格されたプロパティを指定します。
ファイル名は、固定文字列またはドキュメント内の XML データから派生した名前に設定できます。 名前の派生は、標準の名前付け規則を適用する場合に非常に役立ちます。 アダプターは、ファイルの昇格されたプロパティ値を列の値として設定することもできます。 ファイル名と同様に、昇格されたプロパティ値は固定することも、ドキュメント内の XML データから派生することもできます。
Von Bedeutung
Windows SharePoint Services アダプターの昇格されたプロパティは、BizTalk Server の昇格されたプロパティや Windows SharePoint Services の昇格されたプロパティとは異なるエンティティです。
Windows SharePoint Services の昇格されたプロパティは、Windows SharePoint Services フォーム ライブラリを参照するときに XML 要素を表示するために使用されます。 InfoPath フォームを Windows SharePoint Services フォーム ライブラリに発行すると、InfoPath がフォーム ライブラリを構成し、キー要素が自動的に昇格されるようにします。 この機能は、Windows SharePoint Services で InfoPath フォーム ライブラリ (同じ XSD スキーマと InfoPath ソリューションを持つ InfoPath フォームを格納するドキュメント ライブラリ) を使用する場合にのみ使用できます。
Windows SharePoint Services アダプターのプロパティの昇格を使用すると、異なるスキーマを持つドキュメントが同じドキュメント ライブラリに格納されている場合に、ユーザーはプロパティを Windows SharePoint Services に昇格できます。
BizTalk Server プロパティの昇格も同様の概念であり、プロパティは、UI 上のエンド ユーザーではなく、メッセージのプロパティとしてオーケストレーションに表示されます。 さらに、BizTalk Server は、プロパティ値がドキュメントに保存される際に、プロパティの降格という概念をサポートしています。
(任意の XML およびドキュメント ライブラリではなく) InfoPath フォームおよびフォーム ライブラリで Windows SharePoint Services アダプターを使用する場合、送信アダプターを介して昇格されたプロパティを設定する必要はありません。 代わりに、オーケストレーション内でドキュメントを変更できます (メッセージを直接変更するか、降格されるプロパティを介して間接的に変更します)。 値は、Windows SharePoint Services によって自動的に昇格されます。
Windows SharePoint Services アダプターのセキュリティに関する考慮事項
Windows SharePoint Services アダプターは、サブシステム、Windows SharePoint Services Web サイトで実行される BTSharePointAdapterWS Web サービス、BizTalk Server ホスト インスタンス プロセス内で BizTalk サーバー上で実行されるアダプター ランタイムで構成されます。 アダプター ランタイムは、Windows SharePoint Services 内で特定のタスクを実行するためのアクセス許可を持っている必要がある BTSharePointAdapterWS Web サービスを呼び出します。 このコンポーネントは呼び出し元として実行されるため、アクセス許可を呼び出し元に付与する必要があります。 つまり、そのサイトからメッセージを送受信できるようにするには、BizTalk ホスト インスタンスを SharePoint サイトで 共同作成者 にする必要があります。 BTSharePointAdapterWS Web サービスは、 SharePoint Enabled Hosts グループのメンバーのみが呼び出すことができます。 アダプター ランタイムを実行する BizTalk ホスト インスタンスが Web サービスと対話できるようにするには、ホスト インスタンスの Windows アカウントを SharePoint 対応ホスト グループのメンバーにする必要があります。 管理者は、このグループのアカウントを追加および削除し、ホスト インスタンス アカウントを SharePoint 共同作成者 ロールのメンバーにする必要があります。
| コンポーネント | プロセスアイデンティティ | 権限 |
|---|---|---|
| BTSharePointAdapterWS Web サービス | 呼び出し元 ID | SharePoint 対応ホスト グループに付与されたアクセス許可を呼び出す |
| アダプター ランタイム | 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 サービス サイトが作成されたときにアダプターは HTTPS を使用して BTSSharePointAdapterWS Web サービスと通信します。または、サーバー証明書を使用せずに IIS Web サイトで Windows SharePoint Services サイトが作成されるときに、HTTP を使用して BTSharePointAdapterWS Web サービスと通信します。
こちらもご覧ください
Windows SharePoint Services アダプターの設定と展開
Windows SharePoint Services アダプターの構成
Windows SharePoint Services アダプターのチュートリアル