Editing Properties Using MQL

You can edit the app properties to configure them for your business processes.

For your first configured property, you must add a new page object (step 3). If you previously created a page object for properties, you modify that page instead (step 4).

Note: This topic describes creating page objects for properties that configure your app. You can also create page objects for string resource properties files in the same manner.

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.
Check to see if a page object for your app already exists:
```
list page;
```
If the page is not listed, use this command to create it. You can optionally include a description. For example:
```
add page APP_NAME_CODE.properties content PROPERTY=VALUE description DESCRIPTION;
```
where:
- APP_NAME_CODE is the existing name of the properties file.
- PROPERTY is the name of the property that you want to change. The property name usually starts with the APP_NAME_CODE.
- VALUE is the value for this property.
- DESCRIPTION describes the page object (not the property being set).
For example:
```
add page emxProgramCentral.properties content emxProgramCentral.showRDORoles=FALSE description "Program Management changes for implementation 2017";
```
Important: The name must exactly match the default properties file name.
If the page is listed, follow these steps:
1. Print the page to see the contents:
```
print page PAGENAME;
```
  where PAGENAME is the name of the properties file. For example:
```
print page emxProgramCentral.properties;
```
  Use this output to compare with the text file to make sure you do not omit any properties you previously defined.
2. Create a text file or edit a saved file with the existing contents plus any new properties you want to configure. For example, for Project Management, you can create a text file called ProgramManCustomProperties.txt that contains the following:
```
emxProgramCentral.showRDORoles=FALSE
emxProgramCentral.MetricSource.Ranges=Goal,Predicted,Allocated,Measured
eServiceApplicationProgramCentralRPNThreshold.Yellow = 5
eServiceApplicationProgramCentralRPNThreshold.Red = 10
eServiceApplicationProgramCentralRPNThreshold.Max = 20
```
  Warning: For performance reasons, do not include the entire primary properties file.
3. Modify the page object with the contents of the text file. For example:
```
modify page PAGENAME file FILENAME;
```
  where:
  - PAGENAME is the name of properties file.
  - FILENAME is the complete path to the file.
  For example:
```
modify page emxProgramCentral.properties file c:\prgproperties\ProgramManCustomProperties.txt;
```
Reload the cache:
1. From the compass, select Social and Collaborative Apps .
2. In the list of apps, click Collaboration and Approvals.
3. In the navigation pane, click Utilities > Reload Cache.