"""可视化开发核心模块 对应前端源码: api/onlineDev/visualDev.ts 包含功能 CRUD、发布、复制、配置获取、代码生成、AI 表单、OCR 等 """ import json from typing import Optional from aibridge.client import JNPFClient from aibridge.models import APIResponse class VisualDevAPI: """可视化开发 API""" def __init__(self, client: JNPFClient): self._client = client self._prefix = "/api/visualdev/Base" self._online_prefix = "/api/visualdev/OnlineDev" self._gen_prefix = "/api/visualdev/Generater" self._personal_prefix = "/api/visualdev/personal" self._log_prefix = "/api/visualdev/OnlineLog" # ==================== 功能 CRUD ==================== def get_list(self, data: dict = None) -> APIResponse: """获取功能列表""" return self._client.request("GET", self._prefix, params=data) # ==================== 重复检查 ==================== def check_en_code_exists(self, en_code: str) -> bool: """检查功能编码是否已存在 Args: en_code: 功能编码 Returns: True=已存在,False=不存在 """ resp = self.get_list({"keyword": en_code, "currentPage": 1, "pageSize": 20}) if resp.code != 200: return False for item in resp.data.get("list", []): if item.get("enCode") == en_code: return True return False def check_name_exists(self, full_name: str) -> bool: """检查功能名称是否已存在 Args: full_name: 功能名称 Returns: True=已存在,False=不存在 """ resp = self.get_list({"keyword": full_name, "currentPage": 1, "pageSize": 20}) if resp.code != 200: return False for item in resp.data.get("list", []): if item.get("fullName") == full_name: return True return False def get_id_by_en_code(self, en_code: str) -> Optional[str]: """通过编码查询功能 ID Args: en_code: 功能编码 Returns: 功能 ID,未找到返回 None """ resp = self.get_list({"keyword": en_code, "currentPage": 1, "pageSize": 20}) if resp.code != 200: return None for item in resp.data.get("list", []): if item.get("enCode") == en_code: return item.get("id") return None def get_form_list(self, data: dict = None) -> APIResponse: """获取功能列表(集成助手用)""" return self._client.request("GET", f"{self._prefix}/list", params=data) def create(self, data: dict) -> APIResponse: """新建功能""" return self._client.request("POST", self._prefix, data=data) def update(self, data: dict) -> APIResponse: """修改功能""" func_id = data.get("id") return self._client.request("PUT", f"{self._prefix}/{func_id}", data=data) def get_info(self, func_id: str) -> APIResponse: """获取功能详情""" return self._client.request("GET", f"{self._prefix}/{func_id}") def delete(self, func_id: str) -> APIResponse: """删除功能""" return self._client.request("DELETE", f"{self._prefix}/{func_id}") def soft_delete(self, func_id: str) -> APIResponse: """软删除功能 - 修改属性使其不可见且不冲突 由于 JNPF 平台删除后重新创建同名/同编码功能会提示已存在, 此方法通过以下方式软删除: 1. 功能名加上 ID 后缀(避免名称冲突) 2. en_code 改为 func_{id}(避免编码冲突) 3. sortCode 设为极大值(沉底,不影响正常查看) Args: func_id: 要删除的功能 ID Returns: APIResponse """ resp = self.get_info(func_id) if resp.code != 200: return resp data = resp.data.copy() # 名称加 ID 后缀 original_name = data.get("fullName", "") if f"({func_id})" not in original_name: data["fullName"] = f"{original_name}({func_id})" # en_code 改为 func_{id} data["enCode"] = f"func_{func_id}" # 排序码沉底 data["sortCode"] = 999999 return self.update(data) def copy(self, func_id: str) -> APIResponse: """复制功能""" return self._client.request("POST", f"{self._prefix}/{func_id}/Actions/Copy") def release(self, func_id: str) -> APIResponse: """发布功能(复制到 base_visual_release,state 设为 1)""" return self._client.request("POST", f"{self._prefix}/{func_id}/Actions/Release") def get_release_menu(self, func_id: str) -> APIResponse: """获取已发布菜单""" return self._client.request("GET", f"{self._prefix}/{func_id}/getReleaseMenu") def create_menu(self, func_id: str, data: dict) -> APIResponse: """生成菜单""" return self._client.request("POST", f"{self._prefix}/{func_id}/Actions/Module", data=data) def get_form_data_fields(self, func_id: str, filter_type: int = 0) -> APIResponse: """获取表单主表属性列表""" return self._client.request("GET", f"{self._prefix}/{func_id}/FormDataFields", params={"filterType": filter_type}) def get_field_data_select(self, data: dict) -> APIResponse: """获取表单主表数据下拉框""" model_id = data.get("modelId") return self._client.request("GET", f"{self._prefix}/{model_id}/FieldDataSelect", params=data) def get_selector(self, data: dict = None) -> APIResponse: """获取功能下拉框列表""" return self._client.request("GET", f"{self._prefix}/Selector", params=data) def get_column_list(self, data: dict) -> APIResponse: """获取列表字段""" return self._client.request("GET", f"{self._prefix}/getColumnList", params=data) def get_list_by_system(self, data: dict) -> APIResponse: """获取跨应用菜单""" return self._client.request("GET", f"{self._prefix}/getListBySystem", params=data) # ==================== OnlineDev 数据操作 ==================== def get_config(self, model_id: str, data: dict = None) -> APIResponse: """获取列表表单配置 JSON""" return self._client.request("GET", f"{self._online_prefix}/{model_id}/Config", params=data) def get_config_by_menu_id(self, data: dict = None) -> APIResponse: """通过菜单 ID 获取列表表单配置 JSON""" return self._client.request("GET", f"{self._online_prefix}/Config", params=data) def get_form_data(self, model_id: str) -> APIResponse: """获取表单配置 JSON""" return self._client.request("GET", f"{self._online_prefix}/{model_id}/FormData") def get_model_list(self, model_id: str, data: dict) -> APIResponse: """获取数据列表""" return self._client.request("POST", f"{self._online_prefix}/{model_id}/List", data=data) def create_model(self, model_id: str, data: dict, menu_id: str = "") -> APIResponse: """新建数据 注意:JNPF API 返回不包含 data 字段,此方法会通过查询列表最近一条数据id,非常微弱几率可能有覆盖情况 自动补充返回的 id 属性。 """ payload = {"data": json.dumps(data, ensure_ascii=False)} if menu_id: payload["menuId"] = menu_id resp = self._client.request("POST", f"{self._online_prefix}/{model_id}", data=payload) # JNPF create API 不返回 data/id,通过查询列表补充 if resp.success: list_resp = self.get_model_list(model_id, {"currentPage": 1, "pageSize": 1}) if list_resp.success and list_resp.data: records = list_resp.data.get("list", []) if records: resp.id = records[0].get("id") resp.data = {"id": resp.id} return resp def update_model(self, model_id: str, data: dict) -> APIResponse: """修改数据""" record_id = data.get("id") payload = {"id": record_id, "data": json.dumps(data, ensure_ascii=False)} return self._client.request("PUT", f"{self._online_prefix}/{model_id}/{record_id}", data=payload) def get_model_info(self, model_id: str, record_id: str, menu_id: str = "") -> APIResponse: """获取数据详情""" return self._client.request("GET", f"{self._online_prefix}/{model_id}/{record_id}", params={"menuId": menu_id}) def delete_model(self, model_id: str, record_id: str) -> APIResponse: """删除数据""" return self._client.request("DELETE", f"{self._online_prefix}/{model_id}/{record_id}") def batch_delete_model(self, model_id: str, data: dict) -> APIResponse: """批量删除数据""" return self._client.request("POST", f"{self._online_prefix}/batchDelete/{model_id}", data=data) def get_data_change(self, model_id: str, data: dict) -> APIResponse: """获取数据详情(变更对比)""" return self._client.request("POST", f"{self._online_prefix}/{model_id}/DataChange", data=data) def export_model_data(self, model_id: str, data: dict) -> APIResponse: """导出数据""" return self._client.request("POST", f"{self._online_prefix}/{model_id}/Actions/ExportData", data=data) def get_template(self, model_id: str) -> APIResponse: """下载导入模板""" return self._client.request("GET", f"{self._online_prefix}/{model_id}/Template") def export_data(self, model_id: str) -> APIResponse: """导出模板""" return self._client.request("POST", f"{self._online_prefix}/{model_id}/Actions/Export") def launch_flow(self, model_id: str, data: dict) -> APIResponse: """自定义按钮发起流程""" return self._client.request("POST", f"{self._online_prefix}/{model_id}/actionLaunchFlow", data=data) def get_relation_query(self, data: dict) -> APIResponse: """获取关联查询数据列表""" return self._client.request("POST", f"{self._online_prefix}/RelationQuery", data=data) def get_data_log_list(self, data: dict) -> APIResponse: """获取修改记录列表""" return self._client.request("GET", self._log_prefix, params=data) # ==================== 个人视图 ==================== def get_view_list(self, data: dict) -> APIResponse: """获取视图列表""" return self._client.request("GET", self._personal_prefix, params=data) def create_view(self, data: dict) -> APIResponse: """新建视图""" return self._client.request("POST", self._personal_prefix, data=data) def update_view(self, data: dict) -> APIResponse: """修改视图""" view_id = data.get("id") return self._client.request("PUT", f"{self._personal_prefix}/{view_id}", data=data) def delete_view(self, view_id: str, menu_id: str) -> APIResponse: """删除视图""" return self._client.request("DELETE", f"{self._personal_prefix}/{view_id}?menuId={menu_id}") def set_default_view(self, view_id: str, menu_id: str) -> APIResponse: """设置默认视图""" return self._client.request("PUT", f"{self._personal_prefix}/{view_id}/setDefault?menuId={menu_id}") # ==================== 代码生成(基础)==================== def download_code(self, func_id: str, data: dict = None) -> APIResponse: """下载代码""" params = data or {} return self._client.request("POST", f"{self._gen_prefix}/{func_id}/Actions/DownloadCode", data=params) def code_preview(self, func_id: str, data: dict = None) -> APIResponse: """代码预览""" params = data or {} return self._client.request("POST", f"{self._gen_prefix}/{func_id}/Actions/CodePreview", data=params) def get_alias_info(self, func_id: str) -> APIResponse: """获取代码生成命名规范""" return self._client.request("GET", f"{self._gen_prefix}/{func_id}/Alias/Info") def save_alias(self, func_id: str, data: dict) -> APIResponse: """更新代码生成命名规范""" return self._client.request("POST", f"{self._gen_prefix}/{func_id}/Alias/Save", data=data) # ==================== AI / OCR / 跨应用 ==================== def get_ai_info(self, data: dict) -> APIResponse: """获取 AI 字段(AI 表单生成)""" return self._client.request("POST", "/api/visualdev/ai/form", data=data) def get_ocr_data(self, data: dict) -> APIResponse: """OCR 识别""" return self._client.request("POST", "/api/visualdev/ocr", data=data) def get_share_list(self) -> APIResponse: """获取跨应用表单列表""" return self._client.request("GET", "/api/visualdev/share") def get_share_info(self, ids: list) -> APIResponse: """获取跨应用表单详情""" return self._client.request("POST", "/api/visualdev/share/SelectedList", data={"ids": ids}) def save_share(self, data: dict) -> APIResponse: """保存跨应用回显""" return self._client.request("POST", "/api/visualdev/share/save", data=data) def get_share_selector(self) -> APIResponse: """获取功能下拉框列表(包含跨应用表单)""" return self._client.request("GET", "/api/visualdev/share/Selector")