Files
aibridge/modules/visual_dev.py
T
2026-05-18 09:28:15 +08:00

330 lines
13 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""可视化开发核心模块
对应前端源码: 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")