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

[アーティクル]
07/21/2023

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

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

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

このトピックでは、1 つの操作の前または後にのみ呼び出されるようスクリプトを記述して展開する方法について説明します。 3 つの環境変数の値をチェックして、自身が呼び出されるコンテキストの操作を判断するスクリプトを記述します。そのコンテキストに基づいて、スクリプトは実行を継続または停止します。

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

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

Note

ベストプラクティスとして、スクリプトの操作の検証および問題のトラブルシューティングを行うことができるようにログファイルを常に生成することをお勧めします。
新しい BizTalk アプリケーションを作成し、サンプルスクリプトを追加します。
アプリケーションのアイテムを含む .msi ファイルをエクスポートします。
.msi ファイルを同じグループにインポートして .msi ファイルからアプリケーションをインストールできるように、BizTalk グループからアプリケーションを削除します。
アプリケーションをインポートし、ログファイルをチェックしてインポート操作が記録されていることを確認します。
アプリケーションをインストールし、ログファイルをチェックしてインストールログがログファイルに追加されていることを確認します。
ログファイルを表示して、スクリプトによって実行された操作および操作がいつ実行されたかを確認します。

このサンプルの処理

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

重要

スクリプトファイル内のコメントには間違っているものがあります。次に例を示します。

SamplePreProcessing.bat の "既存のアプリケーションのアンインストール前に呼び出されるスクリプトの部分 (Pre uninstall part of the script called for an existing application)" というコメントは、"既存のアプリケーションのアンインストール後に呼び出されるスクリプトの部分 (Post uninstall part of the script called for an existing application)" の誤りです。

SamplePostProcessing.bat の "既存のアプリケーションのアンインストール後に呼び出されるスクリプトの部分 (Post uninstall part of the script called for an existing application)" というコメントは、"既存のアプリケーションのアンインストール前に呼び出されるスクリプトの部分 (Pre uninstall part of the script called for an existing application)" の誤りです。

このサンプルの場所

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

<サンプルパス>\アプリケーション展開\テンプレート

前に説明したように、サンプルには以下の 2 つのファイルが含まれています。

SamplePreProcessing.bat
SamplePostProcessing.bat

このサンプルの使用方法

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

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

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

例:

set LogFile="<Samples Path>\ApplicationDeployment\Templates\SampleLogOut.txt"

新しいアプリケーションの作成

[スタート]、[すべてのプログラム]、[Microsoft BizTalk Server 20xx] の順にクリックし、[BizTalk Server管理] をクリックします。
コンソールツリーで [BizTalk Server 管理] を展開し、BizTalk グループを展開します。
[ アプリケーション ] を右クリックし、[ 新規] をクリックします。
[ アプリケーション名] に「」と入力 SamplesTemplateし、[OK] をクリック します。

アプリケーションへのスクリプトの追加

先ほど作成した SamplesTemplate アプリケーションのフォルダーを展開し、左側のウィンドウで [ リソース ] を右クリックします。
[ 追加] をポイントし、[ スクリプトの前処理] をクリックします。
[ 追加] をクリックし、SamplePreProcessing.bat を参照します。
ファイルを選択し、 [開く] をクリックします。
[ ファイルの種類] で[ System.BizTalk:PreprocessingScript] をクリックし、[OK] をクリック します。

SamplePreProcessing.bat が追加されて、アプリケーションのリソースフォルダーに表示されます。
もう一度 [リソース] を右クリックし、[ 追加] をポイントして、[ スクリプトの処理後] をクリックします。
[ 追加] をクリックし、SamplePostProcessing.bat を参照します。
ファイルを選択し、 [開く] をクリックします。
[ ファイルの種類] で、[ System.BizTalk:PostprocessingScript] をクリックし、[OK] をクリック します。

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

.msi ファイルのエクスポート

BizTalk Server管理コンソールで、SamplesTemplate アプリケーションを右クリックし、[エクスポート] をポイントして、[MSI ファイル] をクリックします。
[エクスポートウィザードへようこそ] ページで、[ 次へ] をクリックします。
[リソースの選択] ページで、[ 次へ] をクリックします。
[IIS ホストの指定] ページで、[ 次へ] をクリックします。
[依存関係] ページで、[ 次へ] をクリックします。
[宛先] ページの [ 宛先アプリケーション名] に、アプリケーション名を入力します。
生成する MSI ファイルに MSI ファイルの完全なパスを入力し、[エクスポート] をクリックします。例: C:\MSI\SamplesTemplate.msi
[概要] ページで [完了]をクリックします。

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

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

.msi ファイルのインポート

BizTalk Server管理コンソールで、[アプリケーション] を右クリックし、[インポート] をポイントして、[MSI ファイル] をクリックします。
[インポートウィザードへようこそ] ページの [ インポートする MSI ファイル] に、以前にエクスポートした .msi ファイルのパスを入力し、[ 次へ] をクリックします。必要に応じて、 (....) ボタンをクリックして MSI ファイルを参照できます。
[アプリケーションの設定] ページの [ アプリケーション名 ] ドロップダウンリストで、アプリケーション名を選択します。
[ 参照を追加できるアプリケーション] で、参照を追加するアプリケーション (存在する場合) を選択し、[ 次へ] をクリックします。
[アプリケーションターゲットの環境設定] ページで、[ 次へ] をクリックします。

Note

このサンプルではターゲット環境を指定する必要はありません。この機能の背景情報については、「バインドファイルとアプリケーションの展開」を参照してください。バインドファイルを追加する手順については、「アプリケーションにバインドファイルを追加する方法」を参照してください。
[インポートの概要] ページで、概要情報が正しいことを確認し、[ インポート] をクリックします。
[結果] ページで、[ 完了] をクリックします。
スクリプトの実行時に作成されたログファイルを開き、インポート操作が記録されていることを確認します。

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

.msi ファイルをダブルクリックし、インストールウィザードを実行します。
ログファイルを開き、ログ情報にインストール操作が追加されていることを確認します。

スクリプトが正常に機能したことの確認

ログファイルを開き、指定した操作でスクリプトが実行されたことを確認します。

参照

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

次の方法で共有