次の方法で共有

CreateApp (アプリケーションの展開サンプル)

  • [アーティクル]

このトピックでは、CreateApp サンプルの使用方法について説明し、BTSTask コマンド ライン ツールを使用して BizTalk アプリケーションを展開および展開解除する方法を示します。 このサンプルに含まれるスクリプトを使用して夜間のビルド プロセスを自動化し、BizTalk アプリケーションを展開および展開解除できます。

重要

サイレント モードで実行する展開スクリプトを必ず記述します。 記述しないと、ユーザー入力を必要とするダイアログ ボックスが表示されます。 ダイアログ ボックスが手動で閉じられるまで展開プロセスが停止され、インポート プロセスが中断されます。

このサンプルの処理

このサンプルには、アプリケーション展開タスクを自動化するスクリプトが含まれています。 これらのタスクを実行するには、BizTalk プロジェクトおよびファイルを生成するスクリプトを実行します。 次に、2 つの BizTalk アプリケーションの .msi ファイルを生成するスクリプトを実行します。これらのファイルは、アプリケーションのすべてのアイテムを含んでいるファイルと、アプリケーションの 1 つのアセンブリのみを含んでいるファイルです。 その後、.msi ファイルを使用してアプリケーションを BizTalk グループにインポートするスクリプトを実行し、アプリケーションをローカル コンピュータにインストールします。 インストール中に、アプリケーションに含まれる前処理スクリプトによって、アプリケーションで使用されるフォルダーが作成され、そのアクションがファイルに記録されます。 最後に、アプリケーションを削除およびアンインストールするスクリプトを実行します。 アンインストール中に、アプリケーションに含まれる前処理スクリプトによって、インストール時に作成されたファイルとフォルダーが削除され、そのアクションがファイルに記録されます。

このサンプルに含まれるスクリプトは次のとおりです。

  • Build.bat。 キー ファイルを生成し、Visual Studio 内にプロジェクトをビルドし、.dll ファイルに署名します。

  • CreateFullAndPartialMSI.bat。 以下の処理を順番に実行します。

    1. BTSTask AddApp コマンド を使用してアプリケーションを作成します。

    2. BTSTask AddResource コマンド を使用して、アプリケーション 3 つの BizTalk アセンブリと、Build.bat によって生成されたその他のリソースに追加します。

    3. BTSTask ExportApp コマンド を使用して、アプリケーションの成果物を CreateApplicationSample.msi という名前の .msi ファイルにエクスポートします。

    4. BTSTask ListApp コマンド を使用して、AppManifest.xml という名前のアプリケーション マニフェストを生成します。このマニフェストには、アプリケーションに含まれるすべての成果物が一覧表示されます。

    5. BTSTask ExportApp コマンド を使用して、オーケストレーション アセンブリのみを CreateApplicationSamplePartial.msi という名前の .msi ファイルにエクスポートします。 これは、ResourceSpec パラメーターに ResourceSpecPartial.xml を指定することによって行われます。 ResouceSpecPartial.xml は、このサンプルに含まれている ResourceSpecComplete.xml の編集されたバージョンです。 このファイルは、オーケストレーション アセンブリのみの参照が含まれるように編集されています。 このパラメーターがある場合、BTSTask は ResourceSpecPartial.xml ファイル (この場合はオーケストレーション アセンブリ) にリストされているアイテムのみをエクスポートします。

    6. グループの BizTalk 管理データベースからアプリケーションを削除します。

  • CreateNewAppFromMSI.bat。 CreateFullAndPartialMSI.bat によって生成された CreateApplicationSample.msi を使用して、ローカル コンピュータに CreateApplicationSample という名前のアプリケーションをインストールすると共に、BizTalk グループにアプリケーションをインポートします。 インストール中、PreProcScript.bat は、後で説明するように自動的に実行されます。

  • RemoveApp.bat。 以下の処理を順番に実行します。

    1. BTSTask RemoveApp コマンド を使用して、グループの BizTalk 管理データベースから CreateApplicationSample アプリケーションを削除します。

    2. BTSTask UninstallApp コマンド を使用して、ローカル コンピューターから CreateApplicationSample アプリケーションをアンインストールします。 インストール中は、後で説明するように PreProcScript.bat が自動的に実行されます。

  • PreProcScript.bat。 次の処理を実行します。

    • 実行のたびに、ユーザーに提供されたアセンブリの公開キー トークンを設定します。

    • アプリケーションのインストール中、CreateApplicationSample アプリケーションがメッセージを格納するために使用する次のフォルダを作成します。

      C:\CreateApplicationSample\Out

      C:\CreateApplicationSample\In

    • アプリケーションのアンインストール中、インストール中に作成されたファイルおよびフォルダを削除します。 インストール中にグローバル アセンブリ キャッシュ (GAC) にインストールされたアセンブリをアンインストールし、ファイルにアクションのログを記録します。 GAC からアセンブリをアンインストールするために、ユーザーが提供した公開キー トークンを参照します。

    • インストールおよびアンインストール中、次の場所にログ ファイルを作成します。

      C:\ScriptLog.txt

このサンプルの場所

サンプル ファイルは、サンプル パス>\アプリケーション展開\ の下の<次のフォルダーにあります。

  • CreateApp (フォルダ)

    • Build.bat

    • CreateFullAndPartialMSI.bat

    • CreateNewAppFromMSI.bat

    • RemoveApp.bat

  • CreateApp\Bindings (フォルダ)

    • CreateApplicationSampleBindings.xml

  • CreateApp\Dlls (フォルダ)

    • Empty

  • CreateApp\ResourceSpecs (フォルダ)

    • ResourceSpecPartial.xml

    • ResourceSpecComplete.xml

  • CreateApp\Scripts (フォルダ)

    • PreProcScript.bat

  • CreateApp\HelloApplicationDeployment (フォルダ)

    • HelloApplicationDeployment.suo

    • HelloApplicationDeployment.sln

  • CreateApp\HelloApplicationDeployment\Maps (フォルダ)

    • POToInvoice.btm

    • Maps.btproj

  • CreateApp\HelloApplicationDeployment\Orchestrations (フォルダ)

    • Orchestrations.btproj

    • HelloOrchestration.odx

  • CreateApp\HelloApplicationDeployment\Schemas (フォルダ)

    • Schemas.btproj

    • POSchema.xsd

    • InvoiceSchema.xsd

このサンプルの使用方法

次の手順に従って、このサンプルを使用します。

サンプルを使用するには

  1. Build.bat を実行します。 これにより、キー ファイルの生成、HelloApplicationDeployment フォルダでのプロジェクトのビルド、結果の .dll ファイルの署名、Dlls フォルダへの .dll ファイルの配置が行われます。

  2. CreateApp\Scripts フォルダにある PreProcScript.bat ファイルを開きます。 次のコードで、REM を削除し、アセンブリの公開キー トークンを入力します。

    REM set PublicKeyToken=

    例:

    set PublicKeyToken=1234a5b6c1234567

  3. CreateFullAndPartialMSI.bat を実行します。 これにより、CreateApplicationSample.msi と CreateApplicationSamplePartial.msi の 2 つのアプリケーション .msi ファイルが作成されます。

  4. CreateNewAppFromMSI.bat を実行します。 これにより、CreateApplicationSample アプリケーションが BizTalk グループにインポートされ、ローカル コンピュータにインストールされます。

  5. C:\ScriptLog.txt にあるスクリプト ログ ファイルをチェックし、スクリプトによってインストール アクションのログが記録されたかどうかを確認します。

  6. CreateApplicationSample アプリケーションが BizTalk Server 管理コンソールおよび [アプリケーションの追加と削除] に表示されているかどうかを確認します。

  7. RemoveApp.bat を実行します。 これにより、CreateApplicationSample が BizTalk 管理データベースから削除され、ローカル コンピュータからアンインストールされます。

  8. C:\ScriptLog.txt にあるスクリプト ログ ファイルをチェックし、スクリプトによってアンインストール アクションのログが記録されたかどうかを確認します。 このログは、インストール中に記録されたインストール アクションの後に表示されます。

  9. CreateApplicationSample アプリケーションが BizTalk Server 管理コンソールおよび [アプリケーションの追加と削除] に表示されていないことを確認します。

  10. インストール中に作成されたフォルダが削除されているかどうかを確認します。

  11. アセンブリが GAC からアンインストールされているかどうかを確認します。

参照

アプリケーションの展開 (BizTalk Server Samples フォルダー)
BizTalk アプリケーションの展開