管理组件


组件是一种可重复使用的模型。当某个模型被多个业务场景复用时,可将其抽象成一个可重复使用的组件。这样其它模型可以直接引用这个组件,就可以包含组件内的全部要素,而不需要重复定义相同的模型要素。当组件需要更新时,只需修改组件本身,其它引用该组件的模型会自动更新,简化模型的维护和迭代。


例如,定义一个 Location 模型,并开放为组件。在 Location 模型中定义通用的位置属性,包括 AddressLatitudeLongitude 等。当其它模型引用该组件后,可直接复用该组件内的这些通用位置属性,无需重复定义和更新。


本文介绍如何创建并管理组件。

前提条件


  • 开放模型为组件,或在模型中引用组件前,确保已拥有模型分组的编辑权限。更多信息,参见 模型管理权限分配

  • 引用其它分组的组件前,确保该组件已分享到当前 OU。

开放模型为组件


  1. 登录 EnOS 应用门户,在开发者控制台中选择 模型 菜单。

  2. 模型 列表中,选择目标模型右侧 … > 组件,打开 开放为组件 的开关。

  3. 开启后,需选择 被引用时是否支持修改标识符

    • 是,支持修改标识符:组件被模型引用后,可以为组件定义新的标识符。一个模型内可以多次引用该组件。

    • 否,保持标识符不变:组件被模型引用后,标识符不可修改,便于通过固定的标识符查找组件内的要素。一个模型内只能引用一次该组件。


备注

  • 若模型已开放为组件,无法在该模型中引用其它组件。

  • 一旦被其它模型引用,不能取消开放为组件。

  • 若父模型未开放为组件,其子模型也不可开放为组件。

  • 当父模型开放为组件后,新建的子模型也自动开放为组件。

  • 当父模型中引用某一组件后,其子模型也自动继承该组件内的要素,无需重复添加组件。

引用组件


  1. 登录 EnOS 应用门户,在开发者控制台中选择 模型 菜单。

  2. 模型 列表中,选择目标模型的 编辑 按钮。

  3. 模型定义新建 按钮旁,选择 … > 引用组件,打开弹窗。

  4. 在弹窗中选择一个组件,并配置组件的 名称标识符。是否支持修改标识符,取决于 开放模型为组件 时的自定义配置。


../../_images/reference_component.png


引用后,组件将展示在左侧 组件 列表中,你可以查看、编辑该组件,或添加新组件。


../../_images/component_successfully.png

结果


引用组件后,组件内的要素将自动添加到该模型的要素列表,标识符为“组件标识符:要素标识符”格式。你可以在列表中查看这些要素。


../../_images/component_element.png