Modifying applications

After you log in to Application Configuration, you can create or modify applications.

About this task

You can modify the code of an application by using the XML editor, properties panel, and the canvas area.

You can make changes to an application by adding, deleting, or modifying XML elements directly in the XML editor. Alternatively, you can select an XML component in the XML editor, and add, remove, and modify component property values in the properties panel.

Besides editing app XML in the XML editor, you can select the AppCustomizations.js file and add custom JavaScript to the application. In addition, you can select the i18n/labels.json file to update labels shown in the application.

You can also modify the appearance of the application UI through the canvas area. Preview an application XML component in the canvas, for example, an application page, and then drag and drop elements to rearrange the display. You can also delete or copy and paste elements in the UI. The XML code displayed in the XML editor updates as you change the appearance of an element from the canvas area.

Procedure

  1. If Maximo® Application Suite v9.0 or earlier is installed, run the Application Configuration Docker image. If Maximo Application Suite v9.1 is installed, access Application Configuration through the Maximo Application Suite UI.
  2. Log in to Maximo Manage.
    The Application list page displays the applications that you are authorized to configure.
  3. Click the name of an application to open it in the Editor page.
  4. Select app.xml from the file section drop-down menu.
  5. Make a change to the XML of the application.
    For example, you can add an owner group reference on a work order.
    Do not change component ID values in the application XML files of default Maximo Mobile applications. Before an upgrade, if you changed default Maximo Mobile applications, you can generate a delta file that contains your configuration changes. The delta file relies on the component IDs of the default applications to identify changes.
  6. Click Save.
  7. Select Preview and verify that the change you made works as intended.
  8. Select Publish.
    Do not publish an application immediately after you start editing the application. When you start editing an application, the local React preview server starts and can take a few minutes to complete the startup process. Errors can occur if you publish at the same time that the React server is starting. View the console for the message that the preview server is available.
    After an application is published, mobile devices can then download the new version of the application. If the application is being published for the first time, assign it to the appropriate security groups. If you edit application files outside of Application Configuration, then you must ensure the integrity of those files. Use a virus or malware scanner before you publish the files to the Maximo application server.