SAP GRC-Customer Defined Survey- End to End Implementation

Customer Defined Survey- End to End Implementation

Having the right planning and approach, along with a strong technical foundation and correct information, can smooth the pathway and ensure the perfect execution of your strategic vision. This blog is against the backdrop of end-to-end implementation of customer defined surveys in GRC Process Control. Though, there is some information already available on this topic in multiple pieces, this is an attempt to summarize all the information in one place, along with additional details on the missing pieces. Although from an operations perspective, this is just like Disclosure Survey Functionality but is very useful for clients who are already using Disclosure Surveys in PC and still want to use new surveys with Custom OWP Form, Custom email solution and a custom reporting mechanism. This blog can help as one stop shop for all the assistance needed in end-to-end implementation of Custom Surveys in GRC. So, Let’s get started!

SAP S/4HANA Business Process Integration Certification Preparation Guide

Customers could define their own survey type and do compliance survey on specific objects. these type of Surveys come handy when you are already using standard Disclosure Surveys and still want to use a separate Survey with a Customized OWP form, Customized email solution and a Custom reporting mechanism. I faced the same situation with my client where Client is already using standard Disclosure Surveys but still wanted to have a separate line of Surveys for Internal Auditors- which will have a OWP form, emails and Reports totally different from what Disclosure Survey already has. This document will guide you on how you can implement these Surveys end to end in your systems.

The workflow task is created as a PDF as well as an online work item and includes task data. For Offline mode, It is sent as an email attachment. The title of the related attachment shows the task name. When you get the email, open the PDF file and complete the Survey and then submit the PDF. The outbound email will be launched. The system will automatically handle this workflow task after receiving the email. And, for online mode, user logs in to NWBC Work Inbox and take the action on work item created.

SAP GRC 10.0,10.1, 12.0

Note: Implement SAP note ‘2860253 – Customers can define their own survey types and do compliance survey on specific objects like ORGUNIT and CONTROLs. While using ORGUNIT as entity, planner throws an error ‘Cannot find Activity for plan XYZ”

Given SAP Note needs to be implemented if the requirement is to Perform Surveys on Org and Sub process entity level.

4.1 Create question category and assign proper answer types

New question category should be created in IMG and allowed answer types should be assigned to question category. This question category can be used in customer defined survey template.

1. Path: SAP Customizing Implementation Guide –>Governance, Risk and Compliance –>

Common Component Setting –>Surveys –> Implement New Survey Valuation

2. According to the IMG activity documentation, create question category (For instance: new question category ID:ZD)

3. Click button ‘Back’ to previous Select new defined question category and double click folder ‘Answer Types’ in left hierarchy.

4. Click button ‘New Entries’ and assign answer types which are allowed in this question category, then click button ‘Save’ and exit

4.2 Create or reuse survey PDF Interactive Form

Create a custom form “ZGRFN_SURVEY_FORM” as a copy of standard form “GRFN_SURVEY_FORM” with an interface ‘ZGRFN_SURVEY_INTERFACE’ as a copy of standard interface ‘GRRM_WORKSHOP_SURVEY_FORM’.

Creating custom form will help customize the fields like client logo, organization, title, etc.

The form will reflect the configured questions and the survey can be submitted.

In case the attachments are also to be included in the form.

Add attachment tab beside evaluation. It allows to browse file from desktop and attach it to the survey. Addition, opening, deletion of URL and file is allowed.

To activate the ‘Browse’ functionality on the form for attachments, usage rights need to be enhanced for the PDF.

4.3 Define agent slot

Customer can define new agent slot to determine recipients.

1. Maintain view “GRFNAGENTSLOTV” (Tcode: SM30) to define agent slot

2. Click button “New Entries”, Input Business Event, Entity ID, Activity and Event Name, then click key “Enter”. Users who have authorization with selected activity on entity and data part will be determined as

NOTE: This demo survey is intended to be sent at SUBPROCESS Level. This can be modified to any Entity Object level.

3. Click button “Save” to save entry

4. Maintain view “GRFNAGENTSLOTCV” to maintain customized agent determination rules. If specific role is used for business event, this view should be maintained. Otherwise, skip step 4 to step

5. Click button “New Entries”, input the defined business event in the business event field, role and entity

In the example below, the new defined business event is assigned to the role for Sox Sub Process owner

6. Click button “Save” to save the entry.

4.4 Define message class

Custom message class should be created to determine notification texts as required.

1. Maintain view “GRFNVNOTIFYMSG” (Tcode: SM30) to define message

2. Click button “New Entries”, input message class, message number, document object, attachment

Three entries created with following message numbers:

000: Survey Distribution (text in survey email)
006: Survey successfully processed (text for successful processing)
008: Duplicated submission notification (text for duplicated submission notification)
009: Invalidate answers notification (text for invalidate answers notification)

For each message number, entry should be created as following steps.

In the message class filed, enter message class ID
In the message number field, enter message number
In the Notification Messages section, enter a description for the notification
Enter the subject line of the e-mail message
Enter the name of the documentation object used as the body of the e-mail message. This documentation object can be defined in the document class General Text ‟in transaction code SE61‟
Enter attachment file name, if file is attached to the
Save your entry

4.5 Create survey usage class

Create survey usage class to return PDF form, recipient list, message variables and so on.

1. A custom survey usage class ZCL_GRFN_SVYUSAGE must be created to inherit from class “CL_GRFN_SVYUSAGE”.

In class “CL_GRFN_SVYUSAGE”, there are two attributes,“MV_SVYTYP”and “MV_OBJECTID”. “MV_SVYTYP” represents survey type, “MV_OBJECTID” represents object id.

2. Redefined method “GET_RECIPIENT_LIST”.

Recipient list is fetched using the regulation as space, object id and agentslot.

Agentslot is fetched based on the survey type.

3. Redefine method “GET_MESSAGE_CLASS”. Mandatory

Return the message class used for customer’s survey.

rv_agentslot = ‘ZPC_RF_SURVY’.

4. Redefine method “GET_MSG_VARIABLE”.

This method returns message variables which are used to replace the variables used in notification text, email subject and filename of attached pdf interactive form.

Variables like survey name, object id, object name, plan name and due date are fetched and used in the PDF as well as notifications.

4.6 Define Online Webdynpro Component

WEBDYNPRO COMPONENT “GRFN_SIMPLE_SURVEY” CAN BE USED AS ONLINE WD COMPONENT DIRECTLY.

To add the required customizations, a custom webdynpro component can be created as ‘ZGRFN_SIMPLE_SURVEY‘.

4.6.1 Create Webdynpro Component

The custom Webdynpro component ’ZGRFN_SIMPLE_SURVEY’:

Implements Webdynpro interface “GRFN_ONLINE_SURVEY”.
Reuses Webdynpro Component “GRFN_SURVEY_RESPONSE”, interface methods are called by SAP online survey framework and Webdynpro Component. “GRFN_SURVEY_RESPONSE” is used to display customer defined survey questions.
Component ‘GRFN_DOCUMENT’ is also re used to add attachments to the online survey.

Custom view needs to be created with an additional tab in the layout for attachments and links. “MAIN_W” appears in the window list and interface methods appear in the component
Main window ‘MAIN_W’ is updated with the attachment container.

4.6.2 Implement Interface method

Below interface methods appearing in component controller have been implemented:

1. Interface method ‘INIT’

This method is called by online survey framework to initialize the application. For instance: initialize survey questions.

2. Interface method ‘IS_CHANGED_BY_CLIENT’

This method is called by online survey framework to check whether the question answer or survey comments is changed by current user.

3. Interface method ‘RELOAD_SURVEY’

If survey interactive PDF form is filled offline and uploaded in online application, this method will be called by online survey framework. Interface method ‘INIT’ of WebDynpro Component ‘GRFN_SURVEY_RESPONSE’ should be called in this method.

Note: Parameter ‘IV_FORCE_RELOAD’ value of interface method ‘INIT’ of WebDynpro Component ‘GRFN_SURVEY_RESPONSE’ must be set as ‘X’.

4. Interface method ‘UPDATE_SURVEY_MODEL’

This method is called by online survey framework to save survey answers.

5. Interface method ‘SET_CURRENCY’

Parameter ‘IV_CURRENCY’ value of this method is determined by the currency of organization.

4.7 Maintain survey type table

New survey type should be created with Question Category ID, agent Slot, survey usage class, PDF Form Interface, PDF Form and Online component.

1. Path: SAP Customizing Implementation Guide –>Governance, Risk and Compliance –>

Common Component Setting –> Surveys –> Maintain Survey Types.

2. According to IMG activity documentation to define new survey type and each field will be described here-

Survey typ

Survey type must be defined in customer name space, begin with ‘Y’ or ‘Z’.

Text

Description for survey type

Survey Category

Compliance survey should be used.

Question Cat. ID

The new defined question category must be used here. Then planner can retrieve survey templates which are created for this question category.

Business Event

The new defined agent slot must be used here.

ABAP Class

The new defined survey usage class must be used here.

Interface for PDF-Based Form

The new defined PDF Interactive Form interface must be used here.

Name of PDF-Based Form

The new defined PDF Interactive Form must be used here.

Online WD Component

To support online survey function, online WD component must be used here.

3. `Click button “New Entries” to create a survey type

4.8 Maintain plan usage

1. Path: SAP Customizing Implementation Guide –>Governance, Risk and Compliance –>

Common Component Setting –> Planning and Scheduling –> Define Plan Usage

2. According to IMG activity documentation to create Plan usage Plan usage for entity “Sub Process”

Note: Fill the fields with proper value, the field “ABAP Class” must be filled with value “CL_GRFN_PLANUSAGE_SURVEY” and check box “Need Survey” must be selected.

Plan usage for entity “ORGUNIT”–Need Select Objects checkbox is not required for ORGUNIT compliance survey

4.9 Maintain selection procedure

NOTE: DO NOT PERFORM THIS STEP IF THE ENTITY IS “ORGUNIT”

1. Path: SAP Customizing Implementation Guide → Governance, Risk and Compliance → Common Component Setting → Planning and Scheduling → Maintain Relationship between Selection Procedure & Plan Usage

2. According to the IMG activity Documentation to maintain selection

4.10 Assign Regulations to Plan Usage

1. Path: SAP Customizing Implementation Guide → Governance, Risk and Compliance → Process Control → Multiple Compliance Framework → Maintain Regulation to Plan Usage

2. According to the IMG activity Documentation to assign regulation to Plan usage

4.11 Create Custom Report

A new Report Id is created in report configuration in below given SPRO path:

SPRO-> SAP Customizing Implementation Guide-> Governance, Risk and Compliance-> Reporting-> Maintain Report Configuration

A custom Webdynpro ‘ZGRFN_REPORT_SELECTION’ can be created to customize the selection screen for Reporting.

Implements interface ‘GRFN_REPORT_SELECTION’.

Create custom view with a following layout:

Method LINK_CLICKED in Component controller is updated to handle hyperlinks in the report.

Set mandatory fields from selection and Initialize in method SELECTION_INIT.

Get data from selection in Method SELECTION_GET.

All the tabs in the hierarchy are updated for the Report:

Version dependent data:

Walking strategy

A new custom Entity ID is created:

Create Structure ZGRFN_S_CUST_REPATTR for reporting attributes.
Create entry in Table GRFNREPENTITYSTR for the new custom Entity ZSURVEY:

Create below two Custom classes and maintain in view GRFNVENTITY and implement the

methods of these classes to meet the customized requirements.

ZCL_GRFN_API_CUST_PLAN- ‘Fetch’ and ‘traverse’

ZCL_GRFN_OBJTYPE_DESCR- s

An entry is maintained in table GRFNNAVENTITY for survey link creation in Report

Hierarchy

Evaluation types

Columns- Add the required columns to be displayed in report.

Filter-Add fields for selection criteria

Column header texts- Customize the header texts for columns selected for the report

Some of the fields have been activated as hyperlinks by updating the LINK as below:

4.12 Define survey questions

Create survey questions with new defined questions category in question library. Path NWBC –> Assessment –> Question Library. For example: create question for answer type: Yes/No/NA