# 台账视图按钮显示位置 用于将已有系统按钮或自定义按钮显示在指定视图的行上、行末下拉或顶部。配置的是按钮 `showPosition`，与整行点击的 `form list-event`、字段点击的 `form list-click` 独立。 ## 查询与设置 ```bash e10-cli form button list e10-cli form button views e10-cli form button position --view --position 行上 ``` `views` 返回平台 `getViewDatas` 对此按钮开放的视图，以及现有位置配置。`--view` 支持视图 ID、唯一名称、表单页语义“新建/编辑/显示”；多个同名视图必须用 ID。省略视图或使用“台账”时，必须只有一个可选台账，否则拒绝保存。 | 显示位置 | 平台值 | |---|---| | 右上 | `rightTop` | | 右上下拉 | `rightTopDropDown` | | 行上（行内） | `lineEnd` | | 行末下拉 | `LineEndDropDown` | 行上、行末下拉只适用于台账，不适用于表单新建/编辑/显示页。 ## 多视图及替换语义 普通设置默认合并：仅更新指定视图，保留其余台账及表单页的位置。同一视图的旧位置数组由此次指定的位置数组替换；需要多位置时一次传齐。 ```bash e10-cli form button position --view --position 行上 右上 e10-cli form button position --show-position @button-positions.json ``` 不同视图使用不同位置时，JSON 文件示例（将 ID 占位替换为实际值）： ```json { "_table": ["lineEnd"], "_table": ["LineEndDropDown"], "show_form": ["rightTop"], "edit_form": ["rightTopDropDown"] } ``` `--show-position` 也默认合并，不能与 `--position/--view` 同时使用。显式 `--replace` 才替换全部页面配置；未列出的页面不再显示该按钮。`--show-position '{}' --replace` 清空所有显示位置。 新建自定义按钮也支持 `form button add ... --view --position 行上`。按钮点击动作仍由原有动作配置决定；改变显示位置不会自动添加行数据参数。 ## 打开页面与当前行字段映射 按钮可以打开固定 URL、平台视图或表单布局；流程快捷入口本质上打开流程绑定表单的“新建布局”。四种目标参数互斥： ```bash # 打开目标视图并按当前行过滤：目标字段 ← 来源字段 e10-cli form button add "查看明细" --open-view <视图名或viewId> --map "关联主表:数据ID" --view <来源视图> --position 行上 # 打开表单新建/编辑/显示布局并预填，可通过 --target-app 跨应用 e10-cli form button add "新建明细" --open-layout <目标表名或objId> --layout-type 新建 --map "关联主表:数据ID" --view <来源视图> --position 行上 # 发起当前应用内流程；内部解析流程绑定表单并打开新建布局 e10-cli form button add "发起申请" --start-workflow <流程名或workflowId> --map "关联主表:数据ID" --view <来源视图> --position 行上 # 无当前行参数的顶部入口 e10-cli form button add "发起申请" --start-workflow <流程> --view <来源视图> --position 右上 ``` `--map` 可连续传多项，字段两端均支持唯一名称或 ID。视图动作生成原生 `VIEWPORT + autoFillParams`，布局动作生成 `LAYOUT + paramsMode=2`，不是拼固定 URL。EBuilder 目标字段通常映射来源“数据ID”。行上/行末下拉存在当前行上下文，可以使用映射；右上/右上下拉没有确定的单行上下文，禁止使用 `--map`。 更新已有按钮动作而不改变位置和权限： ```bash e10-cli form button action-set --open-view <视图> --map "关联主表:数据ID" ``` 当前仅管理一个 `openpage` 动作，不用于复杂多动作编排。`--start-workflow` 暂只解析当前应用内流程；跨应用普通视图/布局使用 `--target-app`。 ## 按钮基础属性 `form button set` 改按钮的展示配置，**已有的动作和权限原样保留**： ```bash # 名称 / 提示内容 / 备注 e10-cli form button set --name "提交" --tips "请确认数据无误" --desc "业务备注" # 图标（存的是 JSON 串，命令负责拼装） e10-cli form button set --icon Icon-N-Offer-management --icon-display line e10-cli form button set --icon Icon-N-Offer-management --icon-color "#ff0000" --icon-bg "#ffffff" e10-cli form button set --icon-none # 清空图标 e10-cli form button set --only-icon # 只显示图标 # 点击日志 e10-cli form button set --no-log e10-cli form button set --log --log-message "提交了单据" ``` `--icon-display` 取 `line`（描边）或 `fill`（填充）；只改颜色/描边时按钮必须已有图标。 ### 数据过滤 按钮的「数据过滤」决定**列表里哪些行**受该按钮影响，条件语法与 `form list-filter` **完全一致**： ```bash e10-cli form button set --add '{"conditions":[{"fieldId":"","func":"contains","value":"abc"}]}' e10-cli form button set --replace @cond.json e10-cli form button set --remove e10-cli form button set --relation or e10-cli form button set --clear-filter ``` `--add` 叠加、`--replace` 整体覆盖、`--remove` 按字段摘、`--relation` 只调顶层关系，同名同义。启用数据过滤时开关 `conditionEnable` 自动置 1，`--clear-filter` 置回 0。另有 `--disable-condition` / `--clear-disable-condition` 管「禁用条件」。 `form button add` 建按钮时也能一次带上：`--tips --desc --icon --only-icon --no-log --log-message --data-filter`。 ## 按钮权限 「按钮权限」管**哪些人能看见并点击这个按钮**，与表单共享权限是两套： ```bash e10-cli form button permission # 列出 e10-cli form button permission --add-all e10-cli form button permission --add-company 某分部 --contain-extra e10-cli form button permission --add-department 某部门 e10-cli form button permission --add-people 某人 e10-cli form button permission --remove 1 # 序号（从 1 起）或权限 id e10-cli form button permission --clear ``` 授权对象支持**全体 / 分部 / 部门 / 人员**四类，主体可写名称或 ID。名称要求精确同名，撞名会报错并列出候选 id；取不到显示名也会直接报错，不会写入一条空名字。`--contain-extra` 表示含下级。其余授权对象类型本轮不支持，遇到会当场报错而不是写错。 未配置过权限的按钮，平台会保留一条「全体」。保存后按**集合**回读核对（平台会重排顺序，不比数组顺序）。 ## 按钮动作（可挂多个） 一个按钮可以挂**多个**动作。`form button action` 负责增删查： ```bash e10-cli form button action # 列出（序号 / 类型 / 摘要） e10-cli form button action --remove 2 # 按序号或动作 id e10-cli form button action --clear # 清空自定义动作 ``` 追加动作（同一次命令里按 打开页面 → 确认框 → JavaScript → 编辑字段值 → 触发逻辑流 的顺序追加，可一次给多种）： | 动作 | 用法 | |---|---| | 打开页面（URL） | `--add-url [--page-type LINK\|CUSTOMPAGE] [--map "参数名:来源字段"]` | | 打开页面（视图 / 布局 / 流程） | `--add-view <视图>`、`--add-layout <表单> [--layout-type 新建\|编辑\|显示]`、`--add-start-workflow <流程>`，共用 `--map "目标字段:来源字段"` | | 确认框 | `--add-confirm --confirm-title <标题> --confirm-content <正文> [--confirm-true <文案>] [--confirm-false <文案>]` | | JavaScript | `--add-js --code <源码\|@文件>` | | 编辑字段值 | `--add-edit-field "字段:值"`（可多个；字段写 fieldId 或字段标题） | | 触发逻辑流 | `--add-logic <逻辑流名或ID> [--logic-ecode-id ]` | `--open-type` 管打开方式：`1` 弹窗 / `2` 当前页 / `3` 新窗口。 ### 使用说明与边界 - **编辑字段值**本轮只支持「赋固定值」。同一次命令里多次 `--add-edit-field` 会并进同一条动作（按字段去重，同字段后写的覆盖先写的）；按钮上已有该动作时会并入它，不会多出一条。 - **触发逻辑流**只做绑定，**不生成**逻辑流。按名称解析要求精确同名，撞名报错并列出候选。`ecodeId` 可用 `--logic-ecode-id` 指定；不给时沿用该按钮上已有的绑定值，都没有则留空。 - **JavaScript** 源码建议用 `--code @文件` 传入，避免命令行转义把脚本弄坏。 - `action-set` 是早期只支持单一打开页面动作的命令，**已标记废弃**，等价于 `action --clear --add-view …`；仍可用，但新需求请用 `form button action`。 保存沿用「读回为底 → 只覆盖本次要改的部分 → 写 → 回读」：改动作时权限原样保留，改属性或权限时动作原样保留，互不冲掉。改完若提示回读不一致，远端可能已被改动，先重新查询再处理。 ## 保存与验证 命令先分页查找按钮，再读取动作、权限和可选视图。提交时保留按钮基础配置、完整动作和权限，及接口返回的日志/自定义提示设置，并按视图实际名称重建 `showPositionSpan`。 保存后回读按钮位置并核对动作、权限 ID 集合；成功输出 `verified: true`。若提示“已保存，但回读不一致”，远端可能已修改，必须先重新查询再处理。该验证属于配置回读，不代表已验证按钮点击行为或浏览器渲染。 计划模板 3.3 中必须记录：按钮名称/ID、来源视图名称/ID、显示位置、目标类型与名称/ID、每条“目标字段 ← 来源字段”映射、验证结果。只有需求涉及按钮展示时才填写，无需求标“— 无”。系统删除按钮测试仅核对配置和显示，不点击删除业务数据。