Architects can guide users in their selection of existing parts using an Add Part grid. When they select to add a part in a given item structure tree using the Open item dialog, the grid will search for and display specific items based on the Add Part grid configuration in that given context. The Add Part grids will be available to all system users. 


Prerequisites


Creating an Add Part Grid

To get started, select the item in the structure for which you want to create an Add Part grid for one of its parts. Right-click and select Add, and then select the part. 



The Open items dialog will appear. In the Recommendations section at the top left, select New view....



The Edit Grid Definition dialog will display. Navigate to the Definition tab and configure the grid using the tags described in XML Tag Reference - Grid specific in the application Help.



Just as with all configurable grid views, the dialog has a View tab where you can test the configuration before saving it using the Save XML Definition button.


Tip: The use of Parameters, and specifically the hintContextPath attribute, may be of special interest for Add Part grids. Refer to the application Help for details.


As described in Installing the SystemWeaver Config Items Meta Data, the add part grid is stored as a specific config item of type "Add part grid" (XAPG). The configuration is stored in an XML attribute called "Definition" with the SID = GRXM.


Editing an Add Part Grid

If, at any time, you need to modify the Add Part grid definition, right-click on it in the Open items dialog and select Edit grid definition



Be sure to save your changes by either saving directly in the selected Add Part grid using Save XML Definition or by Versioning (i.e., taking out a new version or creating a new config item). 



Deleting an Add Part Grid

To remove an Add Part Grid config item from the server using the Open items dialog, right-click on it in the Open items dialog and select Remove grid definition. The conditions for this operation are the same as when deleting any item or part from the server.