Contents

Architecture concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

Learning Active Workspace architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Learn declarative contributions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Declarative action: navigate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Declarative conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Declarative panel walk-through . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
appCtxService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-13
What are intermediary objects? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-14
Registering type icons with a declarative contribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-14
Using visual indicators to quickly recognize a property . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-16
Using a sublocation to display a custom page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-17
Declarative user interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-18
Declarative UI introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-18
Declarative kit & module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21
Declarative control of sublocation visibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-24
Declarative view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-26
Declarative view model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-29
Declarative messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-32
Learn the declarative command architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-33
Declarative command object - commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-33
Controlling command visibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-34
Declarative command object - commandHandlers . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-37
Declarative command object - commandPlacements . . . . . . . . . . . . . . . . . . . . . . . . . . 1-38
Declarative command object - activeWhen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-41
Declarative command object - visibleWhen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-42
Declarative command object - actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-44
Data providers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-45
Learn about data providers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-45
Use an existing server data provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-45
Creating a custom server data provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-49
Learn client-side data providers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-50
Learn the Active Workspace user interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-55
Basic interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-55
Global navigation toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-55
Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-56
Active Workspace back button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-56
Context control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-57
Global search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-57
Sublocations and primary navigation tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-57
Sublocation content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-58
One-step commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-59
Work area header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-60

AW008 4.0 Configuration 3

 Contents
Contents

Primary work area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-60

Navigation command bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-61
Secondary work area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-61
Secondary navigation tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-62
Tools and information command bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-62
Tools and information panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-63

Configuring the user interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

Active Workspace user interface configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

Configure the viewer for your non-CAD assemblies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Configuring the gateway page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Overview of the gateway page configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Add new type and tile icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
Reset the gateway page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
Repin a tile to the gateway page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
Protect a tile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8
Hide a tile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
Configure the HELP tile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
Create a new collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
Create a new tile type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
Create a new tile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13
Add a tile to a collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14
Tile template action types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-15
Tile action — default . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-15
Tile action — external link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-16
Tile action — static resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-17
Create a new tile action — command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-18
Theme index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-19
Tile sizes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-20
Dynamic compound properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-20
Learn about dynamic compound properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-20
Dynamic compound property syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-21
Using dynamic compound properties with XRT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-29
Using dynamic compound properties with column configuration . . . . . . . . . . . . . . . . . . . 2-29
Configuring page layout using style sheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-30
XRT Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-30
XRT information specific to Active Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-31
Configuring tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-40
Working with HTML panels in XRT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-51

Working with platform customizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

Enable a custom business object in Active Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

Integrate custom services into the Active Workspace build . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

Example customizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

Hands-on: Changing Active Workspace behavior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

The Active Workspace development environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Using generateModule to create boilerplate definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3

4 Configuration AW008 4.0

 Contents

Add a new theme to your module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4

Example: Create a new command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7
Example: Create a visual indicator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
Example: Create a sublocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13

Configuring Active Workspace features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1

Active Collaboration configuration . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . 5-1

Active Collaboration configuration tasks . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . 5-1
Deleting commentary . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . 5-2
Disable ratings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . 5-2
Active Content configuration . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . 5-3
Active Content configuration tasks . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . 5-3
Configuring the Content tab . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . 5-4
When is configuration needed? . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . 5-5
Add custom objects to the Content tab and search . . . . . . . . .. . . . . . . . . . . . . . . . . . . . 5-5
Adding an LOV to a property in the Content tab . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . 5-6
Display the Content tab with custom business object types . . .. . . . . . . . . . . . . . . . . . . . 5-6
Add commands to the content tab . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . 5-7
Add shared effectivity information to Overview tab . . . . . . . . .. . . . . . . . . . . . . . . . . . . . 5-7
Display the view type attribute in the BOMLine title . . . . . . . .. . . . . . . . . . . . . . . . . . . . 5-7
Active content technical overview . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . 5-7
Setting security on structured content . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . 5-8
Using the Awb0BOMArchetypeToOccurrence type constant . .. . . . . . . . . . . . . . . . . . . . 5-8
Mapping type to model element . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . 5-9
Marking archetypes to support structure . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . 5-9
Configuring the properties of structured content . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-10
Configuration for the packing of similar structure elements . . .. . . . . . . . . . . . . . . . . . . 5-10
Mapping properties to occurrence properties . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-11
Cleaning up background working contexts . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-12
Enable the sharing of a saved working context . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-12
The default revision rule for a product structure . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-13
Implementing full text search of structures . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-13
Configuring BOM precision . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-13
Confidentiality agreement configuration . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-13
Overview of confidentiality agreement . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-13
Configure the stand-alone confidentiality agreement . . . . . . .. . . . . . . . . . . . . . . . . . . 5-14
Change management configuration . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-14
Change management configuration tasks . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-14
Automating the submission of changes to workflow . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-16
Configuring how changes are derived . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-16
Defining deep copy rules for creating changes . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-17
Configuring the Changes page . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-18
Classification configuration . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-21
Classification configuration tasks . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-21
Visual navigation cards . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-22
Configuring interchangeable attributes . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-23
Viewing DWG and CGM class images in the Classification tab . . . . . . . . . . . . . . . . . . . 5-24
Digital signature configuration . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-24
Digital signature configuration tasks . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . 5-24

AW008 4.0 Configuration 5

 Contents
Contents

Enable digital signature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-26

Geography access configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-28
Overview of geography access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-28
Configure geography access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-29
Configure confidentiality agreement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-30
License attachment configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-32
Overview of license attachment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-32
Adding the License List panel to custom XRT pages . . . . . . . . . . . . . . . . . . . . . . . . . . 5-33
Attaching licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-33
Localization configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-36
Localization configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-36
Configure the web application file generation for other locales . . . . . . . . . . . . . . . . . . . . 5-36
Locale support by Visualization Server Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-38
SLM configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-39
SLM configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-39
Configuring physical structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-40
Program Planning configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-41
Program Planning configuration overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-41
Program Planning pre-configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-42
After installation Program Planning configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . 5-44
Configure out-of-the-box Program Planning LOVs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-45
Assign colors to the program event LOVs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-47
Define Program Planning security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-48
Add custom program and project objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-49
Share Program Planning data between Teamcenter sites . . . . . . . . . . . . . . . . . . . . . . . 5-51
Define STAMs and STVMs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-52
Relations configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-57
Relations configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-57
Creating new views or updating existing views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-59
Example of configuring views: configure relations expansion . . . . . . . . . . . . . . . . . . . . . 5-62
Example of configuring views: localize names that appear in the custom Relations Legend
views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-63
Configuring what views appear in the Relations Legend . . . . . . . . . . . . . . . . . . . . . . . . 5-63
Configuring what user interface style to apply to objects and relations . . . . . . . . . . . . . . . 5-63
Specifying user interface styles such as shapes and colors . . . . . . . . . . . . . . . . . . . . . . 5-65
Example of configuring user interface styles: configure the style of nodes and edges . . . . 5-65
Specifying what properties are visible in the object properties filter . . . . . . . . . . . . . . . . . 5-66
Configuring object expansion button in the one-step commands . . . . . . . . . . . . . . . . . . 5-66
Configuring how edges attach to objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-66
Schedule Manager configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-67
Schedule Manager configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-67
Map custom schedule task properties between Microsoft Project and Teamcenter . . . . . . 5-68
Search configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-69
Search configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-69
Configuring structure indexing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-69
Using Quick Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-93
Configuring shape search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-94
Changing the default thumbnails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-94
Security configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-95

6 Configuration AW008 4.0

 Contents

Security configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-95

Configure sequence of the postlogon stages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-96
Configure logoff for Active Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-96
Configuring multiple application IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-97
Configuring load balancer time-outs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-98
Configuring location codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-98
Configure project-level security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-102
Configuring a two-way SSL proxy server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-103
Configuring HTTP GET redirect method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-104
Configuring a logoff landing page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-104
Protecting against cross-site request forgery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-105
Simulation Process Management configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-106
Simulation Process Management configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . 5-106
Configure the Simulation-related objects table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-107
Configure traversal paths for simulation objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-110
Subscriptions configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-142
Subscriptions configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-142
Configuring notifications for a two-tier environment . . . . . . . . . . . . . . . . . . . . . . . . . . 5-143
Configuring subscribable properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-144
Setting subscription notification preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-145
Visualization configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-147
Visualization configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-147
Configure TCCS environments for Visualization . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-148
Specify the address for the Teamcenter SOA service . . . . . . . . . . . . . . . . . . . . . . . . . 5-148
Configure viewer for SSO-enabled environment (Teamcenter 11.x) . . . . . . . . . . . . . . . 5-149
Configure viewer for SSO-enabled environment (Teamcenter 12.x) . . . . . . . . . . . . . . . 5-150
Optimizing Visualization Server system performance . . . . . . . . . . . . . . . . . . . . . . . . . 5-152
Disable application pool recycling for visualization . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-156
Enable compression of client-side rendering traffic . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-157
Enable Visualization Server Manager logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-157
Configure the Visualization Pool Assigner for JMX metrics . . . . . . . . . . . . . . . . . . . . . 5-158
Configure user service level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-159
Specifying viewer defaults using Teamcenter preferences . . . . . . . . . . . . . . . . . . . . . . 5-160
Configure the Fit command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-161
Adjusting the display resolution for 3D models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-162
Configure display units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-162
Configure measurement precision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-164
Workflow configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-165
Workflow configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-165
Configuring resource pool assignments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-166
Setting conditions for workflows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-166
Showing user assignment options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-166
Configuring the Inbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-167

Configuring Active Workspace in other products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

Host Active Workspace in Client for Microsoft Office . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

Host Active Workspace in standalone Lifecycle Visualization . . . . . . . . . . . . . . . . . . . . . . . . 6-1
Host Active Workspace in Adobe Creative Cloud applications . . . . . . . . . . . . . . . . . . . . . . . . 6-3
Hosting preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4

AW008 4.0 Configuration 7

 Contents
Contents

Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1

Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1
Introduction to utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1
Quickly verify your customizations using Express . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-42
What is Express? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-42
How do I install Express? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-43
How do I use Express? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-43
Business Modeler IDE constants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-43
Global constants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-43
Business object constants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-44
Property constants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-46
Configuring the Audit Logs page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-55
Audit Logs page configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-55
Activate the Audit Log page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-56
Customize audit logs field display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-57
Viewing audit logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-58
Customize the audit log display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-60
Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-61
Teamcenter preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-61
Controlling notification timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-62
Defining the properties that display on tiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-62
Defining the revision rules list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-62
Custom preferences in Active Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-63
Performance and settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-63
Modify Active Workspace settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-63
Enabling browser caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-64
Compressing images for loading them quickly . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-65
Configure image resolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-65
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-66
Open source software attributions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-66
Retrieving Active Workspace client and server versions . . . . . . . . . . . . . . . . . . . . . . . . 7-66
General troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-67
Visualization monitoring and troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-68
Monitoring browser activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-86
Managing groups, roles, and users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-86
Groups, roles, and users in Active Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-86
About the PEOPLE tile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-90
Creating users, roles, and groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-91
Change the user password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-98
View user activity logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-98
Use logical objects to consolidate properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-99
Logical Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-99
Logical object configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-100
Workspaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-103
Learn about workspaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-103
Create the workspace definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-104
Create or update workspace mappings using utilities . . . . . . . . . . . . . . . . . . . . . . . . . 7-106
Assign style sheets to a workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-108
Create or modify column configuration for a workspace . . . . . . . . . . . . . . . . . . . . . . . 7-109

8 Configuration AW008 4.0

 Contents

Verifying your new workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-110

XRT element reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-111
Learn the column style sheet element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-111
Learn the objectSet style sheet element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-112
Learn the section style sheet element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-115

AW008 4.0 Configuration 9

Chapter 1: Architecture concepts

Learning Active Workspace architecture

What is Active Workspace ?
The Active Workspace client framework presents Teamcenter and its applications, as well as other
data sources, in an intuitive user interface, rather than the traditional interfaces and applications
that targeted expert users.

How does it work?

Active Workspace is a web application that connects to Teamcenter and other data sources in order
to present a consistent interface for the user. With Teamcenter, it communicates with the web tier
of the four-tier architecture, relaying user interaction and presenting the results. In this capacity, it
can replace other Teamcenter clients.

What configuration mechanisms are there?

The user interface (UI) includes few main mechanisms for easy extension.
• Declarative locations

• Declarative commands

• XML rendering templates (XRT, also known as style sheets)

What do I need to do before configuring?

The Active Workspace interface consists of many components. Learn the Active Workspace user
interface terms for these components.
Learn how a declarative panel works with a declarative panel walk-through.
Visit the UI Pattern Library in the Active Workspace section of the Doc Center.

Note
Many of the more involved platform modifications require the use of the Business Modeler
IDE. Check the Teamcenter platform documentation to learn what is required.

Learn declarative contributions

Declarative action: navigate
You can use the Navigate action to take the user to a specific page.

AW008 4.0 Configuration 1-1

 Chapter
Chapter 1: 1: Architecture
Architecture concepts
concepts

The UI Pattern Library on Doc Center maintains the up-to-date syntax and options.

Example: Zero-compile command example for Open

In this example, you examine the OOTB command handler for the Open command. This command
handler references the showObject action, defined in the actions section.

The showObject action is defined as being a Navigate action type which will navigateTo the
com_siemens_splm_clientfx_tcui_xrt_showObject page, and it will send along the UID of the
selected object as a parameter.

The base activeWhen and visibleWhen condition expressions are shown for reference.

Example: Override the Open command

In this example, when a project object is selected the OOTB Open command is overridden
so that it takes the user to ProjectContents instead. This command handler references the
TcProjectShowDelegatedObject action, defined in the actions section.

1-2 Configuration AW008 4.0

 Architecture concepts

The TcProjectShowDelegatedObject action is defined as being a Navigate action type which will
navigateTo the ProjectContents page, and it will send along the UID of the selected object as a
parameter.

You must never broaden an existing command condition. Include the original condition to use as the
base in order to ensure you are more specific. In this example, the original condition is ANDed with the
new condition to check the selected object to see if it is a TC_Project type. This ensures that this new
delegate command handler does not allow the Open command to be run outside of its normal design.

Using the navigateIn attribute

You can use the navigateIn attribute to open the new page in either a new browser tab or a new
browser window instead of the normal behavior of replacing the current browser contents.

AW008 4.0 Configuration 1-3

 Chapter
Chapter 1: 1: Architecture
Architecture concepts
concepts

newTab Opens the new page in a new browser tab.

newWindow Opens the new page in a new browser window. You can specify attrbutes for
the new window using the options attribute.

Declarative conditions
You can use conditions to provide logic in your view model.
Conditions:
• Evaluate to either true or false.
• Can refer to other conditions.
• Evaluate live data.
• Can leverage Boolean operations.

Expressions

Condition expressions can be expressed as a simple string,

or as a JSON object.

1-4 Configuration AW008 4.0

 Architecture concepts

Operators

The following operators are supported with expression definition objects.

$source Indicates the reference on the data context node to be used as starting point
for evaluation.
$query Defines the query to be executed on the $source.
$all Applicable when the $source is an array. Indicates that query result should be
valid on all instances of the array elements.
$and A logical AND of each query result.
$or A logical OR of each query result.
$adapt The resulting $source should be adapted before evaluating the query. Active
Workspace sometimes uses intermediary runtime objects that represent
other objects. An example of this is the Awp0XRTObjectSetRow object in
objectSet tables. When you use $adapt the condition uses the target object
instead of the intermediary object.
$in The query should match with at least one of the value from the array.
$notin The query should not match with any value from the array.
$eq Equal.
$ne Not equal.
$gt Greater than.
$gte Greater than or equal to.
$lt Less than.
$lte Less than or equal to.

Example
Use of $and: Enable this command handler when the selected object type is Folder
AND object_name is Newstuff

AW008 4.0 Configuration 1-5