|
| |
DetachPipe generates attachment filenames using a mask where Placeholders
enclosed in square brackets are replaced by various properties of the email and
attachment. Note - you don't have to make use of placeholders - you can specify
a filename manually if you wish.
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', will result in an attachment filename of
c:\My
Documents\DetachPipe\Hello there_test.doc
Notes:
- DetachPipe automatically removes the illegal filename characters / : * ?
< > |
- If the mask results in an existing folder name (ie no filename),
DetachPipe automatically adds the filename and extension
- Multiple spaces, backslashes \\, periods .. and underscores __ are
replaced by single characters (except for leading \\ characters for UNC paths)
- DetachPipe will create new folders if they do not exist
- 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
- DetachPipe will shorten a filename if it is longer than the file system
can handle (e.g. 260 characters for FAT32)
- DetachPipe prevents special filenames such as COM1-9, LPT1-9, CON, PRN
etc from being used.
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. |
Please contact
DataMystic if you require any other placeholders.
Special Use
If you'd like to retain DetachPipe's merging of identical files, then all
files must be placed in the same folder, and have the same root name. A mask of
\folder\[filename]_[random].[ext]
will maintain this function.
|
