アンマネージド ソリューションの作成、エクスポート、またはインポート
公開日: 2017年1月
対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online
アンマネージド ソリューションは、マネージド ソリューションの作成に必須であるだけでなく、一連のアンマネージド カスタマイズを組織間でやり取りする 1 つのセットにグループ化する手段としても有効です。
詳細については、TechNet: カスタマイズでのソリューションの使用を参照してください。
このトピックの内容
アンマネージド ソリューションの作成
アンマネージド ソリューションのエクスポート
アンマネージド ソリューションのインポート
アンマネージド ソリューションの作成
すべてのソリューションには発行元が必要です。 ソリューションを配布しない場合、組織用に既に作成されている既定の発行元を使用できます。 ソリューションの発行元の作成方法については、「ソリューション発行者の作成」を参照してください。
ソリューションに含まれるフィールドと説明を次の表に示します。
フィールド ラベル |
説明 |
|---|---|
表示名 |
ソリューションの名前です。 |
名前 |
Microsoft Dynamics 365 は、[表示名] に基づいて一意の名前を生成します。 一意な名前は編集できます。 一意な名前には、英数字とアンダースコアのみを使用できます。 |
発行元 |
ソリューションを発行元に関連付けるには、発行元検索を使用します。 |
バージョン |
次の形式でバージョンを指定します: major.minor.build.revision (例: 1.0.0.0)。 |
構成ページ |
ソリューションに HTML Web リソースを含める場合、この検索を使用して HTML Web リソースを指定の構成ページとして追加できます。 詳細:ソリューション構成ページの使用 |
内容 |
このフィールドを使用して、ソリューションに関する詳細を記入できます。 |
アンマネージド ソリューションを作成した後、ソリューション コンポーネントを追加するには、このソリューションのコンテキスト内でソリューション コンポーネントを作成するか、他のソリューションから既存のコンポーネントを追加します。 ソリューションをプログラムで作成する方法の詳細については、ソリューションの作成 を参照してください。
ソリューション発行者の作成
マネージド ソリューションを配布する場合、Publisher を作成する必要があります。Publisher に含まれるフィールドと説明を次の表に示します。
ラベル |
説明 |
|---|---|
表示名 |
ソリューションの [発行元] 検索フィールドに表示する名前です。 |
名前 |
Microsoft Dynamics 365 は、[表示名] に基づいて一意の名前を生成します。 一意な名前には、英数字とアンダースコアのみを使用できます。 注意 Unique Name を使用して、Publisher を一意に識別できます。 同じ発行元を共有するマネージド ソリューションは相互に更新できます。 |
内容 |
このフィールドを使用して、ソリューションに関する詳細を記入できます。 |
接頭辞 |
カスタマイズの接頭辞は、ソリューション コンポーネントを追加した発行元を識別するために役立ちます。 たとえば、この発行元に関連付けられたソリューションのコンテキストで作成したエンティティまたは属性の論理名に接頭辞が追加されます。 接頭辞は 2 ～ 8 文字で指定する必要があり、英数字のみを使用できます。 接頭辞を ‘mscrm’ で始めることはできません。 |
オプション値の接頭辞 |
この値は、統合オプションをサポートするためにオプション セットに追加するオプションを区別するのに役立ちます。 値は、一意性がより確実になるように、[接頭辞] テキストに基づいて自動生成されます。 この値は 10,000 ～ 99,999 にする必要があります。 |
取引先担当者の詳細 |
これらのフィールドを使用して、ソリューションのインストール担当者が連絡をとるための情報を追加します。 |
発行元をプログラムで作成する方法については、「発行元の作成」を参照してください。
ソリューション構成ページの使用
ソリューション構成ページは、情報を表示したり、ソリューションのコンテキストで顧客が操作できるようにするためのキャンバスです。 構成ページを設定するには、[構成ページ] 検索フィールドを使用して、ソリューションに含まれている Web ページ (HTML) の Web リソースを選択します。 これにより、[構成] ノードが [情報] ノードの下の [ソリューション] ウィンドウと [コンポーネント] ノードに表示されます。 [構成] ノードに、設定した Web リソースが表示されます。
ソリューション構成ページで、ソリューションを構成するコントロールを表示できます。 たとえば、ソリューションに、ソリューションの動作を制御するエンティティを設定できます。Microsoft Dynamics 365 の OData エンドポイントを使用して、Web リソースにカスタム コントロールを設定することで、これらのエンティティのデータを更新できます。
アンマネージド ソリューションのエクスポート
次のような場合には、アンマネージド ソリューションをエクスポートできると便利です。
たとえば、サイトマップの編集やカスタマイズされたリボンの作成を行う場合。この場合には customizations.xml ファイル内の XML コンテンツを編集する必要があります。
アンマネージド ソリューションを組織間で転送する場合。
現在のカスタマイズ セットのバックアップを作成する場合。
アンマネージド ソリューションをエクスポートすると、圧縮 (zip) ファイルが作成されます。この圧縮ファイルを他の組織または同じ組織にインポートできます。
ソリューションをエクスポートするとき、公開済みのカスタマイズのみが含まれるので、ソリューションをエクスポートする前にかならず変更を公開してください。
Web アプリケーションを使用してソリューションをエクスポートするとき、ソリューションに不足している必須コンポーネントが含まれている場合は、[不足している必須コンポーネント] の手順を参照してください。 アンマネージド ソリューションとしてこれを元の組織にインポートする場合は、この警告を無視できます。 それ以外は、ダイアログ ボックスの指示に従って、エクスポートをキャンセルし、必須コンポーネントを追加します。
ソリューションをプログラムでエクスポートするには、ExportSolutionRequest メッセージを使用します。詳細:ソリューションのエクスポートまたはパッケージ化
[システム設定のエクスポート (詳細)] ステップで Web アプリケーションを使用してソリューションをエクスポートするとき、ソリューションに含めるシステム設定を選択できます。 これらのオプションは、要求で使用できるメンバーを介して、 ExportSolutionRequest を使用して開発者が使用できます。 どちらの設定を含めるかの詳細に対する要求についての注釈を参照してください。
ソリューションをエクスポートするとき、対象とするバージョンを選択できます。 以前のバージョンと互換のあるソリューションをエクスポートできます。詳細:特定の Dynamics 365 バージョンのソリューションをエクスポートする。
アンマネージド ソリューションのインポート
次のような場合には、アンマネージド ソリューションをインポートする必要があります。
一連のカスタマイズを組織間で転送し、ソリューション コンポーネントを変更できるようにする場合。
以前のソリューション コンポーネント定義セットに戻す場合。
アンマネージド ソリューションのインポートは追加プロセスです。 古いバージョンのマネージド ソリューションをインポートしても、新しいバージョンに含まれるソリューション コンポーネントは削除されません。 ただし、ソリューション コンポーネント プロパティの定義は、最後にインポートしたアンマネージド ソリューションに含まれる定義で上書きされます。
重要
アンマネージド ソリューションのインポートによって適用された変更はアンインストールできません。 変更をロールバックできるようにする場合は、アンマネージド ソリューションをインストールしないでください。
この操作をプログラムで実行するには、ImportSolutionRequest メッセージを使用します。 このメッセージを非同期に実行するコードを作成できます。詳細:バックグラウンドのメッセージを実行する (非同期)。 インポートの進行状況を追跡する場合、またはインポートの成功に関するレポートを生成する場合は、ImportJob エンティティを使用します。詳細:ソリューションのインストールまたはアップグレード
重要
ソリューションのインストールやカスタマイズの発行は、通常のシステム操作に影響を与える可能性があります。 ユーザーに対する影響が最小であるうちに、ソリューションのインポートを予定することを推奨します。
インポートするソリューションの最大サイズ
Microsoft Dynamics 365 (オンライン) の場合、ソリューションの最大サイズは 29.296 MB です。
設置型の組織の場合、ソリューションの既定の最大サイズは 6 MB ですが、この値は必要に応じて増やすことができます。
最大許容サイズを変更するには、アプリケーションの web.config で、<httpRuntime> 要素を編集します。 必要なサイズを許容するには、executionTimeout 属性と maxRequestLength 属性を編集します。 ソリューションのインストールが完了した後、必要なサイズに設定できます。
関連項目
ソリューション開発の計画
ソリューションを使用した拡張機能のパッケージ化および配布
Customization solutions file schema
管理ソリューションの作成、インストール、および更新
ソリューションのインストールまたは削除
Microsoft Dynamics 365
© 2017 Microsoft. All rights reserved. 著作権