This, that and the other (may contain nuts)

Steve Castledine

Using formula to open a designated users Calendar, To Do or Contacts - undocumented feature

Steve Castledine  3 November 2008 10:01:57
Starting this week with a very simple tip. Hoping to do at least one a day this week with at least one lengthy one for xpages by Friday.

Anyway, there is a documented formula @Command( [OpenCalendar]; username ) that allows you to open a designated user's calendar. This may be useful in your custom apps or as part of a "portal" solution.

The username part can be a specific user, or if you leave empty a prompt will ask you for a user to navigate to (bearing in mind you will need the permission to open that part of the user's mail application first. Everyone understand "delegated access"? I could write a piece describing that if there is a demand?).

There is also an "undocumented" part which is widely used within the mail template. Because it is undocumented I can take no responsibility for its use, but as it works in the mail template there's a fair bet that it is "solid" and its just a documentation oversight. Anyway, this undocumented part is you can also specify a frameset to launch so you can also launch To Do, Mail, or Contacts (if the synch is set up for contacts - again I can write about this).

Here are the undocumented commands to achieve this (hopefully they are self explanatory):

@Command( [OpenCalendar]; username; [UseMailFrameset])
@Command( [OpenCalendar]; username; [UseToDoFrameset])
@Command( [OpenCalendar]; username; [UseContactsFrameset]) (this was only added at 8.0 for the delegated contacts work)