• Configure actions to associate to a panel's image
• Configure action confirmation for function execution
• ZML implementation for action confirmation

To configure a button action,

1. Edit your app.
2. Select the required page from the accordion menu on the top-left corner, or from the application preview in the middle. You'll be taken to its  Design  page.
3. Click on the device icon to navigate to the  Design  view of the device of your choice.
   

   

4. Hover in the middle and click  Open Page Builder .
5. Click to select a panel that holds the button you want to configure action for.
6. Click the  Configure  option in the toolbar in the header area of the page builder. The  Panel configuration  pane slides in.
7. Click to select the button inside the panel.
8. Select  Action  from the configuration options on the right.
   

   

9. Choose from the options:
   
   • None : Use this option to remove any action associated previously.
   • Open url : Opens a given URL in a specified target window.
     
     • To configure Open URL action:
       
       • Select  Open url .
       • Enter a  URL  you want to open in the space provided below.
       • Select a target window from the  Open in  dropdown. 
   • Open form : Opens a specified form. You can select a form from any application in your account.
     
     • To configure Open form action:
       
       • Select  Open form .
       • Select Form  to associate to the button.
         

         Note:  The  Form  dropdown lists all the forms in the application you are currently working on. To select a form from another application, click the  Change App  option give in Blue, on the footer of the   Form  dropdown. Select another application and click  Done  to view all the forms in it. 

       • Enter a  Query Parameter
         
         .
         

         Adding a query parameter to an Open Form action, loads the associated form with pre-filled values, for the fields specified in the parameter string. You can pass multiple parameters, separating each using the  &  (amp) symbol.
         Parameter formats:

         1. Field link name=${page parameter name}
         2. Field name=value

           Example:

         

       • Select a target window from the  Open in  dropdown. 
   • Open report : Opens a specified report. You can select a report from any application in your account.
     
     • To configure Open report action:
       
       • Select  Open report .
       • S e lect Report  to associate to the button.
         

         Note:  The  Report  dropdown lists all the reports in the application you are currently working on. To select a report from another application, click the  Change App  option give in Blue, on the footer of the  Report   dropdown. Select another application and click  Done  to view all the reports in it. 

       • Enter a  Query Parameter
         
         .
         

         Adding a query parameter to an Open Report action, loads the associated report based on the criteria specified in the parameter string. You can pass multiple parameters, separating each using the  &  (amp) symbol.
         Parameter formats:

         1. Field link name=${page parameter name}
         2. Field name=value

         URL format for setting Report criteria with Operators other than "=" (Equal) is  FieldName1_op  &  FieldName2_op  

         Refer this  table  for the list of Constants for Operators.

           Example:

         

       • Select a target window from the  Open in  dropdown. 
   • Open page : Opens a specified page. You can select a page from any application in your account.
     
     • To configure Open page action:
       
       • Select  Open page .
       • Select Page  to associate to the button.
         

         Note:  The  Page  dropdown lists all the pages in the application you are currently working on. To select a page from another application, click the  Change App  option give in Blue, on the footer of the  Page  dropdown. Select another application and click  Done  to view all the pages in it. 

       • Enter a  Query Parameter .
         

         Adding a query parameter to an Open Page action, provide values for parameters(associated page parameter) in the page to be opened.

         Parameter formats:
         
         1. Field link name=${page parameter name}
         2. Field name=value

         You can pass multiple parameters separating each using the  ‘&’  symbol.

       • Select a target window from the  Open in  the dropdown. 
   • Execute function : Invokes a custom function, specified in any application of your Zoho Creator account.
     
     • To configure Execute function action:
       
       1. Select  Execute function .
       2. Select a custom function  to associate to the button.
          

          Note:  The  Function  dropdown lists all the custom functions in the application you are currently working on. To select a function from another application, click the  Change App  option in Blue, on the footer of the  Select function  dropdown. Select another application and click  Done  to view all the functions in it. 

       3. Select a  Parameter
          

          You can choose an argument of the selected function, to pass it as a page parameter.

       4. Select when to execute the function workflow:  At Once  or  After Confirmation .
          
          • If you choose  At Once , go to the next step (v).
          • If you choose  After Confirmation , you must specify the  confirmation message  and button text for the  confirm execution  and  cancel execution  buttons.  Learn more
       5. Specify a  Success message  to be displayed, on successful execution of the associated function.
10. You can make the changes and close the  Panel configuration  pane. The changes will be auto-saved.

Confirmation for function execution in buttons

Before executing actions such as deleting certain records, a confirmation for proceeding with it helps ensure you don't delete important records by accident. Sometimes, you may never even realize that a record was deleted or that more than one record was accidentally deleted. In such instances, it is always safe to confirm the action request before execution. 

Here are some of the scenarios where actions can have confirmation before they're executed:

• Deleting
• Approving or Rejecting
• Changing Status
• Sending emails

• Configure action confirmation for execute function
• ZML implementation 

Configure action confirmation for function execution

1. Edit your application
2. Open your page builder and click to select a panel that holds the  button  you want to configure an action for.
3. Click the  Configure  option in the header area of the page builder. A  configuration  pane will slide in.
4. Click to select the  button  inside the panel.
5. Click the  Action  tab and choose  Execute function  from the  Action Type  dropdown on the right.
6. Select a  custom function  and specify the argument value.
7. Click  After confirmation  under the  Execute the workflow  section.
8. Specify the following:
   
   • Confirmation message : The message that will be displayed in the confirmation popup informing users of the action that will take place when they confirm to execute it.
   • Confirmation execution button : The button text that will be displayed to confirm the function execution.
   • Cancel execution button : The button text that will be displayed to cancel the function execution.
     

     

     Note : The default values for the  Confirmation execution  button and  Cancel execution  button will be  Yes  and  No  respectively.
9. The changes will be saved automatically. When you access your page in live mode, the confirmation popup will prompt users before the function is executed.

ZML script for confirmation of function execution

The below script shows how to configure the confirmation popup details such as confirmation message, confirmation execution button, and cancel execution button for the execute function action in the button component:

Related Topics