Lotus Notes Sidebar Chart Plugin Update Site
This is the Update Site
for installing the Sidebar Chart plugin
for the Lotus Notes 8.x Standard client, first demoed at Lotusphere 2009 in session BP111 by
. If you wish to use this
application, please see the copyright notices and usage information at the end
of this page. Source code for this application is available in the following files:
We used the ever-reliable JFreeChart
by David Gilbert for charting. JFreeChart is licensed under the terms of
the GNU Lesser General Public License
and both source and binaries are available from
. Also, in keeping with the LGPL license, you can download
the source for JFreeChart 1.0.11 from here
(1.0.11 being the version we used for this plugin).
The code used to listen for changes to the active Notes View is from Brian Leonard's
excellent article on IBM developerWorks: Leveraging
user context in the IBM Lotus Notes V8 sidebar and toolbar
The Domiclipse DocViewer sidebar plugin was also a fantastic resource.
If you want to start writing your own Sidebar apps, here are some good starting points:
How To Install This Sidebar Plugin
This plugin has been tested on Lotus Notes 8.0.1, 8.0.2, and 8.5. Installation
instructions for these client versions (8.0.1 or higher) are as follows:
What This App Does
- From the Lotus Notes 8 Standard client (the Eclipse-based one), select
the menu option File > Preferences > Widgets. Make sure the option for
- Open the Sidebar in the Notes client and expand the "My Widgets" panel.
- Download this file to your computer:
Then drag the file from wherever you downloaded it over to the My Widgets panel.
(NOTE: I tried dragging the URL directly from the browser to the My Widgets panel and
my client hung -- beware. It's safer to download the file and do it locally.)
- You should be prompted to install the Sidebar Chart Plugin. Follow the prompts to install.
You will be asked to restart the Notes client when you're done. If you are not prompted for an install,
check the proxy settings in your Location document to make sure your Notes client can access
the Internet, and also ask your Administrator if they have locked down the installation of
Widgets and plugins.
When installed in the Notes 8 client sidebar, this plugin displays a graphical
representation of either (A) how many documents are selected in the active view
versus how many docs are in the view, or (B) a comparison of values for selected
docs in the view based on columns chosen for values and categories. There are
several different chart types to choose from. For example:
If you have views open in multiple tabs, the chart should represent the values in
the current active view (please see Known Issues below). If you switch
between views, this app should
remember the last settings you chose for a
particular view. There is also a sidebar menu option to save the currently displayed
chart to a file.
- As of Notes 8.0.1, only the first 25 documents selected in a view are returned
to a Sidebar app for processing. If the view is a PIM "Java View" in a composite
application, the first 50 selected docs are returned. This issue has been SPR'ed
and can be worked around with the Notes.ini setting WMCSELECTION_MAXDOCUMENTS
(for example, WMCSELECTION_MAXDOCUMENTS=5000)
- There are sometimes focus issues with Sidebar apps. Specifically, sometimes a
Notes View that is visible in the client does not send selection notifications to
Sidebar apps until you actually click on a document in the view (clicking in the
left-hand view gutter doesn't always set focus either).
copyright 2009, SNAPPS, Julian Robichaux and Rob McDonagh
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, either version 2.1 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License
along with this program. If not, see