Stubbing templates
Message stubbing is a function that replaces parts of an e-mail with external links or new contents. This function does not significantly reduce the load on Exchange in the long run. It could potentially cause administrative problems, such as when external references are obsolete. If performance of the Exchange server or the lifetime of references are not important, message stubbing can be a useful addition to processing messages.
Message stubbingBody templateStubbing templateTemplate, stubbingIn ELOxc, message stubbing is based on templates (stubbing template) that are used in an action (stubbing).
The template contains two parts. One part is for stubbing messages in text format and the other part is for messages in HTML format. ELOxc recognizes the format of each message and uses the corresponding part of the template. Messages in rich text format cannot be stubbed and are ignored with a corresponding error message in the log.
A template represents the new body and supports the use of stubbing variables. These variables are always written to the stubbing template as {%VARIABLE}. The available variables are:
- IX: This variable is replaced by the URL of the corresponding Indexserver.
- ARCNAME: This writes the name of the repository to the body.
- ARCDATE: This variable returns the date and time of archiving.
- DELDATE: This variable returns the date and time of stubbing.
- LINK: This generates a Web Client URL that refers to the archived e-mail.
- ATTLINK: This variable is used for extracted attachments, as with the variable "Link".
- ECD: This variable ensures that ELO links of the archived e-mail and all its attachments are attached to the e-mail.
- BODY: This variable returns the whole message body.
- HTMLBODY: This variable can only be used in HTML format and ensures that the previous message body remains in HTML format. At the same time, all variables except ECD are ignored.
- GUID: This variable is not used in templates but in the "Stubbing" action, where the Web Client URL is configured as a link template.
The standard assignment of the time variables ARCDATE and DELDATE is as follows: {% DELDATE:UTC:ISO:en-US}.
It is possible to configure additional format requirements by separating them with colons. If UTC is omitted, the local time is used. If you do not want to generate an ISO date with the format YYYYMMDDhhmmss, you can use one of the following specifications instead:
- D: Short date pattern
- d: Long date pattern
- f: Complete date/time pattern (short term)
- F: Complete date/time pattern (long term)
- g: General date/time pattern (short term)
- G: General date/time pattern (long term)
- t: Short time pattern
- T: Long time pattern
However, these abbreviations sometimes also generate language-specific output, which is why an additional language/country abbreviation (above "en-US") is required.
For more information on the standard format string for date and time, refer to this Microsoft documentation
The following image shows an example of a body template (text).
The following image shows an example of a body template (HTML).
In the "Message stubbing" action, enter the name of the template in the "Message stubbing" field. The "Address pattern" field is required for the Web Client URL if the variables LINK and ATTNLINK are to be supported. This URL must also contain the GUID variable in this case. ELOxc generates the correct URLs in the stubbing process. In addition, you need to set the "ELO reference" parameter so that the GUID of the e-mail was saved to this metadata field when extracting attachments. Otherwise, ELOxc cannot determine the values of the variable ATTLINK.