On the
Notification
Delivery page, you configure settings for WorldServer
notifications. The default delivery mechanism implements email delivery
and thus delivery settings are email-related. You supply the following
configurations:
- Frequency of e-mail
processing (minutes) – How often do you want WorldServer
to perform notification event processing (in minutes)? The value is
the minimum amount of time between transmissions, defaulting to 30
minutes between transmissions.
- From User – What user do you want the notification to come from? It must be
a valid WorldServer user that has an email address configured.
Note: Having an email address is a constraint of the
default delivery component. Custom delivery components may have other
constraints, such as that the user attribute "IM name" must be configured.
- SMTP Server – What SMTP server should WorldServer use?
- SMTP Port – What SMTP port should WorldServer use?
- SMTP Authentication – Should WorldServer enforce SMTP authentication? If so, you must
specify the SMTP username and password expected by the SMTP server.
- JavaMail Properties – What advanced JavaMail properties—such as protocol, MIME encoding,
or encryption for secure SMTP—would you like WorldServer to use? WorldServer
notification delivery is implemented using the JavaMail API, and the
default delivery component will pass these added user-defined properties
to the JavaMail session.
User-added JavaMail
properties are listed in a table. Both name and value fields can be
edited for each JavaMail property. Click the Add button to add a
new row to the property table. The Delete button works
in conjunction with the checkboxes in the JavaMail property table,
and deletes selected property rows.
As an example of a
useful JavaMail property, you could enter mail.debug for Name and true for Value, and JavaMail
will write the SMTP it uses to standard output, plus other debugging
information. To view the standard output for WorldServer, start WorldServer
in debug mode (for Windows) in a command window with the command IdiomRun –debug, run from
the Idiom\WorldServer\svc directory. This launches a another command window, to which it writes
the logging and debugging information. When you then set the JavaMail
mail.debug property in the Notification Delivery page and click Send Test, you can
view the SMTP information in the command window.
CAUTION:
You should only enter these properties
if you are familiar with JavaMail and have a clear understanding of
the impact. For the most part, you can ignore these settings.
- Would you like WorldServer to send a test email to verify that your
settings are correct?
When you click the Send Test button, WorldServer
sends a notification to test the delivery configuration you have specified,
but does not save the configuration. This consists of a hard-coded
test message sent to your email address. You must have an email address
configured for you in for the test notification to be delivered. When you
have established that your configuration is successful (that is, when
you have received the test email), click the Send Test and Save button
to save the configuration. You will receive another email and your
configuration will now be saved. If the send process encounters an
error, the error is displayed at the top of the page; the configuration
data is not saved.