How to set up and use Dynamic Links in Mavim Portal

Introduction

Dynamic links in Mavim allow you to automatically generate links to external or internal web-based systems, such as document management systems, ERPs, or learning platforms like the Mavim Academy.
Instead of manually creating individual links, you can configure Mavim to build them dynamically based on topic data. This is especially useful when publishing to the Mavim Portal, where lists or reports can contain fields that determine the final link destination.

In this article, we’ll walk through:

• How to enable and configure dynamic links in the Mavim Portal

• How to create dynamic links using field references

• How to use tokens and expressions for advanced configurations

---

Part 1: Getting started with dynamic links

 

Step 1: Understand the concept

Most business systems display deeplinks in their browser address bar. These links often include parameters such as categories, filters, or item codes. Dynamic links in Mavim replicate this logic, allowing you to automatically generate those URLs based on topic fields.

In our example, we’ll link Mavim Portal topics representing Mavim Academy courses directly to the corresponding Academy course pages.

Step 2: Enable dynamic links

1. In the Mavim Portal, go to Administration.

2. Open the General tab.

3. Switch to the Dynamic Links tab.

4. Ensure the Dynamic Links feature is enabled.

Step 3: Prepare your content in Mavim Manager

1. Open your Mavim database in Mavim Manager.

2. Identify or create the topic set that will use dynamic links (for example, a list of microlearning courses).

3. Make sure each topic contains a code field with a unique value that can be referenced in the link (e.g., LNK01).

Step 4: Create a new dynamic link

1. Return to the Mavim Portal and open Administration > Dynamic Links.

2. Click New to create a new link.

3. In the Code field, enter the code value from your topics (e.g., LNK01).

4. In the Open field, paste a sample deeplink from the target system (for example, a Mavim Academy course URL).

5. Remove any part that is unique to a single record (like a specific course code).

6. Replace that portion with a reference to the field containing the dynamic value. For example:

    

   [Field:Course code]


   This tells Mavim to insert the course code from each topic when generating the link.

7. Set Window to Blank if you want the link to open in a new browser tab.

Step 5: Test the dynamic link

1. Refresh the Mavim Portal.

2. Switch to the report view of your published list.

3. Click a topic name.

4. The system should now open the corresponding course (or other linked resource) in a new browser tab.

Note: Dynamic links behave differently from standard links in Mavim. Selecting a topic will open the external URL directly, even when accessed from the tree view or a Visio chart.

---

Part 2: Advanced features of dynamic links

Once you understand the basics, you can make your configuration more flexible using tokens, expressions, and additional field references.

Step 1: Simplify URLs with tokens

If multiple links share a common part of their URL (for example, https://academy.mavim.com), you can define that base as a token.
This allows you to maintain it in one place instead of updating every link manually.

To add a token:

1. Go to Administration > Dynamic Links.

2. Click New under the Tokens section.

3. Enter a name (e.g., MavimAcademy).

4. Enter the shared value (e.g., https://academy.mavim.com).

5. Replace that part of the URL in your dynamic link definition with {MavimAcademy}.

If the base URL ever changes, update the token once and all links using it will update automatically.

Step 2: Use different reference types

Dynamic links can use values from several sources in Mavim:

• Topic name

• Parent topic name

• Topic code

• Field values

You can combine these references to build more complex URLs. For example:

Step 3: Configure advanced links with multiple variables

In more complex structures, links may include categories, folders, sorting settings, or languages.
Each of these elements can be derived from different Mavim data points:

• Category: parent topic name

• Folder: subtopic name

• Language: field value

• Sorting: token reference

Step 4: Apply expressions with Regex

If your code field contains multiple possible values (for example, document or form), use Regex (regular expressions) to define a rule that matches either value.

To use Regex:

1. In the Dynamic Links tab, select Regex for the link type.

2. Enter your expression, such as:

   document|form The vertical bar (|) means “or.”

Step 5: Test before going live

1. To test, set the Action option to Message.
   This displays the generated URL in a popup instead of opening it.

2. Verify that the URL is correct.

3. Once confirmed, change Action back to Open in new tab.

Your dynamic link is now active and will automatically generate correct URLs for each topic based on its data.

---

Key notes and prerequisites

• You must have Administrator rights in the Mavim Portal to configure dynamic links.

• The topics used in links must have consistent code or field values.

• Always test your link configuration using Message mode before publishing to users.

• If your environment structure or base URLs change, review your tokens to prevent broken links.