/
Using Syndeia with Windchill.

Using Syndeia with Windchill.

Nov 08, 2023

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 write access to the Rhapsody and Syndeia installation 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 will require Rhapsody to use Java 11. This will also require Syndeia 3.5 SP2 or later. 

  1. Create a folder named libWC to collect all jar files needed for Windchill. You will need to locate and gather 2 sets of jar files from your Windchill server and copy them into the libWC folder.

    Set 1

  2. Go to the following folder on your Windchill server: <Your Windchill Installation>\Windchill\ieconnector, e.g. D:\ptc\Windchill\ieconnector.

  3. Locate and copy the ie.rar file to a separate temporary location

  4. Unzip the ie.rar file at this temporary location.

  5. Copy the following jar files from the unzipped folder to the libWC folder (created above), as also shown in figure 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

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

  7. Copy the following 3 jar files to the libWC folder.

    1. ie3rdpartylibs.jar

    2. ieWeb.jar

    3. wncWeb.jar

  8. Now, the libWC folder should 8 jar files—5 from Set 1 and 3 from Set 2. Keep the libWC at a known location.

  9. For each workstation that will be running Rhapsody 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 Java 11 and Syndeia 3.5 SP2 or later, perform the additional steps below.

Additional Steps for Windchill 12 libs, using Java 11 and Syndeia 3.5 SP2 or later

  1. Move (not copy) ie3rdpartylibs.jar and webservices-api.jar from libWC to a separate folder under the Syndeia plugin folder named libWCx as shown:

  2. Edit the rhapsody.ini file:

    1. Make sure JavaLocation is set to use JDK11 or higher as required by Windchill 12 e.g. JavaLocation=C:\Program Files\Java\jdk-11.0.13

    2. Modify the ClassPath= line by adding ;$OMROOT\Profiles\Syndeia\lib\logback-core-1.2.10.jar;$OMROOT\Profiles\Syndeia\lib\logback-classic-1.2.10.jar;$OMROOT\Profiles\Syndeia\lib\slf4j-api-1.7.36.jar;$OMROOT\Profiles\Syndeia\libWCx\webservices-api.jar;$OMROOT\Profiles\Syndeia\libWCx\ie3rdpartylibs.jar after the existing value.

    3. Save the file

For example  

  • If the value before editing is ClassPath=-Djava.class.path=C:\Program Files\IBM\Rhapsody\9.0\Share\JavaAPI\rhapsody.jar;

  • Add $OMROOT\Profiles\Syndeia\lib\logback-core-1.2.10.jar;$OMROOT\Profiles\Syndeia\lib\logback-classic-1.2.10.jar;$OMROOT\Profiles\Syndeia\lib\slf4j-api-1.7.36.jar;$OMROOT\Profiles\Syndeia\libWCx\webservices-api.jar;$OMROOT\Profiles\Syndeia\libWCx\ie3rdpartylibs.jar

  • Result: ClassPath=-Djava.class.path=C:\Program Files\IBM\Rhapsody\9.0\Share\JavaAPI\rhapsody.jar;$OMROOT\Profiles\Syndeia\lib\logback-core-1.2.10.jar;$OMROOT\Profiles\Syndeia\lib\logback-classic-1.2.10.jar;$OMROOT\Profiles\Syndeia\lib\slf4j-api-1.7.36.jar;$OMROOT\Profiles\Syndeia\libWCx\webservices-api.jar;$OMROOT\Profiles\Syndeia\libWCx\ie3rdpartylibs.jar