Smartform的简单应用

以下例子引用自baoning的BLOG

用到DDIC 表SFLIGHT

Smart Form 相对SAP Script来说，系统给封装了很多功能，这样用户在Form中的代码写的少了一些，更容易维护，如果把SAP Script比作汇编语言的话，Smart Form可以算上C++了，不过个人感觉对于复杂表单的设计来说，用SAP Script更容易实现。在Smart Form中调整表格边线比较费劲。

1. Create a Form named 'ZBSUNTEST'
用TCode: SMARTFORMS创建一个空白的Form。双击左边树状结构中的'Global Setting'->'Form Attributes'。在里头可以看到纸张的设置，默认是A4。这里还可以调正一页中可以打印多少行。

2. Form Interface
我们生成一个Form的同时，系统也创建了一个相应的function module。Form与Application的数据交换就是通过function的interface来实现的。双击左边树状结构中的'Global Setting'->'Form Interface'，我们可以看到，这和我们在SE37中看到的function module的接口是一样的。点击'Table'这个tab，输入如下：

3. Global Definition这里定义的是在form中共用的全局变量，还可以定义subroutine。是form初始化的时候调用的一个routine，可以在这里做一些data初始化的工作。 用来设置货币或者数量的单位关联用的。
下面是'Global Data'里头的定义：

上图中的T_SUM类型是我在'Types'里头定义的，其中PRICE, CURRENCY是用来做sum用的：

TYPES:
BEGIN OF T_SUM,
PRICE TYPE S_PRICE,
CURRENCY TYPE S_CURRCODE,
END OF T_SUM.

下面是Currecy & Quantity的单位关联设置。这样关联之后Price会按照Currency的不同，输出格式也不同：

4. Create a Style named 'Z_BSUN_TITEL01'
回过头我们要创建一个给这个Form使用的Style。还是用SMARTFORMS这个TCode来创建。在这个Styel里头我只创建了'Paragrah Format'，真正的项目中'Character Format'肯定也是不可缺少的。这个Style使用在Step 1 中创建的Form所有的Output Option中。

M1: Aligned:left;Indent->left margin:0.20 CM;font family: Arial;font size: 12pt
M2: Aligned:right;Indent->right margin:0.20 CM;font family: Arial;font size: 11pt
M3: Aligned:right;Indent->right margin:0.20 CM;font family: Arial;font size: 12pt;font color:blue
T1: Aligned:center;font family: Arial;font size: 14pt;font style: Bold Italic

5.Creat a Page named 'FIRSTPG'
在下创建一个名为'FIRSTPG'的page，并把它的next page设置为其本身。Page Format设置为'Portrait Format'。

6.Create Windows under 'FIRSTPG'

Windows的Position and Size如下(单位都是CM)：

HEADER: L2.60, U0.20, W14.70, H2.00
MAIN: L2.00, U2.00, W16.00, H25.00
FOOTER: L2.60, U27.20, W14.70, H2.00

7. Create Header's Text
在'HEADER' Window node下面创建一个Text，取名'TITLE'。Text type设置成'Text Element'。再PC Editor中点 输入。T1就是在Step 3里头定义的Paragraph Format。

8. Create a table in 'MAIN' Window在'MAIN' Window node下面创建一个Table，. Table下面自带了三个node: header, main area, footer，颜色跟别的由用户创建的node有区别。其中Table的header node下面我们可以放表头。Table的footer node跟我们在Step 6创建的FOOTER Window有区别。FOOTER Window的位置是固定的，Table的footer是Table的line在哪里结束，它就紧跟在后面。 文章开头的打印结果中我们可以很直观的看到这两个的区别：FOOTER Window在每页的最下面（打印了两次，尽管内容不一样），Table footer在第二页中间只打印了一次。当然我们说的都是默认的情况。

9. Insert program line 'CODE_CLEAR' before 'MAIN' Window

Input Parameters: G_TAB_DATA;
Output Parameters: G_REC_TOTAL, G_TAB_TOTAL, G_ITEMS_ONPAGE;

REFRESH: G_TAB_TOTAL, G_TAB_SUBTOTAL.
CLEAR: G_REC_TOTAL, G_REC_SUBTOTAL, G_ITEMS, G_ITEMS_ONPAGE.
DESCRIBE TABLE G_TAB_DATA LINES G_ITEMS. "Get total item number

Programe Line中使用到的全局变量必须在Input/Output中定义，否则check不通过。

10. Create some line types in Table 'FLIGHTINFO'Line Type是控制表格格式的，每一个Table Line都要指定一个Line Type

Layout如下图，注意这些Line的border是框了线的

11. 'DATA' of Table 'FLIGHTINFO'

G_TAB_DATA是Step 2在Form Interface定义的一个内部表，也就是从Application传过来准备给Form显示的数据。我们还想让显示的数据排一下序，当然这可以在外部程序中SORT，不过这里的排序还有触发event的作用，后面会讲到。如果内部表已经排好序了，只是想触发类似LOOP的AT NEW/AT END OF这样的功能，那么把这个勾上就好。下面是SORT的设置，我们对CARRID(Airline),CONNID(Flight No.)排序，并且要触发两个events，用来做subtotal统计。

12. 'Calculation' of Table 'FLIGHTINFO'
是用来对Table的Fields做简单计算的，包括'Number', 'Total', 'Mean Value'。如果不是涉及到货币或者数量的统计我们可以用'Total'这个Operation，具体使用可以参考help。我这里用了'Number'做一个每页的Items统计，'Number'也可以用来做行号。

13. Insert a title in table header
在Table 'FLIGHTINFO'的header node下增加table line ：HEADER_LINE。LINE TYPE选'Line1'。tablbe line自动带出5个cell，cell的数目是根据LINE TYPE :'Line1'来的，Step 10里头可以看到Line1是有5个cell的。我们在每一个cell下面添加一个Text，作为colum title，把paragraph format设置成M1。不过'Price'这个Column因为是数字，paragraph format设置成M3

P.S.Table自带的header的Output Option->Print Time有两个选项

at start of Table就不说了，不过at Page Break工作不正常，第2页并没有打印出来title，也不知道是不是我写的问题。

14. Insert table line into table main area
Main Area是显示Application传进来的内部表的地方，和Step 13一样增加一个Line Type=LINE1的Table Line，每个Cell下各增加一个Text，属性设置成'Text Element'。

点PC Editor的，编辑Text内容，以CARRID为例：

15. Insert a Program Line Under 'DATA_LINES'
CURRENCY_DATA下的Programe Line: SUM，是为了做合计用的，按照Currecy的不同将Price合计。（当然单价Price的合计没什么实际意义，权当是演示）

Input Parameters: G_REC_DATA, G_TAB_SUBTOTAL;
Output Parameters: G_REC_TOTAL, G_TAB_TOTAL;

G_REC_TOTAL-PRICE = G_REC_DATA-PRICE.
G_REC_TOTAL-CURRENCY = G_REC_DATA-CURRENCY.
COLLECT G_REC_TOTAL INTO G_TAB_TOTAL.
COLLECT G_REC_TOTAL INTO G_TAB_SUBTOTAL.
CLEAR: G_REC_TOTAL.

内部表'G_TAB_TOTAL','G_TAB_SUBTOTAL'保存的是合计和根据'Airline'进行小计的数据。

16. Print 'Grand Total' in table footer
在table的footer node下增加一个loop node， 。
Loop的DATA如下：

因为我只想在所有的记录打印结束之后显示总计，所以给这个loop增加一个condition。在Condition Tab里的Output Condition中增加一行：

G_ITEMS_ONPAGE在Step 12中被赋值Number, G_ITEM在Step 9被赋值内部表中的记录数，当这两个值相等的时候也就是记录输出完毕的时候。再给loop node下一级增加一行table line，LINE TYPE : LINE3

GRANDTOTAL: M2 -> 'Grand total:'
PRICESUM_TAB: M2 -> &G_REC_TOTAL-PRICE&
CURR_TAB: M2->&G_REC_TOTAL-CURRENCY&

17. Print subtotal in table (1)
我们在Step 10里头的Sort中勾选了CARRID字段的两个事件之后就能够发现table node 自动增加了两个节点：

首先在'CARRID Event on Sort Begin'下一级增加一个Program Line:SUB_CLEAR，用来在CARRID改变的时候清空subtotal内部表。

Output Parameters: G_REC_SUBTOTAL;

CLEAR: G_REC_SUBTOTAL.
REFRESH: G_TAB_SUBTOTAL.

然后在'CARRID Event on Sort End'下一级增加一个Program Line:CLEAR_SUBTITLE，用来清空一个打印标志。

Output Parameters: G_FLG_SUBTITLE;

CLEAR: G_FLG_SUBTITLE.

每一个CARRID(Airline)下面可能会有多种不同的货币价格，这个标志的作用是为了限制下面的'Subtotal of &G_REC_SUBTOTAL-CARRID& is'这句话在小计的时候不至于print出来很多遍。

18. Print subtotal in table (2)
在'CARRID Event on Sort End'下一级增加一个Loop:PRINTSUBTOTAL:

Loop:PRINTSUBTOTAL:下一级增加一个table line:SUBTOTAL，LINE TYPE : LINE3

AIRLINE_NAME: M2 -> 'Subtotal of&G_REC_DATA-CARRID& is'
SUB_PRICE: M2 -> &G_REC_SUBTOTAL-PRICE&
SUB_CURR: M2->&G_REC_SUBTOTAL-CURRENCY&

其中AIRLINE_NAME是有显示条件的：G_FLG_SUBTITLE没有赋值的时候才显示。

AIRLINE_NAME print出来之后我们在Program Line 'SET_SUBTITLE'中将G_FLG_SUBTITLE设置为'X'。

Output Parameters: G_FLG_SUBTITLE;

G_FLG_SUBTITLE = 'X'.

19. Print 'Grand Total' in page footer在FOOTER Window的下一级添加一个Table Line: FTTABLE, Line Type:

DATA:

然后，在FTTABLE的Main Area下增加一行Table Line: PRICESUM, Line Type: LINE1

为了控制在最后一页的页脚打印出来金额合计，要给PRICESUM增加一个条件。在Conditions Tab里头的
And Additional Event中勾选'Only after end of main window'。'SUM'和'CURR'这两个Text的设置如下：

SUM: M2 -> &G_REC_TOTAL-PRICE&
CURR: M2->&G_REC_TOTAL-CURRENCY&

最后，在FTTABLE的Footer下增加一行Table Line: FOOTER, Line Type: LINE1

ITEMS: M2 -> ITEMS IN THIS PAGE:&G_ITEMS_ONPAGE(3)&
PAGE: M2->PAGE:&SFSY-PAGE&

20. Calling a Smart Form from Application生成smart form的同时系统会自动创建一个对应的funtion module，这个function的名字可以通过菜单Enviroment->Function Module Name得到。在程序中一般通过function 'SSF_FUNCTION_MODULE_NAME'来得到。下面是我们的测试这个smart form的代码：

*&---------------------------------------------------------------------*
*& Report Z_SUN_SFORM
*&
*&---------------------------------------------------------------------*

REPORT Z_SUN_SFORM NO STANDARD PAGE HEADING LINE-SIZE 150 MESSAGE-ID ZBSUN.
************************************************************************
* D E C L A R A T I O N O F I N T E R N A L T A B L E S
************************************************************************
DATA:
G_TAB_OUTPUT TYPE STANDARD TABLE OF SFLIGHT.

************************************************************************
* D E C L A R A T I O N O F V A R I A B L E S
************************************************************************
DATA:
G_REC_OUTPUT TYPE SFLIGHT,
G_REC_OPTIONS LIKE ITCPO,
G_REC_RESULT TYPE ITCPP.
************************************************************************
* D E C L A R A T I O N O F C O N S T A N T S
************************************************************************
CONSTANTS:
G_CON_FLG_ON TYPE C VALUE 'X',
G_CON_FORMNAME(8) TYPE C VALUE 'ZBSUN_01'.

************************************************************************
* S E L E C T I O N S C R E E N
************************************************************************
SELECTION-SCREEN BEGIN OF BLOCK BLOCK1 WITH FRAME.
SELECT-OPTIONS S_LINE FOR G_REC_OUTPUT-CARRID NO INTERVALS.
SELECT-OPTIONS S_DATE FOR G_REC_OUTPUT-FLDATE.
SELECTION-SCREEN END OF BLOCK BLOCK1.

************************************************************************
* S T A R T - O F - S E L E C T I O N
************************************************************************
START-OF-SELECTION.
PERFORM FRM_GET_DATA.

************************************************************************
* E N D - O F - S E L E C T I O N
************************************************************************
END-OF-SELECTION.
PERFORM FRM_OUTPUT.

*&---------------------------------------------------------------------*
*& Form FRM_GET_DATA
*&---------------------------------------------------------------------*
* GET FLIGHT DATA
*----------------------------------------------------------------------*
FORM FRM_GET_DATA .
SELECT *
INTO TABLE G_TAB_OUTPUT
FROM SFLIGHT
WHERE CARRID IN S_LINE
AND FLDATE IN S_DATE.
IF SY-SUBRC <> 0.
MESSAGE E000.
* No data selected.
ENDIF.
ENDFORM. " FRM_GET_DATA
*&---------------------------------------------------------------------*
*& Form FRM_OUTPUT
*&---------------------------------------------------------------------*
* OUTPUT DATA
*----------------------------------------------------------------------*
FORM FRM_OUTPUT.
DATA: FM_NAME TYPE RS38L_FNAM.
CALL FUNCTION 'SSF_FUNCTION_MODULE_NAME'
EXPORTING
FORMNAME = 'ZBSUNTEST'
* VARIANT = ' '
* DIRECT_CALL = ' '
IMPORTING
FM_NAME = FM_NAME
* EXCEPTIONS
* NO_FORM = 1
* NO_FUNCTION_MODULE = 2
* OTHERS = 3
.
IF SY-SUBRC <> 0.
* MESSAGE ID SY-MSGID TYPE SY-MSGTY NUMBER SY-MSGNO
* WITH SY-MSGV1 SY-MSGV2 SY-MSGV3 SY-MSGV4.
ENDIF.

CALL FUNCTION fm_name
* EXPORTING
* ARCHIVE_INDEX =
* ARCHIVE_PARAMETERS =
* CONTROL_PARAMETERS =
* MAIL_APPL_OBJ =
* MAIL_RECIPIENT =
* MAIL_SENDER =
* OUTPUT_OPTIONS =
* USER_SETTINGS = 'X'
* IMPORTING
* DOCUMENT_OUTPUT_INFO =
* JOB_OUTPUT_INFO =
* JOB_OUTPUT_OPTIONS =
TABLES
G_TAB_DATA = G_TAB_OUTPUT
EXCEPTIONS
FORMATTING_ERROR = 1
INTERNAL_ERROR = 2
SEND_ERROR = 3
USER_CANCELED = 4
OTHERS = 5.

IF SY-SUBRC <> 0.
*
ENDIF.

ENDFORM. " FRM_OUTPUT

以下步骤没有用到的node还有Command, lternative,Graphic,Complex Section等。其中Command主要用来插入分页或者打印控制语句的；Alternative用来插入一个逻辑分支；Graphic插入图片的；Complex Section复合操作时用到

[@more@]

来自 “ ITPUB博客 ” ，链接：http://blog.itpub.net/588201/viewspace-918115/，如需转载，请注明出处，否则将追究法律责任。

转载于:http://blog.itpub.net/588201/viewspace-918115/