// 宜搭数据管理。表单实例/流程实例/任务中心的查询、新增、更新。表单走 /v1/form/，流程走 /v1/process/，不能混用。
| name | yida-data-management |
| description | 宜搭数据管理。表单实例/流程实例/任务中心的查询、新增、更新。表单走 /v1/form/，流程走 /v1/process/，不能混用。 |
yida-create-form-pagetextField_eftt1aa5m），无法预测，必须通过 openyida get-schema 获取openyida get-schema 获取真实字段 ID，并将字段 ID 映射记录到 .cache/<项目名>-schema.jsonDateField / CascadeDateField 必须使用 13 位毫秒时间戳（如 1719705600000），不要传 YYYY-MM-DD、YYYY-MM-DD HH:mm:ss 或 ISO 字符串openyida data query 抽查至少 1 条记录，确认 formData 中字段有实际值（非空），否则说明字段 ID 有误，需重新排查.cache/openyida/ 下，并复用真实查询到的 appType/formUuid/fieldId/formInstId*.json、*.js、*.py、*.csv 临时文件；推荐使用 .cache/openyida/data-import/ 存放数据文件，.cache/openyida/scripts/ 存放一次性执行脚本用户需要"查询数据"、"新增记录"、"更新数据"、"查看表单实例"、"发起流程"时使用。
关键区分：
yida-create-form-page/v1/form/）vs 流程接口（/v1/process/）不能混用正向触发：
不适用场景（不要触发）：
yida-create-form-pageyida-integrationyida-get-schema/v1/form/）和流程接口（/v1/process/）不能混用删除数据记录为不可逆操作，执行前必须：
表单与流程是两套独立接口，主键、参数、返回结构都不同，不能混用。
openyida data query form <appType> <formUuid> [--page 1 --size 20] [--search-json '<json>'|--search-file .cache/openyida/data-import/search.json] [--resolve-aliases]
openyida data get form <appType> --inst-id <formInstId>
openyida data create form <appType> <formUuid> --data-json '<json>' [--resolve-aliases]
openyida data create form <appType> <formUuid> --data-file .cache/openyida/data-import/record.json [--resolve-aliases]
openyida data update form <appType> --inst-id <formInstId> --form-uuid <formUuid> --data-json '<json>' [--resolve-aliases]
openyida data update form <appType> --inst-id <formInstId> --form-uuid <formUuid> --data-file .cache/openyida/data-import/patch.json [--resolve-aliases]
openyida data query subform <appType> <formUuid> --inst-id <formInstId> --table-field-id <fieldId|alias> [--resolve-aliases]
当 JSON 使用宜搭组件别名作为 key 时，追加 --resolve-aliases，OpenYida 会先读取表单 Schema 中的 componentAlias.items，再将别名转换为真实 fieldId 后调用数据接口。更新类命令若要解析别名，必须额外传 --form-uuid <formUuid>。
openyida data query process <appType> <formUuid> [--instance-status RUNNING] [--search-file .cache/openyida/data-import/process-search.json] [--resolve-aliases]
openyida data get process <appType> --process-inst-id <processInstanceId>
openyida data create process <appType> <formUuid> --process-code <processCode> --data-json '<json>' [--resolve-aliases]
openyida data create process <appType> <formUuid> --process-code <processCode> --data-file .cache/openyida/data-import/process-record.json [--resolve-aliases]
openyida data update process <appType> --process-inst-id <processInstanceId> --form-uuid <formUuid> --data-json '<json>' [--resolve-aliases]
openyida data update process <appType> --process-inst-id <processInstanceId> --form-uuid <formUuid> --data-file .cache/openyida/data-import/process-patch.json [--resolve-aliases]
openyida data query operation-records <appType> --process-inst-id <processInstanceId>
openyida data execute task <appType> --task-id <taskId> --process-inst-id <processInstanceId> --out-result AGREE --remark '同意' [--data-file .cache/openyida/data-import/task-data.json] [--form-uuid <formUuid>] [--resolve-aliases]
openyida data query tasks <appType> --type todo|done|submitted|cc [--page 1 --size 20]
| 接口 | 方法 | 说明 |
|---|---|---|
searchFormDatas | GET | 查询列表 |
searchFormDataIds | GET | 查询 ID 列表 |
getFormDataById | GET | 查询详情 |
saveFormData | POST | 新增 |
updateFormData | POST | 更新 |
listTableDataByFormInstIdAndTableId | GET | 查询子表数据 |
| 接口 | 方法 | 说明 |
|---|---|---|
startProcessInstance | POST | 发起流程 |
getInstanceIds | GET | 查询 ID 列表 |
getInstances | GET | 查询列表 |
getInstanceById | GET | 查询详情 |
updateInstance | POST | 更新 |
getOperationRecords | GET | 审批记录 |
executeTask | POST | 执行任务 |
| 接口 | 说明 |
|---|---|
getTodoTasksInApp | 待办 |
getDoneTasksInApp | 已完成 |
getMySubmitInApp | 已提交 |
getNotifyMeTasksInApp | 抄送 |
searchFieldJson必须传字符串：
[{"key":"textField_xxx","value":"测试","type":"TEXT","operator":"eq","componentName":"TextField"}]
{"textField_xxx":"文本","numberField_xxx":10,"dateField_xxx":1719705600000,"employeeField_xxx":["userId"]}
当 JSON 较长或用于批量导入时，写入 .cache/openyida/data-import/<name>.json，再使用 --data-file 或 --search-file；不要为了拼接命令在仓库根目录生成临时脚本。
| 组件类型 | 查询格式 | 保存格式 |
|---|---|---|
| 文本 | "文本" | "文本" |
| 数字 | ["1","10"] 或单值 | 1 |
| 单选 | "选项一" | "选项一" |
| 多选 | ["选项一"] | ["选项一","选项二"] |
| 日期 | [开始毫秒时间戳,结束毫秒时间戳] | 13 位毫秒时间戳 |
| 成员 | ["userId"] | ["userId"] |
| 部门 | ["deptId"] | ["deptId"] |
| 子表 | "模糊搜索" | [{"textField_xxx":"值"}] |
| 关联表单 | 不支持直接查询 | [{"appType":"xxx","formUuid":"xxx","instanceId":"xxx"}] |
DateField 保存/更新值必须是 13 位毫秒时间戳，例如 1719705600000。CascadeDateField 保存/更新值必须是毫秒时间戳数组，例如 [1719705600000,1722384000000]。new Date('2024-06-30T00:00:00+08:00').getTime() 或等价方式转换，不要直接写 "2024-06-30"。openyida data create form APP_xxx FORM-xxx --data-json '{
"textField_xxx": "测试记录",
"dateField_xxx": 1719705600000,
"cascadeDateField_xxx": [1719705600000,1722384000000]
}'
关联表单字段保存时必须使用数组对象格式，包含三个必填字段：
# 示例：创建带关联客户的商机
openyida data create form APP_xxx FORM-商机表 --data-json '{
"textField_xxx": "商机名称",
"associationFormField_xxx": [{"appType":"APP_xxx","formUuid":"FORM-客户表","instanceId":"FINST-xxx"}]
}'
注意：字段名是
instanceId（不是 formInstId），三个字段缺一不可
需要参考表单字段定义和数据插入写法时，执行以下命令获取示例，再用
read_file读取：
openyida sample yida-data-management form-field-template # 表单字段定义模板（字段类型/必填/选项配置）及数据插入示例
pageSize 最大 100，QPS 限制约 40 次/秒searchFieldJson 和 dynamicOrder 必须传字符串openyida get-schema 获取，不要手写猜测subprocess 调用 openyida data ...，也可以用 JS 复用 Node 工具；脚本必须放在 .cache/openyida/scripts/，导入数据放在 .cache/openyida/data-import/| 异常场景 | 处理方式 |
|---|---|
| 查询返回空结果 | 确认 formUuid 正确，检查查询条件是否过于严格 |
| 新增数据后字段值为空 | 字段 ID 有误，先执行 openyida get-schema 获取真实 fieldId |
| 更新失败（formInstId 不存在） | 先用 query 命令确认记录存在，不要猜测 formInstId |
| 接口返回 401/未登录 | 执行 openyida login 重新登录 |
| QPS 超限（429） | 降低请求频率，批量操作单次不超过 30 条 |
| 删除操作误删 | 删除前必须展示操作摘要并获得用户明确确认，不可逆操作 |
| 流程接口用了表单接口路径 | 检查接口路径：表单用 /v1/form/，流程用 /v1/process/ |
当 Agent 执行本技能遇到错误时，必须遵循以下默认行为：
| 错误类型 | 默认处理策略 |
|---|---|
| 命令执行失败 | 停止执行，向用户展示错误信息，询问是否重试或调整参数 |
| 参数缺失（appType/formUuid/fieldId 等） | 主动询问用户补充，或引导用户使用 yida-get-schema 获取 |
| 权限不足 / 登录态失效 | 停止执行，提示用户执行 openyida login 重新登录 |
| 字段 ID 无效 | 停止执行，引导用户执行 openyida get-schema 获取真实字段 ID |
| 删除操作前 | 必须先展示操作摘要（数量 + 关键字段），等待用户明确确认 |
| QPS 超限 | 降低请求频率，单次批量操作不超过 30 条，间隔 1 秒重试 |
| 表单/流程接口混用 | 停止执行，提示用户检查接口类型（表单用 /v1/form/，流程用 /v1/process/） |
| 网络超时 | 重试 1 次，仍失败则停止并提示用户检查网络 |
| 未知错误 | 停止执行，完整展示错误信息，建议用户反馈问题 |
宜搭 AI 应用开发总入口技能。通过有 AI Coding 能力的智能体（悟空/Claude/Open Code 等）+ 宜搭低代码平台，实现一句话生成完整应用。 包含应用创建、表单设计、自定义页面开发、页面发布、登录态管理等完整开发流程。 当用户提到"宜搭"、"yida"、"低代码"、"创建应用"、"创建表单"、"发布页面"、"搭建"、"系统"等关键词时，使用此技能；以下情况不要触发：只是讨论通用前端/后端代码、非宜搭平台产品、或只需要解释概念而不操作宜搭资源。
页面公开访问和组织内分享配置。支持 URL 验证、配置保存、导航显示控制。不适用于：配置表单数据权限（应使用 yida-form-permission），或修改页面代码内容（应使用 yida-custom-page + yida-publish-page）。
宜搭 HTTP 连接器执行动作安全生成与修复。适用于从前端 API 文件、后端 Controller/接口定义生成 OpenYida 连接器操作，或修复“点击测试后报错、所有操作消失”的连接器动作配置问题。不适用于创建连接器本体（应使用 yida-connector），也不适用于配置集成自动化逻辑流（应使用 yida-integration）。
宜搭 ECharts 高级报表技能。通过 ECharts + 自定义页面 JSX 实现高度定制化、更美观的数据可视化报表。本技能不负责创建宜搭原生报表（标准报表由 yida-report 技能负责），但 ECharts 报表必须依赖宜搭原生报表的 getDataAsync.json 或 getCacheData.json 接口获取聚合数据，禁止前端聚合。当用户提到「更美观」「高级」「定制化」「ECharts」「echarts」「Dashboard 大屏」「数据大屏」等关键词，或用户提供了报表 URL 要求优化时，使用此技能。普通的「报表」「统计」等需求默认由 yida-report 技能处理。
宜搭流程表单一体化创建。整合创建表单 → 转流程表单 → 获取 processCode → 配置流程四步为一步，流程定义格式与 yida-process-rule 完全一致，支持审批/办理/抄送、条件/并行分支、跳转规则，以及官方组件节点配置透传和 processJson 适配。不适用于：已有流程表单只需修改审批规则（应使用 yida-process-rule），或只需创建普通表单无审批（应使用 yida-create-form-page）。
宜搭自定义页面 JSX 开发规范。React 16 宜搭原生 export function 页面模式，宜搭 JS API 调用，状态管理与编码约束。不适用于：原生表单页面开发（无需 JSX），或发布页面（编写完成后需使用 yida-publish-page 发布）。