Adding new variable-sized, multi-value fields to Lotus Notes documents

Adding new variable-sized, multi-value fields to Lotus Notes documents

Related resources from SearchDomino.com:
Tip: Show multiple Lotus Notes document fields in a single view column

Tip: Editing fields in a Lotus Notes view with Ajax

Tutorial: 30 LotusScript tips

LotusScript Reference Center

When run against selected Lotus Notes documents in a view,

    Requires Free Membership to View

    Register today to access targeted resources from our editorial writers and independent industry experts focused on Lotus Domino, Notes, Workplace and other related technologies.

    By submitting your registration information to SearchDomino.com you agree to receive email communications from TechTarget and TechTarget partners. We encourage you to read our Privacy Policy which contains important disclosures about how we collect and use your registration and other information. If you reside outside of the United States, by submitting this registration information you consent to having your personal data transferred to and processed in the United States. Your use of SearchDomino.com is governed by our Terms of Use. You may contact us at webmaster@TechTarget.com.

this LotusScript code will insert a new variable-sized, multi-value field onto the documents. This is useful when you need a new field in a prototype Lotus Notes document, but don't want to recreate all of your test documents.

The new field will be created with the same number of elements as another field on the same Lotus Notes document. I used this mainly for the purpose of adding an additional field for document revision histories.

Sub Initialize
Dim s As New NotesSession
Dim db As NotesDatabase 
Dim collection As NotesDocumentCollection
Dim doc As NotesDocument
Dim edits As Variant, newField() As String
Dim n As Integer, docCount As Integer


Set db = s.CurrentDatabase
Set collection = db.unprocessedDocuments
Set doc = collection.GetFirstDocument
While Not doc Is Nothing
Redim newField(0)
docCount = docCount + 1
 
If doc.HasItem("OtherField") Then
If doc.OtherField(0) <> "" Then
edits = doc.GetItemValue("OtherField")
For n = 0 To Ubound(edits)
Redim Preserve newField(n)
newField(n) = "Initial value"
Next
End If
End If
  
doc.NewField = newField
doc.Save True, False
 
Set doc = collection.GetNextDocument(doc)
Wend

Print "Processed " & docCount & " documents"
End Sub

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

This tip was submitted to the SearchDomino.com tip library by member Andrew Broxholme. 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.

This was first published in March 2008

Disclaimer: Our Tips Exchange is a forum for you to share technical advice and expertise with your peers and to learn from other enterprise IT professionals. TechTarget provides the infrastructure to facilitate this sharing of information. However, we cannot guarantee the accuracy or validity of the material submitted. You agree that your use of the Ask The Expert services and your reliance on any questions, answers, information or other materials received through this Web site is at your own risk.