cloudcc-cli 2.3.1 → 2.3.2

package/src/pagelayout/docs/introduction.md

@@ -0,0 +1,44 @@
+# 页面布局（Page Layout）介绍
+
+页面布局是 CloudCC 中用于定义对象详情页展示方式的重要配置。
+
+## 什么是页面布局？
+
+页面布局决定了：
+- 字段在详情页如何排列和分组
+- 哪些字段显示、哪些隐藏
+- 操作按钮的位置和顺序
+- 相关列表的展示方式
+- 动态布局规则（根据条件显示/隐藏字段）
+
+## 适用对象
+
+页面布局可以应用于：
+- **标准对象**：如 Account（客户）、Contact（联系人）等系统内置对象
+- **自定义对象**：用户根据业务需求创建的对象
+
+## 前置条件
+
+操作页面布局前，必须先**选中对象**（自定义对象或标准对象）。
+
+## 核心能力
+
+| 能力 | 说明 |
+|------|------|
+| 查询布局列表 | 查看对象下的所有页面布局 |
+| 创建布局 | 基于现有布局复制创建新布局 |
+| 复制动态规则 | 可选择是否复制源布局的动态布局规则 |
+
+## 使用场景
+
+1. **多终端适配**：为 PC 端和移动端创建不同的布局
+2. **多角色视图**：为不同角色创建差异化的详情页展示
+3. **业务场景适配**：针对特定业务流程定制字段展示
+
+## 下一步
+
+查看开发指南了解具体 CLI 命令：
+
+```bash
+cc doc pagelayout devguide
+```

package/src/pagelayout/get.js

@@ -0,0 +1,46 @@
+const { postClass } = require("../../utils/http");
+const { getPackageJson } = require("../../utils/config");
+const chalk = require("chalk");
+
+/**
+ * 查询页面布局列表
+ * 用法：cc get pagelayout <projectPath> <objApiName>
+ */
+async function get(argvs, isMcp = false) {
+    const projectPath = argvs[2] || process.cwd();
+    const objApiName = argvs[3];
+
+    if (!objApiName) {
+        console.error();
+        console.error(chalk.red("Error: 缺少对象 API 名称"));
+        console.error("用法: cc get pagelayout <projectPath> <objApiName>");
+        console.error("示例:");
+        console.error("  cc get pagelayout . b25");
+        console.error("  cc get pagelayout . Account");
+        console.error();
+        throw new Error("缺少必需参数: objApiName");
+    }
+
+    const config = await getPackageJson(projectPath);
+
+    const res = await postClass(
+        config.setupSvc + "/api/layout/queryPageLayout",
+        {
+            prefix: objApiName
+        },
+        config.accessToken
+    );
+
+    if (res && res.result) {
+        const layouts = res.layouts || [];
+        if (!isMcp) {
+            console.log(JSON.stringify(layouts));
+        }
+        return layouts;
+    }
+
+    const msg = res && (res.returnInfo || res.message) ? (res.returnInfo || res.message) : "Unknown error";
+    throw new Error("Get PageLayout Failed: " + msg);
+}
+
+module.exports = get;

package/src/pagelayout/index.js

@@ -0,0 +1,9 @@
+const cc = {}
+cc.create = require("./create")
+cc.get = require("./get")
+cc.doc = require("./doc")
+async function main(action, argvs) {
+  await cc[action](argvs)
+}
+
+module.exports = main;