以下步骤描述了如何在管理后台中使用微页面引擎amis自定义用户界面。
请先进入“设置”应用,点击左侧“用户界面->微页面”菜单,然后点击右上角的新建按钮即可开始新建微页面。
新建“表单、列表页面、记录页面”这三种类型的微页面时会自动生成一个设计好的默认 页面版本 供用户二次开发。
微页面新建好后,我们就可以点击右上角名为“设计器”的按钮打开微页面设计器来设计页面。
把设计好的微页面发布后,我们还需要为每个微页面配置访问权限才能让最终用户看到。我们通过配置“页面分配”来设置权限。
我们可以根据不同的业务场景来分配设计好的页面,也就是说可以让用户在访问不同的应用,或者不同的简档下的用户看到不一样的页面效果。
在微页面记录详情界面可以看到一个名为“页面分配”的子表列表,我们点击该列表右上角的新建按钮可以新建一条页面分配记录。
我们可以为同一个微页面新建多个页面分配记录,它们都会生效。
以下表格描述了在页面分配中支持的三种授权类型对于微页面授权范围的区别:
授权类型 | 授权应用 | 授权简档 |
---|---|---|
组织默认设置 | 所有应用 | 所有简档 |
应用程序默认设置 | 仅限指定应用 | 所有简档 |
应用程序和简档 | 仅限指定应用 | 仅限指定简档 |
在微页面授权范围内的用户可以看到使用amis定制的页面效果,而不在授权范围内的用户看到的页面会是系统原来默认内置的页面效果。
比如假设我们为合同对象设计了一个类型为“记录页面”的使用amis引擎的微页面,并且在页面分配时只授权给“合同管理员”这个简档,那么合同管理员在查看合同记录详情界面时会看到我们定制的微页面,而其他用户看的则会是非定制的默认合同记录详情页面效果。
假设我们已经设计好并发布了页面,以下步骤描述了如何把类型为“应用程序页面”的微页面绑定到选项卡并让最终用户看到它。
页面设计完成后,我们需要点击设计器右上角或微页面记录详情界面右上角的“发布”按钮来发布设计器中设计好的页面内容,两个发布按钮没有区别。
需要注意的是,每次在设计器中修改设计后,需要点击发布按钮发布后才能让最终用户看到最新设计后的效果。
发布操作实际上是把当前最新的“页面版本”标记为“已发布”状态,最终用户看到的页面内容也是最新的已发布状态的页面版本。
第一次在设计器中保存设计内容后,会生成一个页面版本,我们可以在微页面记录详情界面的“页面版本”子表中看到它。
每次点击发布按钮后会把当前最新的页面版本标记为“已发布”,而且后续每次在设计器中修改并保存已发布过的微页面都会生成一个新的待发布的页面版本。
我们在设计器中设计的页面内容最终是以 amis Schema 保存到每个页面版本中的,如果熟悉 amis Schema 语法,我们也可以直接在页面版本中修改它。
微页面本身是不支持参数配置的,不过因为微页面支持直接通过url访问,所以如果需要实现带参数的微页面,可以通过新建外部链接类型的 选项卡,并配置其链接地址为微页面访问地址。
微页面访问地址格式为/app/${appApiName}/page/${pageApiName}[?动态参数]
,规则如下:
比如如果把外部链接配置为/app/oa/page/oa_home?company_id=619383545b2e9a72ec0558b3
表示点击选项卡时,打开api名称为oa的应用下配置api名称为oa_home的微页面,同时传入一个名为company_id的参数。
有了公式脚本功能,我们只要把上面选项卡的外部链接地址配置为{{`/app/oa/page/oa_home?company_id=${global.user.company_id}`}}
即可动态把当前登录用户”所属分部“值传给微页面的“所属公司“参数。
上面提到的方法只适合页面类型为“应用程序页面”的微页面,其他类型的微页面并不具备为页面配置参数的能力。