Defining Object Actions¶
Available Liferay 7.4 U33+ and GA33+
With Liferay Objects, you can define actions that are triggered under specified conditions. While an action is active, Liferay listens for when an Object’s data is added, deleted, or updated and then performs the set action.
Currently, Liferay supports four action types:
Webhook actions deliver a payload to a URL.
Groovy Script actions execute custom Groovy scripts.
Notification actions send email notifications using a predefined template.
Add an Object Entry actions create entries in an active Object.
Follow these steps to define actions for an Object:
Open the Global Menu (
), click on the Control Panel tab, and go to Objects.Select an existing Object or create a new one.
Note
Beginning with Liferay DXP 7.4 U22, you can add actions to system Objects.
While viewing the Object, select the Actions tab and click the Add button (
).In the Basic Info tab, enter a name and description for the action.
Go to the Action Builder tab to define a custom trigger, conditions, and action.
For Trigger, determine when the action is performed.
Trigger
Description
On After Add
When an Object entry is added
On After Delete
When an Object entry is deleted
On After Update
When an Object entry is updated
(Optional) After selecting a trigger, you can use expressions to set additional conditions for the trigger. Click the Code button (
) to view available expressions. 
For Liferay 7.4 U33+ and GA33+, Liferay checks your expression for valid syntax when you click Done. If the expression is invalid, Liferay displays an error message.
For Action, select the type of action performed and fill out all additional fields. See Understanding Action Types for more information.
Click Save.
Once created, the action is active and triggered according to your configuration.
If desired, you can deactivate an action by going to its Basic Info tab, toggling the Active switch, and clicking Save.
Understanding Action Types¶
Webhook Actions¶
Available Liferay 7.4+
Webhook actions deliver a data payload to a set URL. When you select this action type, you must enter the target URL. If applicable, you can also enter a secret.
Groovy Script Actions¶
Available Liferay 7.4 U27+ and GA27+
Groovy Script actions execute custom Groovy scripts. When you select this action type, enter your script into the provided code window. For Liferay 7.4 U33+ and GA33+, Liferay uses the GroovyShell class to check your Groovy scripts for valid syntax when you click Save. If the script is invalid, Liferay displays an error message.
Notification Actions¶
Available Liferay 7.4 U32+ and GA32+
Use Notification actions to automate email notifications for Object events. To use this action type, your instance must have a configured mail server and at least one notification template.
When you select this action type, you must select a notification template. This template determines the sender, recipient, and content for each email.
Add an Object Entry Actions¶
Available Liferay 7.4 U33+ and GA33+
Add an Object Entry actions create entries in a specified Object. When you select this action type, you must choose an active Object. If the Object includes any required fields, you must also set predefined values for the new entries. You can enter these values directly or use expression builder to set values dynamically. If desired, you can also set values for non-mandatory fields.
