用途:面向表单视图的数据语义服务 API,用于查询字段语义和业务对象识别结果、触发或批量理解表单视图、批量业务对象匹配。
主要能力:支持 list(查询逻辑视图列表,参数 keyword、datasource_id)、query(查询语义理解结果,参数 form_view_id)、understand(触发表单理解,参数 form_view_id 或 datasource_id)、batch(批量理解,form_view_ids,≤100 个)、match(批量对象匹配,参数 kn_id、ot_id、entries)。单视图 query/understand 输出字段语义表格、业务对象表格和属性表格;batch 仅输出统计报告。
使用方式:operation 与 auth_token 必填。示例:operation: list、keyword: 用户;operation: query、form_view_id: <uuid>;operation: understand、datasource_id: <uuid>;operation: match、kn_id、ot_id、entries: [{"name": "客户信息"}]。大数据量可用脚本:python scripts/data_semantic_batch.py --token <JWT> --datasource-id <UUID>;python scripts/data_semantic_batch.py --token <JWT> --view-ids <id1,id2>;python scripts/data_semantic_batch.py --token <JWT> --resume。
状态机:0 未理解、1 理解中、2 待确认、3 已完成、4 待确认(重新理解)、5 理解失败;批量理解时状态 3 或 4 都会触发重新理解。
限制:所有操作需有效 JWT;API 返回可能为 GBK,需用 latin1 解码;match 中文乱码可用 echo | curl -d @-;字段语义与业务对象来自不同表。数据量 ≤50 直接执行,>50 建议用 Python 脚本,>1000 提醒非工作时间执行,>5000 建议联系技术团队。