Day: February 3, 2018

As part of the S/4HANA Regional Implementation Group I’m privileged to work with and advise many of our SAP S/4HANA customers regarding making the most of the SAP S/4HANA User Experience.  One of the questions we are asked over and over and over again, is how to extend standard SAP Fiori apps to add a few extra fields, set up defaults, or hide a couple of unwanted fields, or just to reorganize the screen a little.  A lot depends on how the app was written. So now we have created a SAP Guided Answer to lead you through the extension process.

On a typical SAP S/4HANA project, you will usually identify some gaps or custom business needs for the user experience.  That’s just a normal part of adapting your S/4HANA solution to your business.

At this design stage you will usually already have your SAP S/4HANA Fiori Launchpad, your Fiori apps, and your other classic apps working. However for many customers, partners, and consultants, the Fiori world – and especially the Fiori for S/4HANA world – is not as well known as earlier solutions such as SAPGUI or Web Dynpro ABAP.

So your question is HOW do I extend the Fiori apps?

You can now use a SAP Guided Answer – How to extend a SAP Fiori app for SAP S/4HANA to lead you through this process.

Just read the introduction and scroll down to choose which type of SAP Fiori app you need to extend.

Why you want to use a SAP Guided Answer

Ok well the first thing that will help you understand what’s possible when extending Fiori apps is that while the apps are all written using SAPUI5 ( SAP Development Toolkit for HTML5 ) different apps can be based on different UI technology frameworks. These frameworks are essentially composed of different smart templates & features that provide implicit extension options and flexibility services that you can use to adapt your Fiori app.

While implicit extension options usually require developer tools and skills, Flexibility Services include features that can be used by authorized key users (such as power users, business process experts, and functional consultants on your project) and developers alike.  Typically these Flexibility Services are executed directly in the Fiori interface, e.g. using options in the Me Area or using specific Fiori apps such as KPI Workspace (for adjusting Smart Business KPI thresholds, targets, timelines, currency) or Custom Fields and Logic (for adding fields and business logic to business context scenarios that impact the behaviour of multiple related apps).

And of course the Fiori app could also be a freestyle app (i.e. written without a smart template) with explicit extension options. And of course some freestyle apps also have Flexibility Services built-in.

So being able to identify what UI Technology framework has been used, what extension options it provides and how to approach extending that type of app means you can approach extending a Fiori app with confidence.

Knowing what’s available for a specific Fiori app also helps you estimate effort – as flexibility services and implicit extension options are typically quicker to implement than explicit options.

What will you find in this Guided Answer 

For each type of Fiori app that can be extended you will find:

* How to identify what extension options your selected Fiori app provides
* What types of skills and tooling you will need to extend the app
* A typical process flow for approaching the extension

The process flow is particularly helpful for the many Fiori apps which provide multiple extension options, as it tells you in what sequence you should apply extensions.

You will also find a special section just for Fiori app My Inbox – just because it’s time and again the most popular app with SAP S/4HANA customers and it has some extra configuration capabilities you can use for extensions.

What else can you do 

You can also give us feedback on the Guided Answer. If there’s anything that’s not clear, or where you would like to see more information, or if there’s any other topics you would like created as a Guided Answer, or you just want to give us some encouragement, please add that in the feedback or in the blog comments here.

Becoming a SAP Fiori for SAP S/4HANA guru

You’ll find much more on our SAP Fiori for SAP S/4HANA wiki

You might also be interested in these Guided Answers:

* Finding the Best Available App for your Use Case
* Solving the infamous “could not open” app error

And you will find more Guided Answers in the Guided Answers Viewer.

Brought to you by the S/4HANA RIG http://bit.ly/2EC3zGp #SAP #SAPCloud #AI

Introduction:

SAP Cloud Platform Integration released B2B capabilities (available only with Enterprise licensed tenants) for enabling the B2B customers to securely transfer the EDI documents over AS2 protocol and provision a way to split, validate and convert the EDI documents to XML.

In this three-part blog series,

* Part 1 focuses on setting up AS2 simulation tool to simulate B2B partners, to transfer EDI message to a simple integration flow developed on SAP Cloud Platform Integration tenant.

* Part 2 focuses on enhancing the above configured inbound scenario to securely transfer the EDI payload (using signing and encryption) and transform the EDI message to IDoc message.

* Part 3 focuses on creating an outbound scenario that converts IDoc message to EDI message.

Prerequisites:

* You have obtained SAP Cloud Integration tenant with SAP CP Integration, enterprise edition license
* Message Broker is provisioned on the tenant. Refer the blog to provision a Message Broker.
* Familiarized with AS2 protocol. For more details refer to the rfc guide  https://www.ietf.org/rfc/rfc4130.txt

1. AS2 Mendelson Tool Installation:

For simulating the AS2 partners, I would be using the AS2 Mendelson software. You are free to use other tools.

1.Download and install Mendelson from http://as2.mendelson-e-c.com/ 

2. After Installation, you should see AS2 and AS2Stop shortcuts created as shown below

3.Click on AS2 to start Mendelson AS2 server.

4.Enter http://localhost:8080/as2/HttpReceiver in your browser and you should see the below message.

2. Configuring Mendelson for simulating AS2 Partners:

In this step, we would be making the necessary configuration required to post an  AS2 message from the mendelson tool to SAP Cloud integration tenant. This would involve simulating a Sender Partner (mycompany) and Receiver Partner (ABCCompany) in the mendelson tool.

2.1 Configuring AS2 Local Station

There should be at least one AS2 partner configured as a local station that acts as an initiator to post the AS2 messages to other AS2 partners.

*       Run AS2.exe as Administrator

*    In File menu, choose Partner and perform the steps mentioned below:

* Select Local station (the one with Home icon) and configure the properties. You may retain the default values.

* Choose the MDN tab and enter the MDN URL as http://:8080/as2/HttpReceiver

 

* Click “Ok” to save configuration.

2.2   Configuring AS2 Partner

In this step, I am simulating an AS2 Partner called ABCCompany in the Mandelson tool. To test the connection between mendelson tool and SAP Cloud Integration tenant, the initial configuration does not include any security features (i.e. No Signature, No encryption ).

* Choose mendelsontest and click on Clone to simulate a new AS2 partner ( mendelsontest0)

* Edit the newly created partner. Here I have changed the partner name to ABCCompany.
*     Configure the basic properties like Name and AS2 Id

*     Configure Security settings as shown below

*       Configure Send settings as shown below.

Receipt URL: /as2/as2

Payload subject: SimpleAS2

Payload content type: Application/EDI-X12

NOTE:  The Runtime URL can be obtained by connecting to the operations URL in the eclipse or through the Welcome Mail sent from SAP.

 

*        Configure MDN settings as shown below

*            Configure HTTP Authentication to post the AS2 messages on to Cloud integration tenant . The tenant does not accept any inbound messages coming without the authentication.

The user who has been assigned the ESBMessaging.send role on tenant iflmap application has to be mentioned in the Username field and provide the corresponding password of the user.

*           Configure proxy settings ( Optional )

If you are getting connection timeout error after all the settings are done, it may mean that you need to configure the proxy .

Navigate to File->Preferences and set the proxy value as shown below.

More details about different AS2 headers can be found in the AS2 rfc guide https://www.ietf.org/rfc/rfc4130.txt

2.3   Import SSL certificate from SAP Cloud Platform Integration Tenant to Mendelson tool

This step is required to securely post the AS2 message from mendelson tool to SAP Cloud integration tenant.

NOTE: You need to have the AuthGroup.Administrator , AuthGroup.BusinessExpert ,AuthGroup.IntegrationDeveloper roles assigned to the user  on the tmn application.

For more details on task related roles, Refer SAP Cloud Platform Integration Documentation https://help.sap.com/viewer/368c481cd6954bdfa5d0435479fd4eaf/Cloud/en-US/289ef3f8cfad442ea86fe0d5ddad8c42.html

Perform the below steps to import the root certificate:

1.Logon to Tenant Web UI URL .

2.Navigate to Monitor -> Key store.

3. Download the Root certificate as shown below

4. Import the root certificate on to the mendelson tool

a) In the mendelson tool navigate to File->Certificates -> SSL/TLS

b)  Click on Import Certificate

c) Browse the downloaded certificate and Click on Import

d) Check “Show root certificates” to view Root certificate

NOTE: Incase if the above step is not performed, you would get the SSLHandshake error as shown below.

3: Create a Simple AS2 Inbound Integration Flow

3.1 Configure and deploy a simple AS2 Integration flow

* Create a simple integration flow with AS2 Sender and SFTP Receiver to receive Bulk Orders pushed from the mendelson tool and post it onto SFTP receiver.

2. Configure AS2 Sender adapter as shown below.

Keep other properties related to Security, MDN and Retry to the default values.

3. Save and Deploy the integration flow

4.Check the status of the integration flow by navigating to Monitor->Manage Integration Content.

NOTE: Sometimes, Integration flow may fail after deployment with the error saying “No runtime nodes have started for this tenant”. Refer the KBA article 2520573  for the cause and resolution of the issue.

5. A Message queue named after the integration flow is created under Monitoring->Manage Stores->Message Queues.

 4. Testing a simple AS2 message post from Mendelson to SAP Cloud Integration Tenant 

1.In the account cockpit page, assign the Send role to the user on the iflmap application as shown below. This user is same as the user that we configured in mendelson tool for HTTP Authentication.

2. In the Mendelson tool, Choose File->Send File to partner

3. Choose ABCCompany from the Receiver dropdown and select a ANSI X12 message in the file name and click OK

4.You should see a successful message in the mendelson tool as shown below

5.Double click on the message to see the message that was sent and the MDN received back.

6.On the tenant, Navigate to Monitor Message processing to see a Completed message with two MPL attachments (MDN Attachment , Log Current payload )

Take away:

We have learnt on how to install and configure Mendelson tool to post AS2 message to  SAP Cloud Integration Tenant. We have also created a simple integration flow with AS2 Sender to receive messages from mendelson tool.

In the next part of this blog series, I would extend this simple AS2 inbound scenario to post AS2 message securely ( with Signing and Encryption ) and use the EDI Flow steps to transform the ANSI X12 bulk payload to split, validate and convert to IDOC document.

  http://bit.ly/2EESlkM #SAP #SAPCloud #AI