App Implementation: Manage Customer Line Items

System Landscape Requirements

Before you start to implement the app, ensure that your system landscape has been set up to enable SAP Fiori. This also implies that the front-end components and back-end components for your app are already available in this system landscape:

SAP Fiori System Landscape Options	Setup of SAP Fiori System Landscape with SAP HANA Database Setup of SAP Fiori System Landscape with SAP HANA XS
Configuration of Front-End Server	Configuration of SAP Fiori Infrastructure
Back-End Components Delivered with (Product Version Stack)	SAP Simple Finance add-on 1.0 SPS04 for SAP Business Suite powered by SAP HANA
Front-End Components Delivered with (Product Version Stack)	SAP Fiori for the SAP Simple Finance add-on 1.0 SPS04 for SAP Business Suite powered by SAP HANA

Ensure that the front-end component of the app is in place on your front-end server. It is automatically installed with the UI add-on.

Front-End Server: Front-End Component of App (Software Component)

UIAPFI70 100, SAP_FIN 700

For more information about the installation of SAP Fiori products, see Downloading and Installing Product Versions.

Required SAP Notes

For the Manage Customer Line Items app, the following SAP Notes must be implemented:

Back-End/Front-End Server	SAP Note Number	Description
Front-end and back-end server	2058202	SAP Release Information Note for the Manage Customer Line Items app
Front-end and back-end server	2058363	Release note for the Common ARP Line Items Library

Prerequisites for Implementation

To work correctly, this app requires the following library:

Common ARP Line Items Library

All activities that are necessary to install the library are described in the Required SAP Notes and Front-End Server: Activate UI5 Application sections of this document.

Implementation Tasks

The following sections list tasks that have to be performed to implement the Manage Customer Line Items app. The tables contain the app-specific data required for these tasks:

Front-End Server: Activate OData Services

Component	Technical Name
OData Service (Version Number)	`FAR_CUSTOMER_LINE_ITEMS (1)` `FARP_VALUE_HELPS_SRV (1)`

For more information about activating OData services, see Front-End Server: Activate OData Services.

Front-End Server: Activate UI5 Application

Component	Technical Name
UI5 Application	`fin_cust_lits` `fin_arp_lib_li`

Component

Technical Name

UI5 Application

fin_cust_lits

fin_arp_lib_li

For more information about how to activate the ICF service, see Front-End Server: Activate ICF Services of SAPUI5 Application (for transactional apps) or Activate ICF Service of BSP Application (fact sheets).

Front-End Server: Enable App for Access in SAP Fiori Launchpad

There are several steps to be performed to enable the app for access in the SAP Fiori Launchpad. You require the listed data to perform these steps.

The SAP Fiori launchpad is the entry point to SAP Fiori apps. From a user perspective, it displays those SAP Fiori apps that have been assigned to the catalog designed for this user's role.

This presupposes that an administrator has made the necessary assignments in the launchpad designer to enable a user's access to the respective SAP Fiori apps in the SAP Fiori launchpad. For more information, see Setup of Catalogs, Groups, and Roles in the SAP Fiori Launchpad.

SAP delivers technical catalogs for groups of SAP Fiori apps as repositories to create your own catalogs in the launchpad designer. Along with these catalogs, more technical content is delivered for each SAP Fiori app. You can find the delivered technical content for each SAP Fiori app in the SAP Fiori apps reference library at https://www.sap.com/fiori-apps-library .

Component	Technical Name
Semantic Object	`Customer`
Business Role	`SAP_SFIN_BCR_RECEIVABLES_CLERK`
Business Catalog	`SAP_SFIN_BC_REC_CLERK`
Business Catalog Group	`SAP_SFIN_BCG_REC_CLERK`
Technical Role	`SAP_SFIN_TCR_T`
Technical Catalog	`SAP_SFIN_TC_T_FI`

Front-End Server and Back-End Server: Assign Role with OData Service Authorization to Users

To grant specific users access to OData services, you have to assign roles (including OData service authorization for the app) to your users. You have to make the assignment on the back-end server and on the front-end server:

On the back-end server, a dedicated authorization role (PFCG role) for the OData service is delivered as an example. You can adjust this role according to your needs.
On the front-end server, you can assign the OData service authorization to a new or existing role, such as a business role that has been adjusted according to your needs.

OData Service (Version Number)	Back-End Server: Delivered Authorization Role (PFCG Role)	Front-End Server: Authorization Role
`FAR_CUSTOMER_LINE_ITEMS (1)`	`SAP_FIN_CUST_LIT_APP` Copy this role into your customer namespace. Note To be able to do this, the `S_USER_VAL` and `S_TABU_DIS` authorization objects need to be assigned to your administration user. These authorization objects are available, for example, in the `SAP_BC_USER_ADMIN` role. End of the note.	You can assign the OData service authorization to a business role, for example the delivered business role `SAP_SFIN_BCR_RECEIVABLES_CLERK`.
`FARP_VALUE_HELPS_SRV (1)`	`SAP_FIN_CUST_LIT_APP`	You can assign the OData service authorization to a business role, for example the delivered business role `SAP_SFIN_BCR_RECEIVABLES_CLERK`.

OData Service (Version Number)

Back-End Server: Delivered Authorization Role (PFCG Role)

Front-End Server: Authorization Role

FAR_CUSTOMER_LINE_ITEMS (1)

SAP_FIN_CUST_LIT_APP

Copy this role into your customer namespace.

Note Note

To be able to do this, the S_USER_VAL and S_TABU_DIS authorization objects need to be assigned to your administration user. These authorization objects are available, for example, in the SAP_BC_USER_ADMIN role.

End of the note.

You can assign the OData service authorization to a business role, for example the delivered business role SAP_SFIN_BCR_RECEIVABLES_CLERK.

FARP_VALUE_HELPS_SRV (1)

SAP_FIN_CUST_LIT_APP

You can assign the OData service authorization to a business role, for example the delivered business role SAP_SFIN_BCR_RECEIVABLES_CLERK.

You must assign OData service authorizations for the app to your users.

Caution Caution

Several authorization default values are connected to the OData service. To ensure that all these default values are assigned to a user, you have to follow the instructions given under the documentation links provided.

End of the caution.

Make the assignment on the back-end server and on the front-end server:

On the back-end server, a dedicated authorization role (PFCG role) for the OData service is delivered as an example. You can copy this role and adjust it to your needs. For more information, see Back-End Server: Assign OData Service Authorization to Users.
On the front-end server, you must assign the OData service authorization to a new or existing role, such as a business role that has been adjusted according to your needs. For more information, see Front-End Server: Assign OData Service Authorization to Users.

Jam Integration

For information on how to configure SAP Jam, see http://help.sap.com/sapjam.

More Information

For general information about the user management concept in a SAP Fiori environment, see Users in ABAP Front-End System and Users in ABAP Back-End System.