Follow the steps in this section to gather jar files to connect and communicate with Windchill. These steps require Administrator access to the organization's Windchill server and Administrator write-access to the MagicDraw and Syndeia folders of the user's workstation.
Windchill Server Versions
- This guide is for users of PTC Windchill versions 10.1, 10.2, 11.0, and 12.1.
- If you are using a different version of Windchill, contact us at Intercax.com/Help
- Windchill 12 jars require Java 11 and can be used with MagicDraw/Cameo 2021x Refresh2 Hotfix 1, 2022x, and 2024x which also use Java 11.
- Windchill 12 jars cannot be used with MagicDraw/Cameo 19.0 - because that application uses Java 8.
Installing Windchill Jars for Windchill 10.1, 10.2, and 11
Create a local folder named libWC to collect all jar files needed for Windchill.
Locate and gather from your Windchill server, 2 sets of jar files and copy these into the libWC folder.
Set 1- Go to the this folder on your Windchill server: <Your Windchill Installation>\Windchill\ieconnector
- e.g. D:\ptc\Windchill\ieconnector.
- Locate and copy the ie.rar file to a separate temporary location
- Unzip the ie.rar file at this temporary location.
- Copy these jar files from the unzipped folder to your libWC folder:
- ie-ra-client.jar
- webservices-api.jar
- webservices-extra.jar
- webservices-extra-api.jar
- webservices-rt.jar
Set 2
- Go to this folder on your Windchill server: <Your Windchill Installation>\Windchill\codebase\WEB-INF\lib
- e.g. D:\ptc\Windchill\codebase\WEB-INF\lib
- Copy these 3 jar files to the libWC folder.
- ie3rdpartylibs.jar
- ieWeb.jar
- wncWeb.jar
- Now, the libWC folder must have 8 jar files—5 from Set 1 and 3 from Set 2. Assure it has no other jars.
- For each workstation that will be running MagicDraw and Syndeia
- Complete the section "Library Installation for specific Repositories" in the Install Syndeia plugin guide
- If you are using Windchill 12 with MagicDraw (or equivalent CATIA Magic Product) 2021x Refresh 2 Hotfix 1 or later with Java 11, perform the additional steps below
Additional Steps for Windchill 12 libs and MagicDraw 2021x Refresh2 Hotfix 1 or later, which uses Java 11
Move (not copy) ie3rdpartylibs.jar and webservices-api.jar from libWC folder to a separate folder under the Syndeia plugin folder named libWCx as shown:
Edit the properties file (e.g. magicdraw.properties, cameoea.properties, etc.) as follows:
Modify the JAVA_ARGS = line by adding
-Djavax.xml.xpath.XPathFactory:http://java.sun.com/jaxp/xpath/dom\=com.sun.org.apache.xpath.internal.jaxp.XPathFactoryImpl
after the existing value as shown in the screenshot below.
Modify the CLASSPATH = line by adding
\:plugins/com.intercax.syndeia.md/libWCx/webservices-api.jar\:plugins/com.intercax.syndeia.md/libWCx/ie3rdpartylibs.jar
after the existing value as shown in the screenshot below.