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

 

公開日: 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}

アクティブなソリューションは、アプリケーションの動作を定義した、現在公開されているアンマネージ カスタマイズを表します。

関連項目

ソリューション エンティティ
SolutionComponent エンティティのメッセージとメソッド
ソリューションの概要
エンティティ別の特権

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 著作権