SAP S/4HANA Cloud Output Management: Form Developments Common Challenges and Quick Hacks
Output Management plays pivotal role in any SAP S/4HANA Cloud Implementation Project; both functional and technical people will face some hurdles while working on Output Management in Cloud for the first time. So, are you are looking for some quick tips to ease your Output Management journey ? Then yes in this blog I will be talking about my discoveries that can help during analysis and developments of Forms as part of Output Management .Also I will mention some of scenarios you might work upon in projects .
Let’s start with the basics and then discuss on the scenarios you might encounter while working with Forms in Cloud project.
- How to find Forms in SAP S/4HANA Cloud: Of course, this would be first question that will cross your mind. You can find all the standard predelivered templates available using Fiori app “Maintain Form Template“. Even any custom template you create will be maintained in this app only. (It will be available under Custom Templates Tab). Quick preview of Maintain Form template Fiori app is shown below, you can also view the available languages for any template along with its type and data source.
- Form Template Components: Every Form Template has Template (Adobe Form) and Data Source as the key components. The form is separated into two parts Master Form Template(Define the page layout i.e. paper size and orientation and has placeholders for static data like logo and footer text) & Content Form Template (data used).
When you download Form Template from “Maintain Template Forms” Fiori app; it will download 3 files in zip folder
- XSD File (Defines what elements and attributes data source have in an XML format. It also defines the relationship of the elements and what data may be stored in them.)
- Master template XML file (Master template layout)
- Content template XML File.
If you select ‘Download without Form Template Master’ while downloading form template; then only 2 files will be downloaded)
Example: This is how the file contents will appear when you download form template
- What is Data Source used in Forms: Data Source used in Forms is an OData service. Also, when you Upload Form template after any changes as copy of standard template; ensure to give the Data Source as the Original data source else you will get the errors.And in Cloud you can only use SAP predelivered data sources only.
- How to see the fields available in Data Source? Well yes there is no app in Cloud to see the structure and Content of OData in Cloud. But you have alternative ways
- Open the Form in adobe life cycle designer and you can see the fields of data source along with hierarchy of elements.
- Easiest way is to open the file (XSD file of the form that you downloaded) with NOTEPAD++ for better readability. This is XML file having all the elements of data source.
- How to see the Content of fields of Data Source: Again, unfortunately there is no app /direct way to see the OData Content. This was one of the biggest challenge I faced until I came across the blog listed here. As mentioned in this blog you can download the XML file while doing Print preview of document say Billing document using statement #&&DOWNLOAD_FORM_DATA_XML&&#”. So, once the XML file is downloaded; you can see the contents and structure both for the Data Source. This would help in custom development when you want to see which field of data source holds specific data so that you can use the same in layout.
- Simulate testing of Form without uploading form in S/4HANA Cloud: Well Good news is yes you can simulate the Form preview in Adobe Life cycle designer using XML file of the data source. Once you have downloaded the XML file having data for document then you can use the same for testing of forms in Adobe life cycle designer. For details on the same , refer the blog listed above.
- Adding Logos /Footer Text: Most common requirement for any customer is to Customize logos / footer text and this can be achieved easily by maintaining logos in Fiori app “Manage Logos” and text in Fiori app “Manage text”. For details refer blog .
- Layout Changes in Forms: In case you only need to make changes in layout of the Form example removing /changing position of any field /adding fields available in data source then you can download the template and customize the same using adobe life cycle designer and upload the custom template .For details refer here.
- Adding Custom Field in Forms: Enhancing Data Source is not recommended, and you must use In-app Extensibility for the same. For detailed steps refer here.
- Changes in Master Template : Master template has the overall layout of the form including positioning of Logos and footer. If any changes are required for example moving the logo position then we need to make change in Master Form template . For details refer here
- Add Custom field in Decision table for Output Determination: In case you need to add custom field in Decision table to be used in rules for triggering Output Type .Please refer the blog “SAP S/4HANA Cloud: Configuring Custom Field in Decision Table (Output Determination)“
- Using multiple Data sources in Forms: In case you need to build form having data from multiple data sources /custom data source is required; can we do that? So, if you are exploring how this can be done in SAP S/4HANA Cloud then the development cannot be done in SAP S/4HANA Cloud for such type of requirements. But Yes, it’s possible but you must go for Side by Side Extensibility in this case. You need to use the Adobe Service in SCP (Neo account) to build the PDF along with custom UI5 application. Example scenario where in Billing form; you need additional information related to open invoices /payments made for customer along with billing details. I will cover the same in my Upcoming blog on challenges while building forms using Side by Side Extensibility for SAP S/4HANA Cloud.
Summary:We have covered some of common roadblocks and scenarios you may come across while working on Forms in SAP S/4HANA Cloud.I hope while working on S/4HANA Cloud Implementation; you will find this information useful. Please do share your experiences wrt Output Management.
For understanding Side by Side Extensibility for Forms ,refer my blog SAP S/4HANA Cloud Output Management: Side by Side Extensibility for Forms