Release 1.3.0

Release 1.3.0 [12-Dec-2024]

cim-compare 1.3.0 is a minor release with both enhancements and defect fixes.

Defect Issue #21:
Java 11 introduced a new feature to limit the number of characters: Java11 Release Notes. This caused cim-compare to crash with the error:

[Fatal Error] CIMModelComparison_profile1.xml_AND_profile2.xml:9321:260: Invalid byte 1 of 1-byte UTF-8 
ERROR:  'JAXP0801002: the compiler encountered an XPath expression containing '101' operators that exceeds the '100' limit set by 'FEATURE_SECURE_PROCESSING'.'  

FATAL ERROR:  'JAXP0801002: the compiler encountered an XPath expression containing '101' operators that exceeds the '100' limit set by 'FEATURE_SECURE_PROCESSING'.'javax.xml.transform.TransformerConfigurationException: JAXP0801002: the compiler encountered an XPath expression containing '101' operators that exceeds the '100' limit set by 'FEATURE_SECURE_PROCESSING'. at com.sun.org.apache.xalan.internal.xsltc.trax.TransformerFactoryImpl.newTemplates(Unknown Source) at com.sun.org.apache.xalan.internal.xsltc.trax.TransformerFactoryImpl.newTransformer(Unknown Source) at org.cimug.compare.app.CIMModelComparisonGenerator.main(CIMModelComparisonGenerator.java:121)  

This error has been resolved by disabling the character limit programmatically within cim-compare by internally setting the JVM parameters as recommended for use on the command line. Setting these system settings programmatically eliminates this command line need:

java -Djdk.xml.xpathExprGrpLimit=0 -Djdk.xml.xpathExprOpLimit=0 -Djdk.xml.xpathTotalOpLimit=0 -jar cim-compare-1.2.2.jar  CIM_profile1.eap CIM_profile_2.eap  

Enhancement Issue #22:
Previously, including UML diagrams in comparison reports resulted in ZIP archives that contained all diagrams in the model. This has been changed to now include only the subset of images relevant to the report that were either changed, added, or deleted. This results in potentially much smaller ZIP archives with the minimal set of images needed for the report.

Enhancement Issue #25:
Support for the Sparx EA 16.x and 17.x releases and the new 64-bit *.qea project file format is now supported as input to cim-compare. Visit the README or public site for further details on usage. Note that there are now individual cim-compare .jar distributions, one per EA release. This enhancement is only relevant if using .eap or .qea project files as input.

Enhancement Issue #24:
Changes made to the notes associated with classes or attributes were not easily identifiable. This release introduces a simple "diff feature" that displays removals using strike-through of the text that is highlighted in red. New text is also shown highlighted in green.

Release 1.2.2

Release 1.2.2 [12-Aug-2022]

Patch release of the cim-compare project. This release includes:

• Fix for a NullPointerException that occured on specific packages when using the --package command line parameter.

Release 1.2.1

Release 1.2.1 [14-Jun-2022]

Patch release of the cim-compare project. This release includes:

• The --export-diagrams command line option has been removed and is no longer supported when using .eap project files as input. The existing --include-diagrams option introduced in release 1.2.0 is now applicable to both option 1 and 2 command line approaches. This was done to simplify command line usage and eliminate questions and confusion reported by end users. Consult the README.md file for details on the official command line usage for this release.
• Diagrams that were moved to different packages between the baseline and destination models did not properly appear within the package in the target model they were moved to. This has been corrected in this release.

Release 1.2.0

Release 1.2.0 [10-Jan-2022]

Minor release of the cim-compare project. This release includes:

• Support for Enterprise Architect .eap files as direct input into report generation. This eliminates the intermediate step of manually exporting baseline and destination XMI files from EA in order to generate reports.
• New --export-diagrams, --include-diagrams and --image-type command line options. When --export-diagrams is specified cim-compare will export diagrams along with the XMI as part of processing the .eap files. Consult the README file for details on the usage of these new options.
• A new --zip command line option. When specified the generated report is packaged into a single ZIP archive. This was added to simplify distribution of reports when diagrams are included.
• Diagram images displayed as part of comparison reports are now auto-sized to better scale relative to the size of the browser window.
• Introduced support for indicating when Classes and Attributes have been 'deprecated' in the model via the <<deprecated>> stereotype.
• Based on end user feedback the 'Links' section of the comparison report has been reworked to better communicate changes to Associations, Generalizations, etc.
• Numerous other minor bug fixes and CIM comparison report format and layout updates.

Release 1.1.0

Release 1.1.0 [09-Feb-2021]

Minor release of cim-compare.

• cim-compare generates comparison reports that include packages, classes, diagrams, attributes, etc. that are "Identical" between baseline and target models. Such packages and classes are included as they are useful for reference purposes within reports. A new --minimal command line option has been introduced in this release. When specified cim-compare will exclude all "Identical" references and report only the packages, classes, class attributes, associations, generalizations, and UML diagrams that have had actual changes. This feature is useful when it is necessary to perform detailed analysis of only the most concise set of changes between models.
• This release now supports UML diagrams comparisons in reports. Refer to the "Enterprise Architect XMI Export Procedures" section of cim-compare's README.md file for further information.

Release 1.0.1

Release 1.0.1 [31-Jan-2021]

Patch release of cim-compare

Defects within the Links sections of the generated comparison reports have been fixed.

Release 1.0.0

Release 1.0.0 [17-Apr-2020]

This is the first release of the open source cim-compare command line report generation utility.