Skip to end of metadata
Go to start of metadata

If you create a property tag to show a category on a component or presentation template, and want to restrict it to a certain branch, you can enter a tag such as the following:

But if you press save, WCM will remove your "restrict" parameter automatically.

Solution

You have to specify the library AND the level you are trying to restrict to (make sure the level you specify is a category - not a taxonomy).

example:

This will work even though the actual path to the category is:

  • Content Lib / Product Categories / Product Family
    Where Content Lib = the library, Product Categories is the taxonomy, and Product Family is the category.

BUT!! Notice (this is the issue) that when you save, it will work the first time, but it automatically removes the library every time you save!
When you open it up to read or edit it, it look like this.

If you (or anyone else) edits it again, even if they save without changing any thing, since the library is now no longer specified, WCM will completely remove your restrict parameter!

Base22 has submitted a PMR on this issue to IBM - let's see what happens.

More about the property tag from IBM documentation:

Creating a property tag

A property tag is used to display various fields and metadata from content items and site areas.

This is the format of a property tag:

To create a property tag:

  1. Click Insert a Tag  from a presentation template or element design field. The  Tag Helper  dialog opens.
  2. Select Property as the tag type.
  3. Select a property type. This is added to the tag as the field=" " parameter:#* Identification properties:
    • #* *Name - Displays the text entered in the name field of an item.
      • Title - Displays the text entered in the title field of an item.
      • Description - Displays the text entered in the description field of an item.
      • Authors - Displays the users and groups selected in the authors field of an item.
      • Owners - Displays the users and groups selected in the owners field of an item.
      • ID - Displays the GUID of an item.
    • Authoring template properties:
      • authtemplateid Displays the GUID of the authoring template used by the current content item.
      • authtemplatename Displays the name of the authoring template used by the current content item.
      • authtemplatetitle Displays the display title of the authoring template used by the current content item.
    • History properties:
      • lastmodified Displays the last modified date and the last change message.
      • lastmodifieddate Displays the last modified date.creationDisplays the creation date.
      • lastmodifier Displays the name of the user who last modified the item.
      • creator Displays the name of the user who created the item.
    • Profiling properties:
      • Categories Displays a list of categories that an item has been profiled with.
      • Keywords Displays a list of Keywords that an item has been profiled with.Access level properties:UserDisplays a list of users and groups assigned user access to an item.
      • Contributor Displays a list of users and groups assigned contributor access to an item.
      • Editor Displays a list of users and groups assigned editor access to an item. 
      • Manager Displays a list of users and groups assigned manager access to an item.
    • Workflow Properties:
      • Status Displays the workflow status of an item.
      • Workflow Displays the selected workflow of an item.
      • Current Stage Displays the workflow stage that the item is currently in.
      • Publish Date Displays the date and time selected in the publish date field of an item.
      • Expiry Date Displays the date and time selected in the expiry date field of an item.
      • General Date One Displays the date and time selected in the general date one field of an item.
      • General Date Two Displays the date and time selected in the general date two field of an item.Additional ViewersDisplays the names of any additional viewers selected for an item.
  4. Select a source item type. This is added to the tag as the type=" " parameter:## Content - Use this option to display a property from the current content item.
    1. Parent - Use this option to display a property from the parent site area of the current content item
    2. Top - Use this option to display a property from the top site area in the current path of the current content item.
  5. Select the context of the item display a property from. This is added to the tag as the context=" " parameter:## Selected - Use this option to select a specific site area or content item. You must then add the name of the item being referenced using the name=" " parameter. You can select an item by clicking Select.
    1. Current - Use this option to display a property from the current site area or content item. 
    2. AutoFill - Use this option when the item is determined by the search parameters of a menu, navigator, or taxonomy component. If the tag is not used within a menu, navigator, or taxonomy component, the context will revert to the current item.

If you select Selected, click the Select button to select a specific site area or content item.

  1. Click OK to add the tag to your design.

Once you have added the tag to your design, you can also add the following parameters to the tag:

Table: Additional tag parameters

name="" You must specify the name of the item being referenced if the context="selected". If you specify name="./itemName", the actual path is not resolved until the item is rendered. This takes slightly longer to resolve than specifying the path to the item.
format="" This parameter is optional and can only be used with some element types:

When field="ID":
  • format="id" displays the plain ID. If not specified, this format is used by default.
  • format="uri" outputs a wcm:oid:<id> style URI.
    When referencing user details:
    When formatting user details, the format parameter is used to define which LDAP parameter to use when displaying user details. For example:
  • format="cn" is used to display the common name.
  • format="dn" is used to display the distinguished name.
    When field="categories":
    When field="categories" the format parameter is used to determine the output format.
  • format="title" displays a list of category titles.
  • format="uri" displays a wcm:oid:<id> style URI for each listed category.
    Maximum character length:
    You can also specify a maximum number of characters to display by using this format:
  • format="length:number_of_characters"
    For example, to display a maximum of ten characters you would specify the following parameter:
  • format="length:10"
    When referencing number or date elements:
    In this case, the format is used to specify the display format of dates and numbers. The following formats can be defined when displaying dates:
  • 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="relative" (The relative date is displayed as either "today", "yesterday" or the number of days ago.)
  • You can also set user-defined formats for both dates and numbers: Setting parameters to format dates Note on formatting numbers
separator="" This is used when referencing a property that returns multiple results. For example, to add a line break between each result, you would use separator="<br>" . If not defined, a comma is placed between each result when rendered.
htmlencode="" If htmlencode="true" any reserved HTML characters is converted into character entities. For example, '<' is converted to '<'. This is useful if you would like to prevent users adding malicious code, or if you want to prevent users changing the look and feel of their text using HTML.If not specified, the default setting specified by the cmpnt.htmlEncodeDefault property in the WCM WCMConfigService service is used. By default, this property is set to true.
awareness="" If awareness="true" then user names are displayed using the people awareness features. This feature displays user names as hyperlinks that allow users to contact people with whom they might want to work. Wherever person links appear, users can click the link to display a menu of actions for collaborating (contacting and working) with the person named by the link. If you, as administrator, have also configured an IBM Lotus Sametime server to work with WebSphere Portal, person links indicate whether a person is active, away, offline, or in a Do Not Disturb state.People awareness only works in content rendered using either a local or remote rendering portlet.
If not specified, then awareness="false" and people awareness is not used.
ifEmpty="" Enter some text to display if no result is returned by the tag. If not specified, nothing is displayed if no result is returned by the tag.
include="" Used only with field=categories. Determines which level of a taxonomy to display:* exact* ancestors* descendants* all
For example, if an item is profiled with a category of Sport, and include=descendants, then all the descendants of "sport" would also be displayed.
restrict="" Used only with field=library/categories. Enter a list of categories separated by commas to only return results for the categories specified in the list. For example, restrict="library/red, library/green" only displays profile details of items profiled with the categories of red or green. If no library is specified, the default library is used.
resolve="" This determines which type of access to resolve to when rendering access level properties:
none
Only users and groups selected in the access section of an item is resolved. This is a combination of User, Workflow, and Administrator defined access settings. Virtual users are not resolved. If the field parameter is used, only users and groups directly selected for a role type is resolved. For example, a user assigned "contributor" access would not be resolved if field="user".
virtual

Only users and groups selected in the access section of an item, including virtual users, is resolved. This is a combination of User, Workflow, and Administrator defined access settings. If the field parameter is used, only users and groups directly selected for a role type is resolved. For example, a user assigned "contributor" access would not be resolved if field="user".

inherited

All inherited users and groups plus users and groups selected in the access section of an item, including virtual users, is resolved. This is a combination of Inherited, User, Workflow, and Administrator defined access settings. If the field parameter is used, only users and groups that are either directly selected for a role type or that inherit a role type is resolved. For example, a user assigned "contributor" access would not be resolved if field="user".

inheritedonly

Only inherited users and groups, including virtual users, are resolved. If the field parameter is used, only users and groups that directly inherit a role type is resolved. For example, a user that inherits "contributor" access would not be resolved if field="user".

effective

Only users and groups selected in the access section of an item, including virtual users, is resolved. This is a combination of User, Workflow, and Administrator defined access settings. If the field parameter is used, access roles are cascaded down so that users and groups assigned roles higher than the role selected using the field parameter is resolved. For example, if field="user", contributors, editors, and managers are also resolved.

all

All inherited users and groups plus users and groups selected in the access section of an item, including virtual users, is resolved. This is a combination of Inherited, User, Workflow, and Administrator defined access settings. If the field parameter is used, access roles are cascaded down so that users and groups assigned roles higher than the role selected using the field parameter is resolved. For example, if field="user", contributors, editors, and managers are also resolved.
start=""
end="" 		The start and end attributes are used to wrap the data returned by a tag within other tags, such as HTML. These attributes are not mandatory.

Double-byte character sets:

Labels:
None
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.