Can I send an email when a document is deleted from LN database?

I would like to send out an email from a lotus notes database when a document is deleted. The email would contain information from the deleted document. I am running Lotus Notes 7.0.2.
amjavaAsked:
Who is Participating?
 
mbonaciCommented:
Of course you can.
Locate in Designer:
Other - Database Resources - Database Script.

There you have event
Sub Postdocumentdelete(Source As Notesuidatabase).

The sample code is bellow:
	Dim db As Notesdatabase
	Dim doc As NotesDocument, profiledoc As NotesDocument
	Dim c As NotesDocumentCollection
 
	Set db = Source.Database
	Set c = Source.Documents
	
	
	Set doc = c.GetFirstDocument
	Do Until doc Is Nothing		
		'here you handle one by one doc being deleted
		Call SendMail( doc )		'create function that sends mail using values from the doc as information in the mail's subject and body fields.
 
		Set doc = c.GetNextDocument( doc )
	Loop

Open in new window

0
 
fgrushevskyCommented:
You also will need to check user access to prevent false emails, as the script is executed even if user does not have enough access to delete documents.

If db.CurrentAccessLevel < 4 Then Continue = False ' user has no access to delete documents

Also, the script will not report on documents that are deleted through domino backend - i.e. if a document was deleted through API application (adminp could be example of that) or a backend agent      
0
 
mbonaciCommented:
And the SendMail sub could be like this:


Sub SendMail( to As Variant, Subject As String, doc As NotesDocument )
	On error Goto ErrHandler
	Dim s As New NotesSession
	Dim db As NotesDatabase
	Dim rtitem As NotesRichTextItem
	Dim CurrentUser As String
	
	Set db = s.CurrentDatabase
	Set doc = db.CreateDocument
	
	CurrentUser = s.CommonUserName
		
	Set maildoc = New NotesDocument(db) 
	Set rtitem = New NotesRichTextItem(maildoc, "Body")
	Call rtitem.AppendText( "Document " + doc.TheFieldName(0) + " deleted by " + CurrentUser + "." )
	
	maildoc.Form = "Memo"
	Call maildoc.AppendItemValue("SendTo", doc.TheFieldNameInDeletedDoc(0)) 'if the doc holds the intended recipient
	
	maildoc.Subject = Subject
	
	Call maildoc.Send( True )
	
out:
	Exit Function	
ErrHandler:
	Messagebox "SendMail - error: " & Str(Err) & ": " & Error$
	Resume out
End Function

Open in new window

0
Free Tool: SSL Checker

Scans your site and returns information about your SSL implementation and certificate. Helpful for debugging and validating your SSL configuration.

One of a set of tools we are providing to everyone as a way of saying thank you for being a part of the community.

 
mbonaciCommented:
The event is PostDocumentDelete, not QueryDocumentDelete!
So it will execute only after actual deletion of the document.
0
 
fgrushevskyCommented:
Mbonaci, it does not matter.
PostDocumentDelete script will be executed even if the user does not have rights to delete document (and help warns you about that).
So it will look this way:
user clicks delete key, querydocumentdelete is executed, user clicks F9 to actually delete document, postdocumentdelete is executed, then Notes tells user that user has no rights to delete the document, document stays
0
 
fgrushevskyCommented:
So you have to check ACL in the script

 db.CurrentAccessLevel is a quick a dirty way,  you would be better using something like this:


accPriv  = db.QueryAccessPrivileges( EffectiveUserName )

If (accPriv And DBACL_DELETE_DOCUMENTS) = 0 Then Continue = False ' user has no access to delete documents

0
 
amjavaAuthor Commented:
Thanks that looks like it will work great. One last thing can I send the email out based on the form that was used to create it? I only want to send out the email when one certain type of document is deleted from the database.

Thanks
0
 
mbonaciCommented:
Come on, this one you could've done yourself...
        Do Until doc Is Nothing
                If doc.Form(0) = "YourForm" Then
                        'here you handle one by one doc being deleted
                        Call SendMail( doc )
                End if
 
                Set doc = c.GetNextDocument( doc )
        Loop

Open in new window

0
 
mbonaciCommented:
fgrushevsky you're right, my mistake, it is actually stated in the help of the event that it's triggered before verification of authorization to delete.
(You are welcome to join LinkedIn EE group - see my profile).


So amjava, you're going to need this function:
(Call it from Postdocumentdelete Sub, like this:
        ...
        Dim c As NotesDocumentCollection
 
        'Add these two lines here (or you can change the code to remember that the user can't delete
        'and log unauthorized deletion attempt for each document, or something like that)
        Dim s As New NotesSession
        If Not CanUserDeleteDocument( s.CommonUserName ) Then Exit Sub

        Set db = Source.Database
        ...

Function CanUserDeleteDocument( UserName as String ) As Boolean
	Dim s As New NotesSession
	Dim db As NotesDatabase
	Dim acl As NotesACL
	Dim entry As NotesACLEntry
 
	Set db = s.CurrentDatabase
	Set acl = db.ACL
	Set entry = acl.GetEntry( UserName )
 
	If entry.CanDeleteDocuments Then CanUserDeleteDocument = True
 
'add error handling when you get there...
End Function

Open in new window

0
 
amjavaAuthor Commented:
Thanks a bunch. Got it working and running just fine. Thanks for the tip on preventing false emails if the user doesn't have access to delete docs!
0
Question has a verified solution.

Are you are experiencing a similar issue? Get a personalized answer when you ask a related question.

Have a better answer? Share it in a comment.

All Courses

From novice to tech pro — start learning today.