Upgrade (Sales Insights)

This guide provides a step-by-step guide for upgrading the Sales Insights Accelerator to a newer version. It emphasizes the importance of careful execution to ensure a smooth upgrade process.

Upgrade Steps

1. Create a Backup of All Logics

Any custom changes made to the accelerator logics will not be preserved during the upgrade. These changes must be reapplied if the code has been altered. Ensure all current logics are backed up.

1.1 Determine List of All Logics

If the Sales Insights Accelerator has been deployed using the PlatformManager use the following steps to determine the list of all logics.

1. Go to Company Parameters.

2. Enter deployedAccelerators parameter into Name column.

3. In the Company Parameter menu:

   1. Enter sales-insights-dashboards parameter into Name column.

   2. Copy the content from the value column.

Example

{
  "processedActions": {
    "CalculationLogic": [
      "ConfigurationWizardLib+2021-01-01",
      "SIP_Dashboards_Commons+2020-01-01",
      "Configurator_ComparisonWaterfall+2020-01-01",
      "Dashboard_RevenueAndMarginDistribution_Country+2020-01-01",
      "MonitoringLib+2019-07-01",
      "HighmapsLibrary+2019-01-01",
      "StopwatchLib+2019-01-01",
      "HighchartsLibrary+2000-01-01",
      "Revenue_Breakdown+2020-01-01",
      "Configurator_Outliers+2020-01-01",
      "Dashboard_RevenueAndMargin+2020-01-01",
      "SIP_Causality_Period_Configurator+2020-01-01",
      "Configurator_RegionAndCountry+2020-01-01",
      "Dashboard_PeriodOverPeriod+2000-01-01",
      "Dashboard_PeriodOverPeriod_Configurator+2000-01-01",
      "Dashboard_Margin_Breakdown+2020-01-01",
      "Dashboard_ComparisonWaterfall+2020-01-01",
      "Outliers_Dashboard+2020-01-01",
      "Dashboard_Waterfall+2020-01-01",
      "SharedLib+2010-01-01",
      "HighchartsPortletLibrary+2020-01-01",
      "Dashboard_Causality+2020-01-01",
      "SharedAccLib+2010-01-01"
    ],
  },
  "templateVersion": "DEVELOP"
}

1.2 Review Git Repository

Alternatively, you can review the Sales Insights Git Repository. The logic files are stored in the CalculationLogic folder. Git tags can be browsed to examine code from previous versions.

2. Determine Current Accelerator Version

Identify the installed version of the Sales Insights Package by checking deployed Accelerators in the PlatformManager (Account > Partitions > Partition > Accelerators). Utilize the Label column to filter records specifically related to Sales Insights.

Alternatively, check the deployedAccelerators parameter in the Company Parameters of your partition.

Example

{
  "processedActions": {
    "CalculationLogic": [
      "ConfigurationWizardLib+2021-01-01",
      "SIP_Dashboards_Commons+2020-01-01",
      "Configurator_ComparisonWaterfall+2020-01-01",
      "MonitoringLib+2019-07-01",
      "Dashboard_RevenueAndMarginDistribution_Country+2020-01-01",
      "HighmapsLibrary+2019-01-01",
      "StopwatchLib+2019-01-01",
      "HighchartsLibrary+2000-01-01",
      "Revenue_Breakdown+2020-01-01",
      "Configurator_Outliers+2020-01-01",
      "Dashboard_RevenueAndMargin+2020-01-01",
      "SIP_Causality_Period_Configurator+2020-01-01",
      "Configurator_RegionAndCountry+2020-01-01",
      "Dashboard_PeriodOverPeriod+2000-01-01",
      "Dashboard_PeriodOverPeriod_Configurator+2000-01-01",
      "Dashboard_Margin_Breakdown+2020-01-01",
      "Dashboard_ComparisonWaterfall+2020-01-01",
      "Outliers_Dashboard+2020-01-01",
      "Dashboard_Waterfall+2020-01-01",
      "SharedLib+2010-01-01",
      "HighchartsPortletLibrary+2020-01-01",
      "SharedAccLib+2010-01-01",
      "Dashboard_Causality+2020-01-01"
    ],
    "Dashboard": ["HighChartLibrary_Examples"]
  },
  "templateVersion": "1.11.0"
}

3. Review Manual Changes

Read through the upgrade notes provided for your current version up to the target version (if available). Note any changes that need to be made before the upgrade, and follow the provided instructions.

4. Run the Upgrade Package

Navigate to the Marketplace in the PlatformManager, locate the Sales Insights - Upgrade package, and execute the upgrade process by deploying the package to your partition.

5. Execute Remaining Upgrade Notes

Follow the specific upgrade notes to completion, including any required manual changes after the upgrade. Ensure no errors occur during this phase.

6. Reapply Customizations

After the upgrade, reapply any previously implemented customizations. Verify that these modifications integrate seamlessly and do not produce errors.

Important Considerations

• Custom modifications will need to be reapplied after the upgrade.

• The upgrade process will override all accelerator logics, while the configuration remains unchanged.

Release Specific Upgrade Notes