tian/NavisworksTransport
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
759a41fb7e
NavisworksTransport/doc/guide/administrator_manual.md
tian 759a41fb7e 编写管理员手册
2026-02-26 00:44:11 +08:00

6.6 KiB
Raw Blame History

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
适用插件版本: 2.0.0.0 及更高版本