ITS Mobile
ITS Mobile
Public
Warning
This document has been generated from SAP Help Portal and is an incomplete version of the official SAP product documentation.
The information included in custom documentation may not reflect the arrangement of topics in SAP Help Portal, and may be
missing important aspects and/or correlations to other topics. For this reason, it is not for production use.
This is custom documentation. For more information, please visit SAP Help Portal. 1
7/7/25, 7:29 AM
ITSmobile
3. It is very important to use the OLD ITS Handler CL_HTTP_EXT_ITS in the SICF
settings. The new Handler CL_HTTP_EXT_ITS_2 should NOT be used.
4. If more functionality is required e.g. F-Keys or you do not like the standard
design, take the third step. Make manual adjustments to the templates in
the transaction SE80, or include a new CSS file with your own design. See also
the sample video in KBA 2242078 - ITSmobile: How to create a sample service
[VIDEO].
Another option for making adjustments to the templates is to the follow the steps on
the ITSmobile Visual Editor WIKI page.
Important
If you make any subsequent changes in SE80 to the templates, CSS files or MIME's -
then the ITSMobile service needs to be republished.
If you have applied ITSmobile related SAP Notes via transaction SNOTE it is important
to regenerate the ITSmobile templates.
This is custom documentation. For more information, please visit SAP Help Portal. 2
7/7/25, 7:29 AM
Then run the report: SIAC_REGENERATE_TEMPLATES in SE38. This will
regenerate the ITSmobile templates.
Finally republish the newly generated ITSmobile service templates. Do this in
SE80 (or run report SIAC_PUBLISH_ALL_INT in SE38 which will publish ALL
the ITS based services)
Features
Barcode Scanning
SAP Note 1311169 - ITSmobile: Barcode scanner AutoEnter has information on the
AutoEnter feature.
ITSmobile Information
ITSmobile on the SAP help portal for ABAP Platform (Creating Mobile Applications with
ITSmobile)
ITSmobile Notes
Only general ITSmobile notes are listed here; find further related SAP Notes using
search key "ITSmobile" in SAP for Me .
ITSmobile FAQs
You have questions regarding ITS? Please check out the frequently asked questions
(FAQ).
This is custom documentation. For more information, please visit SAP Help Portal. 3
7/7/25, 7:29 AM
ITSmobile Troubleshooting Guide: ITSmobile issues
Forum
Please discuss ITSmobile topics and issues in the SAP Community Forum Internet
Transaction Server (ITS).
On this page you will find a feature list of the ITSmobile with a short description and thePrerequisitefor the
system requirements. following features:
NOTIFY_BELL_SIGNAL support
ALV Grid support
System messages and express
mails
An ALV Grid control can't be identified by the ITSmobile Generator. Application popups
Messages with sound
RFID Support
It has some limited features as set out in the note 1037715 - ITSmobile: Supported
Voice Enabling
screen elements Mobile System Logon
Default, Base Service of generator
Include functionality
NOTIFY_BELL_SIGNAL support
New Generator
ITSmobile Visual Editor
ITSmobile supports NOTIFY_BELL_SIGNAL. With the introduction of this feature,
ITSmobile is compatible with SAPConsole. BGSOUND tag is used to generate the
sound.
New Generator
To improve the performance ITSmobile offers a new generator. Templates created with
the new generating style "Mobile Devices (Without HTML Tables)" does not use the
slow table structure to arrange the screen elements.
RFID Support
Unfortunately, there is no standard RFID interface that enables useres to connect all
the handhelds RFID devices made by different manufacturers. To allow as many
different device types as possible to be used, the technical software connection of the
devices in ITSmobile is based on JavaScript. It is therefore possible to connect any
device whose RFID functions can be programmed using JavaScript. In many cases, the
device manufacturer provides an ActiveX control or similar object that can be
addressed in the browser using JavaScript.
The RFID support provided by ITSmobile simply involves the provision of an RFID
pushbutton. This RFID pushbutton is linked to the RFID data and fields and is therefore
similar to a "trigger" on the RFID device. Pressing the RFID pushbutton or "pulling the
trigger" initiate the same function.
Additionally we changed the message icon. We now have a separate icon for each
message type to visualize the different message types too. Check the new testcase
MESSAGE within the sample service ITSMOBILE01 for an example.
For ITSmobile developers we store the message data within the ITS context to allow
programmers their own visualization of messages. New ITS context fields are:
~MESSAGETYPE[1] content e.g. S, I, W, E
S = success message, I = informantion, W = warning, E = error
~MESSAGENUMBER[1] contains SAP message number, e.g. 013
~MESSAGEID[1] contains SAP message id, e.g. SITS_MOBILE
~MESSAGELINE[1] contains the message text
With the ITS default settings, application popups are not visualized. The ITS
automatically submits a <ENTER> against the backend to commit the popup. For the
most mobile applications this default behavior is fine. Anyway, if your application is
using popups e.g. the commonly used logoff popup ( "Logoff ?, with YES and NO
button" ) you have to set the ITS parameter (gui setting) ~popups to "1" to get the
popups visualized. Please keep in mind, that your service must have the appropriate
template for each popup.
With the improvement pack 2, ITS already delivers a template for the commonly used
logoff page ( dynpro: SAPLSPO1, number: 100). If you specify the default service
itsmobile within your template search path (e.g. ~sources myservice,itsmobile ) you do
not need to create an own template, the default template from service itsmobile is
used.
If you miss other templates for commonly used dynpros, please create a message at
SAP, component BC-FES-ITS.
There is no way to display specific popups only, please carefully check if you really
need this feature.
With the ITS default settings, system messages and express mails are not visualized.
(Please see transaction SM02 and SO01 how to create system messages and express
mails.) The ITS automatically submits a <ENTER> against the backend to commit this
messages/mails. That means even important messages and mails like system
availability information or express mails generated from the update task are not
delivered to the mobile users. Depending on your own organization it may be necessary
to visualize this messages to mobile users e.g. to stop comissioning when the update
task stops working due some problem.
If you set the ITS parameter ~SHOW_SYSTEM_MODAL to "1" system messages and
express mails are delivered to the ITSmobile users. As like the ~popups switch you
need a template for each message/mail dynpro within your service.
This is custom documentation. For more information, please visit SAP Help Portal. 5
7/7/25, 7:29 AM
ITSmobile Improvement Update 2 already contains a default template for the system
messages and express mails (Dynpro SAPMSSY0, number 120). To use this default
template, please add the itsmobile service to your template search path (~sources).
This default template at least delivers a notice containing the message title to the
ITSmobile users. The visualization of the messages and mails is limited since the
message/mail dynpro is a list dynpro. If you would like to create your own template,
please have a look at the default template implementation in service itsmobile to see
how list elements are available / accessible through the ITS context.
Voice Enabling
NEW: ITSGENMOBILE4
Voice support has now been added to ITSGENMOBILE4. Voice support has been added
to the tableless ITSmobile Generator. This generating style is "Mobile Devices (Without
HTML Tables)"
Own template generating programs can now be extended with a default service for
generating program templates. If you want to write an own template generator, it is no
longer required to copy all generation templates in your service. You can copy only the
templates that you would like to change. Technically this is done by the overwriting the
function _GET_FROM_TEMPLATE. This function first checks the own service for
templates. If no template is found the template of the default service will be used.
Include functionality
Until now it was necessary to change the generator or the corresponding template in
order to include a own or modified include file for javascript or css stylesheets. The
latest update provides service parameter to identify the own include files. It is not
necessary to change the generator/templates anymore which makes it easier to
include modifications.
This is custom documentation. For more information, please visit SAP Help Portal. 6
7/7/25, 7:29 AM
~itsmobileCssInclude to replace CSS stylesheets
Mobile system logon, own login class can be derived, that avoids waiting periods.
DYNPRO_COMPRESSION
If you wish to remove lines containing no visible elements that are still visible on the
screen then set ~DYNPRO_COMPRESSION service parameter to the value of "1" in the
GUI Configuration section of the ITSMobile service in transaction SICF.
Application popups
Integrated ITS
SAP Web AS 640: Kernel Patch 220, SAP Basis Support Package: 22
SAP Web AS 700: Kernel Patch 140, SAP Basis Support Package: 15
SAP Web AS 710: Kernel Patch 84, SAP Basis Support Package: 6
Standalone ITS
SAP Web AS 640: Kernel Patch 210, SAP Basis Support Package: 22
SAP Web AS 700: Kernel Patch 132, SAP Basis Support Package: 15
SAP Web AS 710: Kernel Patch 81, SAP Basis Support Package: 5
Standalone ITS
This is custom documentation. For more information, please visit SAP Help Portal. 7
7/7/25, 7:29 AM
Include functionality
Integrated ITS
SAP Web AS 640: Kernel Patch 210, SAP Basis Support Package: 22
SAP Web AS 700: Kernel Patch 132, SAP Basis Support Package: 15
SAP Web AS 710: Kernel Patch 81, SAP Basis Support Package: 5
Standalone ITS
SAP Web AS 640: Kernel Patch 220, SAP Basis Support Package: 22
SAP Web AS 700: Kernel Patch 140, SAP Basis Support Package: 15
SAP Web AS 710: Kernel Patch 84, SAP Basis Support Package: 6
Standalone ITS
SAP Web AS 640: Kernel Patch 210, SAP Basis Support Package: 22
SAP Web AS 700: Kernel Patch 132, SAP Basis Support Package: 15
SAP Web AS 710: Kernel Patch 81, SAP Basis Support Package: 5
Standalone ITS
NOTIFY_BELL_SIGNAL support
Note: 1260592
Integrated ITS
Standalone ITS
620 SAPKB62066
New Generator
This is custom documentation. For more information, please visit SAP Help Portal. 8
7/7/25, 7:29 AM
Integrated ITS
SAP Web AS 640: Kernel Patch , SAP Basis Support Package: 24 (SAPKB64024)
SAP Web AS 700: Kernel Patch , SAP Basis Support Package: 18 (SAPKB70018)
SAP Web AS 710: Kernel Patch , SAP Basis Support Package: 7 (SAPKB71007)
SAPKB70103
SAPKB71101
Standalone ITS
SAPKB46C58
SAPKB62066
RFID Support
Integrated ITS
SAP Web AS 640: Kernel Patch 228, SAP Basis Support Package: 23
SAP Web AS 700: Kernel Patch 155, SAP Basis Support Package: 16
SAP Web AS 710: Kernel Patch 99, SAP Basis Support Package: 6
Standalone ITS
SAP Web AS 640: Kernel Patch 220, SAP Basis Support Package: 22
SAP Web AS 700: Kernel Patch 140, SAP Basis Support Package: 15
SAP Web AS 710: Kernel Patch 84, SAP Basis Support Package: 6
Standalone ITS
Voice Enabling
Integrated ITS
SAP Web AS 640: Kernel Patch 210, SAP Basis Support Package: 22
SAP Web AS 700: Kernel Patch 132, SAP Basis Support Package: 15
SAP Web AS 710: Kernel Patch 81, SAP Basis Support Package: 5
Standalone ITS
This is custom documentation. For more information, please visit SAP Help Portal. 9
7/7/25, 7:29 AM
ITS 6.20 Patchlevel 28, SAP Basis Support Package: 64
Voice support for the faster generator: ITSGENMOBILE4. For the generating style "Mobile Devices (Without HTML Tables)"
One has to republish: ITSGENMOBILE4 in SE80 and re-generate your service templates using the tableless ITSmobile Generator
to have this Voice Support feature if you implement corrections from note #1361067 or if you have upgraded to the above Basis
Suppoprt package.
To see which ITSmobile Generators are present in the system, start transaction SM30, view
the table W3GENSTYLES
In your system you can then view the services via SE80
Here is an example of the comment section of the HTML template for MOBILE5
NAME: MY_TEMPLATE_NAME
SCREEN: 8000
DATE: 20170612
TIME: 144445
This is custom documentation. For more information, please visit SAP Help Portal. 10
7/7/25, 7:29 AM
STYLE: MOBILE5
-->
When you generate an HTML template using the ITSMobile Visual Editor template, the style
MOBILEEDIT is set.
See also the SAP Note: 2027612 - Incorrect generation style in HTML template
XML was the OLD comment - in newer systems MOBILE5 is the comment in template
this change to the comment section in SE80 for a template is also documented in the note
Additional information.
2. Runtime Service
ITSMOBILE
This service contains Mime Objects and HTML Templates which are used by the (Test-)
services during runtime.
The HTML Templates folder contains templates for controls (e.g. ALV_GRID), includes (e.g.
CUAAREA) and system messages (e.g. SAPMSYST 40).
3. Testservices
This is custom documentation. For more information, please visit SAP Help Portal. 11
7/7/25, 7:29 AM
ITS Performance
Performance aspects
This information should help you to analyze performance problems with ITSmobile services. Performance problems are always
difficult to analyze but you should at least be able to verify if the performance gap is related to your sap system, your application,
your network or your mobile device. We will not exactly measure response times and the data traffic of ITSmobile services, neither
will we dive into the performance analysis of the sap system, but instead we will try a couple of simple basic tests to figure out
where the performance comes from and whether it makes sense to invest more time to get a better overall response time.
Please keep in mind, that mobile services are ABAP based. Always call the services you are going to analyze a first time to let the
SAP system compile the ABAP sources and fill the buffers. The ITS also needs this first call to pre-parse the templates and store
them into its template cache. The ICMAN has to read the mimes out of the database into his HTTP-Plugin server cache. All this has
to be done during the first access, so in general the first call of a service is not of interest for performance analysis.
1) Performance checklist
First step is analyzing and understanding the performance problem. That means we have to check the performance of each
involved component. In rare cases, you additionally have to check if the problem is related to a specific SAP server, to a single
location, to a specific application or to distinct screens of an application.
Involved components:
SAP system
Application
ICMAN/ITS
Mobile Device
SAP system
To check the system's performance, start the SAPGUI for Windows and call a couple of SAP basis transactions like SE38, RZ11,
SM50 or SM04 to get an idea of the application servers performance. If the performance of these transactions is already poor it
does not make sense to continue with performance analysis of the mobile services. Use the SAP basic tools to find the reason for
the poor system performance.
Application
ITSmobile Services are ABAP based, that means the mobile transactions can be called with the SAPGUI for Windows. Logon to the
system and call the mobile transactions with the SAPGUI for Windows. You will find the transaction of the mobile service within the
ICF service tree (transaction SICF), in the GUI settings, parameter name ~transaction. Sometimes, if you start this transaction
This is custom documentation. For more information, please visit SAP Help Portal. 12
7/7/25, 7:29 AM
within the SAPGUI you will get an error message, that the transaction could not be started. Simply terminate the easy access
menu ( enter "/n" in the okcode field until you get the "Start Easy Access Menu" screen.). Now the transaction can be started in the
SAPGUI for Windows.
Input exactly the same data as on your mobile device and you will get an idea of the performance of the transaction. It doesn't
matter if you call the transaction using SAPGUI for Windows or via Browser using HTTP, in both cases the same application code is
running and will need the same execution time to reproduce the same results. If the performance of the transaction is bad, use
ABAP tools to find out the reason. In that case it does not make sense to continue with the analysis of the performance of the
mobile service.
ICMAN / ITS
Next step is to check the response time of the HTML/HTTP related components in the backend. Start your favorite browser on
your desktop PC and call the ping service ( URL: [Link] ) to get an idea how
long the access of an HTTP service in the backend takes. After testing the ping service, start the ITSmobile service "itsmobile00"
(URL: [Link] ). On your desktop PC you
probably will not experience a big difference between both services, despite the fact that the service "itsmobile00" has to run a
small piece of application coding, the ITS has to convert the data stream to HTML and the browser has to draw the HTLM page. If
possible repeat the test with your desktop PC connected using the same WLAN as your mobile devices, that gives you an idea if
the wireless network has any effect on the response time.
Mobile device
If you run the tests described in 1) "Performance checklist" you usually end up with the insight, that as long as no mobile device is
involved the performance is perfect. The ping test from above is the only test case which is pretty fast on mobile devices too. The
reason is, that the transferred data rate is pretty small and there is not much to paint for the browser. If you start the "itsmobile00"
test service on your mobile device you probably already recognize a much longer response time. This longer response time is the
result of the limited CPU power and the poor rendering performance of the browser on many mobile devices. Let us now look
closer to these limitations and discuss how we can get around them to improve the performance on mobile devices.
On many mobile devices you will find a menu path like "Settings->System->Power->Battery" that leads to a slider where you can
configure the mobile device to increase battery lifetime by decreasing RAM retension/performance.
Check this setting on your mobile device.
Nowadays this issue can be ignored; the devices on the market support caching.
The HTTP data stream of ITSmobile services can be divided into mimes and template data. The template data contains application
values and is changing with every application screen. Mime data is very stable, the content of mime files usually changes only
during the developing phase of a service or if you implement bugfixes. If a mobile device has no browser cache, the mime data is
requested and send again and again from the server with every submit even if the content does not change.
You can use the ITS publish service to store the mime data directly on each mobile device and avoid unnecessary network traffic.
To access the local stored mime data you have to set the ITS parameter ~urlmime to the local storage location. That's it. At
runtime the ITS will read the ~urlmime parameter and use its content to generate the mime links in your html templates referring
to the local storage location. The mimes will not longer be sent over the network, the mimes will be read from the local file system
instead. The disadvantage is the administrative overhead. You have to copy the mimes onto every mobile device. If a mime file
This is custom documentation. For more information, please visit SAP Help Portal. 13
7/7/25, 7:29 AM
changes, you have to get the changed file to every mobile device. By the way, many mobile devices already has software available
which helps you to automate the distribution of files to many single devices.
Mobile browsers, not supporting table-layout style (slow table rendering) [only valid for old ITSmobile
generator]
Some mobile browsers do not support absolute positioning in HTML pages therefore the ITS template generator has to use HTML
tables for the page layout. The table layout is done with a character table spanning the complete screen using the character
positions from the dynpro for the single fields. This produces an HTML layout pretty close to the dynro screens. To help the
browser to render this pages faster the style "table-layout:fixed" is set. Mobile browser which do not support this attribute need
much more time for rendering because they have to calculate each single cell and column size based on the content. Tables are
also used for rendering subscreens, frames and step loops. Having a dynpro screen, containing a subscreen with a step loop on it
leads to HTML pages containing 3 nested tables. The result is a poor rendering performance on browsers not supporting fixed
table layouts.
For the old ITSmobile template generator (which creates templates with HTML tables) the following information applies:
If possible, avoid such constructions on mobile screens. Anyway it's always a good idea to keep mobile screens simple. If you don't
like to change the dynpro layout, you have to manually change the generated template to speed up the rendering. The ITS template
generator can not do this, because of its generic way creating the templates.
If you manually change the generated template, try to replace the <table> with a <div> tag, convert the table lines (<tr></tr>) to
line breaks (<br>) and use the <span> tag for cells (<td>). This could reduce the rendering time to less than 50% of the original,
generated page if nested tables occur on the page. You may optimize the HTLM for a single screen only, or create your own
template generator to optimize all screens for your specific browser. Please keep in mind, optimizing the generated HTML is a
consulting issue. You need detailed HTML knowledge.
For the new ITSmobile template generator (which creates templates with HTML DIVs) the "slow table rendering perfromance
information" is not valid anymore.
However - here it is sometimes required to optimize the screen using an own CSS stylesheet (consulting issue). From consulting
point of view (where performance plays an important role) the recomendation is to use the new DIV HTMLB ITSmobile template
generator. The new generator cannot ensure that all screens look the same as in the SAP Gui but the performance is better
compared to the old ITSmobile generator.
3) Conclusion
The performance of ITSmobile services mainly depends on the used mobile devices. Saving money here has to be paid for effort to
optimize the generated html or to admistrate local mime files on each device to improve the performance.
ITSM - FAQs
This is custom documentation. For more information, please visit SAP Help Portal. 14
7/7/25, 7:29 AM
You can find useful information on this ITSmobile Wiki page and a structured documentation on the SAP Help Portal.
back to top
SAP note 1037715 lists all supported screen elements and their attributes. In addition you can run testservice itsmobile01; this
internet service displays all screen elements. Very complex screen elements, e.g. tablecontrole are not supported by ITSmobile
back to top
You find information regarding the latest improvement and support packages on the News and Improvements page.
When you create an internet service using generation style Mobile Device, you are getting templates of an internet service
optimized for mobile devices. Besides the templates an ICF service with following service parameter has to be created: ~itsmobile
1, ~transaction <your transaction> and ~theme <your theme>. If you want to see an ITSmobile service without generating your
own, check out the test services itsmobile00, itsmobile01 or itsmobile02 (testservice for language generation). These services get
deliverd with ITSmobile.
See also SAP note 1072504 regarding ITSmobile sample application.
back to top
Befor you start to create your own mobile internet service try to start one of the test services itsmobile00, itsmobile01 or
itsmobile02. See also SAP note 1072504 regarding ITSmobile sample application.
back to top
See SAP Note 1093513 and the page "Mobile Devices and Browser".
back to top
back to top
This is custom documentation. For more information, please visit SAP Help Portal. 15
7/7/25, 7:29 AM
First review the ITSMOBILE service in SE80 and copy the [Link] that exists in
the path
Then create a blank page on the device itself with a background sound just to see if the
browser supports sound:
<html>
<head>
</head>
<body>
<p> This doesn't create any result on the screen but it plays sound file 3 times in the background </p>
</body>
</html>
if the WAV file is accessible on the Handheld device from the Web Application Server then create the following HTML Page
<html>
<head>
<title>Test Sound</title>
</head>
<body>
This is custom documentation. For more information, please visit SAP Help Portal. 16
7/7/25, 7:29 AM
<p> This doesn't create any result on the screen but it plays sound file ONE times in the background </p>
</body>
</html>
TESTING
http(s)://<Host>.<Domain>:<PORT>/sap/bc/gui/sap/its/test/mobile/itsmobile01
→ click on the "+" button → select "514 MESSAGE" → hit the button "STRT" → click the button "Message Type S and I"
if you trace using HTTPWatch or review the View Source the file called is: [Link]
http(s)://<Host>.<Domain>:<PORT>/sap/public/bc/its/mimes/itsmobile/99/sounds/all/[Link]
OR
if you trace using HTTPWatch or review the View Source the file called for "Message Type W"
http(s)://<Host>.<Domain>:<PORT>/sap/public/bc/its/mimes/itsmobile/99/sounds/all/[Link]
For comparison when logged on via SAP GUI for WINDOWS (SAP Logon):
One will get sounds in SAP GUI for WINDOWS similar to those when called via the itsmobile01 service.
This is custom documentation. For more information, please visit SAP Help Portal. 17
7/7/25, 7:29 AM
need the corrections contained in the note 3013443 - ITSmobile Visual Editor: implemented the SoundInclude feature
Another workaround if the Browser does not support the <bgsound and *.wav files is the solution in the
You will still need to do the code changes to pass the various
Note
Other notes
The following is a very interesting blog (Jan 3, 2017) especially if you use the NEWER Browsers on your handheld device.
as the <bgsound> element is now obsolete with NEWER Browsers and is treated as a non-standard element.
[Link]
1. BGSOUND
2. IDA_BEEP.
This is custom documentation. For more information, please visit SAP Help Portal. 18
7/7/25, 7:29 AM
[Link]
Device Details:
Standard SAP ITSmobile communicates with http/s via a normal HTTP Post Event.
This classical HTTP communication allows only a synchronous data transfer and the
Browser takes care of the communication. (without the possibility to enhance it or change
it)
This is custom documentation. For more information, please visit SAP Help Portal. 19
7/7/25, 7:29 AM
In general AJAX means: Asynchronous JavaScript and XML, this means AJAX
communication is an asynchronous communication.
AJAX ITSMobile communication allows to send multiple requests to the server. In addition
it is possible to send the request
To understand the two different communication behaviors following scenarios are described:
User press a button on an ITSmobile webpage, browser sends the request to the server and will wait for a response from the
server.
During the waiting time (synchronous) user can do noting with the webpage/application. The application is not able to react in
case
Of issues or errors.
User press a button on an ITSmobile webpage , browser sends the request to the server (in details the application = ITSmobile
send the request)
and will wait for a response from the server. However the communication is asynchronous, means the application is not locked and
user can do other things.
First: As the communication is controlled in the own JavaScript Coding (ITSmobile application) the HTML DOM is replaced using
Javascript
BENEFIT: performance improvement, as the browser doesn’t created the full HTML DOM again and again (specially not the CSS
and JS content)
Own error message can be displayed or request can be send again automatically, if wireless communication doesn’t exist.
This is custom documentation. For more information, please visit SAP Help Portal. 20
7/7/25, 7:29 AM
What are the benefits as summery – when AJAX with ITSmobile makes sense?
The major benefits are the performance improvement and the control of the communication.
Therefore:
when in a project old devices are used with low memory and low hardware capabilities.
It makes sense to use ITSmobile runs AJAX when old hardware is used.
1. An industrial browser doesn have to be used when AJAX is used because the communication can be controlled
If a company uses many devices it makes sense to invest/modify Standard ITSmobile and enhance it with AJAX JavaScript.
Prerequisites
06_ITSMobileRunsAjax_englisch_v8 (3).pdf
What is the New ITSmobile Visual Editor? This page is part of:
ITSmobile
The ITSmobile Visual Editor is a part of ITSmobile. It introduces the following features:
o Allows to hide individual screen elements on resulting HTML page without the
need to change the underlying ABAP screen.
This is custom documentation. For more information, please visit SAP Help Portal. 21
7/7/25, 7:29 AM
There are four Steps to get a running ITSmobile Service from ABAP Screens.
In this example the transaction we are calling is the test transaction "ITMOBILE00"
and the service that we are creating is "TEST_MOBILE". Here are the steps to do this.
1.1
First call the transaction in question. In this case it is "ITMOBILE00" - then hit the
following in the following order: "CTRL + Shift +F1" and you will get the 'Technical
Information' popup
1.2
In this scenario it is called: SAPMIMOB1. Then select the folder 'Screens'. These are all
the corresponding screens for transaction ITMOBILE00
This is custom documentation. For more information, please visit SAP Help Portal. 22
7/7/25, 7:29 AM
1.3
Then call transaction SICF and create and activate the service name: TEST_MOBILE
with the below 'GUI Configuration'
2. Generate Editor-Templates.
This is custom documentation. For more information, please visit SAP Help Portal. 23
7/7/25, 7:29 AM
2.1 Call transaction SE80 and navigate to the step shown in Step 1.2. Select all the
Screens you wish to modify using the ITSMobile Visual Editor, then using right click
select the context menu item 'Other Functions' and then select 'Create Template from
Template'
2.2
Now enter the ITSMobile service in the resulting popup and define the folder theme
name. In our example the service is called 'TEST_MOBILE' and Theme '99'
This is custom documentation. For more information, please visit SAP Help Portal. 24
7/7/25, 7:29 AM
3.1 Return to the 'Internet Service': TEST_MOBILE in SE80. In the folder "Editor-
Templates" you will see all the screens from step 2.2 that have been created.
3.2
Double click on Editor template. 'SAPMIMOB1' then select the Edit icon(Pencil and
Glasses). You are now using the ITSMobile Visual Editor!
This is custom documentation. For more information, please visit SAP Help Portal. 25
7/7/25, 7:29 AM
4.1 Once you have carried out the modifications using the ITSMobile Visual Editor you
will need to create the HTML template.
From the Editor Templates use context menu "Other Functions"->"Create HTML
Template from (Editor) Templates.".
4.2
This is custom documentation. For more information, please visit SAP Help Portal. 26
7/7/25, 7:29 AM
Now in the "HTML templates" you will see the resulting HTML template will have been
updated.
Next publish the HTML templates, the ITSmobile service with the modifications using
the ITSMobile Visual Editor is now ready to run.
When you generate an HTML template from an editor template, the style MOBILEEDIT
is set in the comment section of the template.
Prerequisites
Release and Support Package with ITSmobile Visual Editor included:
This is custom documentation. For more information, please visit SAP Help Portal. 27
7/7/25, 7:29 AM
o 7.50 and higher
1872180
Kernel:
The editor uses the kernel-based JSON support. Therefore Kernel 7.20* or higher is
required.
*For systems with kernel 7.20 at least kernel patch 116 is required. (JSON-Support:
refer to SAP Note 1650141 )
Browser:
The ITSmobile Visual Editor was designed to work within SAP GUI's HTML Control
using Microsoft Internet Explorer (MSIE) as documented in SAP note 1872180
The HTML Control based on Chromium or Edge will be supported. See SAP Note
3191851 - ITSmobile Visual Editor with Edge Browser Control
For the time being, please configure SAP GUI to make use of the MSIE based HTML
control.
You can change the browser for the HTML Control in the SAP Logon Pad: SAP Logon
→ Options → Interaction Design → Control Setting .
NB: If you call the ITSmobile Visual Editor to process an editor template, and the editor
hangs and does not show the template in the graphical display,
then check the SAP Note 2570160 - ITSmobile Visual Editor: Determining best value
for wait time in communication between ABAP and ITSmobile Visual Editor.
This is custom documentation. For more information, please visit SAP Help Portal. 28
7/7/25, 7:29 AM
Use the CSS color codes to define colors of the screen elements.
The codes are defined using either hexadecimal color values (#00FF00) or RGB color values (rgb(0.255.0)). The value is a
combination of red, green and blue color. The lowest value is 0 (hex 00); the highest value is 255 (hex FF).
The third way to define a color is in using the actual color name (LimeGreen).
By searching for "css color" you will find plenty sources of css color tables.
The picture below shows a snippet of the ITSmobile Visual Editor with an example how a button can be defined.
Please note that shorthand properties can be used to set several properties at once in a single declaration.
This is custom documentation. For more information, please visit SAP Help Portal. 29
7/7/25, 7:29 AM
Example: Font Shorthand
in our example we used the order* given by the W3C and defined the following style: italic bold 18px/40px arial
Font-size and font-family are mandatory, the other values can by omit.
See the KBA 2768002 - ITSmobile: How to apply a different font for input fields
The note 2570160 is very important if the ITSMobile Visual Editor is not saving changes correctly when used within SE80
(ABAP Workbench)
ITSmobile Visual Editor runs in an HTMLviewer control of the SAP GUI for Windows
2017.
2570160 - ITSmobile Visual Editor: Determining best value for wait time in communication between ABAP and ITSmobile
Visual Editor
2527234 - ITSmobile Visual Editor: Steploop dimensions are not visualized correctly
2015
2051056 ITSmobile Visual Editor: User changes are not always saved correctly
2176355 ITSmobile Visual Editor: Switching templates during start results in error
2168990 ITSmobile Visual Editor: Alignment of element not recognized
2159730 ITSmobile Visual Editor: Editor supported in SAP GUI for Windows only
2141558 ITSmobile Visual Editor: Mass change of (sub-)screen sizes in editor templates
2136447 ITSmobile Visual Editor: First launch of editor after applying ABAP updates may fail
1873703 Improvements for the initialization of the graphical editor
2014
2051056 ITSmobile Visual Editor: User changes are not always saved correctly
2027612 Incorrect generation style in HTML template
2057020 ITSmobile Visual Editor: Adding or removing CSS properties is not possible
1927694 ITSmobile Visual Editor: "Adapt to screen" does not work
1903390 ITSmobile Visual Editor: Accelerated start, corrections
2005958 ITSmobile Visual Editor: Prerequisites for switching screens quickly
1818662 ITSmobile Visual Editor: Improvements and corrections
1876462 ITSmobile Visual Editor: Hide elements
This is custom documentation. For more information, please visit SAP Help Portal. 30
7/7/25, 7:29 AM
The ITSmobile framework does not attempt to identify the mobile devices using the
browser ID (user agent string). In fact, the browser identification is completely deactivated
for ITSmobile. It is possible that your generated HTML templates need additional
customization to run on a specific device or browser, this can easily done by a consultant.
To adapt device-specific functionality ( like i.e. function keys), ITSmobile provides a
procedure to include device-specific META tags or Javascripts.
Examples
If device-specific support is required, you can add the device-specific META tags or
JavaScripts using the following service entry in the HTML page:
~ITSMOBILEDEVICEINCLUDE <Name_of_the_template_to_be_included>
It is sufficient to set the service entry and to make the specified template available in the
service. The delivery of ITSmobile contains four testservices. Testservice ITSMOBILE01
contains the file [Link], where specific information can be included. In
addition to this you will find three examples of device-specific customization:
See Also
SAP Note
1311169
SAP Note
1093513
~ITSMOBILEDEVICEINCLUDE
This is custom documentation. For more information, please visit SAP Help Portal. 31
7/7/25, 7:29 AM
Motorola Rho Elements
Naurtech CE TERM
2. Application
To be able to generate templates, you require a functioning SAP Web AS ABAP application. The screen layout of the application
must be designed for mobile devices and their limited visualization functions. That means that the size of the screen must be
adjusted to the screen size of the mobile device and the application should use only screen elements that are supported by
ITSmobile
3. Basis Technology
On the system side, you require an ITS with at least the following service/patch status:
Integrated ITS
We recommed that you are on at least the following Support Pack levels
SAPKB62064
SAPKB64022
SAPKB70014
SAPKB71005
See also SAP NOTE 1031074 ITSmobile 1.1: Supplements and improvements
Standalone ITS
ITS 6.20 Patchlevel 27, SAP Basis 4.6C Support Package: 55 - SAPKB46C55
See also SAP NOTE 1031074 ITSmobile 1.1: Supplements and improvements
Please note...
The ITS prerequisites listed above is only the minimum on Support Package level to run the ITSmobile. Further developments and
improvements are always taking place. We suggest to install the latest BASIS and Kernel versions to ensure not to miss a new
feature or a great improvement.
In order to correctly work ITSmobile needs the following internet services to be published
ITSMOBILE
ITSGENMOBILE
ITSGENMOBILE4
ITSGENMOBILEXV
Publishing is done in transaction SE80. See the following Wiki for the steps to do this:
How to activate, publish and test ITS services in the integrated ITS
This is custom documentation. For more information, please visit SAP Help Portal. 32
7/7/25, 7:29 AM
This document only describes ITS service parameters that are either of particular interest
or essential to ITS mobile services. If a particular patch level is required for individual
parameters, this information is provided. Please note that there are also general ITS
parameters, such as 'sap-language', ~record, and ~urlmime that can also be set for mobile
applications.
KBA 2494749 - Add or edit ITS Services parameters in SICF - GUI configuration
[VIDEO], might be helpfull when editing Service Parameters in SICF.
1) Mandatory Parameters
~ITSMOBILE
~TRANSACTION
~THEME
~SOURCES
2) Unwanted parameters
~WEBGUI=1
3) Parameters for Include Control
~ITSMOBILEDEVICEINCLUDE
~ITSMOBILECSSINCLUDE
~ITSMOBILEJSINCLUDE
~ITSMOBILECUAINCLUDE
~ITSMOBILENOCUAINCLUDE
~ITSMOBILEVOICEINCLUDE
4) Parameters for Popup Control
~POPUPS
~SHOW_SYSTEM_MODAL
5) Additional Parameters
~ITSMOBILEMSGSOUND
~ITSMOBILESOUNDINCLUDE
~RESP_CONTENT_TYPE
~ALVGRIDPAGESIZE
~DYNPRO_COMPRESSION
~ITSMOBILENAMESPACE
~ITSMOBILEELEMFACTOR & ~ITSMOBILEELEMUNITS
~ITSMOBILEELEMFACTOR
~ITSMOBILEELEMUNITS
~ITSMOBILESEARCHHELPSHOWCUA
~ITSMOBILESEARCHHELPNOFILTER
~SEARCHHELPRESULTPERPAGE
~ITSMOBILESEARCHHELPPREV & ~ITSMOBILESEARCHHELPNEXT
~ITSMOBILESTANDARDSMODE
~NO_LOGON_USEREXIT
1) Mandatory Parameters
~ITSMOBILE
This is custom documentation. For more information, please visit SAP Help Portal. 33
7/7/25, 7:29 AM
The ~ITSMOBILE parameter is mandatory and must be set to 1 for all mobile services. The parameter specifies that the particular
service is for mobile devices and adjusts the ITS environment accordingly. This parameter switches off the ITS browser check and
deactivates the inclusion of the browser-specific Java script on the HTML pages.
Example: ~ITSMOBILE 1
~TRANSACTION
The ~TRANSACTION parameter defines the transaction to be started in the SAP system and thus determines the application to be
run in the Web Application Server. A template must be available in the service for every screen of this application that is called.
When the service is started using the URL, if the subsequent login is successful, the transaction itmobile01 is started.
~THEME
The ~THEME parameter defines the template set that is to be used to display the transaction. You determine which theme must be
specified when you generate the template. The generator saves the templates under the theme you specify. You must specify this
theme with ~THEME in the service so that the templates can be found.
Example: ~THEME 99
When searching the generated templates for the application, the system searches for the template with the matching
name/number in the current service under the HTML templates in folder 99.
~SOURCES
You use the ~SOURCES parameter to specify the services (separated by a comma) in which the templates are to be searched for.
This is useful for screens/templates that are called in different transactions. You consequently do not have to regenerate the
templates for these screens in every service. Instead, you simply specify the service in the ~SOURCES parameter in which the
templates were already generated. Please note that the switch ~SOURCES only applies to the HTML templates. The switch cannot
be used to influence the search order for MIME files (for example, JavaScript, style sheets, and GIFs). Since the runtime service
provides ITSMOBILE for individual system screens, this service should always be specified as the last service.
If a template is not found in the itsmobile01 service, the ITS searches the next service listed - in this example: itsmobile - for a
matching template.
2) Unwanted parameters
~WEBGUI=1
Setting the ~webgui parameter to value 1 tells the Internet Transaction Server to start a webgui (SAP GUI for HTML) service.
However ITSmobile services are NOT webgui services. So the ~webgui parameter should be completely removed or set with the
default value "0":
~WEBGUI=1
or
~WEBGUI=0
This is custom documentation. For more information, please visit SAP Help Portal. 34
7/7/25, 7:29 AM
3) Parameters for Include Control
The parameters for include control are used to be able to make changes to JavaScript, CSS style sheets, or for example, device-
specific function key mapping without having to make changes to the generated templates. By activating these switches, for
example, a separate style sheet can be inserted in all the generated templates without actually changing the generator or the
templates themselves. Please note that the inserted include files replace the default include files from the ITSMOBILE service.
Consequently, your inserted CSS file, for example, must, define all the classes that are defined in the [Link] default file of the
service ITSMOBILE. Your include files replace the standard include files.
~ITSMOBILEDEVICEINCLUDE
You use ~ITSMOBILEDEVICEINCLUDE to specify your own device include file in which, for example, the mapping of function keys
for a specific device is defined. The device include file is included on every HTML page in the <head> tag. Function keys are
normally mapped using http meta http-equiv instructions that call a specified JavaScript when a key code is entered. The device
include file is exactly the right place for these device/browser-specific instructions. The ITSMOBILE01 service can be used to
illustrate this.
The content of the devicesample file is included in the HTML <head> tag on every HTML page. The devicesample file must be
available in the relevant service as an HTML template.
~ITSMOBILECSSINCLUDE
You use ~ITSMOBILECSSINCLUDE to overwrite the default CSS style sheet of the [Link] file from the ITSMOBILE service. The
specified file must be stored in the SAP system in the current service under MIME objects and must be published. Since your own
CSS file replaces the default CSS style sheet, you must have defined all the CSS classes used by ITSmobile in your file. Therefore it
is recommended to copy the standard [Link] file and modify it.
The CSS file [Link] is included on every HTML page as a style sheet. The file extension .css is adapted and must not be
specified in the parameter. Use transaction SE80 in the SAP system to ensure that the file [Link] exists in the current
service and was published
See also:
~ITSMOBILEJSINCLUDE
You use ~ITSMOBILEJSINCLUDE to overwrite the default JavaScript file [Link] from the ITSMOBILE service. The specified file
must be stored in the SAP system in the current service under MIME objects and published. Since your own JS file replaces the
default JavaScript file, you must have defined all the JavaScript functions used by ITSmobile in your file so that no JavaScript
errors occur when the service is executed.
This is custom documentation. For more information, please visit SAP Help Portal. 35
7/7/25, 7:29 AM
The JS file [Link] is included on every HTML page as JavaScript. The file extension .js is adapted and must not be
specified in the parameter. Use transaction SE80 in the SAP system to ensure that the file [Link] exists in the current
service under MIME objects and was published.
See also:
~ITSMOBILECUAINCLUDE
You use ~ITSMOBILECUAINCLUDE to overwrite the CUA area of the HTML page. The default CUA area is at the top of the HTML
page and contains the display of the screen title and error messages, if applicable, and a GIF to trigger enter, a GIF to log off, and
the SAP icon. By specifying a CUA include file, you can independently configure this area without making any changes to the actual
template. When configuring the area, do not forget to display messages. To use the application, it is essential to display the
messages.
The content of your CUA file [Link] is included on every HTML page. The file extension .html is adapted and must not be
specified in the parameter. Use transaction SE80 in the SAP system to ensure that the file [Link] exists in the current
service under HTML templates and was published.
See also:
~ITSMOBILENOCUAINCLUDE
When the parameter is 1 or X, no CUA area will be rendered at the top of the HTML Page. The default CUA area is at the top of the
HTML page and contains the display of the screen title and error messages, if applicable, and a GIF to trigger enter, a GIF to log off,
and the SAP icon. Having no CUA area saves at least one full line (row), which some applications can appreciate very much.
Example: ~ITSMOBILENOCUAINCLUDE 1
OR
Example: ~ITSMOBILENOCUAINCLUDE X
~ITSMOBILEVOICEINCLUDE
You use ~ITSMOBILEVOICEINCLUDE to configure the generation of XHTML+Voice to meet your own requirements. Your voice
include file replaces the [Link] default file from the ITSMOBILE service. Your file must contain the BHTML functions
GenerateSpeech and GenerateSpeechDialog(FieldIndex), since these two functions are called from the main page to generate the
HTML for speech support.
To generate speech support, the functions GenerateSpeech and GenerateSpeechDialog(FieldIndex) are called in your
[Link] voice include page. The file extension .html is adapted and must not be specified in the parameter. Use transaction
SE80 in the SAP system to ensure that the file [Link] exists in the current service under HTML templates and was
published.
This is custom documentation. For more information, please visit SAP Help Portal. 36
7/7/25, 7:29 AM
In the default setting, the ITS displays neither popups nor system messages. If a popup or a system message is received, it is
automatically confirmed by ITS with ENTER and is not displayed. This setting makes sense in the majority of cases.
However, for applications that use popups, for example, when logging off ("Do you really want to log off? YES/NO") it may be
necessary to activate popups. Note that the popups can only be displayed as fullscreen images and that a template must be
available for every popup if the ITS does not provide a default template for the screen.
In addition to the application popups, system messages and express mails (transactions SM02 and SO01) can also be activated to
a limited extent for mobile services. This can make sense if you want to make important system messages (for example, update
task terminations) visible to the mobile user. Again, the messages can only be displayed in fullscreen mode and a template for the
screen must be provided if ITS does not provide a default template.
~POPUPS
You use ~POPUPS to activate the application popups for mobile services. If the switch is set to 1, popups are displayed. Please
note that you must provide an HTML template in your service for every application popup. With the default setting "0", ITS
automatically confirms popups with ENTER.
Example: ~POPUPS 1
~SHOW_SYSTEM_MODAL
With ~SHOW_SYSTEM_MODAL, you activate system messages and express mails (transactions SM02/SO01) for mobile services.
Please note that the system messages and express messages are displayed as fullscreen images and that a HTML template must
be available for the screen.
Example: ~ SHOW_SYSTEM_MODAL 1
For system messages and express mails, a short message is displayed as a fullscreen image to mobile users.
See also:
SAP Note:
5) Additional Parameters
~ITSMOBILEMSGSOUND
With ~ITSMOBILEMSGSOUND you can activate beeps for messages. If the parameter is set "the beep" is run with the
HTML tag "bgsound" if a message is received. The browser must support the HTML tag "bgsound" so that the beep can be
outputed.
Example: ~ITSMOBILEMSGSOUND 1
When a new message is received, an output "beep" is received according to the message type.
~ITSMOBILESOUNDINCLUDE
If ~ITSMOBILEMSGSOUND is set, than the HTML tag "bgsound" is used to make the device "beep". On some browsers the
"bgsound" HTML tag is not supported. In such cases the parameter ~ITSMOBILESOUNDINCLUDE can be used as described in
This is custom documentation. For more information, please visit SAP Help Portal. 37
7/7/25, 7:29 AM
SAP Notes 1719568 - ITSmobile: message sound code moved to a separate include and 3013443 - ITSmobile Visual Editor:
implemented the SoundInclude feature.
~RESP_CONTENT_TYPE
This parameter is only for mobile applications with Language issue requirements. The parameter sets the HTML response-type to
XHTML+Voice. The parameter must be set for all applications that have been generated with ITSMOBILEGENXV i.e
"Mobile devices with language support". All other applications must not set this parameter.
The HTML Response Type is set to xhtml so that the browser can interpret the response correctly. Browsers that have no language
assistance can react differently. Either the page without language assistance is displayed or the content is offered for download.
~ALVGRIDPAGESIZE
Defines how many lines per page are shown in the ALV table.
See also:
SAP Note 3019222 - ITSmobile: automatic page sizing for ALV Grid control
Parameter only relevant if you use ALV grid controls in your dynpro.
Example: ~ALVGRIDPAGESIZE 10
~DYNPRO_COMPRESSION
If you wish to remove lines containing no visible elements that are still visible on the screen then set ~DYNPRO_COMPRESSION
service parameter to the value of "1"
NB: This feature is only available with style MOBILE4 (Generation style ITSGENMOBILE4) and you also need to be on at the
following Support Pack listed in the SAP Note 1493374 - ITSmobile: new feature: dynpro compression.
Example: ~DYNPRO_COMPRESSION 1
See also:
SAP Note 3118444 - ITSmobile: fixed empty line height for DYNPRO_COMPRESSION feature.
~ITSMOBILENAMESPACE
This parameter is only needed when you are using an ITSmobile Services with a namspace e.g. "/AII/servicename",
"/SCWM/RFUI" etc As an ICF service name, cannot contain a "/" character it is not possible to create an ICF service with the same
name as the SE80 service which uses the namespace,which is required for ITSmobile to function correctly.
1323339 - ITSmobile: Services with a namspace, for further details and an example of how to use this parameter.
This is custom documentation. For more information, please visit SAP Help Portal. 38
7/7/25, 7:29 AM
You also need to be on the Support Pack mentioned in this note for this feature (one can also apply the SNOTE correction from
SAP note 1323339)
Using the following two parameters allows one to the increase the font size of individual elements, but without increasing
the other individual elements on the screen.
~ITSMOBILEELEMFACTOR
This parameter defines the factor (integer number) by which the width of visible elements will be multiplied.
~ITSMOBILEELEMUNITS
Example:
~ITSMOBILEELEMFACTOR 7
~ITSMOBILEELEMUNITS px
NB: This feature is only available with style MOBILE4 and you also need to be on at least the following Support Pack's outlined in
the SAP Note 1316326 - ITSmobile: HTML element size is independent of font size to have this feature.
~ITSMOBILESEARCHHELPSHOWCUA
The CUA Area can be enabled by setting the ~itsmobileSearchhelpShowCUA to"X" (default is OFF, i.e. CUA Area is not shown)
~ITSMOBILESEARCHHELPNOFILTER
The Filter Area can be disabled by setting the ~itsmobileSearchhelpNoFilter to"X" (default is ON, i.e. SearchHelp dialog offers a
possibility to filter/restrict the list of possible selection)
The advantage of setting this is to create more screen space for your ITSMobile service if it uses search help functionality
~SEARCHHELPRESULTPERPAGE
Defines the number of results that are returned in the result table.
See also:
~ITSMOBILESEARCHHELPPREV and ~ITSMOBILESEARCHHELPNEXT can be used to overwrite default labels of the 'Next' and
'Previous' buttons on a SearchHelp dialog. See SAP Note 1461464 - ITSmobile: improved SearchHelp dialog.
NB: You also need to be on at least the followingBasis Support Pack's and Kernel version's outlined in the SAP Note 1461464 -
ITSmobile: improved SearchHelp dialog
This is custom documentation. For more information, please visit SAP Help Portal. 39
7/7/25, 7:29 AM
to have these additional search help feature's.
~ITSMOBILESTANDARDSMODE
See aso:
SAP Note 2289261 - ITSmobile: fixed MOBILE4 generator not to switch to Standards mode
~NO_LOGON_USEREXIT
See also:
This is custom documentation. For more information, please visit SAP Help Portal. 40