6.13.4 Mail header definition file
- Organization of this subsection
(1) Format
[key-name=value]
(2) Function
This file is used to specify any user-defined mail header options, such as the importance of the mail or the presence or absence of reply requests.
You can store the mail header definition file on any path with any file name. However, the absolute path of the mail header definition file must be specified in the mailadp.user.header.path key of the mail adapter runtime environment property file.
(3) File storage location
- The template file is stored at the following location:
Service-platform-installation-directory\CSC\config\mail\templates\mail-header.properties
(4) Example of coding
An example of coding of the mail header definition file is as follows:
Importance=High Sensitivity=Private
(5) Notes
-
The operations might not function properly if the key name and the values are duplicated.
-
The operations might not function properly if the same header is defined multiple times.
-
You cannot specify an empty value for a key name. An error occurs if such a value is specified.
-
If nothing is defined in the mail header definition file, the mail is sent without the user-defined mail header.
-
The operations of the mail header definition file depend on the mail server and the clients who will receive the mails.
-
We recommend that a different mail header be defined in the mail header definition file than the mail header defined in the mail adapter runtime environment property file or the request message. If you specify the same mail header in the mail adapter runtime environment property file and mail header definition file, the operation will depend on the mail server.
-
Two-byte characters are interpreted as invalid strings. Therefore, you must convert such characters by using the following hjdk.native2ascii.jar tool.
service-platform-installation-directory\jdk\bin\java -jar service-platform-installation-directory\jdk\lib\hcompatlib\hjdk.native2ascii.jar input-file-path output-file-path
For details about the hjdk.native2ascii.jar tool, see the JDK documentation.