Assetize

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.

What it does
Your jobUse it to
Maximo consultantExplain a proposed screen change with a working preview and an exact XML example.
Developer or administratorInspect a control, find its binding, check the XML and review a change before importing it.
Business analyst or trainerWalk through tabs, fields and sample records with the editor tucked away.
Upgrade teamCheck 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.

  1. Open the Work Order Tracking starter below. Keep Dictionary on MAS 9.2 and choose the MAS 9.1+ skin.
  2. Click a field in the preview. The Inspector shows its control and properties, and the editor reveals its XML.
  3. 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.
  4. 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.
  5. Switch the skin to Pre-Carbon, then MAS 9.0. The XML stays the same while the layout changes.
  6. 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.

Stock screens and your export
Starting pointWhat you open
Stock · MAS 9.2A harvested stock application presentation, loaded when you select it. Edits can be compared with that loaded original.
Assetize startersCompact 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 presentationChoose 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.

Editor, screen and inspector
ControlWhat it does
EditorEdit the presentation, inspect design findings and apply UI tricks. Format re-indents the XML.
PreviewExplore rendered tabs, tables and fields. Click a control to select it and reveal its XML.
InspectorRead the selected control’s properties, data binding and available dictionary or domain detail.
Editor / Inspector buttonsHide or restore a side panel. The preview takes the space released; your panel preference is remembered in this browser.
Pop outOpen the simulated screen in another window. XML, skin, dictionary selection and selected control are mirrored while the editor remains open.
Full screenExpand 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.

Read the design review
CheckWhat is examined
XML and control IDsParser findings, missing IDs and duplicate IDs.
Controls and propertiesKnown tags, documented properties, supported values and recorded version rules.
ContainmentKnown structural rules: for example, a tab belongs under a tabgroup and a sectioncol under a sectionrow.
Data bindingsdataattribute against the bound object, plus related-object paths where the available relationship graph can resolve them.
LookupsLookup IDs against the known stock inventory. A custom lookup can produce a note and still be valid on your instance.
Signature optionsBindings 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.

Dictionaries and skins
SettingPurpose
MAS 9.2 dictionaryResolve bindings against the bundled 9.2 data definitions.
Maximo 9.1 dictionaryResolve bindings against the available 9.1 definitions. Where the harvest is marked partial, missing attributes are reported as notes.
Pre-Carbon skinShow the classic layout model, including labels beside fields and boxed tabs.
MAS 9.0 skinShow the Carbon-era layout model, including labels above fields and YORN toggles.
MAS 9.1+ skinShow 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.

  1. Choose a trick in the editor’s drawer. Read what it changes and which configuration it needs.
  2. 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.
  3. Inspect the before/after diff and the added, removed, changed or moved control summary.
  4. Use Undo to restore the XML from before that applied trick, or Download change summary to keep its text summary.
  5. 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.

Choose the right way to hand over your work.

Keep the XML as the change artefact, and use a share link when a reviewer needs to reopen the screen.

Share, download and restore
ActionWhat it contains
DownloadThe XML currently in the editor, named from the presentation ID where one is available.
CopyThe current XML on your clipboard.
Share linkApplication, dictionary, skin, selected control and sample-data toggle. Edited or custom XML is embedded in the URL fragment when it fits.
Download change summaryA text explanation of the current applied trick’s XML changes.

State is reflected in the part of the URL after #. Named, unchanged starters and stock screens can be restored by reference. Edited XML is compressed where supported and embedded in that fragment.

The XML payload limit is 32 KiB after encoding preparation (compressed bytes when compression is available, otherwise raw bytes). If “Too large to share as a link” appears, use Download: the URL omits that XML and cannot restore your custom changes. Compression is an encoding method, not encryption.

Anyone you send a complete share link to can read its embedded presentation. Share it with the same care as the XML file. Working record edits and panel layout are not included in the link.

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.

  1. Keep the original presentation export with its application ID, source environment and export date.
  2. Download the edited XML. Include the trick summary if used, and note the dictionary and skin used for review.
  3. Record the intended behaviour: which field, section, tab or action changed and who should see it.
  4. Import the presentation into the appropriate Maximo test environment using your normal Application Designer process.
  5. Check actual rendering, lookups, related data, security-group access, conditional properties and actions with representative users and records.
  6. 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.

Where your data goes
DataWhere it lives
Your presentation XMLBrowser memory and, when within the share limit, the URL fragment. The editor does not upload it to a server.
Working record editsBrowser memory for the current preview. They are not saved in a database.
Panel visibilityBrowser local storage, so the Editor and Inspector reopen with your preference.
Reference materialStock XML, dictionaries, domains and samples are fetched as site assets when needed.
Site analyticsThe 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.

Troubleshooting
What you seeWhat to do
A field is unknownCheck 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 messagesClean counts errors only. Read the warnings and notes in Design review.
A bean-backed binding cannot be resolvedRead the named bean or relationship context in the finding, then check its actual object in your test environment.
Preview with real data is disabledChoose the Work Order Tracking Assetize starter. Other apps use generated rows when a dictionary is available.
A trick changes nothingRead its explanation. It may need a different control, be already applied, or require configuration outside the XML.
A shared link loses custom XMLCheck for the “Too large to share” message. Send the downloaded XML instead.
A pop-out does not open or stays a snapshotAllow 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 transactionUse 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.