SECollab lets you publish data models directly from client applications. The published data will subsequently be referred to as Design.
There are 2 publication modes:
- A connected mode: a direct HTTPS connection is possible between the workstation hosting the client application and the SECollab server, the data is published directly on the server
- A disconnected mode: the client machine is disconnected from the SECollab network, an archive is exported locally and will have to be imported in a second step to the server to complete the publication
Remark: Word documents can only be imported from the web application.
Engineering data can be published from a generic client SECollab Publisher connecting to the client application. The supported applications are:
- IBM Rational DOORS
- IBM Rational System Architect
- Enterprise Architect
- IBM Rational Rhapsody
Launching the publication
Remark: To publish data, you must have the "Project Leader" or "Publisher" role.
Here are the steps to launch a publication:
- Start the authoring tool and ensure that the data to be published is available.
In MEGA's case, close the application since the publisher now starts MEGA on its own.
- Depending on the authoring tool:
- If the Publisher is not integrated in the tool:
- Launch the SECollab Publisher executable.
- In the SECollab Publisher wizard, select the authoring tool to use.
- If the Publisher is integrated in the tool, depending on the tool, the publisher can be launch differently:
- Capella: click on File > Export then select SECollab > Export Capella to SECollab.
- MagicDraw: click on Tools > Publish to SECollab....
- Depending on the tool, the wizard allows you to select the scope of publication.
- IBM Rational DOORS: Selecting a Module, a Baseline and the Views
- IBM Rational System Architect: Selecting diagrams
- MEGA: Selecting libraries
- Enterprise Architect: Selecting diagrams
- Capella: Selecting the project to publish
- IBM Rational Rhapsody: Automatic connection to the open project
- MagicDraw: Automatic connection to the open model
- Once the item is selected, the rest of the wizard depends on the selected publication mode.
Online publication (connected mode)
In the case where the SECollab server is accessible from the client computer, it is recommended that you publish the data directly to the server.
Here are the steps to launch a connected publication:
- In the publish wizard, enter the server address.
- The address is of the type
- Consult your system administrator for the exact URL.
- Enter your Jazz ID and password in the window presented to authorize the connection.
- Once connected, select the project and stream to publish the design in.
- You can then choose for your publish to be imported as a new design in the folder of your choice, or to be imported as a new version of
an existing design, which you must select in the displayed tree.
Offline publication (disconnected mode)
If the server is not visible from the client station, due to security restrictions for example, you can publish the data in two steps:
Export the data to a local archive and then import this archive into the SECollab web application.
Here are the steps to launch a disconnected publication:
- In the publication wizard:
- Select an archive to be created in the client computer's file system instead of referencing the SECollab server
- From a web browser:
- Go to a SECollab project.
- Select the SECollab design page for this project.
- Click on Import a Design and select the archive produced by SECollab Publisher.
- You can then choose to import the archive as a new design in the folder of your choice, or to import it as a new version of
an existing design, which you must select in the displayed tree. In both cases the design will be imported in the currently
Follow-up of the publication
The publication process runs in the background on the server. Its execution time depends on the volume of data to be published.
The publication task is visible in the Activities tab in the SECollab project.
From this page it is possible to cancel a publication process in progress.
It is also possible to consult the publication log, especially if an error was detected during the publication. The publication log is an HTML page that you can export by saving the page, then send to anyone for review.
Every publication generates a new version of a design. One can browse versions of a design by going to Consulting a design history.
New version of an existing design
When publishing a design, it is possible to decide to import a new version of an existing design. In such case, the existing version
is replaced by the newly imported one. Differences between versions are explained when Consulting a design history.
If you want to cancel such an import while it is running, you may do so by deleting the related import activity. That will not delete the whole design but only the
version currently imported.