Yes, SaveOptions understands more than just "0" or "1":
Did you ever face the problem, that Lotus Notes keeps asking if you want to save the current document, even though you just did?
Picture the following scenario:
A user creates a document with a certain form that contains a "Change Field & Save" action with the following code:
' Action "Change Field & Save"
Sub Click(Source As Button)
Dim ws As New NotesUIWorkspace
Dim doc As NotesDocument
Set doc = ws.CurrentDocument.Document
Call doc.ReplaceItemValue("foo", "1")
Call doc.Save(True, False, False)
End Sub
The user clicks the button "Change Field & Save", and then wants to close the document. What the user expects is, that the document simply closes, because he just clicked a Save-Button and did not change anything afterwards.
What actually does happen though is, that a prompt pops up: "Do you want to save this document?"
The reason is the item change (doc.ReplaceItemValue), even though it is processed before the doc.save.
To tell Notes that it should only ask when something was changed after saving the document, just add a SaveOptions field with any value other than "0" or "1". This also works with an empty string "". Or set the value of the item to "I added this item, so that Notes does not ask me unnecessarily if I want to save the document".
About the AuthorMarcus Foerster works as Systems Architect for Pentos AG in Munich, Germany. His focus lies on the application side, creating collaboration systems for users, groups and enterprises to get their daily work done. This approach includes integrating complex workflows with intuitive user interfaces, using Lotus Notes/Domino with Adobe Flex and other Web technologies.
Read more in Marcus' blog:
http://marcus.foerster.com/blog