SmartForms最全開發(fā)手冊---最全

1、1 引言1.1 目的及范圍 本文檔主要介紹Smarform使用方法?？蛇m用于ABAP開發(fā)人員，分析人員使用。-最全1.2 參考資料 SAP程序設(shè)計 1.3 文檔結(jié)構(gòu)文檔的各章節(jié)介紹的內(nèi)容如下：· 概述整個form的屬性及用法· 完整案例· 附注2 Smartform應(yīng)用及概述Smarform主要是SAP針對商業(yè)處理中固定格外文件批量打印的一種工具。主要分為Form、Style、Text module三個組成部分，此三個組成部分都可以被單獨創(chuàng)建和重復(fù)利用(T-CODE:SMARTFORMS),下面將分別講解三種工具的使用方法。3 上傳背景圖片輸入TCODE：SE78

2、: 選擇 Form GraphicsàStored on Document ServeràGraphics General GraphicsàBMAP Bitmap Images點擊 按鈕導(dǎo)入圖片圖片屬性,導(dǎo)入成功4 FORM創(chuàng)建4.1 創(chuàng)建界面輸入T-CODE:SMARTFORMS,進入以下界面，輸入Form名稱：ZHZP_SM_TEST，點擊Create進入編輯窗口：此窗口分為三個區(qū)域:左邊區(qū)域：包括全部變量，和樹形結(jié)構(gòu)的節(jié)點導(dǎo)航。當點擊相應(yīng)的節(jié)點時，中間區(qū)域?qū)@示該節(jié)點的屬性， 中間區(qū)域：維護各個節(jié)點的屬性等右邊區(qū)域：圖形化窗口繪制，可以手動調(diào)節(jié)節(jié)點分布位

3、置，實現(xiàn)節(jié)點在頁面的布局點擊保存并選擇PACKAGE和CR節(jié)點 全局設(shè)置 包含表格屬性, 表格接口, 全局定義表格屬性Form的基本屬性，包括創(chuàng)建信息和輸出參數(shù)表格接口包含F(xiàn)orm的標準參數(shù)和自定義參數(shù)，用于與調(diào)用程序交互全局定義定義用于整個Form的變量，類型，初始化，單位等Field按鈕控制Form中參數(shù)和系統(tǒng)變量的顯示4.2 節(jié)點介紹Form是由不同類型的節(jié)點組成。 一個Form包含了一個或者多個Page，第一個Page是Form執(zhí)行的的開始（當創(chuàng)建Form時，系統(tǒng)默認創(chuàng)建這個Page），下面將講解每個節(jié)點的功能及其包含的子節(jié)點，4.2.1 輸入?yún)^(qū)域節(jié)點類型描述可能包含的下級節(jié)點Page

4、（頁面）頁面Window,graphic,addressWindow（窗口）一個頁面的輸出區(qū)域：包含三種類型：Main window,Secondary window,Copies window,Final windowWindow是所有數(shù)據(jù)的輸出區(qū)域。你可以在Form Painter中設(shè)置它的大小和位置。Main Window 和Secondary Window。一個Form中只有一個Main Window，且在創(chuàng)建Form時系統(tǒng)默認已創(chuàng)建除page和window以外的所有節(jié)點此兩種節(jié)點創(chuàng)建FORM時，系統(tǒng)默認創(chuàng)建一個PAGE,和一個Main window4.2.2 不包含下級節(jié)點的節(jié)點節(jié)點

5、類型描述Text（文本）通過此節(jié)點可以打印除過地址外所有文本Graphic（圖形）通過此節(jié)點可以加入圖片Address（地址）通過此節(jié)點可以處理地址，當打印時，系統(tǒng)會直接讀取地址數(shù)據(jù)并格式化4.2.3 列表輸出節(jié)點類型描述可能包含的下級節(jié)點Template（模板）通過此節(jié)點打印固定數(shù)據(jù)表格除Page、Window、Template、TableTable（表格）通過此節(jié)點打印動態(tài)數(shù)據(jù)的表格創(chuàng)建此類型的節(jié)點，系統(tǒng)會自動創(chuàng)建三個節(jié)點：Header , Main Area and Footer。LOOP,FOLDER,TABEL節(jié)點可以備用Table line（表行）通過此節(jié)點打印Tableh或者Te

6、mplate中的一行Table cellTable cell（單元格）根據(jù)行類型打印單元格與Temlate共存Old table nodeRelease 6.10之前的功能，現(xiàn)在不能創(chuàng)建，只能修改已存在的與Temlate共存4.2.4 邏輯空控制節(jié)點節(jié)點類型描述可能包含的下級節(jié)點Command（命令）通過此節(jié)點執(zhí)行特殊的命令（下一頁、段落、打印機控制）Loop（循環(huán)）通過 此節(jié)點重復(fù)處理它包含的子節(jié)點除Page和Window所有節(jié)點Alterantive（可選的）設(shè)置條件，分支選擇系統(tǒng)默認兩個節(jié)點：True和False.他們下面可以包含除Page和Window所有的節(jié)點4.2.5 其他節(jié)點Fo

7、lder（文件夾）通過此節(jié)點可以實現(xiàn)邏輯單元的封裝除Page和Window所有節(jié)點Program lines（程序行）通過此節(jié)點執(zhí)行ABAP語句所有節(jié)點共同的選項General Attributes（一般屬性）節(jié)點的描述或者內(nèi)容Output Options（輸出選項）位置、樣式、方框、陰影等屬性，還有其他的一些輸出屬性Conditons（條件）如果條件為真，顯示節(jié)點4.3 創(chuàng)建模板：Template節(jié)點用于創(chuàng)建文檔中的靜態(tài)表格，即在打印前已經(jīng)確認了行數(shù)。如果打印的行數(shù)不確定，需要用Table節(jié)點或者Loop循環(huán)Template輸出，以下為創(chuàng)建過程：鼠標右鍵->創(chuàng)建->模板點擊創(chuàng)建后

8、出現(xiàn)模板的屬性設(shè)置界面，有三個頁簽：頁簽功能描述Templage（模板）設(shè)置陰影、邊框和行類型Output Options（輸出選項）打印時的樣式、邊框、陰影等Conditons（條件）條件滿足則執(zhí)行此節(jié)點及其下級節(jié)點這里最重要的是行類型的設(shè)置，它代表了表格中一行數(shù)據(jù)的樣式（比如多少個單元格，每個單元格長度寬度,邊框等），可以設(shè)置設(shè)置不同的行類型。點擊修改筆可以直接在白色編輯區(qū)域直接畫，也可以點擊細節(jié)直接輸入數(shù)據(jù)。點擊細節(jié)畫面.注意字段“參考“是引用另一行樣式設(shè)置，則不需要再重新設(shè)置樣式：系統(tǒng)提供了很多打印樣式，可以選擇，也可以自己設(shè)置樣式，具體設(shè)置詳見下一章節(jié)介紹。條件頁簽：此節(jié)點執(zhí)行條件：

9、只有滿足了設(shè)置了條件，才能執(zhí)行此節(jié)點及它包含下一節(jié)點的內(nèi)容額外屬性：設(shè)置的事件將會執(zhí)行4.4 創(chuàng)建文件夾鼠標右鍵->創(chuàng)建->文件夾有兩個頁簽，功能同創(chuàng)建模板的一樣4.5 創(chuàng)建文本Text輸出文本，有四種類型，一般情況下選擇E或者M類型即可類型功能描述備注D Dynamic Type（動態(tài)文本）此種類型在Netweaver7.0中沒有介紹E Text Element（文本元素）創(chuàng)建新的文本支持靜態(tài)和動態(tài)I Include Text（包含文本）引用SAPscript Texts M Text Module（文本模板）引用Text Module鼠標右鍵->創(chuàng)建->文

10、本有四個頁簽，其中“輸出選項"和”條件“同以上兩種節(jié)點。針對文本節(jié)點，在輸出選項需要特殊處理：設(shè)置行與列的位置，可參考在模板中設(shè)置的行類型。詳見下圖設(shè)置 文本類型 類型為 文本元素;可以直接輸入要顯示/打印的內(nèi)容，如Airline,也可以動態(tài)數(shù)據(jù)輸出，則需要點擊“添加“按鈕注意：字段前后需要增加符號“&“ 4.6 執(zhí)行SMARTFORMSForm創(chuàng)建成功并激活后，系統(tǒng)自動生成一個FM.執(zhí)行FM可以預(yù)覽結(jié)果并打印。手動執(zhí)行此FM或者程序調(diào)用這個FM實現(xiàn)執(zhí)行Form的功能。程序調(diào)用將在案例中講解，此處講解執(zhí)行執(zhí)行FM.F8或者點擊執(zhí)行按鈕生成的FM:執(zhí)行FM，可以選擇打印機，并提

11、供打印預(yù)覽和直接打印的功能4.7 創(chuàng)建smartforms 樣式Smartforms的樣式主要就是定義一些字體, 顏色，字體大小 一些對齊方式什么的,然后段落的格式,首先輸入TCODE:smartforms進入創(chuàng)建smartforms的界面。如圖：點擊創(chuàng)建之后進入樣式創(chuàng)建界面樣式中分三部分,表頭,段落,字符,我們可以針對自己想要的樣式來定義一些,然后用與smartforms中,三部分的解釋如下：頁簽功能描述備注表頭數(shù)據(jù)表頭數(shù)據(jù)，包括標準配置和管理創(chuàng)建時系統(tǒng)默認顯示此頁簽段落格式段落格式，可以段落設(shè)置字符格式字符格式，可以字體設(shè)置4.7.1 創(chuàng)建表頭數(shù)據(jù)創(chuàng)建Style時系統(tǒng)默認顯示配置表頭數(shù)據(jù)頁

12、簽功能描述備注標準設(shè)置標準設(shè)置，可以針對字體，默認標準段落，及預(yù)覽效果其中標準字段需要設(shè)置下面創(chuàng)建的段落格式，否則不能激活管理管理信息，主要顯示誰創(chuàng)建什么時間創(chuàng)建然后創(chuàng)建段落的格式有左對齊，右對齊，居中的完后需要回到表頭數(shù)據(jù)中把標準段落填上，不然無法激活點擊保存,激活,這樣樣式就是初步完成,后面根據(jù)samrtforms中的應(yīng)用情況做想應(yīng)得調(diào)整.5 文本模塊創(chuàng)建文本模塊作為Form中節(jié)點文本一個類型，維護了它，則可以多個Form共同使用，提供Form創(chuàng)建的效率。兩個頁簽組成：頁簽功能描述備注文本輸出文本管理樣式選擇，翻譯（國際化）及創(chuàng)建信息同 創(chuàng)建文本一樣，可以動態(tài)和靜態(tài)類型6 案例6.1 案例

13、描述以下是客戶預(yù)訂航班清單，要求只有第一頁有表頭。我們將依次案例創(chuàng)建Form。航空公司航班航班日期客戶預(yù)定日期票價AA00172011.08.31000037292011.06.09 803,58. .輸入Tcode：SMARTFORMS,創(chuàng)建Form: zhzp_sm_test系統(tǒng)默認生成Page和Window進入維護界面：6.2 設(shè)置背景圖片在PAGE1中可以設(shè)置背景圖片6.3 創(chuàng)建接口參數(shù)I_CARRID，I_CONNID，I_FLDATE，I_FLAG為查詢條件：航空公司，航班，日期,輸出方式標識如果有要輸出的數(shù)據(jù)可以在EXPORT中定義，如輸出或輸入有表格則可以通過Tables定義，

14、這里我們只定義四個個查詢輸入?yún)?shù)，取數(shù)邏輯由于簡單就放到smartforms中來實現(xiàn)了。6.4 創(chuàng)建全局變量全局變量GT_SBOOK用于保存預(yù)訂的航班清單,GW_SBOOK用于循環(huán)處理時工作區(qū)。GV_TABIX用于流程控制，后面將講到。6.5 創(chuàng)建節(jié)點程序行：此處寫代碼獲取要打印的航班清單。當然，要打印的數(shù)據(jù)可通過接口傳，這里只是為了演示節(jié)點的創(chuàng)建過程。輸入?yún)?shù)，輸出參數(shù)，代碼段6.6 創(chuàng)建節(jié)點可選條件這里創(chuàng)建這個節(jié)點是用于碰到打印輸出是以表格還是模板6.7 TURE節(jié)點下創(chuàng)建節(jié)點循環(huán)循環(huán)處理航班清單6.8 循環(huán)下創(chuàng)建節(jié)點程序行：用于實現(xiàn)第一頁有表頭的條件判斷。6.9 創(chuàng)建節(jié)點模板（Templ

15、ate）此節(jié)點需要創(chuàng)建在Loop下。并設(shè)置每行的樣式，可以設(shè)置很多不同的，這里我們簡單設(shè)置一種6.10 模板下創(chuàng)建可選擇節(jié)點條件設(shè)置：只有第一行才執(zhí)行打印表頭6.11 創(chuàng)建文本在可選的節(jié)點的True節(jié)點中創(chuàng)建,此處將創(chuàng)建表頭False中創(chuàng)建內(nèi)容另外還有一點比較重要就是行列的設(shè)置6.12 最終的節(jié)點分布6.13 創(chuàng)建表格(table)節(jié)點這類型的創(chuàng)建,我們講解的時候再創(chuàng)建.6.14 程序調(diào)用FormFM: SSF_FUNCTION_MODULE_NAME獲取Form生成的FM,動態(tài)調(diào)用此FM代碼如下：REPORT  zhzp_call_sm_sbook.DATA: 

16、 lv_fm_name TYPE rs38l_fnam.DATA: control_parameters TYPE ssfctrlop.DATA: output_options     TYPE ssfcompop.PARAMETERS:  p_carrid   TYPE s_carr_id,  p_connid   TYPE s_conn_id,

17、  p_fldate   TYPE s_date,  p_flag     TYPE flag DEFAULT 'X'.control_parameters-no_dialog = 'X'.control_parameters-preview = 'X'.output_options-tddest = 'LONP'

18、.*獲取Form生成的FMCALL FUNCTION 'SSF_FUNCTION_MODULE_NAME'  EXPORTING    formname           = 'ZHZP_SM_TEST' "Form的名稱  IMPORTING    fm_name 

19、0;          = lv_fm_name  EXCEPTIONS    no_form            = 1    no_function_module = 2    OTHERS&#

20、160;            = 3.IF sy-subrc <> 0.  MESSAGE 'The Form is not exit'  TYPE 'E'.ENDIF.*執(zhí)行Form生成的FM進行打印CALL FUNCTION lv_fm_name  

21、EXPORTING   control_parameters = control_parameters   output_options     = output_options    user_settings      = space    i_carrid    

22、       = p_carrid    i_connid           = p_connid    i_fldate           = p_fldate   

23、; i_flag             = p_flag  EXCEPTIONS    formatting_error   = 1    internal_error     = 2    send_error     &