HCM Processes & Forms: Getting Started…..initial set-up, config and troubleshooting!
I guess this blog is a bit overdue seeing how it’s partly about “getting started” and we are about 5 enhancement packs in now, eh? (haha) However, this is one of those things where once you go through it, it becomes second nature, and you kind of forget that other people will be having “fun” with all the same issues and quirks you went through your first time when their turn comes around.Â Sadly, many of those issues and quirks are partly due to incorrect and/or misleading SAP documentation or documentation simply does not exist at all. I am hoping this blog will help alleviate some (much?) of that.
A lot of other people I know have their own “checklists” and “cheat sheets” for initial HCM P&F set up. Even for myself, I have a guide I put together that is wayyyyyyyy more detailed and documented to the step-by-step “nTH degree” that I keep around for reference and for my clients. I will not go to THAT level of detail, but never fear….you will still get all the same information, but just in a very summarized and easy-to-digest form.
There are not a lot of prerequisites to really highlight, but the three main ones are:
1. ADS (Adobe Document Services) is properly installed and configured. This is NOT the Adobe Document Server (another Adobe product which you can find in incorrect searches and be led way off), but many people still refer to it as such. It is really just a big Java application (read as “resource hog”) running on a Java app server. You will most always see it installed and running on its own server due to “usage scenarios” as well as the resources it consumes. This task is usually handled by your “BASIS” people. You can run three “test” transactions to check if you ADS was installed correctly (*search documentation/Google for how to execute these correctly). These are:
2. Business Functions have been activated based on your Enhancement Pack(EhP) level. Again, this is usually handled by your “BASIS” team and is an activity in the IMG (right at the top of the IMG in fact). I will not go into “how” or “why” business functions are delivered or the details of what is in these. For the most part, they can be thought of as “feature and content packages” for HCM P&F.
3. Insure that correct business packages have been installed to your NW Portal based on your Enhancement Pack level. You can refer to the documentation in help.sap.com for the Business Functions shown above(for example, HCM_ASR_CI_2) for information on which portal business packages are required.
At this point, you should have ADS ready to go and your HCM P&F functionality available.
Initial Configuration Checklist
1. Specify Number Range Interval for Reference Numbers of Process
This sets up your number ranges for your actual “process numbers”. Typically, you will just use the standardnumber range object HRASR_REFN and make a “new interval” for it. Call it “01” and define it for “000000000001” toÂ “9999999999999”…..or get “fancy” and set up patterns and different ranges for different processes. Anyways, it is all done here.
2. Specify Number Range Interval for CASE Mgmt Case IDs.
Transaction SCASE_NUMBERRANGE can be used to set up the number range used for your Case IDs. If you do not set this up,you will get an error later in step 4 which will tell you to do this step anyways. This is not in any of the HCM P&F set up documentation from SAP (fun!).
3. Set up Workflow Environment
Follow the IMG path HR Administrative Services -> Configuration of Forms/Processes -> Process Configuration-> Technical Settings. You will step through each of these activities.
- Set Up Workflow Runtime Environment: nothing really to do here but review the documentation for this activity node
- Settings for Standard Components and Workflows:Â follow all steps as directed by the IMG node documentation. You will be assigning and activating various workflow related objects.
- Interactive Components
- Activate Workflow After Withdrawing Process
- Workflow: Draft for Process Start
- Workflow for Exception Handling When Saving Asynchronously
4. Set up CASE Management and Process Object
*(you will need proper authorization for remote access and client copy)Â Â
Follow the IMG path HR Administrative Services -> Configuration of Forms/Processes -> Process Configuration-> Technical Settings.
- Set Up Process Object
- Copy default Case Types from client 000. This allows us to store the data from HCM P&F (i.e. persist the data).
- Copy Profile for Case Searches from client 000. This allows us to search CASE Mgmt when looking for specific processes.
5. Set up Error Handling
Follow the IMG path HR Administrative Services -> Configuration of Forms/Processes -> Process Configuration -> Error Handling. Here you are simply going to “Assign Possible Processors to Error Categories” just as it says. For the most part, you can leave the default settings unless you have very specific requirements on how/where particular errors should be routed. This is more likely in a global scenario.
6. Customize the Design Time Workbench (optional)
Finally, just for “grins and giggles”, if you like, you can change the default image that shows for the Design Time (transaction HRASR_DT).Â It is key/object HRASR00_DT_START_PICTURE in transaction SMW0 (that is a zero and not an â€œoâ€�).
Simply, switch the default value out for your own.
Set Up Sample Processes (optional)
Assuming the above steps have been completed, you can additionally set up the SAP standard “sample” process example.
7. Copy Sample Processes from client 000 and activate event coupling.
From the Design Time (transaction HRASR_DT), you can copy both the form scenarios and processes from client 000 using the “Reconcile Objects” menu option found in the top menu of the transaction (you will need proper authorization for remote access and client copy). This is better documented in my blog:
8. Modify Sample Process Names (optional)
Now, personally, as a final step for setting up the “sample” processes, I like to go into the IMG via path:
…and change the displayed name of each process by adding “SAP Std -” to the beginning of each. In that way, they show in the process list to the end user listed together (since it is alphabetically) as well as differentiated from our own custom processes you may develop.Â
So you set everything up, followed the checklist, and you still cannot get HCM P&F to work. Here are the 3 most common errors that come up again and again in the forums.
1. Empty Process List
I set up HCM P&F and copied all the samples but nothing shows up in my process list when I run the application. I select an employee and then on the next step, it just says ‘No Data Available’. What am I missing?!?!?!”
I would say 9 times out of 10, it is missing authorizations. Believe it or not, you can do all of the above mentioned steps and yet not have access to the HCM P&F run time. Make sure you have authorization object P_ASRCONT assigned correctly.
Also, check view V_T5ASRAUTHACTVT. It may be missing entries. This happens especially with SAP_PD processes as I have seen config in this view in client 000 that was missing in our runtime client. We had to copy the config entries into V_T5ASRAUTHACTVT in our client.
2.“Work Item Not Found; Workflow Not Started”…..”Process Object Not Created”
If you are testing your process for the first time using the “test tool” from within HRASR_DT (“Test Process”) and you
receive this string of errors, there are a number of reasons this might happen.(if you are running your test online using the actual “Start Application” WDA, you might get to the confirmation page, have a process number given but on the backend, never see a workflow triggered an process object created) Here is a list to check:
- CASE Management number range has not been set up (check t-code SCASE_NUMBERRANGE)
- The POBJ_MODEL in CASE Mgmt does not exist (check t-code SCASE to verify you have the POBJ_MODL along with your scenario
and step models…if not, there are steps to loading the model in correctly that are covered by a nice WIKI on here…http://wiki.sdn.sap.com/wiki/display/ERPHCM/Frequently+asked+questions+for+Case+Customizing)
- Make sure you document ID for Case models are in-synch all around (check if the doc id for your object models …process, scenario, case…are somehow “out of whack”…ie. not matching…between CASE management, SCASE_CUSTOMIZING and SRMREGEDIT)
- Authorization missing (make sure you, your users and WF-BATCH even have the correct authorization….this means P_ASRCONT as well as CASE Mgmt related auth needed to read/write…..look for auth objects named like S_SRM* and S_SCM*)
3. 403 Forbidden
Check transaction SICF and make sure you have the WebDynpros activated!Â Look down the path:
If you see anything with “asr_” at the beginning (especially “asr_process_execute”) and it is grayed out, you need to activate it. Just right click on the service to bring up the context menu and then select “Activate Service”.
4. The ADS Blue Page of Death!!!
This is a simple error related to configuration after ADS is installed. It means that no credentials/ReaderRights were installed and set up. Simply follow the ADS configuration guide (from help.sap.com for example), and it will walk you right through it.
5. When all else fails….
Use the tools you have to further troublshoot. These include:
- t-code SLG1 (Application Log….good for uncovering exceptions and further information)
- t-code SWEL (see what worflow events have fired)
- t-code SWETYPV (check your workflow linkages to make sure they are correct)
- t-code SU53 (check for authorization issues)
- t-code SWI1/SWIA (Workflow Log)
- OSS Note 1539246 – Enable case management authorization check for end user
- OSS Note 1422496 – Debugging background workflow tasks in HCM P&F
- and of course….our good ol’ ABAP Debugger!
Well, I guess for every “getting started” there is a “now we come to the end”. I would say you are all done now, but really this is just the beginning. You now should have your HCM P&F environment in place and ready to go, so get out there and make some magic happen! (haha) Till next time…