Define Form 

Use

You define a form for a specific internal service request scenario. This form is later called up and filled out by the person entering the request.

Prerequisites

  1. In Customizing under Cross Application Components ® Internet-/Intranet Services ® Internal Service Request ® Scenario Definition ® Define Scenario, you defined a scenario.
    For more information on the scenario, see
    Definition of A Scenario.

You define special fields for the request in Customizing for scenarios. You can use the following characteristic categories for this:

You can evaluate characteristics on the HTML template under the name specified there.
The only exceptions are characteristics with reference to a structure. In this case, the structure fields can be used with their names (without the prefix of <structure name> or similar names) in the HTML template. This means that structures are continuously broken down for the request and can, therefore, be seen as a more compact definition instead of a selection of single characteristics that refer to data elements.

In all three cases, the characteristic description is available as a field label in the HTML template as well as the name and the characteristic content.
For the categorized characteristics, the field length is also available. In addition, the input/output format is executed for characteristics that refer to data elements or structure fields, in the same way as for screen fields.

Uncategorized characteristics have the implicit CHAR250 category without input/output conversion.

The following restrictions apply to the definition of scenario characteristics:

  1. You have generated and published an ITS service.
    For more information on generating an ITS service, see:
    Generating Services.

Process Flow

An Internet service for an internal service request has the following components:

You can process Internet services in the SAP@Web-Studio, or in the Web Application Builder (access from Customizing for scenarios). However, compared with the Web Application Builder, the SAP@Web-Studio has several advantages (syntax check, an editor that is easy to use, clearer management for each of the components and several Internet services at the same time, and improved help functions). You can also switch between tools during processing. You can use the source control in the SAP@Web-Studio to check Internet services in and out of the SAP@Web-Studio.

For more information on adaptation tools, see the SAP Library under:

Service Parameters

In an Internet service, you need the following parameters for an internal service request:

Parameter

Value

SCENARIO

Scenario name

~TRANSACTION

QISR1

~WEBTRANSACTIONTYPE

EWT

~GENERATEDYNPRO

1

~STYLE

DHTML

~AUTOSCROLL

0

~LISTSCROLLING

0

~POPUPS

1

   

HTML Templates

When you start the internal service request, you call up the QISR1 transaction in the SAP System (SAPLQISR3 program). This goes to one of the following screens, regardless of processing mode: For each of these subscreen containers, you can define your own HTML template to generate the corresponding HTML form:

Mode

Screen

HTML Templates

CREATE

110

saplqisr3_110.html

CHANGE

120

saplqisr3_120.html

DISPLAY

130

saplqisr3_130.html

 

All HTML templates should be assigned to Default-Theme 99. You can leave out the HTML template for processing modes that you do not require.

If you do not require any variants for the request for the different processing modes, define the HTML template for the display mode. You can enter the following HTML business statement for all other HTML templates:

`include(~theme="99", ~language="", ~name="saplqisr3_110.html")`

This statement ensures that for each HTML template, the saplqisr3_110.html HTML template for the create mode is referenced.
In the HTML template for creating, if you use the functions from the ISR-HTML library (for SAP Design) or from the ISR-Plain-HTML-Library (for Plain HTML), then the entry fields are automatically switched to Not ready for input depending on the processing mode.

Definition Of An HTML Template For The ISR

The simplest HTML template contains the HTML code for displaying the request in the web browser. You can embed the HTML business statement into the HTML template for a dynamic HTML page layout.
For more information on HTMLBusiness, see the SAP@Web-Studio or the Web Application Builder under Application Help. You can use HTML business to create HTML statements under certain circumstances for example (if ( ... ) ... else ... end;) or in loops (for ... ;). In the HTML template, the following generally applies:

You can also refer to data from the SAP R/3 System in the HTML template, using HTML business. For example, the

`BUILDING_TO`

statement means that the BUILDING_TO characteristic is output in the HTML page that was created using the template.

As well as the special characteristics defined in Customizing for scenarios, you can use the following general data from the internal service request in the HTML template.

Name

Description

Name in BADIs

ISR_HEADER-NOTIF_NO

Notification number

GENERAL_DATA -NOTIF_NO

ISR_HEADER-NOTIF_TYPE

Notification type

GENERAL_DATA-NOTIF_TYPE

ISR_HEADER-SCENARIO

Scenario

GENERAL_DATA-SCENARIO

ISR_HEADER-CREATION_DATE

Creation date

GENERAL_DATA-CREATION_DATE

ISR_HEADER-CREATION_TIME

Creation time

GENERAL_DATA-CREATION_TIME

ISR_HEADER-CALC_COSTS

Calculated costs

GENERAL_DATA-CALC_COSTS

ISR_HEADER-CALC_COSTS_CURR

Currency key for CALC_COSTS

GENERAL_DATA-CALC_COSTS_CURR

ISR_HEADER-LANGUAGE

Language

GENERAL_DATA-LANGUAGE

ISR_HEADER-START_DATE

Start date

GENERAL_DATA-START_DATE

ISR_HEADER-START_TIME

Start time

GENERAL_DATA-START_TIME

ISR_HEADER-REQ_DATE

Required date

GENERAL_DATA-REQ_DATE

ISR_HEADER-REQ_TIME

Required time

GENERAL_DATA-REQ_TIME

ISR_HEADER-PRIORITY

Priority

GENERAL_DATA-PRIORITY

ISR_PAGE

Current page number

PAGE

ISR_HEADER-EXT_REF_NUMBER

External reference number

GENERAL_DATA-EXT_REF_NUMBER

ISR_HEADER-SHORT_TEXT

Short text

GENERAL_DATA-SHORT_TEXT

ISR_HEADER-ESTIM_COSTS

Estimated costs

GENERAL_DATA-ESTIM_COSTS

ISR_HEADER-ESTIM_COSTS_CURR

Currency key for ESTIM_COSTS

GENERAL_DATA-ESTIM_COSTS_CURR

ISR_MODE

Current mode (CREATE, DISPLAY, and so on)

MODE

     

ISR_FORM_VIEW

View

Default:
ISR_REQUEST
If processor calls the form for the message:
ISR_PROCESS

ISR_CREATED_BY-USER_ID

Created by: User name

ISR_GENERAL_DATA-CREATED_BY-USER_ID

ISR_CREATED_BY-FIRSTNAME

Created by: First name

ISR_GENERAL_DATA-CREATED_BY-FIRSTNAME

ISR_CREATED_BY-LASTNAME

Created by: Last name

ISR_GENERAL_DATA-CREATED_BY-LASTNAME

ISR_CREATED_BY-FULLNAME

Created by: Full name

ISR_GENERAL_DATA-CREATED_BY-FULLNAME

ISR_CREATED_BY-TITLE

Created by: Title

ISR_GENERAL_DATA-CREATED_BY-TITLE

ISR_CREATED_BY-DEPARTMENT

Created by: Department

ISR_GENERAL_DATA-CREATED_BY-DEPARTMENT

ISR_CREATED_BY-BUILDING

Created by: Building

ISR_GENERAL_DATA-CREATED_BY-BUILDING

ISR_CREATED_BY-FLOOR

Created by: Floor

ISR_GENERAL_DATA-CREATED_BY-FLOOR

ISR_CREATED_BY-ROOM_NO

Created by: Room number

ISR_GENERAL_DATA-CREATED_BY-ROOM_NO

ISR_CREATED_BY-E_MAIL

Created by: eMail address

ISR_GENERAL_DATA-CREATED_BY-E_MAIL

ISR_CREATED_BY-TEL_NUMBER

Created by: Telephone

ISR_GENERAL_DATA-CREATED_BY-TEL_NUMBER

ISR_CREATED_BY-TEL_EXTENSION

Created by: Telephone extension

ISR_GENERAL_DATA-CREATED_BY-TEL_EXTENSION

ISR_CREATED_BY-FAX_NUMBER

Created by: Fax

ISR_GENERAL_DATA-CREATED_BY-FAX_NUMBER

ISR_CREATED_BY-FAX_EXTENSION

Created by: Fax extension

ISR_GENERAL_DATA-CREATED_BY-FAX_EXTENSION

ISR_CREATED_BY-COMPANY

Created by: Company

ISR_GENERAL_DATA-CREATED_BY-COMPANY

ISR_CREATED_BY-MASTER_CCTR

Created by: Master cost center

ISR_GENERAL_DATA- CREATED_BY-MASTER_CCTR

ISR_CREATED_BY-MASTER_COAREA

Created by: Master controlling area

ISR_GENERAL_DATA- CREATED_BY-MASTER_COAREA

     

ISR_INITIATED_BY- …

Person placing request

ISR_GENERAL_DATA-INITIATED_BY- …

ISR_APPROVED_BY- …

Person approving request

ISR_GENERAL_DATA-APPROVED_BY- …

ISR_PROCESSOR- …

Person processing request

ISR_GENERAL_DATA-PROCESSOR- …

ISR_CONTACT_PERSON- …

Contact person for scenario

ISR_GENERAL_DATA-CONTACT_PERSON- …

 

The following functions are available in the SAP General HTML-Business-Functions Library to enable you to create the most important form elements (buttons, fields, labels etc.) quickly and easily:

To make the creation of HTML templates for internal service requests even easier, there is an extension of the SAP General HTML-Business-Functions Library for internal service requests. You include this library in HTML templates using the following statement:

`include(~service="sr_library", ~theme="99", ~language="",
~name="ISR_Template_Library.html")`

If you use this library, you can automatically use the functions of the SAP General HTML-Business-Functions Library.

See also:

Example of Specific Form Elements in HTML Templates (SAPDesign)

To make it easier to create Plain-HTML-Templates, you can use the following statement to include a library in your template:

`include(~service="sr_library", ~theme="99", ~language="",
~name="ISR_Template_Library_Plain_HTML.html")`

See also:

Example: Specific Form Elements in HTML Templates (Plain HTML)