330 lines
13 KiB
Python
330 lines
13 KiB
Python
"""可视化开发核心模块
|
||
|
||
对应前端源码: 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") |