Defining and Accessing Self-Service in ESM

Objective

After completing this lesson, you will be able to define self-service functionalities and how to access self-service in ESM.

Defining Self-Service

Self-Service in ESM is a web-based widget (likely within a portal like SAP Build Work Zone) that empowers employees to create new support cases, review existing cases they've reported, and communicate with agents, all without needing to directly contact the service desk.

self-service UI showing my cases and the option to create case and search case

To enable employees to use the self-Service widget a self-service business role needs to be created and assigned to the employees.

Key Features & Functionality

An employee can view, search, filter, and sort cases within the Case list. In 'My Cases', all cases the logged-in user created are displayed. If the logged-in user is also assigned as the case processor, the case will not appear in 'My Cases'.

My Cases: A dedicated view displaying all cases reported by the logged-in employee (excluding those where they are also the processor). This view supports searching, filtering, and sorting.

Case Creation: Employees can initiate new cases by filling in case details (e.g., Case Type, Category, Subject, Description) and attachments.

Case Review: Employees can view the details of their existing cases, including status, updates, and communication history.

Integration with Forms: Custom forms can be integrated into the case creation process to collect specific data.

Portal Integration: The self-service widget is designed for embedding within employee portals, particularly SAP Build Work Zone, using an iframe. Direct URLs are also provided for accessing the widget with or without the case list.

URL Parameters for Pre-filling: Case fields can be pre-populated using URL parameters, streamlining the case creation process for specific request types (e.g., pre-filling the Case Type).

UI Customization: Administrators can tailor the self-service interface to show or hide specific fields within three sections: Default Case Fields, Case Extensions, and Case Description. This customization can be done per Case Type.

Self-Service Toggle per Case Type: Administrators control which Case Types are available for self-service creation through a toggle within the Case Type configuration.

Self-Service Business Role: A specific business role governs access to the self-service functionalities. This role requires configuration with specific business services to grant the necessary permissions.

In the Create Case view, users can enter case details, including the subject, standard fields such as Case Type, Category, and the Case Description. Additionally, Attachments can be added.

self-service UI with the following highlighted; create case, case type, category, description and attachments.

How to Access Self-Service

Embedding the Self-Service Widget:

The self-service widget can be integrated into employee portals, such as SAP Build Work Zone, using an integration frame (iframe). Add the iframe to your portal page and embed the self-service widget URL. For other portals, integration may also be possible.

URLs for Self-Service Widget:

With Case List:Without Case List:
Code Snippet
1
https://<tenantURL>/go/list/self?ui-header=false&ui-tabs=false&auth=sso
Code Snippet
1
https://<tenantURL>/go/detail/self?ui-header=false&ui-tabs=false&auth=sso

Note

Replace<tenantURL> with your specific tenant URL.

Adding Parameters to the Self-Service Widget URL:

  • You can add parameters to the self-service widget URL to prefill Case fields.
  • Refer to the table below for available parameters.
ParameterDescription
CasetypeCase Type ID
Category

Category display ID

Include the Category display ID of the lowest category level that you want to populate. The higher levels are determined and populated automatically. If you are using the category parameter, you also have to use the caseType parameter due to the Service category catalog is linked to a specific case type.
PriorityPriority code: 01, 02, 03, 04.
SubjectFree text
UI-LanguageTwo letter language code. If no language is specified, then the display language is determined by the user's browser setting. For supported languages see Language Settings | SAP Help Portal.

URL Parameters for Case Fields

To add a parameter such as, Case Type, in the self-service widget URL to prefill the Case field, use the following self-service URL:

Code Snippet
1
https://<tenantURL>/go/detail/self?ui-header=false&ui-tabs=false&auth=sso&CaseType=<CaseTypeID>
Replace <tenantURL> in the URL with your specific tenant URL and <CaseTypeID> with your specific Case Type ID.

Note

Replace <tenantURL> in the URL with your specific tenant URL and <CaseTypeID> with your specific Case Type ID.

By adding the Case Type parameter to the self-service widget URL, it ensures that the Case Type is pre-filled when creating a Case in self-service.

self-service UI with case type highlighted and general inquiry case type pre-filled.

Prerequisite for SAP Work Zone Integration:

To embed the self-service widget into SAP Work Zone, ensure both SAP ESM and SAP Work Zone are on the same SAP Identity Authentication Service (IAS). By following all of these steps, you can successfully access and integrate the self-service widget into your employee portal.

Lesson Summary

This lesson defined self-service functionality in ESM, allowing employees to create and review their own cases. Key features include a dedicated "My Cases" view, Case Creation including case details and integration with employee portals via iframes. Access is controlled by a dedicated business role with specific service permissions. Remember, cases where the employee is both reporter and processor are excluded from "My Cases."