Manage Learn to apply best practices and optimize your operations.

Alternate version of @Command forwards subform via LotusScript

The @Command([MailForward]) function lets you place an UI document's contents into a mail memo and forward it. If you only want to forward a portion or subform of the UI document, this tip can show you how, using a LotusScript alternative.

The @Command([MailForward]) forwards the current UI document by placing its entire contents into a mail memo that a Lotus Notes user can address and send.

Recently, I was asked to recreate and slightly tweak this functionality. I wanted to include only a portion (or subform) of the current UI document. I also wanted the memo to be executed through the back end and sent via the click of a button.

Related resources from
Modify a rich text field in the UI without having to save and re-open

Top 10 LotusScript tips

LotusScript Reference Center

The key to accomplishing this was to isolate the subform in its own form. After doing so, I could copy the subform's contents to the clipboard, paste them into a rich-text field and send them to a specified Lotus Notes user.

You can create the same basic forms and code for this utility in your own Lotus Notes Domino environment using these three steps.

  1. Create a hotspot button on the subform that you want to email and add the following code to the "click" event.

    Note: In the hotspot button's "hide-when" options, check the box to hide when "Copied to the Clipboard."

    LotusScript to add to hotspot button
    (Click on code for enlarged view and script download.)

  2. Create a form in your Notes database and name it "TempForm."
    • Insert the subform from Step 1 into the "TempForm" form.
    • Optional: If your original underlying form has rich-text fields with attachments, add those fields on the tempform subform in a hidden section. The hidden section's properties must be set to "auto-collapse" upon opening. If they're not, attachments from the main form will appear at the bottom of the email when it's sent.
    • Copy and paste the following code into the "PostOpen" event in the "TempForm" subform.

    LotusScript to post into 'Postopen event'
    (Click on code for enlarged view and script download.)

  3. Create a form in your Lotus Notes database and name it "Memo."

    • Create a rich-text field that can be edited on the "Memo" form, and name it "Body."
    • Copy and paste the following code into the "PostOpen" event in the "TempForm" subform.

    LotusScript to post into 'TempForm'
    (Click on code for enlarged view and script download.)

Do you have comments on this tip? Let us know.

This tip was submitted to the tip library by member Chad Martin. Please let others know how useful it is via the rating scale below. Do you have a useful Lotus Notes, Domino, Workplace or WebSphere tip or code snippet to share? Submit it to our monthly tip contest and you could win a prize.

Dig Deeper on LotusScript



  • iSeries tutorials's tutorials provide in-depth information on the iSeries. Our iSeries tutorials address areas you need to know about...

  • V6R1 upgrade planning checklist

    When upgrading to V6R1, make sure your software will be supported, your programs will function and the correct PTFs have been ...

  • Connecting multiple iSeries systems through DDM

    Working with databases over multiple iSeries systems can be simple when remotely connecting logical partitions with distributed ...