SAP Screen Personas Configuration

PUBLIC
Document Version: October 2013

SAP Screen Personas

Copyright
Copyright 2013 SAP AG. All rights reserved.
SAP Library document classification: PUBLIC

No part of this publication may be reproduced or transmitted in any form or for any purpose
without the express permission of SAP AG. The information contained herein may be changed
without prior notice.
Some software products marketed by SAP AG and its distributors contain proprietary software
components of other software vendors. National product specifications may vary.
These materials are provided by SAP AG and its affiliated companies (SAP Group) for
informational purposes only, without representation or warranty of any kind, and SAP Group
shall not be liable for errors or omissions with respect to the materials. The only warranties for
SAP Group products and services are those that are set forth in the express warranty statements
accompanying such products and services, if any. Nothing herein should be construed as
constituting an additional warranty.
SAP and other SAP products and services mentioned herein as well as their respective logos are
trademarks or registered trademarks of SAP AG in Germany and other countries.
Please see http://www.sap.com/corporate-en/legal/copyright/index.epx#trademark for
additional trademark information and notices.

SAP Screen Personas

Icons in Body Text

Icon

Meaning
Caution
Example
Note
Recommendation
Syntax

Additional icons are used in SAP Library documentation to help you identify different types of
information at a glance. For more information, see Help on Help
General Information
Classes and Information Classes for Business Information Warehouse on the first page of any
version of SAP Library.

Typographic Conventions
Type Style
Example text

Example text
EXAMPLE TEXT

Example text

Example text
<Example text>
EXAMPLE TEXT

SAP Screen Personas

Description
Words or characters quoted from the screen. These include field names, screen
titles, pushbuttons labels, menu names, menu paths, and menu options.
Cross-references to other documentation.
Emphasized words or phrases in body text, graphic titles, and table titles.
Technical names of system objects. These include report names, program
names, transaction codes, table names, and key concepts of a programming
language when they are surrounded by body text, for example, SELECT and
INCLUDE.
Output on the screen. This includes file and directory names and their paths,
messages, names of variables and parameters, source text, and names of
installation, upgrade and database tools.
Exact user entry. These are words or characters that you enter in the system
exactly as they appear in the documentation.
Variable user entry. Angle brackets indicate that you replace these words and
characters with appropriate entries to make entries in the system.
Keys on the keyboard, for example, F2 or ENTER.

Table of Contents
SAP Screen Personas Configuration ..................................................................................... 5
1 Configure System Setting ................................................................................................... 7
1.1 Setup Silverlight Cross Domain .................................................................................... 8
1.2 Activate Services in SICF ........................................................................................... 10
1.3 Setup URL Handler .................................................................................................... 11
1.4 Test RestGUI Services............................................................................................... 13
1.5 Performance Considerations ...................................................................................... 14

SAP Screen Personas

SAP Screen Personas Configuration

This document provides the basic configuration information for the Silverlight component of
SAP Screen Personas 2.0 and includes additonal information of the Support Pack SP01.
For SAP Screen Personas 2.0 HTML component, it is sufficient that the add-on is installed
and the necessary roles have been assigned. For more information on roles and
authorizations, refer to SAP Screen Personas 2.0 Master Guide at
http://service.sap.com/instguides.

About this Document

This document provides only the configuration information that is provided as part of the
Solution Manager content for SAP Screen Personas 2.0. This content will be delivered via the
next available patch in the Solution Manager support package cycle. Content such as object
links to Customizing activities, transactions, programs, and so on, are not included. Therefore,
this document does not provide the complete Solution Manager content for SAP Screen
Personas 2.0.
For more information about SAP Solution Manager, see SAP Service Marketplace at
http://service.sap.com/solutionmanager.

Implementation Considerations
SAP Screen Personas 2.0 requires SAP Kernel 7.21 installed in the system.
Silverlight:Stack BASIS
700

BASIS
701

BASIS
702

BASIS
730

BASIS
731

BASIS
740

Personas Notes

None

None

None

NA

None

None

Basis Notes

1787341

1787341

1787341

NA

1787341

None

Kernel Notes

Latest
Patch

Latest
Patch

Latest
Patch

NA

Latest
Patch

Latest
Patch

Personas Add-on 200 SP 01 200 SP 01 200 SP 01 NA

200 SP 01 200 SP 01

BASIS

SP 24

SP 09

SP 07

NA

SP 01

Release

Kernel

721

721

721

NA

721

740

For more information, see installation note 1776739.

SAP Screen Personas

HTML:
Stack

BASIS 700 BASIS 701 BASIS 702 BASIS

730

BASIS 731 BASIS 740

Personas
Notes

None

None

None

NA

None

None

Basis Notes

NA

NA

NA

NA

NA

None

Kernel Notes

Latest
Patch

Latest
Patch

Latest
Patch

NA

Latest
Patch

Latest
Patch

Personas Addon

200 SP 01

200 SP 01

200 SP 01

NA

200 SP 01

200 SP 01

BASIS

SP 26

NA

NA

NA

NA

SP 03

Kernel

NA

NA

NA

NA

NA

740

For more information, see installation note 1776739.

SAP Screen Personas

1 Configure System Setting

Once the SAP Screen Personas 2.0 is installed, the following procedures need to be
completed in order to be able to perform the administration tasks.
Setup Silverlight Cross Domain
Activate Services in SICF
Setup URL Handler
Test RestGUI Services

SAP Screen Personas

1.1 Setup Silverlight Cross Domain

Procedure
1. Locate key icm/HTTP/file_access_<n> in your system profile.
2. Add following line into profile: icm/HTTP/file_access_0 =
PREFIX=/sap/public/icmandir/,DOCROOT=$(DIR_ICMAN_ROOT),ARCHIVE=
$(DIR_EXECUTABLE)/ITS.SAR,CACHECTRL=+28800
3. Add following lines into profile:icm/HTTP/file_access_1 =
PREFIX=/clientaccesspolicy.xml,DOCROOT=<absolute path
to>\clientaccesspolicy.xml,CACHECTRL=0icm/HTTP/file_access_2 =
PREFIX=/crossdomain.xml, DOCROOT=<absolute path
to>\crossdomain.xml,CACHECTRL=0
The files with example content are described here:
clientaccesspolicy.xml

<access-policy>
<cross-domain-access>
<policy>
<allow-from http-methods="*" http-request-headers="*">
<domain uri="http://*"/>
<domain uri="https://*"/>
</allow-from>
<!--<allow-from http-methods="*">
<domain uri="http://*"/>
<domain uri="https://*"/>
</allow-from>-->
<grant-to>
<resource path="/" include-subpaths="true"/> <!-- test -->
</grant-to>
</policy>
</cross-domain-access>
</access-policy>

crossdomain.xml

<?xml version="1.0"?>
<!DOCTYPE cross-domain-policy SYSTEM
"http://www.adobe.com/xml/dtds/cross-domain-policy.dtd">
<cross-domain-policy>
<site-control permitted-cross-domain-policies="all"/>

SAP Screen Personas

<allow-access-from domain="*" secure="false"/>

<allow-http-request-headers-from domain="*" headers="*"
secure="false"/>
</cross-domain-policy>

SAP Screen Personas

1.2 Activate Services in SICF

Procedure
As the initial page to launch Personas is a BSP, the following services need to be activated in
the SICF transaction:
/sap/persos_app
/sap/bc/bsp/persos/mainapp
/sap/bc/bsp/sap/system
/sap/bc/bsp/sap/public/bc
/sap/public/bsp/sap/public/bc
/sap/public/bsp/sap/system
/sap/public/bsp/sap/htmlb
/sap/public/bc
/sap/public/bc/ur
Please follow the steps given below to activate each service:
1. Launch transaction SICF.
2. Navigate to the specified node.
3. Right-click the node and select Activate Service from the context menu.
4. In the popup that appears, select the first button Activate.

SAP Screen Personas

10

1.3 Setup URL Handler

Procedure
In the SICF transaction, check for the availability of the restgui service in the path
/default_host SAP and activate it. To activate a service, refer to the Activate Services in
SICF.
If the service is not available, configure restgui service by following the steps given below:
1. Create a new service.
1. Start SICF transaction.

This needs System Administrator rights.

2. Execute F8 and navigate to
webgui service.

default_host

sap

bc

gui

sap

its

3. Right-click the WebGUI service.

4. Choose Copy.
5. Navigate to

default_host

sap

and choose Paste.

6. Specify new package or choose the Local Object button.

7. Rename the newly created service to restgui.

Depending on the patch level you are using, there is a limitation in

SICF transaction UI. An already created service is not activated yet,
but after copying Activate Service, the action is disabled in popup
menu. As a work around, deactivate service first, than activate it
again.
2. Configure RestGUI service.
1. Double-click the RestGUI service.
The service data dialog is displayed.
2. Change Compression to Yes.
3. Click Change.
4. Click the GUI Configuration button.
3. Modify parameters.
1. Add or set parameter "~RESTGUI" with value "1".
2. Add or set parameter ~XSRFCHECK with value 0. (This is optional but makes
potential debugging easy).

SAP Screen Personas

11

3. Add or set parameter ~WEBGUI with value 1.

4. Remove all other parameters.
5. Choose Copy Parameter Set
4. Choose the Error Pages tab.
5. Change the radio control from System Logon to Explicit Response Time.
6. Go to the handler list tab and change the handler from CL_HTTP_EXT_ITSto
CL_HTTP_EXT_ITS_BASIC.

If CL_HTTP_EXT_ITS_BASIChandler is not present, apply SAP Note

1667055 .
If the SAP Note 1667055 does not apply to your system, use
CL_HTTP_EXT_ITS at handler class; ensure to point this out if issues are
found later.
7. Click Store to save changes.
8. Right-click RestGUIservice and select Test Service command.
A popup dialog is displayed and you will see the actual URL for RestGUI service.

SAP Screen Personas

12

1.4 Test RestGUI Services

Procedure
It is recommended to test the RestGUI services before you proceed with further
configurations.
1. Point your browser to the (actual URL for restgui service) followed by
/newsession?sap-client=<client id>.
2. Copy the session ID returned by the system.
3. Point your browser to the following address: (actual URL for restgui service) followed
by /state/text. Add the session ID obtained above in the URL to the /sap/ part
of the url.

The URL should look similar to the one given below:

https://DOMAINNAME:PORT/sap(cz1TSUQlM2FBTk9OJTNhcGFlcjhkYl9FUjhfNTMlM2Ft
eUFKZWVvWElOS3pjX09GcUtVeUxEN2tRUnBIc1drajZ2UHJ0MWxsLUFUVA=)/restgui/s
tate/text

Result
You should be able to see a control tree in text notation.

SAP Screen Personas

13

1.5 Performance Considerations

Changing Value Set for Parameter em/global_area_MB
One of the possible options to improve performance is to check the value set for the
parameter em/global_area_MB to overcome performance issues. Ensure to check the size
of memory of the application server machines before you change the value of this parameter.

If it is 64 or 128 MB, allocating 1 GB to this parameter would be safe and can

increase performance.
It is suggested that you increase the value at first on one of your application servers and test
it adequately.

Given below is a sample scenario with sample size for the application servers as well as the
recommendation of this parameter:
Sandbox=4GB > em/global_area_MB= 300
Development=6GB >em/global_area_MB= 300
Quality=6GB >em/global_area_MB= 300
Production=24GB >em/global_area_MB= 1000
If you get a warning about low memory, you will again have to increase this to a higher value.

Please refer to SAP Note 1888428 for sizing guidelines of ITS.

Tab Caching
Using tab caching extensively has an impact on the response time time from user
interaction to system response. From a technical point of view the following is happening: if 7
tabs are cached the information of all 7 tabs is retrieved from the backend. Use tab caching
only if you want to move information from one tab to another. The recommendation is to use
tab caching for 2 to 4 tabs only.
Consider the usage of scripting if you want to display data from another tab.

SAP Screen Personas

14

Delta Rendering
Another option to improve performance is to enable the Delta Rendering technique.

Do consider using other customizing options of the effected transaction to size

down screens in order to get better performance output.
Delta Rendering is a data transfer optimization technique that enables Personas to send
minimal data between the client and server. Enabling delta rendering could help in improving
performance for certain complex scenarios especially those that involve multiple cached tabs.
This can be performed from transaction /persos/admin_ui. By default, Delta Rendering will be
disabled for all the transactions and flavors. Delta Rendering can be enabled in two cases.
For the complete transaction (all flavors)
For a specific flavor in a specific transaction
To launch the Delta Rendering screen, launch transaction /n/persos/admin_ui and go to
General Actions > Enable Delta Rendering.
Steps to Enable Delta Rendering for Specific Flavor
1. Choose the
(Insert transaction code and flavor ID) icon. A list of flavors for the
relevant transaction codes appears.
2. Select the required row and choose Enter. The record is now visible in the Delta
Rendering screen.
3. Choose Save to enable Delta Rendering.
Steps to Enable Delta Rendering for Specific Transaction
1. Choose Insert Transaction Code button.
2. Select the required row and choose Enter. The record is now visible in the Delta
Rendering screen.
3. Choose Save to enable Delta Rendering.
Steps to Disable Delta Rendering
1. Select the transaction from the Delta Rendering table and choose the
icon.
The record is now be deleted from the Delta Rendering screen.
2. Choose Save.

SAP Screen Personas

(Delete row)

15