BizTalk Web サービス発行ウィザードを使用してオーケストレーションを Web サービスとして発行する方法
BizTalk Web サービス公開ウィザードを使用して、オーケストレーションを Web サービスとして公開することができます。
Note
BizTalk Web サービス発行ウィザードを実行する前に、BizTalk プロジェクトをビルドする必要があります。
Note
コマンド ライン ツール BTSWebSvcPub.exe を使用して、オーケストレーションを Web サービスとして公開できます。 詳細については、「 BTSWebSvcPub Command-Line リファレンス」を参照してください。
オーケストレーションを Web サービスとして公開するには
[スタート] ボタンをクリックし、[すべてのプログラム] をポイントし、[Microsoft BizTalk Server] をポイントして、[BizTalk Web サービス発行ウィザード] をクリックします。
[ BizTalk Web サービス発行ウィザードへようこそ ] ページで、[ 次へ] をクリックします。
[ Web サービスの作成 ] ページで、[ BizTalk オーケストレーションを Web サービスとして発行する] を選択し、[ 次へ] をクリックします。
[ BizTalk アセンブリ ] ページの [BizTalk アセンブリ ファイル (*.dll)] テキスト ボックスに BizTalk アセンブリ ファイルの名前を入力するか、[ 参照 ] をクリックして発行するオーケストレーションを含むアセンブリを参照し、[ 次へ] をクリックします。
Note
BizTalk アセンブリ ファイルを選択する前に、すべての依存アセンブリを BizTalk アセンブリと同じフォルダーにコピーするか、依存アセンブリをグローバル アセンブリ キャッシュ (GAC) にインストールします。
Note
BizTalk アセンブリ ファイルを GAC にインストールした場合は、[ BizTalk アセンブリ] ダイアログ ボックスで選択するアセンブリで GAC 内のアセンブリが更新されていることを確認します。 GAC の完全修飾名が同じである場合、BizTalk Web サービス公開ウィザードでは、選択したアセンブリ ファイルではなく、GAC 内のアセンブリ ファイルが使用されます。
Note
オーケストレーションを含む Visual Studio で BizTalk Web サービス公開ウィザードを開くと、BizTalk アセンブリ ファイルが、オーケストレーションを含むアセンブリを使用して作成されます。
Note
260 文字を超えるパスを指定すると、パスが長すぎることを示すエラー メッセージが表示される場合があります。
[ オーケストレーションとポート] ページで、プラス記号をクリックして、各アセンブリとオーケストレーションのツリー ノードを展開します。 対応するツリー ノードのチェック ボックスをオンにして、公開するオーケストレーションとポートを選択します。 受信ポートごとに 1 つの Web サービスではなく、選択したすべての受信ポートに対して 1 つの Web サービス (.asmx) を作成する場合は、[ 選択したすべてのポートを 1 つの Web サービスにマージ する] オプションを選択し、[ 次へ] をクリックします。
Note
選択したすべてのポートを 1 つの Web サービスに結合すると、それらのポートの種類は同じで、ポートの操作名は一意になります。
[Web サービスのプロパティ] ページの [Web サービスのターゲット名前空間] ボックスに、Web サービスのターゲット名前空間を入力し、適切なボックスを選択して、ウィザードで SOAP ヘッダーを処理する方法と、Web サービスの 2007 シングル Sign-On (SSO) サポートSharePoint Portal Server指定します。 Web サービスの実装をさらにカスタマイズする場合は、[ 詳細設定 ] ボタンをクリックします。 次の詳細設定オプションが表示されます。
オプション 値 説明 SOAP パラメーターの書式 既定 SOAP メッセージ内におけるパラメーターの書式を指定します。 詳細については、 の SoapParameterStyle 列挙に関するページを https://go.microsoft.com/fwlink/?LinkId=62259参照してください。 SOAP パラメーターの書式 Bare SOAP メッセージ内におけるパラメーターの書式を指定します。 詳細については、 の SoapParameterStyle 列挙に関するページを https://go.microsoft.com/fwlink/?LinkId=62259参照してください。 SOAP パラメーターの書式 Wrapped SOAP メッセージ内におけるパラメーターの書式を指定します。 詳細については、 の SoapParameterStyle 列挙に関するページを https://go.microsoft.com/fwlink/?LinkId=62259参照してください。 適合性表示 なし バインド要求が準拠する Web サービスの相互運用性 (WSI) 仕様を指定します。 詳細については、 の WebServiceBindingAttribute.ConformsTo プロパティに関するページ https://go.microsoft.com/fwlink/?LinkId=193064を参照してください。 適合性表示 WS-I 基本プロファイル 1.1 バインド要求が準拠する Web サービスの相互運用性 (WSI) 仕様を指定します。 詳細については、 の WebServiceBindingAttribute.ConformsTo プロパティに関するページ https://go.microsoft.com/fwlink/?LinkId=193064を参照してください。 要求 - 応答を強制 [Default] 一方向の BizTalk 操作を要求 - 応答 Web メソッドとして公開するかどうかを指定します。 既定では、一方向のフラグは強制されません。 要求 - 応答を強制 いいえ 一方向の BizTalk 操作を要求 - 応答 Web メソッドとして公開するかどうかを指定します。 既定では、一方向のフラグは強制されません。 要求 - 応答を強制 はい 一方向の BizTalk 操作を要求 - 応答 Web メソッドとして公開するかどうかを指定します。 既定では、一方向のフラグは強制されません。 [ Web サービスのプロパティ] ページで 、[ 次へ] をクリックします。
Note
選択した SOAP ヘッダー オプションは、このウィザードのインスタンスの実行中に作成されるすべての Web サービスと Web メソッドにグローバルに適用されます。
[ 追加の SOAP ヘッダーの追加] オプションを選択した場合は、[ 要求 SOAP ヘッダー] ページと [ 応答 SOAP ヘッダー] ページが表示されます。 次のダイアログ ボックスの [ 追加 ] ボタンと [削除] ボタンを使用して、要求と応答の SOAP ヘッダーを追加および 削除 できます。
SOAP ヘッダーを追加するには、[ 追加] をクリックします。 BizTalk アセンブリ ファイル (*.dll) テキスト ボックスに、SOAP ヘッダー スキーマを含むアセンブリを入力または参照します。 [使用可能なスキーマの種類] リスト ビューには、スキーマの各ルート要素が表示されます。 要求または応答の SOAP ヘッダーとして追加するルート ノードを選択します。 複数の項目を選択するには、Ctrl キーを押しながら [OK] をクリックします。
SOAP ヘッダーを一覧から削除するには、追加された SOAP ヘッダーの一覧から SOAP ヘッダーを選択し、[ 削除] をクリックします。
各 SOAP ヘッダー ページで [次へ] をクリックして、ウィザードを続行します。
Note
ターゲットの名前空間とルート要素名によって SOAP ヘッダーが定義されます。
Note
対象となる名前空間とルート要素名の同じ組み合わせを要求および応答 SOAP ヘッダーとして追加すると、受信および送信ヘッダーとして扱われません。 オーケストレーション内で受信ヘッダーを送信ヘッダーに手動でコピーする必要があります。
Note
対象となる名前空間とルート要素名の同じ組み合わせは、要求 SOAP ヘッダーとして 1 度、応答 SOAP ヘッダーとして一度だけ追加できます。
[ Web サービス プロジェクト ] ページの [ プロジェクト名 ] テキスト ボックスに、プロジェクトの名前を入力します。 既定の場所 (
http://localhost/<project_name>) をそのまま使用するか、[プロジェクトの場所] テキスト ボックスにプロジェクトの 場所 を入力するか、[ 参照 ] をクリックして Web ディレクトリを選択します。 次のいずれかのオプションをクリックします。[既存のプロジェクトに上書きする] : このオプションは、プロジェクトの場所が既に存在する場合にのみ使用できます。 このオプションを選択した場合にのみ、同じ場所に発行できます。 このオプションを選択しない場合は、別のプロジェクトの場所を入力する必要があります。
Web サービスへの匿名アクセスを許可します。 : このオプションでは、作成した仮想ディレクトリに匿名アクセスを追加します。 既定では、仮想ディレクトリは、その親仮想ディレクトリまたは Web サイト (最上位の仮想ディレクトリである場合) から、アクセス権限を継承します。
BizTalk 受信場所を作成します。 このオプションでは、生成された各 .asmx ファイルに対応する SOAP アダプターの受信ポートと受信場所が自動的に作成されます。 受信場所が既に存在する場合、既存の受信場所は置き換えられません。 SOAP アダプターの受信場所は、/<virtual directory name>/<orchestration namespace_typename_portname.asmx> という形式で解決されます。 このオプションの選択後、受信ポートと場所を生成するアプリケーションを選択します。
Note
プロジェクトの場所には、別のサーバーを指定することもできます。 Web サービスを別のサーバーに発行するには、プロジェクト名を として
http://<servername>/<project_name>入力します。Note
プロジェクトの場所には、既定以外の Web サイトを指定することもできます。 既定以外の Web サイトに公開する場合は、URL に Web サイトのポート番号を含めます。 たとえば、「
http://localhost:8080/<project_name>」のように入力します。Note
ウィザードを使用して受信場所を作成する場合は、既定値を使用して受信場所が作成されます。 受信パイプラインの既定値は、 Microsoft.BizTalk.DefaultPipelines.PassThruReceive パイプラインです 。 発行された Web サービスを介して受信したメッセージに特別なパイプライン処理 (検証、関連付け/プロパティの昇格、受信/送信マップなど) が必要な場合は、受信パイプラインを Microsoft.BizTalk.DefaultPipelines.XMLReceive またはカスタム パイプラインに設定する必要があります。
Note
オーケストレーションから Web サービスを使用する (呼び出す) 場合、SOAP アダプタはパススルー スタイルの送信パイプラインのみをサポートします。 カスタム送信パイプラインを使用できますが、メッセージのボディ部を変更するコンポーネントを含めることはできません。 これらのコンポーネントには、XML アセンブラーとエンコード コンポーネントが含まれます。
Note
このページに移動し、[ Web サービスとしてスキーマを発行 する] オプションを選択しない場合は、[ Web サービス ] ページに、 前 に選択した BizTalk アセンブリのサービス名とメソッド名が表示され、その前に [ BizTalk オーケストレーションを Web サービスとして発行 ] オプションから戻ります。 これは、公開方法が変更されても、メモリ内の Web サービスの説明はクリアされないためです。
[ 次へ ] をクリックして、ASP.NET Web サービス プロジェクトの設定を確認します。
[ 作成 ] をクリックして、ASP.NET Web サービスを作成します。
[ 完了] をクリックして、BizTalk Web サービス発行ウィザードを完了します。
Note
オーケストレーションを Windows Vista で Web サービスとして公開している場合、サービスをホストする仮想ディレクトリを更新する必要があります。 これを行うには、コマンド プロンプトから次のコマンドを発行し、vdir> を仮想ディレクトリの名前に置き換えます<: %systemroot%\system32\inetsrv\APPCMD.EXE migrate config "Default Web Site/<vdir name>"。
参照
Web サービスとしてのオーケストレーションの発行 オーケストレーションを Web サービスにマップする方法