Mendix uses visual models called microflows to define the logic of your application. A microflow is a visual way of expressing what traditionally would be written in code. This how-to explains how you can create a custom save button on a detail page by utilizing microflows.
This how-to will teach you how to do the following:
- Create a custom Save button
Before starting with this how-to, make sure you have completed the following prerequisites:
- Create a basic data layer (for details, see How to Create a Basic Data Layer)
- Create overview and detail pages for the customer object (for details, see How to Create Your First Two Overview and Detail Pages)
- Create a menu item to access the customer overview page (for details, see How to Set Up the Navigation Structure)
3 Replacing the Default Save Button with a Custom Save Button
To replace the default Save button with a custom one, follow these steps:
Open the Customer detail page, which should look like this:
- Right-click the Save button and remove it by selecting Delete.
Right click the Cancel button and select Add button left > Microflow:
Double-click the new Microflow button to open its properties:
- Change the Caption to Save.
- Change the image to an image of your choice.
- In the Events section, click Select… to add a new microflow with the name Customer_Save.
- Click OK to save the new microflow button.
4 Re-creating the Default Save Behavior
Right-click the new Microflow button and select Go to microflow to open the new microflow:
The Microflow should look like this:
- Open the Toolbox from the bottom-right corner of the Modeler: You can also open it from the View menu:
- Drag a Commit object(s) action from the Toolbox to the line between the green start and red end events, which will insert a commit action activity.
- Double-click the new activity to open its properties:
- In the Input section, select Customer for Variable and click OK. The microflow should now look like this:
- Drag a Close page action from the Toolbox to the line between the green start and red end events, which will insert a close page action activity. You have now re-created the default save behavior, and the m should look like this:
5 Extending the Microflow with Your Own Functionality
- Drag a Show message action from the Toolbox to the line between the start and end events, which will insert a show message action activity.
Double-click the new activity to open its properties:
- Select the Type of message.
- Enter a message as a Template value.
- Click OK to save the properties. The microflow should now look like this:
6 Related Content
- How to Define Access Rules Using XPath
- How to Trigger Logic Using Microflows
- How to Extend Your Application with Custom Java
- How to Work With Lists in a Microflow
- How to Optimize Retrieve Activities
- How to Configure Error Handling
- How to Optimize Microflow Aggregates
- How to Extract and Use Submicroflows
- Button Widgets
- Create Button
- Microflow Activities