CATDWC Main Representation Valuation (CATDWCExportMainRepresentationValuation)

An opening ID is an entry point used to customize business logic. This section describes how to define and identify a MainRepresentation object during MultiRepresentation conversion.

Note: For more information about customization by business rules, see Installation and Setup: Customize: Behavior: Data Setup: Customization by Business Rules.

This page discusses:

General Information

This opening ID is invoked:

  • for each PLM component: the terminal reference to be transferred.

The table below provides you with information related to the definition of the Opening ID.

PLM Opening ID: CATDWCExportMainRepresentationValuation
Customization intent: Computation
Execution context:Client

Input Objects

Input objects must be of the following types:

  • ThisObject
  • Parameters corresponds to the context object.

Context Object Parameters

Parameter NameTypeRead/WriteComments
iOperationId string ReadParameter used to identify the mapping context . The "CATDWCExport" value is available for any Coexistence scenario
iPLMRepRefList CATLIstVal CATInstance_varReadIn a Coexistence scenario, this is the list of proxies of 3D PLMCoreRepReference found under the iPLMRef reference.
iContextName string ReadName of current Context of transfer. Is Null when running the Conversion in a non associative mode.
DWCMainRepCATInstance_var WriteIn a Coexistence scenario, it contains the proxy of the Main representation. Null_var when no main representation is found under the iPLMRef reference.

Sample

For best results, it is recommended to initialize DWCMainRep in CATRule:

 if(
Parameters-> HasAttribute("DWCMainRep") == true )
{
 Parameters-> SetAttributeObject("DWCMainRep",NULL)
 }

In the example below a terminal Reference having multiple Representation instances under it is passed to BLO.

  1. One representation meets MainRep criterion .

    The PLMCoreReference object is passed to BLO for processing MainRep. Only one representation satisfies the MainRep criterion. Using this representation object, BLO valuates DWCMainRep as:

     Parameters -> SetAttributeObject( "DWCMainRep", aRep )

    where aRep is of the PLMCoreRepReference type

    When the DWCMainRep attribute is set to the valid PLMCoreRepReference, DownwardCompatibility validates that the set PLMCoreRepReference is a child of the given PLMCoreReference and proceeds with further processing. If the PLMCoreRepReference set by CATRule is not a child of the given PLMCoreReference, DownwardCompatibility aborts with an appropriate error message.

  2. More than one representation meets the MainRep criterion.

    The PLMCoreReference object is passed to BLO for processing MainRep. More than one representation satisfies the MainRep criterion. In such a case, you must select the best of them.

     Parameters -> SetAttributeObject( "DWCMainRep", aRep )

    where aRep is of the PLMCoreRepReference type

    When the DWCMainRep attribute is set to the valid PLMCoreRepReference, DownwardCompatibility validates that the PLMCoreRepReference set is a child of the given PLMCoreReference and proceeds with further processing. If the PLMCoreRepReference set by CATRule is not a child of the given PLMCoreReference, DownwardCompatibility aborts with an appropriate error message.

  3. No representation meets the MainRep criterion.

    The PLMCoreReference object is passed to BLO for processing MainRep. None of the PLMCoreRepresentationReferences children match the MainRep criterion.

    BLO valuates DWCMainRep as:

     Parameters -> SetAttributeObject( "DWCMainRep", NULL )

    where aRep is of the PLMCoreRepReference type.

    DownwardCompatibility retrieves this attribute, finds it is NULL and proceeds with the processing.