组织设置允许覆盖用户设置或指定特殊行为。这些设置可以应用于不同的区域,例如 ModPlus 的通用设置或各个插件的设置。
组织设置是具有特定结构的 XML 文件:
其中:
设置文件中只需包含必要的区域。只有当相关区域存在且填写正确时,其设置才会生效。
XML 文件应命名为 orgConfig.mpcf,并保存在用户设置文件夹中:%appdata%\ModPlus Data\UserData(完整路径为 %appdata%\ModPlus Data\UserData\orgConfig.mpcf)。该文件可以由组织的系统管理员进行复制和更新。
程序仅以只读方式使用组织设置文件。
文件中的数据会在被访问时读取(例如启动插件时),这允许在不关闭支持的产品(如 AutoCAD、Revit 等)的情况下更新文件。
支持的区域和行为设置可根据请求添加!
组织设置文件的最新模板 – 打开。
对于覆盖配置存储文件(仅指定一个属性 ConfigurationFile)的组织设置,系统提供了如下所示的锁定机制:
1. 最初拥有配置文件编辑权限的用户启动插件
2. 配置文件被锁定,即其他用户无法对此文件进行更改
3. 在配置文件旁边会创建(如果尚未创建)或更新一个名为 插件名称.lock.txt 的文本文件,记录锁定该文件的用户的系统用户名
4. 当插件关闭时,配置文件将被解锁,并从文本文件中移除该用户名
也就是说,在插件关闭之前,配置文件会一直处于该用户的占用状态
在配置文件被占用期间,其他拥有编辑权限的用户将在插件中看到当前占用该文件的用户名
组织的菜单设置允许覆盖 AutoCAD 或 Revit 中的功能区菜单,并可中断 ModPlus 在 AutoCAD、Revit 或 Renga 中的加载。
节点名称必须为 Menu。
该节点可以包含 AutoCAD 和/或 Revit 属性。在每个属性中,需指定包含菜单构建指令的 XML 文件路径。
如果指定的菜单文件位于本地网络的共享磁盘上,则路径必须采用 UNC 格式!
要创建菜单文件,请使用配置器:在“自定义”选项卡中创建菜单并使用相应按钮将其导出为 XML 文件 。
重要提示:请勿手动创建或编辑菜单文件 – 这可能会导致 AutoCAD 或 Revit 启动失败!
如果通过组织设置覆盖了用户的菜单,则用户将无法在配置器中编辑相应的菜单。
该节点还可以包含以下属性,用于中断 ModPlus 的加载:
属性 | 说明 | 可用值 | 默认值 |
LoadInAutoCAD | 控制 ModPlus 在 AutoCAD 中的加载。重要提示:工作库中的命令仍可通过命令行调用! | True, False | True |
LoadInRevit | 控制 ModPlus 在 Revit 中的加载 | True, False | True |
LoadInRenga | 控制 ModPlus 在 Renga 中的加载 | True, False | True |
如果某个属性未指定或格式错误,但节点 Menu 存在,则将使用默认设置。
配置示例:
设置自动更新模块的所有配置。
节点名称必须为 AutoUpdater。
该节点可以包含以下属性:
属性 | 说明 | 允许的值 | 默认值 |
GetStandardCui | 安装新插件时重建菜单 | True, False | True |
ShowProgressDialog | 下载和安装更新时显示进度对话框 | True, False | True |
ShowResultDialog | 显示更新或安装结果的对话框 | True, False | True |
UpdateCheckTime | 检查更新的周期 | 整数 0 到 4 0 – 30 分钟 1 – 1 小时 2 – 2 小时 3 – 4 小时 4 – 8 小时 |
3 |
DoubleMouseClick | 双击托盘图标 | 0 或 1 0 – 打开模块设置 1 – 打开配置器 |
0 |
NotShowNotificationsForUnimportantUpdates | 不显示不重要更新的通知 | True, False | True |
ShowHtmlExceptionMessage | 显示 HTML 错误内容 | True, False | True |
AutoInstallNewPlugins | 自动安装新插件 | True, False | False |
ShowNews | 独立于通知设置显示新闻 | True, False | True |
如果某些属性未指定或指定错误,但存在 AutoUpdater 节点,则将使用默认设置。
自动更新模块每 30 分钟检查一次是否启用/禁用组织设置,无需重新启动模块即可更改。
设置示例:
结果:
许可证服务器设置用于指定局域网许可证服务器的地址或Web许可证服务器的唯一密钥,并指定哪个服务器处于启用状态。
节点名称应为 LicenseServer。
局域网许可证服务器的设置包括三个属性:
属性 | 说明 | 允许值 |
IsLocalLicenseServerEnable | 该许可证服务器是否启用 | True, False |
LocalLicenseServerIpAddress | 许可证服务器的IP地址 | 不验证 |
LocalLicenseServerPort | 许可证服务器的端口 | 0 到 65535 的整数 |
Web许可证服务器的设置包括两个属性:
属性 | 说明 | 允许值 |
IsWebLicenseServerEnable | 该许可证服务器是否启用 | True, False |
WebLicenseServerGuid | 许可证服务器的唯一密钥 | 可转换为GUID的字符串 |
节点中只需添加组织中正在使用的许可证服务器的设置。
对于Web许可证服务器,用户身份识别所用的邮箱不会通过组织设置指定!
局域网许可证服务器设置示例:
结果:
Web许可证服务器设置示例:
结果:
设置自动保存服务的配置。
节点名称必须为 AutoSaveService。
自动保存服务的组织设置在加载Revit时生效!
该节点可以包含以下属性:
属性 | 说明 | 允许的值 |
IsEnabledAutosave | 自动保存服务是否启用。不影响备份文件和文件夹的移动 | True, False |
AutosaveDocument | 服务工作的文档类型 | Project, Family, ProjectAndFamily |
Interval | 自动保存间隔(分钟) | 5 到 60 的整数 |
RemindIfNotSavedDocument | 如果文件未保存则提醒 | True, False |
MoveBackupFiles | 移动备份文件 | True, False |
BackupsCount | 保存的备份副本数量 | 1 到 100 的整数 |
MoveBackupFolders | 移动备份文件夹 | True, False |
BackupDirectory | 备份文件夹 | 用户计算机上存在的文件夹路径 |
CreateBackupDirectory | 创建备份文件夹 | True, False |
BackupDirectory 属性支持使用Windows环境变量,如 %appdata%、%homedrive%、%temp% 等。如果 BackupDirectory 指定的文件夹不存在,且 CreateBackupDirectory 属性值为 True,系统将尝试创建该文件夹。创建失败的错误将被忽略。
如果某个属性未指定或指定错误,将使用用户设置。
配置示例:
设置窗口中“自动保存”选项卡示例:
设置同步通知服务的配置。
节点名称必须为 SyncNotifierService。
同步通知服务的组织设置在加载Revit时以及关闭设置窗口后生效!
该节点可以包含以下属性:
属性 | 说明 | 允许的值 |
GreenNotifierInterval | 绿色通知级别的通知间隔(分钟) | 5 到 120 的整数 |
OrangeNotifierInterval | 橙色通知级别的通知间隔(分钟) | 5 到 120 的整数 |
RedNotifierInterval | 红色通知级别的通知间隔(分钟) | 5 到 120 的整数 |
如果任一属性的值在允许范围内(5 到 120),则视为同步通知服务的设置已被组织配置覆盖。
配置示例:
设置窗口中“同步”选项卡示例:
带有配置的插件的组织设置允许覆盖配置文件的存储路径。默认情况下,用户的配置设置会保存在 UserData 文件夹中(%appdata%\ModPlus Data\UserData\),文件为以插件关键名称命名的 XML 文件(见下表)。
节点必须按照插件的关键名称命名:
插件 | 关键名称 |
Revit. 基准标高 | mprBaseLevel |
Revit. 按筛选选择 | mprFilterSelection |
Revit. 户型规划 | mprApartmentBuildingLayout |
Revit. 房间装修 | mprRoomFinishing |
Revit. 参数化 | mprParametrization |
Revit. 工作集 | mprWorksets |
Revit. 沿线标注 | mprDimByLine |
Revit. 元素着色 | mprColorizer |
Revit. 元素连接 | mprJoin |
Revit. 阶段 | mprPhases |
节点可以包含以下属性:
属性 | 说明 | 允许值 |
ConfigurationFile | 配置文件路径。在使用 ConfigurationsFolder 属性时可以不填 | UNC 格式的文件路径 |
ConfigurationsFolder | 包含多个配置文件的文件夹路径 | UNC 格式的文件夹路径 |
CanUseUserConfigurationFile | 允许用户使用自定义配置文件 | True, False |
如果指定的文件或文件夹位于本地网络的网络驱动器上,路径必须使用UNC 格式!
属性可以组合使用。如果使用的属性(ConfigurationsFolder 或 ConfigurationsFolder + ConfigurationFile,或 ConfigurationFile + CanUseUserConfigurationFile,或 ConfigurationFile + ConfigurationsFolder + CanUseUserConfigurationFile)会生成多个配置文件,则信息区域会显示一个下拉菜单用于选择配置文件。如果 CanUseUserConfigurationFile 属性设置为 True,则文件列表中会添加“用户配置文件”选项。
位于 ConfigurationsFolder 属性所指定文件夹中的文件必须包含插件的有效数据。系统不会检查文件内容!无效的 XML 文件可能会导致错误!
配置示例:
带有此类配置的插件窗口示例:
可以使用 Active Directory 服务限制对配置文件的访问。如果用户没有配置文件的写入权限,插件窗口会显示相应的提示,并且所有编辑功能将被禁用。此时配置文件将仅用于读取。
参数插件的组织设置允许指定企业预设存储位置的路径。
节点名称必须为 mprParameters。
设置仅包含一个属性 – Storage,其值为存储位置路径(保存预设的目录)。该路径必须指向一个已存在的目录。
如果指定的存储目录位于本地网络的网络驱动器上,路径必须使用UNC 格式!
设置示例:
来自企业存储的预设会在加载预设窗口中以黄色显示:
如果用户具有在企业预设存储中创建文件的权限,则在保存预设的对话框中可以选择目标存储位置:
可以使用 Active Directory 服务来限制对预设存储的访问。
存储中的子文件夹(按专业类型划分预设)会在保存预设时由插件自动创建。
图纸导出插件的组织设置允许在导出为 PDF 时设置水印添加规则,以及设置导出文件名掩码和合并文件名掩码。
节点名称必须为 mprSheetExport。
文件名掩码设置可以包含以下属性:
属性 | 说明 | 允许值 |
FileNameMask | 设置导出文件的文件名掩码 | 根据插件设置中定义的规则的文件名掩码 |
MergedFileNameMask | 设置合并文件的文件名掩码 | 根据插件设置中定义的规则的文件名掩码 |
如果该属性不存在或没有值,将使用用户配置中的设置。
在文件名掩码中,字符 < 必须替换为 <,字符 > 必须替换为 >!
配置示例见下。
水印设置包含 4 个必填属性:
属性 | 说明 | 允许值 |
Watermark | 是否启用水印添加 | True, False |
WatermarkText | 水印内容 | 任意 |
WatermarkExclude | 包含文档排除列表的文本文件 (.txt) 路径 | 文件路径。如果路径指向局域网中的文件,则必须使用UNC 格式 |
WatermarkRules | 包含根据标题栏名称设置水印位置规则的文本文件 (.txt) 路径 | 文件路径。如果路径指向局域网中的文件,则必须使用UNC 格式 |
配置示例:
在排除文件(属性 WatermarkExclude)中,列出不需要添加水印的文档名称,即使已启用水印添加(Watermark = True)。每个值必须单独写在文件的新行中。可以只写部分名称。例如,如果 Revit 文档名为 RAC_basic_sample_project,而文件中有 RAC_ 或 _sample_,则导出 PDF 时不会添加水印。
在规则文件(属性 WatermarkRules)中添加水印位置规则。每条规则必须单独写在文件的新行中。如果行首是字符 #,插件会忽略该行。每条规则由 7 个属性组成,用逗号分隔。插件会忽略每个属性的首尾空格。属性的顺序如下:
属性 | 说明 | 允许值 |
标题栏名称中包含的值 | 如果标题栏全名包含此值,将应用该规则 | 可以使用星号 (*)。带星号的规则将用于所有未匹配到其他规则的图纸 |
右边距 | 水印左下角到图纸右边缘的距离(毫米) | 整数 |
下边距 | 水印左下角到图纸下边缘的距离(毫米) | 整数 |
旋转角度 | 相对于水印左下角的旋转角度 | 0 到 359 的整数 |
颜色 | 水印颜色 | 允许值(区分大小写): WHITE LIGHT_GRAY GRAY DARK_GRAY BLACK RED ORANGE YELLOW GREEN MAGENTA CYAN BLUE |
文字大小 | 水印文字的大小(毫米) | 大于 0 的整数 |
字体文件名 | 水印字体文件名(不区分大小写) | 必须是计算机 Windows/Fonts 文件夹中的字体文件名。如果找不到指定字体文件,将使用 arial.ttf |
如果规则文件中的规则没有与标题栏名称匹配(或规则文件为空),插件将使用规则 “,185,65,0,RED,5,isocpeur.ttf”。
规则文件示例: