自動ビルドのモデル バージョンの更新

プラットフォーム更新プログラム 6 では、自動ビルド定義の新しいタスクが、作成したビルドのバージョンを持つビルド出力のソース パッケージと配置可能パッケージのモデルを更新します。

このタスクを含めるには、プラットフォーム更新プログラム 6 の前に作成したビルド定義を手動で更新する必要があります。 詳細については、この記事で後述 する「既存のビルド定義の更新 」セクションを参照してください。

バージョン番号

モデルは 1 つのパッケージにコンパイルされますが、バイナリ パッケージはすべてのモデルのメタデータ情報を保持します。 この情報は、Microsoft Dynamics ライフサイクル サービスまたはクライアントから確認できます。

ライフサイクル サービスで、次の手順に従って、環境にインストールされているモデルのバージョン番号を見つけます。

1. 環境の [完全な詳細 ] ページの [ 環境バージョン情報] で、[ 詳細なバージョン情報の表示 ] リンクを選択します。
2. インストールされた更新ページの、コンピューター名フィールドで、Application Object Server (AOS) コンピューターを選択します。
3. テーブルの一覧で、モデルの Publisher name フィールドを探し、矢印アイコンを選択して一覧を展開します。 その発行元からのすべてのモデルの完全な一覧が表示されます。 バージョン番号は、バージョン 列に表示されます。

クライアントで、次の手順に従って、環境にインストールされているモデルのバージョン番号を見つけます。

1. 環境の URL を開いて、サインインします。
2. ダッシュ ボードが読み込まれた後、ページの右上にあるギヤ記号を選択して、About を選択します。
3. 表示されるダイアログ ボックスで、読み込み済みパッケージとそのモデルを展開します。 モデルが存在するパッケージを検索し、矢印アイコンを選択して一覧を展開します。 パッケージのモデル一覧とバージョン番号が表示されます。

すべてのバージョン番号は .NET アセンブリ形式です。 それらは、1.2.3.4 のようにドット (.) で区切られた 4 つの数字で構成されています。

モデル バージョン管理の目的

コードが更新されると、環境に配置できる新しいパッケージを作成するためにビルドが使用されます。 Microsoft Azure DevOps は、前回のビルド以降に各ビルドに含まれた変更を追跡します。 ビルドのバージョン番号が生成されるモデルに含まれている場合、その番号によって、特定の環境で使用できるコードの変更の徹底した追跡可能性が提供されます。 ビルド番号を見つけてから、Azure DevOps でそのビルドに含まれている変更を確認することができます。 異なる分岐でビルドを使用する、または夜間ビルド、ゲート チェックイン ビルドまたは配置ビルド用の異なるビルド定義を使用する顧客およびパートナーについては、ビルドごとに異なるバージョン スキームを持つことができます。 この方法は、展開可能なパッケージのモデルメタデータを区別し、元のビルド定義に戻します。

バージョン管理の設定

プラットフォーム更新プログラム 6 または新しい配置により作成されるビルド定義については、モデルにビルド バージョンを含めるためのタスクが自動的に追加され有効になります。 Azure DevOps の新しいビルド定義の既定のビルド番号は、年、月、日、およびその日のビルドの増分番号で構成されます。 Azure DevOps のビルド番号、および使用できるオプションの詳細については、Microsoft Visual Studio ドキュメント サイトのビルド定義オプション を参照してください。

自動ビルドでは、ビルドするモデルにビルド バージョン番号が適用されます。

モデルが更新されるのを防ぐ

既定では、ビルド タスクは ISP レイヤーより上位にあるレイヤー内のモデルにのみバージョンを割り当てます。 したがって、モデルで提供されているバージョン番号を上書きしなくても、サード パーティ ベンダーのコード モデルを使用できます。 ただし、レイヤーに関係なく、ビルド中に他のモデルのバージョン番号が上書きされないようにすることもできます。 ビルド定義を編集するときは、変数 タブの ModelVersionExclusions 変数で、除外するモデル名のコンマ区切りの一覧を供給します。

下位レイヤーのモデルの更新

ISV または ISP レイヤーでソリューションを開発するサード パーティの場合は、ビルド定義を手動で変更して、それらのレイヤーにモデル バージョンを自動的に設定する必要があります。

1. ビルド定義を編集します。 [ タスク ] タブで、[ モデル バージョンの設定 ] タスクを選択します。
2. 引数フィールドで、既存の引数のリストの最後に -UpdateLayersAbove 7 のオプションを追加します。

既存のビルド定義の更新

プラットフォーム更新プログラム 6 より前に作成されたビルド定義の場合は、新しいタスクをビルド定義に手動で追加する必要があります。

1. Azure DevOps で、ビルドおよびリリース ページのビルドにあるすべての定義タブでビルド定義を検索します。

2. 省略記号 (...) を選択し、[ 編集] を選択します。

   

3. [ タスク ] タブで、ページの下部にある [ + タスクの追加 ] を選択します。

4. ページの右側にあるタスクの追加ウィンドウのユーティリティ タブで、下にスクロールして PowerShell タスクを表示します。

5. タスクの上にマウス ポインターを置き、表示される [追加 ] ボタンを選択します。

   

6. ページの左側にあるタスクの一覧で、 PowerShell スクリプト タスクを選択します。

7. ページの右側で、表示名、スクリプト パス、および引数プロパティを変更して必要な設定を反映します。

   

8. ページの左側にあるタスクの一覧で、モデル バージョンの設定タスクを、ビルドの準備とソリューションのビルド タスクの間にドラッグします。

   

9. [変数] タブで、 変数 の一覧の下部にある [ + 追加 ] を選択します。 最初の列で、名前の変数に ModelVersionExclusions と入力します。

10. [ 保存] を 選択して新しいタスクを保存します。