配置服务
门户网站配置服务负责收集 IBM® WebSphere® Portal 引擎最重要的配置数据。
- 此处列示的许多属性都是在安装过程中设置的。因此,修改这些属性时,请提前做好规划并且需要特别小心。
- WebSphere Portal 和 WebSphere Integrated Solutions Console 还提供了 CP 配置服务;此服务具有仅用于标记和评级的属性。
- 配置服务还包括 WSRP 服务的配置属性。在各自相关的 WSRP 主题的上下文中列示并描述了这些属性。
- was.home = (${WAS_INSTALL_ROOT})
- 此路径是 WebSphere Application Server 安装目录的绝对路径。
- wps.home = (${WPS_INSTALL_ROOT})
- 此路径是 WebSphere Portal 的主目录(或安装目录)。
- redirect.login = (true)
- 成功登录后打开用户定义的重定向。如果在后面列出的 redirect.login.url 下指定 URL,那么该 URL 将用作重定向 URL。如果没有指定 URL,那么门户网站确定当前用户的缺省页面,并发送受保护门户网站区域中该页面的重定向。
- redirect.login.ssl = (false)
- 成功登录后在系统定义的重定向中打开 SSL。如果未对下面列出的 redirect.login.url 属性指定 URL,那么重定向 URL 将使用 HTTPS 协议。
- redirect.login.url [optional] = <none>
- 成功登录后指定重定向的 URL。如果没有指定 URL,那么门户网站确定当前用户的缺省页面,并发送受保护门户网站区域中该页面的重定向。此设置不影响隐式登录,例如,使用 LTPA 令牌或者通过外部安全性管理器进行的单点登录。
- redirect.login.authenticated.url [optional] = <none>
- 指定在用户由外部安全性管理器 (TAI) 认证且某个门户网站会话尚不存在时,第一次访问受保护页面后用于重定向的 URL。如果不指定 URL,门户网站则显示原先已请求的受保护页面,或如果会话继续功能已启用,那么显示用户在前一会话中访问过的上一页面。
- redirect.logout = (false)
- 成功注销后打开用户定义的重定向。如果在后面列出的 redirect.logout.url 下指定 URL,那么该 URL 将用作重定向 URL。如果没有指定 URL,那么门户网站确定公共门户网站区域中的缺省页面,并发送该页面的重定向。
- redirect.logout.ssl = (false)
- 成功注销后在系统定义的重定向中打开 SSL。如果没有指定 URL,那么重定向 URL 使用 HTTPS。
- redirect.logout.url = <none>
- 成功注销后指定重定向的 URL。如果没有指定 URL,那么门户网站确定公共门户网站区域中的缺省页面,并发送该页面的重定向。
- ldapserviceattributename.attribute [optional] = (uid)
- 使用此属性来确定在识别 IBM Process Server 上的各个用户时,门户网站工作流程集成是否使用了专门的用户属性。将此属性设置为任务认证期间由 IBM Process Server 使用的用户属性。出于此目的,IBM Process Server 使用 J2EE 主体名称。缺省情况下,J2EE 主体名称映射到大多数 LDAP 服务器(Domino 服务器除外)中的 uid 用户属性。Domino LDAP 服务器在缺省情况下使用 cn 属性,因此,对于这种配置,请将 ldapserviceattributename.attribute 设置为值 cn。此属性是可选的。
- multiple.realms.enabled = (false)
- 允许使用 uid@realm 登录的多领域支持属性。
- multiple.realms.login.default.realm = <none>
- 允许使用 uid@realm 登录的多领域支持属性。
- multiple.realms.user.dn.template = <none>
- 允许使用 uid@realm 登录的多领域支持属性。
- host.name = <none>
- 缺省情况下,host.name. 没有缺省值。在这种情况下,门户网站 URL 以入局请求的主机名开头。如果您希望 URL 中的主机名是静态的,那么在此输入主机名。例如,在集群安装中,您可以在此输入网络流量分派器的名称。如果输入了主机名,那么此条目用于创建门户网站 URL。
- host.port.http = <none>
- HTTP 端口(通常是 80)。
- host.port.https = <none>
- HTTP-SSL 端口(通常是 443)。
- security.css.protection = (true)
- 此属性用于确定是否开启 Cross-Site-Scripting 安全保护。启用该保护的缺省值为 true。
- redirect.commands = (false)
- 指定门户网站命令后跟 HTTP 重定向。使用该方法可以将 URL 加入书签。使用此功能会在某种程度上影响性能。因此,只能在需要时使用它。
- uri.context.path = (/wps)
- 用于运行门户网站的上下文路径。
- uri.context.path.facade = (/wsrp)
- 另一个 WAR 文件的上下文路径,该 WAR 文件用作外观 Web 应用程序以实现 WSRP。通过该路径,可以将安全套接字层 (SSL) 和客户机认证用于 WSRP,并同时使用门户网站的其他认证方法(例如,基于表单的认证)。由于 J2EE 只允许每个 WAR 文件有一个认证机制,所以这种分隔是必需的。
- uri.home.public = (/portal)
- 公用(或匿名)页面(即用户无需输入用户标识或密码就可以查看的页面)的门户网站引擎的 Servlet 上下文。
- uri.home.protected = (/myportal)
- 受保护(或个人)页面(即仅在输入用户标识和密码后用户才能查看的页面)的 Servlet 上下文门户网站引擎。
- uri.home.doc = (/doc)
- 文档区域的门户网站引擎的 Servlet 上下文。
- uri.home.substitution = (false)
- 确定当存在用户会话时是否必须将公用 URL 转换成受保护的 URL。要点: 为了保留 WebSphere Portal URL 的原始行为和设计假定,请将 uri.home.substitution 属性的值设置为 true。
Uri.home.substitution 控制 WebSphere Portal 在以下情况下的行为:已登录到正在运行 WebSphere Portal 的 IBM WebSphere Application Server 环境的用户使用 /portal URL 来访问 WebSphere Portal。
在已登录用户发出了 /portal 请求并且 uri.home.substitution 属性未设置或者已设置为 false 时,WebSphere Portal 的原始缺省行为是注销该用户并使其重定向到登录页面。将 uri.home.substitution 属性设置为 true 会更改该行为,以便 WebSphere Portal 将用户重定向到同一请求的 /myportal URL 版本而不将其注销,从而将公用 URL 转换为受保护的 URL。大多数用户希望 WebSphere Portal 按此方式运行。
WebSphere Application Server 安全性中一项名为 use available authentication 的设置影响了 WebSphere Portal URL 的行为。缺省情况下,use available authentication 设置现在设定为 true (此设置在 WebSphere Application Server 中)。 设定为 true 时,此设置会指示 WebSphere Application Server 为针对不受保护的 URL 的请求构建安全上下文,具体而言即 /portal URL(如果可能)。更具体地说,在入站请求中识别出 LtpaToken 之类的有效凭证后,WebSphere Application Server 将构建此安全上下文。在这种情况下,已登录用户对 /portal URL 的请求不会自动将此用户注销,而是将其重定向到登录页面。而请求将以不一致方式得到处理。许多对象看上去正常工作,如同用户被识别为已登录一样。但是,可能会发生一些细微的功能错误,具体而言在响应呈示将辅助请求嵌入 WebSphere Portal contenthandler 函数时发生这些功能错误。因此,要实现最正确的操作,请将 WP ConfigService 资源环境提供程序中的 uri.home.substitution 属性设置为 true。
将 uri.home.substitution 属性设置为 true 可以确保即便 WebSphere Application Server 使用安全上下文转发了对 /portal URL 的请求,WebSphere Portal 仍然会将用户重定向到同一 URL 的 /myportal 版本。此行为保留了原始设计假定,即使用两个 URL 入口点访问 WebSphere Portal,这两个入口点分别用于匿名访问和认证访问。
注: 在 uri.home.substitution 未设置或者已设置为 false 的情况下,如果您希望保留 WebSphere Portal 的原始行为,请参阅 logout.user.onpublic 属性和技术说明 Default triggers for implicit logouts changed in WebSphere Portal v8。 - wsrp.resourceproxy.basic.auth.credentialslot = <none>
- 在 WSRP 使用者门户网站上,可以使用此属性指定包含用户标识和密码凭证的凭证保险库槽。在访存受 HTTP 基本认证保护的资源时,资源代理 Servlet 使用来自凭证保险库槽的凭证。用户标识和密码将发送到远程 WSRP Portlet 的标记中引用的所有远程资源。
- wsrp.resourceproxy.no.header.forwarding = <none>
- 在 WSRP 使用者门户网站上,可以使用此属性指定除主机头和 Cookie 头外不是从客户机请求中转发的 HTTP 头的列表。不论此属性设置如何,都不会转发主机头和 Cookie 头。
- Persistent session properties
- 使用这些属性可以为用户配置会话持久性。有关持久会话状态及其可能的选项的更多信息,请参阅关于配置用户会话持久性的主题。
- persistent.session.level = (0)
- 确定持久会话必须运行的级别。如果您将此属性设置为值 3,那么此设置不影响隐式登录,例如使用 LTPA 令牌或者通过外部安全性管理器进行的单点登录。
- persistent.session.option = (0)
- 确定用户是否获取继续会话的选项。如果将此属性设置为 0,那么在登录时将应用 persistent.session.level 属性的级别设置,并且用户无法选择是否恢复上一会话。如果通过将此属性设置为 1 向用户提供恢复选项,那么您必须通过将 persistent.session.level 属性设置为 1 或 2 来配置持久会话保存级别。
- timeout.resume.session = (false)
- 会话超时需用户认证时确认是否继续会话。缺省值为 false。如果此属性设置为 false 并且用户试图在会话超时后继续会话,那么门户网站将显示错误消息,提示会话已超时,用户必须重新登录。如果您将此属性设置为 true,门户网站将忽略会话超时且不显示错误消息。用户无需认证即可恢复先前的会话并继续工作。在这两种情况下,将按照 persisted.session.level 属性的设置恢复上一会话。
- session.security.use.errorcode = (true)
- 使用该属性可指定,如果对门户网站服务器启用了会话安全性支持且会话中的用户与请求中的已认证用户不一致,门户网站执行重定向还是显示 HTTP 错误。会话安全性支持是 WebSphere Application Server 的固化功能。您可以为WebSphere Integrated Solutions Console中部分下的每个应用程序服务器激活它。如果该会话安全性支持已激活,应用程序服务器则检查每个经认证的请求中拥有当前会话的用户是否匹配发起该请求的用户。例如,该认证可以通过 LTPA 令牌来确定。门户网站服务配置属性在检测出会话用户与已认证用户不匹配的情况下,指定门户网站的行为。
如果您将此属性设置为 true,那么门户网站将返回您通过后面列出的 session.security.errorcode 属性定义的 HTTP 错误码。这通常将导致显示相应的错误消息。
如果您将此属性设置为 false,那么可以通过使用后面列出的 session.security.redirecturl 属性来指定重定向 URL。例如,您可以重定向到特定错误页面,该页面随后向用户显示。
缺省情况下,此属性设置为 true。
有关会话安全性支持的更多常规信息,请参阅与您的安装相对应的 WebSphere Application Server 信息中心 版本。
- session.security.errorcode = (409)
- 使用此属性可以指定在满足下列所有条件时返回的 HTTP 错误码:
- 会话安全性支持在 WebSphere Application Server 中已启用。
- 前面列出的 session.security.use.errorcode 属性设置为 true。
- 检测出会话中的用户与已认证的用户不匹配。
- session.security.redirecturl = <none>
- 使用此属性可以指定在满足下列所有条件时门户网站将重定向至的重定向 URL:
- 会话安全性支持在 WebSphere Application Server 中已启用。
- 前面列出的 session.security.use.errorcode 属性设置为 false。
- 检测出会话中的用户与已认证的用户不匹配。
- portal.session.protection = (true)
- 使用该属性可指定,对于每个经认证的门户网站请求,门户网站会检查门户网站会话中的用户是否与当前请求的调用方用户匹配。如果门户网站检查结果为不匹配,门户网站会取消现有会话,并为调用方用户创建新会话,以确保二者身份匹配。门户网站提供该固化功能,这将独立于 WebSphere Application Server 提供的会话安全性支持。缺省情况下,此属性设置为 true,因此缺省情况下门户网站会执行检查。
- portal.enable.filtering = (true)
- 该标志决定门户网站是否必须使用“门户网站过滤”。缺省值为 true。
- portlet.url.find = <none>
- 在全局设置 Portlet 中用于查找和设置的 URL。
- portlets.unauthorized.visible = (false)
- 确定没有被授权查看 Portlet 的用户所看到的内容。
- portletcontainer.std.custom.windowStates = <none>
- 此属性定义门户网站处理的定制窗口状态。此操作允许 Portlet 按照 Java Portlet 规范 1.0 中定义的方式指定定制窗口状态。同时满足下列两个前置条件时,门户网站允许
Portlet 生成 URL 并因此启动其他具有定制窗口状态的 Portlet:
- 所启动的 Portlet 在其部署描述符 (portlet.xml) 中指定定制窗口状态。
- 此窗口状态使用此属性注册。
- allow.derived.titles = (true)
- 确定用户是否能够重新定义派生页面的标题和描述。如果值设置为 false,那么用户只能更改非派生页面上的页面标题和描述。
- wps.mappingurl.portal_url_identifier = (/!ut/p)
- 此属性决定了门户网站 URL 的标识。有关此属性的格式规范,请参阅有关 URL 映射的主题。注: 在 WebSphere Portal V8.5 中,不推荐使用 URL 映射。
- wps.mappingurl.enabled = (true)
- 此属性决定了是否启用 URL 映射。可能的值为 true(表示启用 URL 映射)或
false(表示禁用 URL 映射)。缺省值为 true。注:
- 在 WebSphere Portal V8.5 中,不推荐使用 URL 映射。
- 创建 URL 映射或者创建或修改页面时,请确保门户网站中的 URL 映射与友好 URL 不匹配、不部分重叠并且不相互干扰。例如,请不要使用 home、ibm 和 ibm.com 之类的字符串,并且不要使用已在门户网站中用作 URL 映射或友好 URL 的字符串。否则可能发生若干浏览器重定向循环,有时没有错误消息。要确定此类字符串,请使用 XML 配置接口来创建门户网站的导出,并扫描所导出的 XML 结果输出文件以查找要用于 URL 映射或友好 URL 的字符串。
- wps.mappingurl.invalid = (false)
- 此属性决定了门户网站对包含路径信息的 URL 映射的响应方式。请指定以下两个值之一:
- true
- 如果将此属性设置为 true,并且门户网站接收到针对包含路径信息的 URL 映射的请求,那么门户网站将返回 HTTP 404 错误或者将用户重定向到缺省门户网站页面。
- false
- 此值为缺省值。如果将此属性设置为 false,并且门户网站接收到针对包含路径信息的 URL 映射的请求,那么门户网站将按照 friendly.pathinfo.enabled 属性定义的那样进行响应。
注意:- 在 WebSphere Portal V8.5 中,不推荐使用 URL 映射。
- friendly.pathinfo.enabled 属性同时适用于友好 URL 和 URL 映射。
- state.decoding.fallback 属性不适用于门户网站解释为 URL 映射或友好 URL 的 URL。如果您使用友好 URL 或 URL 映射,请考虑一致地设置 state.decoding.fallback、wps.mappingurl.invalid 和 friendly.pathinfo.invalid 参数。此操作可帮助提供一致的用户体验。示例:如果设置了 state.decoding.fallback = false,请考虑设置 wps.mappingurl.invalid = true 和 friendly.pathinfo.invalid = true。
- navigation.portletmenu.mode = (0)
- navigation.portletmenu.mode 属性定义以何种方式在整个门户网站导航菜单结构中集成 Portlet 菜单。Portlet 菜单是导航部件,它们由 Portlet 自已提供。它们可以作为子树添加到引用 Portlet 所在页面的导航菜单项。此属性具有以下三个选项:
0 禁用:导航菜单中不再显示 Portlet 菜单。此值为缺省值。
1 当前选择:只有当前选定页面上的 portlet 的 portlet 菜单才被添加到该页面的导航菜单项下。
2 所有:所有页面上的所有 portlet 的 portlet 菜单都被添加到导航树中相应的导航菜单项下。
- navigation.expansion.defaultstate = (false)
- 此值确定缺省情况下是展开还是折叠导航树中的节点。缺省值为 false,这意味着节点已折叠。存在一些例外;例如,“门户网站管理”导航树在缺省情况下是展开的。注: 将此值设置为 true 不会影响 Web 2.0 主题,因为展开状态并非从门户网站 REST 服务返回。
- page.reload.interval = (0)
- 此值定义未认证用户的页面重新装入时间间隔。使用它来指定必须为未认证用户重新装入门户网站页面层次结构的时间间隔(以分钟为单位)。重新装入不妨碍该用户最新的访问控制设置。如果将该值设置为零,那么会话期间不会自动重新装入。
- wsrp.caching.enabled = (true)
- 使用此属性可以启用或禁用 WSRP 标记高速缓存。此属性的缺省值为 true。如果未对此属性指定任何值,那么此值表示 WSRP 标记高速缓存已启用。有关更多信息,请参阅有关“WSRP 标记高速缓存”的主题。
- friendly.enabled = (true)
- 此属性确定是否可以在管理页面 Portlet 中为门户网站页面设置友好 URL 名称。缺省值为 true。如果您将此属性设置为
true,那么可以在“管理页面”Portlet 中为门户网站页面添加友好 URL。“友好”意味着您可以使用简洁易记的名称来表示特定门户网站页面。要为门户网站页面添加友好 URL,单击要添加友好 URL 的页面的编辑页面属性图标。然后可以将 URL 赋予门户网站用户,用户可以通过在其浏览器的地址字段中输入 URL 来访问该页面。注: 创建 URL 映射或者创建或修改页面时,请确保门户网站中的 URL 映射与友好 URL 不匹配、不部分重叠并且不相互干扰。例如,请不要使用 home、ibm 和 ibm.com 之类的字符串,并且不要使用已在门户网站中用作 URL 映射或友好 URL 的字符串。否则可能发生若干浏览器重定向循环,有时没有错误消息。要确定此类字符串,请使用 XML 配置接口来创建门户网站的导出,并扫描所导出的 XML 结果输出文件以查找要用于 URL 映射或友好 URL 的字符串。
如果此属性设置为 true,那么您可以使用后面列出的 friendly.redirect.enabled 属性确定在传入 URL 未包含所寻址页面的友好 URL 前缀时,是否必须发送重定向。
- friendly.redirect.enabled = (true)
- 使用此属性可确定在传入 URL 未包含所寻址页面的友好 URL 前缀时,是否必须发送重定向。如果通过将
friendly.enabled 属性设置为 false 禁用了友好 URL,那么此属性不起任何作用。此属性的有效值如下所示:
- true
- 如果门户网站部署中使用了外部安全性管理器,并且此外部安全性管理器配置为根据 URL 的前缀来保护 URL,请将此属性设置为 true。此值是此属性的缺省值。
- false
- 如果将此属性设置为 false,那么在先前情况中不发送重定向。
- friendly.pathinfo.validation.redirect.onsuccess.enabled = (true)
- 此键指定在传入友好 URL 的路径信息有效的情况下门户网站是否发送所需的友好 URL 重定向。请指定以下两个值之一:
- true
- 此值为缺省值。如果将此属性设置为 true,并且门户网站接收到针对包含路径信息的友好 URL 的请求,那么门户网站将发送所需的友好 URL 重定向,就像 friendly.redirect.enabled 设置为 true 时一样。如果响应指示路径信息未识别可用的内容项,那么将只禁止所需的友好 URL 重定向,以确保发送了所配置的 HTTP 状态码。
- false
- 如果将此属性设置为 false,那么门户网站会按照 friendly.redirect.enabled 属性定义的那样发送友好 URL 重定向。
- friendly.pathinfo.invalid = (false)
- 此属性决定了门户网站对包含路径信息的友好 URL 的响应方式。请指定以下两个值之一:
- true
- 如果将此属性设置为 true,并且门户网站接收到针对包含路径信息的友好 URL 的请求,那么门户网站将返回 HTTP 404 错误或者将用户重定向到缺省门户网站页面。门户网站响应取决于 state.decoding.fallback 属性的设置。
- false
- 此值为缺省值。如果将此属性设置为 false,并且门户网站接收到针对包含路径信息的友好 URL 的请求,那么门户网站将按照 friendly.pathinfo.enabled 属性定义的那样进行响应。
注: state.decoding.fallback 属性不适用于门户网站解释为 URL 映射或友好 URL 的 URL。如果您使用友好 URL 或 URL 映射,请考虑一致地设置 state.decoding.fallback、wps.mappingurl.invalid 和 friendly.pathinfo.invalid 参数。此操作可帮助提供一致的用户体验。示例:如果设置了 state.decoding.fallback = false,请考虑设置 wps.mappingurl.invalid = true 和 friendly.pathinfo.invalid = true。 - friendly.pathinfo.enabled = (true)
- 此属性确定 URL 映射和友好 URL 中是否可以包含内容项的路径信息作为此 URL 的组成部分。请指定以下两个值之一:
- true
- 此值为缺省值。如果将此属性设置为 true,并且门户网站接收到针对包含路径信息的 URL 的请求,那么门户网站将使用该路径信息并将用户定向到指定的门户网站页面。注: friendly.pathinfo.enabled 属性同时适用于友好 URL 和 URL 映射。
对友好 URL 中的路径信息的支持还要求 friendly.enabled 属性设置为 true 且 friendly.pathinfo.invalid 属性设置为 false。
对 URL 映射中的路径信息的支持还要求 wps.mappingurl.enabled 属性设置为 true 且 wps.mappingurl.invalid 属性设置为 false。 - false
- 如果将此属性设置为 false,并且门户网站接收到针对包含路径信息的 URL 的请求,那么门户网站将忽略该路径信息,并且仅将用户定向到所请求的页面。
- friendly.pathinfo.validation.errorCode = (404)
- 此键指定在友好 URL 的路径信息无法解析为所请求的页面的内容项时门户网站返回的 HTTP 状态码。可以指定以下值之一:
- 404
- 缺省值。此 HTTP 状态码告诉调用者(如搜索搜寻器或 Web 浏览器),找不到友好 URL 的任何内容。缺失内容可能暂时或永久缺失。
- 410
- 此 HTTP 状态码告诉调用者(如搜索搜寻器或 Web 浏览器),友好 URL 的资源不再可用。此缺失资源永久消失。
- friendly.pathinfo.validation.errorTextProvider
- 此键指定要发送的本地化 HTTP 状态消息的文本提供者以及已配置的 HTTP 状态码。如果您配置文本提供者并且请求 URL 具有无效路径信息,那么门户网站将使用仅显示 HTTP 状态码和由文本提供者指定的对应本地化消息的空白页面进行响应。此参数的值必须是 com.ibm.workplace.wcm.api.plugin.textprovider.TextProvider 接口的实现标识。要使用 WebSphere Portal 的缺省消息,请指定标识为 PathInfoValidationTextProvider 的文本提供者。如果实现定制文本提供者,请确保其支持由前缀 HTTP_STATUS_MESSAGE_ 和已配置的 HTTP 状态码组成的消息密钥,例如:HTTP_STATUS_MESSAGE_404。要点: 如果还指定了 friendly.pathinfo.validation.errorURI 属性或页面参数,那么门户网站将忽略此设置。
- friendly.pathinfo.validation.errorResourceBundle
- 此键指定 Java 资源束作为实现定制文本提供者的替代方法。如果您配置 Java 资源束并且请求 URL 具有无效路径信息,那么门户网站将使用仅显示 HTTP 状态码和来自 Java 资源束的对应本地化消息的空白页面进行响应。此设置的值必须是 Java 资源束的标准名称。如果提供定制 Java 资源束,请确保其包含由前缀 HTTP_STATUS_MESSAGE_ 和已配置的 HTTP 状态码组成的消息密钥,例如:HTTP_STATUS_MESSAGE_404。要点: 如果还指定了 friendly.pathinfo.validation.errorURI 属性或页面参数,那么门户网站将忽略此设置。如果将 friendly.pathinfo.validation.errorTextProvider 属性或页面参数的值设置为定制文本提供者标识,那么门户网站也将忽略此设置。
- friendly.pathinfo.validation.errorURI
- 此键指定在请求 URL 具有无效路径信息时门户网站解析的内容 URI 段。此参数的值必须是门户网站可以解析的内容 URI 段,例如:
- nm:oid:unique_page_name
- 此导航模型 URI 根据目标页面的唯一名称将请求重定向到特定门户网站页面。
- custom:resolutionserviceuri
- com.ibm.portal.resolver.ResolutionService 接口的此定制实现将无效路径信息解析为动态确定的导航状态。门户网站解析内容 URI 段时,进行 Portlet 验证失败的内容路径作为 wcmContentPath 参数传递到解析服务。
- friendly.pathinfo.validation.errorContentPath
- 此键指定在请求 URL 具有无效路径信息时门户网站设置为已解析页面的公用 Web Content Manager 上下文的完整内容路径。然后,已解析页面上的配置为侦听其他 Portlet 的 Web Content Viewer Portlet 可以呈示具有指定路径的内容。此设置的值必须是可供用户使用的内容项的路径,例如:/Web Content/home/human_resources/health/topic_not_found。
- friendly.pathinfo.validation.enabled = (false)
- 此键指定门户网站是否验证友好 URL 的路径信息。请指定以下两个值之一:
- true
- 如果将此属性设置为 true,并且门户网站接收到针对包含路径信息的友好 URL 的请求,那么门户网站将验证该路径信息。如果未识别出可用内容项,那么门户网站会根据其配置以及已解析页面的配置作出响应。有关更多信息,请参阅为 Web 内容配置友好 URL 的验证。
- false
- 此值为缺省值。如果将此属性设置为 false,并且门户网站接收到针对包含路径信息的友好 URL 的请求,那么门户网站将根据 friendly.pathinfo.enabled 和 friendly.pathinfo.invalid 属性进行响应。有关更多信息,请参阅“为 Web 内容启用友好 URL 的验证”。
- friendlyname.uniqueness.enforcement = (true)
- 此属性确定门户网站是否强制使新的友好名称在现有的非专用同代节点之间唯一。缺省值为 true。此强制行为并不涉及继承了友好名称的派生页面以及由个人化规则引入的胞代页面。
- com.ibm.wps.resolver.servlet.AbstractServlet.enableWebDAV[optional]=(true)
- 此属性指定是否在 WebSphere Portal 中启用 WebDAV 功能。缺省情况下,此属性设置为值 true,即表示启用 WebDAV。要禁用 WebDAV,请指定值 false。要重新启用 WebDAV,请指定值 true。
- portlet.iwidget.markup.prefetching = (true)
- 此属性确定处于客户机端呈示方式的页面上的 Portlet 标记是否必须与门户网站页面标记一起装入。缺省值为 true。此属性定义了配置为使用客户机端呈示方式的页面的缺省标记预取行为。通过在 Portlet 的部署描述符文件 (portlet.xml) 中将此属性声明为 Portlet init 属性,您可以逐个 Portlet 地覆盖此缺省行为。要在缺省情况下禁用 Portlet 标记预取,请将此属性的值设置为 false。在这种情况下,将使用不同的 HTTP 请求来提取处于客户机端呈示方式的页面上的 Portlet 标记。
- portlet.enable.transcoding = (true)
- 确定是否启用代码转换。
- portlet.automaximize = (false)
- 如果将此值设置为 true,那么当 Portlet 设置为编辑、配置或帮助方式时,Portlet 窗口将最大化。
- proxy.enable.app.config = (false)
- 如果将此属性设置为 true,那么 Ajax 代理将忽略 Portlet 内的所有 proxy-config.xml 文件。
- content.topology.writelock.timeout = milliseconds (default=25000)
- 此设置用于控制在获取可写模型时,发出超时警告之前的最长等待时间。要添加或更改设置,请在WebSphere Integrated Solutions Console中打开资源环境提供程序。执行更改后,请重新启动门户网站服务器。
- content.topology.writelock.dump = true|false (default=false)
- 此设置用于控制在生成超时事件时是否写入 Java 核心内存转储以进行调试。要添加或更改设置,请在WebSphere Integrated Solutions Console中打开资源环境提供程序。执行更改后,请重新启动门户网站服务器。
- com.ibm.wps.filestore.JCRWebdavTreeModelFactory.cacheClearOnRestart = true|false (default=true)
- 此设置用于定义在服务器启动之后是否使文件高速缓存内容失效并再次提取该内容。缺省值为 true。
- actual.SSO.tokenUrl = your_URL_for_SAP_integration (no default)
- 此属性是可选的。使用此属性可以指定 SAP 集成的引用属性。根据 SAP 集成页面属性中选择的引用更改属性名称。请指定 SAP 集成的 URL 作为值。
- enable.default.social.object.resolution.mode.request.param = (true)|false
- 此属性是可选的。缺省设置为 true。如果将此属性设置为 false,那么参数 ibm.portal.default.social.object.resolution.mode 将被禁用。此设置将影响如何解析社交列表中的社交对象链接。有关更多信息,请参阅在全局配置解析社交对象链接的方式。
- content.topology.writelock.dump = true|false (default=false)
- 此设置用于控制在生成超时事件时是否写入 Java 核心内存转储以进行调试。要添加或更改设置,请在 WebSphere Application Server 管理控制台中打开资源环境提供程序。执行更改后,请重新启动门户网站服务器。
- com.ibm.wps.filestore.JCRWebdavTreeModelFactory.cacheClearOnRestart = true|false (default=true)
- 此设置用于定义在服务器启动之后是否使文件高速缓存内容失效并再次提取该内容。缺省值为 true。
- proxy.cv.slot.regex = your regular expression with allowed slot IDs
- 此属性是可选的。您可以使用此属性定义凭证保险库中的一部分可用槽,您希望出站 HTTP 连接只访问这些槽。有关详细信息,请阅读“对出站 HTTP 连接进行认证”。
- state.decoding.fallback [=true]
- 使用此属性可以控制门户网站如何响应针对它无法解码的 URL 的请求。将此属性设置为以下两个值之一:
- true
- 此值为缺省值。如果将此参数设置为 true,那么门户网站将呈示缺省页面或主页。在具有门户网站站点访问者的场景中,此操作为回退解决方案。
- false
- 如果将此参数设置为 false,那么该门户网站将向它无法解码的请求返回 HTTP 404 错误。对于其他场景,此操作可能是首选解决方案。
注: state.decoding.fallback 属性不适用于门户网站解释为 URL 映射或友好 URL 的 URL。如果您使用友好 URL 或 URL 映射,请考虑一致地设置 state.decoding.fallback、wps.mappingurl.invalid 和 friendly.pathinfo.invalid 参数。此操作可帮助提供一致的用户体验。示例:如果设置了 state.decoding.fallback = false,请考虑设置 wps.mappingurl.invalid = true 和 friendly.pathinfo.invalid = true。 - search.service.suppress_automatic_creation = (false)
- 使用此属性来确定是否禁止自动创建搜索服务和搜索集合。请指定以下两个值之一:
- false
- 为了不禁止自动创建搜索服务和搜索集合,将此属性设置为 false。 这是缺省值。
- true
- 为了禁止自动创建搜索服务和搜索集合,将此属性设置为 true。
- x-method-override.enabled = (false)
- 使用此属性可以指定您是否希望通过隧道传输(即,改为使用 POST 请求)来模拟 PUT 和 DELETE 请求。要启用这种隧道传输,请将此属性设置为 true。如果将属性 x-method-override.enabled 设置为 true 时,那么当请求传入时,配置服务会考虑使用 x-method-override 请求头。是否发送此请求头由 HTTP 客户机决定。缺省情况下,此属性设置为 false,并且隧道传输处于禁用状态。
- wcm.pages.enabled = (true)
- 此属性指定是否启用了 Web 内容页面。缺省值为 true。
- wcm.config.seedlist.version = (1.0)
- 此属性指定门户网站所使用的搜索种子列表格式的版本。由于搜索种子列表格式 1.0 是唯一受支持的搜索种子列表格式,因此缺省值和唯一受支持的值是 1.0。
- wcm.config.seedlist.servletpath = (/seedlist)
- 此属性指定用于生成搜索种子值列表的 Servlet 的路径。缺省值为 /seedlist。
- delete.empty.portlet.locales = (false)
- 此属性指定在您将语言环境设置为空值之后,门户网站是否删除 Portlet 的 localedata 元素。
dnd.portletdefinition.wcm.link
= (wps.p.dnd.wcm.link)- 此属性定义从站点工具栏的“站点资源管理器”选项卡拖放的项的全局行为。 缺省值为 wps.p.dnd.wcm.link,该值指定了当项从“站点资源管理器”选项卡拖放到页面时将链接的对象。此属性的值可以是 portlet 定义的对象标识或唯一名称,您期望将其用作拖放的全局行为。
- digest.seed
-
在 WebSphere Portal 中,通过 contenthandler 框架提供的所有资源(例如,通过条目 /wps/contenthandler 和 /wps/mycontenthandler)均 在其 URL 中包含一个摘要令牌。该摘要令牌通过对摘要中资源的请求依赖性进行编码来控制资源的缓存能力。 不同的依赖性产生了不同的摘要,因此生成不同的 URL 和 HTTP 高速缓存中的不同条目。 摘要计算算法还会考虑一个种子值。此种子值是一个常量值,对于服务器上的所有资源都相同。您可以通过在 WP ConfigService 中设置 digest.seed 属性来控制此种子值。您可以控制种子值以确保通过 contenthandler 框架提供的所有资源均获取最新的 URL,从而避免最终高速缓存命中。

- stateless.urls.enabled = (false)
- 此属性为标准主题以及使用标准主题的页面启用友好 URL。将此属性设置为 false,为标准主题和使用标准主题的页面禁用友好 URL。False 是缺省值。将此属性设置为 true,为标准主题和使用标准主题的页面启用友好 URL。在特定页面上是否生成没有状态信息的友好 URL,取决于页面参数 generate.stateless.urls 的值,或者如果未设置该参数,则取决于 WP ConfigService 的 generate.stateless.urls 的值。可以从父页面继承页面参数设置。
- generate.stateless.urls = (false)
- 此属性设置缺省值来生成标准主题以及使用标准主题的页面的友好 URL。仅在 stateless.urls.enabled 设置为 true 时,此属性才设置缺省值。将此属性设置成 true 来为 未设置或者未从父页面继承页面 参数 generate.stateless.urls 的所有页面生成无状态信息的友好 URL。此属性设置影响所有虚拟门户网站。将此属性设置成 false 来为未设置或者未从父页面继承 generate.stateless.urls 的所有页面生成有状态信息的 URL。此属性设置影响所有虚拟门户网站。False 是缺省值。