Add links to the CCMS Web menu

As an administrator, you can add links to the main menu so that CCMS Web users can quickly access menu options as static links.

If you have web applications or pages that are related to CCMS Web, you can add links to reference them directly from CCMS Web Suppose you have results for your own reports build. You can link to those reports directly from CCMS Web.

To facilitate the integration with those external applications, use the following variables in the links to provide some level of context:

  • email
  • domain
  • groups
  • roles
  • username

For example, links to reports could use the ${username} variable and the report application would return only the reports relevant for that user.

To add links to the CCMS Web menu:

  1. In the TEXTML Administration perspective, connect to your server.
  2. Locate the web.platform.config.xml file in Repository > system > webplatform > configuration.
  3. Check out the file and open it for editing.
  4. Double-click the file to open it.
  5. Within the <properties> element add links.

    Each link is added as a cluster of <entry> elements with the same values for their key attribute. The value for the key attribute must start with static_link.. but after this character string you can use any value you want. For <entry> elements that contain text, the key attribute must end with one of the language codes, such as .en, .fr, .de, or .ja.

    For example, this is a static link to a website with different text for the link, depending on whether the users are using an English or French version of the UI: 
    <entry key="static_link.anchor1">https://www.ixiasoft.com/</entry>
<entry key="static_link.anchor1.en">Go to IXIASOFT</entry>
<entry key="static_link.anchor1.fr">Aller sur IXIASOFT</entry>
    Note: In this case static_link. is required, but anchor1 is a variable for any value you want.

    You can also add parameters to the URL, such as variables, which CCMS Web replaces with values from the user.

    For example, this codeblock uses variables for the user's username and role as part of the URL link: 
    <entry key="static_link.anchor2">https://www.ixiasoft.com/?hl=fr-ca$amp;user=${username}&amp;roles=${roles}</entry>
<entry key="static_link.anchor2.en">IXIASOFT</entry>

    You add multiple links by using different values after static_link.

    For example, this codeblock adds weblink2:
    <entry key="static_link.anchor1">https://www.ixiasoft.com/</entry>
<entry key="static_link.anchor1.en">Go to IXIASOFT</entry>

<entry key="static_link.weblink2">https://www.ixiasoft.com/?hl=fr-ca$amp;user=${username}&amp;roles=${roles}</entry>
<entry key="static_link.weblink2.en">IXIASOFT</entry>
  6. Save, close, and check in the file.
  7. Restart CCMS Web by taking the following actions:
    1. On the IXIA CCMS Web Server, click Start > Control Panel > Administrative Tools.
    2. Double-click Services.
      The Services dialog opens.
    3. Select the Ixiasoft Output Generator service .
    4. In the list of services, right-click the Tomcat CCMS service, and select Restart.
      The Status column changes for the Tomcat CCMS service.
The links you created are added to the CCMS Web menu and available for use.