Opadeez Help Center

Your First Application - Part 2

Creating Menu Bar and Security Access

In Part 1, we created a basic system with user authentication. Now we'll add a menu bar and configure security access to make the application functional for users.

Current Status: When you login to the Customer Database solution, you don't have access to any functionalities or menu bar. This is normal - we haven't created a menu structure yet!

Step 1: Create the Default Menu

Back in the Studio, we need to create a menu structure for our application:

  1. Navigate to User Interface → Menus
  2. Click "Create a new Menu Item"
  3. This will be the parent menu holding all functionalities accessible by users
  4. Set the Menu name: Default menu
  5. Save your changes

Step 2: Configure System Default Menu

  1. Go back to the "System Information" page
  2. In the "Default menu" setting, select "Default menu" from the dropdown
  3. If the menu doesn't appear in the list, click "Save all" first to make it available
Note: The Default Menu must be saved before it becomes available in the dropdown list.

Step 3: Create Security Menu Item

Now we'll create a "Security" menu entry that reuses the menu definition from the User Management solution:

  1. Navigate back to User Interface → Menus
  2. Click "New Menu item"
  3. Configure the menu item:
    • Menu name: Security
    • Call another menu: UM.Security
      This tells the menu to replicate the User Management "Security" menu functionalities
    • Id: 1
      Used to associate menu items with access rights (more details on this below...)
    • Depth: 1
      Creates the correct hierarchy level
Security Menu Configuration

Security menu item configuration showing the UM.Security reference and access settings

  1. Save your changes

Step 4: Deploy and Test the Menu

  1. Go back to the System Information page
  2. Click "Deploy System"
  3. Wait for deployment completion
  4. Login to the runtime application
Success! You now have a menu bar after login with:
  • Security: Pre-built User Management menu with Users and Groups maintenance
  • Logout: Button to close your session

Step 5: Configure System Properties for Access Rights

When you try to use the Groups Maintenance menu, you'll see this warning:

WARNING: your solution has no MENU_OPTIONS system property

This happens because the User Management solution provides flexibility to create custom access rights. We need to define these:

  1. In the Studio, from the System Information page, click "Edit System Properties"
  2. Create a new property:
    • Property name: MENU_OPTIONS
    • Value: Security,Customer read,Customer write
  3. Save the property
Remember: We used Id "1" for the Security module. This means it's the first security option in our MENU_OPTIONS definition. So "Customer read" access right will be Id 2, and "Customer write" will be Id 3.

Step 6: Deploy and Configure Groups

  1. Save and deploy the solution again
  2. Login to the runtime solution
  3. Go to Security → Groups Maintenance
  4. Click "Create a Group" and configure:
    • Group Name: Admin
    • Allowed Menus: Select all 3 options
    • Click "Save"
Access Rights Model: In the User Management solution, access rights are defined at Group level, and each User belongs to one group. This is a simple but fully customizable implementation.

Step 7: Assign Users to Groups

  1. Go to Security → Users Maintenance
  2. You'll see the existing default root user
  3. Select the root user and associate it with the "Admin" group
  4. This gives the root user access to all solution functionalities

Testing and Experimentation

Feel free to experiment with the security system:

Congratulations! You now have a fully functional menu system with security access controls.

What's Next?

This completes Part 2 of the tutorial. Continue with:

Key Concepts Learned

Pro Tip: Always test your security configuration with different user accounts to ensure access rights work as expected.