AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.
The Server Settings page provides access to various settings for forms workflow:
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.
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.
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.
If you enter incorrect information, you can click Cancel to go back to the previously displayed page.
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@@
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:
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.
The Flex Worksapce is deprecated for AEM forms release.
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.
You can send task assignment notifications to a user or group when they are assigned a task.
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.
You can configure email to hide to the DO NOT DELETE tracking tag in all emails send in a human-centric process.
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:
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.
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.
The Task Notifications and Administrator Notifications pages provide several features that enable you to customize notification messages:
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, as well as paragraph alignment and bullets.
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@@
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.
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.
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.
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 .
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
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.
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.