coco
10 KiB
测区管理
**本文档引用的文件** - [ProManager.cpp](file://cpp/Managers/ProManager.cpp) - [TestingZone.cpp](file://cpp/ProblemZone/TestingZone.cpp) - [TestingZone.h](file://h/TestingZone.h) - [opcreatetzdlg.cpp](file://cpp/Views/opcreatetzdlg.cpp) - [opcreatetzdlg.h](file://h/opcreatetzdlg.h) - [appdatatzlistview.cpp](file://cpp/Views/appdatatzlistview.cpp) - [database_modify.xml](file://database_modify.xml)目录
项目与测区层级关系
在GeomativeStudio系统中，项目与测区之间存在明确的父子层级关系。每个项目可以包含多个测区，但每个测区只能属于一个项目。这种关系通过数据库中的外键约束实现，其中测区表(tz)中的PRID字段引用项目表(project)的ID字段。
项目作为数据管理的基本单元，包含了测区的集合。当用户选择一个项目时，系统会根据该项目的句柄查询其下属的所有测区，并在UI界面上展示这些测区列表。这种层级结构确保了数据组织的逻辑性和一致性，同时也便于数据的同步和管理。
项目与测区的关系还体现在设备端的数据同步过程中。当项目被同步到设备时，其包含的测区也会被同步。系统通过dev_syn_td表来跟踪项目和测区在设备上的同步状态，其中PRCN字段对应项目的CN码，TzCN字段对应测区的CN码。
Section sources
CProManager::ShowTzList方法分析
CProManager::ShowTzList方法负责根据项目句柄查询数据库并填充测区列表控件。该方法首先通过项目句柄获取对应的项目ID，然后执行SQL查询语句从数据库中获取该项目下的所有测区信息。
flowchart TD
Start([开始]) --> GetProjectID["从项目句柄获取项目ID"]
GetProjectID --> CheckItemCount{"列表项数不为0?"}
CheckItemCount --> |是| DeleteAllItems["删除所有列表项"]
CheckItemCount --> |否| BuildSQLQuery
DeleteAllItems --> BuildSQLQuery
BuildSQLQuery --> ExecuteQuery["执行SQL查询"]
ExecuteQuery --> CheckEOF{"记录集未结束?"}
CheckEOF --> |是| InsertListItem["插入列表项"]
InsertListItem --> SetItemText["设置列表项文本"]
SetItemText --> GenerateHandle["生成测区句柄"]
GenerateHandle --> SetItemData["设置列表项数据"]
SetItemData --> MoveNext["移动到下一条记录"]
MoveNext --> CheckEOF
CheckEOF --> |否| CloseRecordset["关闭记录集"]
CloseRecordset --> ReturnTrue["返回true"]
ReturnTrue --> End([结束])
Diagram sources
Section sources
测区类型(TZtype)枚举值及业务含义
测区类型(TZtype)是一个重要的枚举值，用于标识测区的业务类型。根据代码分析，TZtype的取值及其业务含义如下：
- TZtype=0或1: 表示"1D VES | 2D ERI"类型，即一维垂直电测深或二维电阻率成像。这两种类型在系统中被视为同一类别进行处理。
- TZtype=2: 表示"3D ERT"类型，即三维电阻率层析成像，适用于需要三维空间数据采集的场景。
- TZtype=3: 表示"DefaultTestZone"类型，即默认测区。这是一个特殊的测区类型，每个项目创建时都会自动创建一个默认测区。
默认测区(type=3)具有特殊处理逻辑。在创建项目时，系统会自动调用InsertDefaultTzToProject方法为新项目创建一个默认测区。这个默认测区的名称固定为"DefaultTestZone"，描述和位置均为"None"。在设备同步过程中，系统会对TZtype=3进行强制检查，如果发现类型不匹配会抛出错误。
classDiagram
class CTestingZone {
+ShowDetailInfo(CListCtrl&)
+CTestingZone(DWORD, _ConnectionPtr&)
+~CTestingZone()
-m_dwID DWORD
-m_pConnection _ConnectionPtr
-m_szTZname CString
-m_szCDate CString
-m_szDesc CString
-m_szLocation CString
-m_szCN CString
-m_szTZtype CString
}
CTestingZone --> "1" CListCtrl : "填充"
Diagram sources
Section sources
测区配置数据持久化机制
测区配置数据在设备端通过testzone.xml文件进行持久化存储。该文件的生成遵循特定的规则，并具有明确的元素结构。
testzone.xml文件的生成规则如下：当测区数据需要同步到设备时，系统会在本地CACHE目录下创建相应的项目和测区目录结构，然后生成testzone.xml文件。文件路径遵循"\CACHE\projects\{项目CN}\{测区CN}\"的层级关系，与项目XML文件保持一致的目录结构。
testzone.xml文件的元素结构包括以下关键字段：
- type: 测区类型，对应数据库中的TZtype字段
- cn: 测区唯一标识码，对应数据库中的CN字段
- location: 测区位置信息
- desc: 测区描述信息
- create_date: 创建日期
- testzone_name: 测区名称
flowchart TD
Start([开始]) --> CreateDirectory["创建本地目录"]
CreateDirectory --> CreateXML["创建XML文档"]
CreateXML --> AddRoot["添加根元素testzone"]
AddRoot --> AddType["添加type元素"]
AddType --> AddLocation["添加location元素"]
AddLocation --> AddDesc["添加desc元素"]
AddDesc --> AddCreateDate["添加create_date元素"]
AddCreateDate --> AddCreateTime["添加create_time元素"]
AddCreateTime --> AddTestDate["添加test_date元素"]
AddTestDate --> AddTestTime["添加test_time元素"]
AddTestTime --> AddCN["添加cn元素"]
AddCN --> AddName["添加testzone_name元素"]
AddName --> Add3DScript["添加testzone_3D_script元素"]
Add3DScript --> AddVess["添加vess元素"]
AddVess --> AddEris["添加eris元素"]
AddEris --> AddErts["添加erts元素"]
AddErts --> AddWels["添加wels元素"]
AddWels --> SaveFile["保存文件"]
SaveFile --> SendToDevice["发送到设备"]
SendToDevice --> UpdateDB["更新数据库同步状态"]
UpdateDB --> End([结束])
Diagram sources
Section sources
测区创建完整性校验流程
测区创建时的完整性校验流程包括多个步骤，确保数据的完整性和一致性。当用户通过UI界面创建新测区时，系统会执行以下校验流程：
首先，系统会检查测区名称是否为空。如果名称为空，会弹出错误提示"测区名称不能为空"，并阻止创建操作。这是最基本的完整性校验，确保每个测区都有一个有效的名称标识。
对于TZtype=3的默认测区，系统有特殊的强制检查机制。在CreateDefaultTzInDev方法中，系统会检查从数据库读取的测区类型是否为3。如果不是，会立即返回错误并显示相应的错误信息。这种强制检查确保了默认测区的特殊性不会被破坏。
sequenceDiagram
participant UI as "用户界面"
participant ProManager as "CProManager"
participant Database as "数据库"
UI->>ProManager : 调用CreateTzInDB
ProManager->>UI : 显示创建对话框
UI->>ProManager : 输入测区信息并确认
ProManager->>ProManager : 验证测区名称是否为空
alt 名称为空
ProManager->>UI : 显示错误提示
ProManager-->>UI : 返回失败
else 名称有效
ProManager->>Database : 查询同名测区是否存在
Database-->>ProManager : 返回查询结果
alt 测区已存在
ProManager->>UI : 显示"测区已存在"提示
ProManager-->>UI : 返回重复错误
else 测区不存在
ProManager->>Database : 插入新测区记录
Database-->>ProManager : 返回插入结果
ProManager->>Database : 查询新测区ID
Database-->>ProManager : 返回测区ID
ProManager-->>UI : 返回成功
end
end
Diagram sources
Section sources
测区数据模型字段说明
测区数据模型包含多个关键属性字段，这些字段在UI界面中有相应的展示方式。主要字段包括：
- ID: 测区的唯一标识符，数据库主键，用于内部引用和关联
- 名称(TZname): 测区的名称，在测区列表中作为第一列显示
- 描述(TZdesc): 测区的详细描述信息，在列表中作为描述列显示
- 创建日期(Cdate): 测区的创建日期，格式化为"YYYY-MM-DD"显示
- 位置(location): 测区的地理位置信息
- 类型(TZtype): 测区的业务类型，决定测区的功能和处理方式
- CN码: 测区的唯一编码，用于设备同步和数据交换
在UI界面中，这些字段通过CListCtrl控件进行展示。测区列表视图(appdatatzlistview.cpp)定义了列表的列结构，包括测区名称、类型、创建日期和描述等列。每个列表项的数据通过SetItemData方法存储测区句柄，便于后续操作时快速定位对应的测区对象。
erDiagram
PROJECT ||--o{ TESTING_ZONE : "包含"
PROJECT {
int ID PK
string CN UK
string PRname
datetime PRdate
string PRdesc
string location
}
TESTING_ZONE {
int ID PK
int PRID FK
string CN UK
string TZname
int TZtype
datetime Cdate
string TZdesc
string location
}
Diagram sources
Section sources