@qingflow-tech/qingflow-cli 1.1.43 → 1.1.44-beta.1
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 +13 -6
- package/entry_point.py +1 -1
- package/npm/bin/qingflow.mjs +1 -2
- package/npm/lib/runtime.mjs +3 -7
- package/package.json +2 -2
- package/pyproject.toml +3 -4
- package/skills/qingflow-app-form/SKILL.md +66 -0
- package/skills/qingflow-app-form/agents/openai.yaml +4 -0
- package/skills/qingflow-cli/SKILL.md +8 -6
- package/skills/qingflow-cli/manifest.yaml +1 -1
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_BUILDER_APP_DELIVERY_WORKFLOW.md +4 -4
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_EXPLORATION_REPORT.md +1 -1
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_FIELD_DATA_TYPES.md +1 -1
- package/skills/qingflow-cli/reference/QINGFLOW_CLI_SCHEMA_APPLY_FIELD_TYPES_AND_SCENARIOS.md +4 -4
- package/skills/qingflow-cli/reference/builder/10-build-single-app.md +5 -5
- package/skills/qingflow-cli/reference/builder/20-build-complete-system.md +14 -14
- package/skills/qingflow-cli/reference/builder/30-schema-fields.md +106 -103
- package/skills/qingflow-cli/reference/builder/40-layout.md +39 -31
- package/skills/qingflow-cli/reference/builder/README.md +9 -9
- package/skills/qingflow-cli/reference/builder/code-integrations/README.md +4 -2
- package/skills/qingflow-cli/reference/builder/code-integrations/code-block.md +2 -0
- package/skills/qingflow-cli/reference/builder/code-integrations/q-linker.md +2 -0
- package/skills/qingflow-cli/reference/builder/reference/app-delivery-sop.md +45 -38
- package/skills/qingflow-cli/reference/core/QINGFLOW_CLI_EXPLORATION_REPORT.md +1 -1
- package/skills/qingflow-cli/reference/core/QINGFLOW_CLI_FIELD_DATA_TYPES.md +1 -1
- package/skills/qingflow-cli/reference/examples/README.md +3 -3
- package/skills/qingflow-common/SKILL.md +47 -0
- package/skills/qingflow-common/agents/openai.yaml +4 -0
- package/src/qingflow_mcp/__main__.py +2 -3
- package/src/qingflow_mcp/app_form_compat.py +104 -0
- package/src/qingflow_mcp/app_form_validator.py +462 -0
- package/src/qingflow_mcp/builder_facade/app_form.py +4196 -0
- package/src/qingflow_mcp/builder_facade/app_form_schema.py +425 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/manifest.json +42 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/complete.json +2969 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/address.json +392 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/amount.json +236 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/attachment.json +425 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/code_block.json +318 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/data_relation.json +580 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/date.json +150 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/datetime.json +150 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/department.json +345 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/email.json +190 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/link.json +190 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/long_text.json +190 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/member.json +484 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/multi_select.json +214 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/number.json +236 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/phone.json +199 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/q_linker.json +412 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/relation.json +454 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/single_choice.json +214 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/single_select.json +214 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/subtable.json +1921 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/text.json +190 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/formula.json +1594 -0
- package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/summary.json +718 -0
- package/src/qingflow_mcp/builder_facade/service.py +8 -4
- package/src/qingflow_mcp/cli/commands/builder.py +93 -28
- package/src/qingflow_mcp/cli/json_io.py +21 -2
- package/src/qingflow_mcp/cli/main.py +3 -39
- package/src/qingflow_mcp/public_surface.py +5 -2
- package/src/qingflow_mcp/response_trim.py +50 -0
- package/src/qingflow_mcp/server.py +24 -3
- package/src/qingflow_mcp/server_app_builder.py +44 -87
- package/src/qingflow_mcp/tools/ai_builder_tools.py +103 -100
- package/src/qingflow_mcp/tools/app_tools.py +46 -65
- package/src/qingflow_mcp/tools/record_tools.py +3 -3
- package/src/qingflow_mcp/version.py +2 -4
- package/docs/local-agent-install.md +0 -370
- package/skills/qingflow-mcp-setup/SKILL.md +0 -115
- package/skills/qingflow-mcp-setup/agents/openai.yaml +0 -4
- package/skills/qingflow-mcp-setup/references/claude-desktop.md +0 -34
- package/skills/qingflow-mcp-setup/references/environments.md +0 -62
- package/skills/qingflow-mcp-setup/references/generic-stdio.md +0 -32
- package/skills/qingflow-mcp-setup/scripts/check_local_server.sh +0 -38
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$defs": {
|
|
3
|
+
"EmptyConfig": {
|
|
4
|
+
"additionalProperties": false,
|
|
5
|
+
"description": "该字段类型没有特殊配置。",
|
|
6
|
+
"type": "object"
|
|
7
|
+
},
|
|
8
|
+
"FieldCommon": {
|
|
9
|
+
"allOf": [
|
|
10
|
+
{
|
|
11
|
+
"if": {
|
|
12
|
+
"properties": {
|
|
13
|
+
"defaultType": {
|
|
14
|
+
"const": 2
|
|
15
|
+
}
|
|
16
|
+
},
|
|
17
|
+
"required": [
|
|
18
|
+
"defaultType"
|
|
19
|
+
]
|
|
20
|
+
},
|
|
21
|
+
"then": {
|
|
22
|
+
"properties": {
|
|
23
|
+
"defaultValue": {
|
|
24
|
+
"type": "null"
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
},
|
|
29
|
+
{
|
|
30
|
+
"if": {
|
|
31
|
+
"properties": {
|
|
32
|
+
"defaultType": {
|
|
33
|
+
"const": 3
|
|
34
|
+
}
|
|
35
|
+
},
|
|
36
|
+
"required": [
|
|
37
|
+
"defaultType"
|
|
38
|
+
]
|
|
39
|
+
},
|
|
40
|
+
"then": {
|
|
41
|
+
"properties": {
|
|
42
|
+
"defaultValue": {
|
|
43
|
+
"minLength": 1,
|
|
44
|
+
"type": [
|
|
45
|
+
"string",
|
|
46
|
+
"null"
|
|
47
|
+
]
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
],
|
|
53
|
+
"anyOf": [
|
|
54
|
+
{
|
|
55
|
+
"required": [
|
|
56
|
+
"queId"
|
|
57
|
+
]
|
|
58
|
+
},
|
|
59
|
+
{
|
|
60
|
+
"required": [
|
|
61
|
+
"name"
|
|
62
|
+
]
|
|
63
|
+
}
|
|
64
|
+
],
|
|
65
|
+
"description": "顶层业务字段的公共属性;字段类型由 TopField 的判别分支定义。",
|
|
66
|
+
"properties": {
|
|
67
|
+
"beingRequired": {
|
|
68
|
+
"description": "该字段是否必填;缺失时保留已有字段当前值。",
|
|
69
|
+
"type": "boolean"
|
|
70
|
+
},
|
|
71
|
+
"defaultType": {
|
|
72
|
+
"default": 1,
|
|
73
|
+
"description": "默认值类型,与 defaultValue 联动;1 表示静态值,2 表示关联/绑定值且 defaultValue 只能省略或为 null,3 表示公式值且提供 defaultValue 时必须为非空公式文本。省略 defaultType 但提供 defaultValue 时按 1 处理。",
|
|
74
|
+
"enum": [
|
|
75
|
+
1,
|
|
76
|
+
2,
|
|
77
|
+
3
|
|
78
|
+
],
|
|
79
|
+
"type": "integer"
|
|
80
|
+
},
|
|
81
|
+
"defaultValue": {
|
|
82
|
+
"$ref": "#/$defs/ScalarDefaultValue",
|
|
83
|
+
"description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
|
|
84
|
+
},
|
|
85
|
+
"name": {
|
|
86
|
+
"description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
|
|
87
|
+
"minLength": 1,
|
|
88
|
+
"type": "string"
|
|
89
|
+
},
|
|
90
|
+
"queId": {
|
|
91
|
+
"description": "已有字段的后端 ID;更新时用于精确定位并复用,新增字段通常省略。",
|
|
92
|
+
"minimum": 1,
|
|
93
|
+
"type": "integer"
|
|
94
|
+
},
|
|
95
|
+
"questionDescription": {
|
|
96
|
+
"description": "字段说明;null 或空字符串表示清空。",
|
|
97
|
+
"type": [
|
|
98
|
+
"string",
|
|
99
|
+
"null"
|
|
100
|
+
]
|
|
101
|
+
},
|
|
102
|
+
"questionType": {
|
|
103
|
+
"description": "字段类型;具体可用值由当前字段详情 Schema 的判别分支约束。",
|
|
104
|
+
"type": "string"
|
|
105
|
+
},
|
|
106
|
+
"width": {
|
|
107
|
+
"description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
|
|
108
|
+
"enum": [
|
|
109
|
+
25,
|
|
110
|
+
50,
|
|
111
|
+
75,
|
|
112
|
+
100
|
|
113
|
+
],
|
|
114
|
+
"type": "integer"
|
|
115
|
+
}
|
|
116
|
+
},
|
|
117
|
+
"type": "object"
|
|
118
|
+
},
|
|
119
|
+
"ScalarDefaultValue": {
|
|
120
|
+
"description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。defaultType 为 3 时,通过 AppForm Schema 查询能力传入当前 schema_version 并设置 schema_kind=formula 获取公式语法、字段引用、运算符和全部函数说明;CLI 使用 builder app-form schema --schema-kind formula。需要配置结构化默认值时,传入当前 schema_version,并将字段的 questionType 作为 field_type 获取字段详细 Schema。",
|
|
121
|
+
"type": [
|
|
122
|
+
"null",
|
|
123
|
+
"string"
|
|
124
|
+
]
|
|
125
|
+
}
|
|
126
|
+
},
|
|
127
|
+
"$id": "https://builder.qingflow.com/schemas/app-form-apply/v1alpha1/fields/date.json",
|
|
128
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
129
|
+
"allOf": [
|
|
130
|
+
{
|
|
131
|
+
"$ref": "#/$defs/FieldCommon"
|
|
132
|
+
},
|
|
133
|
+
{
|
|
134
|
+
"properties": {
|
|
135
|
+
"config": {
|
|
136
|
+
"$ref": "#/$defs/EmptyConfig"
|
|
137
|
+
},
|
|
138
|
+
"questionType": {
|
|
139
|
+
"const": "date"
|
|
140
|
+
}
|
|
141
|
+
},
|
|
142
|
+
"required": [
|
|
143
|
+
"questionType"
|
|
144
|
+
]
|
|
145
|
+
}
|
|
146
|
+
],
|
|
147
|
+
"title": "Qingflow AppForm v1alpha1 date field",
|
|
148
|
+
"type": "object",
|
|
149
|
+
"unevaluatedProperties": false
|
|
150
|
+
}
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$defs": {
|
|
3
|
+
"EmptyConfig": {
|
|
4
|
+
"additionalProperties": false,
|
|
5
|
+
"description": "该字段类型没有特殊配置。",
|
|
6
|
+
"type": "object"
|
|
7
|
+
},
|
|
8
|
+
"FieldCommon": {
|
|
9
|
+
"allOf": [
|
|
10
|
+
{
|
|
11
|
+
"if": {
|
|
12
|
+
"properties": {
|
|
13
|
+
"defaultType": {
|
|
14
|
+
"const": 2
|
|
15
|
+
}
|
|
16
|
+
},
|
|
17
|
+
"required": [
|
|
18
|
+
"defaultType"
|
|
19
|
+
]
|
|
20
|
+
},
|
|
21
|
+
"then": {
|
|
22
|
+
"properties": {
|
|
23
|
+
"defaultValue": {
|
|
24
|
+
"type": "null"
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
},
|
|
29
|
+
{
|
|
30
|
+
"if": {
|
|
31
|
+
"properties": {
|
|
32
|
+
"defaultType": {
|
|
33
|
+
"const": 3
|
|
34
|
+
}
|
|
35
|
+
},
|
|
36
|
+
"required": [
|
|
37
|
+
"defaultType"
|
|
38
|
+
]
|
|
39
|
+
},
|
|
40
|
+
"then": {
|
|
41
|
+
"properties": {
|
|
42
|
+
"defaultValue": {
|
|
43
|
+
"minLength": 1,
|
|
44
|
+
"type": [
|
|
45
|
+
"string",
|
|
46
|
+
"null"
|
|
47
|
+
]
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
],
|
|
53
|
+
"anyOf": [
|
|
54
|
+
{
|
|
55
|
+
"required": [
|
|
56
|
+
"queId"
|
|
57
|
+
]
|
|
58
|
+
},
|
|
59
|
+
{
|
|
60
|
+
"required": [
|
|
61
|
+
"name"
|
|
62
|
+
]
|
|
63
|
+
}
|
|
64
|
+
],
|
|
65
|
+
"description": "顶层业务字段的公共属性;字段类型由 TopField 的判别分支定义。",
|
|
66
|
+
"properties": {
|
|
67
|
+
"beingRequired": {
|
|
68
|
+
"description": "该字段是否必填;缺失时保留已有字段当前值。",
|
|
69
|
+
"type": "boolean"
|
|
70
|
+
},
|
|
71
|
+
"defaultType": {
|
|
72
|
+
"default": 1,
|
|
73
|
+
"description": "默认值类型,与 defaultValue 联动;1 表示静态值,2 表示关联/绑定值且 defaultValue 只能省略或为 null,3 表示公式值且提供 defaultValue 时必须为非空公式文本。省略 defaultType 但提供 defaultValue 时按 1 处理。",
|
|
74
|
+
"enum": [
|
|
75
|
+
1,
|
|
76
|
+
2,
|
|
77
|
+
3
|
|
78
|
+
],
|
|
79
|
+
"type": "integer"
|
|
80
|
+
},
|
|
81
|
+
"defaultValue": {
|
|
82
|
+
"$ref": "#/$defs/ScalarDefaultValue",
|
|
83
|
+
"description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
|
|
84
|
+
},
|
|
85
|
+
"name": {
|
|
86
|
+
"description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
|
|
87
|
+
"minLength": 1,
|
|
88
|
+
"type": "string"
|
|
89
|
+
},
|
|
90
|
+
"queId": {
|
|
91
|
+
"description": "已有字段的后端 ID;更新时用于精确定位并复用,新增字段通常省略。",
|
|
92
|
+
"minimum": 1,
|
|
93
|
+
"type": "integer"
|
|
94
|
+
},
|
|
95
|
+
"questionDescription": {
|
|
96
|
+
"description": "字段说明;null 或空字符串表示清空。",
|
|
97
|
+
"type": [
|
|
98
|
+
"string",
|
|
99
|
+
"null"
|
|
100
|
+
]
|
|
101
|
+
},
|
|
102
|
+
"questionType": {
|
|
103
|
+
"description": "字段类型;具体可用值由当前字段详情 Schema 的判别分支约束。",
|
|
104
|
+
"type": "string"
|
|
105
|
+
},
|
|
106
|
+
"width": {
|
|
107
|
+
"description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
|
|
108
|
+
"enum": [
|
|
109
|
+
25,
|
|
110
|
+
50,
|
|
111
|
+
75,
|
|
112
|
+
100
|
|
113
|
+
],
|
|
114
|
+
"type": "integer"
|
|
115
|
+
}
|
|
116
|
+
},
|
|
117
|
+
"type": "object"
|
|
118
|
+
},
|
|
119
|
+
"ScalarDefaultValue": {
|
|
120
|
+
"description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。defaultType 为 3 时,通过 AppForm Schema 查询能力传入当前 schema_version 并设置 schema_kind=formula 获取公式语法、字段引用、运算符和全部函数说明;CLI 使用 builder app-form schema --schema-kind formula。需要配置结构化默认值时,传入当前 schema_version,并将字段的 questionType 作为 field_type 获取字段详细 Schema。",
|
|
121
|
+
"type": [
|
|
122
|
+
"null",
|
|
123
|
+
"string"
|
|
124
|
+
]
|
|
125
|
+
}
|
|
126
|
+
},
|
|
127
|
+
"$id": "https://builder.qingflow.com/schemas/app-form-apply/v1alpha1/fields/datetime.json",
|
|
128
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
129
|
+
"allOf": [
|
|
130
|
+
{
|
|
131
|
+
"$ref": "#/$defs/FieldCommon"
|
|
132
|
+
},
|
|
133
|
+
{
|
|
134
|
+
"properties": {
|
|
135
|
+
"config": {
|
|
136
|
+
"$ref": "#/$defs/EmptyConfig"
|
|
137
|
+
},
|
|
138
|
+
"questionType": {
|
|
139
|
+
"const": "datetime"
|
|
140
|
+
}
|
|
141
|
+
},
|
|
142
|
+
"required": [
|
|
143
|
+
"questionType"
|
|
144
|
+
]
|
|
145
|
+
}
|
|
146
|
+
],
|
|
147
|
+
"title": "Qingflow AppForm v1alpha1 datetime field",
|
|
148
|
+
"type": "object",
|
|
149
|
+
"unevaluatedProperties": false
|
|
150
|
+
}
|
|
@@ -0,0 +1,345 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$defs": {
|
|
3
|
+
"DepartmentConfig": {
|
|
4
|
+
"additionalProperties": false,
|
|
5
|
+
"description": "部门字段的可选范围配置。",
|
|
6
|
+
"properties": {
|
|
7
|
+
"beingShowParentPath": {
|
|
8
|
+
"type": [
|
|
9
|
+
"boolean",
|
|
10
|
+
"null"
|
|
11
|
+
]
|
|
12
|
+
},
|
|
13
|
+
"canScan": {
|
|
14
|
+
"type": [
|
|
15
|
+
"boolean",
|
|
16
|
+
"null"
|
|
17
|
+
]
|
|
18
|
+
},
|
|
19
|
+
"defaultDepartments": {
|
|
20
|
+
"$ref": "#/$defs/DepartmentScope"
|
|
21
|
+
},
|
|
22
|
+
"departmentScope": {
|
|
23
|
+
"$ref": "#/$defs/DepartmentScope"
|
|
24
|
+
},
|
|
25
|
+
"departmentScopeRelation": {
|
|
26
|
+
"$ref": "#/$defs/SelectScopeRelation"
|
|
27
|
+
},
|
|
28
|
+
"noRepeat": {
|
|
29
|
+
"type": [
|
|
30
|
+
"boolean",
|
|
31
|
+
"null"
|
|
32
|
+
]
|
|
33
|
+
},
|
|
34
|
+
"scanType": {
|
|
35
|
+
"minimum": 0,
|
|
36
|
+
"type": [
|
|
37
|
+
"integer",
|
|
38
|
+
"null"
|
|
39
|
+
]
|
|
40
|
+
}
|
|
41
|
+
},
|
|
42
|
+
"required": [
|
|
43
|
+
"departmentScope"
|
|
44
|
+
],
|
|
45
|
+
"type": "object"
|
|
46
|
+
},
|
|
47
|
+
"DepartmentScope": {
|
|
48
|
+
"description": "all 表示全部部门;custom 表示仅允许指定部门。",
|
|
49
|
+
"oneOf": [
|
|
50
|
+
{
|
|
51
|
+
"additionalProperties": false,
|
|
52
|
+
"properties": {
|
|
53
|
+
"includeSubDeparts": {
|
|
54
|
+
"description": "是否包含所选部门的下级部门。",
|
|
55
|
+
"type": "boolean"
|
|
56
|
+
},
|
|
57
|
+
"mode": {
|
|
58
|
+
"const": "all"
|
|
59
|
+
}
|
|
60
|
+
},
|
|
61
|
+
"required": [
|
|
62
|
+
"mode"
|
|
63
|
+
],
|
|
64
|
+
"type": "object"
|
|
65
|
+
},
|
|
66
|
+
{
|
|
67
|
+
"additionalProperties": false,
|
|
68
|
+
"properties": {
|
|
69
|
+
"departments": {
|
|
70
|
+
"description": "custom 模式允许选择的部门列表。",
|
|
71
|
+
"items": {
|
|
72
|
+
"$ref": "#/$defs/DepartmentSelector"
|
|
73
|
+
},
|
|
74
|
+
"minItems": 1,
|
|
75
|
+
"type": "array"
|
|
76
|
+
},
|
|
77
|
+
"includeSubDeparts": {
|
|
78
|
+
"description": "是否包含指定部门的下级部门。",
|
|
79
|
+
"type": "boolean"
|
|
80
|
+
},
|
|
81
|
+
"mode": {
|
|
82
|
+
"const": "custom"
|
|
83
|
+
}
|
|
84
|
+
},
|
|
85
|
+
"required": [
|
|
86
|
+
"mode",
|
|
87
|
+
"departments"
|
|
88
|
+
],
|
|
89
|
+
"type": "object"
|
|
90
|
+
},
|
|
91
|
+
{
|
|
92
|
+
"additionalProperties": false,
|
|
93
|
+
"properties": {
|
|
94
|
+
"includeSubDeparts": {
|
|
95
|
+
"type": "boolean"
|
|
96
|
+
},
|
|
97
|
+
"mode": {
|
|
98
|
+
"const": "relation"
|
|
99
|
+
}
|
|
100
|
+
},
|
|
101
|
+
"required": [
|
|
102
|
+
"mode"
|
|
103
|
+
],
|
|
104
|
+
"type": "object"
|
|
105
|
+
}
|
|
106
|
+
]
|
|
107
|
+
},
|
|
108
|
+
"DepartmentSelector": {
|
|
109
|
+
"additionalProperties": false,
|
|
110
|
+
"description": "部门身份;deptId 必填,deptName 仅用于展示。",
|
|
111
|
+
"properties": {
|
|
112
|
+
"deptId": {
|
|
113
|
+
"minimum": 1,
|
|
114
|
+
"type": "integer"
|
|
115
|
+
},
|
|
116
|
+
"deptName": {
|
|
117
|
+
"minLength": 1,
|
|
118
|
+
"type": "string"
|
|
119
|
+
}
|
|
120
|
+
},
|
|
121
|
+
"required": [
|
|
122
|
+
"deptId"
|
|
123
|
+
],
|
|
124
|
+
"type": "object"
|
|
125
|
+
},
|
|
126
|
+
"FieldCommon": {
|
|
127
|
+
"allOf": [
|
|
128
|
+
{
|
|
129
|
+
"if": {
|
|
130
|
+
"properties": {
|
|
131
|
+
"defaultType": {
|
|
132
|
+
"const": 2
|
|
133
|
+
}
|
|
134
|
+
},
|
|
135
|
+
"required": [
|
|
136
|
+
"defaultType"
|
|
137
|
+
]
|
|
138
|
+
},
|
|
139
|
+
"then": {
|
|
140
|
+
"properties": {
|
|
141
|
+
"defaultValue": {
|
|
142
|
+
"type": "null"
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
},
|
|
147
|
+
{
|
|
148
|
+
"if": {
|
|
149
|
+
"properties": {
|
|
150
|
+
"defaultType": {
|
|
151
|
+
"const": 3
|
|
152
|
+
}
|
|
153
|
+
},
|
|
154
|
+
"required": [
|
|
155
|
+
"defaultType"
|
|
156
|
+
]
|
|
157
|
+
},
|
|
158
|
+
"then": {
|
|
159
|
+
"properties": {
|
|
160
|
+
"defaultValue": {
|
|
161
|
+
"minLength": 1,
|
|
162
|
+
"type": [
|
|
163
|
+
"string",
|
|
164
|
+
"null"
|
|
165
|
+
]
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
],
|
|
171
|
+
"anyOf": [
|
|
172
|
+
{
|
|
173
|
+
"required": [
|
|
174
|
+
"queId"
|
|
175
|
+
]
|
|
176
|
+
},
|
|
177
|
+
{
|
|
178
|
+
"required": [
|
|
179
|
+
"name"
|
|
180
|
+
]
|
|
181
|
+
}
|
|
182
|
+
],
|
|
183
|
+
"description": "顶层业务字段的公共属性;字段类型由 TopField 的判别分支定义。",
|
|
184
|
+
"properties": {
|
|
185
|
+
"beingRequired": {
|
|
186
|
+
"description": "该字段是否必填;缺失时保留已有字段当前值。",
|
|
187
|
+
"type": "boolean"
|
|
188
|
+
},
|
|
189
|
+
"defaultType": {
|
|
190
|
+
"default": 1,
|
|
191
|
+
"description": "默认值类型,与 defaultValue 联动;1 表示静态值,2 表示关联/绑定值且 defaultValue 只能省略或为 null,3 表示公式值且提供 defaultValue 时必须为非空公式文本。省略 defaultType 但提供 defaultValue 时按 1 处理。",
|
|
192
|
+
"enum": [
|
|
193
|
+
1,
|
|
194
|
+
2,
|
|
195
|
+
3
|
|
196
|
+
],
|
|
197
|
+
"type": "integer"
|
|
198
|
+
},
|
|
199
|
+
"defaultValue": {
|
|
200
|
+
"$ref": "#/$defs/ScalarDefaultValue",
|
|
201
|
+
"description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
|
|
202
|
+
},
|
|
203
|
+
"name": {
|
|
204
|
+
"description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
|
|
205
|
+
"minLength": 1,
|
|
206
|
+
"type": "string"
|
|
207
|
+
},
|
|
208
|
+
"queId": {
|
|
209
|
+
"description": "已有字段的后端 ID;更新时用于精确定位并复用,新增字段通常省略。",
|
|
210
|
+
"minimum": 1,
|
|
211
|
+
"type": "integer"
|
|
212
|
+
},
|
|
213
|
+
"questionDescription": {
|
|
214
|
+
"description": "字段说明;null 或空字符串表示清空。",
|
|
215
|
+
"type": [
|
|
216
|
+
"string",
|
|
217
|
+
"null"
|
|
218
|
+
]
|
|
219
|
+
},
|
|
220
|
+
"questionType": {
|
|
221
|
+
"description": "字段类型;具体可用值由当前字段详情 Schema 的判别分支约束。",
|
|
222
|
+
"type": "string"
|
|
223
|
+
},
|
|
224
|
+
"width": {
|
|
225
|
+
"description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
|
|
226
|
+
"enum": [
|
|
227
|
+
25,
|
|
228
|
+
50,
|
|
229
|
+
75,
|
|
230
|
+
100
|
|
231
|
+
],
|
|
232
|
+
"type": "integer"
|
|
233
|
+
}
|
|
234
|
+
},
|
|
235
|
+
"type": "object"
|
|
236
|
+
},
|
|
237
|
+
"FieldSelector": {
|
|
238
|
+
"additionalProperties": false,
|
|
239
|
+
"anyOf": [
|
|
240
|
+
{
|
|
241
|
+
"required": [
|
|
242
|
+
"queId"
|
|
243
|
+
]
|
|
244
|
+
},
|
|
245
|
+
{
|
|
246
|
+
"required": [
|
|
247
|
+
"name"
|
|
248
|
+
]
|
|
249
|
+
}
|
|
250
|
+
],
|
|
251
|
+
"description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
|
|
252
|
+
"properties": {
|
|
253
|
+
"name": {
|
|
254
|
+
"description": "字段名称;仅在当前作用域内唯一时可用于解析。",
|
|
255
|
+
"minLength": 1,
|
|
256
|
+
"type": "string"
|
|
257
|
+
},
|
|
258
|
+
"queId": {
|
|
259
|
+
"description": "已有字段的后端 ID;优先用于精确解析。",
|
|
260
|
+
"minimum": 1,
|
|
261
|
+
"type": "integer"
|
|
262
|
+
}
|
|
263
|
+
},
|
|
264
|
+
"type": "object"
|
|
265
|
+
},
|
|
266
|
+
"ScalarDefaultValue": {
|
|
267
|
+
"description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。defaultType 为 3 时,通过 AppForm Schema 查询能力传入当前 schema_version 并设置 schema_kind=formula 获取公式语法、字段引用、运算符和全部函数说明;CLI 使用 builder app-form schema --schema-kind formula。需要配置结构化默认值时,传入当前 schema_version,并将字段的 questionType 作为 field_type 获取字段详细 Schema。",
|
|
268
|
+
"type": [
|
|
269
|
+
"null",
|
|
270
|
+
"string"
|
|
271
|
+
]
|
|
272
|
+
},
|
|
273
|
+
"SelectScopeRelation": {
|
|
274
|
+
"additionalProperties": false,
|
|
275
|
+
"properties": {
|
|
276
|
+
"displayedField": {
|
|
277
|
+
"$ref": "#/$defs/FieldSelector"
|
|
278
|
+
},
|
|
279
|
+
"displayedFieldType": {
|
|
280
|
+
"type": [
|
|
281
|
+
"integer",
|
|
282
|
+
"null"
|
|
283
|
+
]
|
|
284
|
+
},
|
|
285
|
+
"matchRuleFormula": {
|
|
286
|
+
"type": [
|
|
287
|
+
"string",
|
|
288
|
+
"null"
|
|
289
|
+
]
|
|
290
|
+
},
|
|
291
|
+
"matchRuleType": {
|
|
292
|
+
"type": [
|
|
293
|
+
"integer",
|
|
294
|
+
"null"
|
|
295
|
+
]
|
|
296
|
+
},
|
|
297
|
+
"matchRules": {
|
|
298
|
+
"type": [
|
|
299
|
+
"array",
|
|
300
|
+
"null"
|
|
301
|
+
]
|
|
302
|
+
},
|
|
303
|
+
"targetAppKey": {
|
|
304
|
+
"minLength": 1,
|
|
305
|
+
"type": "string"
|
|
306
|
+
},
|
|
307
|
+
"targetAppTitle": {
|
|
308
|
+
"type": [
|
|
309
|
+
"string",
|
|
310
|
+
"null"
|
|
311
|
+
]
|
|
312
|
+
}
|
|
313
|
+
},
|
|
314
|
+
"required": [
|
|
315
|
+
"displayedField",
|
|
316
|
+
"targetAppKey"
|
|
317
|
+
],
|
|
318
|
+
"type": "object"
|
|
319
|
+
}
|
|
320
|
+
},
|
|
321
|
+
"$id": "https://builder.qingflow.com/schemas/app-form-apply/v1alpha1/fields/department.json",
|
|
322
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
323
|
+
"allOf": [
|
|
324
|
+
{
|
|
325
|
+
"$ref": "#/$defs/FieldCommon"
|
|
326
|
+
},
|
|
327
|
+
{
|
|
328
|
+
"properties": {
|
|
329
|
+
"config": {
|
|
330
|
+
"$ref": "#/$defs/DepartmentConfig"
|
|
331
|
+
},
|
|
332
|
+
"questionType": {
|
|
333
|
+
"const": "department"
|
|
334
|
+
}
|
|
335
|
+
},
|
|
336
|
+
"required": [
|
|
337
|
+
"questionType",
|
|
338
|
+
"config"
|
|
339
|
+
]
|
|
340
|
+
}
|
|
341
|
+
],
|
|
342
|
+
"title": "Qingflow AppForm v1alpha1 department field",
|
|
343
|
+
"type": "object",
|
|
344
|
+
"unevaluatedProperties": false
|
|
345
|
+
}
|