Publishing data models

The publishing feature produces a hypertext-linked web of HTML pages that shows information about models. The published information mirrors the content of the models, profiles, and packages and you can view the published information by using a standard browser.

About this task

The publishing process re-creates model elements, including diagrams, relationships, and attributes. You can use the published links to traverse the model the same way that you do in the modeling products.

Each published model is a separate, wholly contained entity with its own root page. When you publish, an overview page is generated that contains a link to the root page for each included model.

Procedure

  1. Make sure that you are in the Data perspective.
  2. In the Data Project Explorer view, select the model or model element to publish, and click Data > Publish > Web.
  3. In the Publish to Web window, on the General tab, select a level of detail:
    • To show only the documentation that is associated with the element, click Minimum.
    • To also show properties and owned elements, click Full.
  4. Specify any of the following publishing options:
    • To generate diagrams, select the Generate diagram image files check box and select a diagram image format. If you do not generate diagrams, the content is published as text.
      Note: To support the SVG format on a browser, you might need to download a supplemental plug-in.
    • For data models, if you would like add a link to an external source, select Link to external content and type the text to display on the overview page, and specify the location of the link.
    • To display element icons in the navigation panes, and public, protected, or private status icons for the elements, select the Display element icons check box. If icons are not displayed, the published content looks more like Javadoc HTML documentation and the element status is represented with words.
    • To open the overview page when publishing finishes, select the Automatically display published output check box.
    • To delete the old contents of the destination folder before publishing the model, select the Always clean destination folder without asking check box.
  5. In the Select folder to publish to field, specify the destination folder for your published model.
  6. Click OK.

Results

The publishing process starts and a progress bar is displayed. When publishing completes, the output folder contains all the published HTML files for the selected elements of the models.

If you selected the Automatically display published output check box, the overview page of the published content opens to display a link to each of the published model elements. Otherwise, to view the published model, browse to the output folder that you specified and open the index.html file.


Feedback