Episerver - update 208

A new release of Episerver Find (including breaking changes), Episerver Advance, Episerver Languages, Episerver Connect for Campaign and a new add-on that integrates the Personalization Portal in the Episerver UI. Bug fixes for Episerver CMS UI and Episerver Change Approvals (including a critical bug fix).

The update applies to Episerver projects version 7.5 and higher, and contains finalized work items included in the latest iteration. Continuous release updates are cumulative to include previous updates. Episerver supports all platform updates and strongly recommends that you keep ongoing projects up-to-date. You can install the updates from the Episerver NuGet feed.

Main packages
This release information lists updated main package versions for the Episerver platform. When a release is built, other dependent packages also may be bumped to new versions, although they contain no publicly visible changes. This is done to avoid dependency errors. When you upgrade, NuGet alerts you to upgrade related packages to the required versions. For Commerce, it is important to ensure that you are running the same version of CMS and Commerce, both in the front-end and back-end applications.

Updated main packages

Click a package in the list to see work item details.

Episerver CMS UI

EPiServer.CMS.UI 11.4.2
Episerver.ChangeApprovals 1.0.2 (Supports CMS 10 only.)

Episerver Find

EPiServer.Find 13.0.1. See Jonas Bergqvist's blog post and Upgrading to Find 13 for breaking changes.

Episerver Advance

EPiServer.Tracking.PageView 1.0.0
This package tracks page views and sends data in a predefined format to the Profile tracking instance. The tracked data is the source for the recommendation service.
This package depends on the EPiServer.Profile.Client and EPiServer.Tracking.Core NuGet packages.

1. Install the EPiServer.Tracking.PageView NuGet package from the Episerver NuGet source to your website.

2. Add the PageViewTracking attribute to your controller, and the page is tracked.

[PageViewTracking]
public ActionResult Index(StartPage currentPage)
{}
 
[ValidateInput(false)]
[PageViewTracking]
public ViewResult Index(SearchPage currentPage, string q)
{}]]

EPiServer.Personalization.CMS 1.0.0
This package connects to the Recommendation Service to retrieve recommendations for content. See example code on GitHub.

When you register for the Recommendation Service, Episerver provides an HMAC key pair and service URL. In the web.config file, set the values in the following appSettings keys:

<add key="episerver:RecommendationServiceKey" value="application key" />
<add key="episerver:RecommendationServiceSecret" value="secret key" />
<add key="episerver:RecommendationServiceUri" value="" />

Install the EPiServer.Personalization.CMS NuGet package from the Episerver NuGet source to your website.
Retrieve recommendations for a content:

- Create a recommendation request with the following parameters:

- - siteId: This is the ID of the website that has the content that needs to receive recommendations.
  - contentId: The ContentGuid of the content.
  - languageId: The language of the content.
  - numberOfRecommendations: The number of recommendations that you want to have for the content.
- Retrieve recommendations using the instance of IRecommendationService.
- The recommendation result is a list of RecommendationResult objects.

For example:

      public async Task<ActionResult> Index(SamplePage currentPage)
        {
            var siteId = SiteDefinition.Current.Id.ToString();
            var contentId = currentPage.ContentGuid.ToString();
            var languageId = currentPage.Language.Name;

            var rRequest = new RecommendationRequest
            {
                siteId = siteId,
                context = new Context { contentId = contentId, languageId = languageId },
                numberOfRecommendations = 5 //or another number as needed
            };

            var recommendationService = ServiceLocator.Current.GetInstance<IRecommendationService>();

            var result = await recommendationService.Get(this.HttpContext, rRequest);
            ……
        }

Episerver add-ons

EPiServer.Labs.LanguageManager 3.1.1
EPiServer.ConnectForCampaign 1.1.0 (Support for CMS 11.)
EPiServer.Personalization 1.0.0. See Adding the Personalization Portal to the Episerver user interface.

Important notifications

Update 208 included breaking changes for Episerver Find 13.
Update 189 included breaking changes for Episerver CMS 11.
Update 174 included breaking changes for Episerver Commerce 11.
Update 150 included breaking changes for Episerver Service API 3.
Update 141 included breaking changes for Episerver Languages 3.
Update 134 included breaking changes for Episerver CMS 10, Episerver Commerce 10, and Episerver Forms 4.
For previous notifications, see update 118.