Configuring advanced incoming mailbox properties

During advanced configuration, you enter information about associated mailboxes, templates, and forms, and information related to mailbox security. You can do this by using the Advanced Configuration tab of the AR System Email Mailbox Configuration form as shown in the following figure.

Advanced configuration for incoming mailboxes

(Click the image to expand it.)

adv-conf-in.PNG

Note

Review the information about advanced configuration settings in Creating-and-using-email-templates.

To create an advanced configuration for your incoming mailbox

  1. In the Advanced Configuration tab of the AR System Email Mailbox Configuration form, select an outgoing mailbox from the Associated Mailbox Name list to reply to incoming emails that require responses, such as queries.
  2. In the Action Configuration section, specify:
    • Email Action — To enable the Email Engine to detect and process instructions included in an incoming email message, select Parse. If you use templates to perform Submit, Modify, or Query actions, you must select Parse.
       For more information about templates and parsing, see Using-label-value-pairs-in-templates and Types-of-email-templates.

    • Use Original Template Format (enabled for upgrades from BMC Remedy Mail Server) — To enable original parsing system processing, select Yes.
       Original parsing ignores special HTML fields, XML formats, and data entered in an invalid format, such as a character string in a number field. If you use this option, the Email Engine displays an error message when it encounters these types of fields or formats. To use normal parsing, select No.

      Note

      If you select No, make sure that multiple lines in emails are encapsulated with the [$$ and $$] multiple-line delimiters.

    • Reply with Result — To enable the Email Engine to return the results of an action in an email, select Yes.
       This option allows the email sender to know if the incoming email succeeded or failed. 
    • Reply with Entry — To return the complete entry of a submit or modify action, select Yes.
    • Enable Modify Actions — To enable the Email Engine to modify existing entries, select Yes.

    • Default Workflow Form — Enter the name of the default form on which the Email Engine executes instructions such as queries, form-entry modifications, and form submittals, from the incoming email message.

      Note

      If you define a default workflow form, incoming templates do not require the Form (or Schema) label. For more information, see Form-label.

    • Force Default Workflow Form — To confine all instructions from the incoming email message to the form that you specified in the Default Workflow Form field, select Yes.

      Note

      If an incoming template specifies a schema, the schema will not be processed and the default workflow form will be used instead.

  3. In the Incoming Security Configuration section, specify the level of security to be applied to email messages to this mailbox. This information is used to determine which AR System user information to apply when executing instructions parsed from an incoming email.
     Depending on the level of security that you want, apply one of the following security options:
    • Use Security Key — Select Yes to enable a security key for incoming email.
       The information is added to the Email Security form, so you do not have to supply the user name and password in the incoming email. If you use this option, you must create and configure the security key. See Configuring incoming mailbox security.
       If you select No, the security key will be disabled for incoming email containing the modify action. In case of multiple recipients, the outgoing email message for this modify action will not be sent.
    • Use Supplied User Information — To use AR System server login information from the incoming email message to execute instructions in the incoming message, such as instructions to modify requests or submit queries, select Yes.
       For more information about login syntax, see Login-Password-and-TCP-Port-labels.

    • Use Email From Address — To use the sender's email address as a form of authentication, select Yes.
       The Email Engine displays an error message if the sender's email address is different from the email address stored in the AR System User form.

      Note

      Apply only one of the given security options.

  4. Click Save.