创建元素标记

元素标记用于引用演示模板或元素设计中的元素。

关于此任务

元素标记的格式：

[Element type=" " context=" " name=" " key=" " format=" " link=" " separator=" " 
htmlencode=" " awareness=" "  ifEmpty=" " start=" " end=" " ]

要创建元素标记，请执行以下操作：

过程

  1. 从演示模板或元素设计字段中单击插入标记。将打开标记助手对话框。
  2. 选择元素作为标记类型。
  3. 选择用于存储元素的项类型以及用于确定要引用的项的上下文：

    如果未设置，项类型为 content 且上下文是 current。

    表 1. 上下文和项类型矩阵. 此表描述上下文如何针对不同的项类型进行更改。
    上下文和项类型 type="auto" type="content" type="sitearea" type="parent" type="top"
    context="Selected"

    选择此选项后，上下文将由选定项设置。您可以通过单击选择来选择项。此参数将以 name=" " 参数形式添加到标记中。

    		 此参数可显示所选项中的元素。 此参数可显示所选内容项中的元素。

    如果已选择站点区域，那么将不显示任何内容。

    		 如果所选项是站点区域，那么此参数可显示站点区域中的元素。

    如果所选项是内容项，那么此参数可显示内容项的父站点区域中的元素。

    		 此参数可显示所选项的父代中的元素。 此参数可显示所选项路径中第一项的元素。
    context="Current"

    选择此选项后，上下文将由当前项设置。

    		 此参数可显示当前呈现项中的元素。 此参数可显示当前内容项中的元素。

    如果已选择站点区域，那么将不显示任何内容。

    		 如果当前呈现项是站点区域，那么此参数可显示当前站点区域中的元素。

    如果当前呈现项是内容项，那么此参数可显示内容项的父站点区域中的元素。

    		 此参数可显示当前呈现项的父站点区域中的元素。 此参数可显示当前呈现项的路径中第一项的元素。
    context="Autofill"

    当引用的元素由菜单、导航器或分类组件的搜索参数确定时，请使用该选项。如果菜单、导航器或分类组件中未使用该标记，那么上下文还原为当前项。

    		 此参数可显示菜单、导航器或分类组件返回的项中的元素。 此参数可显示菜单、导航器或分类组件返回的内容项中的元素。

    如果已选择站点区域，那么将不显示任何内容。

    		 如果菜单、导航器或分类组件返回的当前项是站点区域，那么将显示站点区域中的元素。

    如果菜单、导航器或分类组件返回的当前项是内容项，那么将显示内容项父代中的元素。

    		 此参数可显示菜单、导航器或分类组件所返回项的父项中的元素。 此参数可显示菜单、导航器或分类组件所返回项的路径中第一个项中的元素。
    context="portalContext"

    选择此选项后，上下文将由当前页面的上下文设置。该选项仅对使用 Web 内容查看器 Portlet 交付的内容有效。

    请参阅名为 Web 内容关联的 Knowledge Center 主题，以获取更多信息。

    		 此参数可显示当前页面上下文项中的元素。 如果当前页面的上下文是内容项，那么显示来自当前内容项的元素。

    如果当前页面的上下文是站点区域，那么将显示该站点区域的缺省内容项中的元素。

    		 如果当前页面的上下文是站点区域，那么将显示该站点区域中的元素。

    如果当前页面的上下文是内容项，那么将显示该内容项的父代中的元素。

    		 此参数可显示当前页面上下文项的父代中的元素。 此参数可显示当前页面上下文项的路径中第一项的元素。
    context="portalMapping"

    选择此选项后，上下文将由当前页面的 Web 内容关联进行设置。该选项仅对使用 Web 内容查看器 Portlet 交付的内容有效。

    请参阅名为 Web 内容关联的 Knowledge Center 主题，以获取更多信息。

    		 此参数可显示选择作为页面的缺省 Web 内容关联的项中的元素。 此参数可显示选择作为页面的缺省 Web 内容关联的站点区域的缺省内容项中的元素。 此参数可显示选择作为页面的缺省 Web 内容关联的站点区域中的元素。 此参数可显示选择作为页面的缺省 Web 内容关联的项的父项中的元素。 此参数可显示选择作为页面的缺省 Web 内容关联的项的路径中第一个项中的元素。
    context="portletContext"

    选择此选项后，上下文将由当前 Web 内容查看器 Portlet 的上下文设置。该选项仅对使用 Web 内容查看器 Portlet 交付的内容有效。

    		 此参数可显示当前 Portlet 上下文项中的元素。 如果当前 Portlet 的上下文是内容项，那么将显示当前内容项中的元素。

    如果当前 Portlet 的上下文是站点区域，那么将显示该站点区域的缺省内容项中的元素。

    		 如果当前 Portlet 的上下文是站点区域，那么将显示该站点区域中的元素。

    如果当前 Portlet 的上下文是内容项，那么将显示该内容项的父项中的元素。

    		 此参数可显示当前 Portlet 上下文项的父代的元素。 此参数可显示当前 Portlet 上下文项的路径中第一项的元素。
    门户网站映射与门户网站上下文： 门户网站映射上下文由指定给每个页面的 Web 内容关联确定。此上下文用于在用户首次访问页面时进行呈示。当用户与页面上的内容进行交互时，页面上下文可能会更改。您可以对页面上的每个 Web 内容查看器配置显式上下文，以覆盖呈示页面上下文。如果 Portlet 已配置为接收链接，那么其上下文也可能会更改。当用户在已配置为广播其链接的查看器中单击链接时，页面上下文将会更新。这个新的上下文将会保持，直到用户单击另一个链接或启动新会话为止。当用户启动新的会话时，将使用原始页面上下文。
  4. 单击选择编写模板以选择适当的编写模板。从可用元素列表中选择要显示的元素。此参数将以 key=" " 参数形式添加到标记中：
  5. 单击确定以将标记添加到您的导航器设计中。

下一步做什么

将该标记添加到设计中之后，您还可以向该标记中添加下列参数：
表 2. 其他标记参数. 下表列出了可手动添加到此标记的其他参数。
标记参数 详细信息
name=" " 如果指定 name="./itemName"，那么在呈示该项之后才会解析实际路径。与指定项的路径相比，此方法需要稍长的时间来进行解析。
format=" " 此参数是可选的，并且只能用于某些元素类型：
引用图像元素时：
使用 format="url" 呈示图像元素的 URL。
使用 format="tag" 呈示完整的图像标记。将在呈示的页面中显示图像。如果未指定格式，那么缺省情况下使用此参数。
使用 format="height" 呈示图像元素的高度。
使用 format="width" 呈示图像元素的宽度。
使用 format="alt" 呈示图像元素的替代文本。
引用链接元素时：
使用 format="url" 呈示链接元素目标的完整 URL。例如： 
/wps/wcm/myconnect/Library/Site+Area/Content
使用 format="namepath" 呈示链接元素目标的站点路径。例如： 
/Library/Site Area/Content

如果目标是“组件引用”组件，那么将呈示最终目标的标题路径。

使用 format="titlepath" 呈示链接元素目标的站点路径。例如： 
/Library/SiteArea/Content

如果目标是“组件引用”组件，那么将呈示最终目标的标题路径。

使用 format="id" 呈示链接元素目标的标识。如果目标是链接组件，那么将呈示最终目标的标识。

使用 format="tag" 呈示完整的链接标记。如果未指定格式，那么缺省情况下使用此选项。例如： 
<a href="/wps/wcm/myconnect/Library/Site+Area/Content></a>
注： 通过门户网站查看时，链接元素生成的 URL 为标准 URL。如果希望生成非标准 URL，请改为使用“noprefix”选项：
  • format="noprefixurl"
  • format="noprefixpath"
  • format="noprefixtag"
使用 format="linktext" 呈示链接的文本。
引用“组件引用”元素时：

使用 format="id" 呈示“组件引用” 元素目标的标识。如果目标是“组件引用”组件，那么将呈示最终目标的标识。

使用 format="namepath" 呈示“组件引用”元素目标的站点名称路径。如果目标是“组件引用”组件，那么将呈示最终目标的名称路径。

使用 format="titlepath" 呈示“组件引用”元素目标的站点标题路径。如果目标是“组件引用”组件，那么将呈示最终目标的标题路径。

引用“文件资源”元素时：
如果文件资源是可转换为 HTML 的文件类型，那么可以改为将文件转换为 HTML 并使用 format="HTML" 参数在 Web 内容中直接呈示转换后的 HTML。
受支持文件类型的示例包括：
  • 文字处理文档（*.doc、*.odt）
  • 电子表格 (*.xls) *
  • HTML 文件 (*.htm, *.html)
  • 文本文件 (*.txt)
也可以使用其他文件类型，但您需要首先对其进行测试。
最大高速缓存大小：

如果转换后的 HTML 大于 WCM WCMConfigService 服务中 resourceserver.maxCacheObjectSize 属性定义的缺省高速缓存大小，那么会动态转换包含此文件的每个请求，而不使用高速缓存的副本。 此方法将影响性能。可能需要增加 resourceserver.maxCacheObjectSize 属性的大小以支持较大文件的转换。确保系统安装了足够的内存来应对高速缓存大小的增长。也可以将文件分拆为单独文件，可以单独转换这些文件，而不增大高速缓存大小。

引用文件资源和图像元素时：
  • 使用 format="mimetype" 呈示文件或图像的 mime 类型。如果无法确定有效的 mime 类型，那么将呈示“www/unknown”。
  • 使用 format="filename" 呈示文件或图像的名称。
  • 使用 format="size" 以最合适的单位呈示文件或图像的大小。如果资源小于 1 K，那么将以字节为单位呈示大小。如果资源的大小小于 1 MB，那么将以千字节为单位呈示大小。 如果资源的大小大于或等于 1 MB，那么将以兆字节为单位呈示大小。
  • 使用 format="size_bytes" 以字节为单位呈示文件或图像的大小。仅显示数值。
  • 使用 format="size_KB" 以千字节为单位呈示文件或图像的大小。仅显示数值。
  • 使用 format="size_MB" 以兆字节为单位呈示文件或图像的大小。仅显示数值。
引用日期元素时：
显示日期时可定义以下格式：
  • format="DATE_SHORT"
  • format="DATE_MEDIUM"
  • format="DATE_LONG"
  • format="DATE_FULL"
  • format="DATE_TIME_SHORT"
  • format="DATE_TIME_MEDIUM"
  • format="DATE_TIME_LONG"
  • format="DATE_TIME_FULL"
  • format="TIME_SHORT"
  • format="TIME_MEDIUM"
  • format="TIME_LONG"
  • format="TIME_FULL"
  • format="DATE_SHORT_TIME_MEDIUM"
  • format="DATE_SHORT_TIME_LONG"
  • format="DATE_SHORT_TIME_FULL"
  • format="DATE_MEDIUM_TIME_SHORT"
  • format="DATE_MEDIUM_TIME_LONG"
  • format="DATE_MEDIUM_TIME_FULL"
  • format="DATE_LONG_TIME_SHORT"
  • format="DATE_LONG_TIME_MEDIUM"
  • format="DATE_LONG_TIME_FULL"
  • format="DATE_FULL_TIME_SHORT"
  • format="DATE_FULL_TIME_MEDIUM"
  • format="DATE_FULL_TIME_LONG"
  • format="RELATIVE"（相对日期显示为“今天”、“昨天”或多少天前。）
  • format="MILLIS"（自 GMT 时间 1970 年 1 月 1 日午夜以来经过的毫秒数）
注： 所有日期格式都基于用户的时区，除了 format="MILLIS"，其不依赖于当前时区。
您还可以设置用户定义的日期格式：
引用数字元素时：
您还可以设置用户定义的数字格式：
引用选项选择元素时：
  • 当您引用选项类型为“用户定义的”的选项选择元素时，将呈示所选的用户定义值。要呈示转换后的选择，您可以使用标记属性 format="textprovider"。
  • 当您引用选项类型为“使用分类”的选项选择元素时，缺省情况下，将呈示所选分类或类别的标题路径。您还可以使用标记属性 format="namepath"、format="name"、format="titlepath"、format="title" 和 format="id" 来显示所选类别的名称路径、名称、标题路径、标题和标识。
引用用户详细信息时：
对用户详细信息进行格式化时，使用 format 参数来定义在显示用户详细信息时使用的 LDAP 参数。例如：
  • format="cn" 用于显示公共名称。
  • format="dn" 用于显示专有名称。
最大字符长度：
您还可以使用以下格式指定显示的最大字符数：
  • format="length:number_of_characters"
例如，要最多显示 10 个字符，可指定以下参数：
  • format="length:10"
link=" " link 参数用于定义元素标记所创建的链接类型：
link="default"
创建标准的元素链接。
link="path"
呈示该元素时会使用上下文路径链接。
link="contextual"
呈示该元素时会使用上下文内容链接。如果不适用，将使用上下文路径链接。
上下文链接：

如果使用上下文链接，那么在从另一个站点链接内容时，在可能的情况下该链接将相对于当前站点呈示。仅在 context=current 或 context=autofill 时，才可以使用此参数。
separator=" " 在引用选项选择或用户选择元素时，会使用此参数。它用于定义选项选择或用户选择元素中显示的各个选择之间呈示的文本或代码。例如，要在各个选择之间添加换行符，可使用 separator="<br>"。 如果未定义任何文本或代码，那么显示时将用逗号分隔各个选择。
htmlencode=" " 如果 htmlencode="true"，那么用于显示文本的元素中的保留 HTML 字符将转换为字符实体。 例如，“<”将转换为“&lt;”。 如果要防止用户添加恶意代码或使用 HTML 更改其文本设计，那么此方法非常有用。

如果未指定，那么将使用 WCM WCMConfigService 服务中的 cmpnt.htmlEncodeDefault 属性指定的缺省设置来显示文本。由 WCM WCMConfigService 服务中的 cmpnt.htmlEncodeUrls 属性指定的缺省设置将用于显示 URL。缺省情况下，这些属性设置为 true。
awareness=" " 如果 awareness="true"，那么将使用人员感知功能来显示用户名。这些功能将用户名以超链接形式显示，使用户能够联系其合作伙伴。只要个人链接出现，用户就可以单击该链接来显示一个操作菜单，用来与链接指定的人员进行协作（联系和工作）。如果管理员还将 IBM® Sametime® 服务器配置为使用 WebSphere® Portal，那么个人链接将会指出人员的状态是“活动”、“离开”、“脱机”还是“请勿打扰”。

如果未指定，那么 awareness="false" 且不使用人员感知功能。
ifEmpty=" " 输入该标记未返回结果时要显示的的一些文本。如果未指定，那么在标记不返回任何结果的情况下不显示任何内容。
start=" "

end=" "

 start 和 end 属性用于将标记返回的数据打包到 HTML 等其他标记中。这些属性不是必需的。