このトピックでは、BizTalk Server 管理コンソールまたはコマンド ラインを使用して BizTalk アプリケーションを BizTalk グループにインポートする方法について説明します。 BizTalk アプリケーションをインポートすると、BizTalk 管理データベースに成果物が登録され、成果物のデータが適切な BizTalk データベースに書き込まれます。 詳細については、「 アーティファクトがインポートされたときの動作」を参照してください。 アプリケーションをインポートしても、アプリケーションはインストールされません。 実行する前に、ファイル ベースの成果物を含むアプリケーションをインストールする必要があります。
BizTalk Server 管理コンソールを使用してアプリケーションをインポートする場合、MSI のインポート ウィザードを開始する場所によって、成果物のインポートと同時に新しいアプリケーションを作成できるかどうかが決まります。 BizTalk グループを右クリックしてウィザードを開始する場合は、アプリケーション名を指定する必要があります。 BizTalk グループ内の既存のアプリケーションに指定した名前が付いている場合、ファイル内の成果物がこのアプリケーションにインポートされます。それ以外の場合は、指定した名前の新しいアプリケーションが作成され、成果物がそれにインポートされます。 アプリケーションを右クリックしてウィザードを開始すると、アプリケーション名を指定できず、成果物が現在のアプリケーションにインポートされます。
BTSTask コマンド ライン ツールを使用して .msi ファイルをインポートする場合、アプリケーション名の指定は省略可能です。 名前を指定しない場合、その成果物は既定のアプリケーションにインポートされます。
成果物をインポートした後は、BizTalk Server 管理コンソールのアプリケーションのフォルダーの下にある適切なフォルダーでそれらを表示できます。 ListApp コマンドの説明に従って、BTSTask を使用して、アプリケーション内の成果物の一覧を表示することもできます。
[前提条件]
BizTalk アプリケーションをインポートするには、BizTalk Server Administrators グループのメンバーであるアカウントでログオンしている必要があります。 BizTalk アプリケーションをインストールするには、ローカル ファイル システムに対する書き込みアクセス許可も必要です。 アクセス許可の詳細については、「 BizTalk アプリケーションの展開と管理に必要なアクセス許可」を参照してください。
アプリケーションのインポートに関する考慮事項
アプリケーションをインポートするときに、次の考慮事項が適用される場合があります。
以前のバージョンの BizTalk Server からアプリケーションをインポートする。 BizTalk Server 2006 R2 または BizTalk Server 2009 からアプリケーションをインポートする場合、アプリケーションに EDI/AS2 パーティ データが含まれている場合、BizTalk Server で取引先管理モデルが大幅に変更されたため、アプリケーションのインポートが失敗する可能性があります。 代わりに、パーティ移行ツールを使用して、以前のバージョンの BizTalk Server からパーティー データを移行する必要があります。 ツールの詳細については、「 EDI 移行ユーティリティ」を参照してください。
既存のバインドは、インポートされたバインドによって常に上書きされます。 バインドを含む .msi ファイルを既存のアプリケーションにインポートすると、同じ名前のインポートされたバインドによって既存のバインドが上書きされます。 これは、.msi ファイルをインポートするときに既存の成果物を上書きするオプションを選択していない場合でも当てはまる場合です。 エクスポートするアプリケーション内のバインドで、.msi ファイルをインポートするアプリケーション内のバインドを上書きしたくない場合は、エクスポート操作中にエクスポートするリソースとしてバインド ファイルを選択しないでください。 詳細については、「 BizTalk アプリケーションをエクスポートする方法」を参照してください。
インポート プロセス中にバインドが適用されると、既に適用されているバインドは、同じ名前の新しいバインドによって上書きされます。 つまり、適用する特定の名前の最後のバインドが有効になります。 アプリケーションをインポートすると、バインドは次の順序で適用されます。
BizTalk Server によって生成されたアプリケーション バインド。バインド ファイルを介してアプリケーションに明示的に追加されたのではなく、アプリケーション .msi ファイルにエクスポートするためにユーザーによって明示的に選択されました。
明示的に追加され、ターゲットデプロイ環境が指定されていないバインド ファイル。 このセット内のバインドは、特定の順序で適用されません。
明示的に追加され、アプリケーションのインポート用に選択されたデプロイ環境と一致するターゲットデプロイ環境が関連付けられているバインディング。 このセット内のバインドは、特定の順序で適用されません。
ホストはグループ内に存在する必要があります。 .msi ファイルに含まれるアプリケーション バインドで指定されたホストに対応するホストが BizTalk グループに既に存在している必要があります。インポート操作は失敗します。 さらに、ホスト信頼レベルが一致する必要があります。
別のアプリケーションへの参照の追加が必要な場合があります。 インポートするアプリケーションが別のアプリケーションの成果物に依存している場合は、このアプリケーションへの参照を追加する必要があります。 アプリケーションと必要な成果物は、グループに既に存在している必要があります。 インポート ウィザードには、このオプションが用意されています。 ただし、BTSTask の ImportApp コマンドを使用している場合は、「別のアプリケーションへの参照を追加する方法」の説明に従って、インポート後 にアプリケーションへの参照を追加する必要があります。 背景情報については、「 依存関係とアプリケーションのデプロイ」を参照してください。 インポート ウィザードは、グループ内の既存のアプリケーションへの参照と一致し、新しい参照を追加したり、既存の参照を変更したりするオプションを提供します。 参照先のアプリケーションに必要な成果物が含まれていることを確認する追加の手順を実行する必要があります。
インポート操作がタイムアウトした場合は、アプリケーションを追加の .msi ファイルに分割します。 インポート操作は、期間が 3,600 秒を超えるとタイムアウトします。 .msi ファイルをインポートしようとして操作がタイムアウトした場合は、アプリケーションを再エクスポートし、エクスポートする成果物のサブセットを選択して、アプリケーションの内容を複数の .msi ファイルに分割する必要があります。 詳細については、「 BizTalk アプリケーションをエクスポートする方法」を参照してください。
Von Bedeutung
セキュリティ上の理由から、アプリケーションのエクスポート中に、パスワードはアプリケーション バインドから削除されます。 ただし、アプリケーションに追加されたバインド ファイルからは削除されません。 アプリケーションをインポートした後、アプリケーションが機能するためにはパスワードを再構成する必要があります。 これを行うには、バインド ファイルを編集するか、管理コンソールを使用します。 バインド ファイルの編集の詳細については、「バインド ファイル のカスタマイズ」を参照してください。 アダプターのセキュリティの構成の詳細については、「アダプターの 使用」を参照してください。
注
インポートが失敗した場合、BizTalk Server は、カスタム スクリプトによって実行されるアクションを除くすべてのインポート操作をロールバックします。
注
別のアプリケーションでプロパティ スキーマを使用する 1 つのアプリケーションで送信ポートのフィルターを作成した後、最初のアプリケーションを新しい BizTalk グループにインポートした場合、スキーマが見つからないという警告は表示されず、アプリケーションのインストールと開始時にフィルター処理は機能しません。 スキーマを含まないアプリケーションをインストールする前に、スキーマを含むアプリケーションをインポートすることで、問題を修正できます。
BizTalk Server 管理を使用して BizTalk アプリをインポートする
[ スタート] をクリックし、[ すべてのプログラム] をクリックし、[ Microsoft BizTalk Server 20xx] をクリックして、[ BizTalk Server 管理] をクリックします。
コンソール ツリーで、BizTalk Server 管理を展開し、BizTalk グループを展開して、次のいずれかの操作を行います。
.msi ファイルに含まれるアプリケーションと成果物を BizTalk グループにインポートするには、[ アプリケーション] を右クリックし、[ インポート] をポイントして、[ MSI ファイル] をクリックします。
.msi ファイルに含まれる成果物を既存のアプリケーションにインポートするには、[ アプリケーション] を展開し、アプリケーションを右クリックし、[ インポート] をポイントして、[ MSI ファイル] をクリックします。
[MSI のインポート ウィザードへようこそ] ページで、 インポートする MSI ファイルで、.msi ファイルのパスを入力し、[ 次へ] をクリックします。 必要に応じて、[ ... ] ボタンをクリックして .msi ファイルを参照できます。
[アプリケーションの設定] ページの [ アプリケーション名 ] ドロップダウン リストで、アプリケーション名 (使用可能な場合) を選択します。 この一覧は、アプリケーションを BizTalk グループにインポートする場合に使用できます。
注
この一覧には、BizTalk グループに現在含まれているすべてのアプリケーションの名前と、.msi ファイルのエクスポート元のアプリケーションが含まれます。 後者のアプリケーション名を選択しても、この BizTalk グループにアプリケーションがまだ存在しない場合は、インポート ウィザードによって新しいアプリケーションが作成されます。 グループに既に存在するアプリケーションを選択すると、インポート ウィザードによって、.msi ファイルから既存のアプリケーションに成果物がインポートされます。
[参照を追加できるアプリケーション] で、参照を追加するアプリケーション (存在する場合) を選択し、[次へ] をクリックします。
.msi ファイルを既存のアプリケーションにインポートし、既存のアプリケーションの成果物を上書きする場合は、[ リソースの上書き] を選択します。
注
このオプションを選択せず、.msi ファイルにアプリケーションに既に存在する成果物が含まれている場合、インポート操作は失敗し、ロールバックされます。 BizTalk アプリケーションまたはグループ内の特定の種類の成果物は一意である必要があります。 BizTalk グループに既に存在するが、現在のアプリケーションには存在しない成果物を追加する場合、上書きオプションを指定した場合でもインポート操作は失敗します。 一意である必要がある成果物と、一意にする必要がある方法の詳細については、「 アプリケーションまたはグループで一意である必要がある成果物」を参照してください。
[アプリケーション ターゲット環境設定] ページの [ ターゲット ステージング環境 ] ドロップダウン リストで、このアプリケーションのターゲット環境を選択し、[ 次へ] をクリックします。 この一覧には、このアプリケーションに追加されたすべてのバインド ファイルに対して指定されたすべての環境が含まれます。 ターゲット環境が指定されているものを除くすべてのバインドをアプリケーションに適用する場合は、 <Default> を選択します。 .msi ファイルに明示的に適用するバインド ファイルが含まれていない場合は、 <Default> を選択したままにしておくことができます。
注
バインド ファイルをアプリケーションに追加するときに、バインドのターゲット環境を指定します。 背景情報については、「 バインド ファイルとアプリケーションの展開」を参照してください。 バインド ファイルを追加する手順については、「 アプリケーションにバインド ファイルを追加する方法」を参照してください。
[概要のインポート] ページで、概要情報が正しいことを確認し、[ インポート] をクリックします。
[インポートに成功しました] ページで、ローカル コンピューターにアプリケーションをインストールする場合は、[ アプリケーション インストール ウィザードを実行してローカル コンピューターにアプリケーションをインストール する] チェック ボックスをオンにします。
注
ローカル コンピューターで現在構成されているアプリケーションを実行する必要がない限り、アプリケーションをインストールする必要はありません。 ただし、アプリケーションにファイル ベースの成果物が含まれている場合は、アプリケーションを起動する前に、アプリケーションを実行するすべてのコンピューターにアプリケーションをインストールする必要があります。これは、アプリケーションをインポートすると BizTalk 管理データベースに追加されるだけなのでです。
[完了] をクリックします。
注
たとえば、ローカル ファイル システムに対する書き込みアクセス許可がないためにインストールが失敗した場合、インストールはロールバックされますが、インポート操作は行われません。
コマンド ラインを使用して BizTalk アプリをインポートする
コマンド プロンプトを開きます。[ スタート] をクリックし、[ 実行] をクリックし、「
cmd」と入力して、[ OK] をクリックします。次の表に示すように、適切な値に置き換えて、次のコマンドを入力します。
BTSTask ImportApp /Package:value [/Environment:value] [/ApplicationName:value] [/Overwrite] [/Server:value] [/Database:value]
例：
BTSTask ImportApp /Package:"C:\MSI Files\MyApplication.msi" /Environment:Test /ApplicationName:MyApplication /Overwrite
パラメーター 価値 /パッケージ .msi ファイルの完全なパス。 パスにスペースが含まれている場合は、引用符 (") で囲む必要があります。 /環境 適用するバインド ファイルのターゲット デプロイ環境 (テストなど)。 これは、バインド ファイルがアプリケーションに追加されたときにターゲット デプロイ環境に指定された値です。 /ApplicationName .msi ファイル内の成果物がインポートされる BizTalk アプリケーションの名前。 指定しない場合は、.msi ファイルのエクスポート時に指定されたアプリケーション名が使用されます。 指定したアプリケーションが存在しない場合は、作成されます。 スペースを含むアプリケーション名は、二重引用符 (") で囲む必要があります。 /上書き アプリケーション内の成果物を、同じローカル一意識別子 (LUID) を持つ .msi ファイル内のアーティファクトで上書きするオプション。 このオプションが指定されておらず、.msi ファイル内の成果物と同じ LUID を持つ 1 つ以上の成果物がアプリケーションに存在する場合、インポートは失敗します。 ListApp コマンドを使用すると、アプリケーション内の成果物の LUID を表示できます。 /サーバー BizTalk 管理データベースをホストする SQL Server インスタンスの名前 。ServerName\InstanceName,Port という形式です。
インスタンス名は、インスタンス名がサーバー名と異なる場合にのみ必要です。 ポートは、SQL Server が既定 (1433) 以外のポート番号を使用する場合にのみ必要です。
例：
Server=MyServer
Server=MyServer\MySQLServer,1533
指定しない場合は、ローカル コンピューターで実行されている SQL Server インスタンスの名前が使用されます。/データベース BizTalk 管理データベースの名前。 指定しない場合は、SQL Server のローカル インスタンスで実行されている BizTalk 管理データベースが使用されます。