Using Syndeia with Windchill

Owned by Debesh Roy Chowdhury
Last updated: Nov 22, 2023 by Rose Yntema

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

  • The following information was verified for Windchill versions 10.1, 10.2, 11.0, and 12.1. Although the same jars might work for later versions, you may have to find additional ones and you may have to update the shown ones to those found on your current Windchill server.
  • Windchill 12 jars require Java 11 and have been confirmed to work for MagicDraw/Cameo 2021x Refresh2 Hotfix 1 and later, which also requires Java 11. However, they will not work with MagicDraw 19.0 which requires Java 8.
  1. Create a local folder named libWC to collect all jar files needed for Windchill.
  2. You will locate and gather 2 sets of jar files from your Windchill server, to copy these into your libWC folder.

    Set 1
  3. Go to the following folder on your Windchill server: <Your Windchill Installation>\Windchill\ieconnector, e.g. D:\ptc\Windchill\ieconnector.
  4. Locate and copy the ie.rar file to a separate temporary location
  5. Unzip the ie.rar file at this temporary location.
  6. Copy the following jar files from the unzipped folder to the libWC folder (created above), as also shown below.
    1. ie-ra-client.jar
    2. webservices-api.jar
    3. webservices-extra.jar
    4. webservices-extra-api.jar
    5. webservices-rt.jar


    Set 2

  7. Go to the following folder on your Windchill server: <Your Windchill Installation>\Windchill\codebase\WEB-INF\lib, e.g. D:\ptc\Windchill\codebase\WEB-INF\lib
  8. Copy the following 3 jar files to the libWC folder.
    1. ie3rdpartylibs.jar
    2. ieWeb.jar
    3. wncWeb.jar
  9. Now, the libWC folder must have 8 jar files—5 from Set 1 and 3 from Set 2. Assure it has no other jars.
  10. For each workstation that will be running MagicDraw and Syndeia
    1. Complete the section "Library Installation for specific Repositories" in the Install Syndeia plugin guide
    2. 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 

  1. 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:

  2. Edit the properties file (e.g. magicdraw.properties, cameoea.properties, etc.) as follows:

    1. 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.

    2. 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.