このトピックでは、静的送信ポートと動的送信ポートを比較し、Windows SharePoint Services 送信ポートを作成する手順も示します。 具体的には:
静的送信ポートと動的送信ポート
静的送信ポート | 動的送信ポート | |
---|---|---|
異なるアダプターで 1 つの送信ポートを使用します。 | いいえ 静的送信ポートを作成するときは、トランスポートの種類が必要です。 |
イエス 通常、動的送信ポートはオーケストレーションに追加されます。 トランスポートの種類は、オーケストレーション ロジックで構成されます。 |
URL など、送信ポートのプロパティが異なる 1 つの送信ポートを使用します。 | いいえ 静的送信ポートを作成する場合は、URL などの一部のアダプター プロパティを構成する必要があります。 |
イエス 通常、動的送信ポートはオーケストレーションに追加されます。 プロパティはオーケストレーション ロジックで構成されます。 |
既定の送信ハンドラーを使用する必要があります。 | いいえ 送信ハンドラーは、送信ポートを作成するときに構成できます。 |
いいえ 送信ハンドラーは、送信ポートを作成するときに構成できます。 |
メッセージの移動先がわからない場合に使用します。 | いいえ 静的送信ポートを作成するときは、トランスポートの種類と終了場所を指定します。 |
イエス 終了場所は、オーケストレーションとコンテンツ ベースのルーティング シナリオで構成できます。 ルールを使用して、メッセージが送信される場所をフィルター処理することもできます。 |
1 つの送信ポートを使用して、複数のパートナーにメッセージを送信します。 | いいえ 静的送信ポートを作成するときは、トランスポートの種類と終了場所を指定します。 |
イエス 通常、動的送信ポートはオーケストレーションに追加されます。 プロパティはオーケストレーション ロジックで構成され、指定したルールに基づいて、複数のパートナーにメッセージを送信できます。 |
静的送信ポートを作成する
静的送信ポートを作成する場合、送信ポートはトランスポートの種類に関連付けられている既定の送信ハンドラーを使用します。 Windows SharePoint Services アダプターを使用する場合、既定の送信ハンドラーは BizTalkServerApplication です。 新しい送信ハンドラーを追加する手順については、「アダプター ハンドラー を作成する方法」を参照してください。
静的送信ポートを作成します。
BizTalk Server 管理コンソールで、BizTalk グループ [GroupName] を展開し、[アプリケーション] を展開し、送信ポートを含むアプリケーションを展開します。
[ 送信ポート] を右クリックし、[ 新規] をクリックし、[ 静的一方向送信ポート] をクリックします。
Von Bedeutung
静的 Solicit-Response 送信ポートは、Windows SharePoint Services アダプターでは構成できません。
[プロパティ] で、[種類] ドロップダウン リストの [Windows SharePoint Services] をクリックします。 Name プロパティ、Send Handler プロパティ、および Send Pipeline プロパティを入力します。
[構成] をクリックします。 [プロパティ] で、次を構成します。
プロパティ 説明 アダプター Web サービス ポート 必須。 SharePoint Services アダプター Web サービスをホストする IIS Web サイトで構成されたポート。
既定値は、標準の HTTP ポートであるポート 80 です。 80 以外のポートが使用されている場合は、この値を更新します。時間切れ 必須。 ミリ秒単位で、この値は、アダプターが Web サービスから応答を受信する時刻を決定します。
既定値は 100000 ミリ秒 (100 秒) です。
メッセージまたはバッチ サイズが予想より大きい場合は、この値を大きくします。
Windows SharePoint Services アダプター Web サービスに対して実行されたアダプター ランタイム Web サービス呼び出しのタイムアウト (ミリ秒単位)。 メッセージまたはバッチ サイズがアダプターで予想される平均よりも大きい場合は、この値を増やす必要があります。クライアント OM を使用する 必須。 SharePoint クライアント側オブジェクト モデル (CSOM) とサービス側オブジェクト モデル (SSOM) のどちらを使用するかを決定します。
既定値は [はい] です。 BizTalk Server で SharePoint CSOM を使用するには、[ はい ] に設定します。 SharePoint Services コンピューターには要件はありません。
SharePoint Services コンピューターにインストールされている Web サービスを含む SharePoint SSOM を使用するには、[ いいえ ] に設定します。
付録 B: Microsoft SharePoint アダプターをインストールすると、SharePoint Services アダプター で使用される SSOM および CSOM コンポーネントに関する特定の情報が提供されます。宛先フォルダーの URL 必須。 ドキュメントを格納する SharePoint Services フォルダーの URL。 SharePoint サイトへの相対パスを入力します。 たとえば、 共有ドキュメント や 共有ドキュメント/発注書/などです。 リストは宛先として使用することもできます。 たとえば、 リスト/タスクです。 リストを指定した場合、メッセージ本文はリスト アイテムと共に保存されません。 メッセージから抽出された値は、SharePoint 列に昇格されます。 手記: SharePoint ドキュメント ライブラリまたはフォルダー URL は、その名前とは異なる場合があります。 Web ブラウザーのアドレスで正しい URL を確認します。 ファイル名 オプション。 SharePoint Services ファイル名を入力します。
PurchaseOrder0001.xml や式などのファイル名を入力します。 式には、リテラル、マクロ、XPATH クエリの任意の組み合わせが含まれます。 たとえば、「 PurchOrd-%XPATH=//po:PurchaseOrderId%-%MessageID%.xml」と入力します。 ファイル名が指定されていない場合は、元のファイルのファイル名、オーケストレーションによって指定された値、または 'Msg-%MessageID%.xml' が使用されます。 詳細については、Windows SharePoint Services アダプターの式を参照してください。 手記: リストにメッセージを送信する場合、このファイル名の値は無視され、SharePoint 列には保存されません。 代わりに、使用可能な 16 列のいずれかを使用して 、"Title" 列を更新します。 SharePoint リストにはファイル名列がありません。名前空間のエイリアス オプション。 名前空間エイリアス定義のコンマまたはセミコロンで区切られたリスト。
このフィールドを使用して、'Filename' や 'Column Value' などのフィールドで導入された XPATH クエリで使用される名前空間エイリアスを定義します。 たとえば、「 po='http://OrderProcess/POrder'
,conf='http://OrderProcess/Confirmation'
xmlns=";ipsol='{D8217CF1-4EF7-4bb5-A30D-765ECB09E0D9}'」と入力します。 注意: このプロパティは、オーケストレーションによって定義された ConfigNamespacesAliases メッセージ コンテキスト プロパティをオーバーライドしません。 代わりに、2 つの値がマージされます。上書き 必須。 ファイルが存在する場合は、このファイルが上書きされるかどうかを判断します。
既定値は [いいえ] です。 オプションは次のとおりです。
- いいえ: 同じ名前のファイルが存在する場合は、エラーを発生させ、メッセージを中断します。
- オーケストレーション: 同じ名前のファイルが存在する場合に、オーケストレーションで定義されている値を使用します。
- 名前の変更: 同じ名前のファイルが存在する場合は、新しいファイルの名前を変更します。
- はい: 同じ名前の既存のファイルを上書きします。
[はい] に設定すると、同じ名前の多数のメッセージを送信すると、SharePoint イベント ビューアー エラーが発生する可能性があります。 これらのエラーはアダプターに影響を与えず、失敗したメッセージは再試行されます。SharePoint サイトの URL 必須。 SharePoint Services Web サイトの完全な URL。 たとえば、Http:// SharePointServer/sites/TestSite などです。 手記: 送信ポートまたは受信場所の URI は 256 文字を超えることはできません。 Microsoft Office 統合 必須。 バイナリ メッセージの場合は、 No または Optional を使用する必要があります。
既定値は オプションです。 オプションは次のとおりです。
- いいえ: 文書を as-is保存します。 バイナリ メッセージの場合、このオプションを使用できます。
- 省略可能: InfoPath などの Office アプリケーションで自動的に開かれるようにドキュメントを変更します。 処理命令が見つからない場合、ドキュメントは as-is処理されます。 バイナリ メッセージの場合、このオプションを使用できます。
- オーケストレーション: オーケストレーションで定義されている値を使用します。
-
はい: InfoPath などの Office アプリケーションで自動的に開かれるようにドキュメントを変更します。 処理命令が見つからない場合、メッセージは中断されます。
[はい] に設定すると、次のプロパティ ペアの少なくとも 1 つが必要です。
- テンプレート ドキュメント ライブラリ と テンプレート名前空間列
- テンプレートフォールバックドキュメントライブラリ と テンプレートフォールバック名前空間列
- はい (InfoPath フォーム ライブラリ): InfoPath ソリューションがフォーム ライブラリに存在する場合、ドキュメントは変更され、InfoPath などの Office アプリケーションで自動的に開かれます。 フォーム ライブラリにソリューションがない場合、メッセージは中断されます。
テンプレート ドキュメント ライブラリ テンプレート名前空間列が設定されている場合にのみ必要です。 InfoPath ソリューションを格納する SharePoint ドキュメント ライブラリ。 たとえば、[ マイ ソリューション] などです。 アダプターは、 テンプレート ドキュメント ライブラリ で一致する InfoPath ソリューションを探します。 ソリューションが見つからない場合、アダプターは テンプレート フォールバック ドキュメント ライブラリを検索します。 手記:テンプレート ドキュメント ライブラリには、少なくとも 1 つの "1 行のテキスト" SharePoint 列が必要です。この列には、次のものが設定されています。 - InfoPath ソリューションで開かれる XML ドキュメントの名前空間とルート ノード
- または、XML ドキュメントのルート ノード
テンプレート フォールバック ドキュメント ライブラリ のみ必要なのは、テンプレート フォールバック名前空間列が入力されている場合です。 InfoPath ソリューションを格納する SharePoint ドキュメント ライブラリ。 たとえば、 テンプレートです。
テンプレート ドキュメント ライブラリにソリューションが見つからない場合、アダプターは一致する InfoPath ソリューションのテンプレート フォールバック ドキュメント ライブラリを検索します。 [テンプレート フォールバック ドキュメント ライブラリ] フィールドと [テンプレート ドキュメント ライブラリ] フィールドは、2 セットの InfoPath ソリューションで使用できます。 すべての汎用の InfoPath ソリューションと、特定のパートナーにのみ使用される特殊な InfoPath ソリューションがあります。 [テンプレート フォールバック ドキュメント ライブラリ] フィールドは汎用ソリューションを指し、テンプレート ドキュメント ライブラリは特定のパートナーの特殊なソリューションを指す必要があります。 注:テンプレート フォールバック ドキュメント ライブラリ には、少なくとも 1 つの "1 行のテキスト" SharePoint 列が必要です。この列には、次の値が設定されています。- InfoPath ソリューションで開かれる XML ドキュメントの名前空間とルート ノード
- または、XML ドキュメントのルート ノード
テンプレートフォールバック名前空間列 テンプレート フォールバック ドキュメント ライブラリが設定されているときにのみ必要です。 InfoPath ソリューションの名前空間を格納する SharePoint ドキュメント ライブラリ。 たとえば、 myNamespace です。 手記: このフィールドでは大文字と小文字が区別されます。 テンプレートの名前空間列 必要なのはテンプレート ドキュメント ライブラリが設定されている場合のみです。 InfoPath ソリューションの名前空間を格納する SharePoint テンプレート ドキュメント ライブラリ 列。 たとえば、 myNamespace です。 手記: このフィールドでは大文字と小文字が区別されます。 SharePoint Online パスワード オプション。 SharePoint Online アカウントのパスワード。 SharePoint Online ユーザー名 オプション。 SharePoint Online アカウントのユーザー名。 コラム n
オプション。 コピー先ドキュメント ライブラリに存在する SharePoint 列。 この列は、メッセージから抽出された値または [列の値 ] フィールドで指定された値で更新します。 手記: 最大 16 列を指定できます。 このフィールドでは大文字と小文字が区別されます。 列 n
値オプション。 このメッセージに設定する列の値を入力します。 "発注書" や式などのリテラル値を入力できます。 式には、リテラル、マクロ、XPATH クエリの任意の組み合わせを含めることができます。 たとえば、 "%XPATH=//po:POAmount%"、"%SendingOrchestrationID%"と入力します。 手記: 最大 16 列を指定できます。 [ OK] を クリックして設定を保存します。
その他の送信ポート構成オプションは次のとおりです。
動的送信ポートを作成する
動的送信ポートを作成する場合、送信ハンドラーはすべてのアダプターに対して構成できます。 1 つの動的送信ポートを複数のアダプターで使用できます。 動的送信ポート ハンドラーを構成する手順については、「 動的送信ポート ハンドラーは構成可能 です」を参照してください。
BizTalk Server 管理コンソールで、BizTalk グループ [GroupName] を展開し、[アプリケーション] を展開し、送信ポートを含むアプリケーションを展開します。
[送信ポート] を右クリックし、[新規] をクリックし、[動的一方向送信ポート] または [動的 Solicit-Response 送信ポート] を選択します。
[ プロパティ] に、 名前 と パイプライン のプロパティを入力します。
[構成] をクリックします。
[ 送信ハンドラーの構成] ウィンドウで、個々のアダプターの 送信ハンドラー を選択します。 既定の送信ハンドラーは BizTalkServerApplication です。 新しい送信ハンドラーを追加する手順については、「アダプター ハンドラー を作成する方法」を参照してください。
個別のホストを使用するには、次のような多くの理由があります。
32 ビット要件: 一部のアダプターには、FTP アダプターや POP3 アダプターなどの 32 ビット ホストが必要です。 すべての 32 ビット アダプターまたは個々の 32 ビット アダプターを独自のホストにグループ化できます。
目的別ホスト: 送信用のホスト、受信用のホスト、オーケストレーション処理用のホスト、追跡用のホストを作成します。
異なるホスト設定: 多くの設定がホスト レベルで実装されます。 その結果、ホストごとに異なるスロットリング設定が設定できます。 たとえば、HostA でスロットリングを無効化することができます。 HostB 内のすべてのイベントを追跡します。 HostC の .NET CLR 設定を変更します。 HostD でのメモリ使用量を増やします。
セキュリティ: セキュリティはホスト レベルで実装されます。 各ホストは、独自の Windows アカウントで実行されます。 たとえば、HostA は FILE アダプターを使用してファイル共有にアクセスします。 HostA ユーザー アカウントにファイル共有へのアクセス許可を付与します。 HostB は、IIS サーバーでホストされている Web サービスを使用します。 HostB ユーザー アカウントの承認を Web サービスに付与します。 これにより、他のホスト アカウントがアクセスする必要のないエンティティにアクセスすることもできなくなります。
個別のアダプター: たとえば、HTTP アダプターを使用して複数の成果物 (受信場所と送信ポート) があるとします。 独自のホストで HTTP アダプターに関連付けられているすべてのものが必要です。
個別のオーケストレーション: 個々のオーケストレーションを独自のホストに配置できます。 たとえば、オーケストレーションで高メモリまたは CPU 使用率が高い場合は、そのオーケストレーションを独自のホストに配置します。
BizTalk Server パフォーマンス最適化ガイド と 、BizTalk Server データベースの保守とトラブルシューティングを 行う方法に関する推奨事項を示します。
[ OK] を クリックして設定を保存します。
その他の送信ポート構成オプションは次のとおりです。
[ OK] を クリックして設定を保存します。
その他の送信ポートに関するトピック:
こちらもご覧ください
SharePoint サービス アダプターのトラブルシューティングSharePoint サービス受信場所の構成CSOM: SharePoint サービス アダプター