Configuring Server Settings

Last update: January 3, 2025

Topics:
Adaptive Forms

CREATED FOR:

User
Developer

The Server Settings page provides access to various settings for forms workflow:

Email settings that enable outgoing email messages, along with the email server settings used for those messages. (See Configuring email settings.)
Task notification settings that enable, disable, or modify the messages sent in email notifications to end users and groups regarding their tasks. (See Configuring notifications for users and groups.)
Administrator notification settings that enable, disable, or modify the messages sent in email notifications for administrative tasks. (See Configuring notifications for administrators.)

Configuring email settings

You can specify an email account for the Forms Server, through which it sends email messages to AEM forms users and administrators. These email messages are used to notify and remind users of tasks that they must complete, notify the user of tasks that have reached a deadline, and notify the administrator of any process errors that occur.

To enable the sending of email messages between AEM forms and users, configure the outgoing email settings on the Email Settings page. Outgoing email must use an SMTP server.

To enable AEM forms to receive and handle incoming email messages from users, create an email endpoint for the Complete Task service. (See Create an Email endpoint for the Complete Task service).

If your processes are designed and implemented without requiring email, you do not have to configure any of the options on the Email Settings page.

Configure outgoing email settings

NOTE

Ensure that the user has admin privileges to access the administrator console.

In administration console, click Services > forms workflow > Server Settings > Email Settings.
Select Enable Outgoing Messages.
In the SMTP Server box, type the email server name or IP address. All notification email messages from forms workflow are sent from this email server.
In the User Name and Password boxes, type the login name and password to be used when the SMTP server requires authentication. Leave them blank if anonymous login is allowed.
In the Email Address box, type the email address to use as the return address for email messages that forms workflow sends.

NOTE
If you are using Microsoft Exchange Server and the Email Address is an invalid email address, Microsoft Exchange server fails to send an email to Distribution Lists. To resolve the issue, select the Enable External Communication option seperately for every Distribution List on Microsoft Exchange server.
Click Save.

NOTE

If you enter incorrect information, you can click Cancel to go back to the previously displayed page.

Configuring email templates to use AEM Forms Workspace

NOTE

The Flex Workspace is deprecated for AEM forms release.

By default, the emails sent out by AEM forms contain links to (Deprecated for AEM forms on JEE) Flex Workspace. You can configure AEM forms to send out emails with links to AEM Forms Workspace. To know more about the benefits of AEM Forms Workspace over (Deprecated for AEM forms on JEE) Flex Workspace, see this article.

In administration console, click Home > Services > forms workflow > Server Settings > Task Notifications.
Open task assignment template.
Set the template in the task notifications to the following: https://@@notification-host@@:8080/lc/libs/ws/index.html?taskId=@@taskid@@
https://@@notification-host@@:8080/lc/libs/ws/index.html?taskId=@@taskid@@

Configuring notifications for users and groups

On the Task Notification page, you can configure templates that forms workflow will use to generate the email notifications that are sent to users and groups. You can customize and format the notifications using forms workflow variables.

You configure the following types of notifications for users and groups:

reminders
task assignments
deadlines

To generate email notifications for a group, specify an email address for the group in User Management. When forms workflow sends an email notification to a group, each member within the group who has an email address specified receives the email notification. When a member of the group receives an email notification and wants to claim the task, the member must click the claim link in the email notification, which opens the task details page in Workspace. From there, the member can either claim or claim and open the work item.

NOTE

The Flex Worksapce is deprecated for AEM forms release.

Configure reminders for users or groups

You can send reminder notifications to the assigned user or group when a deadline to complete a task is approaching. The rules for determining exactly when a reminder notification is sent are determined by the process developer.

In administration console, click Services > Forms workflow > Server Settings > Task Notifications.
Under Notification Type, click Reminder (for users) or Group - Reminder (for groups).
Select Enable Reminder or Enable Group - Reminder.
(User notifications only) To include an attachment of the form and its data with the reminder email message, select Include Form Data.
In the Subject box, type the text for the subject line of the email message. This field is prepopulated with default text. For details about customizing this field, see Customizing the content of notifications.
In the Notification Template box, type the text for the body of the email message. This field is prepopulated with default text. For details about customizing this field, see Customizing the content of notifications.
In the Message Format list, select the format that the email message is sent in, either HTML or Text. The default format is HTML.
In the Email Encoding list, select the encoding format to use for the email message. The default is UTF-8, which most users outside of Japan will use. Users in Japan may select ISO2022-JP.
Click Save.

Configure task assignment notifications for users or groups

You can send task assignment notifications to a user or group when they are assigned a task.

In administration console, click Services > Forms workflow > Server Settings > Task Notifications.
Under Notification Type, click Task Assignment for users or Group - Task Assignment for groups.
Select Enable Task Assignment for users or Enable Group - Task Assignment for groups.
(User notifications only) To include an attachment of the form and its data with the task assignment email message, select Include Form Data.
In the Subject box, type the text for the subject line of the email message. This field is prepopulated with default text. For details about customizing this field, see Customizing the content of notifications.
In the Notification Template box, type the text for the body of the email message. This field is prepopulated with default text. For details about customizing this field, see Customizing the content of notifications.
In the Message Format list, select the format that the email message is sent in, either HTML or Text. The default format is HTML.
In the Email Encoding list, select the encoding format to use for the email message. The default is UTF-8, which most users outside of Japan will use. Users in Japan may select ISO2022-JP.
Click Save.

Configure deadline notifications for users or groups

You can send deadline notifications to users and groups when the deadline to act upon an assigned task has passed. A deadline notification is usually informational because the user can no longer act upon the assigned task.

In administration console, click Services > Forms workflow > Server Settings > Task Notifications.
Under Notification Type, click Deadline (for users) or Group - Deadline (for groups).
Select Enable Deadline or Enable Group - Deadline.
In the Subject box, type the text for the subject line of the email message. This field is prepopulated with default text. For details about customizing this field, see Customizing the content of notifications.
In the Notification Template box, type the text for the body of the email message. This field is prepopulated with default text. For details about customizing this field, see Customizing the content of notifications.
In the Message Format list, select the format that the email message is sent in, either HTML or Text. The default format is HTML.
In the Email Encoding list, select the encoding format to use for the email message. The default is UTF-8, which most users outside of Japan will use. Users in Japan may select ISO2022-JP.
Click Save.

Hide the DO NOT DELETE tag for all emails

You can configure email to hide to the DO NOT DELETE tracking tag in all emails send in a human-centric process.

Configuring notifications for administrators

You can configure templates that forms workflow will use to generate the email notifications that are sent to administrators.

You configure the following types of notifications for administrators:

stalled branch
stalled operation

Configure stalled branch notifications

If a branch stalls (stops proceeding either deliberately or because of an error), you can have an email notification sent to an administrator or another user, who can then investigate the problem.

In administration console, click Services > Forms workflow > Server Settings > Administrator Notifications.
Under Notification Type, click Stalled Branch.
Select Enable Stalled Branch.
In the Email Address box, type the addresses of the users to notify when a branch stalls. Use the format user@domain.com and separate each address with a comma. Typically, this email address is for an administrator.
In the Subject box, type the text for the subject line of the email message. This field is prepopulated with default text. For details about customizing this field, see Customizing the content of notifications.
In the Notification Template box, type the text for the body of the email message. This field is prepopulated with default text. For details about customizing this field, see Customizing the content of notifications.
In the Message Format list, select the format that the email message is sent in, either HTML or Text. The default format is HTML.
In the Email Encoding list, select the encoding format to use for the email message. The default is UTF-8, which most users outside Japan use. Users in Japan may select ISO2022-JP.
Click Save.

Configure stalled operation notifications

If an operation stalls (stops proceeding either deliberately or because of an error), you can have an email notification sent to an administrator or another user, who can investigate the problem.

In administration console, click Services > Forms workflow > Server Settings > Administrator Notifications.
Under Notification Type, click Stalled Operation.
Select Enable Stalled Operation.
In the Email Addresses box, type the addresses of the users to notify when an operation stalls. Use the format user@domain.com and separate each address with a comma. Typically, this email address is for an administrator.
In the Subject box, type the text for the subject line of the email message. This field is prepopulated with default text. For details about customizing this field, see Customizing the content of notifications
In the Notification Template box, type the text for the body of the email message. This field is prepopulated with default text. For details about customizing this field, see Customizing the content of notifications.
Click Save.

Customizing the content of notifications

The Task Notifications and Administrator Notifications pages provide several features that enable you to customize notification messages:

rich text editor
variable picker
URL generation

Rich text editor

The Notification Template area is a rich text editor that enables you to generate HTML for the email notification messages. It provides font and paragraph formatting options, which are found below the Notification Template box. The options include font type, size, style, and color, and paragraph alignment and bullets.

URL generation

For Task Notifications only, Forms workflow includes two predefined URL configurations that you can drag from the Url Generation list into the Notification Template box and then customize:

OpenTask is available for the Reminder and Task Assignment notification types. This URL provides a link to the task in Workspace, allowing the user to access the task quickly from the email notification. When you drag the OpenTask URL to the Notification Template box, the URL is in the following format:

https://@@notification-host@@:<PORT>/workpace/Main.html?taskId=@@taskid@@
ClaimTask is available for the Group - Reminder and Group - Task Assignment notification types. This URL provides a link to the task details page in Workspace, where the user can either claim or claim and open the work item. When you drag the ClaimTask URL to the Notification Template box, the URL is in the following format:

https://@@notification-host@@:<PORT>/workpace/Main.html?taskId=@@taskid@@

NOTE

The Flex Worksapce is deprecated for AEM forms release.

If your solution is deployed in a clustered environment, replace @@notification-host@@ with the cluster address.

<PORT > is the port number of the HTTP listener for the application server. The default HTTP listener port for the supported application servers are as follows:

JBoss: 8080

Oracle WebLogic Server: 7001

IBM WebSphere: 9080

To make these URLs function correctly, replace <PORT > with the port number that is appropriate for your environment.

NOTE

If you are using a custom web application other than Forms to provide users with access to the tasks, you must instead use a URL format that is appropriate for your custom application.

Variable picker

The Variable Picker list provides useful variables that you can drag-and-drop into the Subject or Notification Template boxes. When you drop a variable in the Subject or Notification Template boxes, it changes to the actual forms workflow variable name with two @ symbols on either side of it, for example, @@taskid@@.

For reminders, task assignments, and deadlines for users and groups, you can use the following variables in the Subject and Notification Template boxes:

description The contents of the Description property, as defined in the user step (start point, Assign Task operation, or Assign Multiple Tasks operation) of the process in Workbench.

instructions The contents of the Task Instructions property, as defined in the user step of the process in Workbench.

notification-host The host name of the AEM forms application server .

process-name The name of the process.

operation-name The name of the step.

taskid The unique identifier for the current task.

actions Produces a numbered list of valid routes (for example, Approve, Reject) that the recipient can click.

In addition, for group reminders, group task assignments and group deadlines, you can also use:

group-name The name of the group that is assigned the work item.

NOTE

If a variable has no value, nothing is returned.

For stalled branches, you can use the following variables in the Subject and Notification Template boxes:

branch-id The branch identifier.

process-id The process instance identifier.

notification-host The host name of the AEM forms application server .

For stalled operations, you can use the following variables in the Subject and Notification Template boxes:

action-id The operation identifier.

branch-id The branch identifier.

process-id The process instance identifier.

notification-host The host name of the AEM forms application server .

Using a variable in the Subject box

If you type the following text in the Subject box for Task Assignment notifications:

Please complete task @@taskid@@

The user receives an email message with the following subject if they are assigned task 376:

Please complete task 376

Using variables in the Notification Template box

If you type the following text in the Notification Template box for Stalled Branch notifications:

Branch @@branch-id@@ has stalled! You have received this notification from @@notification-host@@.

The administrator receives an email message that contains the following content if the branch number is 4868 and the server name is ServerXYZ:

Branch 4868 has stalled! You have received this notification from ServerXYZ.

Configuring Business Activity Monitoring connections

Business Activity Monitoring, an optional module, provides a set of operational dashboards that provide real-time visibility into your operations and key performance indicators.

On the BAM Configuration Settings page, you set the connections to the server that runs BAM so that process-related events can be tracked and transmitted to that server.

In administration console, click Services > Forms workflow > Server Settings > BAM Configuration Settings.
In the BAM Host box, type the name of the server that runs BAM. The default is localhost.
In the BAM Port box, type the port to be used to connect to the server that runs BAM. The default BAM port for JBoss is 8080, WebLogic is 7001, and WebSphere is 9080.
In the Server Host box, type the name or IP address of the host Forms Server. The default value is localhost.
In the Server Port box, type the port number used by the Forms Server.
In the User Name and Password boxes, type the appropriate user ID and password to access the BAM Server. The default user name is CognosNowAdmin and the default password is manager.
Click Save.

recommendation-more-help