Smart Forms

Smart Forms - Pre-requisite

Pre-requisite

SAPScript

Smart Forms - Overview

Create/maintain

forms for mass printing

Replaces SAPScript
SAPScript will also be supported
Create forms in half the time
No programming knowledge required
XML output for Web
Graphical User Interface
3

Smart Forms - Features

Simple modifications without any programming knowledge
Data retrieval and form logic separated
ABAP program implements data retrieval
Smart Form implements form logic

Smart Form generates a function module upon activation

Data retrieval program passes data through function module parameters
Graphical Design tools
Graphical Form Painter
- Represents form logic in a tree structure

Graphical Table Painter

- Static and dynamic tables
- Sorting, headings, subtotals

XML output used for Web

Graphics can be included as background/on any part of the form

Architecture

ABAP program

SQL statements

CALLS

Function module

Document

ACTIVATE
HEADER
ADDRESS

LOGO
INFO

MAIN
FOOTER

Database tables

SMART FORM

DATA RETRIEVAL

FORM LOGIC

SAP Smart Forms - Transaction: smartforms

Form Builder

Navigation tree

Maintenance Screen

Form Painter
7

Global settings
Form Attributes
General Attributes
Created by/date/time
Changed by/date/time
Development class/language
Output options
Page format, Chars per inch, lines per inch, Style
XSF output (XML output)
Form interface
[Data passed from ABAP program -> function module -> Smart form using these]
Import, Export, Tables, Exceptions parameters
Global definitions
[Global Data/Routine declaration for the form logic]
Global data, Types, Field symbols, Initialization, Form routines
8

Pages & Windows

The default page & window provided for a new Smart Form:

DEFAULT PAGE: %PAGE1 (New page)

DEFAULT WINDOW: MAIN (Main window)

Navigating to the attributes of a page/window

Double-click the element whose attributes are to be changed/viewed
The attributes/definition of the element appears in the Maintenance Screen
To change the name of %PAGE1
Double-click in %PAGE1
Its definition is shown in the Maintenance Screen
Change the Page name

10

Page definition
General attributes
Next page
Page counter
Format (Arabic numeral, Roman Caps, Roman Lowercase, Alphabets Caps, Alphabets Lowercase)
Mode (Initialize counter, Increase counter, Leave counter unchanged, Page and overall page unchanged)

Output options
Print attributes
Page format (Portrait, Landscape)
Resource name, Print mode

Background picture
Name, Object, ID & BMON(Black & White), BCOL (Color), BMON BCOL (Dynamically determined)
Output attributes
Resolution (in DPI)
Output mode (Print preview, Print preview and print)
Position
Horizontal (Left, Centered, Right)
Vertical (Top, Centered, Bottom)

11

Working with pages

[Following operations can be done by

right-clicking on a page or from Edit menu]
Normal operations with tree node
Cut, Copy, Paste, Delete page
Expand, Collapse element list under a
page

Creating elements
Page - Creating more pages
Window - Creating windows in the
selected page
Graphic - Embedding graphic in the
selected page
Address - Including address in the
selected page given an address number or
person number

12

Window definition
General attributes
Main window (Tells whether this is a main window or not)

Output options
Position and size (Left margin, Upper margin, Width, Height)
Box and shading
Line (Width, Vertical spacing, horizontal spacing)
Shading (Gray value)
Always draw box and shading (Draw box and shading even if window is empty)

Conditions
Output conditions (Field name, Relational operator, Comparison value)
Additional event
Only on first page
Not on first page
only after end of main window
only before end of main window
only on page <pagename>
only at page break
only at paragraph beginning
only at paragraph end

13

Working with windows

[Following operations can be done by
right-clicking on a page or from Edit menu]
Normal operations with tree node
Cut, Copy, Paste, Delete page
Expand, Collapse element list under a
page

Creating elements
Windows - Creating more windows in the
same page
Graphic - Embedding graphic in the
selected window
Address - Including address in the
selected window given an address number
or person number
Text - Text element/Text module/Include
text
Alternative - Branching depending on
condition
Command - Executes special commands
(next page, paragraph numbering, printer
control)
14

Working with windows [Contd.]

[Following operations can be done by

right-clicking on a page or from Edit menu]
Creating elements [Contd.]
Program lines - Executes ABAP program
code like conversion routines
Folder - Logical grouping of nodes
Loop - Repeated processing of
successor nodes
Table - Outputs table containing
application data
Template - Outputs table containing static
data such as table headings
Complex section - Combines all node
types like folder, table, template, loop.

15

Creating windows, graphic, address

Click here and draw an area in the form painter to create windows, graphic, address

Navigation tree

Maintenance Screen

Form Painter
16

Node type: Graphic

Graphic can be included as background graphic or as a part of the page such as
company logo or as a part of a window
Background graphic
Set background graphic in the Background picture tab of the page
As a part of the page
Name, Object, ID & BMON(Black & White), BCOL (Color), BMON BCOL
(Dynamically determined)
Output attributes
Resolution (in DPI)
Output mode (Print preview, Print preview and print)
Position
Horizontal (Left, Centered, Right)
Vertical (Top, Centered, Bottom)
As a part of a window
All attributes are same as above except that Horizontal positioning can be made
with reference to window or last paragraph.

17

Node type: Address

Address can be included as a part of the page or as a part of a window
As a part of the page
Type (Organization address, Personal address, Workplace address,
Determine dynamically)
Number (Address number, person number)
Additional address specifications
Paragraph format
Number of lines to be used
Sending country
If PO box and street exists, which one to be used
Output attributes
Style
Position and size (Left margin, Upper margin, Width, Height)
Box and shading
Line (Width, Vertical spacing, horizontal spacing)
Shading (Gray value)

18

Node type: Address

Conditions

Output conditions (Field name, Relational operator, Comparison value)

Additional event
Only on first page
Not on first page
only after end of main window
only before end of main window
only on page <pagename>
only at page break
only at paragraph beginning
only at paragraph end
As a part of a window
All attributes are same as above except that there is an additional option for Page
protection

19

Node type: Text

Displays all text in a form
Types:
Text

element
Enter a new text in PC Editor
Text modules
Include a text module
Include text
Include existing SAP Script text
Text node: [Positioning of the text in the form]
New paragraph
New line
Append directly

Type the text and

click save

20

Node type: Text - Text element

Use PC Editor to enter text
PC Editor: With basic text editing options along with Paragraph and Character
formats
Fields like &WA_SFLIGHT-CONNID& can be included by
Directly typing in the PC Editor
Dragging and dropping from Field list
[Field list can be enabled by clicking
button on Application toolbar (OR) by
selecting Field list on/off from Utilities menu
Field list includes
Import interface, Export interface, Tables defined in Form interface
Global data defined in Global definitions ]

21

Field list

Type the text and

click save

22

Node type: Text - Text modules

Select text module to be included

Options to include text modules:

Refer to text module
Reference to the text module is made.
Text appears in read-only form in PC Editor.
Text included while printing the form
Copy text module
Text from text module copied and an editable text element
created
Always copy style from text: Use this option to override style in current
Smart form with that from the original text module

23

Node type: Text - Include text

Select standard text module to be included

This is similar to the INCLUDE statement in SAP Script

They are texts of object TEXT and ID ST
Maintain these texts through SO10
If the text key of the include text is incorrect (not found in the system),
an error message is issued.
No error if no text exists - Use this option to suppress the error
message.
Format paragraphs:
Standard paragraph - Format for standard paragraph format (*)
First paragraph - Format of first paragraph

24

Node type - Alternative

General Attributes/Conditions
Node/Output conditions (Field name, Relational
operator, Comparison value)

Additional event
Only on first page
Not on first page
only after end of main window
only before end of main window
only on page <pagename>
only at page break
only at paragraph beginning
only at paragraph end
Output attributes
Style
Page protection option
Box and shading
Line (Width, Vertical spacing, horizontal
spacing)
Shading (Gray value)

25

Node type - Alternative - Events: TRUE, FALSE

Output attributes
Style

Page protection option

Box and shading
Line (Width, Vertical spacing, horizontal
spacing)
Shading (Gray value)

Sub-ordinate node types for TRUE and

FALSE events [basically any other node]

Graphic

Address
Text
Alternative
Command
Program lines
Folder
Loop
Table
Template
Complex section
26

Node type - Command

General attributes
Go to new page <pagename>

Reset paragraph numbering (B: Paragraph

justified, L: Paragraph left-aligned)
Include printer control
Spool attributes (Field name, value)

Conditions
Output conditions (Field name, Relational operator,
Comparison value)

Additional event
Only on first page

Not on first page

only after end of main window
only before end of main window
only on page <pagename>
only at page break
only at paragraph beginning
only at paragraph end

27

Node type - Program lines

28

Node type - Program lines

Apart from the common attribute Conditions,
Input parameters
Output parameters
PC Editor for editing the code
Can be used to insert program lines at appropriate places for total/sub-total calculation.
Apart from the common editor features, the following are available

Syntax check

Statement constructor

Pretty printer

29

Node type - Folder

When the form is real complex, there will be many nodes and form would not be clear.
To avoid this, combine related nodes under a folder.
Folder has:
Events
Header (Output event: at
start of paragraph/at page
break)
Footer with height <heigth>
(Output event: at page break/
at end of paragraph)
Output options
As with other node types
Conditions
As with other node types
Any node type can be a subordinate node to LOOP

30

Node type - Loop

Use LOOP to read processor successor nodes repeatedly [For example, read lines
of an internal table
LOOP node has
Data
LOOP
Internal table <inttable> into <workarea>
Line x to y
WHERE condition <Fieldname> <Operator> <Comparisonvalue>
SORT criteria (already sorted, <fieldname> <asc/desc>
<Beginofcontrollevel> <EndofControllevel> )
Events
As with Folder
Output options
As with other node types
Conditions
As with other node types
Any node type can be a sub-ordinate node to LOOP

31

Node type - Loop

32

Node type - Table

To display contents of internal table passed from data retrieval program
TABLE node has
Table [Table display attributes]
Table width
Horizontal alignment
Line type definition (Line type, Default, No page break, Column
width & Unit of measure for each column)
Table pattern
Data - As in LOOP
Events - As in LOOP
Output options - As in LOOP
Conditions - As in LOOP

33

Node type - Table

34

Node type - Table - Unframed Table Patterns

35

Node type - Table - Framed Table Patterns

36

Node type - Table - Table Painter

Graphical User Interface to

Drawing lines and columns
Inserting, cutting, copying, and
deleting lines
Deleting cells
Changing cell size and moving
cell separator lines
Splitting cells Selecting table
patterns

37

Node type - Template

To display a static table of data whose size and layout is known before runtime. For

example, to print table heading for an internal table

TEMPLATE has
Template [template display attributes] similar to Table display attributes.
Table Painter can be used to graphical design the layout
Output options
As with other node types
Condition
As with other node types

38

Node type - Template

39

Node type - Complex section

Can be

Folder
Template
Table
Loop
Has
General attributes to define its type
Events
As with LOOP/TABLE
Output options
As with other node types
Conditions
As with other node types

40

Node type - Complex section

41

Print Program of Smart Forms

In the data retrieval program define a variable of type rs281_fnam for the name
of the generated function module:
data fm_name type rs38l_fnam.

Call function module SSF_FUNCTION_MODULE_NAME. It returns the name

of the generated function module:

CALL FUNCTION 'SSF_FUNCTION_MODULE_NAME'

EXPORTING
FORMNAME = '<form name>'
IMPORTING
FM_NAME = fm_name
EXCEPTIONS
NO_FORM = 1
NO_FUNCTION_MODULE = 2
OTHERS = 3.
42

Print Program of Smart Forms

Call the generated function

module. Use Pattern of
ABAP Editor for calling
function module to avoid
having to copy all interface
parameters manually. Then
replace the function module
name with the variable
fm_name.
In this example, three
variables and an internal
table are passed. The
parameters G_CARRID,
G_CONNID, G_FLDATA,
and GT_SBOOK have been
defined before in the form
interface. In the interface
pass all data you want to
transfer to the form.

43

THANK YOU

44