Organizing Layouts¶
Organize machine details page content by audience, topic, and time range.
Audience¶
The DataPortal lets you organize users and machines into organizational units structured as a tree, reflecting your company's organizational structure and managing visibility and access to machines.
Each organizational unit can also be qualified with an Organization Type, indicating whether it belongs to your company (OEM type), your dealership network (Dealer type), or one of your end customers (Machine Owner type). Since organization types align closely with user audiences in the portal, create separate Dashboards and Machine Page pages for each audience.
Tip
In the DataPortal, go to Settings > Administration > Organization Structure and check that every organizational unit in your tree is qualified with the correct organization type.
Topic¶
Machine owners are interested in two main topics, machine health and recent activity, which break down further into a more detailed taxonomy:
- Machine activity
- Location & Tracking: the machine's current location and its recent track.
- Work Delivered: the amount of work delivered in business-meaningful units. Depending on the asset type, this can take different forms, for example Total load count and Total weight loaded for an excavator.
- Consumption: the amount of consumables used, such as fuel level, battery level, or AdBlue level.
- Machine health
- Faults: active DTCs and DTC history.
- Consumable Levels: the levels of consumables needed to operate the machine.
- Scheduled Maintenance: upcoming and overdue maintenance that could put the machine at risk if not serviced in time.
- Operational Safety: any signal reflecting an aspect of machine use that's critical to operational safety, for example engine oil temperature, engine speed, machine speed, tilt angle, or engine load.
If the maintenance feature is active, the machine master data widget already shows whether a machine needs maintenance:

If the DataPortal's maintenance feature isn't in use, a signal like Hours to next service can serve the same purpose.
Create one page layout for each of the two main topics, activity and health, and use this taxonomy to organize widgets within each layout. Depending on how many signals your fleet uses to represent each topic, consider moving lower-level topics out into their own layout.
Time Range¶
Currently, the time range for data visualization is configured on a widget-by-widget basis, which can lead to a layout that mixes completely different time ranges on the same page and confuses users. Create layouts where all widgets use the same time range.
Note
With Machine Pages by Organization Type - Migration Guide, you can organize machine details pages by audience and topic. Contact Service and Support if you don't have access to this feature yet.
A sample setup for machine owner-targeted machine details pages could include:
- A home layout with the machine's activity for the last 7 days.
- An alternative layout with the machine's activity for the last 30 days.
- An alternative layout with the machine's health status.