Customizing NC Impacted Items

You can modify the page object, NCAllowedItems to add, or customize impacted items for nonconformances(NC).

  1. Modify the page object, NCAllowedItems: 

    <?xml version="1.0" encoding="UTF-8"?>
<ImpactedItems>
   <ControlItem type="type_NCRProductControl" policy="policy_NCRProductControl" reviewstate="state_Review" releasestate="state_Complete">
      <AllowedItem type="type_Products" policy="policy_Product" releasestate="state_Release" displayattribute="attribute_MarketingName" isControlItemRequired="yes" />
      <AllowedItem type="type_Part" policy="policy_ECPart" releasestate="state_Release" displayattribute="attribute_V_Name"  isControlItemRequired="yes"/>
      <AllowedItem type="type_VPMReference" policy="policy_VPLM_SMB_Definition" releasestate="state_Released" displayattribute="name" isControlItemRequired="yes"/>
   </ControlItem>
   <ControlItem> 
		<AllowedItem type="type_CONTROLLEDDOCUMENTS" policy="policy_ControlledDocuments" releasestate="state_Released" displayattribute="attribute_Title" isControlItemRequired="no"/>
		<AllowedItem type="type_Document" policy="policy_Document" releasestate="state_RELEASED" displayattribute="attribute_Title" isControlItemRequired="no"/>
	</ControlItem>
</ImpactedItems>

    Where,
    • Impacted Items: The root node that stores all the impacted items for an NC, the control for each item. It has one or more ControlItem tags with minimum one tag.
    • Control Item: The tag that stores the information of the control to be followed for an allowed item. It has minimum one or more AllowedItem tags.
    • AllowedItem: The tag that stores the information of the allowed type/policy against which an NC can be raised.

    Following are the attributes for the ControlItem tag.

    Attribute Description
    type The type of the control. If it is empty, Control is not created for the allowed items listed under it.
    policy The policy that governs the Control.
    release state The state the Control should be for an NC to close.
    review state The state the Control should be when NC is promoted to the Review state.

    Following are the attributes for the AllowedItem tag.

    Attribute Description
    type The type of the allowed item.
    policy The policy of the allowed item.
    release state The state in which an item can be searched for raising an NC. It is comma-separated list if you search for an impacted item in its multiple states.
    review state The review state of the impacted item.
    isControlItemRequired Defines whether product control is required for the item or not. This tag is used to identify if a control is to be created when an NC is raised. It has two values, yes and no. This tag is optional and if not provided, no is used.
    • yes: Control is automatically created when an NC is raised.
    • no: Control is not automatically created when an NC is raised. You can later create the Control if needed. During creation, the type and policy combination is used from the configuration to create the control.
    displayattribute This is the attribute for an impacted item, which is used as display value when the impacted item of an NC is displayed.
  2. Modify the page object, NCAllowedItems to define the display value for the name of an impacted item:

    For example,

    If you want to add a new type Project Space with the Title as display value, then you can configure the NCAllowedItems as mentioned below. Only attributes are allowed as display value. 

    <?xml version="1.0" encoding="UTF-8"?>
<ImpactedItems>
   <ControlItem type="type_NCRProductControl" policy="policy_NCRProductControl" reviewstate="state_Review" releasestate="state_Complete">
      <AllowedItem type="type_Products" policy="policy_Product" releasestate="state_Release" displayattribute="attribute_MarketingName" isControlItemRequired="yes" />
      <AllowedItem type="type_Part" policy="policy_ECPart" releasestate="state_Release" displayattribute="attribute_V_Name"  isControlItemRequired="yes"/>
      <AllowedItem type="type_VPMReference" policy="policy_VPLM_SMB_Definition" releasestate="state_Released" displayattribute="name" isControlItemRequired="yes"/>
   </ControlItem>
   <ControlItem> 
		<AllowedItem type="type_CONTROLLEDDOCUMENTS" policy="policy_ControlledDocuments" releasestate="state_Released" displayattribute="attribute_Title" isControlItemRequired="no"/>
		<AllowedItem type="type_Document" policy="policy_Document" releasestate="state_RELEASED" displayattribute="attribute_Title" isControlItemRequired="no"/>
	</ControlItem>
<ControlItem type="type_ProjectControl" policy="policy_ProjectControl" releasestate="state_Finish">
      <AllowedItem type="type_ProjectSpace" policy="policy_ProjectSpace" releasestate="state_Complete" isControlItemRequired="no" displayattribute="attribute_Title"  />
   </ControlItem> 
</ImpactedItems>

    The following are the default display values for an impacted item:

    Type Display Attribute
    Model Version Marketing Name
    Part V_Name
    Physical Product (VPMReference) PLMEntity.V_Name
    Quality System Document (Controlled Documents Title
    Document Title

    Either the basic or an attribute, which is applicable to a given impacted item is allowed. By default the name of the impacted item is considered as display value. The display value is used to represent the impacted item only in the context of the NC app.

    By default, the NC app shows the name of the impacted item if the value of the display attribute given for any impacted item is either empty or not specify.

    For display, attribute configuration is not applicable for any other objects. The display attribute option is work according to defined configuration. If configuration is updated, then all existing NCs objects are updated with the new configuration.