imWorkOptions.xml

注:

imWorkOptions.xml 即之前版本中的 iwOfficeAddinsConfig.xml

您可以使用 imWorkOptions.xml 文件自定义与 Microsoft Word、Excel、PowerPoint、Visio 和 MS Project 集成的 iManage Work 的用户体验。例如,您可以自定义 iManage Work 对话框、使用 Microsoft Word 创建的 iManage Work 文件页脚格式、 iManage Work 文件标题格式等。

您可以使用以下键和选项进行自定义:

选项/键

描述

iManage.Import.DocClass

指定在将文件作为新文档保存到 iManage Work 时的默认文档类别。

注:

  • 此选项仅适用于保存新文档,不适用于保存新版本。

  • 默认文档类别和默认电子邮件类别将不再从为服务器配置的默认类别读取。这两个值将仅从 imWorkOptions.xml 文件读取。

  • 如果文件中缺少 iManage.Import.DocClassiManage.Import.EmailClass 选项,则“DOC”将用作默认文档类别,“E-MAIL”将用作默认电子邮件类别。

默认值:DOC

示例:

<key name="iManage.Import.DocClass" value="DOC"/>

如果默认文档类别为空白,即 value 字符串为空,则 iManage“保存”对话框中的类别字段也将空白,系统将提示用户在保存文档时输入文档类别。

iManage.Import.EmailClass

指定在将电子邮件作为新文档或新版本保存到 iManage Work 时的默认电子邮件类别。

默认值:电子邮件

示例:

<key name="iManage.Import.EmailClass" value="E-Mail"/>

FileSave

用于将 Microsoft Office 的文件->保存 (idMso) 命令映射到预先定义的 iManage Work 命令 ID,例如“iManage.WorkSiteSavenSync”。通过映射到“iManage.WorkSiteSavenSync”命令,您可以在执行文件->保存操作时保存编辑内容到 iManage Work。

默认值:空

注:

此设置适用于 Citrix 用户。

示例:

<key name="FileSave" value="iManage.WorkSiteSavenSync"/>

ValidateCheckoutLocation

用于根据已登录用户当前的计算机验证签出文件的位置。

默认值:Y

如果值为 N,则在签入时仅验证文件的签出路径。

注:

此设置适用于 Citrix 用户。

示例:

<key name="ValidateCheckoutLocation" value="Y"/>

iwOnlyKeepLatestVersionatLocal

确保文件仅有一个版本保留在“Recent”(最近)目录中。默认在将文件保存为新版本时,之前的版本将从本地目录中删除。有效值:"Y" 或 "N";"true" 或 "false"。

默认值:Y

示例:

<key name="iwOnlyKeepLatestVersionatLocal" value="Y"/>

footer

包含以下键:

  • iwFooterFormat:指定文档页脚的格式。其使用 WSProfileAttributeID 枚举的成员,前后分别有 "{" 和 "}"。

  • AutoInsert:指定是否要自动将 iManage 文档配置文件信息插入页脚。当保存文档的新版本或新副本到 iManage Work 时会触发自动插入操作。

默认值:如示例中所指定

示例:

<ws_option name="footer" applyToAll="true">
<key name="iwFooterFormat" value="#{imProfileDocNum}v{imProfileVersion}<{imProfileDatabase}> - {imProfileDescription}" />
<key name="AutoInsert" value="N" />
</ws_option>

为确保在保存文档到 iManage Work 时自动插入页脚,将 AutoInsert 键的值设为 Y。 如果已启用自动插入页脚的功能,则 iManage 页脚将替换文档中现有的任何自定义页脚。

注:

  • iwFooterFormat 键已从 common 部分移动到 footer 部分。取消注释 footer 部分,以启用其中包含的设置。

  • 可以通过自定义 Microsoft Office 插件等的方式实现高级页脚集成,从而允许将 iManage 页脚与现有自定义页脚合并。有关更多信息,请参阅 iManage Work Desktop for Windows SDK 指南 10.1.1 中的 iManage Work Desktop for Windows 插件部分。

  • 有关 iwFooterFormat 键和下文提及的其他键中使用的 WSProfileAttributeID 枚举成员的列表,请参阅 WSProfileAttributeID 枚举器¹

iwFileCaptionFormat

指定以下 Microsoft Office 应用程序中的文档标题格式:Word、Excel 和 PowerPoint。值可以与其他文本或字符组合。其使用 WSProfileAttributeID 枚举的成员,前后分别有 "{" 和 "}"。

默认值:#{imProfileDocNum}v{imProfileVersion}<{imProfileDatabase}> - {imProfileDescription}

示例:

<key name="iwFileCaptionFormat" value="#{imProfileDocNum}v{imProfileVersion}<{imProfileDatabase}> - {imProfileDescription}" />

iwFileNameSizeFormat

发送使用 MailTemplate.oft 文件的电子邮件时格式化文件名和大小信息。其使用 WSProfileAttributeID 枚举的成员,前后分别有 "{" 和 "}"。

默认值:{imProfileDescription}.{imProfileExtension} ({imProfileSize})

示例:

<key name="iwFileNameSizeFormat" value="{imProfileDescription}.{imProfileExtension} ({imProfileSize})" />

iwAttachmentFileNameFormat

将文件作为电子邮件附件发送时格式化文件名。

默认值:{imProfileDescription}({imProfileDocNum}.{imProfileVersion}.{imProfileExtension})

示例:

<key name="iwAttachmentFileNameFormat" value="{imProfileDescription}({imProfileDatabase}.{imProfileDocNum}.{imProfileVersion}.{imProfileExtension})" />

iwPurgeRecentAgeThreshold

使用 iManage Work Desktop for Windows 打开 iManage Work 中的文件时,将该文件的副本下载到 %AppData%\Roaming\iManage\Work\Recent 文件夹。除非手动删除,否则这些文件将一直保留在该文件夹中。为防止文件累积并过多地占用硬盘空间以及预防意外删除离线文件的风险,“清除”功能会自动将已超过特定天数(可配置)的文件从 Recent 中移除。

默认值:如示例中所指定

最小值:1

<key name="iwPurgeRecentAgeThreshold" value ="30"/>

注:

  • 系统文件或隐藏文件(如 .ini、.prf 和 .cmt)将不会被清除。

  • 已签出、已离线修改以及离线新建的 iManage 文件将被排除。

  • 被清除的文件将移动至本地回收站,而不是永久删除。

Microsoft Office Backstage 视图键

在 Backstage 视图中,文件详细信息字符串使用以下两个键显示:

"iwBackstageFileFormatSection1" + " " + "iwBackstageFileFormatSection2"

iwBackstageFileFormatSection1

用于在 Backstage 视图中显示文件详细信息字符串的第一部分。其使用 WSProfileAttributeID 枚举的成员,前后分别有 "{" 和 "}"。

默认值:{imProfileDescription}.{imProfileExtension}

示例:

<key name="iwBackstageFileFormatSection1" value="{imProfileDescription}.{imProfileExtension}"/>

images/download/attachments/69077574/Part1-Screen_Shot.png

iwBackstageFileFormatSection2

用于在 Backstage 视图中显示文件详细信息字符串的第二部分。其使用 WSProfileAttributeID 枚举的成员,前后分别有 "{" 和 "}"。

默认值:| v{imProfileVersion} | #{imProfileDocNum} | {imProfileAuthor} | {imProfileEditDate} | {imProfileSize}

示例:

<key name="iwBackstageFileFormatSection2" value="| v{imProfileVersion} | #{imProfileDocNum} | {imProfileAuthor} | {imProfileEditDate} | {imProfileSize}"/>

images/download/attachments/69077574/Part2-Screen_Shot.png

iwDocumentShortcutFormat

用于在 Backstage 视图的“收藏夹”中显示文件的快捷方式;默认值仅为描述。其使用 WSProfileAttributeID 枚举的成员,前后分别有 "{" 和 "}"。

默认值:{imProfileDescription}

示例:

<key name="iwFileShortcutFormat" value="{imProfileDescription}"/>

iwFileShortcutDescriptionFormat

用于显示文档快捷方式的目标信息。可在 iwAddinExtensionRes.dll 中找到相同的字符串。其使用 WSProfileAttributeID 枚举的成员,前后分别有 "{" 和 "}"。

默认值:Shortcut to document {imProfileDocNum} in library {imProfileDatabase}

示例:

<key name="iwFileShortcutDescriptionFormat" value="Shortcut to document {imProfileDocNum} in library {imProfileDatabase}"/>

images/download/attachments/69077574/Screen_Shot_2017-11-28_at_4.44.30_PM.png

iwUseFileName4NewVersion

根据本地文件名设置新文档版本的描述字段,而非使用现有版本的描述。

有效值:"Y" 或 "N";"true" 或 "false"

默认值:N

示例:

<key name="iwUseFileName4NewVersion" value ="N"/>

iManage Work Agent 选项

workagent

协助监控后台任务的进度,例如打印、签入、签出等。

包含以下键:

  • CountThreshold 键:达到指定数量后,自动清理 iManage Work Agent 中的旧通知。

  • AgeThreshold 选项:达到指定天数后,自动清理 iManage Work Agent 中的旧通知。

  • NonIntegratedProcesses:包含编辑时无法锁定文件的非集成应用程序的逗号分隔列表。

  • RestrictOriginsToRegisteredServers:启用后,将从用户的注册服务器 URL 接受通过本地主机发起的 iwl 调用。默认值为“N”(无限制)。

  • AllowedOrigins:允许通过本地主机调用 IWL 的其他来源(服务器 URL)的逗号分隔白名单。若未配置,将没有限制。

  • HideAgentAutoUpdateMenu:启用后,Work Agent 中与自动更新有关的菜单选项将不对最终用户显示。

    注:

    • HKEY_CURRENT_USER\Software\iManage\Work\10.0\Client 配置单元中,HideAgentAutoUpdateMenu 注册表设置将被该配置覆盖。

    • 更改后的设置将在 Work Agent 重新启动 1 分钟后或在配置文件中更改该选项 30 分钟后生效。

示例:

<ws_option name="workagent" applyToAll="true">
<key name="NotificationCountThreshold" value="50"/>
<key name="NotificationAgeThreshold" value="7"/>
<key name="AttentionCountThreshold" value="50"/>
<key name="AttentionAgeThreshold" value="7"/>
<key name="NonIntegratedProcesses" value="notepad"/>
<key name="RestrictOriginsToRegisteredServers" value="N"/>
<key name="AllowedOrigins" value=""/>
<key name="HideAgentAutoUpdateMenu" value="N"/>
</ws_option>

签出文件通知

iwCheckoutOverdueAgeThreshold

iManage Work Desktop for Windows 将提醒用户他们签出了需要签入的文档。默认情况下,如果文档保持签出超过六小时,用户即会收到 iManage Agent 通知。

指定文档保持签出状态达到多少小时后提醒用户。

默认值:6

示例:

<key name="iwCheckoutOverdueAgeThreshold" value="6"/>

iwUseCheckoutOverdueReminder

启用或停用警告用户有文档保持签出状态的提醒。

有效值:"Y" 或 "N"

默认值:Y

示例:

<key name="iwUseCheckoutOverdueReminder" value="Y"/>

iwDocCloseReminderTimeOfDay

指定在一天的什么时刻提醒用户关闭已签出的文档。例如,如果用户一般在下午 6:30 离开办公室,则将默认时间更改为 18:30。

有效值:时:分(24 小时制)

默认值:16:30

示例:

<key name="iwDocCloseReminderTimeOfDay" value="16:30"/>

iwDocCloseReminderSnoozeDuration

指定经过多长时间(分钟)后重新显示关闭文档提醒(如果用户关闭提醒)。

值范围:5-30

默认值:10

示例:

<key name="iwDocCloseReminderSnoozeDuration" value="10"/>

iwDocCloseReminderMaxSnoozeNum

指定关闭文档提醒出现多少此后当天不再提醒。

值范围:1-10

默认值:3

示例:

<key name="iwDocCloseReminderMaxSnoozeNum" value="3"/>

iwUseDocCloseReminder

启用或停用在一天中的指定时刻后警告用户关闭已签出文档的提醒。

有效值:"Y" 或 "N"

默认值:N

示例:

<key name="iwUseDocCloseReminder" value="N"/>

其他选项

DefaultOpen

包含在 iManage Work“打开”对话框中可用的选项列表。您可以使用下列键进行修改。您可以将这些键的值设置为所需的任意字符串。例如,可以将 iwAttemptOpen 键设置为“Open My Document”。

默认值:如示例中所指定。

示例:

<ws_option name="DefaultOpen" applyToAll="false" >
<key name="iwAttemptOpen" value="Open" />
<key name="iwAttemptOpenReadOnly" value="Open Read-Only" />
<key name="iwAttemptOpenasCopy" value="Open as Copy" />
<key name="iwAttemptOpeninProtected" value="Open in Protected View" />
</ws_option>

默认选项:

images/download/attachments/69077574/Screen_Shot_2017-11-28_at_4.48.30_PM.png

iwAttemptOpen 键设置为“Open My Document”后:

images/download/attachments/69077574/Screen_Shot_2017-11-28_at_4.55.01_PM.png

documentLinkCommands

以下键提供了 iManage Work“浏览”对话框中将所选文档作为超链接(IWL 链接)插入的默认选项。第一个选项会插入所选文档最新版本的链接,第二个选项将插入
该文档当前版本的链接。您可以将这些键的值设置为所需的任意字符串。例如,可以将“iwAttemptInsertLink2Latest”键设置为“My Latest Document”。

默认值:如示例中所指定

示例:

<ws_option name="documentLinkCommands" applyToAll="false" >
<key name="iwAttemptInsertLink2Latest" value="Latest" />
<key name="iwAttemptInsertLink2ThisVersion" value="This Version" />
</ws_option>

audit

确定是否启用并记录与打印操作有关的审核历史记录事件。

默认值:如示例中所指定

示例:

<ws_option name ="audit" applyToAll="false">
<key name="EnableAuditWordPrint" value="Y"/>
<key name="EnableAuditExcelPrint" value="Y"/>
<key name="EnableAuditPowerPointPrint" value="Y"/>
<key name="EnableAuditProjectPrint" value="Y"/>
<key name="AuditWordPrintPages" value="IWEnumAuditPrintPageType.All"/>
<key name="AuditExcelPrintPages" value="IWEnumAuditPrintPageType.None"/>
<key name="AuditPowerPointPrintPages" value="IWEnumPrintType.None"/>
</ws_option>

integration

定义 iManage Work Desktop for Windows 与 Microsoft Office 集成所使用的选项。

默认值:如示例中所指定

示例:

<ws_option name="integration" applyToAll="true">
<key name="PassiveMode" value="N"/>
<key name="WordDocumentOpenFilter" value="All Word Documents (*.docx,*.docm)|WORDX,WORDXT"/>
<key name="ExcelDocumentOpenFilter" value="All Excel Files (*.xlsx,*.xlsm)|EXCEL,EXCELX"/>
<key name="PowerPointDocumentOpenFilter" value="All PowerPoint Presentations (*.pptx,*.ppt,*.pptm,*.ppsx,*.pps,*.ppsm,*.potx,*.pot,*.potm,*.odp)|PPTX,PPT"/>
<key name="VisioDocumentOpenFilter" value="All Visio Files (*.vsdx,*.vsdm)|VSDX,VSDM"/>
<key name="ProjectDocumentOpenFilter" value="All Projects Files (*.mpp,*.mpt)|MPP,MPT"/>
</ws_option>

iManage Work Desktop for Windows 支持与 Microsoft Office 的被动集成模式。在被动集成模式中,“打开”和“保存”操作的功能保持不变。若要启用被动集成,需将 PassiveMode 配置的值设置为 "Y"。

iwReEnabledAddinOption

确定在下次启动应用程序时 Microsoft Outlook、Word、PowerPoint、Excel、Visio 和 MS Project 的已禁用 iManage 加载项的自动重新启用行为。

示例:

有效值:

0:在用户下次启动应用程序时,加载项自动启用并显示一条 iManage Work Agent 通知。

1:加载项不自动启用,用户可根据需要手动启用。

2:iManage Work Agent 在用户下次启动集成的应用程序时提示用户启用加载项。如果用户选择,Agent 将显示一条通知,提示加载项已启用。

默认值:0

示例:

<key name="iwReEnabledAddinOption" value ="0"/>

adobeconversion

允许用户选择 Adobe 转换器,以使用所集成的 Microsoft Office 应用程序中的 iManage > 另存为 PDF 选项将文档作为 PDF 保存到 iManage Work 中。

有效值:"Y" 或 "N"

默认值:N

示例:

<ws_option name="adobeconversion" applyToAll="true">
<key name="Enabled" value="N"/>
</ws_option>

shellexecute

允许您通过将特定文件类型加入黑名单来阻止用户使用 iManage Work Desktop for Windows 或 iManage Work Web 客户端打开或打印这些文件,从而减少安全漏洞。

注:

某些文件类型已在应用程序中硬编码,以阻止它们使用 Windows 中的 ShellExecute 功能,例如可执行文件和 JavaScript 文件。因此,用户将无法打开或打印这些类型的文件。

有效值:用逗号分隔的小写文件扩展名。例如,如果您不希望打印富文本格式和文本文件,则将值更高为 "txt, rtf"。

默认值:空

示例:

<ws_option name="shellexecute">
<key name="blacklist" value=""/>
</ws_option>

coauthoring

有关更多信息,请参阅 iManage Work 共同创作指南 10.2 中的自定义 Office 应用程序中的用户体验部分。

参考

¹ 有关更多信息,请参阅 Excerpt - Appendix C - WSProfileAttributeID enumerators