A common complaint about archiving Lotus Notes documents to specific folders is that there are too many steps involved. You have to select the document, move it to the specified folder, select the document again, and then finally select "archive" or "drag/drop."

To address this issue, I've created an agent that reduces the number of steps required to archive Lotus Notes documents to specified folders. This agent allows the end user to archive directly to a folder in their Lotus Notes archive database.

The Lotus Notes agent prompts the end user for the folder they'd like to archive, moves the document to the specified folder, and then archives the selected Lotus Notes documents to the archive database -- while maintaining the documents in the specified folder.

The agent saves Lotus Notes users a few steps, and makes archiving Lotus Notes documents a little easier.

You can name the agent: ArchiveSelected Documents To Folders | agent_archiveToFolder.

 Option Public
Option Declare
Use "Common"


Sub Initialize
On Error Goto Trap 
Dim s As New notessession
Dim uiws As New notesuiworkspace 
Dim db As notesdatabase
Dim coll As notesdocumentcollection
Dim StringTable As New mailtoolsstringtable   
 
'get a handle on the current database
Set db = s.currentdatabase
 
'get a handle on the selected documents to archive
Set coll = db.unprocesseddocuments
 
'prompt for users input, verify to archive
If YesNoPrompt(StringTable.GetString
(TOOL_STRING+76,coll.count),
StringTable.GetString(TOOL_STRING+75,Null)) Then 
  
Archive:   
'move the collection of documents to the folder 
Call uiws.folder(, False)
  
'archive the documents
Call db.ArchiveNow(coll)  
  
'refresh the view
Call uiws.Viewrefresh()
  
End If 'prompt for users input, verify to archive   
 
Exit Sub
 
Trap:
'edit archive settings
If YesNoPrompt(Error$ & Chr(10) & 
StringTable.GetString(TOOL_STRING+74,Null),
StringTable.GetString(TOOL_STRING+75,Null)) Then
If uiws.Currentdatabase.Editarchivesettings() Then
Resume Archive
Else
End
End If
End If 
 
End Sub