Use this procedure to create a new adaptor template for an external
application that you want to interface with a Build Forge project.
- Review the XML structure and elements in the adaptor templates
provided by the Build Forge product. Adaptor templates are located
in the following directory:
bfinstall\interface for
computers running Microsoft Windows operating systems
bfinstall/Platform/interface for
computers running UNIX or Linux operating systems
- Plan what you want the new adaptor to do:
- Know what commands it will run
- Determine how the commands will be parsed
- Determine what to do with the data gathered from the parsed results
- Know which external environment variables are required
- Select one of the adaptor templates in the interface directory
to use as a model. If possible, select an adaptor based on the same
external application. Or, select an adaptor that has a function similar
to the one you are creating. Use the XML hierarchy, elements, and
element attributes in the model as a guide to create the new template.
- Using an XML editor, open the model adaptor template. Save the
template to the interface directory with a new name.
- Using your plan, write the XML code for the new adaptor.
- Save the new adaptor template.
- Validate the adaptor template using the interface.dtd file in
the interface directory.
- Reset the adaptor templates to pick up your new template and add
it to the list of available templates in the Management Console. See Resetting adaptor templates.
- Create a project for the adaptor.
- Create an environment for the adaptor. See Creating an environment for the adaptor.
- Create an adaptor using the new adaptor template. See Creating an adaptor from a template.
- Add the adaptor to the project. See Adding an adaptor to a project.
- Run the adaptor project to test the adaptor. See Testing the adaptor.