On this page

You can customize the appearance of a published project by customizing the template you plan to use for publishing. The best practice is to save an existing predefined template with a different name, and then make changes to the newly created template file. After creating a new template file, you need to use it in the project you intend to publish. There is the option to change the default color of the title bar, document header and text, to add or remove the search button, and other style options. The procedure bellow describes how to modify the Entire Model template (stored as Cameo Collaborator Library.mdzip), but you can also modify other predefined templates the same way.


To customize the appearance a project portal


  1. Go to the modelLibraries folder in the installation directory of your modeling tool and open the Cameo Collaborator template you want to use for publishing as a separate project.
  2. Save the project in the same directory using a different name (e.g., Custom template.mdzip).
  3. When you receive the warning not to edit standard/system profiles and libraries, click Continue.
  4. Open a View Diagram of the template and double-click the element with the «Document» stereotype to open its properties Specification window.
  5. Specify the values of the following properties:
      • Primary Color Palette - defines the color of the app bar in the project portal.
      • Secondary Color Palette - defines the color of the main portal icons, e.g., icons for creating and saving a comment.
  6. Click Close and save the project.

 
The sample of a project portal showing the colors that can be customized.

Setting the default scope for publishing

In the custom template, you can set the default scope for publishing. When the default scope is set, you don't need to specify it while publishing the project. In this case, the default scope is published even if you specify another scope in the Cameo Collaborator Publisher dialog. 


To set the default scope for publishing


  1. If you haven't done so already, use your custom template in the project you intend to publish.
  2. Open the View Diagram of the custom template.
  3. In the Containment tree, select the package you want to set as the default scope for publishing (e.g. Categorization) and drag it onto the diagram pane.
  4. Draw the «Expose» dependency from the element with the «Document» stereotype to the package.


    The figure displays the View Diagram of the Entire Model template with a default scope that is specified through the «Expose» dependency.

  5. If you want to add more packages to the default scope, repeat steps 3 and 4.
  6. Save the project.
  7. Select the custom template in the Cameo Collaborator Publisher dialog when you publish the project to Cameo Collaborator.


Setting the home page of a Cameo Collaborator document

The home page of a published project is the diagram that opens by default after the project portal is loaded. It can be set directly in the model that you intend to publish.


To set the home page of a Cameo Collaborator document


  1. If you use a default template to publish Cameo Collaborator documents, proceed to step 2. If you use a custom template do the following:
    1. Open the custom template you intend to use for publishing.
    2. Open the Specification window of the View element which will be used to display the diagram you want to set as the home page.
    3. Click the specification cell of the Active Element property and in the drop-down list select the FindLandingPage value.
    4. Set the Active Landing Page property to true.

      Using multiple Views

      If your custom template has multiple Views, set the Active Landing Page for one View only.

    5. Close the Specification window and save the template.
  2. Open the model you intend to publish.
  3. Make sure that the Document View Collaborator Profile is used in your model. You can find it in the <intall.root>\profiles directory.
  4. In the model browser, right-click the diagram you want to display as the home page of the project portal and select Home Page


After completing the above steps, the «HomePage» stereotype is applied to the selected diagram. When you publish your model, a diagram with this stereotype is automatically displayed as the home page of a project portal.