Windows SharePoint Services の受信場所を構成する方法

[アーティクル]
05/04/2023

このトピックでは、BizTalk Server 管理コンソールを使用して Windows SharePoint Services の受信場所を作成および構成する方法について説明します。

Windows SharePoint Services の受信場所を作成および構成するには

受信ポートが正しく構成されていることを確認してください。受信ポートを作成および構成する方法については、「受信ポートを作成する方法」を参照してください。
BizTalk Server管理コンソールで、[BizTalk Server管理] を展開し、[BizTalk グループ [GroupName] を展開し、[アプリケーション] を展開して、受信場所を作成するアプリケーションを展開します。
[ 受信場所] を右クリックし、[ 新規] をクリックし、[ 一方向の受信場所] をクリックします。
この受信場所を含む受信ポートを選択し、[OK] をクリック します。
[受信場所のプロパティ] ダイアログボックスの [トランスポート] の [種類] ドロップダウンボックスで、[Windows SharePoint Services] を選択します。
[構成] をクリックします。

[トランスポートのプロパティのWindows SharePoint Services] ダイアログボックスで、次の操作を行います。

プロパティ	目的
アダプター Web サービスポート	Windows SharePoint Services アダプタの Web サービスがインストールされる IIS Web サイトの HTTP ポート。既定では、これはポート 80 で構成された既定の Web サイトです。既定の Web サイト以外の IIS Web サイトでWindows SharePoint Services Web サービスを構成した場合は、この値を更新する必要があります。
タイムアウト	Windows SharePoint Services アダプターの Web サービスに対するアダプターのランタイム Web サービス呼び出しに適用されるミリ秒単位のタイムアウト値。アダプターによって推定される平均値よりもメッセージまたはバッチサイズが大きい場合、この値を大きくする必要があります。
アーカイブファイル名	(省略可)。アーカイブ済みファイルの Windows SharePoint Services ファイル名。 "PurchaseOrder0001.xml" のようなリテラル値または式を入力できます。式には、リテラル値、マクロ、および XPATH クエリを混在させることができます。たとえば、"PurchOrd-%XPATH=//po:PurchaseOrderId%-%MessageID%.xml" などです。ファイル名を指定しなかった場合は、ソースファイルのファイル名が使用されます。式の詳細については、「Windows SharePoint Services アダプター式」を参照してください。メモ： "%SendingOrchestrationID%" および "%SendingOrchestrationType%" マクロは、このフィールドではサポートされていません。
アーカイブ先 URL	処理されたファイルがアーカイブされる、SharePoint サイトと相対的な Windows SharePoint Services フォルダの URL。たとえば、Archive または /Shared Documents/Processed Orders/ などです。アーカイブ場所を指定しなかった場合、ドキュメントは、アダプタによって処理された後に削除されます。メモ： SharePoint ドキュメントライブラリやフォルダー URL が、そのアイテムの名前と異なる場合があります。正しい URL を検出するには、インターネットエクスプローラーのアドレスバーを確認します。
アーカイブの上書き	アーカイブの既存のファイルを上書きするかどうかを決定します。 [はい] を選択すると、既存のファイルが上書きされます。 [いいえ] を選択すると、同じ名前のファイルがアーカイブに存在する場合、アーカイブに失敗します。この場合、ファイルはチェックアウトされたままになるため、手動でそのファイルをアーカイブする必要があります。メモ：ファイルをアーカイブする場合は、ファイル名を一意にするために、マクロでファイル名のアーカイブ値を使用することをお勧めします。このため、PO-%MessageID%.xml や PO-%XPATH=//ns0:PurchaseOrder/ns0:ID%.xml などのアーカイブファイル名を使用できます。ID は注文書の一意な ID です。
バッチサイズ	Windows SharePoint Services メッセージアダプタ Web サービスでバッチとして処理するドキュメントの最大数。処理されるバッチには、定義されたバッチサイズ未満のメッセージを格納できますが、そのサイズを超えるメッセージは格納できません。
エラーのしきい値	受信場所が無効になるまでにアダプタで連続して発生するポーリング障害の最大数。このフィールドを 0 に設定すると、受信場所は無効になりません。
名前空間エイリアス	(省略可能) 名前空間のエイリアスの定義をコンマまたはセミコロンで区切った一覧。このフィールドを使用して、[アーカイブファイル名] フィールドに設定された XPATH クエリで使用される、名前空間エイリアスを定義します。たとえば、po=`'http://OrderProcess/POrder'`, conf=`'http://OrderProcess/Confirmation'` ipsol='{D8217CF1-4EF7-4bb5-A30D-765ECB09E0D9}'
ポーリング間隔	処理する新しいメッセージがあるかどうかを確認するために、アダプタによって実行される 2 つの連続したクエリ間の秒単位の時間間隔。メモ：値を小さく指定すると、アダプターのスループットと応答時間が向上します。
SharePoint サイトの URL	Windows SharePoint Services Web サイトの完全な URL。たとえば、http://BizTalkServer/sites/TestSite. のように指定します。メモ：送信ポートまたは受信場所の URI は 256 文字を超えることはできません。
基になるドキュメントライブラリの URL	ドキュメントの取得元となる、SharePoint サイトと相対的な Windows SharePoint Services ドキュメントライブラリの URL。たとえば、/Shared Documents/ や /New Purchase Orders/ などです。メモ： SharePoint リストからメッセージを受信することはできません。 SharePoint フォルダからのメッセージを受信するには、すべてのフォルダ内のメッセージを表示するビューを使用する必要があります。これを行うには、ビューの作成時に Folders プロパティを [ フォルダーなしですべてのドキュメントを表示する] の値に設定します。メモ： SharePoint ドキュメントライブラリが、そのアイテムの名前と異なる場合があります。正しい URL を検出するには、インターネットエクスプローラーのアドレスバーを確認します。
ビュー名	アダプタによって処理されるドキュメントをフィルタ処理するために使用される Windows SharePoint Services ビュー。たとえば、Approved Orders などです。ソースドキュメントライブラリ内のすべての既存のドキュメントを処理するには、このフィールドを空のままにします。ビューに表示されるフォルダとそれらのフォルダに含まれるメッセージは、アダプタによって処理されません。サブフォルダのドキュメントを含むフラットな構造ですべてのドキュメントを表示するフラットビューを作成できます。メモ：フラットビュー内のすべてのメッセージが処理されます。
Microsoft Office 統合	[省略可能] を選択すると、InfoPath 処理命令が削除可能な場合は削除され、削除できない場合 (バイナリドキュメントの場合など) はそのまま処理されます。 [はい] を選択すると、InfoPath 処理命令が削除され、エラーが発生した場合はメッセージがスキップされます。 [いいえ] を選択して、ドキュメントを "そのまま" 処理します。バイナリメッセージの場合は、"いいえ" または "省略可能" の値を使用する必要があります。

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

参照

Windows SharePoint Services 送信ハンドラを構成する方法
 Windows SharePoint Services 送信ポートを構成する方法
 送信ポートを作成する方法
 Windows SharePoint Services アダプターのプロパティに関するリファレンス
 Windows SharePoint Services アダプターの式
 サポートされている Windows SharePoint Services 列の型