Policy Server Guides › Policy Design Guide › Customizing Registration Services › Task Selector Page Customization › Modify the Links › Add Tasks to the Task Selector Page

Add Tasks to the Task Selector Page

Registration Services uses three files to define a task link:

The locale properties file (dms_en_US.properties)

Determines the link text

The presentation properties file (global.properties)

Determines whether or not the link is displayed based on administrative role

The Task Selector page (launch.jsp)

Sets up the link

To add a new task to the Task Selector page:

1. Make sure that the task has an identifier and has entries in the locale properties file and global.properties:
   • In the locale properties file, the entry should resemble the following:

     IDENTIFIER=Link Text

     where IDENTIFIER identifies the task and Link Text is the text string that will be the link in the Task Selector page.

   • In global.properties, the entry should resemble the following:

     IDENTIFIER=Admin:R,OrgAdmin:R

     where IDENTIFIER identifies the task.

   Note: The identifier for the task must be the same in the locale and presentation properties file.

2. In launch.jsp, define a form:

   <form name="FormName" action="/servlet/
   DMS<%=request.getAttribute("adminFilter")%>
   "targetpage.jsp" method="post">

   <input type="hidden" name="ACTION" value="ActionName">

   <input type="hidden" name="ORGPATH" value="<%=orgpath%>">

   </form>

   where:

   • FormName is the name of the form that you are creating
   • targetpage.jsp is the name of the page where users are directed when they click on the link
   • ActionName is the name of the action administrators will perform, such as NEW if administrators are adding a new object
3. Define the JavaScript:

   <script language="JavaScript">

   <!--

   function FunctionName() {

   document.FormName.submit();

   }

   //-->

   </script>

   where:

   • FunctionName is the name of the function that you are defining. The function name should begin with the word Submit, for example—SubmitAddUser
   • FormName is the name of the form that you created in step 1
4. Add the link:

   <ul align="center" type="disc">

   <% if (accessProperties.getVisible(role, "IDENTIFIER"))
   { %>

      <jsp:setProperty name="localebean" property="key"
   value="IDENTIFIER"/>

   <li><font class="SmallLink"><a href="javascript:Function
   Name()"><jsp:getProperty name="localebean"
   property="label"/></a></font></li>

   where:

   • IDENTIFIER is the name of the identifier for the task.

     This identifier must match identifiers in the locale properties file and in global.properties. The locale properties file provides the text for the link. The global.properties file determines which types of administrators can view the link on their Task Selector page.

   • FunctionName is the name of the function you defined in step 2.