public ActionResult Branding(BrandingViewModel model)
{
AntiForgery.Validate();
if (ModelState.IsValid)
{
// Get the original branding settings
BrandingSettings original = PnPPartnerPackUtilities.GetTenantBrandingSettings();
// If something changed in the branding settings compared with previous settings
if (model.LogoImageUrl != original.LogoImageUrl ||
model.BackgroundImageUrl != original.BackgroundImageUrl ||
model.ColorFileUrl != original.ColorFileUrl ||
model.FontFileUrl != original.FontFileUrl ||
model.CSSOverrideUrl != original.CSSOverrideUrl ||
model.UICustomActionsUrl != original.UICustomActionsUrl)
{
var newBrandingSettings = new BrandingSettings {
LogoImageUrl = model.LogoImageUrl,
BackgroundImageUrl = model.BackgroundImageUrl,
ColorFileUrl = model.ColorFileUrl,
FontFileUrl = model.FontFileUrl,
CSSOverrideUrl = model.CSSOverrideUrl,
UICustomActionsUrl = model.UICustomActionsUrl,
UpdatedOn = DateTime.Now,
};
// Update the last date and time of update
model.UpdatedOn = newBrandingSettings.UpdatedOn;
// Get the JSON representation of the settings
var jsonBranding = JsonConvert.SerializeObject(newBrandingSettings);
// Store the new tenant-wide settings in the Infrastructural Site Collection
PnPPartnerPackUtilities.SetPropertyBagValueToInfrastructure(
PnPPartnerPackConstants.PropertyBag_Branding, jsonBranding);
}
if (model.RollOut)
{
// Create the asynchronous job
var job = new BrandingJob
{
Owner = ClaimsPrincipal.Current.Identity.Name,
Title = "Tenant Wide Branding",
};
// Enqueue the job for execution
model.JobId = ProvisioningRepositoryFactory.Current.EnqueueProvisioningJob(job);
}
}
return(View(model));
}
public ActionResult Branding()
{
BrandingSettings original = PnPPartnerPackUtilities.GetTenantBrandingSettings();
BrandingViewModel model = new BrandingViewModel {
LogoImageUrl = original.LogoImageUrl,
BackgroundImageUrl = original.BackgroundImageUrl,
ColorFileUrl = original.ColorFileUrl,
FontFileUrl = original.FontFileUrl,
CSSOverrideUrl = original.CSSOverrideUrl,
UICustomActionsUrl = original.UICustomActionsUrl,
};
return(View(model));
}
private void ApplyBranding(BrandingJob job)
{
// Use the infrastructural site collection to temporary store the template with color palette and font files
using (var repositoryContext = PnPPartnerPackContextProvider.GetAppOnlyClientContext(
PnPPartnerPackSettings.InfrastructureSiteUrl))
{
var brandingSettings = PnPPartnerPackUtilities.GetTenantBrandingSettings();
ProvisioningTemplate template = PrepareBrandingTemplate(repositoryContext, brandingSettings);
// For each Site Collection in the tenant
using (var adminContext = PnPPartnerPackContextProvider.GetAppOnlyTenantLevelClientContext())
{
var tenant = new Tenant(adminContext);
var siteCollections = tenant.GetSiteProperties(0, true);
adminContext.Load(siteCollections);
adminContext.ExecuteQueryRetry();
foreach (var site in siteCollections)
{
if (!site.Url.ToLower().Contains("/portals/") &&
!site.Url.ToLower().Contains("-public.sharepoint.com") &&
!site.Url.ToLower().Contains("-my.sharepoint.com"))
{
// Clean-up the template
template.WebSettings.MasterPageUrl = null;
using (var siteContext = PnPPartnerPackContextProvider.GetAppOnlyClientContext(site.Url))
{
// Get a reference to the target web
var targetWeb = siteContext.Site.RootWeb;
// Update the root web of the site collection
ApplyBrandingOnWeb(targetWeb, brandingSettings, template);
}
}
}
}
}
}
private void CreateSiteCollection(SiteCollectionProvisioningJob job)
{
Console.WriteLine("Creating Site Collection \"{0}\".", job.RelativeUrl);
// Define the full Site Collection URL
String siteUrl = String.Format("{0}{1}",
PnPPartnerPackSettings.InfrastructureSiteUrl.Substring(0, PnPPartnerPackSettings.InfrastructureSiteUrl.IndexOf("sharepoint.com/") + 14),
job.RelativeUrl);
// Load the template from the source Templates Provider
if (!String.IsNullOrEmpty(job.TemplatesProviderTypeName))
{
ProvisioningTemplate template = null;
var templatesProvider = PnPPartnerPackSettings.TemplatesProviders[job.TemplatesProviderTypeName];
if (templatesProvider != null)
{
template = templatesProvider.GetProvisioningTemplate(job.ProvisioningTemplateUrl);
}
if (template != null)
{
using (var adminContext = PnPPartnerPackContextProvider.GetAppOnlyTenantLevelClientContext())
{
adminContext.RequestTimeout = Timeout.Infinite;
// Configure the Site Collection properties
SiteEntity newSite = new SiteEntity();
newSite.Description = job.Description;
newSite.Lcid = (uint)job.Language;
newSite.Title = job.SiteTitle;
newSite.Url = siteUrl;
newSite.SiteOwnerLogin = job.PrimarySiteCollectionAdmin;
newSite.StorageMaximumLevel = job.StorageMaximumLevel;
newSite.StorageWarningLevel = job.StorageWarningLevel;
// Use the BaseSiteTemplate of the template, if any, otherwise
// fallback to the pre-configured site template (i.e. STS#0)
newSite.Template = !String.IsNullOrEmpty(template.BaseSiteTemplate) ?
template.BaseSiteTemplate :
PnPPartnerPackSettings.DefaultSiteTemplate;
newSite.TimeZoneId = job.TimeZone;
newSite.UserCodeMaximumLevel = job.UserCodeMaximumLevel;
newSite.UserCodeWarningLevel = job.UserCodeWarningLevel;
// Create the Site Collection and wait for its creation (we're asynchronous)
var tenant = new Tenant(adminContext);
tenant.CreateSiteCollection(newSite, true, true); // TODO: Do we want to empty Recycle Bin?
Site site = tenant.GetSiteByUrl(siteUrl);
Web web = site.RootWeb;
adminContext.Load(site, s => s.Url);
adminContext.Load(web, w => w.Url);
adminContext.ExecuteQueryRetry();
// Enable Secondary Site Collection Administrator
if (!String.IsNullOrEmpty(job.SecondarySiteCollectionAdmin))
{
Microsoft.SharePoint.Client.User secondaryOwner = web.EnsureUser(job.SecondarySiteCollectionAdmin);
secondaryOwner.IsSiteAdmin = true;
secondaryOwner.Update();
web.SiteUsers.AddUser(secondaryOwner);
adminContext.ExecuteQueryRetry();
}
Console.WriteLine("Site \"{0}\" created.", site.Url);
// Check if external sharing has to be enabled
if (job.ExternalSharingEnabled)
{
EnableExternalSharing(tenant, site);
// Enable External Sharing
Console.WriteLine("Enabled External Sharing for site \"{0}\".",
site.Url);
}
}
// Move to the context of the created Site Collection
using (ClientContext clientContext = PnPPartnerPackContextProvider.GetAppOnlyClientContext(siteUrl))
{
clientContext.RequestTimeout = Timeout.Infinite;
Site site = clientContext.Site;
Web web = site.RootWeb;
clientContext.Load(site, s => s.Url);
clientContext.Load(web, w => w.Url);
clientContext.ExecuteQueryRetry();
// Check if we need to enable PnP Partner Pack overrides
if (job.PartnerPackExtensionsEnabled)
{
// Enable Responsive Design
PnPPartnerPackUtilities.EnablePartnerPackOnSite(site.Url);
Console.WriteLine("Enabled PnP Partner Pack Overrides on site \"{0}\".",
site.Url);
}
// Check if the site has to be responsive
if (job.ResponsiveDesignEnabled)
{
// Enable Responsive Design
PnPPartnerPackUtilities.EnableResponsiveDesignOnSite(site.Url);
Console.WriteLine("Enabled Responsive Design Template to site \"{0}\".",
site.Url);
}
// Apply the Provisioning Template
Console.WriteLine("Applying Provisioning Template \"{0}\" to site.",
job.ProvisioningTemplateUrl);
// We do intentionally remove taxonomies, which are not supported
// in the AppOnly Authorization model
// For further details, see the PnP Partner Pack documentation
ProvisioningTemplateApplyingInformation ptai =
new ProvisioningTemplateApplyingInformation();
// Write provisioning steps on console log
ptai.MessagesDelegate += delegate(string message, ProvisioningMessageType messageType)
{
Console.WriteLine("{0} - {1}", messageType, messageType);
};
ptai.ProgressDelegate += delegate(string message, int step, int total)
{
Console.WriteLine("{0:00}/{1:00} - {2}", step, total, message);
};
// Exclude handlers not supported in App-Only
ptai.HandlersToProcess ^=
OfficeDevPnP.Core.Framework.Provisioning.Model.Handlers.TermGroups;
ptai.HandlersToProcess ^=
OfficeDevPnP.Core.Framework.Provisioning.Model.Handlers.SearchSettings;
// Configure template parameters
if (job.TemplateParameters != null)
{
foreach (var key in job.TemplateParameters.Keys)
{
if (job.TemplateParameters.ContainsKey(key))
{
template.Parameters[key] = job.TemplateParameters[key];
}
}
}
// Fixup Title and Description
if (template.WebSettings != null)
{
template.WebSettings.Title = job.SiteTitle;
template.WebSettings.Description = job.Description;
}
// Apply the template to the target site
web.ApplyProvisioningTemplate(template, ptai);
// Save the template information in the target site
var info = new SiteTemplateInfo()
{
TemplateProviderType = job.TemplatesProviderTypeName,
TemplateUri = job.ProvisioningTemplateUrl,
TemplateParameters = template.Parameters,
AppliedOn = DateTime.Now,
};
var jsonInfo = JsonConvert.SerializeObject(info);
web.SetPropertyBagValue(PnPPartnerPackConstants.PropertyBag_TemplateInfo, jsonInfo);
// Set site policy template
if (!String.IsNullOrEmpty(job.SitePolicy))
{
web.ApplySitePolicy(job.SitePolicy);
}
// Apply Tenant Branding, if requested
if (job.ApplyTenantBranding)
{
var brandingSettings = PnPPartnerPackUtilities.GetTenantBrandingSettings();
using (var repositoryContext = PnPPartnerPackContextProvider.GetAppOnlyClientContext(
PnPPartnerPackSettings.InfrastructureSiteUrl))
{
var brandingTemplate = BrandingJobHandler.PrepareBrandingTemplate(repositoryContext, brandingSettings);
// Fixup Title and Description
if (brandingTemplate != null)
{
if (brandingTemplate.WebSettings != null)
{
brandingTemplate.WebSettings.Title = job.SiteTitle;
brandingTemplate.WebSettings.Description = job.Description;
}
// TO-DO: Need to handle exception here as there are multiple webs inside this where
BrandingJobHandler.ApplyBrandingOnWeb(web, brandingSettings, brandingTemplate);
}
}
}
Console.WriteLine("Applied Provisioning Template \"{0}\" to site.",
job.ProvisioningTemplateUrl);
}
}
}
}
private void CreateSubSite(SubSiteProvisioningJob job)
{
// Determine the reference URLs and relative paths
String subSiteUrl = job.RelativeUrl;
String siteCollectionUrl = PnPPartnerPackUtilities.GetSiteCollectionRootUrl(job.ParentSiteUrl);
String parentSiteUrl = job.ParentSiteUrl;
Console.WriteLine("Creating Site \"{0}\" as child Site of \"{1}\".", subSiteUrl, parentSiteUrl);
using (ClientContext context = PnPPartnerPackContextProvider.GetAppOnlyClientContext(parentSiteUrl))
{
context.RequestTimeout = Timeout.Infinite;
// Get a reference to the parent Web
Web parentWeb = context.Web;
// Load the template from the source Templates Provider
if (!String.IsNullOrEmpty(job.TemplatesProviderTypeName))
{
ProvisioningTemplate template = null;
var templatesProvider = PnPPartnerPackSettings.TemplatesProviders[job.TemplatesProviderTypeName];
if (templatesProvider != null)
{
template = templatesProvider.GetProvisioningTemplate(job.ProvisioningTemplateUrl);
}
if (template != null)
{
// Create the new sub site as a new child Web
WebCreationInformation newWeb = new WebCreationInformation();
newWeb.Description = job.Description;
newWeb.Language = job.Language;
newWeb.Title = job.SiteTitle;
newWeb.Url = subSiteUrl;
newWeb.UseSamePermissionsAsParentSite = job.InheritPermissions;
// Use the BaseSiteTemplate of the template, if any, otherwise
// fallback to the pre-configured site template (i.e. STS#0)
newWeb.WebTemplate = !String.IsNullOrEmpty(template.BaseSiteTemplate) ?
template.BaseSiteTemplate :
PnPPartnerPackSettings.DefaultSiteTemplate;
Web web = parentWeb.Webs.Add(newWeb);
context.ExecuteQueryRetry();
Console.WriteLine("Site \"{0}\" created.", subSiteUrl);
// Apply the Provisioning Template
Console.WriteLine("Applying Provisioning Template \"{0}\" to site.",
job.ProvisioningTemplateUrl);
// We do intentionally remove taxonomies, which are not supported in the AppOnly Authorization model
// For further details, see the PnP Partner Pack documentation
ProvisioningTemplateApplyingInformation ptai =
new ProvisioningTemplateApplyingInformation();
// Write provisioning steps on console log
ptai.MessagesDelegate += delegate(string message, ProvisioningMessageType messageType) {
Console.WriteLine("{0} - {1}", messageType, messageType);
};
ptai.ProgressDelegate += delegate(string message, int step, int total) {
Console.WriteLine("{0:00}/{1:00} - {2}", step, total, message);
};
// Exclude handlers not supported in App-Only
ptai.HandlersToProcess ^=
OfficeDevPnP.Core.Framework.Provisioning.Model.Handlers.TermGroups;
ptai.HandlersToProcess ^=
OfficeDevPnP.Core.Framework.Provisioning.Model.Handlers.SearchSettings;
// Configure template parameters
foreach (var key in template.Parameters.Keys)
{
if (job.TemplateParameters.ContainsKey(key))
{
template.Parameters[key] = job.TemplateParameters[key];
}
}
// Fixup Title and Description
template.WebSettings.Title = job.SiteTitle;
template.WebSettings.Description = job.Description;
// Apply the template to the target site
web.ApplyProvisioningTemplate(template, ptai);
// Save the template information in the target site
var info = new SiteTemplateInfo()
{
TemplateProviderType = job.TemplatesProviderTypeName,
TemplateUri = job.ProvisioningTemplateUrl,
TemplateParameters = template.Parameters,
AppliedOn = DateTime.Now,
};
var jsonInfo = JsonConvert.SerializeObject(info);
web.SetPropertyBagValue(PnPPartnerPackConstants.PropertyBag_TemplateInfo, jsonInfo);
// Set site policy template
if (!String.IsNullOrEmpty(job.SitePolicy))
{
web.ApplySitePolicy(job.SitePolicy);
}
// Apply Tenant Branding, if requested
if (job.ApplyTenantBranding)
{
var brandingSettings = PnPPartnerPackUtilities.GetTenantBrandingSettings();
using (var repositoryContext = PnPPartnerPackContextProvider.GetAppOnlyClientContext(
PnPPartnerPackSettings.InfrastructureSiteUrl))
{
var brandingTemplate = BrandingJobHandler.PrepareBrandingTemplate(repositoryContext, brandingSettings);
// Fixup Title and Description
brandingTemplate.WebSettings.Title = job.SiteTitle;
brandingTemplate.WebSettings.Description = job.Description;
BrandingJobHandler.ApplyBrandingOnWeb(web, brandingSettings, brandingTemplate);
}
}
Console.WriteLine("Applyed Provisioning Template \"{0}\" to site.",
job.ProvisioningTemplateUrl);
}
}
}
}
private void CreateSubSite(SubSiteProvisioningJob job)
{
// Determine the reference URLs and relative paths
String subSiteUrl = job.RelativeUrl;
String siteCollectionUrl = PnPPartnerPackUtilities.GetSiteCollectionRootUrl(job.ParentSiteUrl);
String parentSiteUrl = job.ParentSiteUrl;
Console.WriteLine("Creating Site \"{0}\" as child Site of \"{1}\".", subSiteUrl, parentSiteUrl);
using (ClientContext context = PnPPartnerPackContextProvider.GetAppOnlyClientContext(parentSiteUrl))
{
context.RequestTimeout = Timeout.Infinite;
// Get a reference to the parent Web
Web parentWeb = context.Web;
// Load the template from the source Templates Provider
if (!String.IsNullOrEmpty(job.TemplatesProviderTypeName))
{
ProvisioningTemplate template = null;
var templatesProvider = PnPPartnerPackSettings.TemplatesProviders[job.TemplatesProviderTypeName];
if (templatesProvider != null)
{
template = templatesProvider.GetProvisioningTemplate(job.ProvisioningTemplateUrl);
}
if (template != null)
{
// Create the new sub site as a new child Web
WebCreationInformation newWeb = new WebCreationInformation();
newWeb.Description = job.Description;
newWeb.Language = job.Language;
newWeb.Title = job.SiteTitle;
newWeb.Url = subSiteUrl;
newWeb.UseSamePermissionsAsParentSite = job.InheritPermissions;
// Use the BaseSiteTemplate of the template, if any, otherwise
// fallback to the pre-configured site template (i.e. STS#0)
newWeb.WebTemplate = !String.IsNullOrEmpty(template.BaseSiteTemplate) ?
template.BaseSiteTemplate :
PnPPartnerPackSettings.DefaultSiteTemplate;
Web web = parentWeb.Webs.Add(newWeb);
context.ExecuteQueryRetry();
if (template.ExtensibilityHandlers.Any())
{
// Clone Context pointing to Sub Site (needed for calling custom Extensibility Providers from the pnp template passing the right ClientContext)
string newWeburl = web.EnsureProperty(w => w.Url);
ClientContext webClientContext = context.Clone(newWeburl);
web = webClientContext.Web;
}
// Create sub-web unique groups
if (!job.InheritPermissions)
{
web.CreateDefaultAssociatedGroups(string.Empty, string.Empty, string.Empty);
context.ExecuteQueryRetry();
}
Console.WriteLine("Site \"{0}\" created.", subSiteUrl);
// Apply the Provisioning Template
Console.WriteLine("Applying Provisioning Template \"{0}\" to site.",
job.ProvisioningTemplateUrl);
// We do intentionally remove taxonomies, which are not supported in the AppOnly Authorization model
// For further details, see the PnP Partner Pack documentation
ProvisioningTemplateApplyingInformation ptai =
new ProvisioningTemplateApplyingInformation();
// Write provisioning steps on console log
ptai.MessagesDelegate = (message, type) =>
{
switch (type)
{
case ProvisioningMessageType.Warning:
{
Console.WriteLine("{0} - {1}", type, message);
break;
}
case ProvisioningMessageType.Progress:
{
var activity = message;
if (message.IndexOf("|") > -1)
{
var messageSplitted = message.Split('|');
if (messageSplitted.Length == 4)
{
var status = messageSplitted[0];
var statusDescription = messageSplitted[1];
var current = double.Parse(messageSplitted[2]);
var total = double.Parse(messageSplitted[3]);
var percentage = Convert.ToInt32((100 / total) * current);
Console.WriteLine("{0} - {1} - {2}", percentage, status, statusDescription);
}
else
{
Console.WriteLine(activity);
}
}
else
{
Console.WriteLine(activity);
}
break;
}
case ProvisioningMessageType.Completed:
{
Console.WriteLine(type);
break;
}
}
};
ptai.ProgressDelegate = (message, step, total) =>
{
var percentage = Convert.ToInt32((100 / Convert.ToDouble(total)) * Convert.ToDouble(step));
Console.WriteLine("{0:00}/{1:00} - {2} - {3}", step, total, percentage, message);
};
// Exclude handlers not supported in App-Only
ptai.HandlersToProcess ^=
OfficeDevPnP.Core.Framework.Provisioning.Model.Handlers.TermGroups;
ptai.HandlersToProcess ^=
OfficeDevPnP.Core.Framework.Provisioning.Model.Handlers.SearchSettings;
// Configure template parameters
foreach (var key in template.Parameters.Keys)
{
if (job.TemplateParameters.ContainsKey(key))
{
template.Parameters[key] = job.TemplateParameters[key];
}
}
// Fixup Title and Description
if (template.WebSettings != null)
{
template.WebSettings.Title = job.SiteTitle;
template.WebSettings.Description = job.Description;
}
// Replace existing structural navigation on target site
if (template.Navigation != null &&
template.Navigation.CurrentNavigation != null &&
template.Navigation.CurrentNavigation.StructuralNavigation != null &&
(template.Navigation.CurrentNavigation.NavigationType == CurrentNavigationType.Structural ||
template.Navigation.CurrentNavigation.NavigationType == CurrentNavigationType.StructuralLocal))
{
template.Navigation.CurrentNavigation.StructuralNavigation.RemoveExistingNodes = true;
}
// Replace existing Structural Global Navigation on target site
if (template.Navigation != null &&
template.Navigation.GlobalNavigation != null &&
template.Navigation.GlobalNavigation.StructuralNavigation != null &&
template.Navigation.GlobalNavigation.NavigationType == GlobalNavigationType.Structural)
{
template.Navigation.GlobalNavigation.StructuralNavigation.RemoveExistingNodes = true;
}
// Apply the template to the target site
web.ApplyProvisioningTemplate(template, ptai);
// Save the template information in the target site
var info = new SiteTemplateInfo()
{
TemplateProviderType = job.TemplatesProviderTypeName,
TemplateUri = job.ProvisioningTemplateUrl,
TemplateParameters = template.Parameters,
AppliedOn = DateTime.Now,
};
var jsonInfo = JsonConvert.SerializeObject(info);
web.SetPropertyBagValue(PnPPartnerPackConstants.PropertyBag_TemplateInfo, jsonInfo);
// Set site policy template
if (!String.IsNullOrEmpty(job.SitePolicy))
{
web.ApplySitePolicy(job.SitePolicy);
}
// Apply Tenant Branding, if requested
if (job.ApplyTenantBranding)
{
var brandingSettings = PnPPartnerPackUtilities.GetTenantBrandingSettings();
using (var repositoryContext = PnPPartnerPackContextProvider.GetAppOnlyClientContext(
PnPPartnerPackSettings.InfrastructureSiteUrl))
{
var brandingTemplate = BrandingJobHandler.PrepareBrandingTemplate(repositoryContext, brandingSettings);
BrandingJobHandler.ApplyBrandingOnWeb(web, brandingSettings, brandingTemplate);
// Fixup Title and Description
if (brandingTemplate != null)
{
if (brandingTemplate.WebSettings != null)
{
brandingTemplate.WebSettings.Title = job.SiteTitle;
brandingTemplate.WebSettings.Description = job.Description;
}
// TO-DO: Need to handle exception here as there are multiple webs inside this where
BrandingJobHandler.ApplyBrandingOnWeb(web, brandingSettings, brandingTemplate);
}
}
}
Console.WriteLine("Applied Provisioning Template \"{0}\" to site.",
job.ProvisioningTemplateUrl);
}
}
}
}