Getting Started - Appendix

Additionally helpful reference material is provided below.

 

Business Analyst Online API for Silverlight Version 2.2 Compatible with the Current Release of the ArcGIS API for Silverlight (Version 2.4, build 851)

The core ArcGIS API for Silverlight v2.4, build 851 (v2.4.0.851) encompasses many compelling features, improvements, and samples that may be of benefit to your development efforts which include the Business Analyst Online API for Silverlight. Unfortunately, the current Business Analyst Online API for Silverlight v2.2 is not compatible with the latest core ArcGIS API for Silverlight release.

While we are working on releasing the next version of the Business Analyst Online API for Silverlight, we are offering our customers the option to install and update their existing applications built against the Business Analyst Online API for Silverlight v2.2 so that they are compatible with the latest core ArcGIS API for Silverlight v2.4.0.851.

 

Quick Steps to Update Your Existing Business Analyst Online API for Silverlight v2.2 Visual Studio 2010 Solutions:

  1. Install the core ArcGIS API for Silverlight (the most current version which is v2.4.0.851) available here.

    The core ArcGIS API for Silverlight v2.4.0.851 will be installed at either C:\Program Files (x86)\ESRI SDKs\Silverlight\v2.4 (64-bit CPU) or C:\Program Files\ESRI SDKs\Silverlight\v2.4 (32-bit CPU).

  2. Download and install the Business Analyst Online API for Silverlight version 2.2 for Core ArcGIS API for Silverlight version 2.4.

    The Business Analyst Online API for Silverlight v2.2.0.0 assembly will be installed at either C:\Program Files (x86)\ESRI SDKs\Silverlight\BAOnline\v2.2 (64-bit CPU) or C:\Program Files\ESRI SDKs\Silverlight\BAOnline\v2.2 (32-bit CPU).

    Note: You may need to uninstall any previous Business Analyst Online API for Silverlight version 2.2 setup since is not compatible with core ArcGIS API for Silverlight v2.4.0.851.

  3. In your application code be sure to update and verify the version numbers of the following assembly references and clean/recompile your solution:

    Note: Current Business Analyst Online API for Silverlight v2.2 sample application code and downloads will need to be updated.

 

Note About "Blocked" Assemblies

This information applies to the ArcGIS API for Silverlight as well as the Business Analyst Online or Server APIs for Silverlight when downloading assemblies or Visual Studio 2010 solutions that contain assemblies. This important note is for your future reference.

As part as a security enhancement in Visual Studio 2010, you now need to “opt-in” to using/referencing certain assemblies/.dlls when they are downloaded and were not originally installed/registered on your system. If you get an error or warning about downloaded or blocked assemblies, you will need to manually unblock them before building and running the application within Visual Studio 2010.

See the following link for instructions on how to unblock an assembly for Visual Studio 2010:
http://go.microsoft.com/fwlink/?LinkId=179545. Basically you must shut down Visual Studio; right-click on the assemblies in question; select Properties from the popup dialog; click on “Unblock”; and reopen the Visual Studio solution. If the “Unblock” button is not available then the assembly is not being blocked by your system.

 

Installing Visual Web developer 2010 Express (Optional)

Here are some quick steps to get up and running with a download of Visual Web Developer 2010 Express. These screen captures were taken as a courtesy to Silverlight “newbies” who may not currently have access to Visual Studio 2010.
  1. Install Visual Web Developer 2010 Express from http://www.microsoft.com/express/Web/.

     

     

     

  2. Specify (and save) your own SQL Server (Express) credentials.

     

  3. Wait several minutes while the installation proceeds. During this time, the installer may require several computer restarts.

     

  4. Installation is complete.

     

  5. With Visual Web Developer 2010 Express closed, download and install the Microsoft Silverlight 4 Tools for Visual Studio 2010 from http://www.microsoft.com/downloads/en/details.aspx?FamilyID=b3deb194-ca86-4fb6-a716-b67c2604a139&displaylang=en

     

     

     

     

     

  6. With Visual Web Developer 2010 Express closed, download and install the ArcGIS API for Microsoft Silverlight version 2.2 from http://help.arcgis.com/en/webapi/silverlight/index.html and verify the installation of the assemblies
  7. Verify the installation of the ArcGIS API for Silverlight v.2.2 assemblies in the appropriate folder:
    C:\Program Files\ESRI SDKs\Silverlight\v2.2\ESRI.ArcGIS.Client.BAO.dll (32-bit OS) or
    C:\Program Files (x86)\ESRI SDKs\Silverlight\v2.2\ESRI.ArcGIS.Client.BAO.dll (64-bit OS)
  8. You are now ready to proceed with the normal BAO API for Silverlight Installation steps given at the beginning of this document

    NOTE: Be sure the follow the steps to confirm the proper installation of the prerequisites.