Updating artifacts in the application by using Rational Focal Point

After posting the artifacts to the application, if some of the artifacts are modified in IBM® Rational® Focal Point™, you can update the artifacts back to the application.

Procedure

  1. In Rational Focal Point, open the workspace.
  2. Click Configure > REST client view command, and click Add view command.
  3. Select a view where you want to add the view command.
  4. In REST Client Command Configuration section, complete these steps:
    1. In REST Client Connector Name, type a name to identify the connection.
    2. In REST Request Method, select the POST method. For information about each method, see the "Supported methods to manage resources" topic.
    3. In Friends List, select the application that you added as a friend to Rational Focal Point.
    4. In Choose URL Attribute to REST Artifact, click Select, and select an attribute. This attribute stores the response URL from the application.
  5. In the REST Client Template XML Configuration section, complete these steps:
    1. Select the Use Template XML for REST PUT call checkbox, if the XML of the application where you are creating artifacts is not structured in a manner that Rational Focal Point expects, you must manually edit the XML.
    2. In REST Application URL to Template XML, type the URL that points to an artifact in the application, and click Get Template XML. The XML loads in the REST Application Template XML text box. If you do not want XML to load dynamically, you can copy the XML in the REST Application Template XML text box.
      Note: For the POST operation, you must know the XML of the application where you are posting artifacts. So you get the XML either dynamically or manually. After getting it, that XML must support posting of new data to the application. In some applications, if XML does not support that, you must manually create or edit the XML.
    3. In Root XPath to REST Application Artifact, click Select, and select the root XPath for attributes. The Select button is enabled only if the XML in REST Applicaiton Template XML is correct.
  6. In the Attribute Mapping section, click Add and map the Rational Focal Point attributes with the attributes of the application. For example, if the value of the Severity attribute is modified in Rational Focal Point, map the Severity attribute of Rational Focal Point with the dc:severity attribute of the application. After the PUT operation, the Severity attribute in the application is modified with the new value.
  7. In the Configuration section, complete these steps:
    1. In REST Application supported Date Format, type the date format that the external application uses.
    2. In Focal Point Separator, type a separator value such as a comma (,) or a semicolon (;). The MultiChoice and the LinkedList items will be separated by the specified separator.
  8. To map the IDs of the attributes between Rational Focal Point and the application, in Request Parameter Table section, click Add, and select a Rational Focal Point attribute. Type the ID of the application in the Key column. For example, if you select Project ID for Rational Focal Point, in the Key column, type the ID that is used for the project ID in the application.
  9. Click Save.
  10. In the Display menu, click the view the elements of which you want to update in the other application.
  11. To update all the artifacts available in the view, from the view toolbar click the dropdown list and select the PUT view command and then click the Go icon Go.
  12. To update one artifact, from the artifact toolbar select the PUT view command and then click the Go icon Go.

Feedback