专业化管理 > 配置您的 Windchill 环境 > Windchill 搜索管理 > Windchill 搜索特性
  
Windchill 搜索特性
除非另行指定,否则请使用 wt.properties.xconf 来设置自定义特性值。


数据库和索引搜索特性
以下特性既适用于索引搜索,又适用于数据库搜索。
com.ptc.windchill.enterprise.search.advancesearch.enableEmptySearch
默认
false
简介
控制是否可以执行空通配符和单一通配符查询。
说明
启用后,利用该特性可以执行空白或单一通配符 ("*" 或 "?") 关键字查询,前提是至少包括下列约束之一:
仅选择一种对象类型
仅选择一个上下文或文件夹
“条件”下的至少一个属性字段提供值。
com.ptc.windchill.enterprise.search.displayUnSelectableValue
默认
true
说明
决定在执行高级搜索时是否使用那些在“类型和属性管理”实用程序中不再可选的全局枚举条目。
设置为 true 后,这些全局枚举条目便可作为高级搜索条件使用。
设置为 false 时,无法在高级搜索中使用这些全局枚举条目。
com.ptc.windchill.search.criteriaDisplayLength
默认
65
简介
限制搜索历史记录汇总的长度。 
说明
此特性用于控制标识搜索历史记录中的每个搜索所使用的字符数。此特性适用于“搜索历史记录和保存的搜索”选项卡中显示的“搜索历史记录”URL 字符串。
字符串长度为该字符串中 16 位 Unicode 字符的数量 (包括空格)。字符串长度计数中不包括结尾省略号。
例如:
设置为 65
Keyword=01*; End Item=Yes; Sourcing Status=Approved; Type=CAD Doc…
设置为 40
Keyword=01*; End Item=Yes; Sourcing Stat…
设置为 20
Keyword=01*; End Ite…
com.ptc.windchill.search.futureDateAttributes
默认
thePersistInfo.createStamp, thePersistInfo.modifyStamp
简介
定义将来日期无效的属性。
说明
使用此属性可以提供以逗号分隔的日期属性列表,对于这些日期属性将来日期无效。
因此,在将属性添加至搜索条件后,“明天”将在下拉值列表中隐藏。
* 
支持模型化属性和可变属性。提供属性值时,可以使用属性的内部名称。
com.ptc.windchill.search.latestRevisionQueryLimit
默认
<未设置>
简介
最新修订版本搜索的查询限制。
说明
此特性用于设置特定于最新修订版本搜索的查询限制。如果未设置此特性,则查询限制将使用 wt.pom.paging.snapshotQueryLimit 特性值。
有关执行最新修订版本搜索的详细信息,请参阅使用修订版本和小版本条件的搜索示例
com.ptc.windchill.search.queryBuilder.enableNullCriteria
默认
false
简介
允许搜索返回的结果为空值。
说明
设置为 true 后,您可以在属性条件中搜索空值。该操作适用于“字符串”“实数”以及“带单位的实数”属性。
为了支持此功能,在指定“高级搜索”页面的搜索条件时,“空”“非空”运算符将作为选项出现:
* 
执行分类搜索或索引搜索时,这些运算符无效。否则,会出现错误消息。
com.ptc.windchill.search.relationQueryLimit
默认
<未设置>
简介
定义依据对象关系进行搜索时处理对象的数量限制。
说明
此属性可以限制执行关系搜索时处理对象的数量。如果未设置此属性,则关系搜索将处理所有对象。
执行可建立索引的关键字搜索或最新版本搜索时,此特性将不适用。
com.ptc.windchill.search.TypesForLatestVersion
默认
<未设置>
简介
搜索结果仅限于最新修订版本的对象类型列表。
说明
此特性通常用于指定更改对象类型。
默认情况下,更改对象类型不能有多个修订版本。在“首选项管理”实用程序中,使用“更改修改跟踪”首选项设置此行为。默认值为“否”。如果将此首选项设置为“是”,则用户可以修订对象。
如果首选项设置为“是”,则也应考虑设置 com.ptc.windchill.search.TypesForLatestVersion特性。例如:
com.ptc.windchill.search.TypesForLatestVersion =
wt.change2.WTChangeIssue, wt.change2.WTChangeProposal,
wt.change2.WTChangeRequest2, wt.change2.WTVariance
* 
只有当用户将其搜索限定为在特性值中定义的对象类型时,此特性才有效。然而,如果搜索中包括多个对象类型 (例如,包括更改对象和部件的搜索),则该搜索将显示所有修订版本。


Windchill Index Search 特性
下列特性可控制索引建立和索引搜索的使用,并且必须进行适当设置,才能使·Windchill Index Search·正常工作。
com.ptc.windchill.search.facet.enum.maxItemsToDisplay
默认
5
简介
结果多面属性组下可以显示的结果数上限。
说明
使用多面搜索结果时,此特性适用。有关详细信息,请参阅多面搜索结果
如果结果集包含属性的多个值,则会在属性名称下对可能的值进行分组。如果要显示大量的值,则显示“全部显示”链接:
提供“全部显示”链接前,可以使用此属性来定义要显示的值的数量。
com.ptc.windchill.search.facet.maxResultCountForAccessCheck
默认
500
简介
根据访问控制,要检查的分面结果的最大数量。
说明
在渲染搜索结果小平面之前,此特性指定了按照访问控制规则进行检查的 Solr 结果数上限。有关详细信息,请参阅多面搜索结果
如果结果计数低于指定限制,则仅生成带有可访问 Facet 属性值的 Facet。如果结果计数高于指定限制,则不会根据访问控制规则检查结果便生成 Facet。
最大限制不应超过 solrconfig.xml 中指定的 maxBooleanClauses 特性。
wt.index.BulkIndexContentQueueList
简介
专门为内容载体对象建立索引队列。
说明
为内容载体对象指定索引队列列表。对 wt.index.BulkIndexQueueList 使用此特性以改进成批索引性能。有关详细信息,请参阅批索引工具
在典型的环境中,可以 2:1 的比率将该值设置为 wt.index.BulkIndexQueueList 特性的值。例如:
wt.index.BulkIndexQueueList=BulkIndexQueue1, BulkIndexQueue2
wt.index.BulkIndexContentQueueList=
BulkIndexContentQueue1,BulkIndexContentQueue2,
BulkIndexContentQueue3,BulkIndexContentQueue4
然而,当与非内容载体对象进行比较时,可以根据系统中内容载体对象数量之间的差异自定义此比率。
wt.index.BulkIndexQueueList
默认
BulkIndexQueue1,BulkIndexQueue2
说明
成批索引工具所使用的索引队列列表。
wt.index.bulkIndexSize
默认
200
说明
要在成批索引操作期间一次性建立索引的对象数量。 
wt.index.checkDocumentTypes
默认
true
简介
启用 (“真”) 或禁用 (“假”) 功能以将文件类型从索引建立过程中排除。
说明
确定是否将在·wt.index.filterFileTypes·特性中设置扩展名的文件类型从搜索索引建立过程中排除。如果设置为 true,这些文件类型会被排除。
* 
一旦特性经过修改,必须对全部数据重新建立索引,以便从索引服务器中移除已建立索引的文件。
wt.index.checkIndexingRulesBeforeQueue
默认
false
简介
启用 (“真”) 或禁用 (“假”) 检查对象的索引规则,然后再将对象添加至索引队列。
说明
如果启用该特性,则会根据索引规则从队列中筛选对象。如果禁用,在索引时筛选出不可索引的对象。
wt.index.defaultQueueInterval
默认
60
说明
索引队列轮询线程的初始休眠或超时间隔 (以秒为单位)。 
wt.index.indexSearchableAttributes
默认
false
说明
SearchableAttributesByType.properties 文件用于确定在执行高级搜索时显示在“条件”菜单中的属性。使用此特性,您可以仅为在此文件中配置的属性建立索引。
false - 为所有符合条件的属性值建立索引。
true - 仅为在 SearchableAttributesByType.properties 中配置的属性建立索引。
* 
如果更改此特性值,则必须为搜索存储库重新建立索引。
wt.index.enabled
默认
true
说明
启用 (true) 或禁用 (false) Windchill Index Search
wt.index.enableIndexingOfEnumDisplayName
默认
false
说明
如果设置为 true,用户可以针对枚举列表条目的显示名称进行搜索。
wt.index.enableIndexSearchHighAvailability
默认
false
简介
启用索引搜索高可用性 (云模式)。
说明
启用或禁用索引搜索高可用性。
如果以独立模式安装 Solr,请将该值设置为 falseWindchill 将尝试联系 wt.index.solrHost 值中提供的 Solr 主机。
如果以云模式安装 Solr,请将该值设置为 trueWindchill 将尝试联系 wt.index.zookeeperHosts 值中提供的主机。
wt.index.enableTextPreview
默认
false
简介
启用上下文中的关键字工具。
说明
此属性可确定上下文中的关键字功能是否可供用户使用。如果设置为 true,则用户从“搜索结果”表格创建自定义表格视图时,可以使用“文本预览”列。
“文本预览”列包含文档预览工具 。将光标悬停在工具图标 上可以查看文件内容中出现的关键字预览。
启用此首选项后,必须重新创建数据的索引才能使用预览工具。
* 
使用 wt.index.supportedTypesForTextPreview 配置附加的内容载体对象类型。
wt.index.enableXMLTagSearch
默认
false
简介
用于确定 XML 文档建立索引的方式,并启用或禁用 XML 标记搜索。
说明
默认情况下,会为 XML 文档建立索引。但是,您可以确定要对 XML 文档中的多少数据建立索引。
false - 仅为 XML 文档内容 (XML 标记之间的值) 建立索引。用户可以针对文档内容执行关键字搜索,从而搜索 XML 文档。
true - 为所有 XML 内容 (包括 XML 标记和标记属性) 建立索引。用户可以执行专门的 xml: 搜索,以仅对 XML 文档进行关键字搜索。这些搜索可针对文档内容、XML 标记、XML 属性和属性值执行。有关详细信息,请参阅 XML 文档搜索
* 
如果启用 XML 标记搜索,则必须为先前已建立索引的 XML 文档重新建立索引,以将其包括在搜索结果中。
wt.index.excludeAttributes
默认
xml,organization,url,entrySet,templateObject
简介
要从索引中排除的对象属性。
说明
可向该特性中添加其他对象属性以将其从索引中排除。
* 
从该特性中移除默认属性可能导致索引失败。
wt.index.federatedLibraries
默认
wblib
简介
建立对象索引时所依据的 Solr 核心。
说明
如果其他核心 (或集合) 被添加到 Solr 以为 Windchill 对象建立索引,则应使用以逗号分隔的列表进行指示。
wt.index.filterFileTypes
默认
XLSB,xlsb
简介
文件的文件扩展名列表:为便于搜索,不应对其建立索引。
说明
不应由 Solr 对文件内容建立索引的文件类型。仍可对关联的 Windchill 对象建立索引。输入文件扩展名,用逗号隔开且不得包含点号 (.)。
* 
Windchill shell 中执行 windchill wt.content.DataFormatUtil -list 以参阅有效的文件扩展名。
* 
wt.index.checkDocumentTypes 特性必须设置为 true 以使其生效。
wt.index.generateContentIndexingFailureLogs
默认
true
说明
对内容索引失败的对象启用或禁用日志生成。
wt.index.indexingLanguage
默认
<未设置>
简介
Windchill 对象和内容的索引与搜索采用的语言。
说明
默认索引语言:
<未设置> - 如果 wt.index.indexingLanguageList 仅有一个值,则使用该值。否则,语言将被设置为与方法服务器相同的语言。
本地 - 使用与方法服务器相同的语言。
由两个字符组成的 ISO639 语言代码 - 所支持语言代码的列表在 properties.html 文件中可用。
wt.index.indexingLanguageList
默认
<未设置>
简介
Windchill 对象和内容的索引与搜索采用的语言的列表。
说明
这是由双字符组成的以逗号分隔的 ISO639 语言代码列表。如果不存在索引语言,则将默认的索引语言添加到此列表。
相应的 keywords_xx 字段应该出现在 Solr schema.xml 文件中。如果检测到的语言未出现在特性值列表中,则将该内容作为默认索引语言内容建立索引。
wt.index.indexWorkingCopy
默认
true
简介
启用或禁用检出对象的索引。
说明
如果将此特性设置为 true,将会对检出对象数据建立索引。检入对象时,将用新版本对该对象重新建立索引。如果检出被撤消,将会移除检出索引数据。
* 
此特性仅适用于 showWorkingCopy 选取器配置参数设置为“真”的选取器搜索。
wt.index.solrAdminUser
默认
<未设置>
说明
访问 Solr 时使用的用户名。
* 
此特性在以下文件中进行设置:
<Windchill>/codebase/WEB-INF/conf/index.solrAuth.properties
wt.index.solrAdminPassword
默认
<未设置>
说明
访问 Solr 时使用的密码。
* 
此特性在以下文件中进行设置:
<Windchill>/codebase/WEB-INF/conf/index.solrAuth.properties
wt.index.solrHost
默认
<未设置>
简介
Windchill 联系 Solr 时使用的主机名。
说明
以独立模式安装 Solr 时,Windchill 用于联系 Solr 的服务器主机名。
如果以云模式安装 Solr,则此特性可以留空。
如果此特性和 wt.index.zookeeperHosts 均为空,则意味着尚未安装 Solr。
wt.index.solrPort
默认
<未设置>
说明
Solr 监听来自 Windchill 的直接服务器对服务器 HTTP 请求时使用的 TCP/IP 端口。
wt.index.solrProtocol
默认
http
说明
以独立模式安装 Solr 时,Windchill 用于联系 Solr 主机的 TCP 协议。
wt.index.zookeeperHosts
默认
<未设置>
简介
以逗号分隔的 zookeeper 主机和端口的列表。仅当以云模式安装 Solr 时,此特性才适用。
说明
请使用以下格式指定 Zookeeper 节点:
<zookeeper_host1>:</zookeeper_port1>,<zookeeper_host2>:</zookeeper_port2>
wt.indexsearch.maxResults
默认
5000
说明
为高性能查询 (例如,最新修订版本搜索或范围搜索) 的索引搜索结果设置查询限制。
* 
此特性在 search.properties 文件中进行设置。
wt.index.solr.httpTimeoutSeconds
默认
600
简介
内部 HTTP SOLR 请求超时前的时长 (以秒计)。
说明
SOLR 索引和搜索请求的 HTTP 套接字超时。如果指定较小的值,可能会导致索引失败以及搜索过程中出现超时错误。
wt.index.supportedTypesForTextPreview
默认
wt.doc.WTDocument
简介
支持上下文中的关键字工具的内容载体对象类型。
说明
指定所有启用上下文中的关键字工具的其他对象类型。
如果将 wt.index.enableTextPreview 属性设置为 true,则用户从“搜索结果”表格创建自定义表格视图时,可以使用“文本预览”列。
com.ptc.windchill.search.getLastModifiedSearchResults,
com.ptc.windchill.search.enableOrderingOnLastModifiedDate
默认
false
说明
如果这些特性设置为 true,则搜索结果列表的顶部会显示包含最新修改的对象。默认值设为 false