BuildForge Help

Creating and Editing Adaptors

An adaptor is an instance of an adaptor template. Adaptor templates are XML files found in the console's <installation directory>\interface, while adaptors are data objects maintained in the database.

An adaptor specifies how the system should interact with a specific external system, using the adaptor XML language.

To set one up, you first add a new adaptor to the system, then edit its XML code to reflect the specifics of the system you want to connect to.

To create a new adaptor:

  1. Select Projects > Adaptors .

  2. Enter a Name for the new adaptor.
    Note: The name you choose must be unique among all of the adaptors. You cannot have a Debug adaptor with the same name as a Test adaptor.
  3. Select a Mode (Source, Debug, or Test) to indicate the main category that the adaptor fits.
  4. Select a Template.

    The template list shows the adaptor template XML files stored in your Management Console.

  5. Select an Access Group that will control this adaptor. Only members of this group will be able to view or modify this adaptor.

  6. Click the Add Adaptor button.

The system creates a new adaptor, and copies the content of the template you select into the new adaptor.

To edit an existing adaptor:

  1. Select Projects > Adaptors .
  2. Select an adaptor from the list.

  3. Edit the adaptor's values.
  4. Click the Save Adaptor button.
Related concepts
Adaptor XML Reference
ClearCase Adaptor Example