组织设置

对于覆盖配置存储文件（仅指定一个属性 ConfigurationFile）的组织设置，系统提供了如下所示的锁定机制：

1. 最初拥有配置文件编辑权限的用户启动插件

2. 配置文件被锁定，即其他用户无法对此文件进行更改

3. 在配置文件旁边会创建（如果尚未创建）或更新一个名为 插件名称.lock.txt 的文本文件，记录锁定该文件的用户的系统用户名

4. 当插件关闭时，配置文件将被解锁，并从文本文件中移除该用户名

也就是说，在插件关闭之前，配置文件会一直处于该用户的占用状态

在配置文件被占用期间，其他拥有编辑权限的用户将在插件中看到当前占用该文件的用户名

组织的菜单设置允许覆盖 AutoCAD 或 Revit 中的功能区菜单，并可中断 ModPlus 在 AutoCAD、Revit 或 Renga 中的加载。

节点名称必须为 Menu。

该节点可以包含 AutoCAD 和/或 Revit 属性。在每个属性中，需指定包含菜单构建指令的 XML 文件路径。

如果指定的菜单文件位于本地网络的共享磁盘上，则路径必须采用 UNC 格式！

要创建菜单文件，请使用配置器：在“自定义”选项卡中创建菜单并使用相应按钮将其导出为 XML 文件 。

重要提示：请勿手动创建或编辑菜单文件 – 这可能会导致 AutoCAD 或 Revit 启动失败！

如果通过组织设置覆盖了用户的菜单，则用户将无法在配置器中编辑相应的菜单。

该节点还可以包含以下属性，用于中断 ModPlus 的加载：

如果某个属性未指定或格式错误，但节点 Menu 存在，则将使用默认设置。

配置示例：

设置自动更新模块的所有配置。

节点名称必须为 AutoUpdater。

该节点可以包含以下属性：

如果某些属性未指定或指定错误，但存在 AutoUpdater 节点，则将使用默认设置。

自动更新模块每 30 分钟检查一次是否启用/禁用组织设置，无需重新启动模块即可更改。

设置示例：

结果：

许可证服务器设置用于指定局域网许可证服务器的地址或Web许可证服务器的唯一密钥，并指定哪个服务器处于启用状态。

节点名称应为 LicenseServer。

局域网许可证服务器的设置包括三个属性：

Web许可证服务器的设置包括两个属性：

节点中只需添加组织中正在使用的许可证服务器的设置。

对于Web许可证服务器，用户身份识别所用的邮箱不会通过组织设置指定！

局域网许可证服务器设置示例：

结果：

Web许可证服务器设置示例：

结果：

设置自动保存服务的配置。

节点名称必须为 AutoSaveService。

自动保存服务的组织设置在加载Revit时生效！

该节点可以包含以下属性：

BackupDirectory 属性支持使用Windows环境变量，如 %appdata%、%homedrive%、%temp% 等。如果 BackupDirectory 指定的文件夹不存在，且 CreateBackupDirectory 属性值为 True，系统将尝试创建该文件夹。创建失败的错误将被忽略。

如果某个属性未指定或指定错误，将使用用户设置。

配置示例：

设置窗口中“自动保存”选项卡示例：

设置同步通知服务的配置。

节点名称必须为 SyncNotifierService。

同步通知服务的组织设置在加载Revit时以及关闭设置窗口后生效！

该节点可以包含以下属性：

如果任一属性的值在允许范围内（5 到 120），则视为同步通知服务的设置已被组织配置覆盖。

配置示例：

设置窗口中“同步”选项卡示例：

带有配置的插件的组织设置允许覆盖配置文件的存储路径。默认情况下，用户的配置设置会保存在 UserData 文件夹中（%appdata%\ModPlus Data\UserData\），文件为以插件关键名称命名的 XML 文件（见下表）。

节点必须按照插件的关键名称命名：

节点可以包含以下属性：

如果指定的文件或文件夹位于本地网络的网络驱动器上，路径必须使用UNC 格式！

属性可以组合使用。如果使用的属性（ConfigurationsFolder 或 ConfigurationsFolder + ConfigurationFile，或 ConfigurationFile + CanUseUserConfigurationFile，或 ConfigurationFile + ConfigurationsFolder + CanUseUserConfigurationFile）会生成多个配置文件，则信息区域会显示一个下拉菜单用于选择配置文件。如果 CanUseUserConfigurationFile 属性设置为 True，则文件列表中会添加“用户配置文件”选项。

位于 ConfigurationsFolder 属性所指定文件夹中的文件必须包含插件的有效数据。系统不会检查文件内容！无效的 XML 文件可能会导致错误！

配置示例：

带有此类配置的插件窗口示例：

可以使用 Active Directory 服务限制对配置文件的访问。如果用户没有配置文件的写入权限，插件窗口会显示相应的提示，并且所有编辑功能将被禁用。此时配置文件将仅用于读取。

参数插件的组织设置允许指定企业预设存储位置的路径。

节点名称必须为 mprParameters。

设置仅包含一个属性 – Storage，其值为存储位置路径（保存预设的目录）。该路径必须指向一个已存在的目录。

如果指定的存储目录位于本地网络的网络驱动器上，路径必须使用UNC 格式！

设置示例：

来自企业存储的预设会在加载预设窗口中以黄色显示：

如果用户具有在企业预设存储中创建文件的权限，则在保存预设的对话框中可以选择目标存储位置：

可以使用 Active Directory 服务来限制对预设存储的访问。

存储中的子文件夹（按专业类型划分预设）会在保存预设时由插件自动创建。

图纸导出插件的组织设置允许在导出为 PDF 时设置水印添加规则，以及设置导出文件名掩码和合并文件名掩码。

节点名称必须为 mprSheetExport。

文件名掩码设置可以包含以下属性：

如果该属性不存在或没有值，将使用用户配置中的设置。

在文件名掩码中，字符 < 必须替换为 &lt;，字符 > 必须替换为 &gt;！

配置示例见下。

水印设置包含 4 个必填属性：

配置示例：

在排除文件（属性 WatermarkExclude）中，列出不需要添加水印的文档名称，即使已启用水印添加（Watermark = True）。每个值必须单独写在文件的新行中。可以只写部分名称。例如，如果 Revit 文档名为 RAC_basic_sample_project，而文件中有 RAC_ 或 _sample_，则导出 PDF 时不会添加水印。

在规则文件（属性 WatermarkRules）中添加水印位置规则。每条规则必须单独写在文件的新行中。如果行首是字符 #，插件会忽略该行。每条规则由 7 个属性组成，用逗号分隔。插件会忽略每个属性的首尾空格。属性的顺序如下：

如果规则文件中的规则没有与标题栏名称匹配（或规则文件为空），插件将使用规则 “,185,65,0,RED,5,isocpeur.ttf”。

规则文件示例：