To run an agent from lotus notes webpage

To run a Lotus-script agent from a lotus notes webpage:

1) Write @Command([ToolsRunMacro]; "(MyWebAgent)") in the button's programmer pane Client > Formula and it will work when you click the button. No need to do Pass-thru HTML for this button.

If for some reason you are still not able to achieve your result, you can use an indirect approach, i.e.

2) In your button where you have written the code for running the agent, in it's Properties > HTML tab, give a name  and id to it. It's better if we keep the value for Name and ID same.

Then create another Button or link and in that write in the programmer pane Web > Javascript, document.forms(0).<the button's ID value>.click()

i.e. document.forms(0).btnCheckDuplicate.click()

Thus, the first button will be triggered with the click() event and your agent will run.

Validating a rich text field

Validating a rich text field:

http://www.ibm.com/developerworks/lotus/library/rich-text-field-notes/

I have copy pasted the three methods from the above link for my reference.

Method 1

In the first method, if the field contains any input (even only a single space character), then it can pass the validation. This validation uses the Querysave event of the form that contains the field. The following LotusScript sample code performs this validation:

Sub Querysave(Source As Notesuidocument, Continue As Variant)             If ( Source.FieldGetText( "rtfield" ) = "" ) Then                  Messagebox( "Please enter some text." )                  Call Source.GotoField( "rtfield" )                  Continue = False          End If End Sub

The code checks for any character in the field rtfield. If the field contains input (even if it consists solely of one or more space characters), then validation succeeds. If the field is empty, then the code returns an error message, and doesn’t save the document (by setting Continue to False).

Method 2

In the second method, the rich text field must contain at least one non-space character (in other words, an input consisting entirely of one or more spaces is not allowed). This check also uses the Querysave event of the form:

Sub Querysave(Source As Notesuidocument, Continue As Variant)                   Dim rtitem As NotesRichTextItem          Set doc = Source.Document          Set rtitem = doc.GetFirstItem( "rtfield" )          Dim text As String                   text$ = Source.FieldGetText("rtfield")          trimmed$ = Trim(text)                         if ( trimmed$ = "") Then                  Msgbox "Please enter some text."                  Continue = False                  source.GotoField("rtfield")                  source.Refresh(True)          Else                  Continue = True                           End If End Sub

Method 3

Our third method validates a rich text field in which an input consisting solely of an attachment, embedded object, or link is allowed, even if it includes no accompanying text. Once again, we use the Querysave event of the form containing the field:

Sub Querysave(Source As Notesuidocument, Continue As Variant)                   Dim rtitem As NotesRichTextItem          Set doc = Source.Document          Set rtitem = doc.GetFirstItem( "rtfield" )          Dim text As String                   text$ = Source.FieldGetText("rtfield")          trimmed$ = Trim(text)                   If(doc.Hasembedded)  Then                  Continue = True                                             Elseif ( trimmed$ = "") Then                  Msgbox "Please enter some text."                  Continue = False                  source.GotoField("rtfield")                  source.Refresh(True)          Else                  Continue = True                      End If End Sub

This code will work if there is an attachment anywhere in the document, even if it's not in the field that is being validated.

Ways to Create Response Document

There are 3 ways to create a response document. Each way is in different language. In all the cases both documents remain in/must be in the same database. This is one of the interview question I was asked once.

1 > In Formula Language:
	a. @Command([ComposeWithReference]; server : database; form; flags)
		- form is the name of the form used to create the response document with and this form must have a rich text field with name as Body. - This command is called usually from a form action or view action. - So that it takes the reference of the currently open document or the selected document in the view. click here for more details.
2 > In Java:
	a. public void makeResponse(Document doc) throws NotesException i.e. responseDoc.makeResponse(parentDoc);
		click here for more details
3 > In LotusScript:
	a. Call responseDocument.MakeResponse( parentDocument )
		click here for more details.