Add New Tile to Dashboard

Overview

📋 Version Requirement: The mobile-shared-data-from mechanism was introduced in Maximo Application Suite (MAS) version 9.2.0. Ensure your environment is running MAS 9.2.0 or later to use this feature.

📚 For comprehensive details on cross-app data sharing, see the Cross-App Datasource Sharing Guide which covers multiple fallback sources, schema requirements, and advanced patterns.

What is a Dashboard Tile?

• Adding work order count tiles to dashboard
• Creating asset status tiles
• Building inspection count tiles
• Displaying material request counts
• Showing purchase order status

• Understanding of datasources
• Knowledge of mobile QBE filters
• Familiarity with cross-app datasource sharing
• Familiarity with dashboard application structure

Why Use mobile-shared-data-from with mobile-qbe-filter?

• ✅ Memory Efficient: Prevents duplicate data downloads across apps
• ✅ Faster Loading: Reuses data already downloaded by other mobile apps
• ✅ Filtered Data: QBE ensures only relevant records are counted
• ✅ Reduced Network Usage: No additional server calls needed

Implementation

Step 1: Identify the source datasource from another mobile app

• Technician App (techmobile): Work orders
• Inspection App (inspection): Inspection results
• Material Request App (materialrequest): Material requests
• Service Request App (srmobile): Service requests
• Inventory Receiving App (irmobile): Purchase orders
• Inventory Transfer App (itmobile): Reservations
• Inventory Counting App (icmobile): Count books

Step 2: Create datasource with mobile-shared-data-from and mobile-qbe-filter

<maximo-datasource 
  id="dspolist" 
  download-page-size="900" 
  page-size="1" 
  offline-immediate-download="true" 
  object-structure="MXAPIPO" 
  controller="DataController" 
  selection-mode="none" 
  saved-query="IROPENPOMOBILE" 
Copy to clipboardCopied!

• mobile-qbe-filter="{{'receipts_maxvalue': '=NONE'}}": Filters to show only POs not received
• mobile-shared-data-from: References the source app (irmobile) and datasource (executionPODS)
• page-size="1": Minimal page size since we only need the count
• controller="DataController": Required for computed attributes like computedTotalRecords
• include-counts="true": Enables count computation
• <qbe> element: Additional QBE filtering (optional, complements mobile-qbe-filter)

Step 3: Add dashboard tile to page

<page id="dashboardpage" title="Dashboard" controller="DashboardController">
  <dashboard id="dsdash1" use-with-mobile="true">
    
    <!-- POs to be received tile -->
    <dashboard-value-tile 
      id="dsdash1_t6" 
      datasource="dspolist" 
      size="smallwide" 
      value-field="computedTotalRecords" 
Copy to clipboardCopied!

Complete Example

<?xml version="1.0" encoding="UTF-8"?>
<maximo-application id="dashboardmobile" title="Dashboard" version="9.2.4.0">
  
  <!-- Tile 1: POs not received -->
  <maximo-datasource 
    id="dspolist" 
    download-page-size="900" 
    page-size="1" 
    offline-immediate-download="true" 
Copy to clipboardCopied!

mobile-qbe-filter Examples for Memory Management

Example 1: Filter by Exact Value

mobile-qbe-filter="{{'receipts_maxvalue': '=NONE'}}"
Copy to clipboardCopied!

Example 2: Filter by Status (Exclude Multiple)

mobile-qbe-filter="{{'status_maxvalue': '!=COMP,CAN,CLOSE,WAPPR'}}"
Copy to clipboardCopied!

Example 3: Filter by Priority Range

mobile-qbe-filter="{{'wopriority': '<=2'}}"
Copy to clipboardCopied!

Example 4: Multiple Filters Combined

mobile-qbe-filter="{{'status_maxvalue': '!=COMP,CAN,CLOSE', 'wopriority': '<=3'}}"
Copy to clipboardCopied!

Example 5: Filter with Specific Status Values

mobile-qbe-filter="{{'status_maxvalue': '!=COMPLETED, CAN, REVIEW', 'historyflag': '!=true'}}"
Copy to clipboardCopied!

Finding Source Datasources

Validation & Testing

1. Check data sharing is working:

   • Install both source app (e.g., Inventory Receiving) and dashboard app
   • Open source app first and let it download data
   • Open dashboard app
   • Verify tile displays count without additional network calls
   • Check browser DevTools Network tab

2. Test mobile-qbe-filter:

   • Verify tile shows only filtered records
   • Check count matches filter criteria
   • Compare with source app’s filtered count

3. Test offline mode:

   • Load source app while online
   • Enable airplane mode
   • Open dashboard app
   • Verify tile displays data from shared source

4. Monitor memory usage:

   • Open DevTools Memory tab
   • Verify no duplicate data in memory
   • Check page-size limits are respected (page-size=“1” for count-only tiles)

• Issue: Tile shows 0 or no data

  • Cause: Source app not installed or data not downloaded
  • Solution: Ensure source app is installed and has downloaded data first

• Issue: “Object structure mismatch” error

  • Cause: Datasource uses different object-structure than source
  • Solution: Verify object-structure matches exactly (case-sensitive)

• Issue: Wrong app-id or datasource-id

  • Cause: Incorrect reference to source datasource
  • Solution: Check source app’s app.xml for correct IDs

• Issue: mobile-qbe-filter not working

  • Cause: Incorrect filter syntax or field names
  • Solution: Verify field names exist in object structure schema

• Issue: computedTotalRecords not showing

  • Cause: Missing controller=“DataController” or include-counts=“true”
  • Solution: Add both attributes to datasource

Best Practices

• Use mobile-shared-data-from to reuse data from other mobile apps
• Apply mobile-qbe-filter to limit records for memory management
• Set page-size="1" for count-only tiles (no need to load all records)
• Use controller="DataController" for computed attributes
• Set include-counts="true" to enable count computation
• Add computedTotalRecords attribute to schema for tile display
• Test with source app installed and data downloaded
• Document which source apps are required

• Reference non-existent app-id or datasource-id
• Use different object-structure than source datasource
• Forget to install source app during testing
• Skip mobile-qbe-filter (loads all shared data unnecessarily)
• Forget to add computed attributes to schema when required
• Set large page-size for count-only tiles

• Always use mobile-qbe-filter to limit records
• Filter out completed/closed records when not needed
• Use page-size="1" for tiles that only display counts
• Set appropriate download-page-size based on expected data volume
• Test on actual mobile devices to verify memory usage

Related Resources

• Datasources Guide - Understanding datasources
• FAQ - How to filter with datasource
• Dynamic Mobile QBE Filter - Dynamic filtering

• Client-side Datasource Filtering - In-memory filtering
• Add Dashboard Tile - Advanced - Complex scenarios with DataController

• Add Dashboard Tile - Advanced - For scenarios requiring all records or complex processing

Summary

• ✅ Another mobile app already downloads the data you need
• ✅ You can filter data with mobile-qbe-filter (no complex logic needed)
• ✅ You only need to display counts (use page-size=“1”)
• ✅ Memory optimization is a priority
• ✅ You want to avoid duplicate data downloads