Importing or Exporting an Integration Configuration

For integration with ALM, it is now possible for administrators to import or export an integration configuration using the integrationMACConfigurations REST API introduced with PPM version 9.20. The exported integration configuration can be used for maintaining or migrating the integration configurations. The imported integration configuration can be used to create a new integration configuration or update existing integration configurations.

To import or export an integration configuration,

  1. Open the <PPM_Home>\kintana\deploy\itg.war\WEB-INF\conf\wink_ws.app file and make sure the following line is not commented out:

    com.mercury.itg.rest.integration.resource.IntegrationMACConfigurationResource
  2. Access the REST API: http://<host>:<port>/itg/rest/integrationMACConfigurations and do the following as necessary:

    • To export integration configurations, use get as http method.
      Note that the password is encrypted.

    • To create an integration configuration, use post as http method, application/xml or application/json as Content-Type. If you want to use a browser to do this, you can use RestClient on firefox. Make sure that configurationKey is empty in the content.

    • To update an integration configuration, use post as http method, application/xml or application/json as Content-Type. If you want to use a browser to do this, you can use RestClient on firefox. Make sure configurationKey in the content is the key of configuration.

For more details about the integrationMACConfigurations REST API, see the Overview of PPM RESTful Web Services.