Skip to main content

A Useful Little Routine to Change Data in Fields

Level: Beginner Development

Today I thought I'd just share with you a little routine that I use when I want to make field level changes to a lot of documents without having to edit them. It's beginner stuff but I use it a lot.

What you need
A document, or group of documents with a field called DocNumber
A view where you can select those documents.
Notes Designer.

Creating the Agent
  1. Open Designer on the database (or template)
  2. Click on Shared Code then Agents
  3. Click on the button marked New Agent
  4. In the Properties box, give your agent a Name eg: Change Document Number
  5. It should be a Shared Agent
  6. In the Target Section, it should read All Selected Documents
  7. You don't need to change anything else in the properties box, so just close it.
  8. Now, in the intialize event of your Agent (just click on the word initialize and type in the box that appears).
  9. Type your code (or paste it from this page).
  10. When you've finished, Close the agent windows and choose YES to save your changes.




The code



Sub Initialize
   Dim NewSection As String
   Dim Counter As Long

   Dim ses As New notessession
   Dim doc As notesdocument
   Dim db As notesdatabase
   Dim col As notesdocumentcollection

   Counter = 0
   NewSection = Trim$(Inputbox$("What is the name of the New Category?"))

   If NewSection = "" Then
      Print "You did not specify a category to move documents to. No documents moved."
      Exit Sub
   End If

   Set db = ses.currentdatabase
   Set col = db.unprocesseddocuments

   Set doc=col.getfirstdocument

   While Not doc Is Nothing
      doc.DocNumber = NewSection
      Counter = Counter +1
      Call doc.Save(True, True)

      Set doc=col.getnextdocument(doc)
   Wend
   Print Trim$(Str$(Counter)) + " document(s) moved to category: " + NewSection
End Sub





How to Use the Routine
Simply tag a whole heap of documents then click on Actions, then Change Document Number (from the Lotus Notes Menu). You'll be prompted for a new number and then it will change all the selected documents.

I use this routine a lot when I want to move documents from one section/category to another.

Comments

Popular posts from this blog

How to Change Your Notification Options for New Lotus Notes Mail in version 8.x

Don't worry, I'm not patronizing you (my readers), I just decided to re-document this for one of our internal users and thought you might want to be able to use it in your own user documentation. WHAT IS THIS DOCUMENT ABOUT? Some people who don't get a lot of mail, like to be notified when such an event occurs. Notification can be; via a sound via a pop-up box via the system tray (where the computer clock is) The pop up box looks like this; Other people, who like myself, get too much mail would rather not be notified. The aim of this document is to tell you how (and where) to turn these options on and off. CHANGING YOUR SETTINGS To change your settings from the Notes 8.x client; On the Menu, click File , then Preferences... On the left hand side , click on the little plus sign to the left of Mail to expand the options. Click on the option marked Sending and Receiving . In the middle section, under receiving, you can control your notifications. If you untick the box mark

How to Create an Auto-Response Mail Message in Lotus Notes 8.5.3+

Why would you do this? Suppose that you have an externally accessible generic email address for your company; support@mycompany.com or info@mycompany.com. You might expose this to the web and allow people to send messages to you. Setting up an auto-response email will tell the senders that their message reached its destination and that it will be dealt with accordingly.  It's also good practice to include links to FAQs or other useful information. Why 8.5.3 The techniques we'll be using here work in older versions of Notes but some of the options seem to have moved around in 8.5.3.  I figured it was a good time to show you where they've moved to. The Procedure Start Domino Designer and open the Mail file to be modified.  A really quick way to do this is to right-click on the application tab and choose "Open in Designer". In the Left hand panel of designer, expand Code and then double-click Agents.  A new window should appear. Click the action

How to Do a Mail Merge to Email using Lotus Notes

Why do one? In today's "green" world, it makes much better sense to send out emails than letters but you still want to personalize them. Sadly, by itself Lotus Notes doesn't support mail merge to email. Of course, we know that outlook does (but then it lets anyone and anything send emails for you - even when you don't want them to). So, how to do it in Notes? OpenNTF The first port of call is OpenNTF ( http://www.openntf.org/ ). This place is full of great things but most of them are really badly documented. Still, these guys give things away for free and they develop in their spare time, so we should be grateful for what we get. There's a great little project there called MailMerge Excel to Notes . Go there, click on releases and download the ZIP file. Getting to the Code The installation is tricky though I've noted that since I asked the author about the install, it's been updated (so maybe these steps are less necessary). Unzip the files to somewher