Professional Documents
Culture Documents
Student Notes:
Foils
ENOVIA SmarTeam
Administration for
Foundation, Editor
and Web Editor
Version 5 Release 19
January 2009
EDU_SMT_EN_STA_FF_V5R19
Student Notes:
Targeted audience
New SmarTeam Administrators
Prerequisites
24 Hours
Admin Functionality
The Application Setup
Using Application Setup
System Configuration Editor
Overview
System Configuration Override Levels
10
11
25
71
89
112
126
127
146
167
168
173
199
200
202
206
207
208
222
223
237
255
209
210
211
212
213
216
217
218
219
220
221
259
260
282
Miscellaneous
319
320
322
324
326
310
Student Notes:
The Form Designer allows the user to define the Form Definitions
of the profiles card in SmarTeam.
Student Notes:
Student Notes:
Student Notes:
Student Notes:
10
Student Notes:
You will become familiar with the various objects in the Data Model.
11
Student Notes:
The Data Model should reflect the business objects used in a company; like, projects,
documents, parts and more.
The Data Model in real life will be based on the customer PLM environment and the type of
industry they are working in:
SmarTeam F&A scenario and SmarTeam E&E scenario provide guidelines for these
industries.
The examples used in this training are more to show the capabilities and do not necessarily
reflect a real business scenario.
12
The Scenario
Talk-and-Run wants to create a Bill of Material (BOM) structure of their products in the
SmarTeam Editor.
We will design a data model to represent Talk-and-Runs BOM structure.
Associated Documents
Silver Prices.doc
Turbo specs.doc
Antenna. CATPart
LED display. CATPart
Turbo keypad. CATProduct
o Soft Buttons x 12
o Turbo Buttons x 3
13
Data Model
Products
Documentation
Folder
Document
Parts
Standard Parts
Standard Part
Standard Assembly
Data
The Silver
Speaker
Silver Prices.doc
Turbo specs.doc
Antenna. CATPart
LED display. CATPart
Turbo keypad. CATProduct
Custom Parts
Custom Part
Custom Assembly
Software
14
Student Notes:
You design the data model to categorize objects with similar properties into classes.
The data model is designed in the form of a tree structure of CLASSES.
The data can be represented in the SmarTeam Editor as a tree structure of Objects.
Class Tree
Products
Object Tree
Documentation
O Silver Speaker Assembly
Folder
o Antenna x 1
o LED Display x 1
Document
o Turbo-dial keypad x 1
Parts
o Soft Buttons x 12
Standard Parts
o Turbo Buttons x 3
Standard Part
Standard Assembly
15
Class Attributes
Objects of the same class share common properties called Attributes.
Products [weight]
The Silver
Speaker
The Charcoal
Chatter
Antenna
Battery
16
Class Mechanisms
Student Notes:
Objects of the same class have the same CLASS MECHANISMS (behaviors).
Non Standard Parts [Revision Control]
Example of attributes added for Revision Control:
Revision, Previous Revision, Date of First Revision Creation
Documentation [File Control]
Example of attributes added for File Control:
File Name: Silver Speaker assembly instructions
Directory: J:\SilverSpeaker
File Type: Word Document
17
Super Classes
A Super Class is the topmost class in any branch of a class tree.
Super Classes allow you to organize information into generic categories.
CLASS TREE
Products [weight]
SUPER CLASS
Documentation
Folder
Document
Parts [part #]
Standard Parts
Standard Assembly
18
Projects
Documentation
Folder
Document
Parts
Standard Parts
Standard Part
Standard Assembly
19
Leaf Classes
Leaf Classes are the bottom-most classes of a tree.
A Leaf Class represents the physical object.
CLASS TREE
Projects [weight]
Documentation
Folder
Document
Parts [part #]
Standard Parts
LEAF CLASS
20
Copyright DASSAULT SYSTEMES
20
Student Notes:
CLASS TREE
SUPER CLASS
ABSTRACT CLASS
Projects [weight]
Documentation
Folder
Document
Parts [part #]
Standard Parts
Standard Part [material, color]
Standard Assembly
21
Class Composition
Using the Class Composition, you can define whether or not an object may be
composed of other objects.
Turbo-dial keypad
(Standard Assembly)
Soft button
(Standard Part)
Turbo button
(Standard Part)
IMPORTANT: An object can be composed only of objects from the same super class of a tree.
22
Student Notes:
Using the Add as Top Level option, certain leaf class objects may be added to the
top of an object tree, while other leaf class objects may only be added below other
objects.
In the example below, objects of the Folders class may be added at the top level of
the Documentation tree, but objects of the Document class may only be added at a
lower level.
Top Level
Second level
23
To Sum Up
Student Notes:
When designing a SmarTeam - Editor data model, it is important to take into account
the data modeling tips in this module, in order to ensure good performance, easy user
navigation etc.
24
Student Notes:
You will learn how to create the data structure or modify the existing data structure
using the Data Model Designer.
25
Student Notes:
The SmarTeam - Data Model Designer allows the administrator to perform the following
operations:
Create data structures based on existing templates
Create completely new templates
Modify existing databases
26
Define Class
Composition and Link
Attributes
Create/Load
Template
or database
3
Define Classes
5
Define Links
Define Class
Attributes
8
7
Save Template/
Create Database
27
Source Database
Destination Database
Wizsrc
(MS-SQL)
Oracle/ MS-SQL
/DB2
Contains system-defined
templates, user-defined templates
Student Notes:
28
Student Notes:
SmarTeam Directory
MS SQL Database Files
29
Student Notes:
Launch from Start > All Program > SmarTeam > Administrative Tools > Admin Console.
30
Menu Bar
Student Notes:
31
Loading/Creating a Template
Student Notes:
32
Student Notes:
33
Selecting Mechanisms
Student Notes:
Select Mechanisms
A mechanism is a function (functionality/behavior) that can be enabled or disabled in a
SmarTeam database.
When a mechanism is enabled, the SmarTeam Data Model Designer adds tables and meta
data to the database, to support this mechanism.
34
Student Notes:
35
Super Classes
36
Student Notes:
You can view the class structure you created in the SmarTeam Data Model
Designer with Search by Attribute window in SmarTeam Editor.
37
Student Notes:
It is Strongly recommend not to change the default values of Table Name & Class Prefix.
38
Student Notes:
39
Top Level
2nd Level
40
Copyright DASSAULT SYSTEMES
40
Supported integration
mechanisms
41
Class Mechanism
42
Lifecycle Operations
are enabled
43
Student Notes:
File Info fields and the Viewer tab are displayed on the profile card of objects,
as defined with the File Control mechanism.
44
Student Notes:
45
Student Notes:
Class attributes are displayed as fields in the SmarTeam Editor Profile Cards.
Class
Attributes
46
Name assigned
by the SmarTeam Editor
Determines the type of data
stored in this attribute
Size of attribute in bytes
47
Select an attribute
of a class.
A class tree
window pops up.
Select a referenced
class.
48
Student Notes:
Objects of the referenced class are displayed as a drop down list in the
referencing field.
49
1
Select the type of Lookup Table
4
Create a
lookup table
Select a
lookup table
To add values to Lookup Table, select Lookup Tables from Tools menu and precede
as described in Adding Values to a Lookup Table in Basic Administration Course.
50
1
Select attribute
51
3
1
2
Select the Class whose
composition is to be defined
52
Classes in
Composition
Composition
not defined
53
Student Notes:
54
Student Notes:
Note: SmarTeam by default supports linkage of objects only once and will give a message when the user
wants to link two objects twice. In an instance based BOM however one part can appear on different
locations in the BOM. To support this link behavior the unique index for the link needs to be expanded with
the balloon number/find number/operation sequence depending on the usage of the BOM
55
Student Notes:
CAD Link Types, which can be created only via the Integration, are managed by the
integration and require the user to work through the integration.
CAD Link Types are visible in a separate link tab for each CAD integration, depending
upon the selected object.
56
Student Notes:
CAD Link types are added when the Database Level Mechanism is activated and then
the Class Mechanism is selected for relevant classes.
57
Hierarchical Links
Parent-child relationships are referred to as Tree links or Hierarchical Links.
Turbo-dial keypad
(Standard Assembly)
QTY = 12
Soft button
(Standard Part)
QTY = 3
Turbo button
(Standard Part)
Hierarchical Links also have attributes. A typical hierarchical Link attribute is Quality.
58
Logical Links
Logical Links can be created to link objects that belong to different Super Classes.
Logical Links also have attributes.
In this example the supplier part # is stored in a link attribute of the link that
connects a supplier and a purchased part.
pp
[su
#]
art
p
lier
LED Display
(Purchased Part)
par
t #]
3mm Antenna
(Purchased Part)
[su
pp
59
60
Student Notes:
Logical Link attributes are displayed in the grid on the SmarTeam Editors Profile
Cards on the Links tab.
Links Tab
from Parts
61
Student Notes:
Logical Link attributes are displayed in the grid on the Attributes Link tab in
an associated objects structure.
62
Define the type of data that can be added to the selected field
63
Student Notes:
64
A default Profile Card (Auto Form) is created for each Class by the SmarTeam Data
Model Designer.
65
Student Notes:
Auto Forms are designed according to Options defined on the Wizard Options\Profile
Card tab.
66
Student Notes:
Use Form Wizard to modify tabs, allocate attributes to tabs and format labels and
fields.
Global design of
Profile Cards
Design individual
Profile Cards
Regenerate default
Profile Cards
67
Creating a Database
At this stage, you should verify that no other connections to the destination database
exist.
Note: If a connection exists, some tables may not be created correctly, resulting in
corruption of the database.
68
Student Notes:
69
To Sum Up
Student Notes:
Create a SmarTeam database structure using the SmarTeam Data Model Designer.
Load/create a template.
Define classes and class attributes.
Define logical links.
Define composition and hierarchical links.
Design forms with Auto Forms and the Form Designer.
70
Student Notes:
71
Student Notes:
When building a new database, the first requirement is to have an empty destination
database.
The SmarTeam WizDst.MDF file is an empty database designated for the creation of a
new database. The empty database needs to have a user (in the MS SQL environment
SmarTeam is using the user SmarTeam). This user should have db_owner rights.
72
Student Notes:
Select
Destination
Database.
73
Student Notes:
Fill in the Company Name and Database Name for the destination database.
Note: The MDF file will still be called WizDst.mdf.
74
Student Notes:
The SmarTeam Data Model Designer has created an empty database with the right
data model. The file is still called WizDst.mdf.
To create an enterprise database, you need to create a database instance in the
new database environment. See the relevant documentation for Oracle, DB2 and
Microsoft SQL server.
Installation of the SmartDBExplorer is available in CD1 with other Administration
tools. After installation the file will be available in the <home>/bin directory.
75
Student Notes:
76
Student Notes:
77
Student Notes:
78
Student Notes:
After successful creation of the new database, there might be two identical
databases defined with the same ReplicationID.
In order to work on the new database, the old database needs to be detached
(temporary) and use DBRegistration to generate a new unique ReplicationID for
the new database.
79
Student Notes:
In case errors occurred during the copy process, the DBRepairing utility will fix the
most foreseen errors.
The DBRepairing.exe can be found as install in the Kits directory of the SmarTeam
CD always use the latest one from the latest service pack
Indexes have:
Validation
Repairing
Index Shortening
DB Statistics
80
Student Notes:
81
Student Notes:
Therefore you need to be able to handle MS SQL database, derived or copied from
the same MS SQL database.
82
Student Notes:
83
Student Notes:
84
Student Notes:
85
Student Notes:
It is a new database
registration.
86
Student Notes:
In case you need to backup or delete a MS SQL database from your local server you can
use the OSQL command line
Login to the SQL command line processor:
OSQL S <ServerName>\SmarTeam d master U sa P sa
Prepare a device for the backup target:
EXEC sp_addumpdevice disk, SMBackup, c:\SQLBackup\BackuSmBackup.dat
GO
Backup the database:
Backup Database SmDemo to SMBackup
GO
Restore the database:
Restore Database SmDemo from SMBackup
GO
Delete the database:
Drop Database SmNewDemo
GO
87
Using SmFiles
Student Notes:
You might need to change file paths in the database to adjust it to your customer
environment:
smfiles -aConnectionString -pDatabasePassword [-i] [old-path] new-path
Use parameter -i for showing progress information.
Please note that the connection string must be inserted using inverted commas.
e.g.: smfiles.exe -a"Provider=SQLOLEDB.1;Persist Security Info=False;User ID=SmarTeam;Initial
Catalog=SmDemo;Data Source=ukibm123\SmarTeam" p SmarTeam "C:\SmarTeam" "C:\Program
Files\SmarTeam" I
This will change in SmDemo all occurrences of
C:\SmarTeam
by
C:\Program Files\SmarTeam
88
Student Notes:
You will learn how to create Profile Cards using the Form Designer, and the Web Form
Designer.
89
Student Notes:
Use the Form Designer to modify the appearance of the Profile Cards.
You can define field and label sizes, create lookup fields, modify tabs etc.
1
You can access the Form Designer from Start > All Programs >
SmarTeam > Administrative Tools > Admin Console.
90
91
Student Notes:
4
The profile card and the Form Designers main menu are displayed.
5
Click on the Form Designer tool
bar to add fields, labels, etc.
to the profile card .
6
Use multiple tabs to categorize
fields. Copy and paste components
to the user-defined tabs.
92
Student Notes:
Label
Text Edit
Lookup
Memo
Ref to Class
93
Viewer
Radio Button
Check Box
Date Edit
Image
94
Script Button
HTML Browser
File Browser
Vault Browser
Hyperlink
95
Student Notes:
7
Display and modify properties of the fields
by selecting a field and pressing F4.
8
For TextEdit fields, select the column (attribute).
96
Student Notes:
10
Assigning scripts on
startup or exit of a
Profile Card.
11
97
or
14
or
98
Student Notes:
1
Click on the Lookup tool from the Form Designer
toolbar in order to add a new lookup field to the
working form.
Combo Box
2
A field is added to the form and the properties
window is displayed. In the column field, select
the database field to be linked to this field.
99
Student Notes:
100
Student Notes:
Add a Reference to the Class attribute to the Profile Card using the Form Designer.
Avoid many references to a class for the same Profile Card. It will affect performance. Also reference to
class is preferred to be used for references to classes with a low number of records (caching in update mode)
101
From the Form Designer, open the attribute profile card of the Class
whose attribute references another Class.
Student Notes:
2
Double click on the Multi-combo box tool from the Form Designer
toolbar to add a new Reference to Class attribute to the working
form.
3
An attribute is added to the form and the properties window is
displayed. In the option Column, select the database attribute to be
linked to this attribute.
4
From the Form Designer, open the attribute Profile Card of the class
whose attribute references another Class.
102
Student Notes:
5
The Projection Details selection screen is
displayed.
Click Add to add a new projection or select
to select an existing one.
6
7
Enter a Separator (e.g. comma, tab) to
separate displayed attributes.
8
Click the Attributes button and select the
attributes to displayed.
9
Click the Search name field browse button
and select: add a query for this projection.
Click OK to save.
103
Student Notes:
SmarTeam Quick Find enables you to search for an object using the Quick Find Profile
Card. In the Profile Card, you can use the most popular attributes for a specific Class.
QuickFindMode = False
QuickFindMode = True
104
Student Notes:
Web Form Designer utility design and modify the layout and content of SmarTeam
Web Editor Profile Cards.
105
Student Notes:
The Web Form Designer utility opens displaying the selected Profile Card.
106
Student Notes:
Working Area
107
Student Notes:
108
Student Notes:
Visibility of
attributes in the
various modes.
109
Student Notes:
To insert a table:
Click on the desired field.
From the menu bar, select Insert,
Table. Note: Default table: 3 X 3.
110
To Sum Up
Student Notes:
Understand the common approach for defining control types where the WEB
Editor has the advanced feature to show/no show attributes.
111
Student Notes:
You will become familiar with the Sequence Designer Tool, the Default values, and the
Integration Tools Setup utility.
112
Student Notes:
You use the Sequence Designer to create and modify masks. SmarTeam uses the
mask to increment a number automatically in a specific field of a Profile Card.
1
Access the Sequence Designer from
Start > All Programs > SmarTeam > Administrative Tools > Admin Console.
2
The most common use of a mask is for the primary ID number of a class and for revision numbers.
113
Select an attribute.
5
Click Link to create a mask or
modify the current one
114
7
Click Select to assign the selected
pattern to the attribute.
115
Student Notes:
9
Enter the formula by which SmarTeam will
increment the numbers in this field and click Check
Pattern.
10
Enter a baseline
value and click Set.
116
Student Notes:
11
Check the Revision mode checkbox if you are
setting a mask for a revision number field.
12
In the Separator field, enter the type of separator to
separate values in the mask field.
For example, if you enter a dot, the values will be
displayed like this: a.9.
13
117
Student Notes:
14
Click the Wildcard checkbox to define characters as
wildcards; if not checked characters are set as
constants.
15
In the Range field, define the limit of the increment
16
118
Student Notes:
The Default Values tool defines the default values for a specific attribute in a
SmarTeam Class. When you add a new object, the default values are automatically
assigned to the attributes for which default values have been defined.
1
Access the Default Values utility from Start > All Programs > SmarTeam >
Administrative Tools > Admin Console.
2
Login with Administrator rights.
Example of default values: You can define that the default value for the Phase field in the
Documents class is Design. When a SmarTeam user opens a Profile Card in the
Documents Class, the Design value for the Phase field is automatically displayed.
119
4
Enter Default Values.
To set a value of a Lookup Table as the default value, you must first add the
value to the Lookup table. (See following section on lookup tables.)
Ref To Class type of fields cannot have default values.
120
Student Notes:
The Setup Default for a Lookup Table appears in the Profile Card as a dropdown list.
You must fill in a field with a value from the list. Here are some examples of lookup
tables (taken from the SmDemo database):
Example 1:
Example 2:
121
Student Notes:
122
Student Notes:
Create an attribute for a Class in the Data Model Designer and assign the type
Lookup to this attribute.
Next define a Lookup Table to the attribute.
For Example create a table named Department.
Add Values to the lookup table Department from within SmarTeam Editor.
Add a lookup field on the Profile Card using the Form Designer.
123
Student Notes:
2
A list of Lookup Tables is displayed.
Click the Values button.
124
3
The Description dialog box Adds or Modifies
values and sets the order in which values are
displayed.
If the default value if set, it will be highlighted.
Sort Ascending/Descending.
125
Student Notes:
User Maintenance
Project-Based Authorizations
126
User Maintenance
Student Notes:
You will learn how to create Users, Groups, and Roles in ENOVIA SmarTeam.
127
Student Notes:
The User Maintenance module allows you to set up passwords, groups and roles
and global authorizations in SmarTeam.
1
You can launch the User Maintenance from Start > All Programs >
SmarTeam > Administrative Tools > Admin Console.
2
Login with Administrator rights (the default administrator is Joe).
Note: Any user can login to the User Maintenance. If the user is not an
administrator, the Change Password option is the only available function.
128
Password
Authorizations
Users
Roles
129
Student Notes:
130
Remove a group
131
Remove a Role
132
Student Notes:
1
From the User Maintenance main
screen, click the Users button.
133
Student Notes:
3
Enter a user login name and a password
(optional).
In case you want to use the e-mail notification
from within SmarTeam the valid e-mail address is
required.
4
Click the Advanced tab, to define the
LDAP setting and Account Setting
(when appropriate).
5
134
Student Notes:
6
Select a user from the Users list.
7
Select the group(s) in the User groups
window to which the user will be assigned.
8
Click the right arrow button.
9
Repeat steps 6 to 8 for Roles.
135
Assigning Authorizations
Student Notes:
In case Project Based Authorizations are defined as Database Level Mechanism, it is also
possible to deny authorizations for Authorization Groups in the data model. In this case the
Minus will overrule the positive assignments.
A user, group or role can have Administrative rights by Set Admin Authorization.
136
2
Select Class
Operations
for the
selected
class
3
Assign positive authorizations where
you decide it is appropriate to do so
137
Student Notes:
To check all the options in a row or column, double-click on the name field.
You can select more than one class in the left window, with SHIFT or CTRL
buttons. Use Unselect All Classes button to unselect.
Before removing authorization from a user, check that the groups the user
belongs to, does not have authorization.
138
Changing Passwords
Student Notes:
1
From the User Maintenance main screen,
click the Password button
2
Enter the password twice and click OK.
Note: Users with non-administrative rights can modify their own password from this screen.
139
Student Notes:
This mechanism enables the authentication of SmarTeam users against the LDAPbased server.
140
2
Click Next
141
4
Click Next
142
Select:
Copy in order to copy the report
to the clipboard
or Save To File to save the report
to a disk.
6
Select Finish
143
Student Notes:
In order to work with the LDAP, the Authentication protocol must be set to LDAP.
The Authentication Manager is one of the Administration Tools and is described in
the Installation Section of this class.
Once all users are imported into SmarTeam, the company can still use SmarTeam
authentication for the database.
LDAP authentication still requires the user to be defined in SmarTeam too.
144
To Sum Up
Student Notes:
How to Import users from a LDAP and optional assign LDAP authentication.
145
Student Notes:
146
Student Notes:
147
Terminology Overview
Student Notes:
Authorization
The right granted to an individual or process to use a system and the data
stored on it. This is the process of determining what activities or access to
data are permitted to the (authenticated) user or process.
148
Student Notes:
149
Global Roles
Student Notes:
150
Role in Project
Student Notes:
A user may have a role (or roles) which is relevant only in a context of a specific
project.
When the Project Manager assigns a user to a project using SmarTeam Editor or
Web Editor, he can provide him with one or more roles.
A user can have different roles in different projects.
The roles a user has in a Project can be different than his global roles.
151
Student Notes:
Restricted Project: Allows the possibility to restrict the authorizations for objects
that belong to it, compared to the global authorizations.
Regular Project: Standard SmarTeam Behavior, plus the authorizations as
relevant for the users assigned with roles in this project.
152
When an object may be affected by project authorization, the user can create an
association with a project.
The association will be visible displayed as a general link between the project and the
object.
The authorizations for the object will be determined according to the regular SmarTeam
authorizations.
153
Student Notes:
154
Student Notes:
Global authorization of the user assigned though the User himself, the
User Group(s) and the User Global Role(s).
Denials of authorization - defined in one of the user groups to which he
belongs at the global level overwrite any positive authorization.
155
Student Notes:
Example
Since the document is not associated to any secured project, Joe has the right to Check In
and Check Out the document.
Delete is denied because of his membership of the external user group.
156
Student Notes:
157
Student Notes:
Example
n
atio
z
i
r
ho
ts
aut men
l
l
Fu Docu
on
The Secured By link for the document assigns the role of Engineer to Joe on top of
the global defined authorizations for the Role and Group.
Although Joe has Delete authorization through the role of Engineer in the project,
this operation is still denied, because of his membership of the External User group.
Joe can Check In and Check Out the document.
158
Student Notes:
159
Student Notes:
Example
te
ele
D
nd
e a ents
s
a
le
um
Re doc
160
Student Notes:
The authorizations for the object will be calculated based on the following rules:
Sum of authorizations of the user according to his roles only in the restricted
projects by which the object is secured.
Denials defined in one of the user groups to which he belongs at the global level.
161
Student Notes:
Example
te
ele
D
nd
e a ents
v
o
pr
um
Ap doc
Ch Ch
ec
e
k O ck I
ut n an
Do
cu d
me
nts
162
Student Notes:
Administrators
As a backup, Administrators can also perform the same operations as the
project manager.
163
164
Sub-Projects
Student Notes:
Sub project authorizations can be independent of the parent project with different
authorizations:
A sub-project can have only one parent project.
Objects may be related to any level of project.
When a sub project is created, authorizations will be copied from the parent project.
165
Sum:
Allow + Allow = Allow
Allow + Dont care = Allow
Allow + Deny = Deny
Dont care + Dont care = Dont care
Dont care + Deny = Deny
Deny + Deny = Deny
Object is secured
by projects?
Yes
Is project Restricted?
Yes
No
Sum=Allow
No
Sum Authorization from
Groups, Global Roles
and User
Sum=Dont care
Sum=Allow or Dont care
Sum Authorization
denials from Groups
Sum=Allow
Copyright DASSAULT SYSTEMES
Sum=Deny
Sum=Allow or Dont care
Sum=Allow
Operation is
Denied
Operation is
Allowed
166
Student Notes:
167
Script Maintenance
Student Notes:
168
Student Notes:
Use the Script Maintenance utility to link scripts to the SmarTeam Editor functions. You
can define scripts per Class and set them to run before, after or instead of an
operation.
You can access the utility from Start > All Programs > SmarTeam > Administrative
tools > Admin Console.
169
Student Notes:
In order to select a Class, click on the System or User Defined tab and double-click
on a field. The Script Browser opens.
170
Student Notes:
Double-click on the file name of the script to be linked and click OK to select the
script.
171
Student Notes:
The selected script is displayed in the field in the Script Maintenance dialog box.
All subclasses will inherit this script (inherited scripts are displayed in red).
172
Student Notes:
You will learn how to use the Menu Editor to create the different Menus.
173
Student Notes:
The Menu Editor is a utility used to customize the SmarTeam Editor menus and toolbar.
With the Menu Editor you can:
Add and remove menus, submenus, commands and buttons.
Create customized menus for specific users and groups.
174
Customizable Menus
Pull down Menu
Popup Menu
Separator
Sub Menu
Menu Commands
175
Menu Profiles
Student Notes:
The Menu Editor is a utility used to customize SmarTeam Editor menus and toolbar.
System Menu Profiles used to assign menu profiles to groups of users.
Important:
- Do not change the System and User Menu profile.
- When a user is assigned to more than one group, duplication of menus will be removed.
176
Student Notes:
177
Student Notes:
The following presentation shows how to create a new System Profile for the
Engineering Group by performing the following steps:
Adding a new System Profile (named Engineering) based on the Admin group
profile.
Assigning a user group to the new profile.
Editing the newly-created System Profile to make the Form Designer command
invisible.
178
Student Notes:
1
Access the utility from Start > All Programs > SmarTeam
> Administrative Tools > Admin Console.
2
Select System under
System Profiles.
179
Student Notes:
Right-click on System Profiles and click Paste > Tree from the
popup menu. The copy is automatically named System1.
180
Student Notes:
181
Student Notes:
1
Change the name in the Caption field to
Engineering.
2
You may change the Internal name too
182
Student Notes:
5
Click OK, and then OK again on the
Engineering Properties dialog box.
183
Student Notes:
1
Open the Engineering profile tree to
display the SmarTeam Editor Main
Menu, then expand Tools node.
184
Student Notes:
3
Uncheck the Visible and Customizable
check boxes and click OK.
4
Define if visibility of menu item can be
overridden into inherited menu profiles.
185
Student Notes:
186
Menu Commands
Student Notes:
Standard Commands
The SmarTeam Editors internal commands are attached to menus to perform a
defined action.
Standard commands cannot be changed.
User Defined Commands
Scripts are attached with the Script Maintenance Utility and are linked as User
Defined Commands in the menu editor.
187
Attaching a Script
Student Notes:
188
Student Notes:
189
Student Notes:
190
191
Student Notes:
Contexts define the users working environment, e.g. which SmarTeam Editor window
is active and which entries are selected.
Positive Contexts: the command will run on the selected context setting.
Negative Contexts: command will not run.
Internal contexts cannot be changed.
192
Student Notes:
193
Student Notes:
194
Student Notes:
1
Open the tree of the profile where you want to
add a command (in this example Engineering).
2
Open the menu tree (tree popup menu, in this
example) to which you wish to add the
command.
3
195
Student Notes:
4
In New Menu Item dialog box, enter a name in the Caption field and click the Browse button.
196
Student Notes:
In our example users of the Engineering group will be able to use the Hello
command during Check In operations only.
197
To Sum Up
Student Notes:
198
Admin Functionality
Student Notes:
199
File type
lookup table
200
201
Student Notes:
202
Student Notes:
4. Next, enter the executable path to the external application for each operation
(Edit, View, Redline and Print).
5. Select the new file type, and click Tools.
6. Select a tab and click Add.
203
Student Notes:
7. The Application tool dropdown menu lists all the applications registered in your
Windows registry. Fields are filled in automatically Or can be filled in manually.
204
IMPORTANT: Do not change the viewers once you have started working with
the system. Redlining does not transfer between viewers.
205
Student Notes:
206
Overview
Over HTTP, SSL, TCP/IP
Editor
System Configuration
Client
.Net remoting
System Configuration
Service
Web Client
System
Configuration
storage
207
Default
Domain
Site
Machine
Application
System
Group (Role)
User
Student Notes:
208
Student Notes:
Override mechanism
Top down evaluation
Lowest level has priority
Keys may be set at 0 or more levels
Example
Key=ScriptDirectory
Level=Domain
Value=\\Server\DefaultScripts
Key=ScriptDirectory
Level=System
Value=\\Server\DataBase\DefaultScripts
System= SmarTeam://0018847CB03142d6A55EAA0777A
In this example when users connect to the database with the replication id
0018847CB03142d6A55EAA0777A the script directory will be
\\Server\DataBase\DefaultScripts. When connecting to any other database the
script directory will be \\Server\DefaultScripts. This is because the Key has been
defined at two levels and when the lower level key is valid it takes precedence.
209
Student Notes:
ConfigSet 1
Element 1
ConfigSet 1
Element 2
ConfigSet Schema 1
Element 1
Element 2
ConfigSet Schema 2
Element 1
Element 2
.
.
.
Schema N
ConfigSet 2
Element 1
Element 2
ConfigSet 2
Element 2
ConfigSet N
Default
ConfigSet N
Domain
ConfigSet 2
Element 1
Element 2
ConfigSet N
User
210
Current Implementation
Student Notes:
Each configuration set is an XML document which has a schema describing each of its
elements.
The Meta Data is a standard XML Schema (conforms to the WWW Consortium
specification http://www.w3.org/XML/Schema/ ).
The Schema must include all available keys for any Configuration Set and should
include documentation for each key.
Client-Server communication using .NET Remoting/Web Services.
211
Student Notes:
Administrator
Updates values in all configuration levels using the System Configuration Editor.
User
Reads configuration according to the logic and security settings.
Updates values only in the user configuration override level.
Administration
The System Configuration clients can only set values for the User Configuration
Override Level handled through the application.
Only users with administrative rights can write directly to other levels
Handled through the application.
Changing configuration from any other level is made by System Configuration Editor
(Administrators only).
212
Student Notes:
213
Enables adding,
updating and deleting
values for each key in
each of its available
override level.
214
Various ways of
searching.
- Full text search
- By Group
- Drill Down
215
Student Notes:
The Administrator options enable you to change the system defaults for all the users.
216
Student Notes:
Use only UNC directory names: Check this option if you want the directory and vault browser to
automatically convert the drive-based logical path for mapped drives into UNC paths.
For example, instead of mapping a drive [H] to a specific computer and directory, when you check this
option the following parameters will appear: \\server1\[directory_name].
217
Student Notes:
218
Student Notes:
219
Student Notes:
The User Account Preferences option enables you to configure the password and
login settings to best suit your organizations security needs.
220
Student Notes:
1
Select the class with
Product Behavior where you
want to define the views for.
221
Student Notes:
222
Student Notes:
223
Student Notes:
The purpose of the lifecycle is to maintain all the versions of data while keeping
track of:
Changes in the objects and the related data (Metadata).
Changes in the relations between objects.
The reason for the change.
The consequences of the change:
Changes in other modules
Switching module locations
Etc
224
Student Notes:
You use the SmarTeam Data Model Designer utility to add the Revision Control
Mechanism (Lifecycle Mechanism) to the database and to assign the Revision Control
to specific classes.
Specific attributes that maintain version information are created, such as:
Revision
State
Approved By
Under Operation
225
Student Notes:
The Lifecycle popup menu includes operations for creating new versions and
maintaining existing ones.
Document behavior:
Check Out
Check In
Release
New Release
Obsolete
Undo Checkout
Copy File
Part behavior:
Promote
New Version
A page tab is added to the Profile Card, ensuring easy access for each items
revision.
226
Student Notes:
227
Student Notes:
Lifecycle Options are set from the Administrator Options on the SmarTeam Editor
Tools menu.
228
a.1 checked in
a.2 checked in
A released
b.1 checked in
b.2 checked out
Check-in
b.1
Release Only
b.1
229
Student Notes:
230
Student Notes:
Setting options on this tab affects Check Out, New Release and file copy
operations.
231
Student Notes:
This tab is only active in case Item Behavior and Items and Documentation are enabled
in the Data Model Designer.
232
Student Notes:
Some organizations have a rule to always use the Latest Revision (by Creation Date)
of an object. Options for the Latest Revision are set by selecting the Latest Revision
button from the Into Vault and Out of Vault tabs.
233
Student Notes:
Setting options on this tab affects the Check Out operation when working in
Latest Revision mode.
234
Student Notes:
Setting options on this tab affects Check In and Release operations when working in
the Latest Revision mode.
235
Links Types
Student Notes:
Special Link Types were introduced to improve the performance, quality and ease of
maintenance for CAD integrations.
This also required links with a direction (such as CATIA reference, in context Parts).
Additionally, the link between Items and specification Documents was introduced to
manage the dependencies.
Lifecycle Rules Setup allows the company to define rules regarding how various
design documents (Product, Item, Drawing) relate to each other when moving to a new
version.
Lifecycle Rules Setup also enables the company to set up rules for the release of an
Item and the related specification Documents.
236
Student Notes:
You will learn how to setup the Lifecycle Rules and manage the dependencies.
237
Student Notes:
The Lifecycle Rules setup is designed to support the behavior of the special link
types. The CAD Integrations are residing in the Documents super class and in case
Part Behavior and Parts and Documents is defined as database level mechanism
(and assigned to the super classes), it is possible to define the Part Rules.
238
Student Notes:
This screen shows you the Super Classes with special link behavior.
Part Rules will be only visible when Part Behavior and Documents are selected as a
database mechanism.
It allows you to configure the behavior of SmarTeam objects, managed by the special
link types.
239
Student Notes:
The Default behavior for the Documents Tree is defined by SmarTeam. The table
shows what happens in case on the Original object an operation is performed, and
what will happen on the Destination (linked) object.
The above situation shows that in a default Document Tree, on Check Out of the
parent the child file will be copied. Propagation and Switch to Latest are allowed
and the Links of the Previous Version will be copied.
240
241
Student Notes:
242
Student Notes:
243
Student Notes:
244
Student Notes:
245
Student Notes:
246
Student Notes:
3
The Rules Explorer shows the
conflicting rules.
247
Order of states
Defined state
Define Icon
248
Student Notes:
249
Student Notes:
Promote Rules:
Defines how to treat the child object, when performing a Promote operation on
a parent object.
Define how to treat specification documents linked to Part.
These rules apply to the hierarchical and specification links.
250
Student Notes:
Demote Rules:
Read only (calculated according to Promote Rules).
Use to check if a Part structure remains valid after Demote Operation
from Promote Rules View.
These rules apply to the hierarchical links.
251
Student Notes:
InActive Rules:
Defines how to treat the parent object, when performing a InActivate operation
on a child object.
Define how to treat specification documents linked to Part
These rules apply to the hierarchical and specification links
252
Student Notes:
To add new Lifecycle Rules properties for Parts or edit exists one.
253
To Sum Up
Student Notes:
254
Student Notes:
You will become familiar with the Vault Maintenance application and the Vault Tester
tool.
255
1.
2.
3.
4.
5.
Student Notes:
256
Student Notes:
Select All Programs > SmarTeam > Administrative Tools > Admin
Console > Vault Tester.
From the File Menu, select Start Working.
If communication is successful, you should have a trace like this:
257
Student Notes:
The Vault server must have the correct protocol definition and security/group
assignments. These are discussed in the installation training.
To summarize briefly:
SmVaultAdmin group:
Should include the vault service user SmAdmin with the rights to suppress, modify
and add files.
SmVaultUsers group:
Should include all Windows users who work with SmarTeam - Editor.
Shared directories and authorizations:
SmTemp
SmVaultAdmin and SmVaultUsers full control
Windows user
The Vault service administrator (SmAdmin)
Everybody
SmVault
SmVaultAdmin and SmVaultUser groups total control but uncheck inherited
rights
Everybody same as above
258
Student Notes:
259
Student Notes:
In this module you will learn how to import data from various sources into a SmarTeam
database and how to export data from SmarTeam.
260
Import into:
Classes
Hierarchical and General Links
Lookup Tables
Import from:
Databases
Text Files
261
Student Notes:
1
Select the Import Mode.
2
Click New Import.
3
Enter a name for
the Import and a
Record Limit.
262
263
Click on an attribute.
264
Note: Once you choose the delimiter, the program arranges the data in fixed columns.
265
Student Notes:
Select the column you want to import and click Save (TDM_DESCRIPTION in this example).
Repeat steps 1 5 for each attribute you want to import from a file
266
1
Click on an attribute.
Note: You must select Mask for attributes that you defined a mask for in
SmarTeam. If an attribute is defined as None, the attribute will be filled with blanks.
267
Student Notes:
Click on an attribute.
268
Click on an attribute.
Note: The value that you enter in the Fixed value attribute will
automatically be entered in the selected attribute during import.
269
2
Click on an attribute.
Select the
database and table
to import from and
click OK.
Note: You must define an import to the first Index attribute to guarantee unique objects in the database.
270
Student Notes:
Repeat steps 1 4 for each attribute you want to import from a file.
271
Student Notes:
Click the Attach Script button and select a script from the Script Browser.
272
Student Notes:
Once you have defined import values for attributes, click Import.
Once the import process is completed, the Import Status dialog box is displayed.
273
Student Notes:
The imported values are displayed above: ID used the mask, Description was imported from
file, the Main Supplier used a default value and a Standard was imported with a fixed value.
274
Importing data
Student Notes:
275
Student Notes:
2
Enter a name for the Export and click OK.
276
Student Notes:
3
Click on the new Export (Vendors in this example).
4
Click Add Query to open
the Search Editor.
5
Use the Search Editor to Select a
pre-defined Query or Create a New
Query.
277
Student Notes:
8
Click Options to open Export
Query Attributes screen.
278
Student Notes:
279
Student Notes:
You can use Notepad to open and view text files that youve exported. The files are
semi-colon delimited text files, as one shown below.
280
To Sum Up
Student Notes:
281
Student Notes:
You will learn how to create a Workflow and manage the Flow process.
282
Flowchart Overview
A Flowchart details the path that documents in a Process travel, and the tasks that must
be performed at each step of the process.
A Node is a step in a Process - it is an address of a user or a group and the tasks that
must be performed at that address.
A Connector is the path defined in the flowchart that routes documents in a Process
from one Node to the next.
Flowchart
Node
Connector
283
1
Start the Flowchart
Designer.
2
Set up a New Flowchart
(define general flowchart properties).
4
Assign the Flowchart to a Process.
284
Student Notes:
Access the Flowchart Designer from Start > Programs > SmarTeam > Administrative Tools >
Admin Console. Login with Administrator rights (the default administrator is Joe).
285
Main Toolbar
Mode Toolbar
Add a label
Select a Node
or a Connector
Grid Toolbar
286
Student Notes:
You can define general flowchart properties or you can use the default properties.
1
Double-click on any Node to load the
Properties window, this window is displayed
permanently on top of the design window.
Although it is useful to define most of the flowchart properties when you begin a flowchart,
it is advisable to assign a Process to a flowchart once the flowchart is complete.
287
Student Notes:
You can define Sharing and Security Properties on the Flow tab.
Share Objects = On
A document that is added to one Process
cannot be added to any other Processes.
288
Student Notes:
289
Student Notes:
You can define properties that affect the default appearance of a flowchart on the
Visual tab.
3
Click on the Visual tab.
290
Student Notes:
1
- Create a new Node by choosing Add Node on the Flowchart toolbar.
- Drag and drop any Node from the Nodes Library into a flowchart.
291
Student Notes:
Once you have added a Node, you can define the Node Properties.
2
Double-click on the node to
display the Properties window.
3
Click on the Visual tab to define
the appearance of the node.
4
Only Visual properties and Events can be defined for the Start and End Nodes.
292
Student Notes:
When you define a Node, specify the users or groups that will receive the SmarTeam
Objects undergoing a Process and the tasks that the users must perform.
1
Click on the Flow tab to assign
users and tasks to the node.
293
3
Click Add New to select users or
groups.
4
If you choose multiple users/
groups assign a Policy. (And/Or).
5
Set Select users at run time for the
user at a previous node, in order to
select a user for this node.
6
Select a user and click Set
Delegator, to allow this user to
delegate this node to others at
runtime.
294
Student Notes:
You can assign four types of tasks to a Node with the Flowchart Designer:
Manual Task
SmarTeam Editor Operation
Script
Automatic Event
1
Click the Flow tab of the Node
Properties window. Click the
browse button in the Task
field.
2
Add Script option allows you to add only scripts that contain Workflow parameters.
295
Student Notes:
3
Fill in the information on the Definition
and Options tabs and click OK to save.
296
Student Notes:
297
Student Notes:
IMPORTANT: If the script displays a message box and the script task is set as Automatic,
make sure that it is clear that message is a script message and not a system message.
298
Student Notes:
On the Events tab, you assign a script to run automatically and determine exactly
when the script will run in the Flow.
299
Student Notes:
You can allow users to terminate the Workflow process without performing the task by
setting Allow terminate option to True.
300
Student Notes:
You can save Nodes in a Library in order to reuse them in another flowchart.
1
From the View menu,
choose Nodes Library to
display the library area.
2
Right-click in the library area
to display the library options.
3
Drag a node from a
Flowchart into a Library
or from a Library into a
Flowchart.
Library Area
301
Student Notes:
302
Student Notes:
2
Double-click on the Connector to
display the Properties window.
3
Click on the Visual tab to define the
appearance of the Connector.
4
Click on the Flow tab to assign a
response name to the Connector.
303
Student Notes:
You can modify or define new response names in the Response screen.
1
Open the Responses window from
Flowchart Designers Workflow menu.
2
Click Add to define new Response
Names or Update to update an
existing Response name.
304
Student Notes:
1
From the Flowchart Designer
Mode toolbar, click the Add
Container Node icon.
2
3
Drill down into the new
container node, double click
the New Container icon.
305
4
Using standard SMARTFLOW
Workflow nodes and
connectors, define the nodes,
connectors and processes
within the embedded flow.
Incoming
nodes area
Flowchart area
306
Student Notes:
307
Student Notes:
When a flowchart is saved, the system checks that the flowchart has been defined
correctly and will run without problems when initialized in the SmarTeam Editor.
308
To Sum Up
Student Notes:
309
Student Notes:
You will learn how to manage a process using the Workflow Manager.
310
Student Notes:
The Administrator can search for and modify processes that have been initiated with
the workflow manager.
1
Access the Workflow Manager from Start > All Programs > SmarTeam >
Administrative Tools > Admin Console.
For example: If a user is on vacation, you can reassign the users task to another user, by
using the Workflow Manager to search for the Process and open the Process. You can
modify the properties of the node to which the user was assigned.
311
Student Notes:
2
Search for a Process:
Use Find process by
Attribute or use a Find
processes.
3
Modify the Process
(Open, Delete, Reassign).
Or
4
Open a users SmartBox
to locate a process.
5
Modify the Process
(Open, Delete, Reassign).
312
2
Enter criteria on tabs and click Find Now to search.
Node Tab
313
Student Notes:
Find process by attribute for Process in the Workflow Manager is similar to the
SmarTeam Editor Search by Attribute.
1
Click on the Search by Attribute icon
on the Workflow Manager toolbar.
2
Enter criteria on the Profile Card.
3
Click on the Attributes button, to
select Attributes to be displayed.
4
Click Run to run the search.
314
315
Student Notes:
1
Right-click on a Process to open the
contextual menu.
316
Student Notes:
317
To Sum Up
Student Notes:
In this lesson you have learned how to search for and modify processes using
the Workflow Manager:
Using the Workflow Manager
Searching for a Processes
Modifying a Process
318
Miscellaneous
Student Notes:
319
Student Notes:
Data Model Designer defines the frame work for the integration tools setup:
DLB (Database Level Behavior) - as integration.
Assign CLB (Class Level Behavior) - for classes represents component types.
File type is defined by Component Type.
320
321
Student Notes:
The Design Copy tool allows the SmarTeam users to create a new SmarTeam object
structure by copying selected objects from an existing assembly, duplicating
selected objects, their files and links.
From SmarTeam
Actions menu select
Design Copy.
Click Options
button.
322
Student Notes:
With the Administrator options dialog box, you can assign a Before Design Copy
script and update the Exclude classes list.
323
Assembly
Assembly
engine.asm
Part1
Part1
bolt.par
Part2
engine.dwg
Part2
screw.par
324
Student Notes:
You set up options for the CFOs on the Application Setup, Advanced Setup screen:
1
Select Application Setup from
SmarTeam Editor Tools menu.
2
Select a file type and
click the Tools button.
3
Click on one of the file operation
tabs (Edit, View etc.), click the Add
or Modify button and click on the
Advanced Setup tab.
5
Select Light Weight mode
(used in CATIA only).
325
Student Notes:
326
NLS
NLS National Language Support
Compliance with:
i18N- Internationalization
i10N- localization
NLS term is based in SmarTeam on 4 components:
Controls GUI (user interface) components like menu items, labels, buttons and etc.
Metadata Specific database related items like profile cards, lookups and etc.
Error messages information that is stored in the tdmerror.err and *.mns files.
327
Benefits
Student Notes:
All translatable data resides in a file system (folder structure) which remove DB
dependency.
328
Student Notes:
329
Student Notes:
The Translation utility is used to change the displayed language for the windows in
SmarTeam and/or SmarTeam utilities. You can add new languages, define values for
languages and select a default language.
1
You can access the Translation utility from Start > All Programs >
SmarTeam > Administrative Tools > Admin Console
330
Student Notes:
You can perform the following tasks using the NLS system:
Showing Existing Localizations.
Finding and Replacing Localized Items.
Setting the Translation Utility Root Path.
Translatable items
Localization tables
331
Student Notes:
332
Student Notes:
1
From the main menu, select
Tools, Add New Language.
333
Student Notes:
Restart SmarTeam.
334
Course Sum Up
Student Notes:
335