Direct Mapping

Direct Mappings are used to integrate your Library Management System (LMS) with your guide


A link should be built like this:


such as:

https://wisibel.com/view/29?lang=en&Department=&Location=Blue Area Floor 1&Shelf=371&Sublocation=


  • The language parameter is optional

  • The values are case insensitive: 

    • 'Department=Abc' == 'department=abc' == 'DEPARTMENT=ABC'

  • If some fields are not applicable, you can leave them empty, such as

    • ....&Department=&Shelf=371.123&....(Department is empty)

  • To find your guide ID, click 'Map Live View' and take note of the URL in the new browser window/tab. It should look like this, where the ending numbers is your guide ID, in this case 29: https://wisibel.com/view/29

  • If you'd like extra information to be displayed, you can add this as a "&text="-parameter, such as: 

The information (department, location, shelf and sublocation) is fetched by the single viewed item in your LMS. For example, if the user finds a book, that book's information (department, location, shelf, sublocation) is used to fill the URL.

Please refer to your LMS support/documentation to generate the links.

Creating Direct Mapping entries in your guide

When a generated link in your LMS is clicked, it's redirected to your guide. The information in the URL (department, location, shelf and sublocation) is then compared to the Direct Mapping entries that exists for the guide. If a match is found (the first match is taken), the animation of that entry is played. 

To add a new entry, navigate to the Direct Mappings and click "Create new direct mapping", or click on an existing one to edit it.


The editing page looks like this:

dm form.JPG

Enter values in the Department, Location, Shelf and Sublocation fields. Leave fields blank if they do not apply.


The values in the Deparment, Location, Shelf and Sublocation can be used as CSV (comma separated values). In this example, the direct mapping entry will match all incoming requests that has one of the following values:

371, F371, B371, FB370, 861


If no match is found for those values, the search truncates the incoming value and attempts to search again. This is then repeated until either a match is found, or the incoming value cannot be further truncated. This means that if you'd like one Direct Mapping entry to cover a wider range (800-805), you could enter




and all of the following incoming values will be a match:








but not the following:





Adding an animation to the Direct Mapping

When a match has been found, the matching Direct Mapping entry's animation is played. To assign an animation to the Direct Mapping entry, you can either:

a) Create an animation by clicking 'Create animation' and then create an animation and then click save. (See here for help with creating an animation)

b) Select an existing animation by clicking the drop down list, or the 'Detailed' button

Now save the Direct Mapping by clicking 'Save'

Adding text to be displayed when the Direct Mapping has been matched

If you'd like to display a message to the user, you can add these under 'Text to be displayed'. This is displayed like this and overrides any &text-parameter in the URL: