NetResults Tracker Help
Form Incoming Email Settings

Incoming Email Settings are configuration settings for the Submit via Email feature that determine how incoming email messages are processed by Tracker. Incoming Email Settings can be configured for a form or based on the option menu item selected in a particular pulldown field.

To manage the Incoming Email Settings for a form:

  1. Login to the workgroup as Admin
  2. Click on the Admin icon
  3. Click on the Projects link
  4. Select a project in the Projects pulldown at the top. The page will be refreshed with the properties of the selected project
  5. Click on the Manage link to the right of Incoming Email Settings
  6. The current Incoming Email Settings will be displayed.

    If a <Pulldown Name> <Option Menu Item> Incoming Email Settings field is displayed (where <Pulldown Name> is the name of the selected pulldown field and <Option Menu Item> is one of the option menu items in the selected pulldown), this indicates that the Incoming Email Settings are different for each option menu item in a particular pulldown field. If the <Pulldown Name> <Option Menu Item> Incoming Email Settings field is not displayed, this indicates that the Incoming Email Settings are not different for each option menu item in a pulldown (the same settings will be applied to all records submitted with this combination of Project and Form). The pulldown selected in the <Pulldown Name> <Option Menu Item> Incoming Email Settings can be set using the Edit Based On link in the Projects section.

    Select an option in the <Pulldown Name> <Option Menu Item> Incoming Email Settings field to set the Incoming Email Settings that will be applied when records are added to Tracker with this option menu item selected. When selecting an option in this field, the page will be refreshed to display the Incoming Email Settings that correspond to that selection.

    The <Pulldown Name> Values field contains the following options:

    • <Default>
      Selecting this option will allow you to choose the Incoming Email Settings that will be applied when new option menu items are added to this pulldown (the pulldown selected in the Based On field). When this option is selected, the option Apply these settings to other <Pulldown Name> values will be available. Checking the box for the option Apply these settings to other <Pulldown Name> values will show a list of the option menu items for the Based On pulldown. Select the option menu item(s) that should inherit the same Incoming Email Settings that you have set for <Default>. To select multiple option menu items, hold down the Ctrl button on your keyboard while clicking on the desired option menu items.

    • Option Menu Items for the Based On pulldown
      Each option menu item configured for the pulldown field selected in the Based On field will be listed. Selecting an option menu item will allow you to set the Incoming Email Settings that will be applied when records are added to Tracker with this option menu item selected. Click on the Load Defaults button if you wish to have the Incoming Email Settings configured for <Default> to be filled into the Incoming Email Settings for the option menu item selected.

    Enable Submit via Email
    In order to enable the Submit via Email feature for a form, this property must be set to "Yes", which will allow records to be added to this workgroup via email. This property is grayed out (cannot be set) for "<Default>" when the Incoming Email Settings are set to be based on a pulldown.

    Mail Account User Name
    Enter a unique mail account (mailbox) on the mail server specified in the "Mail Server Name" field to receive the incoming email messages. Enter the User Name for this account. Up to 80 characters can be entered into this field. This property is grayed out (cannot be set) for "<Default>" when the Incoming Email Settings are set to be based on a pulldown.

    Mail Account User Password
    Enter the password that corresponds to the user account (mailbox) specified in the "Mail Account User Name" field above. Up to 50 characters can be entered into this field. This property is grayed out (cannot be set) for "<Default>" when the Incoming Email Settings are set to be based on a pulldown.

    Warning: Tracker deletes all emails that it successfully reads. It is possible that Tracker could read (and delete) an email, but still be unable to store the full information from the email into your workgroup. If you need to keep a copy of all emails sent to a particular mailbox, do not use that mailbox for Tracker. Instead, create a new mailbox and forward copies of email from the mission critical mailbox (or create a mailing list to distribute emails to both mailboxes). In general, this is a good idea, at least until you have made certain you have configured the Submit via Email feature properly. Please contact your email administrator for information on how to set up email accounts.

    Mail Server Type
    Select the type that corresponds to the mail server entered into the mail server name field below. The mail server types supported are POP3 and IMAP.

    Mail Server Name
    Enter the name of the mail server to be used by default to process the incoming email messages intended for this workgroup. The mail server name can be of the form "smtp.yourcompany.com" or can be the IP Address of the machine where your mail server is installed.

    Save Email 'Subject' as
    Select a field of Text type to which the contents of the email message's subject will be saved in the new record. The choices available are based on the Text fields created in the Fields section. Choosing <None> will not save the email message's subject in any field. A Text field must be selected, if ?Enable Submit via Email? is set to ?Yes?. Please note that Field Visibility settings are not enforced when a record is created via email. Thus, if the Text field selected for this option is configured such that it is not visible to certain groups on the Add page, this restriction will not be enforced for records added via email.

    Save Email 'Body' as
    Select a field of TextArea type to which the contents of the email message's body will be saved in the new record. The choices available are based on the TextArea fields created in the Fields section. Choosing <None> will not save the email message's body in any field. A TextArea field must be selected if "Enable Submit Record via Email" is set to "Yes". If the body of an email is not plain text (for example, it's an image, audio, or HTML file), then it will be saved as a file attachment and a note telling the user that the body was saved as an attachment will be placed in the TextArea field you selected. If the body of the email comes in multiple versions (MIME multipart/alternative format), the plain text version (if any) will be saved in the TextArea field you selected and the other alternative versions will be saved as file attachments. Please note that Field Visibility settings are not enforced when a record is created via email. Thus, if the TextArea field selected for this option is configured such that it is not visible to certain groups on the Add page, this restriction will not be enforced for records added via email.

    Default Initial State for Incoming Emails
    When a new record is created by an incoming email, the Status field of the new record will be set with the state selected in this option. The state selected also determines the assignee of the new record. The user assigned to the new record will be the State Manager as determined by the State Manager settings for the combination of Form and Project set in the record (refer to the section Form State Managers for more information).

    Set Reporter by Mapping 'From' Address
    You can use the email address in the 'From' field of the incoming message to set the "Reported By" field for the new record. This is done by setting this option to "Yes", which will allow Tracker to compare the email address listed in the 'From' field of the incoming message to the email addresses entered in the user profiles in the workgroup's User Accounts section. If the address is not found or this option is set to "No", the incoming email will be processed according to the setting of the "Action for Unmapped Emails" option.

    Action for Unmapped Emails
    Tracker can be configured to map the email address in the 'From' field of the incoming message to the email addresses entered in the user profiles in the workgroup's User Accounts section. The result of this mapping will set the "Reported By" field for the new record. If the mapping does not find a match in the User Administration table OR if the option "Set Reporter by Mapping 'From' Address" is set to "No", one of the following actions can be selected to process the incoming message:

    • Selecting "<Delete Email>" will result in the incoming email message being deleted and no record will be created.
    • Selecting "<Set Reporter to Unregistered User>" will set the "Reported By" field of the new record to be the "Unregistered User". The Unregistered User is a built-in user within Tracker used to distinguish records reported by unregistered users.

    Save Attachments in Email
    If the incoming message contains any file attachments, these can be saved as files attached to the new record by setting this option to "Yes". Please note that the Add Attachments user group privilege is not enforced for records that are added via email. When this option is set to "Yes", any user will be able to create a record that contains an attachment using the Submit via Email feature.

    Save Raw Email as an Attachment
    Select "Yes" for this option if you wish to save the entire incoming email as a file attached to the new record. The entire contents of the email including the attachments (raw email prior to processing by Tracker) will be saved as a text file (with .txt as extension) and attached to the new record. This can be useful if some of the information in the email could not be stored in the Tracker fields you have selected (for example, if the Subject line is very long and must be truncated to be stored in the Text field you have selected).

    Stop Processing Emails on First Error
    Incoming messages are processed in batches periodically by Tracker's Email Processor. If there is an issue which prevents an incoming message from being processed successfully, you can choose whether Tracker should attempt to process any remaining incoming messages. Setting this option to "Yes" indicates that Tracker should not process any additional incoming messages once an error occurs (an incoming message cannot be processed successfully).

  7. Click OK to save the selections
  8. Click OK to return to the Projects section

To edit the pulldown that the Incoming Email Settings are based on:

  1. Login to the workgroup as Admin
  2. Click on the Admin icon
  3. Click on the Projects link
  4. Select a project in the Projects pulldown at the top. The page will be refreshed with the properties of the selected project.
  5. Click on the "+" icon to the left of the Incoming Email Settings section for the form you wish to modify
  6. Click on the Edit Based On link to the right of Incoming Email Settings
  7. Select a pulldown in the Based on Pulldown so that you can configure different Incoming Email Settings for each option menu item in this pulldown
  8. Click OK to save your selection
  9. Click OK to return to the Projects section or click Set Incoming Email Settings to configure the settings for each option menu item in the selected pulldown

To edit the Incoming Email Settings for a specific pulldown option menu item:

  1. Login to the workgroup as Admin
  2. Click on the Admin icon
  3. Click on the Projects link
  4. Select a project in the Projects pulldown at the top. The page will be refreshed with the properties of the selected project.
  5. Click on the "+" icon to the left of the Incoming Email Settings section for the form you wish to modify
  6. Click on the Edit link to the right of the pulldown option menu item
  7. The Incoming Email Settings for the selected option menu item will be displayed.

    If you are editing the settings for the option menu item <Default>, the Incoming Email Settings displayed will be applied when new option menu items are added to this pulldown (the pulldown selected in the Based On field). The option Apply these settings to other <Pulldown Name> values will be available when editing the settings for <Default>. Checking the box for the option Apply these settings to other <Pulldown Name> values will show a list of the option menu items for the Based On pulldown. Select the option menu item(s) that should inherit the same Incoming Email Settings that you have set for <Default>. To select multiple option menu items, hold down the Ctrl button on your keyboard while clicking on the desired option menu items.

    If you are editing the settings for an option menu item in the pulldown, the Incoming Email Settings displayed will be applied when records are added to Tracker with this option menu item selected. Click on the Load Defaults button if you wish to have the Incoming Email Settings configured for <Default> to be filled into the Incoming Email Settings for the option menu item selected.

    Enable Submit via Email
    In order to enable the Submit via Email feature for a form, this property must be set to "Yes", which will allow records to be added to this workgroup via email. This property is grayed out (cannot be set) for "<Default>" when the Incoming Email Settings are set to be based on a pulldown.

    Mail Account User Name
    Enter a unique mail account (mailbox) on the mail server specified in the "Mail Server Name" field to receive the incoming email messages. Enter the User Name for this account. Up to 80 characters can be entered into this field. This property is grayed out (cannot be set) for "<Default>" when the Incoming Email Settings are set to be based on a pulldown.

    Mail Account User Password
    Enter the password that corresponds to the user account (mailbox) specified in the "Mail Account User Name" field above. Up to 50 characters can be entered into this field. This property is grayed out (cannot be set) for "<Default>" when the Incoming Email Settings are set to be based on a pulldown.

    Warning: Tracker deletes all emails that it successfully reads. It is possible that Tracker could read (and delete) an email, but still be unable to store the full information from the email into your workgroup. If you need to keep a copy of all emails sent to a particular mailbox, do not use that mailbox for Tracker. Instead, create a new mailbox and forward copies of email from the mission critical mailbox (or create a mailing list to distribute emails to both mailboxes). In general, this is a good idea, at least until you have made certain you have configured the Submit via Email feature properly. Please contact your email administrator for information on how to set up email accounts.

    Mail Server Type
    Select the type that corresponds to the mail server entered into the mail server name field below. The mail server types supported are POP3 and IMAP.

    Mail Server Name
    Enter the name of the mail server to be used by default to process the incoming email messages intended for this workgroup. The mail server name can be of the form "smtp.yourcompany.com" or can be the IP Address of the machine where your mail server is installed.

    Save Email 'Subject' as
    Select a field of Text type to which the contents of the email message's subject will be saved in the new record. The choices available are based on the Text fields created in the Fields section. Choosing <None> will not save the email message's subject in any field. A Text field must be selected, if ?Enable Submit via Email? is set to ?Yes?. Please note that Field Visibility settings are not enforced when a record is created via email. Thus, if the Text field selected for this option is configured such that it is not visible to certain groups on the Add page, this restriction will not be enforced for records added via email.

    Save Email 'Body' as
    Select a field of TextArea type to which the contents of the email message's body will be saved in the new record. The choices available are based on the TextArea fields created in the Fields section. Choosing <None> will not save the email message's body in any field. A TextArea field must be selected if "Enable Submit via Email" is set to "Yes". If the body of an email is not plain text (for example, it's an image, audio, or HTML file), then it will be saved as a file attachment and a note telling the user that the body was saved as an attachment will be placed in the TextArea field you selected. If the body of the email comes in multiple versions (MIME multipart/alternative format), the plain text version (if any) will be saved in the TextArea field you selected and the other alternative versions will be saved as file attachments. Please note that Field Visibility settings are not enforced when a record is created via email. Thus, if the TextArea field selected for this option is configured such that it is not visible to certain groups on the Add page, this restriction will not be enforced for records added via email.

    Default Initial State for Incoming Emails
    When a new record is created by an incoming email, the Status field of the new record will be set with the state selected in this option. The state selected also determines the assignee of the new record. The user assigned to the new record will be the State Manager as determined by the State Manager settings for the combination of Form and Project set in the record (refer to the section Form State Managers for more information).

    Set Reporter by Mapping 'From' Address
    You can use the email address in the 'From' field of the incoming message to set the "Reported By" field for the new record. This is done by setting this option to "Yes", which will allow Tracker to compare the email address listed in the 'From' field of the incoming message to the email addresses entered in the user profiles in the workgroup's User Accounts section. If the address is not found or this option is set to "No", the incoming email will be processed according to the setting of the "Action for Unmapped Emails" option.

    Action for Unmapped Emails
    Tracker can be configured to map the email address in the 'From' field of the incoming message to the email addresses entered in the user profiles in the workgroup's User Accounts section. The result of this mapping will set the "Reported By" field for the new record. If the mapping does not find a match in the User Administration table OR if the option "Set Reporter by Mapping 'From' Address" is set to "No", one of the following actions can be selected to process the incoming message:

    • Selecting "<Delete Email>" will result in the incoming email message being deleted and no record will be created.
    • Selecting "<Set Reporter to Unregistered User>" will set the "Reported By" field of the new record to be the "Unregistered User". The Unregistered User is a built-in user within Tracker used to distinguish records reported by unregistered users.

    Save Attachments in Email
    If the incoming message contains any file attachments, these can be saved as files attached to the new record by setting this option to "Yes". Please note that the Add Attachments user group privilege is not enforced for records that are added via email. When this option is set to "Yes", any user will be able to create a record that contains an attachment using the Submit via Email feature.

    Save Raw Email as an Attachment
    Select "Yes" for this option if you wish to save the entire incoming email as a file attached to the new record. The entire contents of the email including the attachments (raw email prior to processing by Tracker) will be saved as a text file (with .txt as extension) and attached to the new record. This can be useful if some of the information in the email could not be stored in the Tracker fields you have selected (for example, if the Subject line is very long and must be truncated to be stored in the Text field you have selected).

    Stop Processing Emails on First Error
    Incoming messages are processed in batches periodically by Tracker's Email Processor. If there is an issue which prevents an incoming message from being processed successfully, you can choose whether Tracker should attempt to process any remaining incoming messages. Setting this option to "Yes" indicates that Tracker should not process any additional incoming messages once an error occurs (an incoming message cannot be processed successfully).

  8. Click OK to save the selections
  9. Click OK to return to the Projects section




NetResults Tracker © 1997-2010 NetResults Corporation. All rights reserved.