11.6. Working Offline

You can work in your shared medini analyze projects offline. This is convenient when you are not connected to a server. When you are connected to the server again, you can push your changes to the server, and pull any updates from it.

When executing a push or pull, medini analyze performs a three-way diff between the server project, offline project, and the baseline. The baseline is the state of the server project at the previous action, push or pull. If no changes have been merged yet, the baseline is the server project state when you first downloaded the offline project.

11.6.1. Creating an Offline Project

To create an offline project, complete these steps.

  1. Log in to the server and load a project in the Model Browser.

  2. Right-click the project and select Download Copy....

    Ansys medini analyze creates an offline copy in the workspace. The project appears with an "offline copy" decorator. Note that the project is also marked with a "sync" overlay.

You can now begin working in your offline project.

11.6.2. Pushing Changes to the Server

After you have made changes in the offline project, you can push them to the project version on the server.

To push your changes to the server:

  1. In your offline project, save the changes you made.

  2. Right-click your offline project and select Push Changes to Server....

A dialog informs you that changes are being integrated and then merged. If there are no conflicts, the server is updated and the dialog closes. The change appears in the server version of your project (which is the version you downloaded the copy from). You can undo the push by clicking Ctrl+Z, and redo with Ctrl+Y.

If no changes are found, a dialog informs you of this.

If the server project is locked by another user for exclusive editing, you will not be able to push until the user releases the lock.

Only non-conflicting changes can be pushed. If you have conflicting changes when pushing, medini analyze asks you to pull from the server first. For more information, see Resolving Merge Conflicts.

11.6.3. Pulling Changes from the Server

When changes have been made to the version of the project on the server, you can merge them into your offline project.

To pull changes from the server into your offline project:

  • Right-click your offline project and select Pull Changes from Server....

A dialog informs you that changes are being integrated and then merged. If there are no conflicts, the offline project is updated and the dialog closes. The change from the server project appears in your offline project. You can undo the pull by clicking Ctrl+Z, and redo with Ctrl+Y.

If no changes are found, a dialog informs you of this.

11.6.4. Resolving Merge Conflicts

When you make changes in an offline project while another user is making changes in the server project, a push or pull can result in a merge conflict. You can resolve merge conflicts using medini analyze's conflict resolution tools.


Note:  When a push results in a merge conflict, medini analyze prompts you to pull the changes from the server to your local (offline) project. You resolve merge conflicts only during a pull.


If there is a merge conflict during a pull, medini analyze puts you in the "Conflict Resolution" view. The Merge Done and Abort buttons appear.

  • Clicking the Merge Done button keeps non-conflicting changes and rejects conflicting changes. This process keeps the target (offline) version of the conflicting changes. After you have rejected conflicting changes, they are considered rejected and do not appear the next time you pull.

  • Clicking the Abort button rolls back all changes to before the pull.


Important:  If you leave the Conflict Resolution view without clicking the Merge Done or the Abort button, and you continue working in the Model Browser, you risk losing the changes you have made in the Conflict Resolution view.


The Difference Browser lists the project elements that are in conflict. Conflicting changes are marked with a red arrow overlay. Non-conflicting changes are marked with a blue arrow overlay. Use the icon menu at the top of the Difference Browser to display the types of changes you want to see. You can also hover over each project element to get a little more information about the conflict.

To merge changes or subtree changes here, right-click the project element and select the action you want to take.

To get more details about the conflict, double-click the item, or right-click and select Show Details. The Difference Details window opens, showing the differences between the target and the source. The Difference Details window shows the conflict details for all types of project elements except external documents.


Note:  During a pull, the offline project is the target and the server project is the source.


To merge individual items, right-click in the Name column and select Merge Change(s).

To compare the projects, you can switch between the Conflict Resolution view and Analysis view by clicking the Compare/Merge button Analysis button. Remember that if you make changes in the Model Browser without clicking either the Merge Done or the Abort button, you risk losing the changes you made in the Conflict Resolution view.

For more details about how medini analyze handles diff-merge, see Diff/Merge Handling

11.6.5. Deleting Offline Projects

When you are done working in your offline project and have successfully pushed all your changes to the server, you can delete the project. Note that the project baseline is managed locally and is deleted together with the project.

To delete your offline project:

  • Right-click in your offline project and select Delete.