Connect via API

Follow the instructions below to connect Violet to Teamcenter via API.

Connecting directly to the Teamcenter database and bypassing the API is recommended for faster performance. To use that method, skip ahead to the instructions here. If you wish to connect to TeamcenterX, head to the instructions here.

Configure access

First, you'll need to ensure Violet can access Teamcenter via one of the below methods:

Option 1: Access via Allow List

Add the applicable IP addresses to the allow list for the server hosting your Teamcenter environment:

Violet's IP Addresses

For Violet:

• Production: 50.19.87.143

• Staging: 34.204.135.202

For VioletGov:

• Production: 3.31.169.141

• Staging: 3.30.99.219

Option 2: Access via VPN

For added security, we can establish a VPN tunnel. This will connect Violet’s AWS VPC and the network where your Teamcenter environment is hosted.

We recommend Tailscale VPN, but support any method you require, like IPsec VPN or AWS PrivateLink. More info here.

Create a service account

We suggest that you create a dedicated read-only Teamcenter account that can be used as a service account for Violet integrations and syncs. This helps prevent ambiguity in your data, and it will allow the Violet team to most reliably test and maintain your integration.

In addition, if you don't have Active Workspace, this will be required to allow Violet to access the REST API without locking out another user.

You can securely share credentials with the Violet team on the Credentials page.

Connect Teamcenter

1. In Violet (or VioletGov), navigate to Integrations and click .

2. Select Teamcenter

[Optional] Assign permissions to which users or user groups can view the data or edit the credentials:

1. Enter the server URL followed by the port number you selected during configuration (typically :8080).

2. Enter your Teamcenter username and password, then click Connect.

   1. You are free to use your own user account or a service account. We typically recommend using a service account to avoid ambiguity in your data, especially for larger organizations.

Once your connection is live, you're ready to set up your Teamcenter integration.

Troubleshooting

Confirm your Teamcenter is running JsonRestServices

Your Teamcenter instance will need to be running JsonRestServices in order to allow Violet to connect. For most implementations, this should be enabled out of the box.

If you're not sure whether your instance is running JsonRestServices, you can run the quick test below:

1. Open a web browser and navigate to: http://yourteamcenter.yourdomain.com:8080/tc/JsonRestServices

   1. (Note, replace yourteamcenter.yourdomain.com with the location of your Teamcenter sever).

2. You should see an error page with the below error message. This confirms that JsonRestServices are running at that endpoint.

The request could not be understood by the server due to malformed syntax.

If you see a response other than this message, you may not have JsonRestServices enabled. We'll need to connect with your Teamcenter implementation team to enable this.

Port selection and SSL

1. By default, Violet will connect to port TCP:8080 on your Teamcenter server. If you prefer to use a different port, let us know. Any port is fine as long as JsonRestServices is available there.

2. To ensure that the connection between Violet and Teamcenter is secure, it is important that the endpoint on your Teamcenter server is protected with a valid SSL certificate.

Teamcenter Active Workspace and file ingestion

If you are using Teamcenter Active Workspace, which is required if you wish to ingest files, we will also need to communicate with port 3000.