What is the portal integration?

Portal integration is a solution that offers tight integration of Unified Inbox with SAP NetWeaver enterprise portal technologies to help business users to view and interact with Unified Inbox, tasks directly from the portal. It is based on the standard knowledge management and portal capabilities of SAP NetWeaver.

The following sections are completely technical in nature and cover the following.

  1. Which iView to use
  2. How to make connection to backend where Unified Inbox is deployed.
  3. How to personalize content based on SAP user roles.
  4. How to setup authentication between portal and Unified Inbox
  5. How to apply theming. Unified Inbox portal integration part 2 – Theming

You can follow the steps described here and integrate Unified Inbox or any other UI5 application in portal within minutes. (Please have look at relevant SAP Notes mentioned at the end)

Step 1: Creating an UI5 application iView

Please refer SAP note #1737445 before continuing and follow the recomndations therein. Not doing so might result in UI rendering issues in IE browser.

The first decision to make is which iView template to make use of. If UI5 iView is available in your SAP Enterprise portal use it else you can also make use of URL iView. The steps described here apply to UI5 iView template, but URL iView template usage also would be somewhat similar if not same.

Login to portal with content administrator and system administrator privileges.


1a. Open Portal and navigate to Content Administration.

1b. Navigate to “com.sap.portal.appintegrator.sap” under Portal Applications within the Portal Content.

/wp-content/uploads/2014/06/1b_463198.png

1c. In the context menu of the “UI5” application iView , choose Copy

/wp-content/uploads/2014/06/1c_463128.png

1d. In the Portal Content folder, choose the location in which you want to create the iView, and from the context menu choose Paste as PCD Object. (In this example creating in “Portal Applications”).  Enter details in the General Properties as shown below.

/wp-content/uploads/2014/06/1d_463129.png

1e. Click on Next and then Finish,  the  PCD object  should have been successfully created and should be seen in the folder where it was pasted (in this case inside “Portal  Applications” folder with name ‘Unified Inbox’, which is nothing but the iView).

/wp-content/uploads/2014/06/1e_463133.png

In the above steps, we have successfully used the UI5 application template to create the iVew within a folder “Portal Application” in Portal Content. However any other folder locations can also be used.

Now the iView needs to be configured to a system where Unified Inbox is deployed so that Unified Inbox can be viewed in this iView. The system configuration is done using system alias which we would configure in the next step.

Refer for creating UI5 iViews: Creating SAPUI5 iVIews



Step 2: Creating / Configure System Alias

The next step is to create portal system and configure the physical system where the Inbox is deployed. Use appropriate system template based on your requirements. I have used “SAP system using dedicated application server” system template for convenience. It does not mean you also need to use the same template.

2a. Select System Administration and navigate to System Lanscape.

/wp-content/uploads/2014/06/2a_463134.png

2b. Under System Landscape Overview, click on New to create new system alias.

2c. In the Template Section, choose “SAP system using dedicated application server”.

/wp-content/uploads/2014/06/2c_463135.png

2d. Enter fields under System Properties.

/wp-content/uploads/2014/06/2d_463142.png

2e. Click on next to define the alias name for the system by entering a value and clicking on Add.

/wp-content/uploads/2014/06/2e_463143.png

The value entered for Alias Name will be used in the iView configuration as it will be system alias name. (In this case “Unified_Inbox_System_Alias” will be the system alias name).

2f. Enter the Template Properties

/wp-content/uploads/2014/06/2f_463144.png

Note:  To configure the system alias to point to a BPM system i.e NetWeaver Java Server (BPM Inbox) use an appropriate portal system template.


2g. Enter “User Name” and “Password” to test the system connection state and click on Next. If the connection test is successful click on Finish to complete the step of creating and configuring System Alias.

/wp-content/uploads/2014/06/2g_463145.png

Step 3: Configure iView with System Alias Details

After successfully creating portal system, now let’s configure the iView created earlier so that it can load the Unified Inbox in the iView.

3a. Switch to Content Administration, and navigate to the folder inside Portal Content where the iView was pasted/created (in this case it was Portal Applications).

3b.  In the context menu of the iView (in this case “Unified Inbox” under Portal Applications), Navigate to Open -> Properties.

/wp-content/uploads/2014/06/3b_463146.png

3c. Click on Modify Properties, and select “All”, from the Show Category drop-down choose “Content-SAPUI5”.

/wp-content/uploads/2014/06/3c_463147.png

3d. Provide the “Relative Path for SAPUI5 Applications” (Example: “sap/bc/bsp/iwpgw/tgw_unif_inbox/index.htm”) and input System field with system alias name which was created in Step 2(it was created with name ‘Unified_Inbox_system_Alias’).

/wp-content/uploads/2014/06/3d_463154.png

3e. Configuration can be tested by selecting “Preview” in the context menu of the iView (in our case ‘Unified Inbox’ under Portal Applications).

If user mapping or SSO is not done you need to enter User ID and password. You should be able to view the Unified Inbox application within a new pop-up (Make sure that pop-ups are not blocked by the browser)

/wp-content/uploads/2014/06/3e_463155.png

Note: Step 4a & 4b are required if Single Sign-On (SSO) is not enabled.

Step 4: Creating User Mapping and Adding iView to a Workset

To simplify I will not describe SSO setup and configuration. You can find the details in SAP documentation easily and setup SSO. For this blog purpose I will use the following user mapping mechanism to achieve SSO. Please decide on what kind SSO to use based on your security requirements.

4a. Select User Administration workset search the portal user for which you would like to map the Unified Inbox user. Click on Modify, select ‘User Mapping for System Access’ tab in user details.

/wp-content/uploads/2014/06/4a_463156.png

4b. Select the System from the drop-down which is the System Alias name we created and configured to iView. In the Mapping Data, provide the ‘Mapped User ID and ‘Mapped  Password’ with values of Unified Inbox application User ID and Password.(i.e., which are the application login credentials).  And click on Save to finish user mapping configuration.

/wp-content/uploads/2014/06/4b_463161.png

The user mapping configuration can be tested by performing a Preview (refer: 3e) on the iView again, this time it should not show the login page.

4c. To create a Workset select Content Administration, and in the context menu of the folder where Workset needs to be created choose New -> Workset (in this case we choose Portal Applications folder).

/wp-content/uploads/2014/06/4c_463162.png

4d. Provide the Workset Name which would appear along with other workset items in the Portal and click on Next.

/wp-content/uploads/2014/06/4d_463169.png

4e. Click on Finish to complete the Workset creation.

/wp-content/uploads/2014/06/4e_463170.png

4f. Select ‘Open the object for editing’ option, and click on ‘OK’.

/wp-content/uploads/2014/06/4f_463171.png

4g. For the application to appear in the Workset, a Page has to be added to Workset, and iView to Page.

/wp-content/uploads/2014/06/4g_463184.png

4h. Click on New and select Page to create and add new Page to a Workset.

/wp-content/uploads/2014/06/4h_463185.png

4i. Provide ‘Page Name’ in the Page Properties and click on Next.

/wp-content/uploads/2014/06/4i_463186.png

4j. Select “Default page Template” option in the Available Templates, and click on Next.

/wp-content/uploads/2014/06/4j_463187.png

4k. Select the Page Layout, in this case we will use the default layout 1 Column (Full Width) and click on Next .

/wp-content/uploads/2014/06/4k_463188.png

4l. Check the summary of the Page created with its details, click on Finish and in next page select Close .

/wp-content/uploads/2014/06/4l_463189.png

4m. Check the options “Entry Point”

/wp-content/uploads/2014/06/4m_463190.png

4n. Select the Page (in our case InboxPage) and click on Open button to open ‘Page Content and layout Settings’.

Drag and drop the iView (in this case Unified Inbox) into the area of Column 1 and click on Save.

/wp-content/uploads/2014/06/4n_463191.png

Workset has been created; a Page inside it has been created; iView has been added to the Page with a layout. For user to view the Workset on along with the other tabs in the portal user would need to add Workset to a Role.

Step 5: Adding Workset to a User Role.

In this step typically you manage content provisioning to users, roles or groups. For simplicity I have used “eu_role” as it is available by default in the portal. You can create roles, groups according to your requirements. For more details refer to SAP documentation.

  5a. Search for “eu_role” (Standard User Role) using Find under the Portal Content. Select the ‘Standard User Role’ in the search result by selecting the checkbox and click onOpen Object’.

/wp-content/uploads/2014/06/5a_463192.png

5b. In the context menu of Workset created (in this case Inbox) Add Workset to Role -> Copy.

/wp-content/uploads/2014/06/5b_463196.png

After this operation user would see Workset name (in this case Inbox) under “Standard User Role” items

5c. In the context of iView, select Open -> Properties and modify Fixed Height(Pixels) to the use preference, (in this case are using 800). And click on Save.

5d. Re-Launch the portal to view the new Workset and application inside the workset.

I was unable to upload last couple of images due total size restrictions. But without the images also the last two steps should be easy to configure.

Now we have integrated Unified Inbox into SAP Enterprise portal. In the next part we will look at how to work with themes.

For more details on Unified Inbox refer : Unified Inbox – SAP NetWeaver Gateway – SAP Library

Relevent SAP Notes for integrating UI5 application in the portal

#1708020 – Support of UI5 based on ABAP applications in the portal

#1885476 – DSM support for UI5 application (To handle user session termination from portal)

#1737445 – Internet Explorer standards mode rendering for EP

For ABAP based UI5 application user session termination from the portal is provided out of the box once you implement SAP Note #1885476

For Java based UI5 application such out of the box xolution is not available, hence the application needs to handle the following additionally for user session termination from the portal.

To implement the session termination for the “Custom Java based UI5 application” Please implement SAP Note #1885476 but Do Not set the “ABAP HTTP Security Sessions Enabled” property to true on the system, as this needs to be configured for UI5 applications based on ABAP only.

This way you will be able to get the DSM terminator request in the following manner:

1. When navigating away -> request to the application with URL parameter sapsessioncommand=USR_ABORT
2. When closing the window or refreshing it -> request to the application with URL parameter  sapsessioncommand=USR_ABORT
3. When logging off from the portal -> request to the application with URL parameter sapsessioncommand=USR_LOGOFF

You can use handle these URL parameters to implement the session termination mechanism in your “Custom Java based UI5 application”.

To report this post you need to login first.

7 Comments

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

  1. Harald Schubert

    Hi Vikrant,

    many thanks for this excellent article! This has been asked for a long time! Great that we now have a step-by-step guide to integrate the Unfied Inbox into the SAP Enterprise Portal!

    BR,

    Harald

    (0) 
  2. Oliver Buschmann

    Hi Vikrant, good article… all went well until I wanted to preview the inbox.

    The unified inbox runs on http port 80xx stand alone in the browser no probs, but when I try to start it from the portal it uses the app server port 5xxxx (same as the portal url itself). seem there is a mapping missing between app server port 5xxxxx and ICM port 8xxx? both portal and gateway is the same logical system.

    Do you maybe have a hint where to fix that?

    thanks

    Oliver

    (0) 
    1. Vikrant Patil Post author

      Hi Oliver,

      In step 2f. of above article “ICM Host Name” configuration under “Web Application Server (WAS)”  needs the value in following format <host>:<port>. Perhaps you check this configuration if it is correct.

      (0) 
      1. Oliver Buschmann

        Thanks Vikrant, the settings are all good … it tries to resolve host and then fails with message “Unable to resolve the servers DNS address”

        Guess I will have to talk to our basis guy!

        Thanks for your help!

        Oliver

        (0) 
  3. preethi ande

    Hi Vikrant,

    In wdj iview we used to pass parameters using application parameter property(ex: usertype=1)

    and will retrieve using wdj code in the application.

    like above, how to pass application parameters and how to retrieve in ui5.

    Please any idea?

    Thanks

    preethi

    (0) 
  4. vijay daniel

    Hi Vikrant,

    Thanks for the document. We have followed the steps mention in the document. when we are configuring the Unfied Inbox into the SAP Enterprise Portal but we are getting the 500 connection timed out while connecting the unfied inbox in portal.

    Regards,

    Vijay

    (0) 

Leave a Reply