Manually Upgrading Previous Versions of NetAdvantage for jQuery

Purpose

This post details how to upgrade an existing project using NetAdvantage® for jQuery to the current version.

Required background

You need to first read the following topics:

Manually Upgrading Script Files and Themes

Introduction

For any application that is using only the JavaScript and jQuery UI Themes, you can upgrade the necessary files in your application. If you are using ASP.NET MVC, you need to upgrade the assembly references as well as the JavaScript and jQuery UI Themes.

Requirements

To complete the procedure, you need the following:

  • An Application Using NetAdvantage for jQuery

Overview

Following is a conceptual overview of the process:

  1. Backing up current resources
    1. Backing up JavaScript files
    2. Backing up themes
  2. Replacing JavaScript files
    1. Locating the installation directory for the new JavaScript files
    2. Copying the required JavaScript files into your existing application
  3. Replacing themes
    1. Locating the installation directory for the new jQuery UI themes
    2. Copying the required themes into your existing application
  4. Optional – Upgrading the NetAdvantage for jQuery .NET assemblies
    1. Removing the existing references to the NetAdvantage assemblies
    2. Adding the new version of the Infragistics assemblies to your project.

Steps

  1. Backup current resources.

    Create a backup directory in your project or on your hard drive to where you can move the old JavaScript files and jQuery UI themes.

    1. Backup JavaScript files.

      Move all Infragistics script files, those beginning with “ig.”, to your backup folder. If you are using the combined JavaScript, you only have one file to move. If you are using individual files, you have to move them all to your backup folder.

    2. Backup themes.

      Move the ‘base’ and ‘ig’ themes to your backup folder. If you are using a custom ThemeRoller theme instead of the ‘ig’ theme, you can re-use the same theme in the new version of NetAdvantage. If you are using the minified themes, move those themes to the backup folder as well.

  2. Replace JavaScript files.

    1. Locate the installation directory for the new JavaScript files.

      By default, the installer places the new JavaScript files in: C:\Program Files\Infragistics\NetAdvantage <version>\jQuery\js where <version> represents the new version, e.g. “2011.2”.

      If you did not use the installer, you can download a zip file containing all of the JavaScript files from the Infragistics website. The JavaScript files are found in the “js” directory contained in the downloadable zip file.

    2. Copy the required JavaScript files into your existing application.

      Examine the files in your backup directory and for each JavaScript file that you backed up, retrieve the JavaScript file with the same name from the installation directory of the new version of NetAdvantage for jQuery.

      Place the new versions in your application at the same location as the previous version of the files. For instance, if you backed up the ig.ui.min.js combined and minified file located your application’s “scripts” folder, you should retrieve that file from your installation directory for the new version of NetAdvantage for jQuery and place it in your application’s “scripts” folder.

  3. Replace themes.

    1. Locate the installation directory for the new jQuery UI themes.

      By default, the installer places the new themes in: C:\Program Files\Infragistics\NetAdvantage <version>\jQuery\themes where <version> represents the new version, e.g. “2011.2”.

      If you did not use the installer, you can download a zip file containing all of the required themes from the Infragistics website. The JavaScript files are found in the “themes” directory contained in the downloadable zip file.

    2. Copy the required themes into your existing application.

      Refer to your backup directory. For each jQuery UI theme that you backed up, retrieve the theme with the same name from the new NetAdvantage for jQuery installation directory.

      Place the new versions of the themes in the same location as the previous version of each theme. For instance, if you backed up the “ig” and “base” themes from your application’s “jquerythemes” folder, you should copy the new versions of the themes from your installation directory, and place them in your application's “jquerythemes” folder.

      Note: If you have customized the older versions of the themes, those customizations must be manually copied to the new versions of the themes.

  4. Optional - Upgrade the NetAdvantage for jQuery .NET Assemblies.

    If you are using the ASP.NET MVC helpers or any of the Document assemblies in your application, the assemblies for the new versions must be included in your application:

    • Infragistics.Web.Mvc.dll
    • Infragistics.WebUI.Documents.Core.dll or Infragistics.Web.Mvc.Documents.Core.dll
    • Infragistics.WebUI.Documents.IO.dll or Infragistics.Web.Mvc.Documents.IO.dll
    • Infragistics.WebUI.Documents.Reports.dll or Infragistics.Web.Mvc.Documents.Reports.dll
    • Infragistics.WebUI.Documents.Excel.dll or Infragistics.Web.Mvc.Documents.Excel.dll
    • Infragistics.WebUI.Documents.Word.dll or Infragistics.Web.Mvc.Documents.Word.dll

    Note: The new versions of the document assemblies use the Infragistics.Web.Mvc.Documents naming convention.

    1. Remove the existing references to the NetAdvantage assemblies.

      In Visual Studio, remove the existing references for the Infragistics assemblies from your project.

    2. Add and reference the new version of the Infragistics assemblies in your project.

      By default, the installer places the new assemblies in: C:\Program Files\Infragistics\NetAdvantage <version>\jQuery\MVC where <version> represents the new version, e.g. “2011.2”.

      Add and reference the new .NET assemblies in your project.

      Note: The method by which you add the assemblies to your project will vary depending on the type of deployment you are using. In most cases, removing the old assemblies from the bin folder and adding the new assemblies to the bin folder will be adequate but the steps may differ if you are using a different deployment method.

Related Topics

Following are some other topics you may find useful.


Tags / ,

Add a Comment

Be the first one to add a comment. Please Login or Register to add comment.