Auto Notify Your Team Members with Email, when Performing Visual Source Safe Operations
A Visual Source Safe Addin written in VB with the help of which you can auto-email your team members about the operations (Add, Check in, check out...) you performed on VSS
Introduction
Me and five of my friends are working on a project. We use Visual Source Safe for our code. Last week, an unfortunate incident happened with us, just a day before our project release. I found that the code which I checked in VSS a day before was missing. When I asked my friends about this, we found that, one of them had unknowingly overwritten that piece of code in VSS with the one that he was working on.
Then we thought it would be better if in future we can auto-notify each other about our code add/checking in VSS through some way. Then I read an article in MSDN written in VC++ describing how we can intercept VSS events, while we perform any operation on them. Moreover I learnt about Outlook Redemption Library which helps us to send emails programmatically bypassing security alert dialog boxes. With the help of this all, I developed this simple VSS addin in Visual Basic.
After installing (which is as simple as this addin) this addin, whenever you perform any operation on VSS, an email will be sent to all your friends. The email will be sent when you logout from VSS and will consist of a summary of operations you have performed during that VSS session. The email will be sent using the default email account configured in your Outlook. Moreover no security check dialog boxes will be shown during all these operations.
Prerequisite
Installation
- Copy the VSSVBAddin.dll into the %SystemRoot%\System32 folder.
- From a command prompt, register VSSVBAddin.dll with the following command:
RegSvr32 VSSVBAddin.dll
- Create a file named Ssaddin.ini in the VSS\Win32 folder where the Ssapi.dll file is registered (in other words, the folder where you installed Visual SourceSafe). This folder should also be the folder that the following registry key points to:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SourceSafe\SCCServerPath
- Open the Ssaddin.ini file and add the following line to it:
VSSVBAddin.AddinClass = 1
- Create a file named maillist.txt in the folder where your Visual Source Safe Database srcsafe.ini is placed.
- Open the file and write the email id of all your team members, one on each new line. e.g.<
pradeep@xyz.com sudeep@pqr.com ....
Using the Code
Visual source safe provides a method to trap and control its various events such as BeforeAdd, BeforeCheckIn, ....
through the use of addins. This code implements these events and whenever a operation is performed on VSS, it adds the details related to those operations to a global string variable str
.
'Event fired after addition of any item.
Sub VSSHandler_AfterAdd(ByVal Item As IVSSItem, ByVal LocalSpec As _
String, ByVal Comment As String)
'Check if any comment is added. then include that.
If Comment <> "" Then
str = str & vbCrLf & "Added: " & _
Item.Parent.Spec & "/" & Item.Name & _
" at : " & Now & ", Commented : " & Comment
Else
str = str & vbCrLf & "Added: " & _
Item.Parent.Spec & "/" & _
Item.Name & " at : " & Now
End If
End Sub
Later on, when user exits the VSS, Class_Terminate
is called. Here we read the mail id of all the recipients from maillist.txt file placed on the same path as srcsafe.ini file of VSS database itself. Then we send a mail to all those recipients using Redemption Library (which uses your default email account configured on Outlook).
Private Sub Class_Terminate()
On Error GoTo Mailing_Error
'Check if any operation is done. else this string will be empty
If str <> "" Then
Dim SafeItem, oItem
'Creates a mail item to be mailed.
Set Application = CreateObject("Outlook.Application")
Set Namespace = Application.GetNamespace("MAPI")
Namespace.Logon
Set SafeItem = CreateObject("Redemption.SafeMailItem")
Set oItem = Application.CreateItem(0)
SafeItem.Item = oItem
'Reads maillist.txt file for recipient address.
Dim nFileNum As Integer, sNextLine As String
'Get free file number
nFileNum = FreeFile
'Opens the file
Open Left$(VSSHandler.VSSDatabase.SrcSafeIni, _
Len(VSSHandler.VSSDatabase.SrcSafeIni) - 11) _
& "maillist.txt" For Input As nFileNum
Do While Not EOF(nFileNum)
'Read recipient mail id
Line Input #nFileNum, sNextLine
'Add email recipient
SafeItem.Recipients.Add sNextLine
Loop
' Close the file
Close nFileNum
'Resolves email ids
SafeItem.Recipients.ResolveAll
'Create the subject of mail
SafeItem.Subject = "VSS Notification - " & _
VSSHandler.VSSDatabase.SrcSafeIni
'Create the body of email
str = "This is an auto generated message." & vbCrLf & _
"User :" & VSSHandler.VSSDatabase.Username & _
", performed the following operations on VSS Database " _
& vbCrLf & str
SafeItem.Body = str
'Send the email
SafeItem.Send
'Used in case of non Exchange Server mailids e.g. pop-smtp... _
to immediately deliver mail
Set Utils = CreateObject("Redemption.MAPIUtils")
Utils.DeliverNow
End If
Exit Sub
'Handle any error here.
Mailing_Error:
MsgBox "Error " & Err.Number & " while sending mail" & vbCrLf & Err.Description
End Sub
Related Links
- SAMPLE: VSSAddin.exe Notifies Administrator of SourceSafe Event
- Outlook Redemption Library
- Visual SourceSafe Automation
- Microsoft.VisualStudio.SourceSafe.Interop Namespace
- Visual SourceSafe 6.0 Automation
History
- 20th January, 2006: Initial post