Form Actions
Actions can be assigned to buttons and grid columns on a NIM app. These actions instruct NIM to perform various actions, such as navigating to a different form, refreshing the app, or submitting data to a target system. Actions are executed in descending order.
Add a Form Action to a button
To add a form action to a button, follow these steps:
Drag a button onto the form workspace
Select the button
Click on the Actions tab
Click +Add
Select the desired action and click Save
Repeat steps 4 and 5 as necessary to add more actions
Add a Form Action to a grid column
To add a form action to a grid column, follow these steps:
Drag a grid onto the form workspace
Select the grid
Under the Table column, configure the grid to use a filter
Click on the Actions tab
Under Events, choose which column's Click event you'd like to add the action to
Click +Add
Select the desired action and click Save
Repeat steps 5-7 as necessary to add more actions
Actions
Below is a list of form actions available inside of NIM.
Idle
The "idle" action is the default placeholder for all newly-added actions. Nothing happens when an idle action is executed.
Restart App
The "restart app" action refreshes a NIM app and returns the end user back to the app's initial form. Any data already entered into the form will be erased.
Start App Action
The "start app" action will initialize another app of your choice. The end user will be navigated away from the current app and into the target app. Any data entered into the first form will be cleared.
Form Initialize Action
The "form initialize" action will refresh the current form of the app. This may be useful if the end user wants to retrieve updated information inside the current form, for example from a filter tied to a grid item.
Target System Function Execution
This activity launches an action inside a target system (e.g., Active Directory, Google Workspace, SQL, etc.). Such activities may include creating or editing a user account, inserting a new database record, and more.
Script Function Execution Action
This action executes a custom NIM script function. See the Scripts article for more information.
Service Resource Command Action
This action is used to launch NIM system actions. Options include collecting data from a system, running a job, or launching a scheduled task.
Grid Drag-and-Drop Reset Action
This action resets the state of two drag-and-drop grids. For example, if rows were moved from Grid A into Grid B, or vice-versa, the rows would be moved back to their original grid.
Grid Drag-and-Drop Update Action
This action moves the selected record from one specified drag-and-drop grid to another. In order to move records back and forth, each grid will need their own button with this action.
Reset Variable Action
This action will clear the value of the specified variable.
Set Grid View Action
This action allows you to set the view of a to any one of its configured views. This is useful for providing a means to navigate through filtered data; for example, clicking on the name of a user in one grid and seeing another grid (or the same one) update with that users' data from a second filter.
Generate Password Action
The "generate password" action will cause the app to run the associated password generator to create a new password value.