HCM Processes & Forms: Making sense of the new SAP tutorial using FPM
Being “new” to HCM Processes and Forms (HCM P&F) can be daunting enough. Coming in at a time where we now have Adobe Interactive Forms, ABAP Floor Plan Manager (FPM) forms and possibly anything else (since it is pretty “open” now to any 3rd party to build “whatever” as the “data gathering”/form layer) all as possible solutions might qualify you as insane…or at the very least a masochist! (haha) Even those (of us) who might be versed in HCM P&F of the past and have experience with the “old” ways do need to keep up-to-date or be at risk of going the way of the dinosaurs.
With the “new” HR Renewal release with specific content and changes to HCM P&F, the most notable and exciting change in “our world” has to be the additional out-of-the-box/standard possibility of using ABAP WebDynpro forms (views) instead of Adobe Interactive Forms. This does not allow us to just create any old WDA view we like, however. We must do so using the FPM (Floor Plan Manager) framework. If you are use to WebDynpro ABAP programming and have used the FPM framework like some of us, this might come fairly easy. However, if you are not (or you just want to see how the “new” option is incorporated), you will most likely follow SAP’s newer HCM P&F tutorial….
“Tutorial: Create a Process Based on FPM Forms“
As you work through the tutorial however, some things are not completely spelled out for you or immediately obvious. I put together this blog to serve as a companion/expansion to the tutorial to hopefully help those working through it to overcome some of the headaches.
First off, if you are wondering why SAP uses the names they do for this tutorial, it is actually quite simple. In this tutorial, you will be instructed to define a form scenario called ZTFSWD and then attach this to a process you define as ZTPRWD. If you look at the naming, it is simply…”Z” for our custom namespace…”T” for tutorial…”FS” for form scenario or “PR” for process…and then “WD” for WebDynpro (you will notice many of the “old” sample processes do not have the “WD” at the end but do have the same naming)…..so, yeh…naming is pretty much up to you. (haha)
So now, let’s address some of the more confusing steps in the tutorial. From the first tutorial steps in,
Configuring a Form Scenario
In the section at the bottom….
Create the Form for a Form Scenario
- In the object hierarchy area, double-click Form. A blank FPM configuration table will appear.
There are four types of FPM configuration, which are as follows:
- Form – Display data using
a form. For details, see Creating a Form
- List – Display or perform
operations on repeat fields of a single infotype record. For details, see Creating a List
- List Complex – Display or
perform operations on multiple records of a single infotype. For details, see Creating a List Complex Layout.
- Composite – Group
multiple UIBBs within a single UIBB. For details, see Creating a
- Form – Display data using
- Choose an appropriate FPM configuration type from the FPM configuration table. Enter a configuration ID and description and choose Create.
Step 2 here does not really tell you a whole lot or give you easy to follow instructions. The tutorial tells you all the FPM configuration options available but never says which one to pick or how to do it in order to move on in the tutorial, so try this….
2b. In the first column of the “FPM configuration table”, select: FORM (since we just need a simple form for this).
2c. In the second column (“Configuration ID”), enter your own “key ID” for you configuration. Now, you will find that for HCM P&F, SAP uses the following
For your own, you must name yours in the customer namespace, so start with “Z” or “Y”. For ease, I adopt SAP’s naming
convention and simply add a “Z” to the front.
2d. Add a description in the final column.
2e. click the “create” icon which will then create your actual FPM configuration (you might receive a pop-up window asking if you want to save your form scenario…if so, click the “YES” button). It will open a new browser window (since all FPM config work Is done in your browser and NOT in the SAP GUI).
EDIT: You may receive an error like “error “Configuration (YOUR CONFIG NAME) does not exist”. I do not know why SAP changed this but you can not easily create a configuration directly from here as you could when I originally wrote this (even on the version I am working with now, it throws this error). So here is the alternate steps….
- Go to SE80.
- From the “Repository Browser”, select “Web Dynpro Comp. / Intf.
- Now you will need to selected the correct Webdynpro component based on what time of UIBB type you need. Use the following:
- (C) Composite: FPM_COMPOSITE_UIBB
- (F) Form: FPM_FORM_UIBB_GL2
- (L) List: FPM_LIST_UIBB_ATS (you may only have FPM_LIST_UIBB. This is considered the newer version…ATS stands for ABAP Table Services)
- (M) List Complex: same as list (actually not used in any standard sample processes nor I have I had to use it)
To check these, you can look at standard class CL_HRASR00_DT_FSCN_DATA method CHECK_FORM_SCENARIO_FPM_CONF. You can also
see these defined as constants in IF_HRASR00_DT_CONSTANTS.
- After you select the one you need, look at the nodes/folders under it and find “Component Configurations”.
- Right click on that folder and select “Create”.
- This will launch the FLUID application in your web browser.
- Enter your new configuration ID in the right side input box and then click “new” icon.
- This will popup a window asking for the “Description” (just like you saw in the Design Time/HRASR_DT). Enter it and click “OK”.
- You will be asked for the “package” and such as normal for objects and transports.
- Next you will be asked for the feeder class. Enter the standard one used for HCM P&F…. CL_HRASR00_FPM_FEEDER.
- Click “Edit parameters” and enter/select your Form Scenario (and version if needed).
- Click “OK” and click “save” at the top. (You can close the browser now)
- Now, back over to HRASR_DT, you can put in your config ID for the form type selected.
Gee, SAP, thanks for making this soooo much harder now! haha
2f. You now have your FPM configuration to begin “building” your new form/page/screen/thingy.
Now, in the next part from the steps in,
Creating a Form and Editing the Layout
In the section….
Adding Fields to the Form
- Add a header to the form:
the FPM text view field from Repositories and drag and drop it on
to the form.
the text Request
You might not have the Repositories view visible. To make them visible, click the icon that looks like vertical split panes in the menu bar (shown in the image below and if you hover over the icon, the tooltip reads “Navigation & Repositories”):
Then from the repositories shown, you can locate the “FPM text view” field to add to the form as instructed.
Drag the field onto your form (ie. the “Preview” window). Then make sure you have your Attributes pane open (if not, click the icon in the menu bar to show attributes). Finally, you can enter the text “Request Relocation Benefit” into the attribute for the element.
You will follow similar steps to add the other fields as the guide instructs.
In the tutorial, you will see that they ask you to add the comments fields (new and previous comments) directly into your configuration, however, you will
see in SAP’s own examples (and is a better practice) that they put the comments into a separate configuration that is part of your FPM form configuration table. This is a better way to keep your comments fields consistent across forms as well as adding extra “nice” features (such as checking if “previous” comments are empty, and is so, simply hiding the field to clear of page space (ie. “screen real estate”).
So in my version of the tutorial, I made a separate configuration for comments:
Finally, we create the process in the last tutorial section:
Creating a Process
I will give you a little tip/hint here. You can follow the tutorial exactly as instructed. For the most part, you will be either reusing the workflow you defined if you did the “Non-FPM” tutorial or creating a new one to use for your process (note: you will have to chance some of the tasks as the FPM tasks are slightly different, but it is really just switching the “old” standard tasks for the “new” ones). This is very nicely laid out in the tutorial. However, if you want to bypass these steps and get right to testing your new process and FPM form immediately, you can do the following:
- Follow the steps in the tutorial to create the process, assign your form scenario to it and “start step”, assign imitator(s) and other “Start” information.
- In the step where you define the “workflow template” to use, instead of putting in an actual workflow ID, simply put in NO_WORKFLOW. This is an undocumented “feature” that will allow you to immediately launch (and save) a process/form. Keep in mind, this is only useful for testing single form scenario steps and will attempt to change data upon completion based on your configuration.
- Now, you can execute your “start” application, select your process, and test immediately.
- From the Design Time, you can select your
process and click the “test” icon.
- From the Design Time, you can select your
- Fill in the initial information and make sure to
select the option for the “Web Dynpro Screen” at the bottom.
- Execute your test and view your nice new FPM form.
Hope this helps and eases people into HCM P&F a little more comfortably. As always….more blogs to come! You keep reading them, and I will keep churning them out. (haha) Till next time….
Hey Chris.. Thanks for sharing. I'm sure this will come in handy once we get HR Renewal installed (should be very soon). Question: Does this mean all that work we did enabling "Real Time" form field validation and lookups will be obsolete? (:->
Chris a.k.a "the godfather of forms"-
Thanks for another great blog.
Keep up the good work.
Thanks! I will keep going till people stop showing up...just like a true rock star eh? haha
Great work Chris, keep it up.
Nice job (as always) and have always enjoyed your blogging style. Keep up the great work.
On a side for folks that dont know....it was Chris that convinced me to start blogging on SCN many moons ago and so glad he did 🙂
Excellent job, Chris. Really appreciate your attention to detail. Keep it coming!
Thanks, Chris - what a great contribution!!
Awww shucks. Thanks for the kind words. I will keep putting out more as long as nice folks like you keep reading them.
Thanks Chris for nice blog again, Thank you very much!!!
Thank for your sharing on new tech.
Thanks Chris for another good blog.
Hi Chris, Thanks for the great information. Is the tutorial relevant only to EhP 6 with HR Renewal 1.0? You might have said that somewhere and I missed it.
Many thanks! Monica
Yes, Monica...this is the newer HR Renewal based HCM P&F.....I thought I did say it, but really it is the FPM part that is important (as an option instead of Adobe). Thanks for checking it out!
The Floor Plan Manager (FPM) is an SAP view-editing tool which is the basis for the "form" editing part of the P&F Design-TIme (/HRASR_DT) in the backend. These FPM forms were introduces with HR Renewal 1.0. My thanks to Robert Moeller for his help in answering your question!
Thanks very much Chris, I was just waiting for this blog because I need implement for the first time WDA, this is new to me after working for years on Adobe Forms.
If you worked with the "old" way, you will be just fine. It really isn't much different....just a different "data gathering" UI. haha
Did you figure out a way to add a picture in the form. I dont see any option in WD forms like it used to be in Adobe forms.
Sorry. Did you figure this out? There is an "image" element you can add. Past that, you could make your own component and include it in the form (like my "Google" blog example you can find on here)
Thanks. Very nice!
A top blog post. I've just tweeting your SCN blog list as it's the must-have SCN resource for HCM Processes and Forms.
Thanks, Luke! I know it is a bit of a niche, but HCM P&F actually does touch a lot of the trickier technical side of HCM these days (decoupled infotypes, FPM framework, OADP, etc.). So even in some of my HCM P&F blogs, there are some nuggets of wisdom (?) that can and do apply to a broader crowd. =)
Great tips. I am on a project where they are looking to replace their Adobe P&F with the new FPM forms and I am wondering how much of the existing config and workflow can be re-used. Would you say the Adobe form can be replaced and the existing Workflow and P&F config be re-used?
Excellent work as usual, what a good read Chris! So much to learn, I ll keep coming to your shows 🙂 .
This is a very good blog for the beginners in HCM Process and Forms using FPM form.All these points are basic but very useful and helpful.Thanks a lot for putting them together,Appreciate you effort!!!Carry on the good work!!!
We have Adobe forms on the portal and we now have FPM forms and NWBC. Are they fully interchangeable? i.e. Can you run Adobe forms on NWBC and FPM forms on Enterprise Portal? In all of the SAP documentation it doesnt say you can't but I wondered if there is some technical reason this cant be done?
When you say "interchangeable" how do you mean? It is not as simple as "replace one with the other". There are considerations for each. BUT ....yes, they can be ported over and yes, they both can run in the portal and NWBC. Furthermore, keep in mind that with the release of the FPM option, SAP has now also "left the door open" for ANY other kind of form UI interface (ie. others from 3rd parties for example). I HIGHLY speculate that a HTML5 option will be coming soon as well since SAP is pushing it so much in other areas.
indeed it is a great post that helped a lot. the only thing I could not do is, increase the size of current and previous comments fields in the form. even dragging to make it bigger dont help at all. Wonder how would you make it big like a box. Currently it is like a regular input field.
In the "attributes" for your element, look for the Position section. You can set the "start row of element" and "end row of element" to set the HEIGHT and "start column of element" and "end column of element" to set the LENGTH. This allows you to adjust the "box" size of your comments fields.
Can you please help me in the below issue:
In my case the browser doen't open but I get an error "Configuration ZWD_HRASR_XXX does not exist". Do I need to create it before this step. Please guide me.
Updated blog to reference this.
Very nice and useful blog. I am stuck on your step 2e where you have added an EDIT (in the year 2015) to the original blog. Perhaps system setup has changed today versus when you had your blog posted.
My challenge is that we have two SAP clients; one for development and one for customizing. The Dev client can create the SE80 FPM Configurations and the Customizing client can create the HRASR_DT Form Scenarios.
So after I create FPM configuration in Dev client, I need to link the Feeder Class' parameters to the Form Scenario. Correct? Well, the challenge is that the Form Scenarios are only found in Customizing client, not DEV client. I also cannot go into Customizing client to edit the FPM configuration to do the linking.
So how to link the Form Scenario to the Feeder Class' parameter together when there are two separate clients being used? Without this step, I cannot continue to the Form Layout steps.
You would usually move the transport from one client to other (depending on your own company rules) WITHIN the same "box" using SC01 / SCC1.
Ok, I'll check with Basis if they allow this as we developers don't have access to SCC1. Maybe there is a table that I can search for where the Feeder Class Parameter is linked to the Form Scenario, and then update it directly in the Customizing client through SM30. But surprised that other folks don't have this problem as there isn't much written on this difficulty.
Thanks Chris for the tip.
Thanks a lot for he document.
We have SSF system for HR and we want to integrate the Process and Forms in Service Requests for example we want to load process and form int o CRM (SSF) system based on catefgorization, I tied check some docs but could not find any concreate solution for the same.
Can you please help us on the same! that would great!
This is not related to this blog. Please ask elsewhere (forum discussion?) and what is SSF?
hi Christopher.. apologies 🙂
SSF is shared service framework with which one can access HR , FI , Logistic and can create service tickets and everything in CRM.. so SSF is basically a CRM 7.0 system with HR or FI or logistic.
Ah yeh...got ya now....know what it is.....some many three letter acronyms (TLA) haha
Thanks so much for the document and keeping it up to date! I just got through running into the error message on "Object Component Configuration does not exist" and was following the SAP tutorial which does not address this. I really appreciate the fact that you updated your instructions to include how to get past this.
very welcome...Thank you for reading it!
Hi Chris ,
We created a form process and accessing the form using the application ASR_PROCESS_EXECUTE_OVP and the application configuration ASR_PROCESS_EXECUTE_OVP_CFG .I created a new application configuration copied the component configuration ASR_PROCESS_EXECUTE_OVP_CFG into a 'Z' configuration because we wanted some custom buttons in the application .
When i add a button to the global tool bar that button is not appearing in the screen .When i debugged the core webdynpro component HRASR00_PROCESS_EXEC_ALT and found out that except 3 buttons all the rest are disabled and invisible . Eventhough i have enabled the button using code enhancement i am still not getting the button on the UI . Is there anything i am missing ?
Thanks , Ravi .
Hello, someone could suggest to me a book or ebook on ABAP HCM?
Hello Dhruvin Mehta!
It seems to me, the label says that we should first search on Google for questioning after the forum, but I have done, if this is a concern.
Well, Google gave me more consistent answers to this.
I’ve gained a lot of knowledge from your HCM Processes and Forms blogs and appreciate you investing the time and effort to prepare them. Just starting to look at the FPM option and ran into an issue developing my form. I added an Explanation field (FPM_FGL2_EXPLANATION) to my form. I can maintain the field’s Text attribute or its Text Document attribute, and the text will appear in the Preview pane in FLUID. But when I test my process, the Explanation field does not appear. Any idea what might be causing this behavior? There are no attributes for visibility.
First...THANKS!....Second....sorry, but I can't be much help. I don't use those texts much/often for much the very reason you said. If I want "static" text, but want to control it, I tend to make it a field on my HCM P&F form fields config, then I can set its visibility (as well as text) as I like in a generic service. I think I used the ones like you mention a while back and hit similar issues....don't remember.....deep into a global ESS project so my head has not been in HCM P&F in a while. haha
Thanks for the quick response. I will try the generic service approach.
Sadly all your links now fail to resolve, it looks like SAP have updated their site, so your links are no longer valid...! It's a shame as the official tutorials that SAP produce as opaque and not very helpful at all.
They are just the links to the exact spot in the tutorial in the SAP "help" documentation. You should be able to figure out where they go based on the section in the blog and description. .....and yes, agreed....SAP has problems with breaking links with a "redirect" backup plan. =)