Security Labels Change History Table

The Security Labels Change History table provides historical tracking of changes made to security label values for an object. It displays a list of security label values that were changed for an object and tracked details such as the date and time of change, and the user who performed the changes.

This table is available only on the security labelled objects. By default, this table is available on Part, Document, EPMDocument, Package, Replication Package, Problem Report, Variance, Change Request, Change Notice, Change Task, and Change Review objects in Windchill.

You can extend the use of this table for other security labelled objects by configuring the wt.access.securityLabelChangeHistory.supportedObjects property in the wt.properties file in Windchill codebase.

You can use this property to enable Security Labels Change History table for one or multiple objects at a time using a comma separated list. For example:

• To extend the use of Security Labels Change History table for the MPM Process Plan object, add the following property to the wt.properties file:wt.access.securityLabelChangeHistory.supportedObjects=com.ptc.windchill.mpml.processplan.MPMProcessPlan

• To extend the use of Security Labels Change History table for MPM Process Plan and Part Request objects, add the following property to the wt.properties file:wt.access.securityLabelChangeHistory.supportedObjects=com.ptc.windchill.mpml.processplan.MPMProcessPlan, com.ptc.windchill.suma.npi.WTPartRequest

If the wt.access.securityLabelChangeHistory.supportedObjects property is set with an incorrect object type, a window appears displaying the Events table when you try to edit security labels for any object. To see the error description, click

corresponding to your event in the Events table.

Another window appears displaying the specific error description in the Conflicts table. The object type assigned to the property could be incorrect due to following reasons:

• The object type assigned to the property is a valid Windchill object type but not exposed to security labels.

• The object type assigned to the property is not a valid Windchill object type.

Contact your site administrator for resolution details.

The Security Labels Change History table is available under the Customize > History menu in the object information page. If the object is not supported to show History menu, the table will not be accessible. For more information, contact your site administrator.

The Security Labels Change History table displays only the changed values. The unchanged values are represented by a dash (-).

For objects that are created after Windchill 11.1 F000, the changes made to security label values are tracked since the object creation time. The table will have at least one row that displays security label values which were assigned during creation of the object.

For objects that were created prior to Windchill 11.1 F000, the values are blank. When the security label values for these objects are specified or changed for the first time, the table displays two rows per object. The first row displays the security label values that were configured prior to Windchill 11.1 F000 and the second row displays the new security label values. If the object had no values prior to Windchill 11.1 F000, by default, the values will be displayed as Null. The cells for Modified by and Modified on columns in the first row for such objects will be blank, indicating that these objects existed before the history tracking feature was implemented.

When an object is iterated, the security label values are copied from the previous iteration but the history is tracked from the time the new iteration was created.

For upgraded objects, there will be no security label values for the base iteration by default. It is only when an upgraded object is iterated, that the history is tracked and a security label record is created and displayed for the new iteration. When updating security label values for such objects, if the Apply security label changes to all versions of the edited objects checkbox is selected, the security label value is copied to all the versions of the object, creating a new security label change record for each iteration.

The security labels set on an object can be viewed and changed by launching the Edit Security Labels window from the actions list for the object. For more information on viewing current values of security labels, see Viewing and Setting Security Labels on Existing Objects.

A standard security label can have multiple values, separated by a comma. The Security Labels Change History table can also be used to view multiple values set on a security label. In the following example, standard security labels such as Secrecy Label and Context Based Label can be seen with multiple values.

The deleted security labels appear in the customized views with the term <deleted> appended to their names. The values under a deleted security label column also appear with the term <deleted> appended to it. If you edit a customized view after deleting a security label, the deleted security label does not appear in the Available Columns or Selected Columns fields. The deleted security label columns also disappear from the table after you finish editing the customized view.

The default columns for this table are Modified by and Modified on. You can customize the table to add the required columns as per business requirement. For more information, see Customizing Table Views.