Migration

Infor Ming.le Homepage Development Guide

Infor Ming.le is the user experience platform that provides the unified homepage, social collaboration, and context application framework for all CloudSuite products. Custom Ming.le homepages allow organizations to create role-based landing pages with widgets displaying real-time CSI data, KPI dashboards, task lists, and quick-action links. This guide covers homepage development from widget creation through production deployment.

Homepage Architecture and Widget Framework

Ming.le homepages are composed of widget containers arranged in a responsive grid layout. Widgets are HTML5/JavaScript applications hosted within Ming.le iframes that communicate with the platform through the Ming.le Widget SDK (infor.companion.js). The SDK provides APIs for context sharing, drillback navigation, user identity, and theme integration. Widgets can be built using any JavaScript framework (React, Angular, Vue) as long as they implement the required SDK lifecycle methods.

  • Create widget projects using the Infor Homepages SDK with the standard project scaffold: manifest.json, index.html, widget.js
  • Implement the widget lifecycle: onInit(), onContextChange(), onSettingsChange(), and onDestroy() from infor.companion.js
  • Use the Ming.le Context API to receive and publish context (e.g., selected customer ID, item number) between widgets on the same page
  • Apply IDS (Infor Design System) theme tokens in widget CSS for consistent look and feel matching the enterprise color scheme
  • Build responsive widget layouts supporting Ming.le's grid system: 1x1, 2x1, 2x2, and full-width widget size options

Data Integration and Drillback Configuration

Widgets fetch real-time data from CloudSuite Industrial through the ION API Gateway using OAuth2 authentication provided by the Ming.le SDK's getToken() method. For read-heavy dashboards, the Data Lake JDBC connector or Birst embed API provides optimized query performance over aggregated datasets. Drillbacks enable users to click elements in a widget and navigate directly to the relevant CSI form (e.g., clicking an order number opens the Customer Order form in CSI), configured through the Ming.le drillback registry.

  • Fetch CSI data in widgets using ION API Gateway endpoints with bearer tokens obtained from companion.getToken()
  • Register drillback definitions in Ming.le Admin mapping logical IDs (e.g., SalesOrder) to CSI form URLs with parameter substitution
  • Embed Birst visualizations in widgets using the Birst JavaScript Embed API for pre-built dashboard content
  • Implement widget-level caching with configurable TTL to reduce ION API call volume on frequently accessed dashboards
  • Use WebSocket connections through ION for real-time data updates in monitoring widgets (production status, alert feeds)

Deployment and Role-Based Configuration

Completed widgets are packaged as .zip archives containing the manifest, HTML, JavaScript, and CSS files, then uploaded through the Ming.le Widget Catalog in the Admin Portal. Homepage layouts are designed in the Ming.le Homepage Designer where administrators drag widgets onto the grid and configure widget-specific settings. Role-based homepage assignment ensures each user role (shop floor, planner, executive, finance) sees a tailored landing page with relevant widgets and quick actions.

  • Package widgets as .zip archives with manifest.json defining widget metadata, size options, and configuration parameters
  • Upload widget packages to the Ming.le Widget Catalog (Admin > Homepages > Widget Catalog) for organization-wide availability
  • Design homepage layouts in the Homepage Designer with drag-and-drop widget placement and grid configuration
  • Assign homepages to security roles ensuring role-based access: manufacturing role sees production widgets, finance sees GL dashboards
  • Version widget deployments through the Widget Catalog supporting rollback to previous versions if issues are discovered

Want to create compelling Ming.le homepages for your CloudSuite users? Netray develops custom widgets and role-based dashboards that boost user productivity.