{"id":1445,"date":"2011-05-04T19:41:23","date_gmt":"2011-05-04T19:41:23","guid":{"rendered":"https:\/\/www.wapshere.com\/missmiis\/?p=1445"},"modified":"2017-01-22T23:31:31","modified_gmt":"2017-01-22T23:31:31","slug":"adding-custom-aspx-pages-to-the-fim-portal","status":"publish","type":"post","link":"https:\/\/www.wapshere.com\/missmiis\/adding-custom-aspx-pages-to-the-fim-portal","title":{"rendered":"Naughty but nice: adding custom ASPX pages to the FIM Portal"},"content":{"rendered":"

At TEC I sat through a combined Microsoft-Quest-OCG talk which had something to do with an integration between Quest ARS and the FIM Portal. At least I think that’s what it was – I’m afraid the talk was rather disorganised and I was left completely unsure about what they actually had done – but the one bit that did make me sit up and take notice was when they showed a FIM Portal page with a Quest page nicely framed inside it. I thought “I need to figure out how to do that!”
\n<\/p>\n

Integrating another site into the Portal<\/h3>\n

You can add external links to the FIM Portal. You create a Navigation Bar Resource or a Home Page Resource with the link, however when someone clicks the link they will leave the FIM Portal. How much nicer to have it work like this:<\/p>\n

\"\"<\/a><\/p>\n

So you know this is unsupported, right?<\/h3>\n

I believe so. To achieve this you have to add aspx pages to the FIM site. Actually I haven’t seen anywhere in the documentation that explicity says “not allowed”, but whenever someone has asked how to do this on the forum the reponse has been “can’t be done” and “not supported”.<\/p>\n

So while I’m going to show you how I did it, I can’t say at this point how the modifications will be affected by a FIM upgrade. It may be you have to re-add the pages again – we’ll see.<\/p>\n

But if you still want to know how I did it…<\/h3>\n

Here’s how I got it to work – but you should know that I’ve come at this from a point of complete Sharepoint ignorance, and I have no idea how Quest\/OCG got their demo working. After trying to hack some files myself, then wasting time researching “feature stapling” which proved to be no help, I got some advice from a Sharepoint-savvy collegue who suggested this general approach.<\/p>\n

Pre-reqs<\/h3>\n

The only pre-requisite here is that you’ll have to download and install Sharepoint Designer 2007<\/a>. I installed it on my dev FIM server and was able to modify both the dev and prod servers from there.<\/p>\n

Create a Document Library<\/h3>\n

The first time, you must create a document library to store your aspx files.<\/p>\n\n\n\n\n\n\n
Logon to the FIM Portal as an account with Sharepoint Administration permissions.
\nIn the top-right corner, click Site Actions <\/strong>and then Site Settings<\/strong>.<\/p>\n

Note if you don’t see “Site Actions” then you don’t have the appropriate Sharepoint permissions.<\/td>\n

\"\"<\/td>\n<\/tr>\n
Under Site Actions<\/strong> click Create<\/strong> and choose “Web Part Page”.<\/td>\n\"\"<\/a><\/td>\n<\/tr>\n
At the bottom of the next form you should see that Document Library is “None Available”. Click the Document Library<\/strong> link to create one.<\/td>\n\"\"<\/a><\/td>\n<\/tr>\n
Give the library a name and description.<\/td>\n\"\"<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Create the page<\/h3>\n

Create a new webpart page:<\/p>\n\n\n\n\n
Go back to the Site Actions -> Create<\/strong> page and again click “Web Part Page”.<\/td>\n\"\"<\/a><\/td>\n<\/tr>\n
Give the page a suitable name.<\/p>\n

It doesn’t matter what layout we pick as we’re actually going to over-write all the aspx it generates.
\nSave it to your new library.<\/p>\n

The page will come up in edit mode. Just click Exit Edit Mode<\/strong> to close it.<\/td>\n

\"\"<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Hack the ASPX<\/h3>\n

Now we’re going to replace the default aspx with new content that simply opens our external site in an iframe.<\/p>\n\n\n\n\n\n
Open Sharepoint Designer 2007. Click File -> Open Site<\/strong> and then enter the URL of your FIM Portal.<\/td>\n\"\"<\/a><\/td>\n<\/tr>\n
If all has worked so far you should see your Document Library, and inside you will find your new ASPX file.
\nCheck the file out then open it as Text.<\/td>\n		\"\"<\/a><\/td>\n<\/tr>\n
Replace the contents of the aspx file (see code below) then save and check back in the file.<\/p>\n

You should now be able to browse your new page at http:\/\/fimserver\/IdentityManagement\/MyASPX\/MyLink.aspx<\/p>\n

Note that I always see this error the first time I access the page, and then it goes away. Not sure if I should be worried or not!<\/td>\n

\"\"<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Here’s the aspx content. Just change the link to the one you actually want – possibly not the Dr Who page…<\/p>\n

<%@ Page masterpagefile=\"~masterurl\/custom.master\" language=\"C#\" inherits=\"Microsoft.SharePoint.WebPartPages.WebPartPage, Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c\" meta:progid=\"SharePoint.WebPartPage.Document\" UICulture=\"auto\" Culture=\"auto\" %>
\n<%@ Register Tagprefix=\"SharePoint\" Namespace=\"Microsoft.SharePoint.WebControls\" Assembly=\"Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c\" %> <%@ Register Tagprefix=\"Utilities\" Namespace=\"Microsoft.SharePoint.Utilities\" Assembly=\"Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c\" %> <%@ Import Namespace=\"Microsoft.SharePoint\" %> <%@ Register Tagprefix=\"WebPartPages\" Namespace=\"Microsoft.SharePoint.WebPartPages\" Assembly=\"Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c\" %><\/p>\n

<asp:Content ContentPlaceHolderID=\"PlaceHolderTitleBar\" runat=\"server\">
\n<\/asp:Content><\/p>\n

<asp:Content id=\"content1\" ContentPlaceHolderID=\"PlaceHolderMain\" runat=\"server\">
\n <iframe runat=\"server\" id=\"reportIFrame\" class=\"style1\" frameborder=\"0\" scrolling=\"yes\" style=\"border-style: none; border-color: inherit; border-width: 0px; overflow: auto; width: 1100px; height: 800px\" src=\"http:\/\/www.bbc.co.uk\/doctorwho\/dw\">
\n <\/iframe>
\n<\/asp:Content><\/code><\/p>\n

Finally – make the new page available<\/h3>\n

I’m not going to go into details about how to do this here, but you need to look at Home Page Resources and\/or Navigation Bar Resources.<\/p>\n","protected":false},"excerpt":{"rendered":"

At TEC I sat through a combined Microsoft-Quest-OCG talk which had something to do with an integration between Quest ARS and the FIM Portal. At least I think that’s what it was – I’m afraid the talk was rather disorganised and I was left completely unsure about what they actually had done – but the…<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"footnotes":"","jetpack_publicize_message":"","jetpack_is_tweetstorm":false,"jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":[]},"categories":[42,21],"tags":[],"class_list":["post-1445","post","type-post","status-publish","format-standard","hentry","category-fim-2010","category-sharepoint"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/pkp1o-nj","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/posts\/1445","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/comments?post=1445"}],"version-history":[{"count":22,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/posts\/1445\/revisions"}],"predecessor-version":[{"id":1476,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/posts\/1445\/revisions\/1476"}],"wp:attachment":[{"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/media?parent=1445"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/categories?post=1445"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/tags?post=1445"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}