<< November 2008 | Home | January 2009 >>

Installing Lotus Expeditor Toolkit 6.2 - there's an issue with the instructions

In preparation for my Lotusphere session I installed Lotus Expeditor toolkit 6.2 on top of a clean Eclipse 3.4 install in order to test it out. One of the things I noticed was that there is an error in the install guidelines - not critical but if you're new to Eclipse you might be stumped. The documentation also fails to mention how to configure the Toolkit once installed. Read on...

The error is in the doc/index.html in step 5 where it states

"Select Add Site and browse to the drive 
and directory where the Lotus Expeditor 
Toolkit update site zip file is located 
and click OK."
The problem is that the Expeditor toolkit that I downloaded from IBM Partnerworld didn't have a zip-file but instead an unpacked update site. In my case step 5 should instead be
"Select Add Site and browse to the drive 
and directory where you unpacked the Lotus 
Expeditor Toolkit and select the 
Expeditor_Toolkit_install directory and 
click OK."
The remaining steps are fine and installing the toolkit is almost easy... There is one caveat the documentation fails to mention and that's how to fill in the dialog that pops up once the Toolkit has been installed and Eclipse has been restarted. I fill in the dialog as follows (with Notes 8.5 installed in C:\Program Files\Notes 8):
  • Lotus Notes 8
  • C:\Program Files\Notes8\framework\rcp\eclipse
  • jre6
  • 1.5
  • Display the first time a new workspace opens

Question on LotusScript.doc HTML output

I have been hard at work on version 2 of LotusScript.doc and I'm getting very close to a beta candidate. My main issue is that I keep adding features instead of finishing the core product as I now have a framework that is far more extensible than the version 1 code.

I'm currently finishing the framed HTML output that also shipped with version 1 and in that regard I have a question for LotusScript.doc users. Which parts of the HTML output do you actually use? In version 1 you could select to include the follow design element types and have output about these output to the documentation:

  • Script libraries
  • Agents
  • Database script
  • Forms
  • Views
  • Pages
  • Shared actions

Which parts do you actually use? Is there a better way to do it? Any parts that should highlighted differently?

Please donate

Based on prior and recent recommendations I have set up a Paypal account to accept donations to finance the development of the free version of LotusScript.doc version 2. All donations will be very much appreciated and help me justify the time I put into this.

Scala links

Dan Sickles sent me a couple of Scala links after I tweeted that I was playing with Scala over the holidays. Thank you for those. I put them here if others are interested.

Tags : ,

Lotusphere 2009: Preferences in SWT components

On the demos I have done for my Lotusphere 2009 session is a demo on how to use the extension point to extend the preferences dialog box (File/Preferences...) in Notes 8. As always a demo makes it easier to comprehend so download and explore to your heart's content. Questions are welcome here or at Lotusphere.


Otherwise I recommend the Eclipse User Settings FAQ

SWT @ Notes 8: Network awareness from SWT components

One of the big strengths of having Notes 8 built in Lotus Expeditor is that you have access to all the functionality of the underlying Expeditor platform including its services. On if the nice ones is that you can be notified when the underlying network connectivity is available and/or unavailable.

RESTlets in Jersey

REST services are very in so you might want to read this article (Configuring JSON for RESTful Web Services in Jersey 1.0) on how to use the Jersey REST framework. RESTlets is another Java API trying to standardize how to develop REST services using Java.

Tags : ,

Doclinks and default views

After spending a fair time troubleshooting an agent that send out e-mail I found the problem and the reason it didn't run. Once again it was because you apparently cannot create a doclink to a document in a database that doesn't have a default view. Why that is I do not know but that was the case... Again! I seen this before but it continues to amaze me.

Looking into Scala

I'm spending a little time this Christmas holiday looking into Scala which is a functional programming language that runs on the JVM. I'm off to a good start with the excellent The Busy Java devlopers Guide to Scala on developerWorks by Ted Neward.

object HelloWorld {
  def main(args : Array[String]) {
    Console.println("Hello Scala World!")
    for (value <- args; if value.startsWith("Lotus")) {

Tags : ,

Merry Christmas / Happy holidays

Merry Christmas or happy holidays - whatever you prefer. I'm in the middle of a couple of festive days trying hard to avoid too much coding which I'm finding a bit difficult. The abstiences are hard to deal with... :-)

Anyways - have a good one and see you on the other side.

I'm Nathans hero! Now I got to decide on my superpower...

Nathan said I could quote him as saying I'm his hero - just couldn't help posting that... ;-)

Lotusphere 2009: Session time posted

The time slots and room allocations for the Lotusphere sesions has been posted on the lotusphere.com site. My session (BP106 - "From IBM Lotus Notes Java Developer to Lotus Notes 8 Plug-in Developer") is on Monday at 1 PM in Swan Pelican and it's up against more than fair competition.

The line-up this year is very strong and so will the competition for attendees at sessions be. Please remember that many of those competing sessions probably will be repeated so you can catch them second time around... :-)

Be at my session or be square... :-)

Lotus Expeditor 6.2 toolkit

Information about the toolkit for Lotus Expeditor 6.2 is available on the Lotus Expeditor wiki. There is also some info for using the toolkit with Notes 8.5 beta 2 if you don't want to use my instructions which still works flawlessly.

Lotusphere 2009: Tagging content

As "agreed" via Twitter today please use #ls09 for tagging Lotusphere 2009 tweets and "lotusphere2009" (without the quotes) for tagging content at all other sites and services where characters are not important.

Spread the word...

Lotusphere 2009: (OGS) predictions

As last year I have been thinking about that may be in store for us at the opening general session (OGS) at Lotusphere 2009. I really think that the IBM Lotus strategy is becoming clearer and clearer and that customers are starting to pick up on the ideas and get on board. Let's just hope that recent developments doesn't mess it up for IBM Lotus. I heard that a certain blogger may attend Lotusphere and I hope that she'll get her facts straightened out and get up to speed on the Notes platform. If not I know that we at Intravision would love to show of the Notes 8 platform to demonstrate that the Notes client is far from what it once was.

Anyways - on to the predictions.

OGS predictions

  • Sametime interoperability with MSN via for-pay bridging service (they may save this one for the Sametime "OGS")
  • Announcement of public beta of Project Atlantic
  • Sametime 8.5/9.0 announced
  • Lotus Foundations, (native) support for Sametime and Quickr
  • Most, if not all, demos done on Notes 8.5 for Mac and/or for Linux
  • Demo of pure developer, all Linux, workstation with Notes and Designer...
  • Someone will actually stumble and fall off the stage and use of dry ice in both the OGS and OCS... :-)

What are yours?

Theme for Notes 8

I'm cleaning out unpublished blog entries and this is one. Don't know why I made a note of this...

plugin_customization.ini - edit the following:
com.ibm.rcp.ui/WED_THEME_PREFERENCE=<theme desc id>

Tags :

Lotusphere 2009: MyWidgets / LiveText / search provider demo

While MyWidgets and LiveText isn't a part of my session at Lotusphere it still makes a lot of sense in this demo. It shows how Notes 8 provides alternative ways of performing the same task - searching for a package by its track and trace number is this case. One option is using LiveText and another is using a custom search provider. The astute reader will immediately see that this is an extension of the IBM whois plug-in I posted about the other day.

Using Wink I did a Flash movie that shows the demo.

TwitNotes - 1.0.6 released to the update site

I just released TwitNotes 1.0.6 to the update site and if you're using TwitNotes you should upgrade. The reason for the update isn't functionality but because twitter.com changed the way the API method for verifying credentials works. For more info see the comments to my post from last night (TwitNotes stopped working today :-().

To upgrade simply follow the installation guidelines on the TwitNotes page.

Tags :

TwitNotes stopped working today :-(

Don't know if twitter.com changed the API or the service is just unreliable but today the service stopped working for me using TwitNotes. I get a "CWPST0071E: The maximum number of login attempts has been exceeded." and some funny stacktraces in the log of the Notes client. I also see a "java.net.UnknownHostException: twitter.com" message. Using the website works fine though using the same username/password combination.

I will look into it.

Developing plug-ins for Domino Designer in Eclipse (DDE)

With Notes 8.5 just around the corner we also have Domino Designer for Eclipse (DDE) just around the corner. Domino Designer being built on Eclipse opens up the door for plug-in developers and tool vendors to provide tools that plug-in into Designer just like (sidebar) plug-ins plug into the Notes client. The API's are the same so the stuff you already know can be reused.

Please note: The below requires that you're running a Notes 8.5 beta with DDE and that your Eclipse IDE is configured for Notes 8.5. See this post for instructions on configuring Eclipse for Notes 8.5.

Developing plug-ins for DDE is however a little tricky as the Expeditor Toolkit or my own instructions will launch the Notes client and not DDE. Unfortunately you can't just launch DDE once Notes is launched from Eclipse since this will result in a Notes initialization error as Notes is already running and DDE is launched anew. That aside it would also be unnecessarily time consuming for day-to-day development.

The solution is to edit your existing Eclipse launch configuration (or create a new) that launches DDE instead of Notes. So how do you do it? Read on...

First bring up your Notes launch configuration. Now change the "Run a product" dropdown to "com.ibm.designer.domino.product.dde" and then switch to the "Arguments"-tab and change the "Program arguments" field from

-personality com.ibm.rcp.platform.personality
-product com.ibm.notes.branding.notes
-nl en_US
-personality com.ibm.designer.domino.personality
-product com.ibm.designer.domino.product.dde
-nl en_US

Apply the settings and run the configuration and notice how DDE now launches instead of Notes. Don't you just love Eclipse?

Now we just need some published extension points...

Lotusphere 2009: Booth 828

Be sure to stop by booth 828 in the showcase to learn about the OnTime Suite and meet up with me off cause... :-)

How to learn about the learning plug-in

I read on planetlotus.org that the learning plug-in is available for download from the Domino wiki. For those who want to learn more about developing Notes 8 plug-ins please note that this is actually the sample plug-in from the Extending Sametime 7.5 Building Plug-ins for Sametime Redbook.

Lotusphere 2009: BALD!?

I haven't heard/read any other bloggers mention it so I might as well do it - the Bloggers Anual Lotusphere Dinner aka BALD. As has been the case the previous years I assume we'll meet up at the Brewery on the boardwalk on Saturday before Lotusphere around 5 PM for a pint or 5...

I'm flying in Friday to make sure I'm there! :-)

Launching DDE from the command line

Notes 8.5 brings Domino Designer in Eclipse (DDE) and this means you might want to launch Designer from the command line which is easy once you know the configuration name.

<Notes directory>\framework\rcp\rcplauncher.exe -config designer
Of cause you can also add the -console command line option to get the OSGi console.

Tags : ,