DetachPipe Placeholders

DetachPipe generates attachment filenames using a mask where Placeholders enclosed in square brackets are replaced by various properties of the email and attachment.

e.g. Using a mask of

c:\My Documents\DetachPipe\[Subject]_[Filename].[Extension]

With a Subject of 'Hello there', and an attachment name of 'test.doc'

Results in an attachment filename of:

c:\My Documents\DetachPipe\Hello there_test.doc

Notes

1. DetachPipe automatically removes the illegal filename characters / : * ? < > |

2. If the mask results in an existing folder name (ie no filename), DetachPipe automatically adds the filename and extension

3. Multiple spaces, backslashes \\, periods .. and underscores __ are replaced by single characters (except for leading \\ characters for UNC paths)

4. DetachPipe will create new folders if they do not exist

5. If there is a filename clash, DetachPipe will number new documents consecutively if the documents are not identical, or share the same filename if documents are size and byte-for-byte identical.

The Placeholders

Placeholder names are not case-sensitive. If you use an unknown placeholder, DetachPipe will substitute [bad placeholder XXX] instead.

Placeholder	Description
[folder]	The parent folder of the email (only one level)
[folderstructure]	The complete folder path of the email all the way back to the root (excluding 'Personal Folders').
[allfolders]	The complete folder path of the email all the way back to the root (including 'Personal Folders').
[myDocuments]	The location of the My Documents folder, with a trailing slash
[sendername]	The email sender's name e.g. ‘Bill Bloggs’
[senderemail]	The email sender's email address e.g. ‘bill@hotmail.com’
[senderdomain]	The email sender’s domain name e.g. ‘hotmail.com’
[recipientname]	The email recipient's name
[recipientemail]	The email recipient's email address
[subject]	The email subject line e.g. 'Re: Dinner'
[simplesubject]	The email subject line without RE:, FW:, Re[4]: etc e.g. 'Dinner'
[ext]	The attachment's extension without a period e.g. 'doc'
[ext1]	The first character of the attachment's extension e.g. 'd'
[filename]	The attachment's filename without the extension e.g. 'test'
[filename1]	The first character of the attachment's filename e.g. 't'
[name]	The attachment's filename and extension e.g. 'test.doc'
[emaildate]	The date of the email in yyyymmdd form e.g. '20060101'. Similarly for [emailyear], [emailmonth] and [emailday], [emailmonthname] and [emaildayname]
[emailtime]	The time of the email in hhmmss form (leading zeroes) e.g. '123201'. Similarly for [emailhour], [emailminute] and [emailsecond]
[date]	Today's date in yyyymmdd form e.g. '20060101'. Similarly for [year], [month] and [day], [monthname] and [dayname]
[time]	Today’s time in hhmmss form (leading zeroes) e.g. '093201'. Similarly for [hour], [minute] and [second].
[user]	The Windows user name
[outlookuser]	The Outlook user name
[random]	A random integer between 0 and 2147483647
[leftsq]	A left square bracket '['
[rightsq]	A right square bracket ']'
[env:variable]	The value of the environment variable variable e.g. [env:HOMEDRIVE]
[reg:key]	The value of the registry key key e.g. [reg:HKLM\Software\DataMystic\DetachPipe\Name] Valid root keys are HKLM, HKCU, HKCR, HKU, HKCC.
[entryid]	The email's entry id (Outlook identifier)

Please contact DataMystic (www.datamystic.com) if you require any other placeholders.