To start using ShapeChange, follow these steps:
|1||Verify that you are using the Java Runtime Environment 11 or later.|
|2||Download ShapeChange (all platforms; version 2.9.0; 30 December 2019) Release Notes|
|3||Unpack the ZIP archive. An overview of the contents of the archive can be found here. Use a path without whitespace in filenames as the XSLT processor currently used by ShapeChange cannot handle such path names properly.|
|4||If you plan to process Enterprise Architect models, copy SSJavaCom.dll located in <EA installation folder>/Java API to <Windows folder>/System32 (on a 32-bit machine) or to <Windows folder>/SysWOW64 (on a 64-bit machine). On a 64-bit machine, verify that you are using a 32-bit version of Java (e.g. using the command “java -version”) since Enterprise Architect is a 32-bit application. Enterprise Architect 7.5 or later is required.
NOTE: If you are searching for a 32bit JDK, take a look at AdoptOpenJDK. They provide 32bit OpenJDK for Java 8, 11, and later. ShapeChange has been tested with the 32bit OpenJDK 11 from AdoptOpenJDK.
|5||If you plan to create feature catalogues or to apply XSL transformations to output files and would like to use Saxon as XSLT processor, then download the Saxon HE jar from the official maven repository. Each release of ShapeChange uses a specific version of Saxon HE. The table in the Release Notes indicates which version is needed for the ShapeChange release that you are using. Copy the Saxon HE jar to the lib folder of your ShapeChange distribution.|
ShapeChange is now ready to be used.
To test the installation, open a shell / DOS box and make the unzipped folder your current directory. Execute
java -jar ShapeChange-2.9.0.jar -Dfile.encoding=UTF-8 -c https://shapechange.net/resources/test/testXMI.xml
You should now see the following information message:
I Application schema found, package name: TestSchema, target namespace: https://shapechange.net/test
After the execution is complete, you will find
- Log messages are written to test/xmi/log.xml
- The GML application schema has been created as test/xmi/INPUT/test.xsd
- The HTML feature catalogue has been created as test/xmi/INPUT/test.html
To test the access to Enterprise Architect models (note that this test requires Enterprise Architect and can be executed only on Windows), execute
java -jar ShapeChange-2.9.0.jar -Dfile.encoding=UTF-8 -c https://shapechange.net/resources/test/testEA.xml
You should see the same results as in the XMI test, except that the results are written into the folder test/ea.
Configurations for the use of ShapeChange with some public models (INSPIRE, AFIS-ALKIS-ATKIS) are made available on the examples page.
If you notice errors when executing the tests, have a look at some of the typical problems in setting up ShapeChange.