Working Collaboratively

When you are building your host application project files it is often important for multiple people to contribute to a project. Configuration management software, such as Git, provides your team with the ability to manage and merge your project files efficiently. Because Host Integrator saves your project files in an XML format, making them accessible to multiple developers, it is easy to work collaboratively.

Each host application project contains a number of files that you need to keep together in order to ensure the project's uniqueness. Files are generated and saved in a directory that uses the same name as the model you are using. The main model file, .modelx, uses that same name. It is important to keep all the project files together and preserve their folder structure.

The <Model name> directory, which, by default, is created in <my documents>\Micro Focus\Verastream\HostIntegrator\model. Each <Model name> directory contains the following files and directories:

In previous versions of Host Integrator, project files were saved with a .model extension. By default your project is saved using its existing extension. Using the Save As option you can choose which format to use. If you choose to save your file as a .model file, the directory contains these files:

Using source control to manage and merge changes

Using the multiple plain text files generated in the Design Tool and a tool, such as Git, different developers can work on the different files needed to build your host application project.

Things to remember

Importing model elements

With this option, developers can work separately on different sections of the same model, import sections into the destination model, and reuse model elements as often as needed. You can import elements from older formatted models into the current format and vice versa. You are not restricted by the different versions of existing project files. There is complete documentation on this option available. See Importing Model Elements.

Optional Files

The Recordings directory, which is where the Host Emulator trace files are stored is optional. If you do not intend to load and run a model recording in the Host Emulator, this directory is not needed.

If you want to save the settings for this model so that it will be the basis for creating other models, select Save Settings As. The .dtool file you create can include Design Tool-specific configuration information such as window size, colors, keymapping, and preferences, as well as information about the host application and connection settings.


Related Topics
Bullet Validating host application models
Bullet Troubleshooting tips and techniques