Can I use a widget property to filter a current user name or date?

You can create a widget property to filter information by the current user's name or the current date.

About this task

When you create a new widget you can set a property to filter for the current user's name or the current date. These options are available as defaults when you use the widget creation wizard.

To create a widget property to contain the current user's name, use the following format, where nameType is the type of name being resolved using DN (distinguished name) format:

${name:nameType}

For example: ${name:cn}/${name:ou}/${name:o} will resolve to CommonName/OrganizationlUnit/Organization.

For example: ${name:dn} will resolve to the user's full distinguished name.

To create a widget property to contain the current date, use the following format, where dateformat is a Java data format:

${date:dateformat}

For example: ${date:yyyy MM DD} will resolve to the current date (in this example: 2009 03 20).

Sample use cases are as follows:

  • You can create a widget that searches google.com for the current user's name. You would set the q property in the widget to $name:cn$. When you engage the widget, it will search google.com for the current user's name.
  • You can create a widget that uses the Notes filter command to filter a Notes view for a specific user as follows: notescmd:filter|<name>|Notes://yourserver/yourdatabase/MainFrameset?OpenFrameset. The <name> will become a property for which you can set the value to ${name:cn}$. When you engage the widget, this setting will filter the view based on the current user's name.