Migration Process

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 initilalze the property sheet and re-save your XLF, which should ensure new properties are included.

Migration Process:

Step 1. Install your new XLX plugin component (full instructions)
Step 2. Open your XLF
Step 3. Open the property sheet for each custom component that you have upgraded
Step 4. Re-save your XLF project with a new file name
Step 5. Open your newly saved XLF.

TIP- It is prefered 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 understad 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.

Flex2- Flex4 migration with CMaps and GMaps

Versions of SAP Dashboards for BI4. SP04 and higher will require the use of Flex4 components. This includes CMaps Plugin and GMaps Plugin 3.6.1. Existing customers who have previously used GMaps Plugin can upgrade to the latest CMaps Plugin version, or GMaps Plugin 3.6.1. All versions are available on Centigon Solutions portal: http://support.centigonsolutions.com

Note: Trial users must upgrade to CMaps Plugin 4

Additional Version Notes for Upgrade and Migration

GMaps Plugin to CMaps Plugin V4 
CMaps Plugin requires you to upgrade your license prior to installing and using the component. Trial users do not need to take the following steps.

1. Install the CMaps Plugin XLX into SAP Dashboards

2. Locate your current license and authentication key that you are using at the bottom of the Info Tab on the properties sheet.

3. Login to Centigon Solutions customer portal.

4. Go to the Upgrade GMaps Plugin License tab.

5. Select the license key that you located in step 1

6. Upgrade the license.

7. Re-load the map property sheet which will unlock the component.


GMaps Plugin v3.0 to 3.5

With new features in GMaps 3.5, there are a few slight changes to default properties that could impact your existing dashboard project. To ensure the user experience is NOT impacted, please make the following adjustments.

Transparency- The new transparency feature grants control over all layers within your dashboard. To ensure consistency, the default transparency for all migrated series is 100%. You will need to reduce the transparency for all series back to 70% to match previous versions of GMaps Plugin.

GMaps Plugin v2.0 or v2.1 to 3.0 or 3.5
When migrating from version 2.0 or 2.1 to 3.0 there are architecture changes that you will need to be aware of, to ensure your dashboard applications will operate exactly the same as 2.1. These changes will ensure you can take full advantage of powerful new featuers implmented in GMaps Plugin.

Selector Configuration
New to GMaps Plugin 3.0 is a improved selector architecture allowing developers to define independant selector behavior per series (excludes multi-selection). When migrating an existing model, GMaps Plugin will automatically notify you of this modification. Because this feature does not enable backwards compatability, you will need to re-configure your selector Insertion Type, Source Data, and Destination.

GMaps Plugin v2.0 to v2.1
GMaps Plugin 2.1 features several enhancements that modify existing property behavior. To ensure your map performs similar to 2.0, you will need to observe the following modifications.

Tool tips are removed- In place of tool tips, we have implemented Info Window display on click, roll over, or both. This allows you to have 100% control over the contents that are displayed when you hover and click on data points.

Polygon Outlines- 2.1 allows you to show/hide polygon outlines and change color. If your dashboard is missing the polygon outlines, you may need to re-enable them in your dashboard.

GMaps Plugin v1.0 to v2.1
If you are migrating GMaps Plugin 1.1 to 2.1 you may need to re-configure your map if your map does not behave exactly as it did within your 1.x version.