Customizing the Where Used Page

Create or open the text file for customized properties. For more information, see Editing Properties Using MQL.

Add the following keys for each type of object to which you want to add where used functionality:


Key	Description	Value
`emxProduct.WhereUsed.<type of the object>.ExpandTypes`	Object types on which the where used program expands the context object.	A comma separated string of the symbolic type names: `type_type1,type_type2 type_type3,...`
`emxProduct.WhereUsed.<type of the object>.ExpandRelationships.`	Relationships which the where used program traverses to get the parent objects connected to the context object.	A comma separated string of the symbolic names of the relationships: `relationship_relationship1, relationship _ relationship2...`
`emxProduct.WhereUsed.IntermediateTypes`	Intermediate types objects which are not to be displayed to the users.	A comma separated string of the symbolic names of the intermediate types: `type_IntermediateType1,type_IntermediateType2...`

If the where used query of the object involves some intermediate objects, update the emxProduct.WhereUsed.IntermediateTypes setting to include the symbolic names of all of the intermediate types.
When you are finished updating the text file with all properties that you want to modify, use the text file to modify the emxProductLine.properties page object. For more information, see Editing Properties Using MQL.

To create a command to display an object's where used information and set its page link (HREF), run the following MQL command:

add command <Command Name> description <STRING VLAUE> label <VALUE> href "${COMMON_DIR}/emxTable.jsp?program=emxPLCCommon:getWhereUsed&FilterFramePage=${SUITE_DIR}/emxProductWhereUsedTableFilterInclude.jsp&FilterFrameSize=55&table=PLCWhereUsedList&header=emxProduct.Heading.WhereUsedGeneric&selection=multiple&topActionbar=PLCWhereUsedListTopActionBar&HelpMarker=emxhelpwhereusedlist&command=command_commandName";

where:

<Command Name> is the name of the command that you want to create.
command_commandName is the symbolic name of the command that you want to create.

Open the Run MQL window:
1. From the compass, select Collaboration and Approvals.
2. In the navigation pane, click Utilities > Run MQL.
To run an MQL command, enter the command in the MQL Command box and click Run or press Enter.
To add the filter settings to the new command, run the following MQL commands:
```
modify command <Command Name> add setting ExpandFilterRelationships <relationship_relationship1, relationship _ relationship2...>;
modify command <Command Name> add setting ExpandFilterTypes <Type_type1, type_type2 type_type3,...>;
modify command <Command Name> add setting IntermediateFilterTypes <type_IntermediateType1, type_IntermediateType2...>;
```
where:
- <Command Name> is the name of the command that you created.
- <relationship_relationship1, relationship _ relationship2...> is a comma-separated string of the symbolic names of the relationships.
- <Type_type1, type_type2 type_type3,...> is a comma-separated string of the symbolic names of the object types.
- <type_IntermediateType1, type_IntermediateType2...> is a comma-separated string of the symbolic names of the intermediate types.
Note: These are the values that you defined in emxProductLine.properties in Step 2.
To add the newly-created command to the object type's menu, run the following MQL command:
```
modify menu <Menu Name> add command <Command Name>;
```
where:
- <Menu Name> is the object type menu to which you want to add the command.
- <Command Name> is the command that you want to add to the menu.