Managing Personal Cabinet Names
Windchill's conceptual model for the organization of information is similar to that of an operating system in which you navigate a hierarchy of directories, subdirectories, and files in order to find data.
In Windchill, the primary storage mechanism is the folder, an object with functionality similar to that of a paper folder in the physical world. Cabinets, which are a special type of folder, provide the top-level organizing mechanism in the Windchill solution. You can consider a cabinet analogous to a filing cabinet in the physical world, a disk drive in the Windows operating system, or a root directory in a UNIX file system.
Each user created in Windchill is the owner of a cabinet, called his or her personal cabinet, as well as all of the subfolders and information stored or created within it. This cabinet is automatically created when the Windchill user is created. Usually, a user's personal cabinet is created using the name of the user as the cabinet name and is located in the /User domain; however, there are exceptions to this rule.
Since a Windchill user name does not need to be unique and all personal cabinet names must be unique, Windchill uses the wt.folder.personalCabinetNamingAttribute property in the wt.properties file to determine what the initial personal cabinet name should be for a given user. The wt.folder.personalCabinetNamingAttribute property contains the following default ordered list of attributes:
|
Attribute
|
Description
|
|
name
|
The cabinet name used is the user's name.
|
|
eMail
|
The cabinet name used is the user's email address.
|
|
fullName
|
The cabinet name used is the user's full name.
|
|
oid
|
The cabinet name used is the Windchill object identifier associated with the user. The Windchill object identifier is the unique string that Windchill creates to identify each object in the system.
|
For the cabinet name, Windchill uses the value of the first attribute in the list that produces a unique name. In most cases, the name of the personal cabinet is the user's name. If there is already a personal cabinet with that name, the user's email address is used for the personal cabinet name. If the email address is already being used as a cabinet name, then the full name is used. If the full name is already being used, the object identifier for the user is used as the cabinet name and, if that object identifier is already in use, Windchill appends an underscore and an integer, starting with 1, to the object identifier ( <oid> _1, <oid> _2, and so on) until a unique cabinet name is discovered.
You can change the attributes used in creating the personal cabinet name or the order of these attributes by modifying the list of attributes in the wt.folder.personalCabinetNamingAttribute property. For example, to use the full name before using an email address, you could specify the following xconfmanager command from a windchill shell:
xconfmanager -s wt.folder.personalCabinetNamingAttribute=
name,fullName,eMail,oid -t <Windchill>
/codebase/wt.properties -p
Where <Windchill> is the location where your Windchill solution is installed.
To use a user's telephone number instead of the email address, you could specify the following:
wt.folder.personalCabinetNamingAttribute=name,fullName,telephoneNumber,oid
If the attribute list for wt.folder.personalCabinetNamingAttribute has been modified and no personal cabinet name is discovered using the modified list, Windchill reverts back to using the default list to discover a unique name.