Import/Export

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.

../_images/ie_menu_8.1.png

Fig. 552 Import/Export menu

Artifacts

Export

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.

../_images/impexp_gallery11.png

Fig. 553 Artifacts Export

../_images/impexp_gallery21.png

Fig. 554 Artifacts Export - Items selection

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

../_images/impexp_gallery31.png

Fig. 555 Artifacts Export - setting name for zip file

Import

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

../_images/impexp_gallery41.png

Fig. 556 Artifacts Import - Export file selection #1

../_images/impexp_gallery51.png

Fig. 557 Artifacts Import - Export file selection #2

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

../_images/impexp_gallery61.png

Fig. 558 Artifacts Import - items selection

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

../_images/impexp_gallery71.png

Fig. 559 Gallery Management Gui

../_images/impexp_gallery81.png

Fig. 560 Functions Management Gui

Documents

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.

../_images/image672.png

Fig. 561 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:

../_images/OCW_8.1.png

Fig. 562 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:

../_images/SDOC1.png

Fig. 563 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.

../_images/image682.png

Fig. 564 Document Import

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

../_images/image1101.png

Fig. 565 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.

../_images/image1132.png

Fig. 566 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.

../_images/image1141.png

Fig. 567 Document Import Missing licenses

Users

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

../_images/image732.png

Fig. 572 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.

../_images/image742.png

Fig. 573 User Import

Important

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

Catalogs

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.

../_images/image75_8.1.png

Fig. 574 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.

../_images/image761.png

Fig. 575 Catalogs Import

KPIs

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.

../_images/image781.png

Fig. 576 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.

../_images/image792.png

Fig. 577 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.

../_images/image823.png

Fig. 578 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.

../_images/image833.png

Fig. 579 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.

../_images/image842.png

Fig. 580 Mapping data sources

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

../_images/image852.png

Fig. 581 Import KPIs ended successfully

Analytical Drivers

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

../_images/image862.png

Fig. 582 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.

Afterwards:

  • 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.

../_images/image872.png

Fig. 583 Import of analytical drivers

../_images/image882.png

Fig. 584 Import of analytical drivers

../_images/image892.png

Fig. 585 Import of analytical drivers

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

Glossary

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

../_images/image903.png

Fig. 586 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.

../_images/image913.png

Fig. 587 Import of glossaries

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

Alerts

This functionality allows to Export/Import alerts.

../_images/export_alert_8.1.png

Fig. 588 Export alerts

../_images/import_alert_8.1.png

Fig. 589 Import alerts