Smartform應(yīng)用_開發(fā)手冊V10

1、1.1SMARTFORMS 應(yīng)用開發(fā)手冊修改記錄制定日期生效日期制定 /修訂內(nèi)容摘要頁數(shù)版本擬稿審查批準(zhǔn)25 / 261 引言1.1 目的及范圍本文檔主要介紹Smarform使用方法?？蛇m用于ABAP開發(fā)人員，分析人員使用。1.2 參考資料 SAP程序設(shè)計(jì) 1.3 文檔結(jié)構(gòu)文檔的各章節(jié)介紹的內(nèi)容如下：· 概述整個(gè)form的屬性及用法· 完整案例· 附注2 Smartform應(yīng)用及概述Smarform主要是SAP針對商業(yè)處理中固定格外文件批量打印的一種工具。主要分為Form、Style、Text module三個(gè)組成部分，此三個(gè)組成部分都可以被單獨(dú)創(chuàng)建和重復(fù)利用(T

2、-CODE:SMARTFORMS),下面將分別講解三種工具的使用方法。3 上傳背景圖片輸入TCODE：SE78: 選擇 Form GraphicsàStored on Document ServeràGraphics General GraphicsàBMAP Bitmap Images點(diǎn)擊 按鈕導(dǎo)入圖片圖片屬性,導(dǎo)入成功4 FORM創(chuàng)建4.1 創(chuàng)建界面輸入T-CODE:SMARTFORMS,進(jìn)入以下界面，輸入Form名稱：ZHZP_SM_TEST，點(diǎn)擊Create進(jìn)入編輯窗口：此窗口分為三個(gè)區(qū)域:左邊區(qū)域：包括全部變量，和樹形結(jié)構(gòu)的節(jié)點(diǎn)導(dǎo)航。當(dāng)點(diǎn)擊相應(yīng)的節(jié)點(diǎn)時(shí)，

3、中間區(qū)域?qū)@示該節(jié)點(diǎn)的屬性， 中間區(qū)域：維護(hù)各個(gè)節(jié)點(diǎn)的屬性等右邊區(qū)域：圖形化窗口繪制，可以手動(dòng)調(diào)節(jié)節(jié)點(diǎn)分布位置，實(shí)現(xiàn)節(jié)點(diǎn)在頁面的布局點(diǎn)擊保存并選擇PACKAGE和CR節(jié)點(diǎn) 全局設(shè)置 包含表格屬性, 表格接口, 全局定義表格屬性Form的基本屬性，包括創(chuàng)建信息和輸出參數(shù)表格接口包含F(xiàn)orm的標(biāo)準(zhǔn)參數(shù)和自定義參數(shù)，用于與調(diào)用程序交互全局定義定義用于整個(gè)Form的變量，類型，初始化，單位等Field按鈕控制Form中參數(shù)和系統(tǒng)變量的顯示4.2 節(jié)點(diǎn)介紹Form是由不同類型的節(jié)點(diǎn)組成。 一個(gè)Form包含了一個(gè)或者多個(gè)Page，第一個(gè)Page是Form執(zhí)行的的開始（當(dāng)創(chuàng)建Form時(shí)，系統(tǒng)默認(rèn)創(chuàng)建這個(gè)P

4、age），下面將講解每個(gè)節(jié)點(diǎn)的功能及其包含的子節(jié)點(diǎn)，4.2.1 輸入?yún)^(qū)域節(jié)點(diǎn)類型描述可能包含的下級節(jié)點(diǎn)Page（頁面）頁面Window,graphic,addressWindow（窗口）一個(gè)頁面的輸出區(qū)域：包含三種類型：Main window,Secondary window,Copies window,Final windowWindow是所有數(shù)據(jù)的輸出區(qū)域。你可以在Form Painter中設(shè)置它的大小和位置。Main Window 和Secondary Window。一個(gè)Form中只有一個(gè)Main Window，且在創(chuàng)建Form時(shí)系統(tǒng)默認(rèn)已創(chuàng)建除page和window以外的所有節(jié)點(diǎn)此兩種

5、節(jié)點(diǎn)創(chuàng)建FORM時(shí)，系統(tǒng)默認(rèn)創(chuàng)建一個(gè)PAGE,和一個(gè)Main window4.2.2 不包含下級節(jié)點(diǎn)的節(jié)點(diǎn)節(jié)點(diǎn)類型描述Text（文本）通過此節(jié)點(diǎn)可以打印除過地址外所有文本Graphic（圖形）通過此節(jié)點(diǎn)可以加入圖片Address（地址）通過此節(jié)點(diǎn)可以處理地址，當(dāng)打印時(shí)，系統(tǒng)會直接讀取地址數(shù)據(jù)并格式化4.2.3 列表輸出節(jié)點(diǎn)類型描述可能包含的下級節(jié)點(diǎn)Template（模板）通過此節(jié)點(diǎn)打印固定數(shù)據(jù)表格除Page、Window、Template、TableTable（表格）通過此節(jié)點(diǎn)打印動(dòng)態(tài)數(shù)據(jù)的表格創(chuàng)建此類型的節(jié)點(diǎn)，系統(tǒng)會自動(dòng)創(chuàng)建三個(gè)節(jié)點(diǎn)：Header , Main Area and Footer

6、。LOOP,FOLDER,TABEL節(jié)點(diǎn)可以備用Table line（表行）通過此節(jié)點(diǎn)打印Tableh或者Template中的一行Table cellTable cell（單元格）根據(jù)行類型打印單元格與Temlate共存Old table nodeRelease 6.10之前的功能，現(xiàn)在不能創(chuàng)建，只能修改已存在的與Temlate共存4.2.4 邏輯空控制節(jié)點(diǎn)節(jié)點(diǎn)類型描述可能包含的下級節(jié)點(diǎn)Command（命令）通過此節(jié)點(diǎn)執(zhí)行特殊的命令（下一頁、段落、打印機(jī)控制）Loop（循環(huán)）通過 此節(jié)點(diǎn)重復(fù)處理它包含的子節(jié)點(diǎn)除Page和Window所有節(jié)點(diǎn)Alterantive（可選的）設(shè)置條件，分支選擇系統(tǒng)

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

8、ble節(jié)點(diǎn)或者Loop循環(huán)Template輸出，以下為創(chuàng)建過程：鼠標(biāo)右鍵->創(chuàng)建->模板點(diǎn)擊創(chuàng)建后出現(xiàn)模板的屬性設(shè)置界面，有三個(gè)頁簽：頁簽功能描述Templage（模板）設(shè)置陰影、邊框和行類型Output Options（輸出選項(xiàng)）打印時(shí)的樣式、邊框、陰影等Conditons（條件）條件滿足則執(zhí)行此節(jié)點(diǎn)及其下級節(jié)點(diǎn)這里最重要的是行類型的設(shè)置，它代表了表格中一行數(shù)據(jù)的樣式（比如多少個(gè)單元格，每個(gè)單元格長度寬度,邊框等），可以設(shè)置設(shè)置不同的行類型。點(diǎn)擊修改筆可以直接在白色編輯區(qū)域直接畫，也可以點(diǎn)擊細(xì)節(jié)直接輸入數(shù)據(jù)。點(diǎn)擊細(xì)節(jié)畫面.注意字段“參考“是引用另一行樣式設(shè)置，則不需要再重新設(shè)置樣

9、式：系統(tǒng)提供了很多打印樣式，可以選擇，也可以自己設(shè)置樣式，具體設(shè)置詳見下一章節(jié)介紹。條件頁簽：此節(jié)點(diǎn)執(zhí)行條件：只有滿足了設(shè)置了條件，才能執(zhí)行此節(jié)點(diǎn)及它包含下一節(jié)點(diǎn)的內(nèi)容額外屬性：設(shè)置的事件將會執(zhí)行4.4 創(chuàng)建文件夾鼠標(biāo)右鍵->創(chuàng)建->文件夾有兩個(gè)頁簽，功能同創(chuàng)建模板的一樣4.5 創(chuàng)建文本Text輸出文本，有四種類型，一般情況下選擇E或者M(jìn)類型即可類型功能描述備注D Dynamic Type（動(dòng)態(tài)文本）此種類型在Netweaver7.0中沒有介紹E Text Element（文本元素）創(chuàng)建新的文本支持靜態(tài)和動(dòng)態(tài)I Include Text（包含文本）引用SAPscript Texts

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

11、。程序調(diào)用將在案例中講解，此處講解執(zhí)行執(zhí)行FM.F8或者點(diǎn)擊執(zhí)行按鈕生成的FM:執(zhí)行FM，可以選擇打印機(jī)，并提供打印預(yù)覽和直接打印的功能4.7 創(chuàng)建smartforms 樣式Smartforms的樣式主要就是定義一些字體, 顏色，字體大小 一些對齊方式什么的,然后段落的格式,首先輸入TCODE:smartforms進(jìn)入創(chuàng)建smartforms的界面。如圖：點(diǎn)擊創(chuàng)建之后進(jìn)入樣式創(chuàng)建界面樣式中分三部分,表頭,段落,字符,我們可以針對自己想要的樣式來定義一些,然后用與smartforms中,三部分的解釋如下：頁簽功能描述備注表頭數(shù)據(jù)表頭數(shù)據(jù)，包括標(biāo)準(zhǔn)配置和管理創(chuàng)建時(shí)系統(tǒng)默認(rèn)顯示此頁簽段落格式段落格式

12、，可以段落設(shè)置字符格式字符格式，可以字體設(shè)置4.7.1 創(chuàng)建表頭數(shù)據(jù)創(chuàng)建Style時(shí)系統(tǒng)默認(rèn)顯示配置表頭數(shù)據(jù)頁簽功能描述備注標(biāo)準(zhǔn)設(shè)置標(biāo)準(zhǔn)設(shè)置，可以針對字體，默認(rèn)標(biāo)準(zhǔn)段落，及預(yù)覽效果其中標(biāo)準(zhǔn)字段需要設(shè)置下面創(chuàng)建的段落格式，否則不能激活管理管理信息，主要顯示誰創(chuàng)建什么時(shí)間創(chuàng)建然后創(chuàng)建段落的格式有左對齊，右對齊，居中的完后需要回到表頭數(shù)據(jù)中把標(biāo)準(zhǔn)段落填上，不然無法激活點(diǎn)擊保存,激活,這樣樣式就是初步完成,后面根據(jù)samrtforms中的應(yīng)用情況做想應(yīng)得調(diào)整.5 文本模塊創(chuàng)建文本模塊作為Form中節(jié)點(diǎn)文本一個(gè)類型，維護(hù)了它，則可以多個(gè)Form共同使用，提供Form創(chuàng)建的效率。兩個(gè)頁簽組成：頁簽功能描述

13、備注文本輸出文本管理樣式選擇，翻譯（國際化）及創(chuàng)建信息同 創(chuàng)建文本一樣，可以動(dòng)態(tài)和靜態(tài)類型6 案例6.1 案例描述以下是客戶預(yù)訂航班清單，要求只有第一頁有表頭。我們將依次案例創(chuàng)建Form。航空公司航班航班日期客戶預(yù)定日期票價(jià)AA00172011.08.31000037292011.06.09 803,58. .輸入Tcode：SMARTFORMS,創(chuàng)建Form: zhzp_sm_test系統(tǒng)默認(rèn)生成Page和Window進(jìn)入維護(hù)界面：6.2 設(shè)置背景圖片在PAGE1中可以設(shè)置背景圖片6.3 創(chuàng)建接口參數(shù)I_CARRID，I_CONNID，I_FLDATE，I_FLAG為查詢條件：航空公司，航班

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

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

16、FM代碼如下：REPORT  zhzp_call_sm_sbook.DATA:  lv_fm_name TYPE rs38l_fnam.DATA: control_parameters TYPE ssfctrlop.DATA: output_options     TYPE ssfcompop.PARAMETERS:  p_carrid   TYPE s_carr_id,

17、60; p_connid   TYPE s_conn_id,  p_fldate   TYPE s_date,  p_flag     TYPE flag DEFAULT 'X'.control_parameters-no_dialog = 'X'.control_parameters-preview = '

18、X'.output_options-tddest = 'LONP'.*獲取Form生成的FMCALL FUNCTION 'SSF_FUNCTION_MODULE_NAME'  EXPORTING    formname           = 'ZHZP_SM_TEST' "Form的名稱 &

19、#160;IMPORTING    fm_name            = lv_fm_name  EXCEPTIONS    no_form            = 1    no_functi

20、on_module = 2    OTHERS             = 3.IF sy-subrc <> 0.  MESSAGE 'The Form is not exit'  TYPE 'E'.ENDIF.*執(zhí)行Form

21、生成的FM進(jìn)行打印CALL FUNCTION lv_fm_name  EXPORTING   control_parameters = control_parameters   output_options     = output_options    user_settings      = space&

22、#160;   i_carrid           = p_carrid    i_connid           = p_connid    i_fldate       &

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