Publishing referenced model elements

In IBM DevOps Model Architect, you might have a diagram in a model that has elements from other models. When the particular model is web published along with the model elements that belong to the other models, those model elements must also be included in the web published model so that their properties can be viewed along with the properties of the model elements that belong to the web published model.

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

To publish all the dependent or referenced elements from other packages, you must complete the following steps:

Select the parent package. Right-click Add UML and then select Relationship > Package Import, and then select the referenced package. For more information about web publishing, see Publishing models.
Select the parent package and go to the Properties view. Select the Documentation section. Add a Link (Select the Use workspace path check box, browse to the workspace using the Browse workspace button, and then select the referenced Package) to the referenced package.
Note: Repeat this step for all the referenced packages because the links that are created are not automatically published unless the packages are imported as described in step 1.

To include links to the model documentation, select Create links in the Publish to Web dialog box under URLs section.

The documentation section is included in the index page, which is the Overview page of the published content, so that user can go to the referenced packages from the overview page easily.

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