/// <summary>
/// Returns a 'sharepointdocumentlocation' that represents the path from an existing 'sharepointsite' to an existing entity.
/// If the document location path does not exist, a relative path of locations is created between the two entities.
/// The folder path structure defined by the site is respected when retrieving or creating the document location path.
/// </summary>
/// <param name="context"></param>
/// <param name="sharePointSite"></param>
/// <param name="entity"></param>
/// <param name="relativeUrl"></param>
/// <returns>
/// The 'sharepointdocumentlocation' referencing the folder of the entity.
/// </returns>
public static T AddOrGetExistingDocumentLocation <T>(this OrganizationServiceContext context, Entity sharePointSite, Entity entity, string relativeUrl)
where T : Entity, new()
{
if (sharePointSite == null)
{
throw new ArgumentNullException("sharePointSite");
}
if (entity == null)
{
throw new ArgumentNullException("entity");
}
sharePointSite.AssertEntityName(_sharepointsite);
// Replace the following invalid characters ~ " # % & * : < > ? / \ { | } . with hyphens (Same as what CRM does).
var spSafeRelativeUrl = Regex.Replace(relativeUrl, @"[\~\""\#\%\&\*\:\<\>\?\/\\\{\|\}\.]", "-");
var siteName = sharePointSite.GetAttributeValue <string>("name");
var locationName = "Documents on {0}".FormatWith(siteName);
var folderStructureEntity = sharePointSite.GetAttributeValue <string>("folderstructureentity");
if (folderStructureEntity == "contact" && entity.LogicalName != "contact")
{
// <site>/contact/<contact name>/<entity name>/<record name>
var related = context.GetRelatedForEntityCentricFolderStructure(entity, folderStructureEntity);
if (related != null)
{
return(context.AddOrGetEntityCentricDocumentLocation <T>(locationName, spSafeRelativeUrl, entity, related, sharePointSite));
}
}
if (folderStructureEntity == "account" && entity.LogicalName != "account")
{
// <site>/account/<account name>/<entity name>/<record name>
var related = context.GetRelatedForEntityCentricFolderStructure(entity, folderStructureEntity);
if (related != null)
{
return(context.AddOrGetEntityCentricDocumentLocation <T>(locationName, spSafeRelativeUrl, entity, related, sharePointSite));
}
}
// <site>/<entity name>/<record name>
var entitySetLocation = sharePointSite
.GetRelatedEntities(context, _sharepointdoclocationsiterelationship)
.FirstOrDefault(loc => loc.GetAttributeValue <string>("relativeurl") == entity.LogicalName);
if (entitySetLocation == null)
{
entitySetLocation = context.CreateDocumentLocation <T>(locationName, entity.LogicalName, sharePointSite, _sharepointdoclocationsiterelationship);
return(context.CreateDocumentLocation <T>(locationName, spSafeRelativeUrl, entitySetLocation, _sharepointdoclocationparentrelationship, entity.ToEntityReference()));
}
return(context.CreateOrUpdateRecordDocumentLocation <T>(locationName, spSafeRelativeUrl, entitySetLocation, entity));
}