Skip to content
Merged

Main #2636

Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,302 @@
---
parser: v2
auto_validation: true
primary_tag: software-product-function>sap-s-4hana-cloud--abap-environment
tags: [ tutorial>beginner, software-product-function>sap-s-4hana-cloud--abap-environment, programming-tool>abap-development, programming-tool>abap-extensibility]
time: 25
author_name: Merve Temel
author_profile: https://github.com/mervey45
---

# Integrate List Report Into SAP Fiori Launchpad

<!-- description --> Integrate your list report application into SAP Fiori launchpad.

## Prerequisites

- You have a license for SAP S/4HANA Cloud and have a developer user in it
- You have installed the latest version of [ABAP in Eclipse](https://tools.eu1.hana.ondemand.com/#abap), i.e. ADT
- You need to have following business role assigned for your business user `SAP_BR_DEVELOPER` and `SAP_BR_BPC_EXPERT`
- You need to have business catalog `SAP_CORE_BC_UI_FLD` assigned for the usage of manage launchpad space
- You need to have business catalog `SAP_CORE_BC_UI` assigned for the usage of manage launchpad settings
- You need to have business catalog `SAP_CORE_BC_BCT_TRN_MNG_PC` and `SAP_CORE_BC_BCT_TRN_REL_PC` assigned to your user to see the app
- You need to [enable spaces layout](https://help.sap.com/docs/SAP_S4HANA_CLOUD/4fc8d03390c342da8a60f8ee387bca1a/64a5e1675ce7413791a654d2228a90be.html?locale=en-US&state=TEST&version=2208.502) in SAP Fiori launchpad to see the app tiles, that are added to spaces or pages


## You will learn

- How to make use of IAM apps and business catalogs
- How to create business roles
- How to manage launchpad spaces and assign business role
- How to assign and manage launchpad spaces


## Intro

>**HINT**: The administrator receives an welcome e-mail after provisioning. This e-mail includes the system URL. By removing `/ui` you can log into the SAP S/4HANA Cloud ABAP Environment system. Further information can be found [here](https://help.sap.com/docs/SAP_S4HANA_CLOUD/6aa39f1ac05441e5a23f484f31e477e7/4b962c243a3342189f8af460cc444883.html?locale=en-US&state=DRAFT).

---

### Make use of existing IAM App and business catalog

1. Open ADT, select your package `Z_PURCHASE_REQ_###` and open your IAM App `ZSHOPCART_IAM_###`. Add the UI5 application ID to your IAM app and activate it.

<!-- border -->
![iamapp](new2.png)

If you don't have an IAM App created yet. Please create an IAM App and add the UI5 application to it.

2. **Publish** your IAM App.

<!-- border -->
![iamapp](new3.png)

3. Make use of your business catalog `ZSHOPCART_BC_###`.

<!-- border -->
![businesscatalog](new4.png)

If you have not yet created a business catalog, please create one and publish it locally.

### Create business role

1. Log in to your **S/4HANA Cloud ABAP environment customizing system**.

<!-- border -->
![login](login.png)

2. Select **Maintain Business Roles**.

<!-- border -->
![role](role.png)

3. Click **New**.
<!-- border -->
![role2](role2.png)

4. Create new business role:
- Business Role ID: `BR_Z_SHOPCART_###`
- Business Role Description: Business role for shopping cart

<!-- border -->
![role3](new5.png)

Click **Create**.

5. Go to **Assigned Business Catalogs** and click **Add**.

![role4](new6.png)

6. Search for business catalog `ZSHOPCART_BC_###`, select it and click **Apply** and **OK**.

![role5](new7.png)

7. Click **Assign Business Users** and click **Add**.

![role6](new8.png)

8. Search your business user, select it and click **Apply** and **OK**.

![role7](role7.png)

9. Select **Maintain Restrictions**.

![role7](new9.png)

10. Adjust Maintain Restrictions for **Write, Read, Value Help** to **Unrestricted**. Go back.

![role7](new10.png)

11. Click **Save**. Now your business catalog and business user is assigned to your business role.

![role8](new11.png)

### Alternative 1: Manage launchpad spaces and assign business role

Option 1:

1. Select the **Manage Launchpad Spaces** tile.

![transport](space.png)

2. Click **Create**.

![transport](space2.png)

3. Create new space and page:
- Space ID: `Z_SHOPCART_###`
- Space description: Space for shopping cart
- Space title: Shopping Cart ###
- Page ID: `Z_SHOPCART_###`
- Page description: Page for shopping cart
- Page title: Online Shop ###

![transport](new12.png)

Click **Create**.

4. Check your result and click **Save**.

![transport](new13.png)

5. Go back to the homepage.

![transport](new14.png)

6. Select the **Maintain Business Roles** tile.

![transport](space6.png)

7. Search for your business role **`BR_Z_SHOPCART_###`** and select it.

![transport](new15.png)

8. Click **Edit** and select **Assigned Launchpad Spaces**.

![transport](new16.png)

9. Click **Add**.

![transport](new17.png)

10. Select **Use Existing Space**, select your space `Z_SHOPCART_###` and click **Assign Space**.

![transport](new18.png)

11. Check your result and click **Save**.

![transport](new19.png)

12. Open the Mange Launchpad Pages tile.

![transport](managespaces.png)

13. Select your page `Z_SHOPCART_###`.

![transport](new20.png)

14. Click **Edit**.

![transport](new21.png)

15. Add a description to your section tile, select your business catalog and click **Add**.

![transport](new22.png)

16. Save your changes.

![transport](new23.png)

17. Check your result.

![transport](new24.png)

18. Click **Page Preview**.

![transport](new25.png)

19. Check the result in the preview.

![transport](new26.png)

### Alternative 2: Assign and manage launchpad spaces

Option 2:

1. Select the **Maintain Business Roles** tile.

![transport](brole.png)

2. Search and select your business role.

![transport](new27.png)

3. Click **Edit** and select **Assigned Launchpad Spaces**.

![transport](new28.png)

4. Click **Add**.

![transport](new29.png)

5. Select **Create New Space**. Add Launchpad Space:
- Assign Space to Business Role: Create New Space
- Space ID: `Z_SHOPCART_###`
- Space description: Shopping Cart ###
- Space title: Shopping Cart ###
- Check **Create Page from Business Catalogs and Groups**.

![transport](new30.png)

Click **Create and Assign Space**.

6. Click **Save**.

![transport](new31.png)

7. Open the Mange Launchpad Pages tile.

![transport](managespaces.png)

8. Select your page `Z_SHOPCART_###`.

![transport](new32.png)

9. Click **Edit**.

![transport](new33.png)

10. Add a description to your section tile, select your business catalog and click **Add**.

![transport](new34.png)

11. Save your changes.

![transport](new35.png)

12. Check your result.

![transport](new36.png)

13. Click **Page Preview**.

![transport](new37.png)

14. Check the result in the preview.

![transport](new38.png)

### Export software collection (optional)

If you want to transport your software collection to your production system, follow the steps below.

1. Open the **Export Software Collection** tile.

![export](export.png)

2. Select **+** to create a new software collection.

![export](export2.png)

3. Create new software collection:
- Name: `Z_SC_###`

![role3](new39.png)

Click **Create**.

4. Click **Add Items**

![role4](new40.png)

5. Select your **business role**, **SAP Fiori Launchpad page**, **SAP Fiori launchpad space** and click **OK**.

![role5](new41.png)

6. Now you are able to select each item and export it.

![role6](new42.png)

### Test yourself

---
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading