创建、导出或导入非托管解决方案

 

发布日期: 2017年1月

适用于: Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online

非托管解决方案不仅是创建托管解决方案的前提,而且也是将非托管的自定义项集合组成可以在组织之间进行传输的集合的有用方法。

有关详细信息,请参阅:TechNet:将解决方案用于您的自定义项

本主题内容

创建非托管解决方案

导出非托管解决方案

导入非托管解决方案

创建非托管解决方案

每个解决方案都需要有发布商。 如果您不想分发解决方案,可以使用已为所属组织创建的默认发布商。 有关如何创建解决方案发布商的详细信息,请参阅创建解决方案发布商。

下表列出了解决方案包含的字段和说明。

字段标签

说明

显示名称

解决方案的名称。

客户

Microsoft Dynamics 365 根据“显示名称”生成一个唯一名称。 您可以编辑该唯一名称。 唯一名称必须仅包含字母数字字符或下划线字符。

发布者

使用“发布商”查找可将解决方案与发布商相关联。

版本

请以以下格式指定版本: major.minor.build.revision,例如 1.0.0.0。

配置页

如果解决方案中包含了 HTML Web 资源,则可以使用此查找将其添加为指定的配置页。

详细信息:使用解决方案配置页面

说明

使用此字段可以包含有关解决方案的任何相关详细信息。

创建非托管解决方案后,您可以通过以下两种方式添加解决方案组件:在此解决方案的上下文中创建组件,或者从其他解决方案添加现有组件。 有关如何以编程方式创建解决方案的详细信息,请参阅 创建解决方案

创建解决方案发布商

如果想要分发托管解决方案,应创建 Publisher。 下表列出了解决方案 Publisher 包含的字段和说明。

标签

说明

显示名称

解决方案的“发布商”查找字段中显示的名称。

客户

Microsoft Dynamics 365 根据“显示名称”生成一个唯一名称。 唯一的名称可以仅包含字母数字字符和下划线字符。

备注

您可以使用 Unique Name 唯一标识 Publisher。 共享相同发布商的托管解决方案可以彼此更新。

说明

使用此字段可以包含有关解决方案的任何相关详细信息。

前缀

自定义项前缀有助于标识添加解决方案组件的发布商。 例如,前缀可以添加到在与此发布商关联的解决方案的上下文中创建的任何实体或属性的逻辑名称中。 前缀的长度必须介于两个到八个字符之间,可以仅包含字母数字字符。 不能以 ‘mscrm’ 开头。

选项值前缀

此值有助于分离为支持合并选项而添加到选项组中的选项。 此值是根据“前缀”文字自动生成的,以便进一步提高唯一性。 此值必须介于 10,000 到 99,999 之间。

详细信息:合并选项集选项

联系人详细信息

使用这些字段来添加信息,以便安装解决方案的人员可以与您联系。

有关如何以编程方式创建发布商的详细信息,请参阅创建发布商

使用解决方案配置页面

解决方案配置页提供了一个区域,供您显示信息或方便客户执行解决方案上下文中的动作。 配置页面的设置方式如下:使用“配置页面”查找字段选择解决方案中包含的网页 (HTML) Web 资源。 完成此操作后,“解决方案”窗口中会出现一个新的“配置”节点,该节点位于“信息”节点之下,“组件”节点之上。 “配置”节点将显示您所设置的 Web 资源。

您可以使用解决方案配置页显示将用于配置解决方案的控件。 例如,您可以在解决方案中提供一些用于控制解决方案行为的实体。 使用 Microsoft Dynamics 365 的 REST 端点,可以在 Web 资源页面上提供自定义的控件,以更新这些实体中的数据。

导出非托管解决方案

在以下情形中,您可能想要导出非托管解决方案:

  • 必须编辑 customizations.xml 文件中的特定 XML 内容。例如,您可能想要编辑 SiteMap 或创建自定义的功能区。

  • 您想将非托管解决方案从一个组织传输到另一个组织。

  • 您想创建当前自定义项组的备份。

导出非托管解决方案时会创建一个压缩 (zip) 文件,然后可将该文件导入其他组织或同一个组织。

在导出解决方案时,只包括已发布的自定义项,因此,在导出解决方案之前,必须确定公布所有更改。

当使用 Web 应用程序导出解决方案时,如果您的解决方案中包含任意缺少的必需组件,将显示“缺少必需组件” 步骤。 仅当您打算将此解决方案作为非托管解决方案导入到原组织时,才能忽略此警告。 否则,请按照对话框内的说明取消操作并添加必需组件。

使用 ExportSolutionRequest 消息能够以编程方式导出解决方案。详细信息:导出或打包解决方案

当使用 Web 应用程序导出解决方案时,在“导出系统设置(高级)”步骤中,您可以选择要包含在解决方案中的系统设置。 这些选项是可供开发人员可以使用通过 ExportSolutionRequest 成员请求中许可。 参阅请求注解以了解所包含设置的详细信息。

当导出解决方案时,您可以选择目标版本。 您可以导出与早期版本兼容的解决方案。详细信息:导出特定 Dynamics 365 版本的解决方案

导入非托管解决方案

在以下情形中,您应导入非托管解决方案:

  • 您想将一组自定义项从一个组织传输到另一个组织,并且想要更改解决方案组件。

  • 您想恢复或还原到解决方案组件定义的较早版本

导入非托管解决方案是一个累加过程。 导入较早版本的托管解决方案不会移除较新版本中的解决方案组件。 但是,所有解决方案组件属性的定义都将被上次导入的非托管解决方案中的定义所覆盖。

重要

通过导入非托管解决方案应用的更改无法卸载。 如果想要回滚更改,请勿安装非托管解决方案。

此操作可以使用 ImportSolutionRequest 消息以编程方式执行。 您可以编写代码以可按异步方式执行此消息。详细信息:在后台执行消息(异步)。 您可以使用 ImportJob 实体跟踪导入进度或生成导入成功报告。详细信息:安装或升级解决方案

重要

安装解决方案或发布自定义项会干扰常规的系统操作。 建议您安排在解决方案对用户的干扰最小时导入解决方案。

导入解决方案的最大大小

对于 Microsoft Dynamics 365 (online),解决方案的最大大小为 29.296 MB。

对于内部部署组织,解决方案的默认最大大小为 6 MB,但可以根据需要增加。

更改允许的最大大小的方式如下:编辑应用程序文件中的 <httpRuntime>web.config 元素以便应用。 编辑 executionTimeoutmaxRequestLength 属性可酌留出必需的大小。 完成解决方案的安装后,即可以设置为想要的大小。

另请参阅

解决方案开发的规划
使用解决方案打包和分发扩展
Customization solutions file schema
创建、安装和更新托管解决方案
卸载或删除解决方案

Microsoft Dynamics 365

© 2017 Microsoft。 保留所有权利。 版权