a
This commit is contained in:
coco
@@ -0,0 +1,358 @@
|
||||
# 项目管理界面
|
||||
|
||||
<cite>
|
||||
**本文档引用的文件**
|
||||
- [taskmngframe.cpp](file://cpp/Views/taskmngframe.cpp)
|
||||
- [DialNew1DTask.cpp](file://cpp/Views/DialNew1DTask.cpp)
|
||||
- [DialNew2DTask.cpp](file://cpp/Views/DialNew2DTask.cpp)
|
||||
- [DialNew3DTask.cpp](file://cpp/Views/DialNew3DTask.cpp)
|
||||
- [DialCfgTaskPacket.cpp](file://cpp/Views/DialCfgTaskPacket.cpp)
|
||||
- [DialCfgTerrain.cpp](file://cpp/Views/DialCfgTerrain.cpp)
|
||||
- [DialTaskTree.cpp](file://cpp/Views/DialTaskTree.cpp)
|
||||
- [DialTaskManager.cpp](file://cpp/Views/DialTaskManager.cpp)
|
||||
- [ProManager.cpp](file://cpp/Managers/ProManager.cpp)
|
||||
</cite>
|
||||
|
||||
## 目录
|
||||
1. [任务管理框架与导航逻辑](#任务管理框架与导航逻辑)
|
||||
2. [测量任务创建流程](#测量任务创建流程)
|
||||
3. [任务包配置机制](#任务包配置机制)
|
||||
4. [地形参数设置逻辑](#地形参数设置逻辑)
|
||||
5. [任务树形视图构建与交互](#任务树形视图构建与交互)
|
||||
6. [项目数据持久化与加载](#项目数据持久化与加载)
|
||||
7. [任务参数验证与数据传递](#任务参数验证与数据传递)
|
||||
8. [任务配置工作流](#任务配置工作流)
|
||||
9. [UI响应性能优化建议](#ui响应性能优化建议)
|
||||
|
||||
## 任务管理框架与导航逻辑
|
||||
|
||||
任务管理框架由`taskmngframe.cpp`实现，作为MDI子窗口继承自`CMDIChildWnd`。该框架负责组织和管理所有与任务相关的UI组件，提供统一的导航界面。框架通过消息映射处理窗口激活、关闭等事件，确保在用户切换不同任务管理视图时能够正确更新状态和界面元素。
|
||||
|
||||
**Section sources**
|
||||
- [taskmngframe.cpp](file://cpp/Views/taskmngframe.cpp#L1-L36)
|
||||
|
||||
## 测量任务创建流程
|
||||
|
||||
### 1D测量任务创建
|
||||
|
||||
`DialNew1DTask.cpp`实现了1D测量任务的创建对话框。该对话框初始化时会根据当前UI语言设置控件文本，并从`CTaskDataOper`操作类查询可用的介质类型和脚本信息。用户选择测试类型（电阻率、激电、自电）后，系统会动态更新发射波形和发射周期的选项。在用户点击"创建"按钮后，系统会执行完整的参数验证，包括任务名、测试方式、装置类型、脚本、迭代次数等，确保所有必填项都已正确填写且符合取值范围。
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
Start([开始创建1D任务]) --> Init["初始化对话框\n设置语言、加载介质和脚本"]
|
||||
Init --> SelectType["用户选择测试类型\n(电阻率/激电/自电)"]
|
||||
SelectType --> UpdateOptions["更新发射波形和周期选项"]
|
||||
UpdateOptions --> UserInput["用户输入任务参数\n任务名、位置、脚本等"]
|
||||
UserInput --> Validate["点击创建时验证参数"]
|
||||
Validate --> CheckName{"任务名为空?"}
|
||||
CheckName --> |是| ShowError1["显示错误提示"]
|
||||
CheckName --> |否| CheckType{"测试方式未选?"}
|
||||
CheckType --> |是| ShowError2["显示错误提示"]
|
||||
CheckType --> |否| CheckArray{"装置类型未选?"}
|
||||
CheckArray --> |是| ShowError3["显示错误提示"]
|
||||
CheckArray --> |否| CheckScript{"脚本未选?"}
|
||||
CheckScript --> |是| ShowError4["显示错误提示"]
|
||||
CheckScript --> |否| CheckStacking{"迭代次数有效?"}
|
||||
CheckStacking --> |否| ShowError5["显示错误提示"]
|
||||
CheckStacking --> |是| CreateTask["调用CTaskDataOper::Create1DTask\n创建任务"]
|
||||
CreateTask --> Success{"创建成功?"}
|
||||
Success --> |是| CloseDialog["关闭对话框"]
|
||||
Success --> |否| Return["返回等待用户修正"]
|
||||
ShowError1 --> Return
|
||||
ShowError2 --> Return
|
||||
ShowError3 --> Return
|
||||
ShowError4 --> Return
|
||||
ShowError5 --> Return
|
||||
```
|
||||
|
||||
**Diagram sources**
|
||||
- [DialNew1DTask.cpp](file://cpp/Views/DialNew1DTask.cpp#L1-L381)
|
||||
|
||||
### 2D测量任务创建
|
||||
|
||||
`DialNew2DTask.cpp`实现了2D测量任务的创建对话框。与1D任务相比，2D任务需要更多的参数配置，包括电缆布线方式、起始/结束电极、电极间距、孔间距（对于交叉孔装置）等。对话框在初始化时会根据装置类型动态显示或隐藏相关控件，例如交叉孔装置会显示孔间距输入框。当用户选择不同的测试类型时，系统会过滤可用的电缆布线方式，确保选择的配置是有效的。
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
Start([开始创建2D任务]) --> Init["初始化对话框\n加载介质、脚本、电缆布局"]
|
||||
Init --> SelectType["用户选择测试类型"]
|
||||
SelectType --> FilterLayout["根据测试类型过滤\n电缆布线方式"]
|
||||
FilterLayout --> UserInput["用户输入任务参数\n包括电极间距、起始/结束电极等"]
|
||||
UserInput --> Validate["点击创建时验证参数"]
|
||||
Validate --> CheckCommon["验证通用参数\n(任务名、测试方式等)"]
|
||||
CheckCommon --> CheckSpace{"电极间距为零?"}
|
||||
CheckSpace --> |是| ShowError1["显示错误提示"]
|
||||
CheckSpace --> |否| CheckHole{"交叉孔装置且孔间距为零?"}
|
||||
CheckHole --> |是| ShowError2["显示错误提示"]
|
||||
CheckHole --> |否| CheckRange{"起始/结束电极越界?"}
|
||||
CheckRange --> |是| ShowError3["显示错误提示"]
|
||||
CheckRange --> |否| CreateTask["调用CTaskDataOper::Create2DTask\n创建任务"]
|
||||
CreateTask --> Success{"创建成功?"}
|
||||
Success --> |是| CloseDialog["关闭对话框"]
|
||||
Success --> |否| Return["返回等待用户修正"]
|
||||
ShowError1 --> Return
|
||||
ShowError2 --> Return
|
||||
ShowError3 --> Return
|
||||
```
|
||||
|
||||
**Diagram sources**
|
||||
- [DialNew2DTask.cpp](file://cpp/Views/DialNew2DTask.cpp#L1-L665)
|
||||
|
||||
### 3D测量任务创建
|
||||
|
||||
`DialNew3DTask.cpp`实现了3D测量任务的创建对话框。3D任务的配置最为复杂，需要设置网格大小、X/Y方向电极步长和距离等参数。当用户选择脚本时，系统会自动查询并显示网格信息（X和Y方向的点数），帮助用户理解测量范围。对话框还提供了发射周期的"自动"选项，为用户提供更灵活的配置选择。
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
Start([开始创建3D任务]) --> Init["初始化对话框\n加载介质、脚本、电缆布局"]
|
||||
Init --> SelectScript["用户选择脚本"]
|
||||
SelectScript --> QueryGrid["查询并显示网格信息\n(X方向点数, Y方向点数)"]
|
||||
QueryGrid --> UserInput["用户输入任务参数\n包括步长、距离等"]
|
||||
UserInput --> Validate["点击创建时验证参数"]
|
||||
Validate --> CheckCommon["验证通用参数\n(任务名、测试方式等)"]
|
||||
CheckCommon --> CheckStep{"步长为空?"}
|
||||
CheckStep --> |是| ShowError["显示错误提示"]
|
||||
CheckStep --> |否| CreateTask["调用CTaskDataOper::Create3DTask\n创建任务"]
|
||||
CreateTask --> Success{"创建成功?"}
|
||||
Success --> |是| CloseDialog["关闭对话框"]
|
||||
Success --> |否| Return["返回等待用户修正"]
|
||||
ShowError --> Return
|
||||
```
|
||||
|
||||
**Diagram sources**
|
||||
- [DialNew3DTask.cpp](file://cpp/Views/DialNew3DTask.cpp#L1-L570)
|
||||
|
||||
## 任务包配置机制
|
||||
|
||||
`DialCfgTaskPacket.cpp`实现了任务包的配置对话框，允许用户将多个任务组织成一个任务包进行循环执行。对话框包含一个任务选择下拉框和一个任务列表，用户可以将选中的任务添加到列表中，也可以从列表中删除任务。系统会检查重复添加的任务，避免同一个任务被多次执行。
|
||||
|
||||
在用户点击"保存"时，系统会对输入的参数进行严格验证：
|
||||
- 循环次数必须在1-60000之间
|
||||
- 时间间隔必须在1-60000之间
|
||||
- PLC ID不能为空
|
||||
|
||||
验证通过后，系统会将任务列表和属性信息保存到数据库中，供后续执行使用。
|
||||
|
||||
```mermaid
|
||||
classDiagram
|
||||
class CDialCfgTaskPacket {
|
||||
+m_cmbTaskName : CComboBox
|
||||
+m_listTaskPacket : CListCtrl
|
||||
+m_cmbTaskName : CComboBox
|
||||
+OnButtonAdd() void
|
||||
+OnButtonDel() void
|
||||
+OnOK() void
|
||||
+IsRepeatTask(int) bool
|
||||
+InitialTaskList() void
|
||||
}
|
||||
class CTaskDataOper {
|
||||
+QueryTdBrowseInfo() void
|
||||
+QueryTaskPacketAttr() bool
|
||||
+InsertTaskPacketInfo() bool
|
||||
}
|
||||
CDialCfgTaskPacket --> CTaskDataOper : "使用"
|
||||
```
|
||||
|
||||
**Diagram sources**
|
||||
- [DialCfgTaskPacket.cpp](file://cpp/Views/DialCfgTaskPacket.cpp#L1-L301)
|
||||
|
||||
## 地形参数设置逻辑
|
||||
|
||||
`DialCfgTerrain.cpp`实现了地形参数的配置对话框，允许用户导入DAT文件并编辑地形数据点。对话框提供了添加、修改、删除地形数据点的功能，并支持从文件导入地形数据。用户可以设置地形数据标志（水平距离或垂直距离）和第一个电极对应的地形数据点编号。
|
||||
|
||||
在保存地形数据时，系统会执行严格的验证：
|
||||
- 必须已导入DAT文件
|
||||
- 必须选择地形数据标志
|
||||
- 必须输入至少一个地形数据点
|
||||
- 第一个电极对应的地形数据点编号必须在有效范围内
|
||||
|
||||
验证通过后，系统会将地形数据写入原DAT文件的末尾，遵循特定的文件格式要求。
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
Start([开始配置地形]) --> ImportFile["用户导入DAT文件"]
|
||||
ImportFile --> EditData["编辑地形数据点\n添加、修改、删除"]
|
||||
EditData --> SetParams["设置地形参数\n标志、第一个电极编号"]
|
||||
SetParams --> Save["点击保存"]
|
||||
Save --> Validate["验证参数"]
|
||||
Validate --> CheckFile{"已导入文件?"}
|
||||
CheckFile --> |否| ShowError1["显示错误提示"]
|
||||
CheckFile --> |是| CheckFlag{"选择数据标志?"}
|
||||
CheckFlag --> |否| ShowError2["显示错误提示"]
|
||||
CheckFlag --> |是| CheckData{"输入地形数据?"}
|
||||
CheckData --> |否| ShowError3["显示错误提示"]
|
||||
CheckData --> |是| CheckIndex{"第一个电极编号有效?"}
|
||||
CheckIndex --> |否| ShowError4["显示错误提示"]
|
||||
CheckIndex --> |是| WriteFile["将地形数据写入DAT文件"]
|
||||
WriteFile --> Success{"写入成功?"}
|
||||
Success --> |是| ShowSuccess["显示成功提示"]
|
||||
Success --> |否| ShowFail["显示失败提示"]
|
||||
ShowError1 --> Return["返回等待用户修正"]
|
||||
ShowError2 --> Return
|
||||
ShowError3 --> Return
|
||||
ShowError4 --> Return
|
||||
```
|
||||
|
||||
**Diagram sources**
|
||||
- [DialCfgTerrain.cpp](file://cpp/Views/DialCfgTerrain.cpp#L1-L843)
|
||||
|
||||
## 任务树形视图构建与交互
|
||||
|
||||
### 任务树形视图构建
|
||||
|
||||
`DialTaskTree.cpp`实现了任务树形视图，使用`CTreeCtrl`控件显示任务列表。视图支持复选框功能，允许用户选择多个任务进行批量操作。视图初始化时会根据任务类型（2D或3D）从服务器获取任务数据，并构建树形结构。
|
||||
|
||||
```mermaid
|
||||
classDiagram
|
||||
class CDialTaskTree {
|
||||
+m_treeTask : CTreeCtrl
|
||||
+m_iSptType : int
|
||||
+m_pParentWnd : CWnd*
|
||||
+ShowTaskTree(int, time_t, time_t) void
|
||||
+OnClickTreeTaskList() void
|
||||
+OnNMRClickTreeTaskList() void
|
||||
+OnAddNewItemToTaskList() bool
|
||||
+OnClearTaskList() void
|
||||
}
|
||||
class CTaskDataOper {
|
||||
+InitOnLineTaskTreeCtrl() void
|
||||
+SetCurrentTimeRange() void
|
||||
}
|
||||
CDialTaskTree --> CTaskDataOper : "使用"
|
||||
```
|
||||
|
||||
**Diagram sources**
|
||||
- [DialTaskTree.cpp](file://cpp/Views/DialTaskTree.cpp#L1-L686)
|
||||
|
||||
### 任务树形视图交互
|
||||
|
||||
任务树形视图支持丰富的交互功能：
|
||||
- 点击复选框：选择或取消选择任务，同时更新父节点的选中计数
|
||||
- 右键点击：显示上下文菜单，提供创建任务、删除任务、取消测试、刷新列表等操作
|
||||
- 点击任务节点：通知父窗口当前选中的任务
|
||||
|
||||
上下文菜单的选项会根据当前UI语言动态调整文本内容，确保用户界面的国际化支持。
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant User as "用户"
|
||||
participant Tree as "任务树"
|
||||
participant Parent as "父窗口"
|
||||
User->>Tree : 右键点击任务节点
|
||||
Tree->>Tree : 显示上下文菜单
|
||||
User->>Tree : 选择"删除任务"
|
||||
Tree->>Parent : 发送WM_MSG_DELETE_TASK消息
|
||||
Parent->>Parent : 处理删除任务逻辑
|
||||
Parent->>Tree : 刷新任务列表
|
||||
Tree->>User : 显示操作结果
|
||||
```
|
||||
|
||||
**Diagram sources**
|
||||
- [DialTaskTree.cpp](file://cpp/Views/DialTaskTree.cpp#L1-L686)
|
||||
|
||||
## 项目数据持久化与加载
|
||||
|
||||
`ProManager.cpp`实现了项目管理器，负责项目数据的持久化与加载。项目管理器通过`CProManager`类与数据库交互，实现项目和测区的创建、查询和同步功能。
|
||||
|
||||
项目创建流程包括：
|
||||
1. 在数据库中创建项目记录
|
||||
2. 在设备上创建项目文件夹和配置文件
|
||||
3. 同步项目数据到设备
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant UI as "用户界面"
|
||||
participant ProMgr as "CProManager"
|
||||
participant DB as "数据库"
|
||||
participant Dev as "设备"
|
||||
UI->>ProMgr : 创建项目
|
||||
ProMgr->>ProMgr : 显示创建对话框
|
||||
ProMgr->>ProMgr : 验证项目名称唯一性
|
||||
ProMgr->>DB : 插入项目记录
|
||||
DB-->>ProMgr : 返回项目ID
|
||||
ProMgr->>Dev : 在设备上创建项目文件夹
|
||||
Dev-->>ProMgr : 文件夹创建成功
|
||||
ProMgr->>Dev : 发送项目配置文件
|
||||
Dev-->>ProMgr : 文件发送成功
|
||||
ProMgr->>DB : 记录同步状态
|
||||
DB-->>ProMgr : 同步记录创建成功
|
||||
ProMgr-->>UI : 显示创建成功
|
||||
```
|
||||
|
||||
**Diagram sources**
|
||||
- [ProManager.cpp](file://cpp/Managers/ProManager.cpp#L1-L2054)
|
||||
|
||||
## 任务参数验证与数据传递
|
||||
|
||||
### 任务参数验证
|
||||
|
||||
系统在创建任务时执行严格的参数验证，确保所有输入都符合业务规则：
|
||||
- **必填项验证**：任务名、测试方式、装置类型、脚本等必须填写
|
||||
- **取值范围验证**：迭代次数(1-255)、采样间隔(0-30000)、电极间距(>0)等
|
||||
- **逻辑关系验证**：交叉孔装置的孔间距必须大于电极间距
|
||||
- **唯一性验证**：任务包中不能包含重复任务
|
||||
|
||||
### 跨对话框数据传递
|
||||
|
||||
系统通过多种机制实现跨对话框的数据传递：
|
||||
- **构造函数传递**：在创建对话框时通过构造函数传递必要的操作对象（如`CTaskDataOper`）
|
||||
- **成员变量共享**：父窗口与子窗口通过成员变量共享数据
|
||||
- **消息机制**：使用Windows消息在不同窗口间传递数据和状态
|
||||
|
||||
例如，在`DialTaskManager.cpp`中，创建任务时会根据任务类型显示相应的创建对话框，并将创建好的任务参数传递给上传逻辑：
|
||||
|
||||
```cpp
|
||||
// 伪代码示例
|
||||
if (0 == m_iSelTaskType) {
|
||||
iRet = m_dialNew2DTask.DoModal();
|
||||
if (IDOK == iRet) {
|
||||
// 从对话框获取创建好的任务参数
|
||||
strTaskCN = m_dialNew2DTask.m_strTaskCN;
|
||||
// 构造任务参数结构体
|
||||
strcpy(m_TaskArg.ucTaskID, strTmp);
|
||||
strcpy(m_TaskArg.ucTDName, m_dialNew2DTask.m_strTaskName);
|
||||
// ... 其他参数
|
||||
// 上传任务数据
|
||||
CDownloadDataProgressDlg uploadDlg(&m_TaskArg, &m_taskOper,this);
|
||||
uploadDlg.DoModal();
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Section sources**
|
||||
- [DialNew1DTask.cpp](file://cpp/Views/DialNew1DTask.cpp#L1-L381)
|
||||
- [DialNew2DTask.cpp](file://cpp/Views/DialNew2DTask.cpp#L1-L665)
|
||||
- [DialNew3DTask.cpp](file://cpp/Views/DialNew3DTask.cpp#L1-L570)
|
||||
- [DialTaskManager.cpp](file://cpp/Views/DialTaskManager.cpp#L1-L2242)
|
||||
|
||||
## 任务配置工作流
|
||||
|
||||
对于初学者，任务配置的工作流可以概括为以下步骤：
|
||||
|
||||
1. **创建项目**：通过项目管理器创建新的项目，填写项目基本信息
|
||||
2. **创建测区**：在项目中创建测区，定义测量区域
|
||||
3. **创建任务**：
|
||||
- 选择任务类型（1D、2D或3D）
|
||||
- 选择测试方式（电阻率、激电或自电）
|
||||
- 选择装置类型和测量脚本
|
||||
- 设置任务参数（迭代次数、发射周期等）
|
||||
- 点击"创建"完成任务创建
|
||||
4. **配置地形**（可选）：为任务配置地形数据，导入或手动输入地形点
|
||||
5. **组织任务包**（可选）：将多个任务组织成任务包，设置循环执行参数
|
||||
6. **执行任务**：在任务管理器中选择任务并开始测量
|
||||
|
||||
每个步骤都有相应的对话框引导用户完成配置，系统会在关键操作前进行参数验证，确保配置的正确性。
|
||||
|
||||
## UI响应性能优化建议
|
||||
|
||||
针对大型项目下的UI响应性能，建议采取以下优化措施：
|
||||
|
||||
1. **分页加载任务数据**：避免一次性加载所有任务，采用分页或按时间范围加载的方式，减少内存占用和UI阻塞
|
||||
2. **异步数据加载**：将耗时的数据查询操作放在后台线程执行，避免阻塞UI线程
|
||||
3. **虚拟化列表控件**：对于包含大量任务的列表，使用虚拟化技术，只渲染可见区域的项目
|
||||
4. **缓存常用数据**：将频繁访问的数据（如介质类型、脚本列表）缓存到内存中，减少数据库查询次数
|
||||
5. **优化数据库查询**：为常用查询字段建立索引，优化SQL查询语句，减少查询时间
|
||||
6. **延迟加载**：对于非关键信息，在用户需要时才进行加载，提高初始加载速度
|
||||
7. **批量操作优化**：对于批量删除等操作，使用事务处理，减少数据库交互次数
|
||||
|
||||
这些优化措施可以显著提升大型项目下的UI响应速度，改善用户体验。
|
||||
Reference in New Issue
Block a user