Previous Topic: Add an Additional Request Status

Next Topic: Restrict the Status Changes Available for a Request Item Based on its Current Status

Hide Request Statuses

The default list of request statuses can include more options than you need for certain categories. In such cases, you can decide to customize the request status list by hiding some of the values in that category. Consequently, users do not see these options on the GUI when they handle requests pending action. Thus, they do not need to sort through status values that do not apply in your organization.

To hide request statuses

  1. Use an editor, such as Notepad, to edit the appropriate requestshared.xml file for the language of your system. For example, for English, edit the file in the %USM_HOME%\view\webapps\usm\locale\icusen\request folder.
  2. Decide which status lines you want to hide; that is, decide which statuses do not apply in your organization.
  3. Edit the line in the <request_header> and <request_item> sections for each status that you want to hide. Enter the comment characters before and after the original expression.

    For example to hide the Ordered status on the request-related pages, enter the comment characters before and after the original expression. These comment characters appear in bold in the following line:

    <!--<st_1004>Ordered</st_1004>-->
    

    In contrast, the following line makes the Ordered status visible on the request-related user interface screens:

    <st_1004>Ordered</st_1004>
    
  4. Hide the corresponding lines in all other sections that use it, such as the <request_item_approval> or <request_item_fulfillment> section.

    For example, to hide the Ordered status on the request-related pages, enter the comment characters before and after the original expression. These comment characters appear in bold in the following line:

    <!--<st_1004 statval="1004"/>-->
    

    In contrast, the following line makes the Ordered status visible on the request-related user interface screens:

    <st_1004 statval="1004"/>
    

    Note: Hide the exact same lines in all relevant sections of the file. Doing so is required for the status to appear correctly in the user interface.

  5. Save the requestshared.xml file.
  6. Test your changes by verifying that they are correctly reflected on the following request-related pages: Request Details, Approve Request, and Fulfill Request.

Example: Hide Request Statuses

To hide certain default fulfillment-related statuses, enter the comment characters before and after the original expression, as shown in bold in this example. Enter the comment characters in the request_header, request_item, and request_item_fulfillment_action sections of the requestshared.xml file.

In this example, before the comment markers are added, the following statuses are visible on the following request-related pages: Ordered, Shipped, Received, Order Cancelled, Staged, and Configured. After the comment markers are added, the following statuses are visible on those pages: Ordered, Shipped, and Configured.

- <request_header>
...
  <st_1004>Ordered</st_1004> 
  <st_1006>Shipped</st_1006> 
   <!--<st_1007>Received</st_1007>-->
   <!--<st_1008>Order Cancelled</st_1008>--> 
   <!--<st_1017>Staged</st_1017>-->
  <st_1019>Configured</st_1019> 
...
  </request_header>
- <request_item>
...
  <st_1004>Ordered</st_1004> 
  <st_1006>Shipped</st_1006> 
   <!--<st_1007>Received</st_1007>-->
   <!--<st_1008>Order Cancelled</st_1008>-->
   <!--<st_1017>Staged</st_1017>-->
  <st_1019>Configured</st_1019> 
...
  </request_item>
- <request_item_fulfillment_action>
...
  <custom_menu current_status_value="default">
...
  <st_1004 statval="1004"/> 
  <st_1006 statval="1006"/> 
   <!--<st_1007 statval="1007"/>-->
   <!--<st_1008 statval="1008"/>-->
   <!--<st_1017 statval="1017"/>-->
  <st_1019 statval="1019"/> 
...
</shared>