Manage Learn to apply best practices and optimize your operations.

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

Learn how to add new variable-sized, multi-value fields to Lotus Notes documents using this LotusScript code.

Related resources from
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, 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"
End If
End If
doc.NewField = newField
doc.Save True, False
Set doc = collection.GetNextDocument(doc)

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

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

This tip was submitted to the 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.

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 ...