Microsoft Content Management Server Decline Reason Extension

• Download source files - 24.9 Kb

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

1. Copy all the files in the directory WebControlLibray to the web control library project of your MCMS solution.
2. 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.
3. For the ASP.NET 1.x version only, update ProjectRootNamespace with your project root namespace in DeclineReasonDlg.aspx.
4. 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:
   1. Make sure the page directive remains like:
      ASP.NET

      <%@ Page language="c#" Codebehind="ApprovalAssistant.aspx.cs" 
         AutoEventWireup="false" 
         Inherits="Microsoft.ContentManagement.WebAuthor.ApprovalAssistant" %>

   2. Change the source of the DialogTitle register:
      ASP.NET

      <%@ Register tagprefix="WebAuthor" Tagname="DialogTitle" 
          Src="/<MCMS Site Application Name>/CMS/WebAuthor/
               Controls/DialogTitle.ascx" %>

   3. Add a JavaScript include, an onsubmit attribute in the form element, and a hidden element:
      HTML

      .....
      
      <%=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="">
      
      .....

5. Change the console actions to use the new custom classes. For example, if you are using DefaultConsole.ascx:
   ASP.NET

   <%@ 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>

6. 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.