Topic
  • 2 replies
  • Latest Post - ‏2010-09-17T18:51:55Z by TigerTrix
SystemAdmin
SystemAdmin
8 Posts

Pinned topic Where is the list of available macros for Shared Views?

‏2010-09-17T05:10:49Z |
Using IBM FileNet Services for Lotus Quickr 1.1.0.1.
There are macros in the search files such as:
@currentTimeMinus1Week@
@currentLibraryContentId@
@sortCriteria@
@currentTimeMinus1Day@
@currentUserId@

Are there any additional macros?
How can you create additional ones? Is there an extension framework?
Updated on 2010-09-17T18:51:55Z at 2010-09-17T18:51:55Z by TigerTrix
  • smalabarba
    smalabarba
    12 Posts

    Re: Where is the list of available macros for Shared Views?

    ‏2010-09-17T18:38:50Z  
    Use of the macros in custom views isn't officially supported.

    Unoffically, the following are fairly safe, though you use them at your own risk. They're unlikely to break in future releases due to the need to maintain compatibility with previously installed view files.

    currentUserId: ID/short name of the currently authenticated user
    currentUserDn: fully qualified name of the currently authenticated user
    currentTime: the current time, in the ISO8601 compliant format used in IBM FileNet P8 Content Manager SQL
    currentTimeMinus1Day: as above but 24 hours earlier (good for "in last day" queries)
    currentTimeMinus1Week: 1 week earlier (good for "in last week" queries)
    currentLibraryId: ID of the Quickr library object in which the view was executed
    currentLibraryContentId: ID of the top-level content folder for the library in which the view was executed (see info center for more information on libraries and their content folders)
    userLocale: locale of the current user, in Java standard format (e.g. "en-us")

    The sorting-related macros are not safe for custom use.

    Again, you're welcome to experiment with these but we can't provide support in the current release. Meaning that, if a particular macro doesn't work the way you want or expect in custom views, you can always ask about it here but we can't accept a PMR or address it in a fixpack.

    We've contemplated adding a framework for custom macros. It would be a significant piece of work to implement and support. If you have any specific use cases, please pass them along.
  • TigerTrix
    TigerTrix
    18 Posts

    Re: Where is the list of available macros for Shared Views?

    ‏2010-09-17T18:51:55Z  
    Use of the macros in custom views isn't officially supported.

    Unoffically, the following are fairly safe, though you use them at your own risk. They're unlikely to break in future releases due to the need to maintain compatibility with previously installed view files.

    currentUserId: ID/short name of the currently authenticated user
    currentUserDn: fully qualified name of the currently authenticated user
    currentTime: the current time, in the ISO8601 compliant format used in IBM FileNet P8 Content Manager SQL
    currentTimeMinus1Day: as above but 24 hours earlier (good for "in last day" queries)
    currentTimeMinus1Week: 1 week earlier (good for "in last week" queries)
    currentLibraryId: ID of the Quickr library object in which the view was executed
    currentLibraryContentId: ID of the top-level content folder for the library in which the view was executed (see info center for more information on libraries and their content folders)
    userLocale: locale of the current user, in Java standard format (e.g. "en-us")

    The sorting-related macros are not safe for custom use.

    Again, you're welcome to experiment with these but we can't provide support in the current release. Meaning that, if a particular macro doesn't work the way you want or expect in custom views, you can always ask about it here but we can't accept a PMR or address it in a fixpack.

    We've contemplated adding a framework for custom macros. It would be a significant piece of work to implement and support. If you have any specific use cases, please pass them along.
    Just as a point of reference for any CM8 users who are wondering how this applies to the IBM Content Manager Services for Lotus Quickr:

    Similar macros are available for CM8, such as current user, current date & time with offset and are documented in the saved search documentation as Implicit variables and variable functions and listed for you as choices when you use the interactive query builder in the SavedSearchAdmin and Browser commandline tools. These are part of IBM Content Manager Services for Lotus Quickr, not the repository itself, and are fully supported.