|
| |
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.
Example masks
| Mask |
| [MyDocuments]\DetachPipe\[FolderStructure]\[filename].[ext] |
| [MyDocuments]\[senderdomain]\[subject]_[filename].[ext] |
| C:\Documents and
Settings\[user]\My Documents\[sendername]\[subject]_[filename].[ext] |
Suggested Mask for DropBox integration: |
| [MyDocuments]\My
Dropbox\Public\DetachPipe\[FolderStructure]\[subject]_[filename].[extension] |
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.
|
