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