On this page


By default, comments are stored in Cameo Collaborator documents. However, it is possible to store Cameo Collaborator comments as model elements inside a project. This allows you to work with them as any other UML elements and use the benefits of the modeling tool functionalities, such as calculating metrics, validating comments, and creating comment reports.

Working with synchronized projects

Synchronized projects on the target Teamwork Cloud server are read-only. This means you cannot store Cameo Collaborator comments in such projects because they cannot be modified. Learn more about cross-cluster resource synchronization.


Storing Cameo Collaborator Comments in a project

If you want to store Cameo Collaborator comments in a project rather than in a document, you have to choose the Comments in project check box when publishing the document, as shown below. For information on how to publish documents, refer to Publishing documents.


The Cameo Collaborator Publisher dialog with the highlighted option, which allows storing comments inside a project.


When Cameo Collaborator comments are saved in a project, they are automatically synchronized between the project and the document every time you commit changes to the server or update the project. This means you can work with comments both in a modeling tool and Cameo Collaborator without compromising consistency.

Importing comments

If you select the Comments in project check box when updating an existing document with comments, a dialog will pop up, allowing you to import these comments from the document to the project (see the figure below).  However, keep in mind that you will not be able to migrate the comments from the project back to the document, so be careful not to clear the Comments in project check box when updating the document at a later time.

A popup dialog allowing you to import Cameo Collaborator comments to a project automatically.


Importing Cameo Collaborator comments to a project manually

If you did not import Cameo Collaborator comments to a project when publishing a document with the Comments in project option enabled (as described in the above section), you can import them manually later.


To import Cameo Collaborator comments to a project


  1. In the main menu of a modeling tool, select Tools > Cameo Collaborator > Import Comments.
  2. When you get a notification that comments are being imported, wait until the import is complete and update the project.


You can find the imported comments in the containment tree of a modeling tool under the Package with the same name as the published document.


Imported Cameo Collaborator comments in the containment tree of a modeling tool.