Miracle Mobile Forms allows form designers to control a user's experience within the apps they create. One of the ways of doing this is by setting category-level permissions. 


As a form designer, you can use users' roles to set access rights to the categories in your application. For example, you can restrict the access to a category featuring high-level reports and financial stats to Senior Management. Without this restriction, the category and its forms/pages will be available to all users regardless of their designation. 


With the help of the following steps, you can easily set separate permissions to view and interact with a certain category in your app. 


Step 1 - Open the Category You Wish to Configure

To change the access permissions of a category, follow these steps:

  • From Miracle Studio, click on Categories from the left sidebar. 
  • Click on the Edit button associated with the category. Alternatively, you can click on the category's name. 



Step 2 - Set the Visibility of the Category

Once the category's settings are open, scroll a little to the Permissions section (shown below). 


From this section, you can define who views this category by either using an expression or mentioning the user's role. Keep in mind that this doesn't mean app users can make any changes to the forms within the category. 


That said, here's how you define the visibility of your categories. 

  • First, select 'Only following users have the permission to view this category'. 
  • Under 'Users for whom this condition gets true', type a condition in the form of an expression to define who can view this category. For instance, if you wish for the category to be shown to a user whose display name is Matt Reeves, you can use the expression Login.DisplayName = "Matt Reeves".
  • If you don't wish to use an expression and have the User Management Connector configured, you can simply add user roles in the text box under 'Users who belong to any of these roles'. 
  • Click 'Save' if you don't wish to define who can use the forms in this category. Otherwise, continue to the next step. 


Step 3 - Define Who Interacts with the Category

If you wish to allow Miracle Mobile App users to view your category and make changes to it, you need to do the following:

  • Click on the checkbox next to 'Only following users have the permission to interact with this category '. 
  • In the textbox below 'Users for whom this condition gets true', type an expression.  
  • Alternatively, add user roles in the text box under 'Users who belong to any of these roles'. 
  • Click 'Save'. 


Need more help? Contact us at support@miracletek.com.au