Adding solution properties

You can add custom properties to a solution project to override solution-wide defaults, or to provide information for an agent to pass along to an external system. For example, if your agent needs to connect to a database server, you can store the connection settings in a custom properties file in the solution project.

About this task

Use the Eclipse XML editor to modify the solution_properties.xml file and add property elements that include name and value pairs.

Procedure

  1. Double-click the solution_properties.xml file in the Solution Explorer or Project Explorer view to edit the file in the Eclipse XML Editor.
  2. Click the Source tab to edit the XML content. The file contains the <properties> element and comments.
  3. Inside the <properties> element, add a child <property> element for each of the custom properties you want to add. The completed XML file looks similar to this example:
    <?xml version="1.0" encoding="UTF-8"?>
    <properties xmlns="http://www.ibm.com/ia/SolutionProperties">
    <property name="db_username">JoeSmith</property>
    <property name="db_password" override_required="true"></property>
    <property name="secret_property" encoded="true">{xor}KzosKzot</property>
    </properties>
    To protect the value of a property, such as a password, you can include the encoded=true parameter. The override_required property parameter indicates that the property value must be modified by the administrator by using the setproperty command. If the property value is not set, the getproperty command returns a null value. See Creating and overriding the properties of a solution.

What to do next

Test the connection to the external system to make sure that the authentication settings in the custom properties are passed to the server by the agent.