アンマネージド ソリューションの作成、エクスポート、またはインポート

このトピックは、Dynamics 365 Customer Engagement (on-premises) に適用されます。 このトピックの Power Apps バージョンについては、以下を参照してください。 マネージド ソリューションを作成、エクスポート、またはインポートします。

アンマネージド ソリューションは、マネージド ソリューションの作成に必須であるだけでなく、一連のアンマネージド カスタマイズを組織間でやり取りする 1 つのセットにグループ化する手段としても有効です。

詳細: カスタマイズでのソリューションの使用。

アンマネージド ソリューションの作成

すべてのソリューションには発行元が必要です。 ソリューションを配布しない場合、組織用に既に作成されている既定の発行元を使用できます。 ソリューションの発行元の作成方法については、ソリューションの発行元の作成 を参照してください。

ソリューションに含まれるフィールドと説明を次の表に示します。

フィールド ラベル	説明
表示名	ソリューションの名前です。
名前	Dynamics 365 Customer Engagement (on-premises) は、表示名 に基づいて一意の名前を生成します。 一意な名前は編集できます。 一意な名前には、英数字とアンダースコアのみを使用できます。
発行元	ソリューションを発行元に関連付けるには、発行元検索を使用します。
バージョン	次の形式でバージョンを指定します: major.minor.build.revision (例: 1.0.0.0)。
構成ページ	ソリューションに HTML Web リソースを含める場合、この検索を使用して HTML Web リソースを指定の構成ページとして追加できます。 詳細: ソリューション構成ページの使用
説明	このフィールドを使用して、ソリューションに関する詳細を記入できます。

アンマネージド ソリューションを作成した後、ソリューション コンポーネントを追加するには、このソリューションのコンテキスト内でソリューション コンポーネントを作成するか、他のソリューションから既存のコンポーネントを追加します。 ソリューションをプログラムで作成する方法の詳細については、ソリューションの作成を参照してください

ソリューション発行者の作成

マネージド ソリューションを配布する場合、Publisher を作成する必要があります。 Publisher に含まれるフィールドと説明を次の表に示します。

ラベル	説明
表示名	ソリューションの発行元検索フィールドに表示する名前です。
名前	Dynamics 365 Customer Engagement (on-premises) は、Display Name に基づいて一意な名前を生成します。 一意な名前には、英数字とアンダースコアのみを使用できます。 注:Unique Name を使用して Publisher を一意に識別することができます。 同じ発行元を共有するマネージド ソリューションは相互に更新できます。
説明	このフィールドを使用して、ソリューションに関する詳細を記入できます。
接頭辞	カスタマイズの接頭辞は、ソリューション コンポーネントを追加した発行元を識別するために役立ちます。 たとえば、この発行元に関連付けられたソリューションのコンテキストで作成したエンティティまたは属性の論理名に接頭辞が追加されます。 接頭辞は 2 ～ 8 文字で指定する必要があり、英数字のみを使用できます。 接頭辞を "mscrm" で始めることはできません。
オプション値の接頭辞	この値は、統合オプションをサポートするためにオプション セットに追加するオプションを区別するのに役立ちます。 値は、一意性がより確実になるように、接頭辞テキストに基づいて自動生成されます。 この値は 10,000 ～ 99,999 にする必要があります。 詳細: オプション セット オプションのマージ
取引先担当者の詳細	これらのフィールドを使用して、ソリューションのインストール担当者が連絡をとるための情報を追加します。

発行元をプログラムで作成する方法については、発行元の作成 を参照してください。

ソリューション構成ページの使用

ソリューション構成ページは、情報を表示したり、ソリューションのコンテキストで顧客が操作できるようにするためのキャンバスです。 構成ページを設定するには、構成ページ検索フィールドを使用して、ソリューションに含まれている Web ページ (HTML) の Web リソースを選択します。 これにより、構成ノードが情報ノードの下の [ソリューション] ウィンドウとコンポーネントノードに表示されます。 構成ノードに、設定した Web リソースが表示されます。

ソリューション構成ページで、ソリューションを構成するコントロールを表示できます。 たとえば、ソリューションに、ソリューションの動作を制御するエンティティを設定できます。 データ アクセスの Web API を使用して Web リソース ページにカスタム コントロールを設定することで、これらのエンティティのデータを更新することができます。

アンマネージド ソリューションのエクスポート

次のような場合には、アンマネージド ソリューションをエクスポートできると便利です。

• たとえば、サイトマップの編集やカスタマイズされたリボンの作成を行う場合。この場合には customizations.xml ファイル内の XML コンテンツを編集する必要があります。

• アンマネージド ソリューションを組織間で転送する場合。

• 現在のカスタマイズ セットのバックアップを作成する場合。

  アンマネージド ソリューションをエクスポートすると、圧縮 (zip) ファイルが作成されます。この圧縮ファイルを他の組織または同じ組織にインポートできます。

  ソリューションをエクスポートするとき、公開済みのカスタマイズのみが含まれるので、ソリューションをエクスポートする前にかならず変更を公開してください。

  Web アプリケーションを使用してソリューションをエクスポートするとき、ソリューションに不足している必須コンポーネントが含まれている場合は、不足している必須コンポーネントの手順を参照してください。 アンマネージド ソリューションとしてこれを元の組織にインポートする場合は、この警告を無視できます。 それ以外は、ダイアログ ボックスの指示に従って、エクスポートをキャンセルし、必須コンポーネントを追加します。

  ソリューションをプログラムでエクスポートするには、ExportSolutionRequest メッセージを使用します。 詳細: ソリューションのエクスポートまたはパッケージ化

  システム設定のエクスポート (詳細) ステップで Web アプリケーションを使用してソリューションをエクスポートするとき、ソリューションに含めるシステム設定を選択できます。 これらのオプションは、要求で使用できるメンバーを介して、 ExportSolutionRequest を使用して開発者が使用できます。 どちらの設定を含めるかの詳細に対する要求についての注釈を参照してください。

  ソリューションをエクスポートするとき、対象とするバージョンを選択できます。 以前のバージョンと互換のあるソリューションをエクスポートできます。 詳細: 特定の Dynamics 365 Customer Engagement (on-premises) バージョンのソリューションをエクスポートする。

アンマネージド ソリューションのインポート

次のような場合には、アンマネージド ソリューションをインポートする必要があります。

• 一連のカスタマイズを組織間で転送し、ソリューション コンポーネントを変更できるようにする場合。

• 以前のソリューション コンポーネント定義セットに戻す場合。

  アンマネージド ソリューションのインポートは追加プロセスです。 古いバージョンのマネージド ソリューションをインポートしても、新しいバージョンに含まれるソリューション コンポーネントは削除されません。 ただし、ソリューション コンポーネント プロパティの定義は、最後にインポートしたアンマネージド ソリューションに含まれる定義で上書きされます。

重要

アンマネージド ソリューションのインポートによって適用された変更はアンインストールできません。 変更をロールバックできるようにする場合は、アンマネージド ソリューションをインストールしないでください。

この操作をプログラムで実行するには、ImportSolutionRequest メッセージを使用します。 このメッセージを非同期に実行するコードを作成できます。 詳細: メッセージを非同期に実行するために ExecuteAsync を使用します。 インポートの進行状況を追跡する場合、またはインポートの成功に関するレポートを生成する場合は、ImportJob エンティティを使用します。 詳細: ソリューションのインストールまたはアップグレード

重要

ソリューションをインストールまたはカスタマイズを公開すると、標準システム操作を妨げる可能性があります。 ユーザーに対する影響が少ないうちに、ソリューションのインポートを計画することを推奨します。

インポートするソリューションの最大サイズ

Dynamics 365 for Customer Engagement の場合、ソリューションの最大サイズは 29.296 MB です。

設置型の組織の場合、ソリューションの既定の最大サイズは 6 MB ですが、この値は必要に応じて増やすことができます。

 

最大許容サイズを変更するには、アプリケーションの web.config ファイル内の <httpRuntime> 要素を編集します。 必要なサイズを許容するには、executionTimeout 属性と maxRequestLength 属性を編集します。 ソリューションのインストールが完了した後、必要なサイズに設定できます。

関連項目

ソリューション開発の計画
Dynamics 365 Customer Engagement (on-premises) ソリューションを使用した拡張機能のパッケージ化および配布
カスタマイズ ソリューション ファイルのスキーマ
マネージド ソリューションの作成、インストール、および更新
ソリューションのアンインストールまたは削除