Configure the PRE_UI_INSERT extension

The PRE_UI_INSERT extension allows you to restrict the search options on the Teamcenter Insert dialog box.

You can implement this extension using JAVA only.

The method for implementing this extension is as follows:

1. Implement a custom JAVA class and override the public BHMExtensionOutput executePreUIAction(String input, Connection connection) method in this custom class.
2. The input string of the BHMExtensionOutput executePreUIAction method is an XML file based on the BHMOperationSchema.xsd schema.
3. Use the JAXB utility to generate the XML input strings. This utility is available in the BHMOperationData and the BHMDesign classes located in the com.teamcenter.behaviormodeling.common.xml package. The JAXB utility also does the following:
   • Converts the input XML string into a JAVA object.
   • Sets the UID in the JAVA code.
   • Converts the JAVA object back into XML.
   • Sets the XML file as the output in the XML field of the BHMOperationOutput object.

In the input XML file, you can provide two types of UIDs. These UIDs will be used to populate the Insert dialog box:

• The list of UIDs for the insert search operation. In the Insert dialog box, you can search using Teamcenter folders or Classification, or you can use Teamcenter search. You can provide UIDs only for one out of the three search options.
• The list of UIDs for the behavior models that you want to appear in the Model selected for Insert list of the Insert dialog box.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BHMOperations xmlns="http://www.plmxml.org/Schemas/bhm">
  <options>
    <insertOperationOptions stopOperationOnError="true">
	<!-- List of Teamcenter UIDs for browsing on Insert dialog.
            Enable one of the following: -->
      <BrowseList>
        <TCFolderUIDs>
		<!-- 1. Specifies the Teamcenter folder UIDs -->
          <UID>AkTRBcBQI2ELbD</UID>
          <UID>gQYRBcGLI2ELbD</UID>
        </TCFolderUIDs>
		<!-- 2. Specifies the Classification UIDs -->
        <TCClassUIDs/>
		<!-- 3. Specifies the UIDs available in Teamcenter search dialog-->
        <TCObjectUIDs/>
      </BrowseList>
	  <!-- Specifies the UIDs of objects that will be displayed
              in the Models selected for insert list
	  -->
      <SelectList>
        <UID>A6URBk7FI2ELbD</UID>
      </SelectList>
    </insertOperationOptions>
  </options>
</BHMOperations>

In the example input XML file:

• UIDs are specified for objects to be displayed for the Teamcenter Folder tab. The Classification Tree and Teamcenter Search tabs are disabled.
• Only one tab can be enabled at a time.
• UIDs of objects that must always appear in the Models selected for insert list are added in the SelectList element.