JetTrac Email ConfigForm

Using the JetTrac Email ConfigForm:

JetTrac Email™ enables any version of Adobe Central of JetTrac JobController to send Internet Email messages to end-users. Messages can have any file such as a PDF as an attachment and can be formatted in the email body using standard HTML. Multiple messages can be batched and sent from one field-nominated file or XML stream.
JetTrac Email™ is written in Java so it will run on any platform that supports Java, including, Windows, UNIX, and Linux. This guide will assume a Windows installation, but the information herein can easily be adapted for UNIX or Linux.
For additional information on Java and JetTrac Java products, see the document What you need to know about JetTrac Java and Licensing available from the JetTrac website, http://www.jettrac.com.

Introduction:

This document is a guide to configuring JetTrac Email™ utilizing the ConfigForm GUI. Includes detailed descriptions of the required and optional fields.

Technical Support:

If you need assistance in installing and configuring JetTrac Email™, call Pro Technology Automation, Inc. at 805-527-1248 ext. 0 or e-mail us at support@protechinc.com. Please note that the JetTrac Email™ license fee does not cover configuration services and technical support so there may be an additional charge. Please ensure you read these instructions carefully before calling for technical support.

Using ConfigForm to Configure JetTrac Email™:

JTEmail.jpg

Lines of the ini file:

To: Email Address – Field Name in FNF for Email address(s) to send email to (TO Address), if literal, string starts with a #, multiples separated by semicolon.

CC:Email Address – Field Name in FNF for CC Email address(s) to send email to (CC Address), if literal, string starts with a #, multiples separated by semicolon.

BCC: Email Address – Field Name in FNF for BCC Email address(s) to send email to (CC Address), if literal, string starts with a #, multiples separated by semicolon.

Email Subject – Field Name in FNF for Subject of email, if literal, starts with a #

From: Email Address – Field Name in FNF for Email Address sending the email (From Address), if literal, string starts with a #

Email Body – Field Name in FNF for the message body of the email, if literal, string starts with a #, if pulling from a filename, string adds an & as well

Attachment(s) – Field Name in FNF for a single or multiple attachment(s), if literal, string starts with a #, multiples separated by semicolon.

SMTP Server Address – SMTP Server IP Address:port (if not 25)|smtp user|smtppass~SMTP fault

User Name for SMTP Server – Sender’s hostname

Name of start field – First field of each document in Field Nominated File

Stop after first email? – N for multiple SMTP sessions, Y for single SMTP session with first address encountered

HTML Format Email? – Y for HTML file, N for plain text

Log File Type? – 2 for mega-verbose extra log, jtemail.log, 1 for normal

Delete attachments after sending? – Y to delete attachments, otherwise N, also if second position is Y, then send return receipt request.

Detailed Explanation of each line of ini file:

To: Email Address – The field in the fnf where the name and/or address of the person receiving the Email (the TO name/address) is found. Specified fixed name(s)/address(es) by starting the line with a # character. A value on this line is required. You also have the option to use multiple email addresses, by separating each address with a semicolon (;) Distribution list files are also accommodated. They are specified in either the ini file or in the field specified by an ampersand (&) before the filename. Each address in a distribution list file must be on a separate line.

CC:Email Address – The field in the fnf where the name and/or address of the person(s) receiving a carbon copy of the Email (the CC name/address) is found. Specify a fixed name by starting the line with a # character. A value on this line is optional. The format is the same as the email address above.

BCC: Email Address – The field in the fnf where the name and/or address of the person(s) receiving a blind carbon copy of the Email (the BCC name/address) is found. Specify a fixed name by starting the line with a # character. A value on this line is optional. The format is the same as the email address above.

Email Subject – The field in the fnf where the subject of the Email message is found. Specify a fixed subject by starting the line with a # character. A value on this line is optional.

From: Email Address – The field in the fnf where the name and/or address of the person sending the Email (the FROM name/address) is found. This does not have to correlate to the Adobe Central Server at all and could be any person inside or outside your company. Specify a fixed name by starting the line with a # character. A value on this line is required. The format is the same as for the TO name/address, but only the first address found will be used.

Differentiating From: and Reply To:

In order to have the From address be different than the MIME code for Reply to, put a pipe after the first address a nd add a second address on this line (#static or field).
For example,

From: Email Address – #john@perfect.com

becomes:

From: Email Address – #john@perfect.com|#fred@flinstones.com

john@perfect.com becomes the from address, and fred@flintstones.com becomes the MIME Reply-to address value

Email Body – The field in the fnf where the body of the Email message is specified. Specify a fixed address by starting the line with a # character. To specify an external file, enter #& and then the filename of the file you wish to include as the body of the Email. A value on this line is optional. You can also dynamically call different body files with this method.

Attachment(s) – The field in the Field Nominated File or XML where the attachment(s) of the Email is specified (do not put a ^field or XML bracket notation – just put the field name). You would place the name of each attachment you want in the field name. A value on this line is optional. An example in the fnf:

^field attachments
AttachmentFNF.pdf
AttachmentFNF2.pdf

Or if you are using XML then here is an example (attachments must be on separate lines)

<Attachments>Cooling_Unit_specs.xls
Eagle.jpg
</Attachments>

If the line starts with #, then static filenames can be entered, each one separated by a semicolon.
These are all in addition to the file named on the command line.

SMTP Server Address – The SMTP server is specified and is a requirement for JetTrac Email. This must be a standard SMTP server operating on port 25, and requiring no login. If you are not sure if you have an SMTP server available, consult your network personnel. This can be either a numeric, i.e. 222.124.288.233 or a numonic, i.e. smtp.yahoo.com A value on this line is required. If you need to use a port other than 25, specify a colon then the port after the server reference, If you need to log in and authenticate to this SMTP server, specify a pipe | character at the end of the line, followed by the user name, followed by another pipe | followed by the password. In order to use SMTP server fault tolerancing, place a ~ at the end of the current line, then adding a path to the file that you want to be copied somewhere. The first line of that file is the path to where to place the new file, usually the Control directory of Central.

User Name for SMTP Server – The sender’s hostname is specified. This value is irrelevant to the function of JetTrac Email, but will appear in the source of the message if the receiver were to purposely view the source. Usually use the hostname of the computer you are using. A value on this line is required.

Name of start field – The first field in each document in the field Nominated File or XML. The field specifying the TO Email address must follow this field.

Stop after first email? – The ability to send single Email messages from one FNF or XML file is turned on or off with Y or N. If multiple messages are desired, then each document in the fnf must have the fields specified in lines 1-6 of this .ini file. If single messages per fnf are desired, the first occurrence of the fields specified in lines 1-6 will be used. A value on this line is required.

HTML Format Email? – The ability to send HTML-formatted message bodies is turned on with Y and off with N. The HTML commands must be generated before JetTrac Email runs, in another application. JTEmail will not format your message body as HTML, but simply mark the correct properties of the message as HTML, so most mail readers will see it correctly. All recent Email readers support HTML-formatted Email. A value on this line is required.

Log File Type? – For use in the Debugging mode. Enter a 2 on this line for a verbose log file of the SMTP session in a file called jtemail.log, otherwise, specify 1 for a normal log.
Delete attachments after sending? – In position 1, if you want JTEmail to delete the attachment file after execution of JTEmail, place Y here, otherwise put N here. If Y, the file will be deleted whether the mail is successfully sent or not. This will only delete the file named on the command line, not any of the other attachments. In position 2, if you want to request a return receipt from the client, place a Y.