Show TOC

App Implementation: My Contacts Locate this document in the navigation structure

Implementation information for SAP Fiori app.

System Landscape Requirements

In order to be able to implement this app, your system landscape has to be enabled for SAP Fiori. Depending on the database type serving as the basis in your system landscape, it has to be set up for SAP Fiori and has to meet the respective prerequisites:

Database SAP Fiori System Landscape Setup Prerequisites

ABAP environment

Setup of SAP Fiori System Landscape for SAP Business Suite with ABAP Environment

Installation Requirements (Transactional Apps)

HANA database

Setup of SAP Fiori System Landscape for SAP Business Suite with SAP HANA Database

Installation Requirements (Fact Sheets)

The SAP product version in the back-end system serving as the the basis for the app must be the following:

Required Back-End Product (Product Version Stack)
Each SAP Fiori app consists of front-end components and back-end components:

  • The front-end components of the app consist of the user interfaces and content required for launching the app on the SAP Fiori launchpad. These components have to be installed on your front-end server.

  • The back-end components of the app mainly consist of the OData services required for the app. These components have to be installed in your back-end system.

The front-end and back-end components of the app are delivered with the following SAP product versions as part of the listed software components. The required software components for the app are contained in the listed product instances:

App Component

Required SAP Product Version (Support Package Stack)

Available Instances Containing Software Component

Software Component Required for App (Support Package)

Front-End Components

 ( ) ( )

Back-End Components

 () ( )

For more information about the installation of front-end components, see http://help.sap.com/fiori_implementation.

The app offers the possibility to upload documents. For security reasons, we strongly recommend that you install an appropriate virus scanner in your respective back-end system and define sufficiently restrictive scan profiles to prevent the upload of malicious content. For more information about virus scanning and scan profiles for SAP Fiori apps, see Virus Scanning.

Required SAP Notes

On the back-end server, the following SAP notes must be implemented for this app:

SAP Note Number

Description

On the front-end server, the following SAP notes must be implemented for this app:

SAP Note Number

Description
Implementation Tasks

The following sections list tasks that have to be performed to implement the required components of the app. The tables contain the app-specific data required for these tasks.

You can find the data required to perform these tasks in the SAP Fiori apps reference library at:

Front-End Server : Activate OData Services

Component

Technical Name

OData Service (Version Number)

 ( )

For more information about how to activate the OData service, see Front-End Server: Activate OData Services .

Front-End Server: Activate SAP UI5 Application

Component

Technical Name

SAP UI5 Application

For more information about how to activate the SAP UI5 application (ICF service), see Front-End Server: Activate ICF Services.

Enable App for Access in SAP Fiori Launchpad

To define the access of single users to this app in the SAP Fiori launchpad, technical content is delivered, such as catalogs and example roles.

You can find an overview of the delivered technical content for this SAP Fiori app in the SAP Fiori apps reference library.

For more information about how to procede with this content, see Enable App for Access in SAP Fiori Launchpad.

Front-End Server and Back-End Server: Assign OData Service Authorizations to Users

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

Note

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.

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.

  • 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.

OData Service (Version Number)

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

Front-End Server : Assignment to Authorization Role
( )

In addition, this role contains authorizations to display the related business data.

Note

In addition, this role contains authorizations to display the related business data.

OData service authorization must be assigned.
Configuration Tasks

To be able to implement the app, you must perform the following configuration tasks in the back-end system:

  • Define text type (optional)

    In Customizing for SAP CRM, define the text type to be used for the notes section of the contact information. You do this in Customizing for SAP CRM, under Start of the navigation path Customer Relationship Managemen Next navigation step Master Data Next navigation step Business Partner Next navigation step Settings for "My Accounts" and "My Contacts" Apps Next navigation step Define Settings for Business Partner Next navigation step OData Services End of the navigation path

    For more information, see the documentation for this Customizing activity.

  • Configure notes

    To display a contact’s notes in the My Contacts app, you must configure the text object BUT000 so that texts are displayed in the notes log. BUT000 is the text object used for business partner texts.

    In Customizing for SAP CRM, under Start of the navigation path Customer Relationship Management Next navigation step Basic Functions Next navigation step Text Management Next navigation step Define Text Determination Procedure  End of the navigation pathdefine the default text determination procedure for text object BUT000 as follows:

    Text Type

    Text Changes

    <text type specified in Customizing activity Define Settings for Business Partner OData Services (see above)>

    P (Log)

    If this text type is not set to P, only the latest note is displayed in the My Contacts app, with each new note replacing the old one. There is no log of all notes.

    <custom text type used to display the notes log>

    R (Display Log)
Example
If you are using the default text type 0001 Correspondence, proceed as follows:
  1. In Customizing for SAP CRM, under Start of the navigation path Customer Relationship Management Next navigation step Basic Functions Next navigation step Text Management Next navigation step Define Text Determination Procedure End of the navigation path, select text object BUT000 and, in the tree on the left-hand side, choose Definition of Procedure.
  2. In the Determine Work Area: Entry dialog box, make sure that text object BUT000 and text determination procedure DEFAULT are entered and confirm.
  3. On the Definition of Procedure screen, set the Changes field of text type 0001 Correspondence to P.
  4. On the same screen, set the Changes field of the text type that you want to use to display the notes log, to R.

  • Configure images (optional)

    To deliver photos to the My Contacts app, you must store the files in the back-end system as attachments in the master data of the contacts. In the Attachments assignment block of each contact, make the following settings under Advanced Properties:

    • Select the Default Document checkbox.

    • Select the document type BDS_IMAGE.
Note The aspect ratio of the image must be 1:1.

  • Assign "Employee" business partner role

    Ensure that each user who should have access to the My Contacts app is assigned to a business partner with the Employee business partner role.

  • Configure Microsoft Internet Explorer to upload files larger than 4MB (optional)

    See SAP Note 2041225 Information published on SAP site

More Information

For more information about app implementation, see http://help.sap.com/fiori_implementation Start of the navigation path App Implementation Information for SAP Fiori End of the navigation path.