Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This upgrade assumes that you are upgrading a project with the same structure as our starter project WIRE_GUI.

Extract Upgrade Zip File

  1. Move all config files to root project directory
    1. Copy all config files that are in the "bin" folder to the root of the WIRE_GUI directory.
  2. Extract the WIRE_ver4.0.zip archive into the root WIRE_GUI directory of your existing project. (This will overwrite your WIRE.dll.config and WIRE_GUI.dll.config files, so make sure you have a backup!)
  3. Delete the PrintPage.ascx file from the rood WIRE_GUI directory of your existing project.

Update Visual Studio Project

  1. Open the project in Visual Studio
  2. If you have references to to assemblies in the "bin" folder
    • Remove all references to assemblies in the "bin" folder
    • Move any dependent assemblies to the "lib" folder (make sure assemblies are removed from "bin")
  3. Reference the following assemblies in the "lib" folder
    • AjaxPro.2.dll
    • AssemblySettings.dll
    • BAMacros.dll
    • BrandonCollections.dll
    • DataDictionary.dll
    • Ionic.Zip.dll
    • RequestReduce.dll
    • WIRE.dll
    • Wire.XmlProfilePersister.dll
    • WireControls.dll
    • WireLicense.dll
    • Wire.Common.dll
  4. Delete all dlls from bin folder
  5. Include config files in project
    1. Include the WIRE.dll.config, WIRE_GUI.dll.config, DataDictionary.dll.config and Wire.XMLProfilePersister.dll.config files into the VS.NET project (right-click on files in VS.NET and choose "Include In Project").
    2. Select all four configuration files in VS.NET and edit the Properties for these files (press F4) to match the following:
  6. Include the following files/folders on the VS.NET project (right-click on file in VS.NET and choose "Include in Project")
    • Download.aspx
    • UserControls directory
    • Styles directory
      • jquery-ui.css
      • wire.css
    • Javascript directory
      • clientMenuScript.js
      • ClientScripts.js
      • CloseSideWindow.js
      • jquery-ui.min.js
      • jquery.js
      • jquery.plugins.js
      • jquery.popupwindow.js
      • lookupBtn.js
      • Stylesheets.js
      • vv_search.js
      • Wire.js
    • Images directory
      • AutoZoomOff_disabled.gif
      • AutoZoomOn_disabled.gif
      • Classic.gif
      • ClassicMode.png
      • Enhanced.gif
      • EnhancedMode.png
      • loading-animated-dots.gif
      • menu_over.png
      • Standard.gif
      • StandardMode.png
      • vv-close-button.png
    • Images/Button
      • navbutton.gif
      • navbutton2.gif
    • Images/Tabs directory
      • Rename.png
    • Images/Toolbar directory
      • refresh.gif
      • refresh_disabled.gif
      • toolbarbg.gif
      • toolbarbtn_separator.png

Configure WIRE

  1. Update WIRE configuration files
    1. Copy connections section from your original WIRE_GUI.dll.config file into the updated WIRE_GUI.dll.config file in the root of the WIRE_GUI directory
    2. Check both WIRE_GUI.dll.config and WIRE.dll.config files to ensure no existing configurations changed.
    3. Setup new path for User Profiles
      1. Ensure that Wire.XMLProfilePersister.dll.config has correct path to Profile directory on web server.
      2. Ensure that the user that the application pool runs under has the appropriate rights to write to the configured Profile directory 
    Update configuration for AjaxPro
  2. In the system.web config section of the web.config file, locate the following configuration element and replace with correct value:

    Code Block
    REPLACE
    			<!-- handler for AJAX.NET -->
    			<add verb="POST,GET" path="ajaxpro/*.ashx" type="AjaxPro.AjaxHandlerFactory, AjaxPro"/>
    
    
    WITH
    			<!-- handler for AJAX.NET -->
    			<add verb="POST,GET" path="ajaxpro/*.ashx" type="AjaxPro.AjaxHandlerFactory, AjaxPro.2"/>
     
    In
  3.  In the system.webServer config section of the web.config file, locate the following configuration element and replace with correct value:

     

    Code Block
    REPLACE
    			<!-- handler for AJAX.NET -->
    			<add name="AJAXPRO" verb="POST,GET" path="ajaxpro/*.ashx" type="AjaxPro.AjaxHandlerFactory, AjaxPro"/>
    
    
    WITH
    			<!-- handler for AJAX.NET -->
    			<add name="AJAXPRO" verb="POST,GET" path="ajaxpro/*.ashx" type="AjaxPro.AjaxHandlerFactory, AjaxPro.2"/>
  4. Include the following files/folders on the VS.NET project (right-click on file in VS.NET and choose "Include in Project")
    1. Download.aspx
    2. UserControls directory
    3. Styles directory
      1. jquery-ui.css
      2. wire.css
    4. Javascript directory
      1. clientMenuScript.js
      2. ClientScripts.js
      3. CloseSideWindow.js
      4. jquery-ui.min.js
      5. jquery.js
      6. jquery.plugins.js
      7. jquery.popupwindow.js
      8. lookupBtn.js
      9. Stylesheets.js
      10. vv_search.js
      11. Wire.js
    5. Images directory
      1. AutoZoomOff_disabled.gif
      2. AutoZoomOn_disabled.gif
      3. Classic.gif
      4. ClassicMode.png
      5. Enhanced.gif
      6. EnhancedMode.png
      7. loading-animated-dots.gif
      8. menu_over.png
      9. Standard.gif
      10. StandardMode.png
      11. vv-close-button.png
    6. Images/Button
      1. navbutton.gif
      2. navbutton2.gif
    7. Images/Tabs directory
      1. Rename.png
    8. Images/Toolbar directory
      1. refresh.gif
      2. refresh_disabled.gif
      3. toolbarbg.gif
      4. toolbarbtn_separator.png

Test You WIRE Application

Build WIRE Application and run.  If compile errors are encountered, see "Troubleshooting Upgrade" below...

Troubleshooting Upgrade

"Type ??? is not defined" or "??? is not declared"

If the Type that is not defined is Callback, DisplayModes, EventType, HostTypes or ScreenFilter

...

then Add the following Import to the top of the file reporting the exception

Code Block
Imports WIRE.Common

Property 'DisplayMode' is 'ReadOnly'

...