Main Menu Navigation

The main menu is your central hub for accessing all warehouse operations in Shipedge Warehouse Pro. After signing in, you’ll see a grid of icons representing the features you’re allowed to use based on your user permissions.

Menu Updates Automatically

The menu shows only the features your account has permission to use. If you don’t see a feature, contact your administrator to request access.

Understanding the Main Menu

The main menu displays available warehouse operations as icons in a grid layout. Each icon represents a different warehouse function you can access.

Key features:

• Dynamic loading - Menu items are loaded based on your user permissions
• Icon-based navigation - Tap icons to access different operations
• Permission verification - Features are checked before opening
• Task notifications - Shows pending tasks if available
• Refresh capability - Update menu to reflect permission changes

Menu Layout

The menu displays icons in a 2-column grid:

• Icons are arranged in rows of 2
• Each icon represents a warehouse operation
• Icons are sized to fit your device screen
• Tap any icon to access that feature

Menu Structure:

• Top section: Main operation icons (grid layout)
• Bottom section: Additional controls (refresh, tasks, Bluetooth status)

Available Menu Items

The menu can display up to 14 different operations, each identified by an ID:

Core Operations:

• ID 1: Wall - Wall module functionality
• ID 2: Inventory Control - Bins management and inventory operations
• ID 3: Pick and Pack - Order picking operations
• ID 4: Quality Control - Product and order quality inspection
• ID 5: Cycle Count - Regular inventory counting
• ID 6: Blind Count - Inventory counting without expected quantities
• ID 7: Returns - Process returned items
• ID 8: Replenishment - Move inventory from reserve to picking locations

Additional Operations:

• ID 9: Label Out Verify - Verify labels for outgoing shipments
• ID 10: Label Ready - Label preparation and management
• ID 11: Transfers - Transfer inventory between locations
• ID 12: Project Clock - Time tracking for projects
• ID 13: LPN - License Plate Number management
• ID 14: Load and Move - Manage blocked bins and load/move operations

Not All Items Visible

You’ll only see icons for operations your user account has permission to access. If an operation isn’t shown, you don’t have permission for it.

Navigating the Menu

1. Access the Main Menu

   After successful login, you’re automatically redirected to the main menu. The menu loads with your available features.

2. View Available Operations

   Browse the grid of icons to see which operations you can access. Icons are displayed in a 2-column layout.

3. Select an Operation

   Tap the icon for the operation you want to perform. The app verifies your permission before opening the feature.

4. Wait for Verification

   If permission is verified:

   • You’ll feel a short vibration (20ms)
   • The operation screen opens
   • The menu closes automatically

5. Handle Permission Errors

   If you don’t have permission:

   • You’ll see “Not activated” message
   • The menu refreshes automatically
   • Contact your administrator to request access

Menu Features

Task Notifications

The menu can display task notifications:

• Alert badge appears if you have pending tasks
• Shows task count when tasks are available
• Tap the task icon to view task list
• Tasks are loaded from NotificationService

Task Display:

• Visible when tasks exist and aren’t “Nothing” or “Error internet”
• Hidden when no tasks are available
• Updates automatically when tasks change

Refresh Menu

You can refresh the menu to update permissions:

• Tap the refresh icon (if visible)
• Menu reloads with current permissions
• Useful if permissions were recently changed

Refresh Process:

• Verifies device activation
• Reloads user permissions from server
• Updates menu display with current access

Bluetooth Status

The menu shows Bluetooth scanner connection status:

• Connected - Scanner is paired and ready
• Disconnected - No scanner connected
• Access Bluetooth settings from menu options

Menu Options

Access additional menu options from the overflow menu (three dots):

Scanner:

• Opens Bluetooth scanner selection
• Connect or change Bluetooth scanner
• See available paired devices

Manual:

• Disconnects Bluetooth scanner
• Switches to manual input mode
• Use device keyboard for data entry

Permission Verification

Before opening any operation, the menu verifies:

Device Activation:

• Checks if device is activated in system
• Verifies connection to server
• Shows error if device not activated

User Permissions:

• Confirms you have permission for selected operation
• Checks against Users.activity array
• Blocks access if permission missing

Error Messages:

• “Not activated” - You don’t have permission for this feature
• “No connection to internet” - Cannot verify permissions
• “Out of service” - Service unavailable
• “Please contact your supplier to active your device” - Device needs activation

Navigation Behavior

Opening Operations:

• Menu closes when operation opens (finish() called)
• Previous menu state is not saved
• Return to menu by closing the operation

Back Button:

• Pressing back from menu logs you out
• Stops notification service
• Returns to login screen

Activity Lifecycle:

• Menu checks activation on resume
• Updates task notifications periodically
• Refreshes when returning from operations

💡 Best Practices

Check Permissions First

If you don’t see an operation you need, check with your administrator before troubleshooting. Permissions are server-controlled.

Use Task Notifications

Pay attention to task notifications. They alert you to pending work that needs attention.

Refresh When Needed

If permissions were recently updated, use the refresh option to reload the menu with current access.

Understand Icons

Familiarize yourself with operation icons. Each icon represents a specific warehouse function you can access.

Troubleshooting Menu Issues

Menu Shows “Nothing”

Problem: Menu displays “Nothing” message

Solutions:

• Your account has no activity permissions assigned
• Contact your WMS administrator to activate activities
• Verify your login was successful

Can’t Access an Operation

Problem: Tap an icon but see “Not activated” message

Solutions:

• You don’t have permission for that operation
• Contact administrator to request access
• Menu will refresh automatically
• Try refreshing menu manually if permissions were updated

Icons Missing

Problem: Expected operations don’t appear in menu

Solutions:

• Verify you have permissions for those operations
• Check with administrator about your access level
• Refresh menu to reload permissions
• Some operations may be disabled for your warehouse

Task Notifications Not Showing

Problem: Tasks exist but notification badge doesn’t appear

Solutions:

• Check that tasks aren’t “Nothing” or “Error internet”
• Verify notification service is running
• Refresh menu to update task status
• Check server connection

Bluetooth Status Issues

Problem: Bluetooth status incorrect or can’t connect scanner

Solutions:

• Use menu options to access Bluetooth settings
• Verify Bluetooth is enabled on device
• Check scanner is paired
• See Bluetooth Scanner Setup for detailed help

Menu Refresh Process

When you refresh the menu:

1. Activation Check:

• Verifies device activation with server
• Checks user permissions
• Updates activity list

2. Menu Reload:

• Clears current menu display
• Reloads icons based on permissions
• Updates task notifications

3. Error Handling:

• Shows connection errors if server unreachable
• Displays activation errors if device not activated
• Handles permission errors gracefully

Technical Details

Activity Class: AppMenu.java

Layout: R.layout.newmenu (TableLayout with TableRows)

Menu Loading:

• Method: loadMenu()
• Checks Users.activity array
• Creates ImageView for each permission
• Arranges in 2-column grid

Permission IDs:

• Stored in MyActivity.java as static integers
• Mapped to activity IDs (1-14)
• Verified before navigation

Navigation:

• Uses Intent to start Activities
• Passes userId as extra
• Calls finish() to close menu
• Sets NotificationService.fromActivity="Other"

Refresh Method:

• refreshActivity() - Reloads menu
• progressBallUserIdAsync(1000) - Checks activation
• Recreates menu with updated permissions

Back Button:

• onBackPressed() - Logs out
• Stops NotificationService.bucle
• Returns to login screen

---

Next: Bluetooth Scanner Setup or explore specific operations like Replenishment or Picking