Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Content layer
id829160843
Content column
id829160845
Content block
id829160844

Publishing a model from the graphical user interface is a quick way to share it on on the web with other team members or stakeholders.

Note
titlePublishing prerequisites

To be able to publish models to Cameo Collaborator for Teamwork Cloud:

  • The Cameo Collaborator Publisher plugin must be installed in your modeling tool.
  • You must log in to Teamwork Cloud.
  • You need to have user permissions to publish models.
  • The model you are trying to publish must be stored in Teamwork Cloud. If you want to publish a local model, first add it to Teamwork Cloud.
  • If you intend to publish a large model, increase the default JVM heap size of your modeling tool (Maximum Heap Size or Xmx property)the Cameo Collaborator Publisher plugin as follows:
    1. Go to the <modeling tool installation directory>/plugins/com.nomagic.collaborator.publisher directory and open:
      • The publish.bat fileon Windows.

      • The publish.sh fileon OS X or Linux.
    2. Increase the -Xmx value, e.g., -Xmx4000M. It is recommended to set a larger heap size value than the one defined for your modeling tool.

    3. Save and close the file.

Info
titleProject permissions

When you publish a new document, it inherits Teamwork Cloud project permissions. When you update a document, project permissions are not affected.


To publish a model to Cameo Collaborator for TWC


  1. Start your modeling tool and open the model you want to publish.

  2. In the main menu, select Tools > Cameo CollaboratorPublish to Teamwork Cloud.
  3. In the Cameo Collaborator Publisher dialog, specify the following properties:
    • Document name - enter the name of the published document. By default, the document name is the same as the model name.
    • Category name - select the Teamwork Cloud category where the published document will be stored.

    • Scope - click  and select the Package or several Packages containing the data you want to publish.

    • Template - select the template for publishing the model. You can select one of the predefined templates or a custom template used in your model. Click  if you want to select a locally stored template or a template stored in Teamwork Cloud.

      Warning
      title Updating projects

      If you update a published model, specify the same template that you used before. Otherwise, the navigation between comments and commented items will be corrupted. To restore corrupted navigation, update the document again using the initial template.

  4. In the same dialog, do the following (optional):
    • Select the Disable comments check box if you do not want reviewers to comment in the published document.

    • Select the Update previously published project check box if you want the current model to replace a previously published model with the same name. If you select this check box when publishing a model for the first time, the model will be published as new.

      Warning
      titleProjects reverted to an earlier version

      When publishing, the selected template is automatically used in your model and then committed to Teamwork Cloud. If you update a model that has been reverted to an earlier version (without the template used in it), you will corrupt the navigation between existing comments and commented items. Afterwards the , navigation cannot be restored.

  5. Click the Publish button.


The Cameo Collaborator Publisher dialog with specified publishing properties.

Wait until you get the message that the model is successfully published, as publishing a large model may take some time. If you update an existing document, its version number in Cameo Collaborator for TWC is increased by one. A new version of the published document includes all comments from the previous version , unless the commented item no longer exists or comments are disabled.

Improving publishing performance

You can improve publishing performance by changing environment options in your modeling tool, as described below.

To improve publishing performance

  1. In the main menu of your modeling tool, select Options > Environment.
  2. On the left side of the Environment Options dialog, select the Collaboration option group.
  3. On the right side of the dialog, set the Notify About New Project Versions on the Server option to false.
  4. On the right side of the dialog, set the Notify About Newer Project Usages option to Never.
  5. Click OK.
Now Teamwork Cloud will use less connections when publishing, so the publishing performance will improve.

Image Removed

Changing the highlighted environment options improves publishing performance

.

Content block
id829160841

Related pages