Using a Sequential Combination to Instantiate a User Feature    

This scenario aims at providing the expert user with an example of the sequential Combination behavior associated with the Bind UDF behavior. The expert user creates a part containing a UDF and a Product file into which the UDF will be instantiated. To do so, the expert user creates a combination containing a BindUDF behavior.

This scenario is divided into the following steps:
Remember to save your .CATfct file as well as the Bkt_PartUDF.CATPart and the BKT_InstantiateUDF.CATProduct, the  BKT_PartResult.CATPart, BKT_PartSupport.CATPart files in the directory corresponding to the CATGraphicPath environment variable.

Create a Technological Object

  1. From the Start>Knowledgeware menu, access the Business Process Knowledge Template workbench.

  2. Create the TestUDF technological type.

    • Click the Create Technological Type icon () to create a type. The Create technological type dialog box is displayed.

    • Enter the name of the type: TestUDF .

    • Click OK to validate.

    At this stage of the scenario, the Feature Dictionary tree looks like the one opposite.

Add Behaviors to the Technological Type

  1. Click the TestUDF type and the Sequential Combination behavior icon () to create a combination of behaviors. 

  2. Double-click SequentialCombination  in the Behaviors View and double-click TestUDF in the Behaviors tab. The Sequential Combination is displayed in the Behaviors tab.

  3. Double-click the SequentialCombination combination in the Behaviors tab to edit it. The Sequential Combination editor is displayed.

  4. In the Name field of the opening dialog box, enter Instantiate UDF and click OK to validate.

  5. Select the Instantiate UDF combination in the Behaviors tree and click the Sequential Combination icon ().  Sequential Combination is displayed in the Behaviors tab. 

  6. In the Name field of the opening dialog box, enter Retrieve Part and click OK to validate.

    At this stage of the scenario, the Behaviors tree looks like the one opposite.

  7. Click the Retrieve Part combination and click the Bind Object behavior icon ().

  8. Double-click the Bind Object node. The Bind Object editor is displayed.

    • In the Relative Name field, enter ../../../../BKT_PartResult.1

    ".." indicates that the bind must be performed on the upper level. In the current context, you go up 4 levels to reach the root product and go down one level to access the PartResult.

    • Click OK to validate.

  9. Click the Retrieve Part combination and click the Bind Reference behavior icon (). BindReference is displayed in the Behaviors tab.

  10. Double-click the BindReference node. The Bind Reference editor is displayed.

    • Click the Reference of field.

    • Expand the BindObject node and click the output link. =BindObject\Link is displayed in the Reference field.

    • Click OK to validate.

  11. Click the Retrieve Part combination and click the Bind Part behavior icon (). BindPart is displayed in the Behaviors tab.

  12. Double-click the BindPart node. The BindPart editor is displayed.

    • Click the From object field, expand the BindReference variables node and click the output link. BindReference\Link is displayed in the Reference field.

    • Click OK to validate.

    At this stage of the scenario, the behaviors tree looks like the one opposite.

  13. Select the Instantiate UDF combination in the Behaviors tab and click the Sequential Combination icon ().  SequentialCombination is displayed in the Behaviors tab. 

  14. Double-click SequentialCombination. The Sequential Combination editor is displayed.

  15. In the Name field of the opening dialog box, enter Retrieve Publications and click OK to validate.

  16. Click the Retrieve Publications combination and click the Bind Object behavior icon ().

  17. Double-click the Bind Object node. The Bind Object editor is displayed.

    • In the Relative Name field, enter ../../../../BKT_PartSupport.1

    • Click OK to validate

  18. Click the Retrieve Publications combination and click the Bind Publication Behavior icon (). BindPublication is displayed in the Behaviors tab.

  19. Double-click the BindPublication node. The Bind Publication editor is displayed.

    • In the Name field, enter BindPublication_Surface.

    • Click the Starting from field, expand the BindObject node and click the output link.

    • In the Relative Name field, enter Surface.

    • Click OK to validate.

  20. Click the Retrieve Publications combination and click the External Reference Behavior icon (). CreateExternalReference is displayed in the Behaviors tab.

  21. Double-click the CreateExternalReference node. The Create External Reference editor is displayed.

    • Click the Feature to import field, expand the BindPublication_Surface variables node and select the output link. BindPublicationSurface\Link is displayed in the Feature to import field.

    • Click the Destination field, expand the Retrieve Part node, and the BindPart variables node and select the output part. BindPart\Part is displayed in the Destination field.

    • Set the Show Mode to true.

    • Click OK to validate.

    At this stage of the scenario, the behaviors tree looks like the one opposite.

  22. Click the Retrieve Publications combination and click the Bind Publication Behavior icon (). BindPublication is displayed in the Behaviors tab.

  23. Double-click the BindPublication node. The Bind Publication editor is displayed.

    • In the Name field, enter BindPublication_Point.

    • Click the Starting From field, expand the BindObject node and click the output link. =BindObject\Link is displayed in the Reference field.

    • In the Relative Name field, enter Point.

    • Click OK to validate.

  24. Click the Retrieve Publications combination and click the External Reference Behavior icon (). CreateExternalReference is displayed in the Behaviors tab.

  25. Double-click the CreateExternalReference node. The Create External Reference editor is displayed.

    • In the Name field, enter CreateExternalReference_Point.

    • Click the Feature to import field, expand the BindPublication_Point node and select the output link. BindPublication_Point\Link is displayed in the Feature to import field.

    • Click the Destination field, expand the Retrieve Part node, and the BindPart node and select the output part. BindPart\Part is displayed in the Destination field. 

    • Click OK to validate.

    At this stage of the scenario, the behaviors tree looks like the one opposite.

  26. Select the Instantiate UDF combination in the Behaviors tab and click the Sequential Combination icon ().  Sequential Combination is displayed in the Behaviors tab. 

  27. Double-click the SequentialCombination. The Sequential Combination editor is displayed.

  28. In the Name field of the opening dialog box, enter Retrieve UDF and click OK to validate.

  29. Click the Retrieve UDF combination and click the Load Document Behavior icon (). LoadDocument is displayed in the Behaviors tab.

  30. Double-click the LoadDocument node. The Load Document editor is displayed.

    • Click OK to validate.

  31. Click the Retrieve UDF combination and click the Bind User Feature Behavior icon (). BindUserFeature is displayed in the Behaviors tab.

  32. Double-click the BindUserFeature node. The Bind User Feature editor is displayed.

    • Click the From object field, expand the LoadDocument variables node and select the output document. LoadDocument\Document is displayed in the From object field.

    • In the User Feature Name field, enter UserFeature1.

    • Click OK to validate.

    At this stage of the scenario, the behaviors tree looks like the one opposite.

  33. Click the InstantiateUDF combination and click the Instantiate Template Behavior icon (). InstantiateTemplate is displayed in the Behaviors tab.

  34. Double-click the InstantiateTemplate node. The Instantiate Template editor is displayed.

    • Click the Template feature field, expand the Retrieve UDF node and the BindUserFeature variables node and select the UserFeature output. BindUserFeature/UserFeature is displayed in the Template feature field.

    • Click the Destination field, expand the Retrieve Part combination node and the BindPart node and select the output part. BindPart\Part is displayed in the Destination field.

    • From the Valuation Mode scrolling list, select UseIdenticalName.

    • Click OK to validate.

    At this stage of the scenario, your workbench is similar to the graphic opposite.

     

Generate the Workbench

  1. Save the .CATfct file.

  2. Click the Generate Applicative Workbench icon () to generate a user workbench. Enter the name of the workbench, Instantiate UDF in this example and click OK to validate. The generated workbench opens.

Test the Workbench

  1. From the Tools>Options>Knowledgeware>Business Knowledge Template menu, select All Users from the Access Rights scrolling list and click OK to work in a User environment.

  2. Open the BKT_InstantiateUDF.CATProduct : The following picture is displayed (click it to enlarge it):

  1. Click the root product of the specification tree and select the TestUDF icon to type the root product. The root product name is now TestUDF2:Product2.

  1. Right-click TestUDF (Product2) and select TestUDF object>Instantiate UDF:

 The UDF is inserted into the product.