Setting Up Client Applications
Use
You can set up a client application to use the Bounced Mail Framework (BMF). Once you register and configure it, all incoming and outgoing mail messages are controlled by the BMF in the way that you have defined:
· The BMF may check outgoing and incoming mails for trusted or suspended addresses
● The BMF may compare incoming message IDs to outgoing ones to find a rejection reason based on a set of predefined patterns.
● The BMF may execute a required action group once the rejection reason has been identified.
Procedure
Adding Client Applications
...
1. In the Administration workset, navigate to Administer Bounced Mail Framework → Clients and choose Add.
2. Enter the application name.
3. Enter the e-mail address of the client application administrator.
4. Configure the following options, if required:
¡ Format Mails
Enable this option if you want to receive HTML-formatted mails. Otherwise, all HTML-formatted mails are received in plain text.
○ Add Mail Message ID in the 'From' Header
Enable this option if you want the BMF to add an automatically generated ID to the From header for each sent mail.
○ Add Mail Message ID in the Subject
Enable this option if you want the BMF to add an automatically generated ID to the Subject field for each sent mail.
○ Filter Received Mail
Enable this option to filter incoming mail. Only mails from trusted addresses are passed to client applications. If the address of the received e-mail message is not in the trusted list, BMF sends a notification message to the client application administrator.
If incoming filtering is not enabled, all incoming mails are permitted.
○ Filter Sent Mail
Enable this option to filter outgoing mail. Only mails from trusted addresses are sent. If outgoing filtering is not enabled, the BMF sends all outgoing mails.
To use the features of the BMF, enable at least one of the Add mail message ID options.
5. Enter a client identification.
You can choose one of the following ways to register your application:
○ With an Auto-Generated ID
○ With a Custom ID You Entered
If you have enabled automatic registration of the client applications, this field is disabled.
More information: Administering the Bounced Mail Framework
6. Choose Save.
7. To edit or delete an application, select the application from the list and choose Edit or Remove respectively.
Viewing Client Application Status
Each client application appears in the list with the initial status Unregistered. Unregistered applications are not able to send mails through the BMF.
Currently, you cannot register client applications other than the iForms Processor, which is part of the Guided Procedures forms solution.
In the event of problems with mail retrieval, the status of the iForms Processor client changes from Registered to Error. You can see the error details by choosing Show Exception Details. To restore the client to status Registered, choose Register.
Configuring Client Application Settings
...
For each client application that you select from the BMF Clients list, you can choose Settings and do the following:
● Set lists with trusted and suspended addresses
More information: Managing Trusted and Suspended Addresses
● Define action groups
More information: Managing Actions and Action Groups
● Define patterns
More information: Setting Up Client Application Patterns
● Monitor sent and unrecognized mail messages
More information:
Viewing Unrecognized Mail Messages
Result
The BMF can filter and manage your client applications mails.
You can do the following:
● Change the client application settings as required
● Clean up BMF messages that you no longer need
More information: Cleaning Up the BMF Database
● View statistics for client application mails
More information: Viewing Statistics