跳到主要内容

页面

system.page.* 管理租户自定义首页配置,并为适用成员提供已发布页面。操作流程参见 自定义页面。

查询配置​

system.page.list 需要页面访问权限,结果包含状态、资产与适用范围。

sl system page list --keyword shop --limit 20 --json
sl system page list --keyword shop --limit 20 --cursor '<nextCursor>' --json

keyword 可选,最多 200 字符;limit 为 1–100,默认 20。使用返回的原始 nextCursor 翻页,保持筛选条件一致。

创建与编辑​

system.page.create 和 system.page.update 需要页面访问及页面管理权限。使用 system.studio.asset.list/get 查询页面资产 UUID,使用组织或角色命令查询主体 UUID。必须选择 Studio 页面资产,不能使用脚本资产或文件 UUID。

创建 page.json:

{
"name": "访客商城",
"description": "购物首页",
"assetId": "<studio-page-asset-uuid>",
"scopes": [
{ "subjectType": "ROLE", "subjectId": "<role-uuid>" }
]
}
sl system page create --definition-file ./page.json --json
sl system page update --page-id '<page-uuid>' --definition-file ./page.json --json

两个命令均从 --definition-json 与 --definition-file 中二选一。

字段约束
name必填,去除首尾空格后 1–200 字符
description可选,可为 null,最多 2000 字符
assetId必填,Studio 页面资产 UUID
scopes必填,完整的 1–500 个不重复 {subjectType,subjectId} 数组
subjectTypeMEMBER、DEPARTMENT、ORGANIZATION 或 ROLE
subjectId所选主体 UUID

创建后默认 停用。编辑完整替换所有可编辑字段与适用范围,保留启停状态。两个命令均不会发布 Studio 资产。初始管理员始终不生效,通过角色、部门或组织间接命中也不例外。

启用、停用和删除​

system.page.status.update 和 system.page.delete 需要页面管理权限。

sl system page status update --page-id '<page-uuid>' --status active --json
sl system page status update --page-id '<page-uuid>' --status inactive --json
sl system page delete --page-id '<page-uuid>' --json

状态仅支持 active 或 inactive。启用中的页面不能删除;删除保留 Studio 资产。配置启用且资产已发布时才会替换成员首页。多个启用且已发布的页面同时适用时,按 created_at 降序、ID 降序选择首个。

查询当前成员适用页面​

system.page.home.get 无输入参数,返回 {page: ...} 或 {page: null}。查询当前登录成员适用的启用且已发布首页,不授予管理权限。

sl system page home get --json

system.page.applicability.get 检查指定配置是否适用于当前成员,返回 {pageId, applicable}。该检查要求配置启用并命中范围,不要求资产已经发布,因此不能据此判断页面已可运行。

sl system page applicability get --page-id '<page-uuid>' --json

获取运行页面与执行动作​

system.page.runtime.get 加载适用页面的已发布运行内容。system.page.action.execute 以当前成员权限执行该已发布版本声明的动作。

sl system page runtime get --page-id '<page-uuid>' --json
sl system page action execute --page-id '<page-uuid>' --definition-file ./action.json --json

action.json 示例:

{
"versionId": "<current-published-version-uuid>",
"actionName": "getCurrentUser",
"payload": {}
}

versionId 必须为当前已发布版本 UUID。actionName 必须为已声明动作名,长度 1–64,以字母开头,后续允许字母、数字和下划线。payload 为可选对象,默认 {}。发布新版本后重新获取运行内容,不能继续使用旧版本。草稿源码、调用者伪造的身份及管理权限均不能替代当前成员的数据权限。