@qingflow-tech/qingflow-cli 1.1.42 → 1.1.43-beta.2

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/q_linker.json

@@ -0,0 +1,357 @@
+{
+  "$defs": {
+    "FieldCommon": {
+      "description": "顶层业务字段的公共属性;字段类型由 TopField 的判别分支定义。",
+      "properties": {
+        "dataTitle": {
+          "description": "是否作为数据标题;整个 body 最多且必须按规则存在一个。",
+          "type": "boolean"
+        },
+        "defaultType": {
+          "default": 1,
+          "description": "默认值类型;1 表示静态值,2 表示关联/绑定值,3 表示公式值。",
+          "enum": [
+            1,
+            2,
+            3
+          ],
+          "type": "integer"
+        },
+        "defaultValue": {
+          "$ref": "#/$defs/ScalarDefaultValue",
+          "description": "普通字段的标量默认值;表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
+        },
+        "description": {
+          "description": "字段说明;null 或空字符串表示清空。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "name": {
+          "description": "字段展示名称;同一父级内唯一,不单独作为字段身份。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "queId": {
+          "description": "已有字段的后端 ID;get 返回,新增字段省略。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "required": {
+          "description": "是否必填;缺失时保留已有字段当前值。",
+          "type": "boolean"
+        },
+        "width": {
+          "description": "字段在所在行的宽度百分比;同一行要么全部提供且合计 100,要么全部省略。",
+          "maximum": 100,
+          "minimum": 1,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "type": "object"
+    },
+    "FieldSelector": {
+      "additionalProperties": false,
+      "anyOf": [
+        {
+          "required": [
+            "queId"
+          ]
+        },
+        {
+          "required": [
+            "name"
+          ]
+        }
+      ],
+      "description": "跨字段引用选择器;至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
+      "properties": {
+        "name": {
+          "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "queId": {
+          "description": "已有字段的后端 ID;优先用于精确解析。",
+          "minimum": 1,
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "QLinkerBinding": {
+      "additionalProperties": false,
+      "description": "Q-Linker 的输入映射、请求配置和输出映射。",
+      "properties": {
+        "inputs": {
+          "description": "将当前表单字段映射到请求参数的规则。",
+          "items": {
+            "$ref": "#/$defs/QLinkerInputBinding"
+          },
+          "type": "array"
+        },
+        "outputs": {
+          "description": "将响应路径映射到目标字段的规则;至少一个。",
+          "items": {
+            "$ref": "#/$defs/QLinkerOutputBinding"
+          },
+          "minItems": 1,
+          "type": "array"
+        },
+        "request": {
+          "$ref": "#/$defs/QLinkerRequest",
+          "description": "远程请求配置。"
+        }
+      },
+      "required": [
+        "request",
+        "outputs"
+      ],
+      "type": "object"
+    },
+    "QLinkerConfig": {
+      "additionalProperties": false,
+      "description": "Q-Linker 的高层声明;无法无损还原为该结构时阻断处理。",
+      "properties": {
+        "qLinkerBinding": {
+          "$ref": "#/$defs/QLinkerBinding"
+        }
+      },
+      "required": [
+        "qLinkerBinding"
+      ],
+      "type": "object"
+    },
+    "QLinkerInputBinding": {
+      "additionalProperties": false,
+      "description": "一个表单字段到请求参数的映射。",
+      "properties": {
+        "field": {
+          "$ref": "#/$defs/FieldSelector",
+          "description": "输入来源字段。"
+        },
+        "key": {
+          "description": "请求中的参数名。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "source": {
+          "description": "参数写入请求的位置。",
+          "enum": [
+            "query_param",
+            "header",
+            "url_encoded",
+            "json_path"
+          ]
+        }
+      },
+      "required": [
+        "field",
+        "key",
+        "source"
+      ],
+      "type": "object"
+    },
+    "QLinkerKeyValue": {
+      "additionalProperties": false,
+      "description": "HTTP 请求中的键值对。",
+      "properties": {
+        "key": {
+          "description": "参数名。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "value": {
+          "description": "参数值;null 表示空值。",
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "key"
+      ],
+      "type": "object"
+    },
+    "QLinkerOutputBinding": {
+      "additionalProperties": false,
+      "description": "一个响应值到表单目标字段的映射。",
+      "properties": {
+        "alias": {
+          "description": "输出别名;用于后续数据关联引用。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "aliasId": {
+          "description": "后端生成的输出别名 ID;新增输出时可省略,get 返回后必须保留。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "path": {
+          "description": "从响应中取值的 JSONPath。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "targetField": {
+          "$ref": "#/$defs/FieldSelector",
+          "description": "接收结果的当前表单字段。"
+        }
+      },
+      "required": [
+        "alias",
+        "path",
+        "targetField"
+      ],
+      "type": "object"
+    },
+    "QLinkerRequest": {
+      "additionalProperties": false,
+      "description": "Q-Linker 远程 HTTP 请求配置。",
+      "properties": {
+        "autoTrigger": {
+          "description": "是否在输入变化时自动触发请求。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "bodyType": {
+          "default": "url_encoded",
+          "description": "请求体格式;分别映射后端 bodyType 1、2、3。",
+          "enum": [
+            "url_encoded",
+            "json",
+            "xml"
+          ]
+        },
+        "customButtonText": {
+          "description": "自定义触发按钮文案。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "customButtonTextEnabled": {
+          "description": "是否启用自定义触发按钮文案。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "headers": {
+          "description": "请求头键值对。",
+          "items": {
+            "$ref": "#/$defs/QLinkerKeyValue"
+          },
+          "type": "array"
+        },
+        "hideOnForm": {
+          "description": "是否在表单填写界面隐藏该 Q-Linker 字段。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "insertValueDirectly": {
+          "description": "是否把请求结果直接写入目标字段。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "jsonValue": {
+          "description": "bodyType 为 json 时的 JSON 请求体字符串。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "method": {
+          "default": "GET",
+          "description": "HTTP 方法;当前 Q-Linker 仅支持 GET 和 POST,缺失时按 GET 处理。",
+          "enum": [
+            "GET",
+            "POST"
+          ]
+        },
+        "queryParams": {
+          "description": "URL 查询参数键值对。",
+          "items": {
+            "$ref": "#/$defs/QLinkerKeyValue"
+          },
+          "type": "array"
+        },
+        "resultType": {
+          "default": "json",
+          "description": "响应解析格式;分别映射后端 resultType 1、2、3。",
+          "enum": [
+            "json",
+            "xml",
+            "text"
+          ]
+        },
+        "url": {
+          "description": "请求 URL。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "urlEncodedValue": {
+          "description": "bodyType 为 url_encoded 时的表单键值对。",
+          "items": {
+            "$ref": "#/$defs/QLinkerKeyValue"
+          },
+          "type": "array"
+        },
+        "xmlValue": {
+          "description": "bodyType 为 xml 时的 XML 请求体字符串。",
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "url"
+      ],
+      "type": "object"
+    },
+    "ScalarDefaultValue": {
+      "description": "不包含对象或数组的普通字段默认值。",
+      "type": [
+        "null",
+        "boolean",
+        "number",
+        "string"
+      ]
+    }
+  },
+  "$id": "https://builder.qingflow.com/schemas/app-form-apply/v1alpha1/fields/q_linker.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "allOf": [
+    {
+      "$ref": "#/$defs/FieldCommon"
+    },
+    {
+      "properties": {
+        "config": {
+          "$ref": "#/$defs/QLinkerConfig"
+        },
+        "type": {
+          "const": "q_linker"
+        }
+      },
+      "required": [
+        "type",
+        "config"
+      ]
+    }
+  ],
+  "title": "Qingflow AppForm v1alpha1 q_linker field",
+  "type": "object",
+  "unevaluatedProperties": false
+}