Configuring Mass Promotion

This section shows you how to configure X-CAD Design Management to support mass promotion of objects.

Before you begin:

Custom JPO methods to validate objects for promotion or selection must be written.

  1. Run the following MQL commands.
    Run MQL from the Live Collaboration Server folder or from 3DSpace. For more information, see Installation and Setup | Administrate | 3DEXPERIENCE Platform | 3DSpace | Collaboration and Approvals | Administrative Utilities | Running MQL
  2. Clone IEF-MassPromoteConfig type object and provide a name to indicate the integration.
    MQL>copy bus IEF-MassPromoteConfig IEF-MassPromoteConfig - to <NEW_NAME> <REVISION>

    For example,

    MQL>copy bus IEF-MassPromoteConfig IEF-MassPromoteConfig - to IEF-MassPromoteConfig_CATIA -;

  3. Edit the value for any attribute as required: MQL>mod bus IEF-MassPromoteConfig IEF-MassPromoteConfig_CATIA - <ATTRIBUTE_NAME> <ATTRIBUTE_VALUE>;
    For example, MQL>mod bus IEF-MassPromoteConfig IEF-MassPromoteConfig_CATIA - IEF-ValidateObjectPromotion True
  4. The available attributes are:

    • Attribute: IEF-MassPromoteValidationRuleJPO

      Function: Contains the name of the JPO fired from the MCADFinalize JPO to validate the promotion process. The JPO listed need to be created based on your company's business rules. For information on creating the JPO methods, see Customizing Mass Promotion. You can specify the default IEFMassPromoteValidationRule JPO installed by X-CAD Design Management.

    • Attribute: IEF-ValidateObjectPromotion

      Function: Enables or disables the validation of selected objects during the promote operation

      Possible Values:

      • True--Enables validation during promotion. The validateObjectForPromotion method implemented in the JPO specified by the IEF-MassPromoteValidationRuleJPO attribute is called during the promote operation
      • False--Disables validation during the promote process
    • Attribute: IEF-ValidateObjectSelection

      Function: Enables or disables the validation of objects when a user selects them on the Promote page

      Possible Values:

      • True--Enables validation during selection on the promote page. The validateObjectForSelection method implemented in the JPO specified by the IEF-MassPromoteValidationRuleJPO attribute is called when a user selects an object on the promote page
      • False--Disables validation

  5. Edit the attributeIEF-MassPromote-RegistryTNR in the GCO for the collaborative product with the name of the object created in Step 1. MQL>mod bus MxCATIAV5-GlobalConfig CatiaV5NewArch TEAM IEF-MassPromote-RegistryTNR IEF-MassPromoteConfig|IEF-MassPromoteConfig_CATIA|-; for example, MQL>mod bus MxCATIAV5-GlobalConfig CatiaV5NewArch TEAM IEF-MassPromote-RegistryTNR IEF-MassPromoteConfig|<NEW_NAME>|-;