How to Upgrade an Existing Add-On

<< Click to Display Table of Contents >>

Navigation:  Developers' Guide >

How to Upgrade an Existing Add-On

Navigation: Developers' Guide >

hm_btn_navigate_prevhm_btn_navigate_tophm_btn_navigate_next

How to Upgrade an Existing Add-On

Show/Hide Hidden Text

This topic contains two sections providing your insight for upgrading an existing add-on for latest iVend Retail version and upgrading add-on version for iVend Retail 6.6.

Upgrading an Add-On for the Latest iVend Retail Version

This section contains information about the upgrade process of iVend Retail Add-On, which has become very important to learn after release of iVend Retail 6.6.

The users who have upgraded from iVend Retail 6.4 series to the latest iVend Retail version released, also require to upgrade their Add-On in order to run it flawlessly and in accordance to the business requirement.

There are few important architectural changes in iVend Retail 6.6 that give more efficiency and agility to developers easing the development complexities.

Key Features of iVend Retail 6.6 - Extensibility for Add-On Development/Upgrade:

üThe VSIX template is no longer required for add-on development/upgrade.

üAll DLLs of subsystems are combined in a single DLL that is CXS.Retail.BusinessLogic.dll.

üOnly project DLL file is required for packaging and deployment of an add-on.

üGives control to run the add-on on selected Store(s) or all stores.

To upgrade an add-on:

1.Add a class library project file.

2.Add following three files in the project reference:

oCXS.Retail.Extensibility.dll

oCXS.Retail.ManagementUIComponents.dll

oCXS.RetailPOS.exe

Note

You can add other DLL reference files depending on development requirements.

 

3.Write business driven code for add-on.

Refer the How to Create an Add-On topic for more details.

4.Package and deploy the DLL file.

Refer the Packaging & Deployment topic for more details.

 

Add-On Version Upgrade in iVend Retail 6.6

This topic describes about upgrading an existing version of an add-on using iVend Add-On Framework.

Developers can customize the existing add-on, which includes changing version information, customizing code according to new business requirements, and other changes.

To upgrade an iVend Retail add-on version:

1.Open the existing project “SampleAddonForPO”.

2.Change the value in the Version property.

3.Ensure that you put the value in increasing manner.

4.For example, if the existing version of an add-on is 1.0.0.0 then the upgrade version should be 1.0.0.1.

5.Now change the add-on according to your requirements.

6.Refer to the Packaging and Deployment topic for upgrading the add-on.

Click here collapse/expand the view.

Code Snippet for Changing Version Information

Existing Add-On Version

public override Version VersionInfo

        {

            get

            {

                System.Version MyVersion = new Version("1.0.0.0");

                return MyVersion;

            }

        }

 

Changed Add-On Version

public override Version VersionInfo

        {

            get

            {

                System.Version MyVersion = new Version("1.0.0.1");

                return MyVersion;

            }

        }