You need to have Domain Admin role assigned to perform the backup and restore.

Domain backup allows you to store all domain information in XML format.

Backup doesn't store data. You can export them manually from the Data Set or use one of the procedures described in BellaDati Backup and Restore.

Saving XML Backup

Domain backup can be done manually or automatically.

Automatic domain backup

Automatic domain backup is available since BellaDati 2.9.3.3

This function allows the user to schedule automatic backup of the domain to a folder, which is specified in the global configuration. To schedule Domain Backup:

  1. Navigate to Domain link in upper right corner of BellaDati window.
  2. Click on Edit in the Action box.
  3. Switch to tab Automated backup.
  4. Enable the backup by switching the "Active" toggle.
  5. Select how often should be the backup executed (default empty means daily). Backup runs at midnight (server time).For the week, month, quarter and year, the first day of the period is used.

Manual domain backup

To perform Domain Backup:

  1. Navigate to Domain link in upper right corner of BellaDati window
  2. Click Save XML Backup in left menu bar
  3. XML Backup of your domain will be downloaded




Loading XML Backup

In a multi-domain environment, it is necessary to use a domain administrator when restoring the domain admin and restore the backup to an existing domain.


To load Domain Backup

  1. Navigate to Domain link in upper right corner of BellaDati window
  2. Click Load XML Backup in left menu bar. You can select multiple domains to be updated from XML under Other domains to update. Those domains should be the same for restore. Wizard will be done according to main domain.
  3. Navigate to your XML Backup
  4. Follow the wizard to restore your backup

For referencing request config, use CODE

For referencing dataset, use CODE. Make sure, you are using unique names of dataset.

For referencing whole report, use ALIAS



Update other

You can update other domains settings from current domain

  1. Navigate to Domain link in upper right corner of BellaDati window
  2. Click Update other in left menu bar. You must select primary domain. This primary domain will be used as muster for wizard. Then select additional domains. All those domains should be the same for update.
  3. Follow the wizard to update other domains from current domain

Import Wizard

Missing users

Users, that ows any entity such as Dataset, Report etc. and are not part of domain import will be displayed under Missing users. Ownership of that user can be then replaced with different user. Click on Replace and select user.


Errors

Any errors, that could have not been resolved by system and needs to be resolved by user manually. In this example we can see XML with Dataset "Construction sites" contains report "Construction site detail" that uses GEO Map, does not contain map definition called "Prefecture-Code-Yumake". This map definition needs to be also part of that XML or needs to be available on server, where XML restore is executed.

Other option is to ignore import of that report, and do it later manually using report backup/restore. This is not recommended. If any other report will use this report e.g. button from different report would open view from this report. This linkage would be lost. If problems are still displayed even-though you for example excluded dataset from import, try to refresh the page.

Loading XML Backup from GIT

In a multi-domain environment, it is necessary to use a domain administrator when restoring the domain admin and restore the backup to an existing domain.


This functionality is accessible only with IDE enabled


To load domain backup from GIT

  1. Go to IDE and select
  2. Select "Update domain from git" (last item in menu)
  3. Fill your git repository address and your credentials
  4. Your domain backup filename located in repository must begin with prefix workspace_ all those files will be listed
  5. Select your backup and Continue
  6. Follow the wizard to restore your backup

User can Ignore import of object, it can be also mapped to already existing object (for example if dataset exists, import can be mapped to that existing dataset and it will be updated with new informations) or it can be added as a new object.

Existing extensions can be mapped to reports, but are not part of import. Domain menu is imported every time.

Next Steps