Action Item Object

Action Items are used to execute Lua scripts to perform actions within the system. The Lua API in AspenTech Inmation OT DataFabric allows you to fully customize the system environment to your needs. Action Items are incredibly versatile objects acting as one of the key tools of the Lua scripting engine and are essential to creating automated tasks and customizing your system.

Action Items are created in the I/O Model.

Use Cases

  • Execute an embedded Lua script to perform actions on demand (create objects, set properties etc.).

  • Perform calculations using data from other items in the system.

  • Perform an action via Lua script when triggered by a referenced item.

Create Object

By default, the functionality of newly created objects in the IO Model will be executed by the same Node as the functionality of the object under which they are created. If the functionality of the newly created object shall be executed on a different Node, open the System Model tab, right-click the Node where the functionality of the new Action Item object shall be executed and select Copy Full Path. Make sure to keep the path in the clipboard as it will be needed in a later step, or take a note somewhere.
Make sure to paste this path into the Owner property in the Common before clicking Create below.

1 Connect WebStudio to the Admin Node and open the System Config App.

2 Open the I/O Model tab and select a suitable parent object for which the new Action Item object shall be created.

3 Right-click this object and select Admin  New to open the Create Object Wizard.

4 In the Available Object Types List, expand the Data Processing section and select Action Item.

5 In the Common section, provide an Object Name and, optionally, a Description.

6 Click on the Lua Script Body …​ to open a script editor and enter:

return "Hello, world!"

7 Then, click OK to return to the Create Object Wizard

8 Click Create to create the Action Item object in the I/O Model.

Further Reading

For further examples of how Action Items work, both alone and in combination with other objects, please visit: