This functionality allows to import/export items belonging to Gallery, Documents, Menu, Users, KPIs and Catalogs. After exporting, the user can import the information previously extracted into a different Knowage installation or tenant.


Fig. 540 Import/Export menu



It is possible to export widgets and functions to a zip file to use afterwards as a source to be imported to a different environment. As shown below, select the items of your interest and click on EXPORT.


Fig. 541 Artifacts Export


Fig. 542 Artifacts Export - Items selection

After the selection, give a name to the file and confirm with Export button.


Fig. 543 Artifacts Export - setting name for zip file


You can import the zip file formerly exported just clicking on IMPORT. See below image:


Fig. 544 Artifacts Import - Export file selection #1


Fig. 545 Artifacts Import - Export file selection #2

Clicking on NEXT, it is possible to see and select the items to be imported..


Fig. 546 Artifacts Import - items selection

Click on the IMPORT button to make selected widgets and functions available in the new environment.


Fig. 547 Gallery Management Gui


Fig. 548 Functions Management Gui


This feature allows to download a zip file of the whole or a part of the documents existing in your Knowage installation.

Below, you can see how the export editor looks like.


Fig. 549 Document Export

Fill in the name of your export and select which documents to export. You can browse through folders by clicking on the relative icon. Check the items to include in the file. The export icon changes colour from grey to pink. Before starting to export, you can decide whether to include or not the following options:

  • Olap customized View
    By checking this property, the export will include all the customized views saved into the selected OLAP documents. Customized views can be retrieved clicking on the option Show OLAP custom View of the Document Menu. See below image for more details:

Fig. 550 Olap customized view

  • Scheduled documents
    By checking this property, the export will include all the scheduled executions saved into the selected documents. You can find the scheduled executions clicking on the option Show Scheduled Execution of the Document Menu. See the figure below:

Fig. 551 Scheduled documents

  • BIRT Translation
    By checking this property, the export will include all the translation added into the Localization functionalities of BIRT templates.
  • Schedule configurations
    By checking this property, the export will include all the scheduling associated to the selected documents. At the end of the import, the scheduling information will be saved into the Scheduler section.
  • Export the document only in the selected functionality
    By checking this property, the export will include documents only if they are inside a selected functionality.
  • Related documents
    By checking this property, the export will include all those documents linked through the cross navigation to the selected documents.

Fig. 552 Document Import

You will be asked to map Roles, Engines, Datasources and Metadata from Source to Target.


Fig. 553 Document Import Wizard

If a role does not match any of the existing ones, the role will be created. Please bear in mind that all the target metadata with the same label i.e. documents, lovs, drivers will be overwritten when importing.


Fig. 554 Document Export Missing licenses

Before starting the import procedure, licenses are checked and if one or more are missing or are not valid, the user will be informed with the list of all those documents that will not be imported. See image below.


Fig. 555 Document Import Missing licenses


This functionality allows to export/import users from one installation/tenant to another.See the image below.


Fig. 560 User Export

To generate the zip file, fill in the name of your file and select the users to include. You can also include the personal folder of the users just checking the option Export Personal folder.

To import your zip file, log in and select Users from Import\Export. Switch to the Import tab and click on Browse . Choose the file and click on the import icon. The list of users contained in your file are uploaded. Make your selection and click on the arrow to move them to the other side. Now click on the Start import button and your users will be created. See figure below.


Fig. 561 User Import


All users involved in the import procedure will have the password changed with the value set in Advanced configuration.


This functionality allows to Export/Import the following elements:

  • Datasets,
  • Business models,
  • Mondrian catalogs,
  • Layers,
  • SVG files.

The details are shown in the below figure.


Fig. 562 Catalogs Export

To generate the zip file, mark the items to include and fill in the export name. Save the export file in your local system.

To import the zip file, log in to the source tenant, select Catalogs from the Import/Export menu and switch to the Import tab. Click on Browse and choose the file previously created through the exportation. Uploading the file, the list of available catalogs are displayed. Choose the ones to be imported, decide if you want to override them or just add the missing ones and then click on Start import. Your catalogs will be created in this environment.


Fig. 563 Catalogs Import


In this section we describe how to manage the import/export of KPIs between two tenants.

The user must enter Knowage as administrator of the source tenant and click on KPIs from the Import/Export menu panel.

The page contains the Export and the Import tab, where the user can select the KPIs for the export/import respectively.


Fig. 564 KPIs Import window

Let’s start from the export feature. The user at first selects the KPIs to be exported and in addition can include:

  • targets,
  • the scorecards related to the selected KPIs,
  • schedulations.

Click on the red download button to get a zip file.


Fig. 565 Start export button

Once the zip file is downloaded, the user has to switch to the tenant used for the import and as admin enter the Import/Export KPIs functionality and move to the Import tab.

The user must therefore browse the personal folder to catch the zip file and click on the red upload button, as shown below.


Fig. 566 Import tab

Referring to the following image, the user has to specify if:

  • overwriting the existing KPIs and their related formulas
  • importing targets,
  • importing scorecards,
  • importing schedulations.

Fig. 567 Import KPIs settings

Once the import is started, the GUI leads the user to finalize the import procedure. In particular, the user is asked to map data sources correctly. See figure below.


Fig. 568 Mapping data sources

The process ends successfully when the wizard shows up as following.


Fig. 569 Import KPIs ended successfully

Analytical Drivers

This option allows to import/export the analytical drivers and their related LOVs.


Fig. 570 Import/Export of analytical drivers

As shown in figure above, the window contains the Export and the Import tab. Use the Export tab to download the zip file to be used in the import process.


  • log in as administrator to the source tentant,
  • assign a name to the export,
  • check the analytical drivers of interest and
  • click on the red download button, available at the top right corner of the page to get the zip file.

It is possible to narrow the search of the analytical drivers by filtering on their creation date.

Switch to the target tenant and log in as administrator. Use the Import tab to upload the zipped folder and finalize the import.

Use the GUI to upload the zip file and specify if overwriting the existing analytical drivers or just adding the missing ones. Then click on NEXT and continue by mapping roles between the source and the target tenants.


Fig. 571 Import of analytical drivers


Fig. 572 Import of analytical drivers


Fig. 573 Import of analytical drivers

The process ends with a message containing the information about the import.


The export/import of glossary allows the user to align glossaries among tenants.


Fig. 574 Export/Import of glossaries window

In the Export tab, the user is asked to select the glossaries to export and type a name that will be assigned to the zip file. The searching functionality can be used for the selection.

Afterwards, connecting as admin to a target tenant, the user selects the Import tab from the Export/Import main window.


Fig. 575 Import of glossaries

Arrows are used to indicate the glossaries to consider for the import.


This functionality allows to Export/Import alerts.


Fig. 576 Export alerts


Fig. 577 Import alerts