Migrating dashboards when updating Centigon Solutions components for Xcelsius, SAP Crystal Dashboard Design and SAP BusinessObjects Dashboards
As we improve our components by enhancing or changing properties, when you import an old Xcelsius dashboard configured to a previous component, you must follow a very specific process to ensure proper migration.
Background on Xcelsius save process:
When you save an Xcelsius project file XLF, it stores all of the meta data for all component properties and bindings in an XML file (inside the XLF). When you open an XLF Xcelsius will initially attempt to set both new and old properties. To ensure no legacy properties are cached by Xcelsius, you will need to initialize the property sheet and re-save your XLF, which should ensure new properties are included.
Migration Process:
Step 1. Open your XLF
Step 2. Open the property sheet for each custom component that you have upgraded
Step 3. Re-save your XLF project with a new file name
Step 4. Open your newly saved XLF.
TIP-Â It is preferred when you upgrade Centigon Components, that you use the same version of Xcelsius that was originally used to increase the success rate of migration. We understand that this is a top priority to ensure Centigon Solutions components do not effect a project lifecycle.
If you do still experience problems with migration you will be required to re-introduce the component to your project. To ensure no legacy properties are cached by Xcelsius, please perform the following.
Step 1. Open your XLF
Step 2. Delete your custom component(s)
Step 3. Re-save your XLF project with a new file name
Step 4. Open your newly saved XLF
Step 5. Import your component(s)
Step 6. Re-bind your components
TIP– If you need to re-bind your components, you can open a second instance of Xcelsius and then reference the properties.