@qingflow-tech/qingflow-cli 1.0.10 → 1.0.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -4
- package/docs/local-agent-install.md +54 -3
- package/entry_point.py +1 -1
- package/npm/bin/qingflow-skills.mjs +5 -0
- package/npm/bin/qingflow.mjs +7 -2
- package/npm/lib/runtime.mjs +304 -13
- package/npm/scripts/postinstall.mjs +1 -5
- package/package.json +3 -2
- package/pyproject.toml +1 -1
- package/skills/qingflow-cli/SKILL.md +431 -0
- package/skills/qingflow-cli/manifest.yaml +10 -0
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_ADMIN_CHEATSHEET.md +94 -0
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_BUILDER_APP_DELIVERY_WORKFLOW.md +432 -0
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_BUILDER_CHARTS_WORKFLOW.md +177 -0
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_BUILDER_MATCH_RULES.md +119 -0
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_BUILDER_PORTAL_WORKFLOW.md +200 -0
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_BUILDER_VIEWS_WORKFLOW.md +288 -0
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_BUILDER_WORKSPACE_ICONS.md +40 -0
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_DATA_RETRIEVAL_WORKFLOW.md +129 -0
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_EXPLORATION_REPORT.md +84 -0
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_FIELD_DATA_TYPES.md +129 -0
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_MEMBER_CHEATSHEET.md +196 -0
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_ONE_SHOT_CHEATSHEET.md +159 -0
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_RECORD_CREATE_WORKFLOW.md +14 -0
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_RECORD_IMPORT_WORKFLOW.md +150 -0
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_RECORD_UPDATE_WORKFLOW.md +163 -0
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_SCHEMA_APPLY_FIELD_TYPES_AND_SCENARIOS.md +95 -0
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_TASK_CONTEXT_WORKFLOW.md +150 -0
- package/skills/qingflow-cli/reference/_batch_schema_complex.json +18 -0
- package/skills/qingflow-cli/reference/_batch_schema_scalar.json +17 -0
- package/skills/qingflow-cli/reference/charts_remove.example.json +1 -0
- package/skills/qingflow-cli/reference/charts_reorder.example.json +1 -0
- package/skills/qingflow-cli/reference/charts_upsert_bar.example.json +8 -0
- package/skills/qingflow-cli/reference/charts_upsert_dashboard_starter.example.json +37 -0
- package/skills/qingflow-cli/reference/charts_upsert_minimal.example.json +13 -0
- package/skills/qingflow-cli/reference/portal_sections_all_types.example.json +131 -0
- package/skills/qingflow-cli/reference/portal_sections_five_types.example.json +106 -0
- package/skills/qingflow-cli/reference/schema_add_fields_minimal.example.json +7 -0
- package/skills/qingflow-cli/reference/schema_apply_add_fields_all_types.json +78 -0
- package/skills/qingflow-cli/reference/views_upsert_table_minimal.example.json +7 -0
- package/skills/qingflow-cli/scripts/builder-package-from-app-list.py +140 -0
- package/skills/qingflow-cli/scripts/find-app-by-keyword.py +132 -0
- package/skills/qingflow-mcp-setup/SKILL.md +113 -0
- package/skills/qingflow-mcp-setup/agents/openai.yaml +4 -0
- package/skills/qingflow-mcp-setup/references/claude-desktop.md +34 -0
- package/skills/qingflow-mcp-setup/references/environments.md +62 -0
- package/skills/qingflow-mcp-setup/references/generic-stdio.md +32 -0
- package/skills/qingflow-mcp-setup/scripts/check_local_server.sh +38 -0
- package/src/qingflow_mcp/__main__.py +6 -2
- package/src/qingflow_mcp/builder_facade/models.py +41 -2
- package/src/qingflow_mcp/builder_facade/service.py +2743 -423
- package/src/qingflow_mcp/cli/commands/app.py +3 -16
- package/src/qingflow_mcp/cli/commands/builder.py +30 -4
- package/src/qingflow_mcp/cli/commands/exports.py +2 -2
- package/src/qingflow_mcp/cli/commands/imports.py +1 -1
- package/src/qingflow_mcp/cli/commands/record.py +54 -11
- package/src/qingflow_mcp/cli/context.py +0 -3
- package/src/qingflow_mcp/cli/formatters.py +238 -8
- package/src/qingflow_mcp/cli/main.py +47 -3
- package/src/qingflow_mcp/errors.py +43 -2
- package/src/qingflow_mcp/public_surface.py +24 -16
- package/src/qingflow_mcp/response_trim.py +119 -12
- package/src/qingflow_mcp/server.py +17 -14
- package/src/qingflow_mcp/server_app_builder.py +29 -7
- package/src/qingflow_mcp/server_app_user.py +23 -24
- package/src/qingflow_mcp/solution/compiler/icon_utils.py +294 -0
- package/src/qingflow_mcp/solution/executor.py +112 -15
- package/src/qingflow_mcp/tools/ai_builder_tools.py +497 -65
- package/src/qingflow_mcp/tools/app_tools.py +237 -51
- package/src/qingflow_mcp/tools/approval_tools.py +196 -34
- package/src/qingflow_mcp/tools/auth_tools.py +92 -16
- package/src/qingflow_mcp/tools/code_block_tools.py +296 -39
- package/src/qingflow_mcp/tools/custom_button_tools.py +64 -10
- package/src/qingflow_mcp/tools/directory_tools.py +236 -72
- package/src/qingflow_mcp/tools/export_tools.py +230 -33
- package/src/qingflow_mcp/tools/file_tools.py +7 -3
- package/src/qingflow_mcp/tools/import_tools.py +293 -40
- package/src/qingflow_mcp/tools/navigation_tools.py +91 -12
- package/src/qingflow_mcp/tools/package_tools.py +134 -8
- package/src/qingflow_mcp/tools/portal_tools.py +39 -3
- package/src/qingflow_mcp/tools/qingbi_report_tools.py +116 -7
- package/src/qingflow_mcp/tools/record_tools.py +2305 -442
- package/src/qingflow_mcp/tools/resource_read_tools.py +191 -39
- package/src/qingflow_mcp/tools/role_tools.py +80 -9
- package/src/qingflow_mcp/tools/solution_tools.py +57 -15
- package/src/qingflow_mcp/tools/task_context_tools.py +569 -119
- package/src/qingflow_mcp/tools/task_tools.py +113 -29
- package/src/qingflow_mcp/tools/view_tools.py +106 -3
- package/src/qingflow_mcp/tools/workflow_tools.py +17 -1
- package/src/qingflow_mcp/tools/workspace_tools.py +71 -3
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
# 任务上下文 SOP:待办列表 → 详情 → 审批历史 → 关联报表 → 执行动作
|
|
2
|
+
|
|
3
|
+
本文与 **MCP / 服务端公开工具命名**对齐,并给出已安装的 `**qingflow` CLI** 等价命令。编写前已在当前环境对 `**task list` / `task get` / `task log`** 实跑;`**task report`** 在抽样任务上遇到过后端 `**40038` Object not exist**(见文末「实测排障」),属数据/权限/报表生命周期问题,**不否定**标准编排顺序。
|
|
4
|
+
|
|
5
|
+
**必须落盘**:`task` 的 `list`、`get`、`log`、`report` 以及 `**task action` 的响应**若体积大,均应 `> tmp/qingflow_*.json`,与主技能 [SKILL.md](../SKILL.md) 一致。
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 1. 编排顺序(固定)
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
| 步骤 | 工具名(文档/编排常用) | CLI 子命令 | 说明 |
|
|
13
|
+
| --- | ----------------------------------- | ------------------------------- | ----------------------------------------------------------------------------- |
|
|
14
|
+
| 1 | `task_list` | `qingflow [--json] task list` | `--task-box todo` 为待办(可省略则默认 todo) |
|
|
15
|
+
| 2 | `task_get` | `qingflow [--json] task get` | **优先** `--task-id`;从响应中取动作能力、关联报表摘要 |
|
|
16
|
+
| 3 | `task_workflow_log_get` | `qingflow [--json] task log` | 当前任务上下文的流程/审批历史条目(与详情独立接口,勿与 `extras.workflow_log` 混为一谈;记录级全量日志用 `record logs`) |
|
|
17
|
+
| 4 | `task_associated_report_detail_get` | `qingflow [--json] task report` | **必须** `--report-id`;ID 来自 **步骤 2** 的关联报表列表 |
|
|
18
|
+
| 5 | `task_action_execute` | `qingflow [--json] task action` | **无 `--dry-run`**;调用即生效,`**--action` 须落在 `task get` 的 `available_actions` 内** |
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
实现侧 CLI 将上述工具映射到 `qingflow_mcp` 的 `TaskContextTools`(`task` 子命令源码:`task list/get/log/report/action` → `task_list`、`task_get`、`task_workflow_log_get`、`task_associated_report_detail_get`、`task_action_execute`)。
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## 2. 定位方式(二选一,勿混用半截参数)
|
|
26
|
+
|
|
27
|
+
- **推荐**:全程使用列表里拿到的 `**task_id`**(字符串十进制;与大雪花 ID 一致时保持 **引号 / JSON 字符串** 习惯,避免其它子系统精度问题)。
|
|
28
|
+
- **备选**:无 `task_id` 时,**同时**提供 `--app-key`、`--record-id`、`--workflow-node-id`,缺一不可。
|
|
29
|
+
缺参时 CLI 会直接报 config:**要求 `--task-id`,或三者齐**。
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## 3. 步骤说明与命令模板
|
|
34
|
+
|
|
35
|
+
### 3.1 `task_list`(`task list`)
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
qingflow --json task list \
|
|
39
|
+
--task-box todo \
|
|
40
|
+
--flow-status all \
|
|
41
|
+
--page 1 \
|
|
42
|
+
--page-size 50 \
|
|
43
|
+
> tmp/qingflow_tasks_todo.json
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
- `**--task-box**`:`todo`(待办)、`done`(已办)、`cc`(抄送)、`initiated`(我发起)等;与 `**--flow-status**`(箱内流程状态)为 **两个独立维度**,可同一次请求带给后端。
|
|
47
|
+
- `**--query`**:优先走后端检索;若后端零条,公开列表可能 **本地回退**匹配应用名、节点名、`app_key`、`record_id`(JSON 中可能出现 `TASK_LIST_QUERY_FALLBACK_APPLIED` 类警告)。
|
|
48
|
+
- `**--app-key`**:列表阶段 **常省略**(不按应用过滤);与下钻阶段不同。
|
|
49
|
+
|
|
50
|
+
从 `data.items[]` 取 `**task_id`** 进入下一步。
|
|
51
|
+
|
|
52
|
+
### 3.2 `task_get`(`task get`)
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
qingflow --json task get \
|
|
56
|
+
--task-id "<TASK_ID>" \
|
|
57
|
+
> tmp/qingflow_task_get.json
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
可选(默认开启,大响应可关):`--no-include-candidates`、`--no-include-associated-reports`。
|
|
61
|
+
|
|
62
|
+
**解析要点**(以 CLI `--json` 紧凑载荷为准,字段名以你环境实际 JSON 为准):
|
|
63
|
+
|
|
64
|
+
- `**data.task`**:`app_key`、`record_id`、`workflow_node_id`、`workflow_node_name`、`actionable`、`task_id`。
|
|
65
|
+
- `**data.available_actions`**:当前节点 **允许** 的动作子集(**下文 `task action` 的 `--action` 必须落在此列表中**,否则 CLI 报 config)。
|
|
66
|
+
- `**data.editable_fields`**:可编辑字段(与 `**save_only`** 等配合)。
|
|
67
|
+
- `**data.extras**`:摘要信息,例如 `**workflow_log**`(是否可见、条数提示等)、`**associated_reports**`(`count`、`items[]`,每项含 `**report_id**` / `chart_key` / `chart_name` 等)。
|
|
68
|
+
|
|
69
|
+
### 3.3 `task_workflow_log_get`(`task log`)
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
qingflow --json task log \
|
|
73
|
+
--task-id "<TASK_ID>" \
|
|
74
|
+
> tmp/qingflow_task_log.json
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
- 典型结构:`data.items[]` 含节点、操作者、`operation`、`operation_time`、备注与附件等(具体字段以后端为准)。
|
|
78
|
+
- `**data.visibility**`:审计/机器人日志可见性等元数据。
|
|
79
|
+
- 这不是记录详情页的全量数据日志工具;如果用户要某条记录的完整数据日志 + 流程日志,先定位 `app_key/record_id/view_id`,再用 `qingflow --json record logs ...`。
|
|
80
|
+
|
|
81
|
+
### 3.4 `task_associated_report_detail_get`(`task report`)
|
|
82
|
+
|
|
83
|
+
1. 在 `**task get**` 的 `**data.extras.associated_reports.items**` 中选一条,读取其 `**report_id**`(整数)。
|
|
84
|
+
2. 若 `**count == 0**`,跳过本步,无 `**--report-id**` 可填。
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
qingflow --json task report \
|
|
88
|
+
--task-id "<TASK_ID>" \
|
|
89
|
+
--report-id <REPORT_ID> \
|
|
90
|
+
--page 1 \
|
|
91
|
+
--page-size 20 \
|
|
92
|
+
> tmp/qingflow_task_report.json
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
- 定位方式与 `task get` 相同(`--task-id` 或 三键)。
|
|
96
|
+
- 若关联项是 QingBI 报表,详情读取优先走前端同源的 **`/qingbi/charts/data/qflow/{chartId}/detail`**,再按 qflow `asos` 降级;只有 qflow 路由明确不存在/不适用时才退回旧 BI 数据接口。不要把中间 **`CHART_SEE` / 40002** 当成任务关联报表最终不可见。
|
|
97
|
+
|
|
98
|
+
### 3.5 `task_action_execute`(`task action`)
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
qingflow --json task action \
|
|
102
|
+
--task-id "<TASK_ID>" \
|
|
103
|
+
--action <ACTION> \
|
|
104
|
+
[--payload-file tmp/task_action_payload.json] \
|
|
105
|
+
[--fields-file tmp/task_action_fields.json] \
|
|
106
|
+
> tmp/qingflow_task_action.json
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
`**--action` 允许字面量**(实现校验,大小写不敏感):
|
|
110
|
+
`approve`、`reject`、`rollback`、`transfer`、`urge`、`save_only`。
|
|
111
|
+
|
|
112
|
+
**约束摘要**(与实现一致):
|
|
113
|
+
|
|
114
|
+
- `**approve` / `reject`**:执行上下文以当前待办详情或用户/前端已给出的显式 `formId` 为准;只有缺少 `formId` 时才兜底读取应用 baseInfo。不要把应用 baseInfo 的 `40002` 当作待办动作最终无权结论,最终是否可执行以后端审批动作接口为准。
|
|
115
|
+
- `**save_only`**:必须 提供非空 `**--fields-file`**(或 payload 与 fields 不能同时塞 `answers` 与 fields,具体以报错为准)。以当前待办节点的 `data.editable_fields` / `editableQueIds` 为准;若 `editableQueIds` 被当前权限链路挡住,但任务详情里的 `queAuthSetting` 已暴露可编辑字段,CLI 会按任务详情继续允许 save-only,并由最终保存接口裁决。申请表单 schema 或辅助 `editableQueIds` 的 `40002` 不是待办字段保存的最终无权结论。
|
|
116
|
+
- `**transfer**`:`**payload` 内需要** `target_member_id`(或别名 `uid` / `targetMemberId`);不能转给当前登录人。
|
|
117
|
+
- **意见必填**:若详情里 `**action_constraints.feedback_required_for`** 包含当前动作,需在 `**payload.audit_feedback`**(实现从 payload 抽取审计意见,具体键名以 `--help` / 服务端为准)中提供,否则会 config 错误。
|
|
118
|
+
- `**urge`**:**不支持** 与 `fields` 同时提交。
|
|
119
|
+
- **禁止臆测动作**:只允许 `**data.available_actions`** 中出现的动作;`approve` 不在列表则不可硬放行。
|
|
120
|
+
|
|
121
|
+
`**--payload-file` / `--fields-file`**:UTF-8 JSON 对象,与 `record update` 同类「文件用 JSON」习惯一致。
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
## 4. 与「应用内 `record list`」的边界
|
|
126
|
+
|
|
127
|
+
- **任务中心待办 / 已办 / 抄送**:用 `**task list --task-box …`**,**不要**再用过时的 `record list --view-id system:todo` 等当作任务箱。
|
|
128
|
+
- **业务表读数**:仍在 `app get` 的 `**accessible_views`** 里选 `**custom:`* 等**,走 [QINGFLOW_CLI_DATA_RETRIEVAL_WORKFLOW.md](./QINGFLOW_CLI_DATA_RETRIEVAL_WORKFLOW.md)。
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
## 5. 实测与排障(编写时实跑)
|
|
133
|
+
|
|
134
|
+
|
|
135
|
+
| 命令 | 结果 |
|
|
136
|
+
| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
137
|
+
| `task list --task-box todo` | 返回多条,`items[].task_id` 为字符串;列表项可能不含 `app_key`(详情阶段再解析)。 |
|
|
138
|
+
| `task get --task-id …` | `data.task` 含完整定位;`available_actions` 示例含 `approve`/`reject`/`rollback`/`transfer`;`extras.associated_reports` 可为 `count: 0` 或大于 0。 |
|
|
139
|
+
| `task log --task-id …` | 返回 `data.items` 审批/流程历史。 |
|
|
140
|
+
| `task report --task-id … --report-id …` | 某条 `**count>0`** 的抽样上曾返回后端 `**40038` Object not exist**;同一 `task get` 里仍列出 `report_id`。**建议**:换 `report_id`、确认报表未删除、核对轻流 BI 权限与节点关联;仍失败时保留 `request_id` 报障。 |
|
|
141
|
+
|
|
142
|
+
|
|
143
|
+
**说明**:本文编写时仅用读接口抽样校验;`**task action`** 可依照 **第 3.5 节** 在自动化剧本中直接调用,由编排侧控制目标待办与动作,避免误批。
|
|
144
|
+
|
|
145
|
+
---
|
|
146
|
+
|
|
147
|
+
## 6. 交叉引用
|
|
148
|
+
|
|
149
|
+
- 主技能 [SKILL.md](../SKILL.md):**落盘规则**、`**task-box` / `flow-status`** 枚举、与 `record` 混用雷区。
|
|
150
|
+
- [QINGFLOW_CLI_MEMBER_CHEATSHEET.md](./QINGFLOW_CLI_MEMBER_CHEATSHEET.md):成员侧最短路径。
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"name": "BAT_sub",
|
|
4
|
+
"type": "subtable",
|
|
5
|
+
"subfields": [
|
|
6
|
+
{"name": "BAT_sub_a", "type": "text"},
|
|
7
|
+
{"name": "BAT_sub_b", "type": "number"}
|
|
8
|
+
]
|
|
9
|
+
},
|
|
10
|
+
{
|
|
11
|
+
"name": "BAT_rel",
|
|
12
|
+
"type": "relation",
|
|
13
|
+
"target_app_key": "ead8ims5i401",
|
|
14
|
+
"relation_mode": "single",
|
|
15
|
+
"display_field": {"name": "单行文字"},
|
|
16
|
+
"visible_fields": [{"name": "多行文字"}]
|
|
17
|
+
}
|
|
18
|
+
]
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
[
|
|
2
|
+
{"name": "BAT_text", "type": "text", "description": "批测"},
|
|
3
|
+
{"name": "BAT_long_text", "type": "long_text"},
|
|
4
|
+
{"name": "BAT_number", "type": "number"},
|
|
5
|
+
{"name": "BAT_amount", "type": "amount"},
|
|
6
|
+
{"name": "BAT_date", "type": "date"},
|
|
7
|
+
{"name": "BAT_datetime", "type": "datetime"},
|
|
8
|
+
{"name": "BAT_member", "type": "member"},
|
|
9
|
+
{"name": "BAT_phone", "type": "phone"},
|
|
10
|
+
{"name": "BAT_email", "type": "email"},
|
|
11
|
+
{"name": "BAT_address", "type": "address"},
|
|
12
|
+
{"name": "BAT_attachment", "type": "attachment"},
|
|
13
|
+
{"name": "BAT_boolean", "type": "boolean"},
|
|
14
|
+
{"name": "BAT_single_select", "type": "single_select", "options": ["A", "B"], "required": false},
|
|
15
|
+
{"name": "BAT_multi_select", "type": "multi_select", "options": ["X", "Y"], "required": false},
|
|
16
|
+
{"name": "BAT_dept", "type": "department", "department_scope": {"mode": "all"}}
|
|
17
|
+
]
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
["CHART_ID_TO_DELETE"]
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
["CHART_ID_FIRST", "CHART_ID_SECOND"]
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"name": "数据总量",
|
|
4
|
+
"chart_type": "target",
|
|
5
|
+
"indicator_field_ids": [],
|
|
6
|
+
"visibility": {
|
|
7
|
+
"mode": "workspace",
|
|
8
|
+
"selectors": {},
|
|
9
|
+
"external_mode": "not",
|
|
10
|
+
"external_selectors": {}
|
|
11
|
+
}
|
|
12
|
+
},
|
|
13
|
+
{
|
|
14
|
+
"name": "按状态分布",
|
|
15
|
+
"chart_type": "bar",
|
|
16
|
+
"dimension_field_ids": ["REPLACE_WITH_STATUS_FIELD_ID"],
|
|
17
|
+
"indicator_field_ids": ["REPLACE_WITH_COUNT_OR_NUMERIC_FIELD_ID"],
|
|
18
|
+
"visibility": {
|
|
19
|
+
"mode": "workspace",
|
|
20
|
+
"selectors": {},
|
|
21
|
+
"external_mode": "not",
|
|
22
|
+
"external_selectors": {}
|
|
23
|
+
}
|
|
24
|
+
},
|
|
25
|
+
{
|
|
26
|
+
"name": "按时间趋势",
|
|
27
|
+
"chart_type": "line",
|
|
28
|
+
"dimension_field_ids": ["REPLACE_WITH_DATE_FIELD_ID"],
|
|
29
|
+
"indicator_field_ids": ["REPLACE_WITH_COUNT_OR_NUMERIC_FIELD_ID"],
|
|
30
|
+
"visibility": {
|
|
31
|
+
"mode": "workspace",
|
|
32
|
+
"selectors": {},
|
|
33
|
+
"external_mode": "not",
|
|
34
|
+
"external_selectors": {}
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
]
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"title": "筛选条_实验项_勿默认交付",
|
|
4
|
+
"source_type": "filter",
|
|
5
|
+
"position": {
|
|
6
|
+
"pc": {
|
|
7
|
+
"x": 0,
|
|
8
|
+
"y": 0,
|
|
9
|
+
"cols": 24,
|
|
10
|
+
"rows": 2
|
|
11
|
+
},
|
|
12
|
+
"mobile": {
|
|
13
|
+
"x": 0,
|
|
14
|
+
"y": 0,
|
|
15
|
+
"cols": 6,
|
|
16
|
+
"rows": 2
|
|
17
|
+
}
|
|
18
|
+
},
|
|
19
|
+
"config": {
|
|
20
|
+
"filterConfig": [],
|
|
21
|
+
"graphList": [
|
|
22
|
+
{
|
|
23
|
+
"graphType": "CHART",
|
|
24
|
+
"graphKey": "REPLACE_WITH_QINGBI_CHART_ID",
|
|
25
|
+
"graphName": "可选_图表显示名"
|
|
26
|
+
}
|
|
27
|
+
]
|
|
28
|
+
}
|
|
29
|
+
},
|
|
30
|
+
{
|
|
31
|
+
"title": "九宫格",
|
|
32
|
+
"source_type": "grid",
|
|
33
|
+
"position": {
|
|
34
|
+
"pc": {
|
|
35
|
+
"x": 0,
|
|
36
|
+
"y": 2,
|
|
37
|
+
"cols": 24,
|
|
38
|
+
"rows": 4
|
|
39
|
+
},
|
|
40
|
+
"mobile": {
|
|
41
|
+
"x": 0,
|
|
42
|
+
"y": 2,
|
|
43
|
+
"cols": 6,
|
|
44
|
+
"rows": 4
|
|
45
|
+
}
|
|
46
|
+
},
|
|
47
|
+
"config": {}
|
|
48
|
+
},
|
|
49
|
+
{
|
|
50
|
+
"title": "说明文字块",
|
|
51
|
+
"source_type": "text",
|
|
52
|
+
"position": {
|
|
53
|
+
"pc": {
|
|
54
|
+
"x": 0,
|
|
55
|
+
"y": 6,
|
|
56
|
+
"cols": 24,
|
|
57
|
+
"rows": 2
|
|
58
|
+
},
|
|
59
|
+
"mobile": {
|
|
60
|
+
"x": 0,
|
|
61
|
+
"y": 6,
|
|
62
|
+
"cols": 6,
|
|
63
|
+
"rows": 2
|
|
64
|
+
}
|
|
65
|
+
},
|
|
66
|
+
"text": "本文件仅用于排障/实验:filter 在当前 CLI 直写中可能不落库;稳定自动化模板请使用 portal_sections_five_types.example.json。"
|
|
67
|
+
},
|
|
68
|
+
{
|
|
69
|
+
"title": "外部链接",
|
|
70
|
+
"source_type": "link",
|
|
71
|
+
"position": {
|
|
72
|
+
"pc": {
|
|
73
|
+
"x": 0,
|
|
74
|
+
"y": 8,
|
|
75
|
+
"cols": 12,
|
|
76
|
+
"rows": 2
|
|
77
|
+
},
|
|
78
|
+
"mobile": {
|
|
79
|
+
"x": 0,
|
|
80
|
+
"y": 8,
|
|
81
|
+
"cols": 6,
|
|
82
|
+
"rows": 2
|
|
83
|
+
}
|
|
84
|
+
},
|
|
85
|
+
"url": "https://example.com"
|
|
86
|
+
},
|
|
87
|
+
{
|
|
88
|
+
"title": "应用视图块",
|
|
89
|
+
"source_type": "view",
|
|
90
|
+
"position": {
|
|
91
|
+
"pc": {
|
|
92
|
+
"x": 0,
|
|
93
|
+
"y": 10,
|
|
94
|
+
"cols": 24,
|
|
95
|
+
"rows": 8
|
|
96
|
+
},
|
|
97
|
+
"mobile": {
|
|
98
|
+
"x": 0,
|
|
99
|
+
"y": 10,
|
|
100
|
+
"cols": 6,
|
|
101
|
+
"rows": 8
|
|
102
|
+
}
|
|
103
|
+
},
|
|
104
|
+
"view_ref": {
|
|
105
|
+
"app_key": "YOUR_APP_KEY",
|
|
106
|
+
"view_key": "YOUR_VIEW_KEY"
|
|
107
|
+
}
|
|
108
|
+
},
|
|
109
|
+
{
|
|
110
|
+
"title": "指标图",
|
|
111
|
+
"source_type": "chart",
|
|
112
|
+
"position": {
|
|
113
|
+
"pc": {
|
|
114
|
+
"x": 0,
|
|
115
|
+
"y": 18,
|
|
116
|
+
"cols": 12,
|
|
117
|
+
"rows": 6
|
|
118
|
+
},
|
|
119
|
+
"mobile": {
|
|
120
|
+
"x": 0,
|
|
121
|
+
"y": 18,
|
|
122
|
+
"cols": 6,
|
|
123
|
+
"rows": 6
|
|
124
|
+
}
|
|
125
|
+
},
|
|
126
|
+
"chart_ref": {
|
|
127
|
+
"app_key": "YOUR_APP_KEY",
|
|
128
|
+
"chart_id": "YOUR_CHART_ID"
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
]
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"title": "门户说明",
|
|
4
|
+
"source_type": "text",
|
|
5
|
+
"position": {
|
|
6
|
+
"pc": {
|
|
7
|
+
"x": 0,
|
|
8
|
+
"y": 0,
|
|
9
|
+
"cols": 24,
|
|
10
|
+
"rows": 2
|
|
11
|
+
},
|
|
12
|
+
"mobile": {
|
|
13
|
+
"x": 0,
|
|
14
|
+
"y": 0,
|
|
15
|
+
"cols": 6,
|
|
16
|
+
"rows": 2
|
|
17
|
+
}
|
|
18
|
+
},
|
|
19
|
+
"text": "建议将门户设计成工作台:上方放入口,中部放指标,下方放待处理和异常列表。此文件仅演示 grid / text / link / view / chart 的稳定写法。"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"title": "业务入口",
|
|
23
|
+
"source_type": "grid",
|
|
24
|
+
"position": {
|
|
25
|
+
"pc": {
|
|
26
|
+
"x": 0,
|
|
27
|
+
"y": 2,
|
|
28
|
+
"cols": 24,
|
|
29
|
+
"rows": 4
|
|
30
|
+
},
|
|
31
|
+
"mobile": {
|
|
32
|
+
"x": 0,
|
|
33
|
+
"y": 2,
|
|
34
|
+
"cols": 6,
|
|
35
|
+
"rows": 4
|
|
36
|
+
}
|
|
37
|
+
},
|
|
38
|
+
"config": {
|
|
39
|
+
"gridTitle": "业务入口",
|
|
40
|
+
"beingShowTitle": true
|
|
41
|
+
}
|
|
42
|
+
},
|
|
43
|
+
{
|
|
44
|
+
"title": "核心指标",
|
|
45
|
+
"source_type": "chart",
|
|
46
|
+
"position": {
|
|
47
|
+
"pc": {
|
|
48
|
+
"x": 0,
|
|
49
|
+
"y": 6,
|
|
50
|
+
"cols": 8,
|
|
51
|
+
"rows": 6
|
|
52
|
+
},
|
|
53
|
+
"mobile": {
|
|
54
|
+
"x": 0,
|
|
55
|
+
"y": 6,
|
|
56
|
+
"cols": 6,
|
|
57
|
+
"rows": 6
|
|
58
|
+
}
|
|
59
|
+
},
|
|
60
|
+
"chart_ref": {
|
|
61
|
+
"app_key": "ead8ims5i401",
|
|
62
|
+
"chart_id": "mcp_fb104267c5c249ca"
|
|
63
|
+
}
|
|
64
|
+
},
|
|
65
|
+
{
|
|
66
|
+
"title": "待处理列表",
|
|
67
|
+
"source_type": "view",
|
|
68
|
+
"position": {
|
|
69
|
+
"pc": {
|
|
70
|
+
"x": 0,
|
|
71
|
+
"y": 12,
|
|
72
|
+
"cols": 12,
|
|
73
|
+
"rows": 8
|
|
74
|
+
},
|
|
75
|
+
"mobile": {
|
|
76
|
+
"x": 0,
|
|
77
|
+
"y": 12,
|
|
78
|
+
"cols": 6,
|
|
79
|
+
"rows": 8
|
|
80
|
+
}
|
|
81
|
+
},
|
|
82
|
+
"view_ref": {
|
|
83
|
+
"app_key": "ead8ims5i401",
|
|
84
|
+
"view_key": "ead8kbf1i402"
|
|
85
|
+
}
|
|
86
|
+
},
|
|
87
|
+
{
|
|
88
|
+
"title": "帮助文档",
|
|
89
|
+
"source_type": "link",
|
|
90
|
+
"position": {
|
|
91
|
+
"pc": {
|
|
92
|
+
"x": 12,
|
|
93
|
+
"y": 12,
|
|
94
|
+
"cols": 12,
|
|
95
|
+
"rows": 2
|
|
96
|
+
},
|
|
97
|
+
"mobile": {
|
|
98
|
+
"x": 0,
|
|
99
|
+
"y": 20,
|
|
100
|
+
"cols": 6,
|
|
101
|
+
"rows": 2
|
|
102
|
+
}
|
|
103
|
+
},
|
|
104
|
+
"url": "https://example.com"
|
|
105
|
+
}
|
|
106
|
+
]
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"name": "QFCLI_AT_text",
|
|
4
|
+
"type": "text",
|
|
5
|
+
"as_data_title": true,
|
|
6
|
+
"description": "【本文件用法】推荐一次成功:npx @qingflow-tech/qingflow-cli --profile default builder schema apply --package-id <你的包tag_id> --app-name \"新应用名\" --create-if-missing --no-publish --add-fields-file schema_apply_add_fields_all_types.json。内含19种搭建 type(另含远程查询/代码块所需辅助 text),且已在本字段标记 as_data_title。关联字段 target_app_key 默认为本仓库实测用的模板应用 ead8ims5i401(须含「单行文字」「多行文字」);其它租户请改成你方可读的目标应用 app_key。若用 --app-key 向已有应用追加:须无「关联」字段且字段名不重复;每应用仅允许一个 relation。"
|
|
7
|
+
},
|
|
8
|
+
{"name": "QFCLI_AT_long_text", "type": "long_text"},
|
|
9
|
+
{"name": "QFCLI_AT_number", "type": "number"},
|
|
10
|
+
{"name": "QFCLI_AT_amount", "type": "amount"},
|
|
11
|
+
{"name": "QFCLI_AT_date", "type": "date"},
|
|
12
|
+
{"name": "QFCLI_AT_datetime", "type": "datetime"},
|
|
13
|
+
{"name": "QFCLI_AT_member", "type": "member"},
|
|
14
|
+
{"name": "QFCLI_AT_department", "type": "department", "department_scope": {"mode": "all"}},
|
|
15
|
+
{"name": "QFCLI_AT_single_select", "type": "single_select", "options": ["A", "B"]},
|
|
16
|
+
{"name": "QFCLI_AT_multi_select", "type": "multi_select", "options": ["X", "Y"]},
|
|
17
|
+
{"name": "QFCLI_AT_phone", "type": "phone"},
|
|
18
|
+
{"name": "QFCLI_AT_email", "type": "email"},
|
|
19
|
+
{"name": "QFCLI_AT_address", "type": "address"},
|
|
20
|
+
{"name": "QFCLI_AT_attachment", "type": "attachment", "as_data_cover": true},
|
|
21
|
+
{"name": "QFCLI_AT_boolean", "type": "boolean"},
|
|
22
|
+
{"name": "QFCLI_AT_ql_kw", "type": "text"},
|
|
23
|
+
{"name": "QFCLI_AT_ql_v1", "type": "text"},
|
|
24
|
+
{"name": "QFCLI_AT_ql_v2", "type": "text"},
|
|
25
|
+
{"name": "QFCLI_AT_cb_in", "type": "text"},
|
|
26
|
+
{"name": "QFCLI_AT_cb_out", "type": "text"},
|
|
27
|
+
{
|
|
28
|
+
"name": "QFCLI_AT_sub",
|
|
29
|
+
"type": "subtable",
|
|
30
|
+
"subfields": [
|
|
31
|
+
{"name": "QFCLI_AT_sub_c1", "type": "text"},
|
|
32
|
+
{"name": "QFCLI_AT_sub_c2", "type": "number"}
|
|
33
|
+
]
|
|
34
|
+
},
|
|
35
|
+
{
|
|
36
|
+
"name": "QFCLI_AT_q_linker",
|
|
37
|
+
"type": "q_linker",
|
|
38
|
+
"q_linker_binding": {
|
|
39
|
+
"inputs": [{"field": {"name": "QFCLI_AT_ql_kw"}, "key": "k", "source": "query_param"}],
|
|
40
|
+
"request": {
|
|
41
|
+
"url": "https://httpbin.org/get",
|
|
42
|
+
"method": "GET",
|
|
43
|
+
"headers": [],
|
|
44
|
+
"query_params": [],
|
|
45
|
+
"body_type": 1,
|
|
46
|
+
"url_encoded_value": [],
|
|
47
|
+
"result_type": 1,
|
|
48
|
+
"auto_trigger": false,
|
|
49
|
+
"custom_button_text_enabled": true,
|
|
50
|
+
"custom_button_text": "查"
|
|
51
|
+
},
|
|
52
|
+
"outputs": [
|
|
53
|
+
{"alias": "a", "path": "$.headers.Host", "target_field": {"name": "QFCLI_AT_ql_v1"}},
|
|
54
|
+
{"alias": "b", "path": "$.url", "target_field": {"name": "QFCLI_AT_ql_v2"}}
|
|
55
|
+
]
|
|
56
|
+
}
|
|
57
|
+
},
|
|
58
|
+
{
|
|
59
|
+
"name": "QFCLI_AT_code_block",
|
|
60
|
+
"type": "code_block",
|
|
61
|
+
"code_block_binding": {
|
|
62
|
+
"inputs": [{"field": {"name": "QFCLI_AT_cb_in"}, "var": "x"}],
|
|
63
|
+
"code": "qf_output = {}; qf_output.r = x ? '1' : '0';",
|
|
64
|
+
"auto_trigger": false,
|
|
65
|
+
"custom_button_text_enabled": true,
|
|
66
|
+
"custom_button_text": "运行",
|
|
67
|
+
"outputs": [{"alias": "r", "path": "$.r", "target_field": {"name": "QFCLI_AT_cb_out"}}]
|
|
68
|
+
}
|
|
69
|
+
},
|
|
70
|
+
{
|
|
71
|
+
"name": "QFCLI_AT_relation",
|
|
72
|
+
"type": "relation",
|
|
73
|
+
"target_app_key": "ead8ims5i401",
|
|
74
|
+
"relation_mode": "single",
|
|
75
|
+
"display_field": {"name": "单行文字"},
|
|
76
|
+
"visible_fields": [{"name": "多行文字"}]
|
|
77
|
+
}
|
|
78
|
+
]
|