Tag Archives: Sharepoint

Loading JavaScript via CustomAction and Initializing Functions with SharePoint 2013’s Minimal Download Strategy

9 Apr

For any of you who have worked with the new SharePoint 2013 Minimal Download Strategy (MDS) and custom scripts, you have probably run into some of the same headaches as myself.

While “official” documentation on MDS is greatly lacking (surprise, surprise), there are some great articles out there that really helped me build a foundational understanding. However most are focused around the use of custom scripts in conjunction with JSLink and tend to assume all the JavaScript references are embedded in the master page. So if you are in the same boat, check out the my reference section at the bottom as I have listed some of the better articles that are great reads and very helpful.

Scenario

Current project requires implementing multiple host names site collections, each with their own branded custom master page, and include about 20 different core scripts that are needed for various features and functionalities (such as jQuery, Knockout, Bootstrap, Amplify, etc.). Each master page will then load client-side initialization functions for a handful custom features, the most common being a world clock.

Solution v1.0

From a maintenance standpoint, loading my scripts via Custom Actions in a single Site feature is a much better and simpler solution than creating a ScriptLink and listing out each of the 20 core scripts in all the master pages and then having to add/remove them when the project requirements change or additional enhancement phases are started.

Loading JavaScript via CustomActions

Specifically, I need a way that once the page is loaded that I am able to initialize and world clock component that is being shown on the page, which utilizes jQuery, Knockout, and a custom Utility class. To do so I have initialization scripts that are directly tied to each master page via a ScriptLink reference so that I can have a different Custom and System master page for each site and can fire off additional, master page specific initializations that might be needed, which means I can’t use a CustomAction for those scripts.

ScriptLink LoadAfterUI

Wall Ramming

Attempt 1

This concept works great when MDS is disabled or when Publishing is enabled as Publishing negates MDS. However, when using MDS, any time a partial load fires, noted by “/_layouts/15/start.aspx#” displaying in browser address bar, my initialization script is called before the CustomActions have fired to load the core scripts and subsequently errors out.

MDS Undefined Error

After reviewing a lot of different articles, the common thread was to create a non-anonymous function (in my case within a Singleton object) and register it with SharePoint’s RegisterModuleInit() function.

MDS Attempt 1

Note: As you can see above, I do have a delay in place to wait until the body and SP.js is loaded, so I can rely upon _spPageContextInfo to always be populated.

I would like to say that worked, that doesn’t cover everything situation, or rather only works when the MDS partial page load is in play. See also:


Attempt 2

Now that I have my solution partially responding, I wanted to figure out what the trigger was to get it to fully function as expected. Upon diving deeper into Anatoly’s post I saw he ran into a similar quirk and so I attempted to use the $_global_ trick that worked for him. I had some mixed results with this solution. My best guess is it has to do with my utilizing CustomActions to load my core scripts or during testing I didn’t add $_global_ to all my core scripts. Either way, it would have been A LOT of files to modify, including 3rd party scripts as well as providing training to the client on the concept was not ideal. So I figured there had to be another way.

After walking through a lot of trial and error debug sessions, and thanks to insight from Sridhar’s CSR-override on MDS post, the simplest solution I found was to check to see if my core utility object was already loaded and if so call my initialization function directly, otherwise I assume MDS is in effect and I register my function to fire once MDS has completed.

MDS Attempt 2

Resolution

Once I implemented the combination of Attempt 1 and Attempt 2, everything now appears to be functioning as expected. I am not sure if this concept will work when using JSLink, but again, here are some really great resources to reference:

VERY IMPORTANT: One thing I want to make sure to point out that the ScriptLink for the initialization script in the master page must include LoadAfterUI=”True” or it will not initiate correctly. I was reminded of this the hard way when I redeployed one of my master pages without this and my script stopped fired after a partial MDS load.

Final Result is that each and every time my core scripts are being loaded before my initialize initialization script so my world clock which is now displaying on both full and partial loads.

MDS Resolution

Summary

In this post my goal was to get a custom script to initialize after scripts loaded via CustomActions in conjunction with a site using Minimal Download Strategy (MDS). Here are key factors that are required in order to get this working:

  • Initialization script must be referenced in a ScriptLink that has the property of LoadAfterUI set to “True”
  • Initialization script’s primary function must be a named function and not anonymous
  • When calling the named initialization function, you must register it to fire after MDS is completed using the RegisterModuleInit() function


References

Advertisements

SP2013 disables org chart viewer.. but only on YOUR profile page

1 Jul

Put this in the strange but true category.

We received a defect report from a client doing a 2013 migration stating that the org chart viewer wasn’t working. Gave us a link to the page where it wasn’t working. Of course we went to verify the defect, but when we looked the org chart viewer was there.

Thought that was closed, but they insisted it wasn’t there. So assuming it was some sort of training issue, we went to show them where the viewer was and how to get to it. But when we went to see the same page on thier machine.. no Org chart. what?

So we went to a few other peoples profile pages. All of them worked. Just not theirs. Was this some wierd cache issue? Had they customized their page in a way that broke this?

Well with this new information, we went back to look at our own profile page. And turns out when anyone looks at their own profile, they cannot see the org chart viewer. So thinking this must be a bug, we went to go find a bug report from someone else, and hopefully find a fix or work around.

This was the post we found: http://blogs.msdn.com/b/chandru/archive/2013/04/01/sp15-organization-chart-in-mysites.aspx

Granted the date on the post is April Fool’s day, which always makes me suspicious. But concerns aside, it basically indicates, “yeah it does that because we thought turning it off was better than making it perform better”. And we did find another post not on April Fool’s Day, that matches the comments, and even links to that post. (http://social.technet.microsoft.com/forums/sharepoint/en-US/71046c9d-b7f6-4cff-81dd-5edf67bd9e11/sharepoint-2013-issue-with-org-chart-not-visible)

So there you have it, by design, and if you want it, custom event reciever and feature stapling to fix it. (unless I assume you are in office 365, then you are out of luck)

 

Careful when you import that design manager package (part 2)

10 May

After my last post we started looking for more possible content type corruption introduced by Design Manager Export/import process.

it appears to impact other content type besides just “page”. we are seeing corruption in “article page” and “welcome page” as well.

article page is missing:

  • Page content, Summary Links, Byline, Article Date, Image Caption

Welcome page is missing:

  • Page content, Summary Links, Summary Links 2

working on documenting all the content types that are not being exported fully.

Careful when you import that design manager package

8 May

Looking through some issues we were seeing with roll up images not appearing after you check-in and publish a page, and some ULS log message about a column not being defined, it appears that the process of exporting and importing a Design Manger package will corrupt some out of the content types, specifically for pages.

http://social.technet.microsoft.com/Forums/en-US/sharepointcustomization/thread/73c5fb6b-c346-4b7e-bef2-74865d05d1c5

So there is your hot tip for the day.

This is only like one of 4 things for today :/

Want to remove “recent” links from the Left Nav in SharePoint 2013? Good luck with that

2 May

I am working with a new SP2013 install and was noticing the new “recent” link that kept showing up on the left. I had gone through the navigation and deleted it manually,

But it kept showing up.

The implementation is for a pretty tightly managed intranet, so that was not going to work. I was assuming there was a place I could just turn it off. I wasn’t worried about that, but I thought I would do a quick search for how to fix that.

turns out, it is not as straight forward as I would expect. I found this note for this new feature.

http://www.jasperoosterveld.com/2013/02/sharepoint-2013-remove-recent-in-quick.html

The Recent-section gets added automatically through a WebControl on the page. To automatically remove the who section (including child navigation nodes of Recent) you could enable a custom feature, that simply does a .Delete() against the corresponding navigation node in SPWeb.Navigation.QuickLaunch navigation collection. Then just call your custom feature from your provisioning logic, and way Recent -section would always be removed upon provisioning a new site. Alternatively you could use some CSS-styling but that wouldn’t really remove it, but just hide.