cloudcc-cli 2.3.8 → 2.3.9

package/src/fields/fields/Q.js

@@ -1,35 +1,65 @@
 /**
- * 选项列表（多选）字段(Q)配置模板
+ * 选项列表（多选）字段(Q)配置模板（与 `L` 类似，另含 `visibleLines`、`showalloptions`）
+ * @param {string} useGlobalSelect 是否使用全局选项列表：`"0"` 否，`"1"` 是
+ * @param {string} edittype 选择样式，写入 `obj.edittype`：`radio` 或 `select`（多选常见为 `select`）
+ * @param {string} isPicklistSorted 是否按字母排序：`"0"` 否，`"1"` 是
+ * @param {string} defPl 是否将第一个值作为默认值：`"0"` 否，`"1"` 是
+ * @param {string} globalSelectId 全局选项列表 id（`useGlobalSelect` 为 `"1"` 时使用）
+ * @param {string} visibleLines 下拉最多展示几行选项，写入 `obj.visibleLines`
+ * @param {string} showalloptions 是否显示所有选项：`"0"` 否，`"1"` 是，写入 `obj.showalloptions`
  */
-module.exports = function (objid, nameLabel, apiname, ptext, profileList) {
+module.exports = function (
+    objid,
+    nameLabel,
+    apiname,
+    ptext,
+    helps = "",
+    defaultValue = "",
+    profileList,
+    useGlobalSelect = "0",
+    edittype = "select",
+    isPicklistSorted = "0",
+    defPl = "0",
+    globalSelectId = "",
+    visibleLines = "4",
+    showalloptions = "0"
+) {
+    const ugs = useGlobalSelect === "1" ? "1" : "0";
+    const et = edittype === "radio" ? "radio" : "select";
+    const sorted = isPicklistSorted === "1" ? "1" : "0";
+    const dp = defPl === "1" ? "1" : "0";
+    const gid = ugs === "1" ? String(globalSelectId || "").trim() : "";
+    const vl = String(visibleLines || "4").trim() || "4";
+    const sao = showalloptions === "1" ? "1" : "0";
     return {
-        "objid": objid,
         "obj": {
             "id": "",
             "nameLabel": nameLabel,
             "apiname": apiname,
             "schemefieldLength": "255",
-            "edittype": "select",
-            "visibleLines": "4",
-            "showalloptions": "0",
+            "edittype": et,
+            "visibleLines": vl,
+            "showalloptions": sao,
             "renderstyle": "1",
             "remark": "",
-            "helps": ""
+            "helps": helps !== undefined && helps !== null ? String(helps) : "",
+            "defaultValue": defaultValue !== undefined && defaultValue !== null ? String(defaultValue) : ""
         },
+        "objid": objid,
         "dtype": "Q:选项列表（多选）",
         "fdtype": "Q",
         "ischecked": "false",
-        "useGlobalSelect": "0",
-        "globalSelectId": "province",
+        "useGlobalSelect": ugs,
+        "globalSelectId": gid,
         "ptext": ptext,
-        "isPicklistSorted": "0",
-        "defPl": "1",
+        "isPicklistSorted": sorted,
+        "defPl": dp,
         "iscover": "",
         "formulaText": "",
         "profileFieldJson": profileList.map(profile => ({
             "profileId": profile.id,
             "visible": "true",
             "readonly": "false"
-        })),
+        }))
     }
 }

package/src/fields/fields/S.js

@@ -1,7 +1,19 @@
 /**
  * 文本字段(S)配置模板
  */
-module.exports = function (objid, nameLabel, apiname, profileList) {
+module.exports = function (
+    objid,
+    nameLabel,
+    apiname,
+    schemefieldLength,
+    helps,
+    isrepeat,
+    casesensitive,
+    placeholder,
+    defaultValue,
+    profileList
+) {
+    const length = schemefieldLength ? String(schemefieldLength) : "255";
     return {
         "objid": objid,
         "obj": {
@@ -9,12 +21,12 @@ module.exports = function (objid, nameLabel, apiname, profileList) {
             "nameLabel": nameLabel,
             "apiname": apiname,
             "remark": "",
-            "helps": "",
-            "schemefieldLength": "255",
-            "isrepeat": "true",
-            "casesensitive": "",
-            "placeholder": "",
-            "defaultValue": ""
+            "helps": helps ? String(helps) : "",
+            "schemefieldLength": length,
+            "isrepeat": isrepeat !== undefined ? String(isrepeat) : "true",
+            "casesensitive": casesensitive ? String(casesensitive) : "",
+            "placeholder": placeholder ? String(placeholder) : "",
+            "defaultValue": defaultValue ? String(defaultValue) : ""
         },
         "dtype": "S:文本",
         "fdtype": "S",

package/src/fields/fields/SCORE.js

@@ -1,7 +1,12 @@
 /**
  * 评分字段(SCORE)配置模板
+ * schemefieldLength：最大评分，控制星星图标个数；平台允许 1～100，默认 10
  */
-module.exports = function (objid, nameLabel, apiname, profileList) {
+module.exports = function (objid, nameLabel, apiname, helps = "", defaultValue = "", schemefieldLength = "10", profileList) {
+    const len =
+        schemefieldLength !== undefined && schemefieldLength !== null && String(schemefieldLength).trim() !== ""
+            ? String(schemefieldLength).trim()
+            : "10";
     return {
         "objid": objid,
         "obj": {
@@ -9,9 +14,9 @@ module.exports = function (objid, nameLabel, apiname, profileList) {
             "nameLabel": nameLabel,
             "apiname": apiname,
             "remark": "",
-            "helps": "",
-            "schemefieldLength": "10",
-            "defaultValue": ""
+            "helps": helps !== undefined && helps !== null ? String(helps) : "",
+            "schemefieldLength": len,
+            "defaultValue": defaultValue !== undefined && defaultValue !== null ? String(defaultValue) : ""
         },
         "dtype": "SCORE:评分",
         "fdtype": "SCORE",

package/src/fields/fields/T.js

@@ -1,17 +1,17 @@
 /**
  * 时间字段(T)配置模板
  */
-module.exports = function (objid, nameLabel, apiname, profileList) {
+module.exports = function (objid, nameLabel, apiname, helps = "", defaultValue = "", profileList) {
     return {
         "objid": objid,
         "obj": {
             "id": "",
             "nameLabel": nameLabel,
             "apiname": apiname,
-            "schemefieldLength": "255",
             "remark": "",
-            "helps": "",
-            "defaultValue": ""
+            "helps": helps !== undefined && helps !== null ? String(helps) : "",
+            "schemefieldLength": "20",
+            "defaultValue": defaultValue !== undefined && defaultValue !== null ? String(defaultValue) : ""
         },
         "dtype": "T:时间",
         "fdtype": "T",

package/src/fields/fields/U.js

@@ -1,18 +1,31 @@
 /**
  * URL字段(U)配置模板
  */
-module.exports = function (objid, nameLabel, apiname, profileList) {
+module.exports = function (objid, nameLabel, apiname, helps, edittype, defaultValue, profileList) {
+    const openMode = edittype && String(edittype).trim() !== ""
+        ? String(edittype).trim()
+        : "_blank";
+    const safeEdittype = openMode === "_self" ? "_self" : "_blank";
     return {
+        // 对象ID
         "objid": objid,
         "obj": {
+            // 字段ID
             "id": "",
+            // 字段名称
             "nameLabel": nameLabel,
+            // 字段API名称
             "apiname": apiname,
+            // 字段备注
             "remark": "",
-            "helps": "",
-            "edittype": "_blank",
-            "schemefieldLength": "255",
-            "defaultValue": ""
+            // 字段帮助
+            "helps": helps !== undefined && helps !== null ? String(helps) : "",
+            // 最大输入长度（字符）
+            "schemefieldLength": "2000",
+            // URL打开方式: _blank 新窗口打开, _self 当前窗口打开
+            "edittype": safeEdittype,
+            // 默认值
+            "defaultValue": defaultValue !== undefined && defaultValue !== null ? String(defaultValue) : ""
         },
         "dtype": "U:URL",
         "fdtype": "U",

package/src/fields/fields/X.js

@@ -1,7 +1,21 @@
 /**
- * 文本区字段(X)配置模板
+ * 文本区字段(X)配置模板（多行文本，schemefieldLength 为最大字符数，常见上限 4000）
  */
-module.exports = function (objid, nameLabel, apiname, profileList) {
+module.exports = function (
+    objid,
+    nameLabel,
+    apiname,
+    helps = "",
+    defaultValue = "",
+    schemefieldLength = "4000",
+    placeholder = "",
+    profileList
+) {
+    const len =
+        schemefieldLength !== undefined && schemefieldLength !== null && String(schemefieldLength).trim() !== ""
+            ? String(schemefieldLength).trim()
+            : "4000";
+    const ph = placeholder !== undefined && placeholder !== null ? String(placeholder) : "";
     return {
         "objid": objid,
         "obj": {
@@ -9,10 +23,10 @@ module.exports = function (objid, nameLabel, apiname, profileList) {
             "nameLabel": nameLabel,
             "apiname": apiname,
             "remark": "",
-            "helps": "",
-            "defaultValue": "",
-            "schemefieldLength": "255",
-            "placeholder": ""
+            "helps": helps !== undefined && helps !== null ? String(helps) : "",
+            "defaultValue": defaultValue !== undefined && defaultValue !== null ? String(defaultValue) : "",
+            "schemefieldLength": len,
+            "placeholder": ph
         },
         "dtype": "X",
         "fdtype": "X",

package/src/fields/fields/Y.js

@@ -1,7 +1,21 @@
 /**
  * 查找关系字段(Y)配置模板
+ * @param {string} lookupObjDefaultField 搜索辅助字段（`obj.lookupObjDefaultField`）；搜索时用于展示，可为 API 名字段等
  */
-module.exports = function (objid, nameLabel, apiname, lookupObj, profileList) {
+module.exports = function (
+    objid,
+    nameLabel,
+    apiname,
+    lookupObj,
+    helps = "",
+    defaultValue = "",
+    profileList,
+    lookupObjDefaultField = ""
+) {
+    const ldf =
+        lookupObjDefaultField !== undefined && lookupObjDefaultField !== null
+            ? String(lookupObjDefaultField).trim()
+            : "";
     return {
         "objid": objid,
         "obj": {
@@ -10,11 +24,10 @@ module.exports = function (objid, nameLabel, apiname, lookupObj, profileList) {
             "apiname": apiname,
             "schemefieldLength": "255",
             "remark": "",
-            "helps": "",
+            "helps": helps !== undefined && helps !== null ? String(helps) : "",
             "lookupObj": lookupObj,
-            "defaultValue": "",
             "childrelationName": nameLabel,
-            "lookupObjDefaultField": ""
+            "lookupObjDefaultField": ldf
         },
         "dtype": "Y:查找关系",
         "fdtype": "Y",

package/src/fields/index.js

@@ -1,6 +1,8 @@
 const cc = {}
 cc.get = require("./get")
+cc.detail = require("./detail")
 cc.create = require("./create")
+cc.update = require("./update")
 cc.delete = require("./delete")
 cc.doc = require("./doc")
 

package/src/fields/update.js

@@ -0,0 +1,148 @@
+const fs = require("fs");
+const path = require("path");
+const { postClass } = require("../../utils/http")
+const { getPackageJson } = require("../../utils/config");
+const chalk = require('chalk')
+const { buildFieldData } = require("./buildFieldData");
+
+/**
+ * 在 object/custom-objects 与 object/standard-objects 中按对象 id 查找 objprefix（供 queryField 使用）
+ */
+function findObjPrefixForObjId(projectPath, objid) {
+    if (!objid || String(objid).trim() === "") return null;
+    const roots = [
+        path.join(path.resolve(projectPath), "object/custom-objects"),
+        path.join(path.resolve(projectPath), "object/standard-objects"),
+    ];
+    for (const dir of roots) {
+        if (!fs.existsSync(dir)) continue;
+        let files;
+        try {
+            files = fs.readdirSync(dir);
+        } catch (_) {
+            continue;
+        }
+        for (const f of files) {
+            if (!f.endsWith(".json")) continue;
+            const fp = path.join(dir, f);
+            try {
+                const j = JSON.parse(fs.readFileSync(fp, "utf8"));
+                if (j && j.id === objid && j.objprefix) return String(j.objprefix).trim();
+            } catch (_) {}
+        }
+    }
+    return null;
+}
+
+/**
+ * saveField 需要与平台上已有字段一致的元数据（如 datafieldRef、schemetableId）。
+ * 在发起 saveField 前，用 queryField 拉取当前字段并合并进 payload。
+ */
+async function mergeUpdatePayloadFromServer(config, projectPath, fieldId, objid, fieldData) {
+    const prefix = findObjPrefixForObjId(projectPath, objid);
+    if (!prefix) {
+        console.error(
+            chalk.yellow(
+                "⚠ cloudcc update fields: 未在 object/custom-objects 或 object/standard-objects 中找到 objid=" +
+                    objid +
+                    " 的 objprefix；请先执行 cloudcc get object 同步对象清单后再试。"
+            )
+        );
+        if (fieldData.obj) fieldData.obj.schemetableId = String(objid).trim();
+        return;
+    }
+    const res = await postClass(
+        config.setupSvc + "/api/fieldSetup/queryField",
+        { prefix },
+        config.accessToken
+    );
+    if (!res || !res.result || !res.data) return;
+    const pool = [...(res.data.stdFields || []), ...(res.data.cusFields || [])];
+    const raw = pool.find((f) => f && f.id === fieldId);
+    if (!fieldData.obj) return;
+    fieldData.obj.schemetableId = String(objid).trim();
+    if (raw && raw.datafieldRef) fieldData.obj.datafieldRef = String(raw.datafieldRef);
+    if (raw && (raw.schemefieldName || raw.apiname)) {
+        fieldData.obj.apiname = String(raw.schemefieldName || raw.apiname);
+    }
+    if (raw && Array.isArray(raw.profileFieldJson) && raw.profileFieldJson.length > 0) {
+        fieldData.profileFieldJson = raw.profileFieldJson;
+    }
+    if (fieldData.layoutIds === undefined) fieldData.layoutIds = "";
+}
+
+/**
+ * create 使用 save，简档为 profileId + visible + readonly；saveField 需 profileid + permission。
+ */
+function normalizeProfileFieldJsonForSaveField(fieldData) {
+    if (!fieldData || !Array.isArray(fieldData.profileFieldJson)) return;
+    fieldData.profileFieldJson = fieldData.profileFieldJson
+        .map((row) => {
+            const pid = row.profileid || row.profileId;
+            if (!pid) return null;
+            if (row.permission != null && String(row.permission) !== "") {
+                return { profileid: String(pid), permission: String(row.permission) };
+            }
+            return { profileid: String(pid), permission: "1,0" };
+        })
+        .filter(Boolean);
+}
+
+/**
+ * 更新字段（与 create 共用同一套 payload 与类型分支；区别在于必须设置 `obj.id` 为字段 ID，且不请求 layout 绑定）
+ * @param {Array} argvs - 命令行参数数组
+ * @param {string} argvs[2] projectPath
+ * @param {string} argvs[3] fieldId（平台字段 id）
+ * @param {string} argvs[4] fieldType
+ * @param {string} argvs[5] objid
+ * @param {string} argvs[6] nameLabel
+ * @param {string} argvs[7] remark（与 create 相比各类型可选参数整体下标 +1）
+ * @returns {Promise<boolean>}
+ */
+async function update(argvs) {
+    try {
+        let projectPath = argvs[2];
+        const fieldId = argvs[3];
+        if (!fieldId || String(fieldId).trim() === "") {
+            throw new Error("Missing field id: argvs[3] (field id from platform)");
+        }
+        const config = await getPackageJson(projectPath);
+        let nameLabel = argvs[6];
+        let remarkText = argvs[7];
+        if (!remarkText) remarkText = "auto created by cloudcc-cli ai agent";
+        console.error(chalk.blue('\nUpdating field ' + nameLabel + ' (id=' + fieldId + ')...'));
+        let fieldData = await buildFieldData(argvs, { shift: 1 });
+        if (!fieldData) {
+            throw new Error("Unsupported or unknown fieldType for update");
+        }
+        if (fieldData.obj) fieldData.obj.id = String(fieldId).trim();
+        if (fieldData && fieldData.obj) fieldData.obj.remark = remarkText;
+        if (fieldData) fieldData.remark = remarkText;
+
+        const objid = argvs[5];
+        await mergeUpdatePayloadFromServer(config, projectPath, fieldId, objid, fieldData);
+        normalizeProfileFieldJsonForSaveField(fieldData);
+
+        const result = await postClass(
+            config.setupSvc + "/api/fieldSetup/saveField",
+            fieldData,
+            config.accessToken
+        );
+
+        if (result && result.result) {
+            const okId = result.data && (typeof result.data === "string" || typeof result.data === "number")
+                ? result.data
+                : (result.data && result.data.id) || fieldId;
+            console.error(chalk.green('✓ Field updated successfully! ID: ' + okId));
+            return true;
+        } else {
+            console.error(chalk.yellow('⚠ Field update completed with warnings: ' + (result && result.returnInfo)));
+            return false;
+        }
+    } catch (error) {
+        console.error(chalk.red("Failed to update field: "), error.message || error);
+        return false;
+    }
+}
+
+module.exports = update;

package/test/fields.cli.test.js

@@ -21,6 +21,7 @@ test("字段管理流程：获取对象列表→create 字段→get 字段列表
   let objId = null;
   let objName = null;
   const fieldLabel = `AutoField_${Date.now()}`;
+  const fieldRemark = `AutoFieldRemark_${Date.now()}`;
   let fieldId = null;
 
   t.test("1) 获取对象列表（取第一个对象的 id 和 objprefix）", async () => {
@@ -45,7 +46,8 @@ test("字段管理流程：获取对象列表→create 字段→get 字段列表
   t.test("2) create 创建一个文本字段（S）", async () => {
     assert.ok(objId, "需要对象 id");
     // create fields 调用约定：cloudcc create fields <path> <fieldType> <objid> <nameLabel> [...]
-    const { stdout, stderr } = await runCc(["create", "fields", repoRoot, "S", objId, fieldLabel]);
+    // 统一规则：argvs[6] 作为 remark
+    const { stdout, stderr } = await runCc(["create", "fields", repoRoot, "S", objId, fieldLabel, fieldRemark]);
     // create fields 会通过 console.error 输出创建结果（见 src/fields/create.js）
     assert.match(
       `${stdout}\n${stderr}`,