Email service
Intrexx offers you the option of sending automated emails. There are two ways to trigger these emails:
-
By clicking on a configured button
-
In Processes, with the corresponding process elements
The basic requirement for sending e-mails is the configuration of the e-mail service in the "Tools" module. So, first set up, test and activate the email service.
All information on configuring buttons in applications for sending e-mails can be found here.
All information on the automatic sending of emails in processes can be found here.
Configure
Clicking this button opens a wizard where the service can be set up.
Default sender
Name
Enter the default sender here. The default sender is used if no individual sender has been defined in an application or process.
Enter the email address of the default sender here.
Click "Next".
Email server
SMTP server / SMTP port
Enter the name or the IP address of the SMTP server here.
The default port is 25. If in doubt, please contact your system administrator. The mail server used does not necessarily have to be on the local network of the Intrexx Portal Server.
Authentication
The settings in this area should be defined according to what your mail server requires.
Connection security
You can select between None, STARTTLS or SSL/TLS as the connection security here.
Authentication methods
How the password is transferred can be defined here.
PLAIN
Transfers the password unencrypted as plain text.
Login
Takes the password unencrypted from the user input in the end device.
CRAM-MD5
Encrypts the password with the CRAM-MD5 algorithm.
NTLM
Authentication takes place via NTLM.
User name / Password
Enter the corresponding user name and password.
Click "Next".
Sending settings
Maximum email size
The maximum size of sent emails can be specified here. If the field is left blank, the size of the e-mails is not taken into account. Select your required unit using the drop-down list.
By default, 10 MB is predefined as the maximum size. This corresponds to the usual expected maximum message size.
Maximum number of emails per session
Here, the maximum number of emails per SMTP session can be constrained. If several emails are available for sending at the same time, the SMTP session is terminated once this limit is reached and a new SMTP session is created in the next round of the sending loop in order to send further emails. The waiting time between the two transits of the sending loop is defined by the ""de.uplanet.lucy.sendmail.sleepInterval"" setting (default : 1000 ms).
Archive sent emails
With this setting, sent e-mails are stored in an archive file. You can change the corresponding path in the expert settings.
Generate process event if e-mail cannot be sent
If this setting is activated, an e-mail is sent after a final failed e-mail transmission
de.uplanet.lucy.server.mailservice.workflow.event.IBadMailWorkflowEvent
which can be accessed, for example, with the generic event handler
de.uplanet.lucy.server.mailservice.workflow.eventhandler.BadMailWorkflowEventHandler
.
Further information can be found here.
Maximum number of retries
Here, you can specify the number of times that an undeliverable mail should be re-sent.
Repetition intervals
Below you can set the intervals between the first, second, third and subsequent retries. Each interval will be calculated from the last time the sending was attempted.
We recommend keeping the default settings for the resending of emails.
Click "Next".
Connection test
The configuration can be tested by clicking on the "Test" button. If error messages are displayed, the configuration must be changed or there is no mail server that can be used for the SMTP service. If in doubt, please contact your system administrator.
Click "Finish" to save the configuration of the e-mail service and close the wizard.
If the e-mail service is set up, the settings are displayed on the right-hand side. The email service can be activated or deactivated, and updated, by clicking on the corresponding buttons here.
If you click on "Configure" again here, the configuration overview opens. In addition to the already established settings, you will find the Expert settings here.
Expert settings
Double-click to edit the value of a sending setting.
Add setting
Opens a dialog where a new property can be created.
New property
Select the desired JavaMail properties in "Name" and enter the value. Custom properties can also be entered here directly. Information on the possible settings can be found here.
Determine from which portal the message was sent
Global headers can be set when sending emails. These are placed in every email message sent via the Intrexx email service. A common convention is to have the names of user-defined headers that are not defined by standards begin with X-. To define a global header, create the new property de.uplanet.lucy.sendmail.header in the expert settings as described above. followed by a consecutive number, such as here
de.uplanet.lucy.sendmail.header.1
Enter the prefix ""X-"" to the value of the key (see above), followed by the name of the header, a colon, and the name of the portal. For example:
X-Intrexx-Portal:MeinPortal
With it, all emails that are sent from the portal ""My portal"" can, for example, be filtered in Outlook. In our example above, the message header will be ""X-Intrexx-Portal:MyPortal"".
Click on "OK" to save the new setting and close the dialog.
Delete setting
Removes the currently selected property.
Specify path for email archive
In the send settings you will find the setting "Archive sent emails". The directory, where the archived emails are saved, can be modified by double-clicking on the Value column for the de.uplanet.lucy.sendmail.sentMailDirectory setting.
Gmail as an email provider
The password associated with your Google account is, since May 2022, no longer valid to use Gmail as an email provider in Intrexx.
You will need to use an app password instead. Two-factor authentication must be enabled in your Gmail account for this to work.
For existing portals, this issue is identifiable by the following error type:
Error:
javax.mail.AuthenticationFailedException:
534-5.7.9 Application-specific password required. Learn more at 534 5.7.9
https://support.google.com/mail/?p=InvalidSecondFactor y12-20020a170906470c00b00711d0b41bcfsm2837429ejq.0 - gsmtp
Send us an e-mail