Skip to Content
Todays topic is the web UI for OSA and how to create your own custom layout. I will also shortly add some points to the MSS/ESS integration in the portal environment.

How to create a custom web layout for Objective Setting & Appraisals

The web UI is realized via the BSP Application HAP_DOCUMENT. It generates an appraisal document based on a fixed routine. This leaves little possibility for creativity when you are not happy with the standard delivered layout.

Therefore the application has the possibility to give the control over the layout to another BSP application. To achieve this, these few steps are necessary.

Copy the delivered or create you own BSP Application and make sure that the custom BSP application uses application class CL_BSP_HAP_DOCUMENT_UI as this class contains all the necessary methods and constants to perform the eventing.

Create a controller class and implement the do_request method. In here it has to be decided whether to call the main appraisal document or the part appraisal document. The coding within this method will look more or less like:

Now you can program the layout you want to use in your custom BSP. Some examples I have seen include roadmaps, tab-strips and flowbars.
You can directly use the new BSP application however often the layout is for one specific template and not general valid. To make sure a BSP is only used for the right template you can create a BAdI implementation based on definition HRHAP00_BSP_TMPL. In the method ‘BSP_APPLICATION_GET’ you only have to assign the custom BSP application.

After you activated the implementation you have to go to the basic setting of OSA (transaction OOHAP_BASIC) and register the new implementation in exit area ‘AW – Web Layout’. Now you can set for a template on the layout tab writer the WEB layout to the custom layout. You will have to call always the HAP_DOCUMENT BSP in the web, and then the standard BSP will make sure the correct custom BSP is called.

Objective Setting & Appraisals within the web environment

To run OSA in a web environment a portal is not necessary. You will need to call on of the following document list pages.

Manager
documents_todo.htm – All open documents where the user is appraiser or part appraiser. The page can also be used to create new appraisal documents.
documents_created.htm – All documents in status ‘completed’ or higher where the user is appraiser
Employee
documents_received.htm– All documents in status ‘completed’ or higher where the user is appraisee
documents_received_open.htm – All open documents where the user is appraisee in display mode
documents_received_open2.htm – All open documents where the user is appraisee in change mode
Other
documents_where_participated.htm – All documents where the user is further participant

When a list page is not providing the data needed for your process you can copy an overview page and adapt this. For example of you want the employee to be able to trigger the appraisal process you can copy the documents_todo.htm and replace appraiser with appraisee. Also you will need to change the data provider, this can be done by replacing the data provider with a call of function module HRHAP_DOCUMENT_GET_LIST_XXL.

All the pages can of course also be included in a portal iview as part of your MSS or ESS process. Important here is to set the parameter SESSION_HANDLING_OFF in the list pages on true. This to avoid conflicts between the portal and the BSP session handling.

Another important parameter, independent of the portal, on the list pages is MODE. A common situation is that an employee needs to approve or reject his completed appraisal. He goes to his list (documents_received_open2.htm) and selects his document. The approve and reject button are there but inactive. This is due to the MODE parameter being initial. Set this to ‘X’ to enable the status change buttons after completion.

To report this post you need to login first.

13 Comments

You must be Logged on to comment or reply to a post.

  1. Raghu Kolukuluri
    Hello Maurice,

    The Blog is really usefull and informative for us.

    You said, sap is working on new webDynpro for performance management.

    when it is expected to be released?

    I think it would be a lot easier for us to work on webdynpro than BSP

    Thank you & Regards
    Raghu

    (0) 
    1. Padamshree Ramananda
      Hi Maurice,

      There is requirement from the client for the appraisee to initiate the appraisal process via ESS.

      1. I have defined the link in Homepage framework and given the object name as hap_document_pa/documents_todo_with_parameter.htm
      2. An user parameter ‘X’ has been defined in the portal in appraisal iview.
      3.I have defined in my template for the employee and manager to default.The employee name is defaulting through, but manager name is not defaulting through.

      Could you please advice if there are any other object name I can define, so that it will enable the appraisee to initiate the appraisal process and the manager to approve when ‘In Planning’ In Process’.

      Thanks & regards
      Shree

      (0) 
  2. manasa manasa
    Hi!
    I am trying to redirect the HAP_DOCUMENT BSPusing the HRHAP00_BSP_TMPL badi. Below are the steps i followed for this:

    1)I created a BAdI implementation based on definition HRHAP00_BSP_TMPL.

    2)In the method ‘BSP_APPLICATION_GET’ i assigned the custom BSP application.
    [i]METHOD if_ex_hrhap00_bsp_tmpl~bsp_application_get.
      application = ‘CUSTOM_BSP_APPLICATION_NAME’.
    ENDMETHOD.[/i]

    3)After i activated the implementation, went to the basic setting of OSA (transaction OOHAP_BASIC) and register the new implementation in exit area ‘AW – Web Layout’.

    4)Now  set for a template on the layout tab writer the WEB layout to the custom layout.

    5)I called the HAP_DOCUMENT BSP in the web.

    Now when i open the documents, i am getting a dump as below: The current program, “SAPLRHAC”, had to be terminated because a capacity limit
    has been reached.

    The method is being executed infinite times and hence the memory limit is exceeded and i get the dump.

    Please let me know if i am doing anything wrong in using the badi.
    Any suggestions are highly appreciatedi have this topic posted in the BSP forum too.
    Thanks in advance,
    manasa

    (0) 
  3. Raghu Kolukuluri
    Hello Maurice,

    I think it would be usefull, if you can also give some inputs on dirrerent technologies involved in linking the BSP list pages to ESS/MSS portal, such as iViews, etc.
    Also what are the SAP standard iViews for Performance Management?

    The other issue that I wanted to add is, nowadays the customers wanted to use just SAP out of box applications and discouraging us to create custom developments such as chaging BSPs, etc.

    So it would be great, if SAP comes up with better web pages (BSP / WebDynpro), that solves the important problems such as:

    1. width of note boxes (we can only choose height, but not width),
    2. Locking the column headings (currently column headings are not locked on the page, so column headings are not visible, if the user scrolls down Vertically),
    3. Locking the objectives column (currently Objectives are not locked on the page, so objectives are not visible, if the user scrolls horizontally), etc

    (0) 
  4. Hannah Lewy-Phillips
    Hi Maurice,
    we can see:
    documents_todo_with_parameter.htm
    in our system.
    What is this for? Why does it have commented ABAP code near the end of in initialisation and will it help us setting up Appraisees as creators of appraisal documents?
    Many thanks,
    Hannah.
    (0) 
    1. Kelvin Dela Rosa
      Hi Hannah,

      What is the version of your system?
      We are using ECC 6.0 with EA-HR extension 600 but I can’t see that page?

      also, regards from PDO.

      Cheers,
      Kelvin Dela Rosa

      (0) 
    2. Kelvin Dela Rosa
      Hi Hannah,

      What is the version of your system?
      We are using ECC 6.0 with EA-HR extension 600 but I can’t see that page?

      also, regards from PDO.

      Cheers,
      Kelvin Dela Rosa

      (0) 
  5. Puneet Gupta
    Hi,

    We have to open up a apprisal document in interactive PDF form instead on  standard BSP page.

    I have Created a new BSP with reference to class for HAP_Document and implemeted the BADI.

    But in the do_request method of the controller class i am not getting data from the previous page.
    l_appl ?= adapter->if_bsp_page~get_application( ).
    l_appl remains initial.

    Please help me with this.

    second issue is the PDF forms opens up when we click on documents in preparation but not when in In process status.

    This is highly critical for us, Please help.

    (0) 
  6. Mohan Pitchaimani
    Hi Sven Ringling,

                    My name is Mohan from IBM India Pvt ltd, I have read your Document “HR2008 How and When to Use BAdIs to Customize SAP ERP HCM Performance Management Templates..”
                I have some doubts in my project requirement..

    My requirement :

               I have the requirement in Performance appraisal Document layout changes.. I needs to Add/Delete some of the layout changes.
    so i followed your document.
    1. I changed the hap_document to Zhap_document and changed the layout.
    2. And also i created the new BADI implementation
    3. Mu question is How to assign enhancements to a template

    (0) 

Leave a Reply