Override the Teamcenter and Active Workspace text server for localization display values
Updated: Feb 27
In Teamcenter and Active Workspace, there are many locations which get their display values from a server-side file. In this post, explore the topics that are controlled by the text server and how to override the values to take use of the feature.
Explore our demonstration video for overriding the textserver or continue below to see detailed information about the process.
Examples of features that utilize the Text Server
Style sheets
Integrated Toolkit (ITK) functions which retrieve custom display names from a list of custom error messages
Query Builder Saved Queries
Error Message Handling (EMH)
More....
The elements in the Active Workspace interface are all controllable by the Teamcenter text server. If an administrator needs to make a change without the text server, that individual needs to modify each location, on every page to make the change.
Using the text server, all of the locations call to a specific variable. The variable is defined in a file in the text server and maps to a display value. If the administrator needs to make a change, and has the text server, the change need only be made to the file on the server and all locations which reference it will pick up the change (once the tcserver processes are restarted that is).
Siemens has provided a way to provide our own values for the display and error names. The location of the display names in Teamcenter and Active Workspace's style sheets (along with other features that use the text server) derive from is:
%TC_ROOT%\lang\textserver\en_USThe en_US value may be changed for various localizations.
Try it out
Learn how to create a text server override in Teamcenter and Active Workspace to create your own or override existing localization values. Future changes to values utilizing the text server can be evaluated and reused extensively without much effort in modification.
Version compatibility
The process is validated in Teamcenter 9 through the latest release (14.*). The process is also validated in Active Workspace 3.4 through the latest release of (6.*).
Process to override the text server
1.) Create a directory and file to contain the new and/or overridden values.
The directory should not be in the Teamcenter or Active Workspace installation directories, including the %TC_DATA% and %TC_ROOT%.
The directory must resemble the following
<DIRECTORY-YOU-BUILD>\lang\textserver\en_US.Tip. Change the localization folder for the localization you need. This is the en_US value at the end of the path.
2.) Create or Copy files from the existing textserver to override them in the new directory.
Example. To update the locations in the screenshot (above with the little red boxes), the tc_xrt_text_locale.xml file must be copied to the new directory.
Caution. Be certain not to remove or alter the original text server location:
<%TC_ROOT%>\lang\textserver\en_US (or other localization directory). The copy you create will be emptied and only values you need to override will be added. The rest will continue to determine other values from %TC_ROOT%.
The image (above) shows the tc_xrt_text_locale.xml file in the %TC_ROOT% directory. This directory varies by installation and site.
Tip. To locate the %TC_ROOT% location, open a Teamcenter Command Prompt and type: set TC
Copy the file (in the image above). The image (below) shows the newly created directory (AW5_textserver folder not required) with the copied tc_xrt_text_locale.xml file. Make sure to paste the file in this directory to resemble the screenshot (below).
3.) Update the XML file in the new textserver directory
Modify the copied tc_xrt_text_locale.xml file (in the AW5_textserver directory) to only include the value(s) you need to add or modify.
The goal is to override all places where the term "Overview" is used in a style sheet across all of Active Workspace (which is almost every stylesheet). This method of updating individually shouldn't be used anymore (in our opinion). The better method is to add the override and update the (copied) tc_xrt_text_locale.xml file with the value(s) we intend to override (hint. Overview).
The image (above) shows an example of where the "Overview" display name is used in Active Workspace.
In the tc_xrt_text_locale.xml file, modify the file to only include (1) entry.
<textsrvfilename="tc_xrt_text_locale.xml">
<!-- XML Rendering Template(XRT) key(s): tc_xrt_<Key> -->
<keyid="tc_xrt_Overview">Overview</key>
</textsrv>Be certain to erase any <key lines that you do not intend to override. Only the overridden or new <key's should remain. The system will "fall back" to the server (%TC_ROOT%) for the out of the box values which are not overridden.
Our goal is to replace the display name "Overview" with the value "Summary". The following code definition shows the resulting <key value.
<textsrv filename="tc_xrt_text_locale.xml">
<!-- XML Rendering Template(XRT) key(s): tc_xrt_<Key> -->
<keyid="tc_xrt_Overview">Summary</key>
</textsrv>The resulting file will resemble the image (below).
No other adjustments were made to the file except between the <textsrv and </textsrv elements. Anything outside of those elements was not altered.
Note. Don't forget to save the file.
4.) Update the %TC_DATA%\tc_profilevars.bat file with the TC_USER_MSG_DIR environment variable
Open the %TC_DATA%\tc_profilevars.bat file in an editor.
In the tc_profilevars.bat file, below:
set FSC_HOME=%TC_ROOT%\fsc add the following environment variable.
set TC_USER_MSG_DIR=C:\Apps\Siemens\TCAW\AW5_textserver\lang\textserver