解决方案组件的依赖项跟踪

解决方案由解决方案组件所组成。 使用 Microsoft Dataverse 中的“解决方案”区域创建或添加解决方案组件。 可以使用 AddSolutionComponentRequest 消息或用于创建或更新包括 SolutionUniqueName 参数的解决方案组件的任何消息,以编程方式执行这些操作。

解决方案组件通常依赖于其他解决方案组件。 您无法删除对其他解决方案组件具有依赖关系的任何解决方案组件。 例如,自定义功能区通常需要图像或脚本 Web 资源才能显示图标并使用脚本执行操作。 只要自定义功能区位于解决方案中,就需要其所使用的特定 Web 资源。 在删除网络资源之前,必须先删除自定义功能区中对它们的引用。 可以通过选择“ 显示依赖项”在应用程序中查看这些解决方案组件依赖项。

本文章介绍可以包括在解决方案中的解决方案组件的类型以及它们相互之间的依赖关系。

所有的解决方案组件

系统 componenttype 全局选择列包含可用解决方案组件类型的完整列表。 可以通过在项目中包括文件 OptionSets.cs 或 OptionSets.vb 来查看此属性支持的值范围。 但是,列出的许多解决方案组件类型仅供内部使用,并且列表不提供有关解决方案组件之间的关系的信息。

解决方案组件依赖项

解决方案组件依赖项可确保使用解决方案时获得可靠的体验。 它们可防止你通常执行的操作无意中破坏解决方案中定义的自定义项。 利用这些依赖项,只需导入或删除解决方案,便可安装和卸载托管解决方案。

解决方案框架会自动跟踪解决方案组件的依赖项。 对解决方案组件执行的每项操作都会自动计算其对系统中其他组件的任何依赖关系。 系统使用依赖项信息来维护其完整性,并防止可能导致不一致状态的操作。

由于依赖项跟踪,将强制实施以下行为:

  • 如果系统中的其他组件依赖于某个组件,则会防止删除该组件。

  • 导出解决方案时,如果缺少的组件可能导致该解决方案导入到另一个环境时失败,系统会发出警告。

    如果您打算仅在预期存在这些依赖组件的环境中安装该解决方案,则可以在导出过程中忽略警告。 例如,当您创建一个设计为安装在预先安装的“基础”解决方案之上的解决方案时。

  • 如果解决方案不包含所有必需的组件,并且目标环境尚未包含这些组件,则解决方案导入会失败。

  • 导入托管解决方案时,所有必需的组件必须与解决方案的包类型匹配。 托管解决方案中的组件只能依赖于另一个托管组件。

解决方案组件依赖项有三种类型:

  • 内部解决方案。 Dataverse 管理内部依赖项。 当某个特定的解决方案组件无法脱离另一个解决方案组件而独立存在时,就会存在这种依赖关系。
  • 已发布。 当两个解决方案组件彼此相关并且已发布时,Dataverse 会创建已发布的依赖项。 若要删除此类依赖项,必须删除关联并再次发布表。
  • 未发布。 未发布的依赖项应用于所更新的可发布解决方案组件的未发布版本。 发布解决方案组件后,它将成为已发布的依赖项。

解决方案内部依赖项是指这样一种依赖关系:对某个解决方案组件执行操作时,还需要对另一个解决方案组件执行相应操作。 例如,如果删除表,则预期会随表一起删除所有表属性。 系统还会删除与其他表的任何表关系。

但是,内部依赖项可能会导致某个依赖项被发布,并且仍需要手动干预。 例如,如果您已在表窗体中包括某个查找字段,然后删除关系中的主要表,那么您将无法完成该删除操作,除非从相关表窗体中删除该查找列并发布该窗体。

使用解决方案以编程方式执行操作时,请使用与 Dependency 表相关的消息。 若要了解可用于标识在删除某个组件或卸载某个解决方案之前可能存在的依赖项的消息,请参阅依赖关系实体。

常见解决方案组件

这些解决方案组件显示在应用程序中。 通过解决方案页面添加或删除解决方案组件时,可以直接处理它们。 其他每种类型的解决方案组件都依赖于其中一个或多个此类解决方案组件。

应用程序功能区(RibbonCustomization)

应用程序功能区的功能区自定义项和表功能区模板。 应用程序功能区不包括表或窗体级别的功能区定义。

自定义应用程序功能区通常具有对 Web 资源的已发布依赖关系。 使用 Web 资源定义功能区按钮图标和 JavaScript 函数,用于控制何时显示功能区元素,或者在使用特定功能区控件时执行哪些操作。 仅当功能区定义使用 $webresource: 指令将 Web 资源关联到功能区时,才会创建依赖项。 有关详细信息,请参阅 $webresource 指令。

文章模板(KBArticleTemplate)

包含文章标准属性的模板。 文章模板与 KbArticle 表之间始终存在内部依赖项。

连接角色(ConnectionRole)

描述两条记录之间的关系的角色。 每个连接角色定义可以使用连接角色链接的实体记录类型。 此角色可在连接角色与表之间创建已发布的依赖项。

合同模板 (ContractTemplate)

包含合同标准属性的模板。 合同模板与合同表之间始终存在内部依赖项。

仪表板或实体窗体(SystemForm)

使用系统窗体表记录定义仪表板和表窗体。 使用 SystemForm 作为表窗体时,存在对该表的内部依赖关系。 将 SystemForm 用作仪表板时,没有内部依赖项。 表窗体和仪表板通常具有与其内容相关的已发布依赖项。 表窗体可能具有依赖于表关系的查找列。 仪表板和表窗体可能包含图表或子网格,这些图表或子网格会对视图创建已发布的依赖关系,而该视图随后对表具有内部依赖关系。 由于仪表板或窗体中显示了内容或窗体中包含 JavaScript 库时,可以在 Web 资源上创建已发布的依赖项。 表窗体针对窗体中显示为列的任何属性都具有已发布的依赖项。

电子邮件模板(EmailTemplate)

包含电子邮件消息标准属性的模板。 电子邮件模板通常包括用于插入指定表属性数据的列。 您可以在创建时将电子邮件模板链接到特定表,因此可能存在对该表的内部依赖项。 全局电子邮件模板不与特定表关联,但它可能已发布对用于提供数据的表属性的依赖项。 流程(工作流)通常配置为使用电子邮件模板发送电子邮件,从而使用该工作流创建已发布的依赖项。

实体 (Entity)

表(以前称为实体)是 Dataverse 中用于建模和管理数据的主要结构。 由于它们之间的内部依赖关系,在删除表时,还删除与该表关联的图表、窗体、表关系、视图和属性。 表通常与流程、仪表板和电子邮件模板存在已发布依赖关系。

列安全性配置文件 (FieldSecurityProfile)

定义安全属性的访问级别的配置文件。

邮件合并模板(MailMergeTemplate)

包含邮件合并文档的标准属性的模板。 邮件合并模板对与其相关联的表具有已发布的依赖项。

选项集(OptionSet)

选项列(以前称为选项集)定义一组选项。 选择列表属性使用选择项来定义所提供的选项。 有多个选择列表属性可能会使用全局选项,以便它们所提供的选项始终相同并且可以在一个位置进行维护。 当选择列表属性引用全局选项时,即会存在已发布的依赖项。 您无法删除选择列表属性所使用的全局选项。

插件程序集 (PluginAssembly)

包含一个或多个插件类型的程序集。 插件会注册到通常与某个表相关联的事件。 此注册可创建已发布的依赖项。

流程 (Workflow)

一组逻辑规则,这些规则定义自动执行特定业务流程、任务或一组要执行的操作所需的步骤。 流程提供的各种操作可针对流程所引用的任何其他解决方案组件创建已发布的依赖项。 每个流程对与其相关联的表也具有已发布的依赖项。

报表(报表)

采用易读布局的数据摘要。 报表对其中所包括的任何表或属性数据具有已发布的依赖项。 每个报表还必须与报表类别相关联,从而对名为 Report Related Category 的解决方案组件(ReportCategory)创建内部依赖项。 可以将报表配置为子报表,从而与父报表形成已发布的依赖关系。

SDK消息处理步骤(SDKMessageProcessingStep)

执行管道中插件执行所在的阶段。

安全角色(角色)

对安全权限进行分组。 向用户分配安全角色,以授权其访问 Dataverse 系统。 将表窗体与特定的安全角色相关联,以控制谁可以查看该窗体。 此关联在安全角色和表单之间创建一个已发布的依赖关系。

备注

您只能将来自环境业务部门的安全角色添加到解决方案。 只有对这些安全角色拥有读取访问权限的用户可以将其添加到解决方案中。

服务端点(ServiceEndpoint)

可以联系的服务终结点。

站点地图(SiteMap)

用于控制应用程序导航窗格的 XML 数据。 可以链接网站地图以显示 HTML Web 资源,或者网站地图中的图标可能使用图像 Web 资源。 使用 $webresource: 指令建立这些关联时,将创建已发布的依赖项。 有关详细信息,请参阅 $webresource 指令。

Web资源(WebResource)

等同于用于扩展模型驱动应用或 Web 开发中的文件的数据。 Web 资源提供用于提供自定义用户界面元素的客户端组件。 Web 资源可能与表窗体、功能区和站点地图之间具有已发布的依赖项。 使用 $webresource: 指令在功能区或站点地图中建立关联时,将创建已发布的依赖项。 有关详细信息,请参阅 $webresource 指令。

备注

Web 资源可能依赖于基于相对链接的其他 Web 资源。 例如,HTML Web 资源可能使用 CSS 或脚本 Web 资源。 在表窗体或图表外显示的 Silverlight Web 资源必须有一个承载它的 HTML Web 资源。 这些依赖关系不会被作为解决方案依赖关系进行追踪。

另请参阅