Select a site
Loading...

IMPORTANT: This version of Sitefinity CMS is out of support and the respective product documentation is no longer maintained and can be outdated. Use the version selector to view a supported product version.

Example: Create item relations

Sitefinity CMS provides you with an API to work with Related data. RelatedDataExtensions method is implemented to facilitate your work with Related data. The method is located in the Telerik.Sitefinity.RelatedData namespace.

The following code sample demonstrates how you can create item relations:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using Telerik.Sitefinity;
using Telerik.Sitefinity.Data;
using Telerik.Sitefinity.DynamicModules;
using Telerik.Sitefinity.DynamicModules.Model;
using Telerik.Sitefinity.GenericContent.Model;
using Telerik.Sitefinity.Modules.News;
using Telerik.Sitefinity.Utilities.TypeConverters;
using Telerik.Sitefinity.Versioning;
using Telerik.Sitefinity.Model;
using Telerik.Sitefinity.Security;
using Telerik.Sitefinity.News.Model;
using Telerik.Sitefinity.Workflow;
using System.Text.RegularExpressions;
using Telerik.Sitefinity.RelatedData;
namespace SitefinityWebApp
{
public class CreateRelatedDataItemRelation
{
public void CreateItemRelation()
{
NewsManager newsManager = NewsManager.GetManager();
//create some sample items first, to eb able to relate them through code later
var speaker = this.CreateSpeaker();
var newsItem = this.CreateNewsItem(newsManager, Guid.NewGuid(), "MyNewsItem1", "SampleNewsContent");
// create a relation between the news item and the speaker item. The news item should have a relatedData field of type DynamicContent (pointing to the Speakers module) called "speakers"
// the relation will be available only for the current item state (Master)
newsItem.CreateRelation(speaker, "speakers");
newsManager.SaveChanges();
// on publish, all item's relations are copied from Master to Live state.
newsManager.Lifecycle.Publish(newsItem);
newsManager.SaveChanges();
}
public DynamicContent CreateSpeaker()
{
// Set the provider name for the DynamicModuleManager here. All available providers are listed in
// Administration -> Settings -> Advanced -> DynamicModules -> Providers
var providerName = String.Empty;
// Set a transaction name and get the version manager
var transactionName = "someTransactionName";
var versionManager = VersionManager.GetManager(null, transactionName);
DynamicModuleManager dynamicModuleManager = DynamicModuleManager.GetManager(providerName, transactionName);
Type speakerType = TypeResolutionService.ResolveType("Telerik.Sitefinity.DynamicTypes.Model.Speakers.Speaker");
DynamicContent speakerItem = dynamicModuleManager.CreateDataItem(speakerType);
// This is how values for the properties are set
speakerItem.SetValue("Title", "Some Title");
speakerItem.SetString("UrlName", "SomeUrlName");
speakerItem.SetValue("Owner", SecurityManager.GetCurrentUserId());
speakerItem.SetValue("PublicationDate", DateTime.UtcNow);
speakerItem.SetWorkflowStatus(dynamicModuleManager.Provider.ApplicationName, "Draft");
// Create a version and commit the transaction in order changes to be persisted to data store
versionManager.CreateVersion(speakerItem, false);
TransactionManager.CommitTransaction(transactionName);
return speakerItem;
}
public NewsItem CreateNewsItem(NewsManager newsManager, Guid masterNewsId, string newsTitle, string newsContent)
{
//The news item is created as a master. The newsId is assigned to the master.
var newsItem = newsManager.CreateNewsItem(masterNewsId);
//Set the properties of the news item.
newsItem.Title = newsTitle;
newsItem.Content = newsContent;
newsItem.DateCreated = DateTime.UtcNow;
newsItem.PublicationDate = DateTime.UtcNow;
newsItem.LastModified = DateTime.UtcNow;
newsItem.UrlName = Regex.Replace(newsTitle.ToLower(), @"[^\w\-\!\$\'\(\)\=\@\d_]+", "-");
//Recompiles and validates the url of the news item.
newsManager.RecompileAndValidateUrls(newsItem);
//Save the changes.
newsManager.SaveChanges();
//Publish the news item. The published version acquires new ID.
var bag = new Dictionary<string, string>();
bag.Add("ContentType", typeof(NewsItem).FullName);
WorkflowManager.MessageWorkflow(masterNewsId, typeof(NewsItem), null, "Publish", false, bag);
return newsItem;
}
}
}
view raw CreateRelatedDataItemRelation.cs hosted with ❤ by GitHub

Back To Top

Next: Example: Manage item relations