Add Model to Workspace - archimatetool/archi-modelrepository-plugin2 GitHub Wiki

This action adds an Archi model to the Collaboration Workspace. The action is disabled if the model is already set up for collaboration.

This action is used when the Archi model has not yet been published to an online repository. You may need to configure an online repository beforehand. See Configuring a Remote Repository for more details.

1. Select a model in the Models Tree so it has the focus
2. From the main or right-click context "Collaboration" menu select "Add Model to Workspace..."
3. A dialog will open:

4. If an online repository has already been configured enter its URL here. If the URL is HTTPS you can enter the user name and password (or Personal Access Token) for the repository. If not, leave these fields blank and you can set them later. The "Store user name and password" checkbox can be checked if you wish to store these details. If you don't store them you will be prompted to enter them in other actions.
5. Click the "Add" button
6. The model will now appear in the Collaboration Workspace panel

7. An initial commit is made and visible in the Change History panel:

When a model is added to the Collaboration Workspace the model file (*.archimate) is copied to a newly created repository folder which contains all of the necessary Git files required for version tracking and collaboration. Note that a copy is made of the original file. The folder location is as follows, where "XXXXXXXXXXXX" is a unique number:

<user home>/Documents/Archi/repositories/XXXXXXXXXXXX

Inside this folder is the model file renamed to model.archimate and a .git folder (which will be hidden unless you have hidden files visible).

At the same time an initial commit is made with the message "First Commit". This is the starting point for the model's history of changes.