テンプレート (アプリケーションのデプロイ サンプル)

このトピックでは、アプリケーションのデプロイにテンプレート サンプルを使用する方法について説明します。

BizTalk アプリケーションの展開をカスタマイズするには、事前処理スクリプトと後処理スクリプトという 2 種類の展開スクリプトを作成して使用できます。 前処理スクリプトは、アプリケーションのインストールとインポートが開始される前とアンインストールが完了した後に呼び出されます。 後処理スクリプトは、アプリケーションのインストールとインポートの完了後、およびアンインストールが開始される前に呼び出されます。

これらの各操作に対して呼び出されるように、前処理スクリプトと後処理スクリプトを記述できます。 または、スクリプトの 1 つ後にのみ実行するようにスクリプトを構成することもできます。 スクリプトの記述の詳細については、「 前処理スクリプトと後処理スクリプトを使用してアプリケーションの配置をカスタマイズする」を参照してください。

このトピックでは、1 つの操作の前または後に呼び出されるようにスクリプトを記述してデプロイする方法について説明します。 これを行うには、3 つの環境変数の値をチェックして、呼び出されるコンテキストで操作を決定するスクリプトを記述します。 このコンテキストに基づいて、スクリプトは実行を続行または中止します。

このトピックでは、次の手順を実行する方法について説明します。

  1. スクリプト操作のログ ファイルを生成できるように、ログ ファイルの場所を設定します。

    注

    ベスト プラクティスとして、スクリプト操作を確認し、問題のトラブルシューティングを行えるように、ログ ファイルを常に生成する必要があります。

  2. 新しい BizTalk アプリケーションを作成し、サンプル スクリプトを追加します。

  3. アプリケーション成果物を含む .msi ファイルをエクスポートします。

  4. BizTalk グループからアプリケーションを削除して、.msi ファイルを同じグループにインポートし直し、.msi ファイルからインストールできるようにします。

  5. アプリケーションをインポートし、ログ ファイルを調べて、インポート操作がログに記録されたことを確認します。

  6. アプリケーションをインストールし、ログ ファイルを確認して、インストール ログがログ ファイルに追加されたことを確認します。

  7. ログ ファイルを表示し、スクリプトが実行した操作と実行日時を確認します。

このサンプルが何をするか

このサンプルで提供される 2 つの .bat ファイルには、インポート、インストール、アンインストールの環境変数の値が含まれています。 SamplePreProcessing.bat には、前処理スクリプトの変数が含まれています。 SamplePostProcessing.bat 後処理スクリプトの変数が含まれています。 また、スクリプトからメッセージをログに記録する方法も示します。 これらのファイルの関連するセクションをスクリプトにコピーできます。

Important

次のように、スクリプト ファイル内のコメントの一部が正しくありません。

SamplePreProcessing.batでは、"既存のアプリケーションに対して呼び出されたスクリプトの一部を事前アンインストールする" というスクリプト コメントは、「既存のアプリケーションに対して呼び出されたスクリプトのアンインストール部分を後で実行する」と読み取る必要があります。

SamplePostProcessing.batでは、"既存のアプリケーションに対して呼び出されたスクリプトのアンインストール後の部分" というスクリプト コメントは、「既存のアプリケーションに対して呼び出されたスクリプトのアンインストール前の部分」と読み取る必要があります。

このサンプルを検索する場所

このサンプルは、次のように BizTalk Server のインストール フォルダーにあります。

<サンプル パス>\Application Deployment\Template

前述のように、サンプルには次の 2 つのファイルが含まれています。

  • SamplePreProcessing.bat（サンプルプレプロセシング・バッチファイル）

  • SamplePostProcessing.bat

このサンプルを使用する方法

サンプルを実行するには、次の手順を実行します。

ログの場所を設定するには

  • 両方のスクリプト サンプルを開き、ログ ファイルを書き込む場所を指す LogFile 変数を変更します。 ファイル名を含む完全なパスを指定する必要があります。 スペースが含まれている場合は、パスを二重引用符 (") で囲む必要があります。

    例：

    set LogFile="<サンプル パス>\ApplicationDeployment\Templates\SampleLogOut.txt"

新しいアプリケーションを作成するには

  1. [ スタート] をクリックし、[ すべてのプログラム] をクリックし、[ Microsoft BizTalk Server 20xx] をクリックして、[ BizTalk Server 管理] をクリックします。

  2. コンソール ツリーで、BizTalk Server 管理を展開し、BizTalk グループを展開します。

  3. [ アプリケーション ] を右クリックし、[ 新規] をクリックします。

  4. [ アプリケーション名] に「 SamplesTemplate」と入力し、[ OK] をクリックします。

スクリプトをアプリケーションに追加するには

  1. 先ほど作成した SamplesTemplate アプリケーションのフォルダーを展開し、左側のウィンドウで [ リソース ] を右クリックします。

  2. [ 追加 ] をポイントし、[ スクリプトの前処理] をクリックします。

  3. [ 追加] をクリックし、SamplePreProcessing.batを参照します。

  4. ファイルを選択し、[ 開く] をクリックします。

  5. [ファイルの種類] で、[System.BizTalk:PreprocessingScript] をクリックし、[OK] をクリックします。

    SamplePreProcessing.bat がアプリケーションに追加され、アプリケーションの Resources フォルダーに表示されます。

  6. もう一度 [リソース] を右クリックし、[ 追加] をポイントして、[ スクリプトの後処理] をクリックします。

  7. [ 追加] をクリックし、SamplePostProcessing.batを参照します。

  8. ファイルを選択し、[ 開く] をクリックします。

  9. [ファイルの種類] で、[System.BizTalk:PostprocessingScript] をクリックし、[OK] をクリックします。

    SamplePostProcessing.bat がアプリケーションに追加され、アプリケーションの Resources フォルダーに表示されます。

.msi ファイルをエクスポートするには

  1. BizTalk Server 管理コンソールで、SamplesTemplate アプリケーションを右クリックし、[ エクスポート] をポイントして、[ MSI ファイル] をクリックします。

  2. [エクスポート ウィザードへようこそ] ページで、[ 次へ] をクリックします。

  3. [リソースの選択] ページで、[ 次へ] をクリックします。

  4. [IIS ホストの指定] ページで、[ 次へ] をクリックします。

  5. [依存関係] ページで、[ 次へ] をクリックします。

  6. [宛先] ページの [ 宛先アプリケーション名] に、アプリケーション名を入力します。

  7. 生成する MSI ファイルで、MSI ファイルの完全なパスを入力し、[エクスポート] をクリックします。 例: C:\MSI\SamplesTemplate.msi

  8. [概要] ページで [完了]をクリックします。

アプリケーションを削除する

  • BizTalk Server 管理コンソールで SamplesTemplate アプリケーションを右クリックし、[削除] をクリック します。

.msi ファイルをインポートするには

  1. BizTalk Server 管理コンソールで、[ アプリケーション] を右クリックし、[ インポート] をポイントして、[ MSI ファイル] をクリックします。

  2. [インポート ウィザードへようこそ] ページで、 インポートする MSI ファイルに、以前にエクスポートした .msi ファイルのパスを入力し、[ 次へ] をクリックします。 必要に応じて、 (....) ボタンをクリックして MSI ファイルを参照できます。

  3. [アプリケーションの設定] ページの [ アプリケーション名 ] ドロップダウン リストで、アプリケーション名を選択します。

  4. [参照を追加できるアプリケーション] で、参照を追加するアプリケーション (存在する場合) を選択し、[次へ] をクリックします。

  5. [アプリケーション ターゲット環境設定] ページで、[ 次へ] をクリックします。

    注

    このサンプルの目的でターゲット環境を指定する必要はありません。 この機能の背景情報については、「 バインド ファイルとアプリケーションの展開」を参照してください。 バインド ファイルを追加する手順については、「 アプリケーションにバインド ファイルを追加する方法」を参照してください。

  6. [概要のインポート] ページで、概要情報が正しいことを確認し、[ インポート] をクリックします。

  7. [結果] ページで、[ 完了] をクリックします。

  8. スクリプトの実行時に作成されたログ ファイルを開き、インポート操作がログに記録されたことを確認します。

アプリケーションをインストールするには

  1. .msi ファイルをダブルクリックし、インストール ウィザードを実行します。

  2. ログ ファイルを開き、インストール操作がログ情報に追加されたことを確認します。

スクリプトが正しく機能していることを確認するには

  • ログ ファイルを開き、指定した操作中に実行されたことを確認します。

こちらもご覧ください

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

  • 最終更新: