Introduction
For use in the Microsoft Content Management Server, this Decline Reason Web Author extension (written in VB.NET) prompts authors to enter a reason when declining postings. It works in both single posting declines in the Web Author menu and multiple posting declines in the Approval Assistant dialog. The reason entered can be collected using Request.Form("NC_DeclineReason")
within the events CmsPosting_Declining
and CmsPosting_Declined
in the global.asax, and can be used for email notifications (code sample not included).
A C# version of this extension is available here.
Installation Procedures
- Copy all the files in the directory WebControlLibray to the web control library project of your MCMS solution.
- Copy the directory WebAuthor into the root of your web site. The file /WebAuthor/Client/Console.js contains the scripts for the custom console actions. If Console.js exists already, copy the new scripts into your existing Console.js.
- For the ASP.NET 1.x version only, update ProjectRootNamespace with your project root namespace in DeclineReasonDlg.aspx.
- Copy the MCMS Web Author file \Program Files\Microsoft Content Management Server\Server\IIS_CMS\WebAuthor\ Dialogs\TasksAssistant\ApprovalAssistant\ApprovalAssistant.aspx into /WebAuthor/Dialogs/TasksAssistant/ApprovalAssistant/. In VS.NET 2003, when the file is included and you are asked to automatically generate the code behind file for it, say No. Edit the file as follows:
- Make sure the page directive remains like:
<%@ Page language="c#" Codebehind="ApprovalAssistant.aspx.cs"
AutoEventWireup="false"
Inherits="Microsoft.ContentManagement.WebAuthor.ApprovalAssistant" %>
- Change the source of the
DialogTitle
register:
<%@ Register tagprefix="WebAuthor" Tagname="DialogTitle"
Src="/<MCMS Site Application Name>/CMS/WebAuthor/
Controls/DialogTitle.ascx" %>
- Add a JavaScript include, an
onsubmit
attribute in the form
element, and a hidden element:
.....
<%=EmbedHeadSection()%>
<script language="JavaScript" src="ApprovalAssistant.js"
type="text/javascript"></script>
</head>
.....
<form id="WBC_frmApprovalAssistant" method="post"
runat="server" onsubmit="return CMS_onMultipleDecline();">
<input type="hidden" name="NC_DeclineReason" value="">
.....
- Change the console actions to use the new custom classes. For example, if you are using DefaultConsole.ascx:
<%@ Register TagPrefix="CustomAction"
Namespace="WebControlLibraryRootNamespace.McmsCustom.WebAuthor"
Assembly="WebControl Library Assembly Name" %>
......
<CmsConsole:Console runat="server" id="Console1">
<script language="javascript" type="text/javascript"
src="../WebAuthor/Client/Console.js"></script>
......
<cms:PresentationModeContainer mode="Unpublished" runat="server"
id="PresentationUnpublishedModeContainer1">
......
<CustomAction:ApprovalAssistantCustomAction
id="ApprovalAssistantAction1" runat="server">
<A id="ApprovalAssistantAnchor" href="#"
onclick="<%# Container.ActionJavascript %>;return false" target=_self>
<%# Container.Text %>
</A>
<BR>
</CustomAction:ApprovalAssistantCustomAction>
......
<CustomAction:DeclineReasonAction id="DeclineAction1" runat="server">
<A id="DeclineAnchor" href="#"
onclick="<%# Container.ActionJavascript %>;return false" target=_self>
<%# Container.Text %>
</A>
<BR>
</CustomAction:DeclineReasonAction>
......
</cms:PresentationModeContainer>
......
</CmsConsole:Console>
- Rebuild your site solution in VS.NET.
History
- V1.0 - 2004.02.20 - Base.
- V1.1 - 2004.04.08 - Code clean up.
- V1.2 - 2004.07.10
- Fixed the missing buttons in the dialog due to changes in MCMS SP1a.
- Split CustomAction.vb into DeclineReasonAction.vb and ApprovalAssistantCustomAction.vb.
- V1.3 - 2006.05.16 - Added an ASP.NET 2.0 version.
A Microsoft Certified Professional Developer and Technology Specialist.
Experience and expertise in SharePoint 2016 / 2013 / 2010 / 2007.
Role ranges from a developer in a multi-person team to a solution consultant with expert-level skills, leading a project to completion status.
Proven experience working effectively in a team environment and a self-managed environment.