特定の Dynamics 365 バージョンのソリューションをエクスポートする

[アーティクル]
03/04/2017

公開日: 2017年1月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

注意

このトピックでは、Microsoft Dynamics 365 のメジャーバージョンに対するマイナーバージョンの更新で使用できる関数について説明します。この機能は、Microsoft Dynamics 365 (オンラインおよび設置型) の最初のリリースでは使用できませんが、マイナーバージョンの更新プログラムで追加機能が組み込まれたときに使用できるようになります。

新しいバージョンのMicrosoft Dynamics 365、以前のバージョンでは見られない機能が含まれます。新しい機能を使用するソリューションは、以前のバージョンの組織にインポートできません。旧バージョンの組織からエクスポートしたソリューションは新しいバージョンの組織にインポートできます。

ソリューションの定義に使用する組織をアップグレードした後も、以前のバージョンを対象とするソリューションをエクスポートできます。下位のターゲットのバージョンを選択すると、そのバージョン以降に導入された機能に依存するソリューションコンポーネントは、エクスポートするソリューションに含まれません。

注意

既定のソリューションをエクスポートするときに、以前のバージョンは選択できません。

このトピックの内容

ソリューションをエクスポートするとき、特定のバージョンを対象にする

どのような変更は、以前のバージョンのためにエクスポートするソリューションに適用されますか。

プログラムで対象とするバージョンを選択する

ソリューションをエクスポートするとき、特定のバージョンを対象にする

Microsoft Dynamics CRM Online 2015 更新プログラム 1 からソリューションをエクスポートするとき、Dynamics 365 の特定のバージョンのソリューションを対象とするオプションが表示されます。Microsoft Dynamics CRM Online 2015 更新プログラム 1 の場合は、オプションは 7.1 (既定値) および 7.0 です。 7.0 を選択した場合、Microsoft Dynamics CRM Online 2015 更新プログラム 1 に導入された新機能は、エクスポートしたソリューションには含まれませんが、CRM 2015 の以前のバージョンをまだ使用する組織は、このソリューションをインストールすることができます。

以前のバージョンを対象とするソリューションをエクスポートするときに、エクスポートダイアログボックスは 2 つのメッセージを表示する場合があります。

このソリューションは、対象の Dynamics 365 バージョンをサポートしています。
これは、ソリューション内のソリューションコンポーネントが、そのバージョン以降に導入された機能やソリューションコンポーネントに依存しないことを意味します。
エクスポートの一部として、次のコンポーネントが削除または変更されます
このメッセージの下の表は、変更された、またはエクスポートしたソリューションに含まれていないソリューションコンポーネントの項目を示します。

ダイアログボックスに表示される情報は、エクスポートしたソリューションファイルにもあります。特定のバージョンを対象にソリューションをエクスポートすると、ファイルの名前は、次の名前付け規則を使用して、対象のソリューションを指定します: ソリューション名_Solution_Version_Number_target_CRM_対象の Dynamics 365 バージョン番号.zip。たとえば、バージョン 7.0 を対象にエクスポートされる、ソリューションのバージョンが 2.0 で、名前がサンプルソリューションのアンマネージドソリューションは、名前が SampleSolution_2_0_target_CRM_7.0.zip になります。この圧縮されたファイルの内容を抽出するときに、どのアクションが実行されたかの詳細なデータを含む filteredcomponents.xmlファイルがあることに気づきます。 Excel を使用してこのファイルを開き、どのソリューションコンポーネントが編集または削除されたかのレポートを表示できます。

どのような変更は、以前のバージョンのためにエクスポートするソリューションに適用されますか。

CRM 2013とMicrosoft Dynamics CRM Online 13 年秋リリースから、ソリューションコンポーネントの種類ごとに IntroducedVersionプロパティが含まれています。この値は、作成時に、ソリューションコンポーネントが関連付けられたソリューションの現在のバージョン番号を取り込みます。 Microsoft によって導入されたすべてのソリューションコンポーネントは、バージョン番号が Microsoft Dynamics 365 のバージョンに対応する非表示のシステムソリューションの一部です。

IntroducedVersion 値	導入されたソリューションコンポーネント
5.0.0.0	CRM 2013とMicrosoft Dynamics CRM Online 13 年秋以前
6.0.0.0	CRM 2013 および Microsoft Dynamics CRM Online 13 年秋
6.1.0.0	Microsoft Dynamics CRM 2013 Service Pack 1 (SP1) および CRM Online 2014 年春
7.0.0.0	Microsoft Dynamics CRM 2015 および Microsoft Dynamics CRM Online 2015 更新プログラム
7.1.0.0	Microsoft Dynamics CRM Online 2015 更新プログラム 1
8.0.0.0	CRM Online 2016 更新プログラムおよび CRM 2016 設置型
8.1.0.0	Microsoft Dynamics CRM Online 2016 更新プログラム 1 および Microsoft Dynamics CRM 2016 Service Pack 1
8.2.0.0	Dynamics 365 用 2016 年 12 月の更新プログラム (オンラインおよび設置型)

IntroducedVersionデータは、対象のバージョンと一致するソリューションをエクスポートするときに使用されます。これにより、次の 3 つのアクションが実行される可能性があります。

削除
対象のバージョンに存在しない、または対象のバージョンで動作できないコンポーネントとの依存関係が含まれているソリューションコンポーネントは、ソリューションに追加できません。
修正
削除されたソリューションコンポーネントとソリューションコンポーネントが依存していると、可能な場合は、ソリューションコンポーネントは変更されて依存関係が削除されます。たとえば、フォーム定義がそのバージョンに存在しない属性を参照する場合、フォームが変更されて参照が削除されます。ソリューションコンポーネントを変更して依存関係を削除できない場合は、ソリューションコンポーネントが削除されます。
置換
ソリューションコンポーネントが対象のバージョンに存在していたが、削除されるソリューションコンポーネントとの依存関係を持つように変更さた場合、ソリューションコンポーネントは対象とするバージョンに定義されたソリューションコンポーネントの定義で上書きされます。

プログラムで対象とするバージョンを選択する

ソリューションをプログラムでエクスポートするには、ExportSolutionRequest を使用します。CRM 2013 および Microsoft Dynamics CRM Online 13 年秋の後は、このメッセージには新しいオプションのTargetVersionString プロパティが含まれ、以前のバージョンにエクスポートしたい場合、これを使用して “7.0.0.0” に設定することができます。

特定の Dynamics 365 バージョンのソリューションをエクスポートする

このトピックの内容

ソリューションをエクスポートするとき、特定のバージョンを対象にする

どのような変更は、以前のバージョンのためにエクスポートするソリューションに適用されますか。

プログラムで対象とするバージョンを選択する

関連項目

その他のリソース