UI Playground · Documentation
Understand the screen. Make the change. Share the result.
A practical guide to exploring Maximo presentation XML: open a screen, edit its layout, check its bindings, compare version skins and hand over a reviewed change.
Open the playground · Controls reference
Turn a screen change into something everyone can inspect.
The Playground brings the XML, a schematic preview, design checks and control documentation into one workspace.
| Your job | Use it to |
|---|---|
| Maximo consultant | Explain a proposed screen change with a working preview and an exact XML example. |
| Developer or administrator | Inspect a control, find its binding, check the XML and review a change before importing it. |
| Business analyst or trainer | Walk through tabs, fields and sample records with the editor tucked away. |
| Upgrade team | Check bindings against the available dictionaries and compare the same XML under three layout skins. |
This is an Assetize tool for classic Application Designer presentations. Its preview is a schematic; final rendering, permissions and business behaviour are confirmed in your Maximo test environment.
Make your first change in a few minutes.
Start with the small Work Order Tracking example. You can complete this walkthrough without a Maximo connection or an export.
- Open the Work Order Tracking starter below. Keep Dictionary on MAS 9.2 and choose the MAS 9.1+ skin.
- Click a field in the preview. The Inspector shows its control and properties, and the editor reveals its XML.
- Change an existing label in the XML. The preview redraws after you pause typing. Editing a field value in the preview changes a sample record instead of the XML.
- Read the Design review below the editor. Select a finding to jump to its source location; open its reference link for the relevant control property.
- Switch the skin to Pre-Carbon, then MAS 9.0. The XML stays the same while the layout changes.
- Choose Download to keep the edited XML, or Share link to copy a URL that restores the supported screen state.
Download changes before selecting a different application or using Reset. Those actions replace the XML currently in the editor.
Start from the product, an example or your own presentation.
The Application picker distinguishes harvested stock screens from the smaller Assetize examples.
| Starting point | What you open |
|---|---|
| Stock · MAS 9.2 | A harvested stock application presentation, loaded when you select it. Edits can be compared with that loaded original. |
| Assetize starters | Compact examples for Work Order Tracking, Assets, Service Requests and Preventive Maintenance. These are Assetize-authored teaching examples. |
| Your own export… | An Application Designer presentation XML file. Use Open export, drop the file onto the workspace, or paste XML into the editor. |
| Blank presentation | Choose Your own export…, then Start from a blank presentation to get a small WORKORDER example. |
Export the application presentation from Application Designer in your Maximo environment. Keep an unchanged copy, then open the XML in the Playground. Custom objects and fields are checked against the bundled dictionary; the Playground does not import your environment’s dictionary or lookups.
Select a presentation XML file, rather than a ZIP archive, a database export or a role-based application package.
Three views of the same presentation.
Move between the XML and the visible control without losing the binding you are inspecting.
| Control | What it does |
|---|---|
| Editor | Edit the presentation, inspect design findings and apply UI tricks. Format re-indents the XML. |
| Preview | Explore rendered tabs, tables and fields. Click a control to select it and reveal its XML. |
| Inspector | Read the selected control’s properties, data binding and available dictionary or domain detail. |
| Editor / Inspector buttons | Hide or restore a side panel. The preview takes the space released; your panel preference is remembered in this browser. |
| Pop out | Open the simulated screen in another window. XML, skin, dictionary selection and selected control are mirrored while the editor remains open. |
| Full screen | Expand the preview for a walkthrough. Press Escape to return. |
Pop out mirrors presentation state, not your edited sample rows. The pop-out window displays “live from the playground” when connected and “snapshot” when it is no longer receiving the editor’s state.
Find the issue, see its location, choose the fix.
The Design review checks XML and known presentation rules, then resolves data bindings using the selected dictionary and available relationships.
| Check | What is examined |
|---|---|
| XML and control IDs | Parser findings, missing IDs and duplicate IDs. |
| Controls and properties | Known tags, documented properties, supported values and recorded version rules. |
| Containment | Known structural rules: for example, a tab belongs under a tabgroup and a sectioncol under a sectionrow. |
| Data bindings | dataattribute against the bound object, plus related-object paths where the available relationship graph can resolve them. |
| Lookups | Lookup IDs against the known stock inventory. A custom lookup can produce a note and still be valid on your instance. |
| Signature options | Bindings and the application’s harvested option inventory where available. Your security-group grants are checked in Maximo. |
Errors identify problems such as invalid structure or duplicate IDs. Warnings need review against the intended configuration. Notes describe context such as a custom lookup, a partial dictionary or an object supplied by a Java bean that cannot be resolved from the XML alone. Each finding includes its source location and, where available, a control reference.
The “clean” indicator above the editor means zero errors. Read warnings and notes in the Design review as well. A custom field absent from the bundled dictionary needs checking against your own configuration; deleting a valid custom field is not the fix.
A clean static review does not execute Java beans, automation scripts, workflow actions or database validation. Use your Maximo test environment for those behaviours.
Choose the data definition and the visual layout separately.
Dictionary controls binding checks. Skin controls how the same XML is drawn. Changing one does not change the other.
| Setting | Purpose |
|---|---|
| MAS 9.2 dictionary | Resolve bindings against the bundled 9.2 data definitions. |
| Maximo 9.1 dictionary | Resolve bindings against the available 9.1 definitions. Where the harvest is marked partial, missing attributes are reported as notes. |
| Pre-Carbon skin | Show the classic layout model, including labels beside fields and boxed tabs. |
| MAS 9.0 skin | Show the Carbon-era layout model, including labels above fields and YORN toggles. |
| MAS 9.1+ skin | Show the later layout model, including checkboxes and underlined tabs. |
For a binding comparison, keep the presentation fixed and switch Dictionary. For a visual comparison, keep both the XML and dictionary fixed and switch Skin. This makes it clear which setting caused the difference.
The Pre-Carbon skin does not provide a 7.6 dictionary. The picker currently offers 9.1 and 9.2 dictionaries; a skin is a layout model, not a running release of Maximo.
Try the layout with records behind the fields.
The main preview uses generated working rows when an object dictionary is available. The Work Order Tracking starter also offers bundled lab sample data.
Type into an editable preview field to change the working record. This lets you demonstrate how a populated screen feels while keeping layout edits in the XML editor.
Preview with real data is enabled for the Work Order Tracking starter that has a sample file. These are bundled 9.2 lab records, not a live connection to your Maximo. Other applications can still use generated rows when their object dictionary is available.
Working record edits live in memory. They are not included in Download, Copy, Share link or the pop-out mirror. Loading a different application, changing the dictionary or changing the data source can reseed the working rows.
The Playground does not save work orders or other business records to Maximo. Download exports the presentation XML only.
Apply a focused change and inspect exactly what moved.
The tricks drawer offers presentation patterns with their source, intended effect and instructions for checking the result.
- Choose a trick in the editor’s drawer. Read what it changes and which configuration it needs.
- Apply it to the current presentation. If no control matches, the Playground explains why nothing changed; some recipes describe configuration steps instead of editing XML.
- Inspect the before/after diff and the added, removed, changed or moved control summary.
- Use Undo to restore the XML from before that applied trick, or Download change summary to keep its text summary.
- Follow any additional recipe steps in Application Designer, Conditional Expression Manager or Security Groups, as named by that recipe.
When you edit a loaded stock presentation, “Compared to stock” summarises changes against that loaded original. Opening your own export does not automatically fetch a matching stock baseline.
These are readable, mxdiff-style summaries. The Playground does not produce an IBM .mxs migration transaction or apply a change to Maximo.
Give the next person the change and a clear way to verify it.
A useful handover includes the original, the edited presentation and a short record of what the reviewer should confirm.
- Keep the original presentation export with its application ID, source environment and export date.
- Download the edited XML. Include the trick summary if used, and note the dictionary and skin used for review.
- Record the intended behaviour: which field, section, tab or action changed and who should see it.
- Import the presentation into the appropriate Maximo test environment using your normal Application Designer process.
- Check actual rendering, lookups, related data, security-group access, conditional properties and actions with representative users and records.
- Promote the tested artefact through your normal change process, retaining the original for rollback.
Changing a presentation does not create a custom database attribute, a lookup definition or a security grant. Carry those dependencies with the change when your design requires them.
XML processing happens in your browser.
Opening an export reads a local file. Parsing, editing, design checks, preview rendering and change summaries run in the browser.
| Data | Where it lives |
|---|---|
| Your presentation XML | Browser memory and, when within the share limit, the URL fragment. The editor does not upload it to a server. |
| Working record edits | Browser memory for the current preview. They are not saved in a database. |
| Panel visibility | Browser local storage, so the Editor and Inspector reopen with your preference. |
| Reference material | Stock XML, dictionaries, domains and samples are fetched as site assets when needed. |
| Site analytics | The site records route-level usage. Its PostHog privacy filter drops events on Playground routes and strips URL fragments from other routes. |
There is no customer XML database or server-side save operation for this editor. It still loads the application and reference assets from the website, so treat it as a browser tool rather than an installed offline application.
Download an XML copy when you need a durable working file. A browser history entry or a share URL that exceeds the payload limit is not a substitute for that file.
Get from a confusing result to the next useful check.
Most surprises come from the selected dictionary, the source of the preview data or the difference between static XML and runtime behaviour.
| What you see | What to do |
|---|---|
| A field is unknown | Check Dictionary, the presentation’s mboname and any relationship path. For a custom field, compare the binding with your own Database Configuration. |
| Clean, but there are still messages | Clean counts errors only. Read the warnings and notes in Design review. |
| A bean-backed binding cannot be resolved | Read the named bean or relationship context in the finding, then check its actual object in your test environment. |
| Preview with real data is disabled | Choose the Work Order Tracking Assetize starter. Other apps use generated rows when a dictionary is available. |
| A trick changes nothing | Read its explanation. It may need a different control, be already applied, or require configuration outside the XML. |
| A shared link loses custom XML | Check for the “Too large to share” message. Send the downloaded XML instead. |
| A pop-out does not open or stays a snapshot | Allow the window for this site and reopen it from Pop out. Live mirroring needs a browser that supports BroadcastChannel. |
| A button does not perform a Maximo transaction | Use the preview to review the control and its event binding. Run the real action in your Maximo test environment. |
Go deeper where the change needs it.
Use the focused references for properties, version changes and the configuration around a screen.
Control and dictionary details come from the bundled registry, stock presentations and harvested definitions. The reference pages identify their sources. Layout models also use the documented and practitioner-reported version changes described in the UI version guide.
Start Centers and Operational dashboards have their own tools. The classic presentation Playground does not build a role-based application or an Operational dashboard.
Created by Assetize Consultancy. Source details accompany the controls and version references. Assetize is independent of IBM.