与其他应用程序集成 > Windchill Workgroup Manager 文档 > CATIA V5 > 管理员 > CATIA V5 的首选项 > wgmclient.ini 文件中的常用首选项
  
wgmclient.ini 文件中的常用首选项
本主题列出了 CATIA V5 最常用的 Windchill Workgroup Manager 首选项,用户可通过使用 wgmclient.ini 文件对其进行管理。
* 
本主题不会列出可设置的每个客户端首选项。有关客户端首选项的完整列表,请参阅位于 Windchill Workgroup Manager 主目录下的 wgmclient.ini 文件。
如果在 [CATIA V5] 部分下未列出该首选项,请滚动至 wgmclient.ini 文件的开头,然后搜索该首选项的名称。
本地保存文件后,重新启动 Windchill Workgroup Manager 以使经修改的首选项可用。
有关详细信息,请参阅管理 Windchill Workgroup Manager 首选项
名称
说明
所有值
expose.model.annotations
用于控制:在“保存到工作区”或“检入”时,是否在下游进程向 Windchill 公开模型注释。此首选项仅适用于 CATIA V5。
Yes:将模型注释向 Windchill 公开
No (默认):不公开模型注释
checkin.content.options
指定如何在创作应用程序菜单上保存模型和“自动检入”,并为“自定义检入”提供了默认的界面设置。
Models (默认)
Models and Viewables
save_to_ws.content.options
“保存到工作区”窗口中“工具”菜单的“内容”选项提供默认的界面设置。
Models Only (默认)
* 
CATIA V5 不支持创建客户端可视项;因此无法创建可视项。
save_to_ws.upload
“保存到工作区”窗口中“工具”菜单的“上载”选项提供默认的界面设置。
Yes (默认)
No
import.to.workspace.upload
指定在“导入”操作之后是否上载模型。
No (默认)
Yes
UndoCheckout.overwrite.local.content
指定在使用“撤消检出”时,是否覆盖缓存中的模型内容。
No (默认)
Yes
overwrite.contents.on.update
指定在 Windchill Workgroup Manager 中使用“更新”时,是否覆盖缓存中的模型内容。
No (默认)
Yes
wgm.autoattach
允许配置作为模型的附加内容而上载的内容。
该首选项的格式为:*.CATPart,*。<附件文件扩展名 1>,<附件类型 1>;… …;<附件文件扩展名 n><附件类型 n>
默认首选项值为空。
除已列出的文件类型外,用户可以将其他文件类型指定为自动附件。
open.modifies.checkedout.objects
确定系统参数更新后,检出模型是否在会话中显示为已修改。
Yes (默认)
No
unmanaged.read.only.area.folders
Windchill Workgroup Manager 将忽略从指定的文件系统路径检索到的文件 (假定无需在 Windchill 中管理这些文件)。
含有构成 ROA 的文件夹路径的列表 (以分号进行分隔)。
catiav5.template.part.nr
CATIA V5 中进行检索时,如果部件编号仍然设置为默认值并且未映射至任何其他 Windchill 属性,则将其设置为与模型的文件同名 (不带扩展名)。
使用 Windchill 模板中部件编号所使用的字符串对该首选项的值进行设置。
update.drawing.alwaysShowDialog
确定在保存到工作区或检入时是否以窗口形式提示用户更新绘图。
Yes (默认)
No
force.update.metadata.on.open
控制在打开模型时是否传播元数据 (全局属性 (IBA) 和系统属性),并允许此传播发生延迟以获得更佳性能。
有关使用 force.update.metadata.on.open 和其他首选项来提高性能的详细信息,请参阅延迟属性的元数据更新
* 
此首选项仅适用于 CATPart。
Yes (默认) - CATIA V5 CATPart:以任何模式 (包括可视化模式) 打开文档都会对文档的全局属性进行更新。系统属性会根据 update.metadata.on.load 的值进行更新。
No - CATIA V5 CATPart:根据 update.metadata.on.load 的值更新元数据。
Legacy - CATIA V5 CATPart:旧数据的全局属性会根据 update.metadata.on.load 的值更新。此首选项仅应用于没有中性数据 XML 文件的文档 (自 Windchill 9.0 之前版本升级而来的模型)。
update.metadata.on.load
控制是否更新 CATIA V5 中打开的 CATIA V5 CATPart 文档的元数据 (全局属性 (IBA) 和系统属性),此更新可提升性能。
有关详细信息,请参阅延迟属性的元数据更新
* 
为了获得最佳性能,请将 update.metadata.on.loadforce.update.metadata.on.open 设置为 No
如果 force.update.metadata.on.open=Yes,则无论 update.metadata.on.load 的值如何,都会对以可视化模式加载的文档的全局属性进行更新。加载绘图时,无论 update.metadata.on.load 的值如何,都会对绘图通过属性链接参考的任何 CATIA V5 文档的元数据进行更新。
Yes (默认) - 以产品模式、Brep 模式或设计模式加载 CATIA V5 CATPart 文档时,都会更新元数据。以可视化模式加载 CATIA V5 CATPart 时,该文档不会更新。
No - 仅在以设计模式加载 CATIA V5 CATPart 文档时更新元数据。
* 
如果 update.metadata.on.load=No,则过期元数据值显示在未以设计模式加载的任何 CATIA V5 CATPart 文档的 CATIA V5 中。
update.metadata.on.save
控制是否在“保存”操作 (例如“保存到工作区”“检入”,和“导入至工作区”) 期间更新元数据。
Yes (默认) - 在保存操作期间更新元数据。
No - 元数据在保存操作期间未更新。更新将会推迟,直至下一次“打开”操作时才会进行。
enable.readonly.in.session
控制是否启用“在会话中只读”功能。
No (默认)
Yes
allow.missing.design.table
当设计表丢失时,此首选项用于控制是否以提示窗口的形式允许继续执行“保存到工作区”或“检入”操作。
No (默认)
Yes
enable.environment.management
指定用于控制启用及管理环境信息的字符串。
No (默认)
Yes
environment.management.parameter
字符串值用于定义环境全局属性的名称。
PTC_WM_ITERATION (默认)
None - 禁用管理环境信息
enable.replace.in.cad.session.on.refresh
控制是否在刷新时启用“在 CAD 会话中替换”功能。
该首选项仅适用于将已过期的装配级 CGR 加载到已过期的会话中。
Yes
No
generic.is.read.only=
将会话中的通用部件/装配设置为“只读”状态
No (默认)
Yes
allinonecatpart. 名称
指定一体化 CATPart 的命名规则。
_AllCATPart
allinonecatpart.creation.merge.all.bodies
在生成产品部件时控制合并所有主体。
No (默认)
Yes
identify.standard.part
指定用于控制显示标准部件信息的字符串对。如果显示,则会使用反映定义标准部件时所使用的约定的字符串值,在规范树中搜索标准部件。
采用的格式是以分号分隔的字符串对,其中包括 CAD 模型的文件名和几何集的名称。
Blank - 将不会显示标准部件的设计信息
expose.parameters.under.geometrical.set.from.specification.tree
通过指定需要在其下方显示所有参数的几何集的名称,控制是否在规范树的几何集下方显示参数。
Blank
Names
All
expose.annotation.text.notes.from.specification.tree
控制“保存到工作区”或“检入”时是否在规范树的注释集下显示参数。
No (默认)
Yes
expose.measure.inertia.property
控制是否在“保存到工作区”或“检入”时显示测量惯性特性。
Blank (默认)
PartBody
store.formula.value.for.parameters
存储使用公式的参数的公式值,而非显示值。
No (默认)
Yes
expose.manufacturing.information
对相关的制造数据执行“保存到工作区”或“检入”操作时,控制是否在 Windchill 中将制造信息显示为附属内容 (XML 文件),例如 CATIA V5 CATProcess。
No (默认)
Yes
ignore.missing.dependents
确定是否忽略缺失的相关性,或者在执行“导入到工作区”、“保存到工作区”或“检入”操作时是否为其创建幻影部件。
No (默认)
Yes
managed.read.only.area.folders
只读区域 (ROA) 首选项旨在告知 Windchill Workgroup Manager 将从指定文件系统路径中检索到的所有部件或参考装配,均被视为已经存在于 Windchill 中的对象。
该首选项含有构成 ROA 的目录路径的列表 (以分号进行分隔)。
enable.pdm.status.icons
在结构树中显示 PDM 状况图标。
Yes (默认)
No
enable.localPreview.on.save.catalog
控制对目录数据执行“保存到工作区”或“检入”操作时,是否启用强制使用“本地预览”功能。
No (默认)
Yes
import.to.workspace.structure.only
控制在“导入到工作区”时是否导入结构成员。
No (默认)
Yes
wwgm.download.method.upon.open
控制如何在操作 (例如“添加至工作区”“在 CATIA 中打开”) 期间从公用区为 CATIA V5文档下载内容。
Full (默认)
CGR
Async
有关此首选项及其值的详细信息,请参阅从公用区下载大型装配时提高性能
open.assembly.cgrs
启用在装配级 CGR 模式下打开装配级 CGR 装配。
No (默认)
Yes
cache.size
指定客户端内部缓存的限制。
0 (默认)
设定值 (以 MB 为单位)。例如,800。
Date.Type.Parameter.Format
确定在创建或上次修改 CAD 文档时显示日期和时间的格式。
%dd%Mmm %yy (默认),例如 11-Jul-18
以下格式用于编写日期类型字符串:
%yyyy 4 位数年份 (例如,2015 年)
%yy 2 位数年份 (例如,15)
%MMM 月份 (例如,SEP)
%Mmm 月份 (例如,Sep)
%Month 完整的月份名称 (例如,9 月)
%mm 月份编号,由 2 位数组成 (例如,09)
%m 月份编号 (例如,9)
%dd 日期,由 2 位数组成 (例如,05)
%d 日期,没有占位 (例如,5)
%Hh 小时数 (例如,04)
%mi 分钟数 (例如,10)
%ss 秒数 (例如,59)
%Pm 指定上午 (AM)/下午 (PM) (例如,PM)
upload.autoattach.searchpath
指定磁盘上的路径 (用分号 (;) 分隔),用于搜索在上载时需要自动添加到 CAD 或动态文档中的附件。
用户可在搜索路径中使用环境变量,方法是将环境变量指定为 ${environment variable name}。
message.slider.timeout
控制弹出消息窗口停留在屏幕上的时间。
输入数值 (以秒为单位)。
10 (默认)
0 (禁用滑动窗口)
add.active.ws.to.dlnames
确定是否应将“活动工作区”添加至 DLNames 的 CATIA V5列表。
Yes (默认)
No
ascii.only.chars.in.workspace.name
限制工作区名称的 ASCII 字符。此首选项会在工作区本地目录开启 Unicode 工作区名称到 ASCII 名称的 Windchill Workgroup Manager 映射。
No (默认)
Yes
open.appVersionSelection.alwaysShowDialog
确定选择应用程序版本的窗口是否始终显示在 openInSession 上。
No (默认)
Yes
wwgm.remember.last.used.server
控制在后续 Windchill Workgroup Manager 客户端启动时是否重新连接到上次使用过的服务器。
Yes (默认)
No
windows.browser.type
设置 Windchill Workgroup Manager 嵌入式浏览器类型。
为 Chromium 浏览器类型,输入 Chromium_based_browser
为 Internet Explorer 类型输入 IE_In_Process
expose.mass.properties.only.main.body
对产品或部件执行“保存到工作区”或“检入”操作时,控制是否在显示质量特性时启用或禁用“仅主体”选项。
No (默认)
Yes
network.request.size
向 Windchill 上载内容文件时,确定以字节为单位的 HTTP 上载请求最大大小。
8000000 (默认)
整数值大于或等于 0
wf.network.threads
控制用于上载和下载内容的网络线程的数量。
6 (默认)
整数值大于或等于 0
wwgm.open.dialog.remember.last.location
在执行打开操作 (例如,“从 Windchill 打开”、“从 Windchill 插入”和“替换”(从信息页面)) 时,控制是否保留上次在“打开的对话框”中选定的“文件夹”。
Yes (默认)
No
java.script.errors
控制 java 脚本错误窗口的显示和执行。如果显示此窗口,则用户可以选取是要停止还是继续运行此脚本。
Show (默认)
Hide and run
Hide and stop
enable.auto.numbering.on.new.document.in.CATIA.session
控制是否将 Windchill 生成的编号用作创建于 CATIA V5 中新文档的文件名称和部件编号。
Yes (默认) - 对于在 CATIA V5 中创建的新文档,可将 Windchill 生成的编号用作文件名称和部件编号。
No - 对于在 CATIA V5 中创建的新文档,文件名称和部件编号将根据默认 CATIA V5 行为进行分配。
store.deactivated.component.as.suppressed
控制在执行保存到工作区、导入到工作区或检入操作时,取消激活的组件是否存储为隐含在 Windchill 中。
Yes (默认) - 将取消激活的组件存储为隐含在 Windchill 中。
No - 将取消激活的组件存储为常规子成员。组件不会存储为隐含在 Windchill 中。
enable.preselection.file.selection.dialog
控制默认情况下是否在文件选择窗口中选择某对象以用于所有 Windchill Workgroup Manager 客户的打开操作。其中包括“导入至工作区”“从 Windchill 打开”“从 Windchill 插入”等操作。
Yes (默认) - 默认情况下,会选择第一个有效文件。
No - 无预选文件。
add.to.workspace.replace.iteration.option
控制“添加至工作区”操作是否将本地工作区的小版本替换为公用区中选定的不同小版本。
Conflict (默认) - 操作失败并出现可忽视冲突。
Replace - 本地工作区小版本将自动替换为服务器中选定的小版本。
confirmation.dialog.display.file.rename.or.delete
控制是否在 CAD 工具中打开文件时 (如果该文件已在本地工作区进行重命名或已被删除) 显示确认窗口。
Yes (默认) - 将显示确认窗口。
No - 不显示确认窗口。
open.replace.in.session.dialog.suppress
如果模型已经载入到 CAD 会话中,则在打开操作的过程中,可以控制是否隐含“在会话中替换”冲突窗口。如果已隐含该窗口,则会自动替换 CAD 会话中的模型,即使该模型已在会话中经过修改。
此首选项将影响 Windchill 中的“在 [CAD 工具] 中打开” 操作、Windchill 中带有“打开”选项的“添加至工作区”操作以及 CAD 应用程序中的“从 Windchill 打开”操作。
No (默认) - 将显示“在会话中替换”窗口。
Yes - 将隐含“在会话中替换”窗口。
allow.import.when.models.in.session
当模型在 CAD 会话中处于打开状态时,此首选项用于控制是否允许启动导入操作。
No (默认) - 除非用户关闭 CAD 会话中打开的所有模型,否则将阻止导入操作继续进行。将显示带有用于关闭所有打开模型或取消操作的选项的窗口。
Yes - 当 CAD 会话中没有打开的链接模型时,允许导入操作继续。否则,将终止导入操作,并显示通知窗口。
save.to.workspace.dialog.suppress
控制是否在对新建和现有 CAD 文档执行“保存到工作区”“自动检入”和“自定义检入”操作时隐含“保存到工作区”窗口。
No (默认) - 将显示“保存到工作区”窗口。
Yes - 将隐含“保存到工作区”窗口。
update.instance.name
指定当部件编号更改时是否将实例名称与部件编号一同更新。
无论此首选项如何设置,都会依据本机 CATIA V5 规则自动添加一个序列号。如果文件扩展名是部件编号的一部分,则将包含在实例名称中。
对于已重命名或使用“另存为”操作保存的文档,实例名称将在于 CATIA V5 中打开参考文档时得到更新。重命名实例的父项装配将被修改。因此,必须将装配重新检入 Windchill 以保存实例名称更新。
No (默认) - 不更新实例名称。
Yes - 如果实例名称与部件编号不同,则更新实例名称。
lock.raster.drawing.views.on.publish
控制在 Theorem 文件同步工作器发布期间是否锁定光栅绘图视图。此首选项仅在使用 Theorem 工作器时适用。
No (默认) - 不锁定光栅视图,且生成表示时会更新光栅视图。如果不能成功呈现光栅视图,则生成的表示无法显示光栅视图。
Yes - 将会锁定光栅视图且不会更新。先前的光栅视图会显示在新的表示中。
update.drawing.views.on.publish
在文件同步工作器发布绘图期间控制是否要下载并加载所有关联的 3D 模型并更新绘图视图。
Yes (默认) - 在文件同步工作器发布绘图期间下载并加载所有具有其相关性的关联 3D 模型,并更新绘图视图。
No - 在文件同步工作器发布绘图期间禁止下载所有关联 3D 模型,也不会更新绘图视图。当从 CAD 检入时将绘图视图以显示状态发布。发布期间传播绘图的元数据更新。
* 
当此首选项设置为“否”时,在文件同步启用的 CATIA V5 工作器发布绘图期间不下载 CATDrawing 相关性。因此,绘图中的属性值由外部属性链接控制,例如,与 CATDrawing 关联的 CATPart 或·CATProduct 属性在 CATDrawing 发布期间不会更新。这意味着绘图标题块中的关联绘图模型的属性值 (Windchill 系统参数和 IBA) 可能不会更新。因此,此类属性值在 Creo View 表示中可能已过期。
conflict.dialog.display.update
控制在进行更新 (影响当前在 CAD 工具中打开的装配) 期间检测到新的 Windchill 创作结构更改时,是否显示冲突窗口。如果禁用了冲突窗口,即使经过修改,在 CAD 会话中打开的模型也会自动更新。
此首选项只影响设计上下文和带有注释结构链接的装配。它不会影响当属性或内容发生更改时是否会显示冲突窗口。
此首选项将影响以下操作:
Windchill 配置上下文中执行的“更新”“在 CATIA V5 中打开”
针对 Windchill 设计上下文执行的“保存定义”
从本地工作区中执行的“同步”“刷新”
CATIA V5 执行的“更新”操作
Yes (默认) - 将会禁用冲突窗口且不再显示。
Yes - 冲突窗口将会显示。用户可以选择更新 (默认) 或不更新所有受影响的模型。
set.missing.instance.name
指定如何在保存到工作区时设置缺失的实例名称。将根据本机 CATIA V5 规则自动添加一个序列号。
File Name (默认) - 将缺失的实例名称设置为文件名。
Part Number - 将缺失的实例名称设置为部件编号。
Initial Name - 将缺失的实例名称设置为实例创建时指定的名称。
manage.system.attributes
控制是否在将文件保存到 Windchill 或从中打开时管理系统属性 (例如 PTC_WN_NUMBER)。受影响的 PDM 操作包括“保存到工作区”、“检入”、“从 Windchill 打开”、“从 Windchill 插入”和“替换来自 Windchill 的元件”。
All (默认) - 管理所有系统属性。
None - 不管理任何系统属性。
[属性列表] - 仅管理已列出的用户定义的系统属性。对于多个属性,使用如下以逗号分隔的格式:
Attribute1,Attribute2,Attribute3
home.page.url
指定 Windchill Workgroup Manager 嵌入式浏览器的主页。
默认值为 http://www.ptc.com/products/windchill。
hide_default_workspaces.in_server_ management
控制是否显示虚拟工作区。
No (默认) - 为所有未定义工作区的上下文列出默认工作区。
Yes - 如果在所选服务器的任何上下文中至少创建了一个工作区,则不会列出从未使用过的默认工作区。
autoupdate.model.upon.filesync.publishing
控制是否在文件同步模式下发布时自动更新 CATIA V5 零件和装配。
Yes (默认) - 在文件同步期间,零件和装配会自动更新。
No - 文件同步期间已禁用自动更新。
* 
注意:确保将以下原生 CATIA 设置设为手动:
零件基础结构:Tools >> Options >> Infrastructure >>Part Infrastructure >> Update >> Manual
装配设计:Tools >> Options >> Mechanical Design >> Assembly Design >>Update >> Manual
allow.instance.to.standalone
控制是否将从 CAD 会话的族表中移除的实例另存为独立部件。
No (默认值) - 移除的实例将从 Windchill 族表中排除,且不会再被小版本化。
Yes - 允许将移除的实例另存为独立部件。