smithsson68@gmail.com
Feb 18, 2010
  10909
(2 votes)

Changes to Page Objects API in CMS 6 Release

The upcoming final release of CMS 6 will introduce a couple of small changes in the way you load and save Page Objects compared to the RC1 version.

Following feedback and a few bug fixes we decided that mixing Page Objects with PageData and having to go through the DataFactory to save them was not going to work and was not the cleanest API.

This blogpost explains the RC1 way of doing things. In the rest of this post I will go through how to work with Page Objects in the CMS Release version.

The main class you will be interested in is the EPiServer.Core.PageObjectManager which can be found in the EPiServer.dll assembly. The most likely places you will be working with Page Objects are in a CMS Page Template, a CMS User Control or from Dynamic Content. In all 3 cases the PageData object is available and therefore the PageObjectManager takes a PageData in its constructor (there are other constructers available for other scenarios when PageData is not available). This tells the PageObjectManager to load and save Page Objects in the context of that page.

You can load Page Objects like this:

   1: PageData pageData = // Obtain the PageData instance to work with
   2:  
   3: // Construct a PageObjectManager with the PageData
   4: PageObjectManager pom = new PageObjectManager(pageData);
   5:  
   6: Rating rating = pom.Load<Rating>("Rating");
   7:  
   8: if (rating != null)
   9: {
  10:     // Do something with the rating
  11: }

 

You can also load all Page Objects for the page like this:

   1: PageData pageData = // Obtain the PageData instance to work with
   2:  
   3: // Construct a PageObjectManager with the PageData
   4: PageObjectManager pom = new PageObjectManager(pageData);
   5:  
   6: var objects = pom.LoadAll();
   7:  
   8: // Get the Rating object
   9: Rating rating = objects.ItemAs<Rating>("Rating");
  10:  
  11: if (rating != null)
  12: {
  13:     // Do something with the rating
  14: }

Note that the LoadAll method returns an IDictionary. The ItemAs<> method is an extension method added as part of the Page Objects implementation to obtain the object in a typed way.

Saving a Page Object is also straight forward:

   1: PageData pageData = // Obtain the PageData instance to work with
   2:  
   3: // Construct a PageObjectManager with the PageData
   4: PageObjectManager pom = new PageObjectManager(pageData);
   5:  
   6: Rating rating = pom.Load<Rating>("Rating");
   7:  
   8: // Update the rating or create a new one if null
   9:  
  10: // Save it back
  11: pom.Save("Rating", rating);

There is another overload of Save which takes a OwnerOption. I will go into this in more detail in a later blog post.

What all this means is that if you have already started building sites with CMS 6 RC1 and have used Page Objects you will unfortunately need to make these small codes changes for obtaining and saving Page Objects. If anybody also needs to preserve their Page Object instances between RC1 and the release version then please email me paul smith episerver com and I will provide you will a small script to do this.

Feb 18, 2010

Comments

Sep 21, 2010 10:33 AM

So, are Page Objects orthogonal to versioning of page data now?

Sep 21, 2010 10:33 AM

Well, I'm not totally sure what you mean by orthogonal in context, if you mean independent of each other then the answer is not really.
Page Objects are not versioned as such, there is no magic going on in the background when a page is versioned to copy the Page Objects. When a Page Objects is created it is assigned an OwnerOption with the options being Page, PageLanguageBranch and PageVersion. So you decide how your Page Objects are shared between different versions/languages of a page. I will blog more shortly.
/Paul
/ Paul Smith

Sep 21, 2010 10:33 AM

I like this API a lot better than the previous one. A good change!

Sep 21, 2010 10:33 AM

Will there be a method to get the page data objects based on PageReference instead of pagedata object?

/ Anders Hattestad

Please login to comment.
Latest blogs
PageCriteriaQueryService builder with Blazor and MudBlazor

This might be a stupid idea but my new years resolution was to do / test more stuff so here goes. This razor component allows users to build and...

Per Nergård (MVP) | Feb 10, 2025

Enhancing Optimizely CMS Multi-Site Architecture with Structured Isolation

The main challenge of building an Optimizely CMS website is to think about its multi site capabilities up front. Making adjustment after the fact c...

David Drouin-Prince | Feb 9, 2025 | Syndicated blog

How to: set access right to folders

Today I stumped upon this question Solution for Handling File Upload Permissions in Episerver CMS 12, and there is a simple solution for that Using...

Quan Mai | Feb 7, 2025 | Syndicated blog

Poking around in the new Visual Builder and the SaaS CMS

Early findings from using a SaaS CMS instance and the new Visual Builder grids.

Johan Kronberg | Feb 7, 2025 | Syndicated blog

Be careful with your (order) notes

This happened a quite ago but only now I have had time to write about it. Once upon a time, I was asked to look into a customer database (in a big...

Quan Mai | Feb 5, 2025 | Syndicated blog

Imagevault download picker

This open source extension enables you to download images as ImageData with ContentReference from the ImageVault picker. It serves as an alternativ...

Luc Gosso (MVP) | Feb 4, 2025 | Syndicated blog