280 lines
6.7 KiB
Markdown
280 lines
6.7 KiB
Markdown
# NavisworksTransport 插件管理员手册
|
||
|
||
本手册面向系统管理员，介绍 NavisworksTransport 物流路径规划插件的部署、升级、数据管理和维护操作。
|
||
|
||
---
|
||
|
||
## 目录
|
||
|
||
1. [系统要求](#系统要求)
|
||
2. [插件安装](#插件安装)
|
||
3. [插件升级](#插件升级)
|
||
4. [路径数据导出与导入](#路径数据导出与导入)
|
||
5. [数据库管理](#数据库管理)
|
||
6. [日志与故障排查](#日志与故障排查)
|
||
7. [常见问题](#常见问题)
|
||
|
||
---
|
||
|
||
## 系统要求
|
||
|
||
### 软件环境
|
||
|
||
| 组件 | 版本要求 |
|
||
|------|---------|
|
||
| 操作系统 | Windows 10/11 64位 |
|
||
| Autodesk Navisworks | Manage 2026 |
|
||
| .NET Framework | 4.8 或更高 |
|
||
|
||
### 权限要求
|
||
|
||
- **安装插件**: 需要管理员权限（写入 `C:\ProgramData\Autodesk\`）
|
||
- **运行插件**: 普通用户权限即可
|
||
- **数据库操作**: 对模型文件所在目录有读写权限
|
||
|
||
---
|
||
|
||
## 插件安装
|
||
|
||
### 安装前准备
|
||
|
||
1. 确认已安装 Navisworks Manage 2026
|
||
2. 关闭 Navisworks
|
||
3. 准备好安装包（包含 `TransportPlugin.dll` 和 `resources` 文件夹）
|
||
|
||
### 安装步骤
|
||
|
||
1. **创建插件目录**
|
||
|
||
创建目录：`C:\ProgramData\Autodesk\Navisworks Manage 2026\plugins\TransportPlugin\`
|
||
|
||
2. **复制文件**
|
||
|
||
将以下文件复制到插件目录：
|
||
- `TransportPlugin.dll`
|
||
- `resources` 文件夹（如有）
|
||
|
||
3. **验证安装**
|
||
|
||
启动 Navisworks，检查菜单栏是否出现 **"物流路径"** 选项卡。
|
||
|
||
---
|
||
|
||
## 插件升级
|
||
|
||
### 升级前准备
|
||
|
||
1. **备份数据**（详见[数据库管理](#数据库管理)）
|
||
2. **关闭 Navisworks**
|
||
3. **记录当前版本**（查看 `TransportPlugin.dll` 文件属性）
|
||
|
||
### 升级步骤
|
||
|
||
1. **备份旧版本**（可选）
|
||
|
||
复制 `TransportPlugin.dll` 为 `TransportPlugin_backup.dll`
|
||
|
||
2. **替换文件**
|
||
|
||
将新版本的 `TransportPlugin.dll` 复制到插件目录，覆盖旧文件。
|
||
|
||
3. **验证升级**
|
||
|
||
启动 Navisworks，检查插件是否正常加载，验证现有数据是否完整。
|
||
|
||
### 版本回滚
|
||
|
||
如升级后出现问题：
|
||
|
||
1. 关闭 Navisworks
|
||
2. 将备份的 `TransportPlugin_backup.dll` 重命名为 `TransportPlugin.dll`
|
||
3. 重新启动 Navisworks
|
||
|
||
---
|
||
|
||
## 路径数据导出与导入
|
||
|
||
### 导出路径数据
|
||
|
||
#### 支持的格式
|
||
|
||
| 格式 | 扩展名 | 用途 |
|
||
|------|-------|------|
|
||
| XML | `.xml` | 标准格式，推荐用于备份 |
|
||
| JSON | `.json` | 数据交换 |
|
||
| CSV | `.csv` | Excel 查看分析 |
|
||
|
||
#### 导出步骤
|
||
|
||
1. 在 **"路径编辑"** 面板中找到 **"路径文件管理"** 区域
|
||
2. 选择导出方式：
|
||
- **"导出全部"**：导出所有路径
|
||
- **"导出选中路径"**：导出当前选中的路径
|
||
3. 选择保存位置和格式
|
||
4. 点击"保存"
|
||
|
||
**命名建议**: `项目名_日期.xml`
|
||
|
||
### 导入路径数据
|
||
|
||
#### 导入步骤
|
||
|
||
1. 在 **"路径文件管理"** 区域点击 **"导入"** 按钮
|
||
2. 选择要导入的文件（XML 或 JSON）
|
||
3. 点击"确定"
|
||
|
||
导入的路径将自动合并到现有路径列表中。如遇重名路径，系统会自动重命名。
|
||
|
||
---
|
||
|
||
## 数据库管理
|
||
|
||
### 数据库概述
|
||
|
||
- **位置**: 与模型文件（`.nwd`）同目录
|
||
- **文件名**: 与模型文件同名，扩展名为 `.db`
|
||
- **示例**: `Project.nwd` → `Project.db`
|
||
|
||
### 数据备份
|
||
|
||
#### 通过插件界面备份
|
||
|
||
1. 打开 **"系统管理"** 选项卡
|
||
2. 在 **"数据管理"** 区域点击 **"备份数据"** 按钮
|
||
3. 选择保存位置
|
||
4. 系统自动导出所有路径、检测记录和截图
|
||
|
||
#### 自动备份设置
|
||
|
||
1. 在 **"数据管理"** 区域勾选 **"启用自动备份"**
|
||
2. 设置保留备份数量（默认保留最近若干个）
|
||
|
||
#### 手动备份数据库文件
|
||
|
||
1. **关闭 Navisworks**（必须）
|
||
2. 复制模型文件同目录的 `.db` 文件到备份位置
|
||
|
||
### 数据恢复
|
||
|
||
1. 在 **"系统管理"** 选项卡的 **"数据管理"** 区域
|
||
2. 点击 **"恢复数据"** 按钮
|
||
3. 选择备份文件
|
||
4. 点击"确定"
|
||
|
||
或手动恢复：关闭 Navisworks 后，用备份的 `.db` 文件覆盖原文件。
|
||
|
||
### 数据库维护
|
||
|
||
- **修复数据库**: 在 **"数据管理"** 区域点击 **"修复数据库"** 按钮，检查并修复完整性
|
||
- **清空数据**: 点击 **"清空数据"** 按钮清空所有路径和检测记录（谨慎使用）
|
||
|
||
---
|
||
|
||
## 日志与故障排查
|
||
|
||
### 日志查看
|
||
|
||
1. 打开 **"系统管理"** 选项卡
|
||
2. 在 **"日志管理"** 区域点击 **"查看日志"** 按钮
|
||
|
||
### 日志文件位置
|
||
|
||
```
|
||
C:\ProgramData\Autodesk\Navisworks Manage 2026\plugins\TransportPlugin\logs\
|
||
```
|
||
|
||
### 日志级别设置
|
||
|
||
在 **"日志管理"** 区域选择日志级别：
|
||
|
||
- Debug：详细调试信息
|
||
- Info：一般信息
|
||
- Warning：警告信息
|
||
- Error：仅错误信息
|
||
|
||
### 常见问题
|
||
|
||
#### 插件未加载（无"物流路径"选项卡）
|
||
|
||
**检查项**:
|
||
|
||
- 插件目录是否存在 `TransportPlugin.dll`
|
||
- Navisworks 版本是否为 Manage 2026
|
||
- .NET Framework 4.8 是否已安装
|
||
|
||
**查看 Windows 事件查看器**:
|
||
|
||
- 运行 `eventvwr.msc`
|
||
- 查看 "Windows 日志" → "应用程序"
|
||
- 查找 Navisworks 或 .NET 相关错误
|
||
|
||
#### 无法保存路径
|
||
|
||
**检查项**:
|
||
|
||
- 磁盘剩余空间
|
||
- 模型文件目录的写入权限
|
||
- 是否有其他 Navisworks 实例占用该模型
|
||
|
||
#### 导出/导入失败
|
||
|
||
**检查项**:
|
||
|
||
- 目标目录写入权限
|
||
- 磁盘空间是否充足
|
||
- 导入文件格式是否正确
|
||
|
||
### 联系技术支持
|
||
|
||
收集以下信息：
|
||
|
||
1. **日志文件**: `debug.log`
|
||
2. **插件版本**: 在 **"系统管理"** 选项卡的 **"系统信息"** 区域查看
|
||
3. **系统信息**: 运行 `msinfo32` 导出
|
||
4. **问题描述**: 操作步骤、错误提示
|
||
|
||
---
|
||
|
||
## 常见问题
|
||
|
||
### Q: 如何查看数据库版本？
|
||
|
||
**A**: 在 **"系统管理"** 选项卡的 **"数据管理"** 区域查看"插件版本"（如果没显示，可以点击“恢复数据库”刷新信息）。
|
||
|
||
### Q: 可以在多台机器上使用吗？
|
||
|
||
**A**: 可以。在每台机器安装插件即可。路径数据随 `.db` 文件与模型一起共享。
|
||
|
||
### Q: 卸载插件会删除数据吗？
|
||
|
||
**A**: 不会。数据存储在模型目录的 `.db` 文件中。
|
||
|
||
### Q: 如何彻底卸载插件？
|
||
|
||
**A**: 删除插件目录：`C:\ProgramData\Autodesk\Navisworks Manage 2026\plugins\TransportPlugin\`
|
||
|
||
### Q: 升级后数据还能用吗？
|
||
|
||
**A**: 要查看数据库版本，主版本相同，升级（如 2.1 → 2.2）完全兼容，跨主版本升级要删除数据库并重建。
|
||
|
||
### Q: 如何迁移到新电脑？
|
||
|
||
**A**:
|
||
|
||
1. 在原电脑使用"备份数据"功能
|
||
2. 在新电脑安装插件
|
||
3. 使用"恢复数据"功能
|
||
|
||
---
|
||
|
||
## 附录
|
||
|
||
### 常用路径
|
||
|
||
| 用途 | 路径 |
|
||
|------|------|
|
||
| 插件目录 | `C:\ProgramData\Autodesk\Navisworks Manage 2026\plugins\TransportPlugin\` |
|
||
| 日志目录 | `C:\ProgramData\Autodesk\Navisworks Manage 2026\plugins\TransportPlugin\logs\` |
|
||
|
||
**文档版本**: 1.0
|