手順 1: Visual Studio で BizTalk Server アプリケーションプロジェクトを追加する

[アーティクル]
05/04/2023

Visual Studio Team Servicesを使用してアプリケーションをビルドすると、新しい BizTalk プロジェクトファイル (.btaproj) が作成されます。この新しいプロジェクトには、Azure DevOps のビルドおよびリリース機能を使用してビルドおよびデプロイするすべての BizTalk アプリケーションが保持されます。

BizTalk アプリケーションプロジェクトには、ファイルが BizTalkServerInventory.json 含まれています。このファイルで、BizTalk アセンブリを追加し、BizTalk アプリケーションのバインドファイルを追加してから、展開シーケンスを設定します。

開始する前に

オーケストレーションを使用して単純な BizTalk プロジェクトを作成します。
BizTalk プロジェクトへの XML バインドファイルへのパスを準備します。この XML ファイルは、送受信ポートを作成します。
Azure DevOps アカウント、コレクション、チームプロジェクトの詳細を把握します。
リポジトリの複製や操作など、Git の概念をよく理解してください。

アプリケーションプロジェクトを追加する

BizTalk Serverで、Visual Studio でソリューション (ProjectName.sln) を開きます。 Visual Studio Blend を選択しないでください。
ソリューションエクスプローラーで、プロジェクト>の [ビルド] を右クリックします。ビルドが成功したことを確認します。プロジェクト>の [配置] を右クリックします。デプロイが成功したことを確認します。
ソリューション>を右クリックし、新しいプロジェクトの追加を追加>します。
[BizTalk Server アプリケーションプロジェクト>の次へ] を選択します。 [作成] などのappProjectHelloWorld>プロジェクト名を入力します。
ソリューションエクスプローラーで、新しく追加したアプリケーションプロジェクト (.btaproj) >[参照の追加]> を右クリックします。 [プロジェクト] タブを展開し、BizTalk プロジェクト (Azure DevOps を使用してデプロイするプロジェクト) をチェックします。 [OK] を選択します。

追加したら、アプリケーションプロジェクト (appProjectHelloWorld など) の下にある [参照] を展開して、先ほど追加した BizTalk プロジェクトを表示します。
ソリューションエクスプローラーで、アプリケーションプロジェクト (.btaproj) >[既存の項目>の追加][バインド XML ファイルの追加>] を右クリックします。
省略可能。新しく追加したアプリケーションプロジェクト>の [プロパティ] を右クリックします。 BizTalk 管理に表示する アプリケーション名 をカスタマイズします。

JSON テンプレートを構成する

Visual Studio で、アプリケーションプロジェクト (.btaproj) でファイルを BizTalkServerInventory.json 開きます。
テンプレートには、以下のセクションが含まれています。
- BizTalkAssemblies: アプリケーションで使用されるアセンブリ。
- BindingFiles: 参照しているバインドファイル。
- DeploymentSequence: インストールする要素のシーケンス。
サンプルテンプレート:

重要

ソリューションの複雑さに応じて、ビルドで必要な要素は、この JSON テンプレートファイルで参照する必要があります。
で BizTalkAssemblies、BizTalk プロジェクトで使用されるアセンブリを追加します。
```
"BizTalkAssemblies": [
    {
        "Name": "AssemblyName",
        "Path": "PathToAssembly
    }
]
```

で BindingsFiles、BizTalk プロジェクトのバインドファイルを追加します。

"BindingsFiles": [
    {
        "Name": "Binding File Name",
        "Path": "PathToBindingFile
    }
]

でDeploymentSequence、展開する順序でアプリケーション名を追加し、BizTalk Serverにインストールします。
```
"DeploymentSequence": [
    "NameOfFirst",
    "NameOfSecond",
    "NameOfThird"
]
```

変更内容を保存します。完了すると、.json ファイルは次のようになります。

{
  "$schema": "http://json.schemastore.org/BizTalkServerApplicationSchema",
  "BizTalkAssemblies": [
    {
      "Name": "HelloWorld",
      "Path": "HelloWorld\\bin\\Release\\HelloWorld.dll"
    }
  ],
  "BindingsFiles": [
    {
      "Name": "HelloWorldBinding",
      "Path": "HelloWorld\\HelloWorldBinding.xml"
    }
  ],
  "DeploymentSequence": [
    "HelloWorld", "HelloWorldBinding"
  ]
}

オプション。アプリケーションプロジェクト (appProjectHelloWorld など) >のプロパティを右クリックします。 [デバッグ] または [リリース] バージョンを新しい値に設定できます。これらの手順は行いませんが、次のことが可能です。
アプリケーションプロジェクト (appProjectHelloWorld など) >ビルドを右クリックします。成功した場合は、zip ファイルが yourApplicationProject\bin\debug フォルダーに作成されます。
ソリューションを選択し、[チームエクスプローラー] タブを選択します。[Azure DevOps] で、[接続] を選択します。
Azure DevOps アカウント、コレクション、およびチームプロジェクトを選択します。 [OK] を選択します。 Azure DevOps アカウントをまだ作成していない場合は、作成します (手順 2: Azure DevOps トークンの作成に関するガイダンスが提供されます)。作成したら、この手順に戻り、接続します。
接続すると、このリポジトリを複製するように求めるメッセージが表示されることがあります。 [ このリポジトリを複製 する] リンクを選択します。
URL とパスをメモし、[複製] を選択 します。

完了すると、Azure DevOps デプロイタスクでは、必要なファイルとインストールシーケンスが優先されます。

ヒント

git でクローンした後にプロジェクトに変更を加えた場合は、Visual Studio 内で変更を ステージング してから プッシュできます。

結果

BizTalk プロジェクトに、BizTalk アプリケーションプロジェクト (.btaproj) を追加しました。このプロジェクトは、Azure DevOps を使用してBizTalk Server プロジェクトのデプロイを自動化するために使用されます。アプリケーションプロジェクトを作成した後、BizTalk プロジェクトへの参照を追加しました。次に、デプロイする DLL、使用するバインドファイル、およびアプリケーションをデプロイする順序を自動デプロイに指示する JSON ファイルを更新しました。

次の手順

手順 2: Azure DevOps トークンを作成する
 手順 3: ビルド定義を作成する
 手順 4: リリース定義を作成する
 環境トークンと変数を構成する

次の方法で共有

手順 1: Visual Studio で BizTalk Server アプリケーションプロジェクトを追加する

開始する前に

アプリケーションプロジェクトを追加する

JSON テンプレートを構成する

結果

次の手順

フィードバック

その他のリソース

次の方法で共有

手順 1: Visual Studio で BizTalk Server アプリケーション プロジェクトを追加する

開始する前に

アプリケーション プロジェクトを追加する

JSON テンプレートを構成する

結果

次の手順

フィードバック

その他のリソース

手順 1: Visual Studio で BizTalk Server アプリケーションプロジェクトを追加する

アプリケーションプロジェクトを追加する