<aside> 💡 This content applies to IBM TRIRIGA Application Platform 3.5.1 and later. See Migrating objects (3.8.0) in IBM Documentation for more information.
The IBM TRIRIGA Application Platform provides the ability to track metadata for high-level objects with object revisions and object labels. Changes to high-level objects, such as business objects and UX metadata, are captured in object revisions. In addition to revision capabilities, these objects contain identifiers called object labels. The process of identifying the objects is called object labeling.
Tracking Object Revisions
Best Practices for Object Conversion
Best Practices for Application Upgrade
Object Upgrade Videos
IBM TRIRIGA Application Platform 3.6.0 builds on the object revisioning and labeling capabilities by providing the ability, during object migration export, to detect UX metadata objects that might require the creation of revisions. When creating a revision might be required, an orange icon is displayed next to the object and the object name is in orange text.
Starting in 3.6.0, the Create Revision action and Revision terminology replaces the Snapshot action and Snapshot terminology. The Create Revision action (UX Revision Options) saves your changes and applies the In Progress object label to the UX metadata component and all of its dependent children components. For bulk changes to multiple UX metadata components, the Create Revision For Selected action and Create All Needed Revisions action are available on the landing page of the related UX app designer tool. Then you can apply a custom object label to these modified objects in the Object Label Manager.
Also, starting in 3.6.0, when you open an object label in the Object Label Manager, the In Progress Objects tab features the By Object Label drop-down, and the Current Revision Only check box. The By Object Label drop-down allows you to display the labeled objects by the In Progress label, the Root label, or a custom object label. No IBM object labels will be available. Then you can click the Apply Label to Selected action for the selected objects. For a non-Root label, you can also click the Apply Label to All [Label Name] Objects action, where [Label Name] is the object label selected from the drop-down. The Current Revision Only check box allows you to apply object labels to the current revision of an object only.
In addition, this new version provides the ability, during object migration import, to detect object label conflicts after the preliminary validation process and after the validation process. When there is an object label conflict, an orange icon is displayed next to the object and the object name is in orange text.
If differences are reported on the UX content files, such as HTML/JS and CSS files, then to determine the exact differences, you can download the content files. For each object from which you want to download content, select the check box, and click the Download Content For Selected feature. The downloaded ZIP file includes the
OM folder and
System folder. The
OM folder contains the source content files, while the
System folder contains the target content files. Next, you can compare the content file versions by using an HTML/JS "diff" tool. For more information on downloading content files, see Object Download (UX in Object Migration Tool). For more information on comparing UX metadata, see Compare and Merge HTML/JS Views (UX Best Practices).