ソリューション (Solution) エンティティのメッセージおよびメソッド

[アーティクル]
12/22/2017

公開日: 2017年1月

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

ソリューションとは、エクスポートまたはインポートできるソリューションコンポーネントのグループです。

ソリューションが管理対象 (マネージド) になっている場合、そのソリューションは 1 つのソフトウェア単位として扱われます。マネージドソリューションを削除すると、該当するソリューションコンポーネントがすべて削除されます。

ソリューションが非管理対象 (アンマネージド) になっている場合、そのソリューションは単に一群のソリューションコンポーネントに名前を付けたグループにすぎません。アンマネージドソリューションを削除すると、そのグループが削除されるだけです。該当するソリューションコンポーネントはすべて維持されます。アンマネージドソリューションをエクスポートし、それをマネージドソリューションとしてエクスポートするように選択すると、マネージドソリューションが作成されます。このエンティティのスキーマ名は Solution です。組織のエンティティメタデータを表示するには、「組織のメタデータの参照」で説明されているメタデータブラウザーソリューションをインストールします。カスタマイズされていない組織のメタデータを、EntityMetadata.xlsx という名前の Excel ファイルで見ることもできます。このファイルは、ダウンロードした SDK の最上位のフォルダーに含まれています。

IOrganizationService.Execute メソッドで、このエンティティに関連して使用されるメッセージを次の表に示します。

メッセージ	説明
AssociateRequest	関連付けに参加している一対一のレコード間または一対多のレコード間のリンクを作成します。IOrganizationService.Associate メソッドを使用することもできます。詳細については、「8597998f-764f-4c73-b63d-9f5e02c78061#ActionsOnEntityRecords」を参照してください。このエンティティで使用する既定の関連付けの一覧については、ソリューションエンティティのメタデータを参照してください。この情報は、組織のメタデータ内にあります。前述のメタデータブラウザー情報を確認してください。
CloneAsPatchRequest	ソリューションの修正プログラムを作成します。修正プログラムには、エンティティおよびその他のエンティティ関連資産に対する変更が含まれています。詳細については、「ソリューションの更新プログラムを簡易化する修正プログラムの作成」を参照してください。
CloneAsSolutionRequest	より大きい major.minor バージョン番号を持つ、アンマネージドソリューションの重複コピーを作成します。詳細については、「ソリューションの更新プログラムを簡易化する修正プログラムの作成」を参照してください。
CreateRequest	ソリューションを作成します。IOrganizationService.Create メソッドを呼び出すこともできます。
DeleteRequest	ソリューションを削除します。IOrganizationService.Delete メソッドを呼び出すこともできます。
DeleteAndPromoteRequest	保持ソリューションとしてインポートされたソリューションの新バージョンがあるときに、基本ソリューションで使用できます。このメッセージ要求は、基本ソリューションとその修正プログラムを削除し、保持ソリューションの名前を基本ソリューションと同じ名前に変更します。詳細:ソリューションの更新プログラムを簡易化する修正プログラムの作成。
DisassociateRequest	関連付けに参加している一対一のレコード間または一対多のレコード間からリンクを削除します。IOrganizationService.Disassociate メソッドを使用することもできます。詳細については、「8597998f-764f-4c73-b63d-9f5e02c78061#ActionsOnEntityRecords」を参照してください。このエンティティで使用する既定の関連付けの一覧については、Solution エンティティのメタデータを参照してください。この情報は、組織のメタデータ内にあります。前述のメタデータブラウザー情報を確認してください。
ExportSolutionRequest	マネージドまたはアンマネージドソリューションをエクスポートします。
ImportSolutionRequest	マネージドまたはアンマネージドソリューションをインポートします。注意このメッセージは ExecuteAsyncRequest で使用できます。詳細については、「218d9d80-fb52-49a4-9208-b72675080451#bkmk_executeasync」を参照してください。
InitializeFromRequest	2 つのエンティティに属性マップが定義されている場合に、既存のレコードに基づいて新しいレコードを初期化します。詳細については、「エンティティマッピングおよび属性マッピングのカスタマイズ」を参照してください。
RetrieveDuplicatesRequest	重複データ検出が有効であり、エンティティ用の重複データ検出ルールが公開済みである場合に、指定されたレコードについて重複レコードを検出および取得します。詳細については、「重複データの検出」を参照してください。
RetrieveRequest	ソリューションを取得します。IOrganizationService.Retrieve メソッドを呼び出すこともできます。
RetrieveMultipleRequest	ソリューションのコレクションを取得します。IOrganizationService.RetrieveMultiple メソッドを呼び出すこともできます。
UpdateRequest	ソリューションを更新します。IOrganizationService.Update メソッドを呼び出すこともできます。

定数の SolutionId 値

プログラムでソリューションを使用する場合、次のソリューションレコードを参照する必要があることもあります。それぞれの Microsoft Dynamics 365 組織には、SolutionId 値で参照できる次のソリューションがあります。

名前	SolutionId	説明
既定値	{FD140AAF-4DF4-11DD-BD17-0019B9312238}	既定のソリューションにはソリューションコンポーネントがまったく含まれていません。既定のソリューションにはシステム内のすべてのマネージドソリューションとアンマネージドソリューションに対する参照が含まれています。
アクティブ	{FD140AAE-4DF4-11DD-BD17-0019B9312238}	アクティブなソリューションは、アプリケーションの動作を定義した、現在公開されているアンマネージカスタマイズを表します。

Share via

ソリューション (Solution) エンティティのメッセージおよびメソッド

定数の SolutionId 値

関連項目

その他のリソース