Step 2. Define Standard Security Label Values - Optional
The label values, display names, and descriptions for standard security labels are defined in the resource file associated with the enumerated type class for the standard security label. Ten enumerated type classes have been provided out-of-the-box for use with standard security labels (wt.access.configuration.SecurityLabel1 through wt.access.configuration.SecurityLabel10). Decide which class you will use for each standard security label. You will specify the class for each standard security label in the security labels configuration file in the next step.
For the example configuration, the following classes are used:
• wt.access.configuration.SecurityLabel1 for Export Control
• wt.access.configuration.SecurityLabel2 for Corporate Proprietary
• wt.access.configuration.SecurityLabel3 for Legal Information
Additional enumerated type classes can be created if your site wants to configure more than ten standard security labels. For more information on creating and editing enumerated type classes, see the Windchill Customization Guide.
To define the security label values for each standard security label, and the display name and description for each value, complete the following steps:
1. Copy the resource bundle file for the class from the following source directory:
<Windchill>/src/wt/access/configuration
to the following directory:
<Windchill>/wtCustom/wt/access/configuration
2. Open the resource bundle file for the class in a text editor. For example, for the SecurityLabel1 class, open the following file:
<Windchill>/wtCustom/wt/access/configuration/SecurityLabel1RB.rbInfo
where <Windchill> is the installed location of your Windchill solution.
3. For each standard security label value, add the following lines:
<VALUE>.value=<LOCALIZED_DISPLAY_NAME>
<VALUE>.longDescription=<LONG_DESCRIPTION>
where:
◦ <VALUE> is the security label value name that will be specified in the securityLabelsConfiguration.xml file.
◦ <LOCALIZED_DISPLAY_NAME> is the name of the security label value as it will display in the user interface.
◦ <LONG_DESCRIPTION> is the long description of the security label. The long description is displayed in the automatically generated online help for the security label, accessed by clicking the view security label information icon
from the
Security Labels table.
| The NULL resource key is present automatically for each standard security label. A meaningful display name and description can be provided for the NULL key by editing the resource entry, but the entry should not be deleted. The value associated with the NULL key is always unrestricted. As a result, the value associated with the NULL key should not be used for a marking for which you may want to restrict access in the future. Use a non-null informative marking for this case instead. |
For example, the following lines would be modified in or added to the SecurityLabel1RB.rbInfo file for the sample configuration:
NULL.value=No License Required
NULL.longDescription=Export of the selected business objects does not require a license.
LNC.value=License Required - Commercial
LNC.longDescription=Export of the selected business objects requires a commercial export license.
LNS.value=License Required - State
LNS.longDescription=Export of the selected business objects requires a state export license.
DNE.value=Do Not Export
DNE.longDescription=Export of the selected business objects is not allowed.
UNK.value=Unknown
UNK.longDescription=Export restriction status of the selected business object is not known. Treat as Do Not Export.
4. Save and close.
5. Repeat steps 1 through 4 for each security label class.
6. From within a windchill shell, run the following command to build the resource bundle:
◦ For a Windows system:
ResourceBuild wt.access.configuration
◦ For a UNIX system:
ResourceBuild.sh wt.access.configuration
