Other Applications

You can add external applications such as Gitlab, Jenkins, or SonarQube to the Allegra Perspectives menu. Together with an SSO system, this allows you to quickly switch between different applications without having to leave Allegra.

To provide access to external applications, download the portal extension from https://www.trackplus.com/de/service/erweiterungen.html to your server and copy the file portal-x.y.tpx to your TRACKPLUS_HOME/plugins directory.

The file will be unpacked there into a directory named TRACKPLUS_HOME/plugins/portal-x.y. In this directory, there is a file called trackplus-plugin.xml. It looks something like this:

<trackplus-plugin id="trackplus.plugin" name="PortalPlugin">

    <plugin-info>
        <description>Portal plug-in</description>.
        <version>7.0</version>
        <application-version min="7.0" max="10.0"/>
        <vendor name="Steinbeis - Allegra" url="https://www.trackplus.com"/>
    </plugin-info>

    <!-- ${SERVER} will be replaced by the Allegra server base URL -->
    <!-- including the protocol. You can also use a fixed URL like -->
    <!-- https://www.yourdomain.com -->

    <module id="jenkins"
        name="Jenkins"
        iconCls="jenkinsApp"
        useHeader="true"
        description="Jenkins integration"
        url="https://ci.yourdomain.com/internal/jenkins/"/>

    <module id="gitlab"
        name="GitLab"
        iconCls="gitlabApp"
        useHeader="true"
        description="Gitlab integration"
        url="https://ci.yourdomain.com:2244"/>

    <module** id="sonar"
        name="Sonar"
        iconCls="sonarApp"
        useHeader="true"
        description="Sonar integration"
        url="https://www.yourdomain.com/internal/sonar"/>
</trackplus-plugin>

The icons are integrated via a style sheet similar to the one below.

.gitlabApp {
    background-image: url(svg/other/gitlabLogo.svg) !important;
    background-size: 16px;
}

As an administrator, you can customize the style sheets via Administration by selecting Customize > Branding to adjust the style sheets accordingly.