Visual Studio から BizTalk アセンブリを展開する方法
このトピックでは、Visual Studio ソリューション エクスプローラーまたは Visual Studio コマンド プロンプトを使用して、Visual Studio から BizTalk アプリケーションに BizTalk アセンブリを展開する手順について説明します。 プロジェクト レベルから 1 つのアセンブリを展開する方法 (手順は、プロジェクトを右クリックして [配置] をクリックするなど) と、ソリューション レベルからすべてのアセンブリをソリューションで展開する方法 (ソリューションを右クリックして [配置] をクリックするなど) を利用できますが、ソリューション レベルからすべてのアセンブリを一度に展開する方法を強くお勧めします。
BizTalk Server の以前のバージョンでは、複数のアセンブリをソリューションで展開する場合、いずれかのアセンブリに他のアセンブリとの依存関係があると、これらのアセンブリを依存関係と逆の順序で個別に展開する必要がありました。 たとえば、Assembly1 が Assembly2 に依存していた場合、最初に Assembly2 を展開しないと、Assembly1 は展開できませんでした。
プロジェクト レベルからアセンブリを展開する場合、このことは変わりません。 ただし、BizTalk Serverでは、プロジェクト レベルではなくソリューション レベルからアセンブリを展開すると、アセンブリの配置を含め、すべての配置手順が自動的に処理BizTalk Server。 したがって、展開するアセンブリに他のアセンブリとの依存関係がある場合、展開を簡略化するには、ソリューション レベルでアセンブリを展開してください。
Visual Studio 内からプロジェクトまたはソリューションを展開するオプションを選択すると、1 つのまたは複数のアセンブリが自動的にビルドされ、ローカルの BizTalk グループ内の指定した BizTalk アプリケーションに展開されます。 アプリケーションがグループ内に存在しない場合は、展開によってアプリケーションの作成も行われます。 アセンブリとアセンブリに含まれるアイテムは登録され、それらのデータは BizTalk グループの BizTalk 管理 (構成) データベースに格納されます。 また、プロジェクトの展開のプロパティでこのオプションを指定した場合、アセンブリはグローバル アセンブリ キャッシュ (GAC) に追加されます。
"アイテム" とは、BizTalk アプリケーション内に存在するあらゆる項目のことです。これには、アセンブリ、オーケストレーションなど、Visual Studio で使用するリソースだけでなく、送信ポート、受信ポート、証明書、スクリプトなど、アプリケーションの展開後に作成または追加したその他の項目も含まれます。 アセンブリが展開されたら、BizTalk Server 管理コンソールの [アプリケーション] ノードでアセンブリのアイテムを表示および管理できるようになります。 各アプリケーションは個別のフォルダーに格納され、サブフォルダーにアプリケーション内のアイテムが表示されます。 詳細については、「BizTalk Server管理コンソールの使用」を参照してください。 アプリケーションの作成と管理の詳細については、「 BizTalk アプリケーションの展開と管理」を参照してください。
アセンブリを展開する場合、まず、次の手順を実行する必要があります。
「厳密な名前のアセンブリ キー ファイルを構成する方法」の説明に従 って、厳密な名前のアセンブリ キー ファイルを作成し、各プロジェクトに割り当てます。
「Visual Studio で配置プロパティを設定する方法」の説明に従って、プロジェクトの配置プロパティを設定します。
以前に展開したアセンブリがある場合は、プロジェクトの再展開オプションを有効にします。 再展開に関する手順とその他の重要な情報については、「 Visual Studio から BizTalk アセンブリを再展開する方法」を参照してください。
重要
ここで説明する作業は、実稼働コンピューターでは行わないでください。 開発の過程ではしばしば、Visual Studio からのアセンブリの再展開が必要になります。 再展開を可能にするため、Visual Studio では同じまたは別のアプリケーション内に存在するアイテムの展開解除、バインド解除、停止、および参加解除が行われます。 これは開発環境では必要であり適切なことですが、実稼働環境では予期しない結果や結果や好ましくない結果を引き起こす可能性があります。 また、実稼働コンピューター上の Visual Studio からアセンブリが展開される危険性を回避するために、実稼働コンピューターには Visual Studio をインストールしないことをお勧めします。
Note
.NET Framework のランタイム セキュリティ ポリシーでは、既定でネットワーク共有からアセンブリを展開できません。 ネットワーク共有からアセンブリを展開しようとして、問題が発生した場合は、.NET Frameworkセキュリティ管理者に問い合わせるか、Visual Studio 統合コレクションの 「セキュリティ ポリシー管理」を参照してください。
前提条件
このトピックの手順を実行するには、BizTalk Server の管理者グループに属するアカウントでログオンする必要があります。 [配置プロパティ] で、アセンブリをグローバル アセンブリ キャッシュ (GAC) にインストールするオプションを有効にしている場合は、GAC に対する読み取り/書き込みアクセス許可も必要です。 ローカル コンピューターの管理者アカウントには、このアクセス許可があります。 アクセス許可の詳細については、「 BizTalk アプリケーションの展開と管理に必要なアクセス許可」を参照してください。
1 つまたは複数の BizTalk アセンブリを展開するには
Visual Studio ソリューション エクスプローラーを使用する場合
Visual Studio ソリューション エクスプローラーで、BizTalk プロジェクトまたはソリューションを右クリックし、[配置] をクリックします。
プロジェクトのアセンブリ、またはソリューションのアセンブリが、指定した BizTalk アプリケーションに展開されます。 ページの左下隅に、ビルドおよび展開プロセスの状態が表示されます。
Visual Studio コマンド プロンプトを使用する場合
Visual Studio コマンド プロンプトを起動します。
次の表で説明するように、適切な値に置き換え、次のコマンドを入力します。
devenv /deploySolnConfigNameSolutionName [/projectProjName] [/projectconfigProjConfigName]
例:
devenv /deploy Release "C:\Documents and Settings\someuser\My Documents\Visual Studio\Projects\MySolution\MySolution.sln" /project "MyBizTalkApp\MyBizTalkApp.csproj" projectconfig Release
パラメーター 値 /展開 ビルドまたはリビルド後にソリューションを配置します。 SolnConfigName SolutionName で指定したソリューションのビルドに使用されるソリューション構成の名前です。 SolutionName ソリューション ファイルの完全パスと名前です。 /projectProjName ソリューション内のプロジェクト ファイルのパスと名前です。 SolutionName フォルダーからプロジェクト ファイルまでの相対パス、プロジェクトの表示名、またはプロジェクト ファイルの完全パスと名前を入力できます。 /projectconfigProjConfigName プロジェクトをビルドするときに使用される、プロジェクトのビルド構成の名前です。 オーケストレーションを含むアセンブリを初めて展開すると、オーケストレーションがバインド ファイルに含まれていないことを通知する警告メッセージが表示されることがあります。 これは、展開時にオーケストレーションがホストに自動的にバインドされないためです。 この手順は手動で行う必要があります。