Crosslight 4 is a major improvement over the previous version and provides many new features in data-related framework such as better and faster entity relationship management, view projection, and advanced query descriptor. These major improvements will be enabled directly when you create a new project using Crosslight Project Wizard and latest Crosslight 4 development tools. For existing projects, you will need to follow this simple guide to enjoy the new features.
Updating Code Generated Model
First of all, you need to update the code generated model using the latest code generation tools. To do this, simply open the EDMX file that you would like to update and re-save the file. This will trigger the code generation tools to regenerate the code generated model.
The new code generated model will have a new class called EntityRelations and you'll see that the Version property is now set to V2.
Updating Server Assemblies
Crosslight 4 introduces a new server assembly called Intersoft.Data.WebApi.v4. The use of this assembly requires newer version of WebApi.OData, so you will need to update the NuGet package in your WebAPI project as follows.
On Visual Studio 2015, this might look slightly different.
Also, you will need to update ASP.NET WebAPI assemblies as well.
These nuget packages will update the WebApi.OData related assemblies and configurations automatically. In particular, the web.config file will be automatically updated to have the following entries.
Finally, remember to change the Intersoft.Data.WebApi reference to Intersoft.Data.WebApi.v4.
For more information about general upgrade process such as applying the client assemblies to your project, see Updating Crosslight.