David Lillis: Using the Repository Manager


If you wish to be able to view graphical diagrams of the protocols in a repository, you must firstly install Graphviz (specifically, the 'dot' executable must be in your path). Installation instructions can be found here.

The latest version of the Repository Manager can be found here. After downloading the JAR file, double-clicking on it should run the Repository Manager.

Please report bugs to the Agent Factory bug tracker.

Working with Remote Repositories

A remote repository is one located on a web server, meaning that it is accessible via HTTP. For remote repositories, the Repository Manager offers read-only access so that you may examine the protocols it provides before implementing them within your agents. Accessing a remote repository is done by selecting the Repository -> Open Remote option from the menu (or using the Ctrl+R shortcut). This will prompt you for the URL of the repository (e.g. http://acre.lill.is/trading).

Once a repository has been opened, all the protocol definitions it contains are visible in the Protocol Selector (see screenshot below). If this is too long, protocols can be filtered by namespace (using the Namespace Filter) or by name (using the Name Filter). Once you have selected the desired protocol, clicking the View button on the left will open a view of the protocol.

Working with Local Repositories

Local repositories are those located on the computer you are working on. These are read/write so the protocols they contain are editable. To create a new repository, choose the Repository -> New option (or use the Ctrl+N shortcut). This will prompt you to choose a location for the repository. This should be an empty directory. If you have previously created a repository, open it using the Repository -> Open Local option (or use the Ctrl+L shortcut).

Once open, the protocols already in a repository are viewable and filterable in the same way as for a remote repository. However, for local repositories, the buttons on the left are available to make changes to the protocols in the repository. These are:

Create a new, empty, protocol and edit it with the Protocol Editor.
Make modifications to the protocol currently selected in the Protocol Selector. This also opens the Protocol Editor.
Import a previously-created protocol definition into this repository. You must select a valid protocol definition (with a .acr) extension when prompted.
Delete the protocol currently selected in the Protocol Selector from the repository.