SmartForms最全开发手册---最全

1、1引言1.1 目的及范围本文档主要介绍Smaform使用方法。可适用于ABA叫发人员，分析人员使用。-最全1.2 参考资料SAP程序设计1.3 文档结构文档的各章节介绍的内容如下：?概述整个form的属性及用法?完整案例?附注2Smartform应用及概述Smarform主要就是SAP针对商业处理中固定格外文件批量打印的一种工具。主要分为Form、Style、Textmodule三个组成部分，此三个组成部分都可以被单独创建与重复利用(T-CODE:SMARTFORMS)f面将分别讲解三种工具的使用方法。3上传背景图片输入TCODE:SE78:选择FormGraphicsStoredonDocu

2、mentServerGraphicsGeneralGraphicsBMAPBitmapImages点击按钮导入图片图片属性，导入成功4FORM创建4.1创建界面输入T-CODE:SMARTFORMS人以下界面，输入Form名称:ZHZP_SM_TEST/点击Create进入编辑窗口"意哥兴百般史罩*在用嚣.势gT_中.拒Nj西faro.+.tiTt'，白邮Q-日效罚也翻如上添:不片匚I7.U1L1I33二至一：卧I1BFjnjais%1月即若属InBSPFeihjilthr;二”产一理隹星.是用朗坡刊科蚊金四聊看的看相访J阮融航局fonTnin.tff,中间区域将会显示该节点

3、的属性此窗口分为三个区域左边区域：包括全部变量，与树形结构的节点导航。当点击相应的节点时中间区域：维护各个节点的属性等右边区域：图形化窗口绘制，可以手动调节节点分布位置，实现节点在页面的布局点击保存并选择PACKAGECR节点全局设置包含表格属性，表格接口，全局定义表格属性Form的基本属性，包括创建信息与输出参数表格接口包含Form的标准参数与自te义参数，用于与调用程序交互全局定义定义用于整个Form的变量，类型，初始化，单位等Field按钮控制Form中参数与系统变量的显示au占11咕住H口讪口科“皿.日"日寸IE后怛陋月叫号心注的画"I利&争SM_TE：ST

4、由Liir近i.斥昌STiMPZH日MnH寸问mr司位班购FEIW4.2 节点介绍Form就是由不同类型的节点组成。一个Form包含了一个或者多个Page,第一个Page就是Form执行的的开始（当创建Form时，系统默认创建这个Page）,下面将讲解每个节点的功能及其包含的子节点，4.2.1 输入区域节点类型描述可能包含的下级节点Page（贝卸）贝卸Window,graphic,addressWindow（窗口）一个贝卸的输出区域：包含三种类型：Mainwindow,Secondarywindow,Copieswindow,FinalwindowWindow就是所有数据的输出区域。您可以在F

5、ormPainter中设置它的大小与位置。MainWindow与SecondaryWindow。一个Form中只有一个MainWindow,且在创建Form时系统默认已创建除page与window以外的所有节点此两种节点创建FORM,系统默认创建一个PAGE与一个Mainwindow4.2.2 不包含下级节点的节点节点类型描述Text（文本）通过此节点可以打印除过地址外所有文本Graphic（图形）通过此节点可以加入图片Address（地址）通过此节点可以处理地址，当打印时，系统会直接读取地址数据并格式化4.2.3 列表输出节点类型描述可能包含的下级节点Template（模板）通过此节点打印固

6、定数据表格除Page、Window、Template、TableTable（表格）通过此节点打印动态数据的表格创建此类型的节点，系统会自动创建三个节点:Header,MainAreaandFooter。LOOP,FOLDER,TABE节点可以备用Tableline（表行）通过此节点打印Tableh或者Template中的一行TablecellTablecell（单元格）根据行类型打印单元格与Temlate共存OldtablenodeRelease6、10之前的功能，现在不能创建，只能修改已存在的与Temlate共存4.2.4 逻辑空控制节点节点类型描述可能包含的下级节点Command命令）通过

7、此节点执行特殊的命令（下一页、段落、打印机控制）Loop（循环）通过此节点重复处理它包含的子节点除Page与Window所有节点Alterantive（可选的）设置条件，分支选择系统默认两个节点：True与False、她们卜面可以包含除Page与Window所有的节点4.2.5 其她节点Folder（文件夹）通过此节点可以实现逻辑单元的封装除Page与Window所有节点Programlines（程序行）通过此节点执行ABAP语句所有节点共同的选项GeneralAttributes（一般属性）节点的描述或者内容OutputOptions（输出选项）位置、样式、方框、阴影等属性，还有其她的一些输

8、出属性Conditons（条件）如果条件为真，显示节点4.3 创建*II板：Template节点用于创建文档中的静态表格，即在打印前已经确认了行数。如果打印的行数不确定，需要用Table节点或者Loop循环Template输出，以下为创建过程：鼠标右键->创建->模板页签功能描述Templage（模板）设置阴影、边框与行类型OutputOptions（输出选项）打印时的样式、边框、阴影等Conditons（条件）条件满足则执行此节点及其下级节点这里最重要的就是行类型的设置，它代表了表格中一行数据的样式（比如多少个单元格，每个单元格长度宽度，边框等），可以设置设置不同的行类型。点击创

9、建后出现模板的属性设置界面，有三个页签：点击修改笔可以直接在白色编辑区域直接画，也可以点击细节直接输入数据。SAP波楞荧门整：更改检版轴TEMPLAT£1手。r国回国磔口才我悔荒制里壬格一口 ZHZ? SM TEST-合主序设史国多格甘泉IS箍口,国王后定一-壮飙喧口 d对4证1期岫-O %5m心ovfi标总 g TEcnftg Q）main T®r, n STABLEL 斫表 1指如KTHWPLmiW|中脚”0|同田I回画匡国I武I画点击细节画面、注意字段“参考”就是引用另一行样式设置，则不需要再重新设置16. 00样式：系统提供了很多打印样式，可以选择，也可以自己设置样

10、式，具体设置详见下一章节介绍。模板TEMFLATELfiuli新便旗1模痛输十，逾项条件I-1 Ti而仔护I条件页签：此节点执行条件：只有满足了设置了条件，才能执行此节点及它包含下一节点的内容额外属性：设置的事件将会执行TEMPLATE1吊斤矫14.4创建文件夹xjgll尸1li"Mim目''区r小匕尹声下，立应.丁占rlwrf.Trri*上注MT省rm111J11|1r一1JV1*to-4更电h飞"T也1巾2.注口传0r¥住ma奶m-EE在主BES1=1讣*WE1g在主MB1=1出市HE卬在。3鼠标右键->创建->文件夹空限电抑模棘:

11、在印指团的 地址制承剪切豆制粘I帖删除有开有两个页签，功能同创建模板的一样文件* iHiias*lr口L-DiLKI_5fr.JD-IffiTH'总工干口加号7二UJ忸比匕米占4切中子4.5创建文本Text输出文本，有四种类型，一般情况下选择E或者M类型即可类型功能描述备注DDynamicType（动态文本）此种类型在Netweaver7、0中没有介绍ETextElement（文本元素）创建新的文本支持静态与动态IIncludeText（包含文本）弓1用SAPscriptTextsMTextModule（文本模板）引用TextModule鼠标右键->创建->文本有四个页签，

12、其中“输出选项"与"条件"同以上两种节点。针对文本节点，在输出选项需要特殊处理：设置行与列的位置，可参考在模板中设置的行类型。详见下图设置文本类型类型为文本元素；可以直接输入要显示/打印的内容，如Airline,也可以动态数据输出，则需要点击“添加“按钮注意：字段前后需要增加符号"&“掘评一般国民占占J!"'"fcCs.(L牛IWTEXT2文本元素SAP条件开始 a信房匕车.1好.竿邛慕徨许可和部隹FdlrlwgPraoti n g-J a f|力玷站“百找?'«k扬4 IS 捍 *为 Reset P

13、sragirph Forrnot仍困©学领8式Styles*4.6执行SMARTFORMSForm创建成功并激活后，系统自动生成一个FM执行FM可以预览结果并打印。手动执行此FM或者程序调用这个FM实现执行Form的功能。程序调用将在案例中讲解，此处讲解执行执行FMF8或者点击执行按钮SAP蓑格设计器:更改文本%7E¥N皆o° |图|画目I曲4表格绘制牒文本5JTEXT2辑迷新文本2一般属性出选项件表格aH?P_5H_TEST,&全局铅矍a表格属性0表格接口，国窒局金文生成的FM:委数构建舞;初蛤屏幕界口回中H目口脂重新分酶困数模次，®3fB/S

14、FgQg2T3曳显示次修改|口福建丁执行FM,可以选择打印机，并提供打印预览与直接打印的功能4.7创建smartforms样式Smartforms的样式主要就就是定义一些字体，颜色，字体大小一些对齐方式什么的，然后段落的格式首先输入TCODE:smartforms进入创建smartforms的界面。如图：SAP智髓表:初始屏基的盼口。恚格r文本模块回显示I,更改|Q仓腱一.-martFormsHcn?eg）电点击创建之后进入样式创建界面博武ta.if曦祖事£|朝：建超制*圣相w更叶学的时 鼻走寸行知+曲国，*济存10i 0O Ie, gV标X手体纪，要绸X:肆忒档才K7空n二七L2口

15、即白卜+三.台州吞一百用巴丁¥_GMLIr竹仲LZI理苦他包*口学时I®寸样式中分三部分，表头，段落，字符，我们可以针对自己想要的样式来定义一些，然后用与smartforms中,三部分的解释如下页签功能描述备注表头数据表头数据，包括标准配置与管理创建时系统默认显示此页签段落格式段落格式，可以段落设置字符格式字符格式，可以字体设置4.7.1创建表头数据创建Style时系统默认显示配置表头数据页签功能描述备注标准设置标准设置，可以针又t字体，默认标准段落，及预览效果其中标准字段需要设置卜面创建的段落格式，否则不能激活管理管理信息，主要显示谁创建什么时间创建然后创建段落的格式有左

16、对齐，右对齐，居中的完后需要回到表头数据中把标准段落填上，不然无法激活点击保存,激活,这样样式就就是初步完成,后面根据samrtforms中的应用情况做想应得调整、5文本模块创建文本模块作为Form中节点文本一个类型，维护了它，则可以多个Form共同使用，提供Form创建的效率。SAP智熊袤二初始屏幕7HZP SH TEST - -ZHZP_T7_SMQ表格。样式文本植块zhap_teKt_ind|O酎更改|口创建两个页签组成页签功能描述备注文本输出文本管理样式选择，翻译（国际化）及创建信息同创建文本一样，可以动态与静态类型ZHZFTESTND曲讨6案例6.1案例描述以下就是客户预订航班清单，

17、要求只有第一页有表头。我们将依次案例创建Form。航空公司航班航班日期客户预定日期票价AA00172011、08、312011、06、09803,58、输入Tcode:SMARTFORMS,创建Form:zhzp_sm_testSAP智髓表二初始屏墓袤格皿511ctestc样式t-rc文本槿境沏显色|少更示系统默认生成Page与Window进入维护界面6.2设置背景图片在PAGE1中可以设置背景图片6.3创建接口参数I_CARRID,I_CONNID,I_FLDATE,I_FLAG为查询条件：航空公司，航班，日期，输出方式标识如果有要输出的数据可以在EXPORT中定义，如输出或输入有表格则可以

18、通过Tables定义,这里我们只定义四个个查询输入参数，取数逻辑由于简单就放到smartforms中来实现了。SAP表指设S器:更改素瘩TEST沙施四时Fl|圆_国中表格曲博I-丢榨O堂局设置国无嗜用性,国案喧悒口-1=1至月定:七，eWAfiElJM页面*Z壬窈匚表碣2KZF_3I_,raffT福避分2出表K函1比率纤图美方叁孚神当俏A7CELVEINPEXTYF3TOA_D£KAARCHIVR_UDR_T/FTfPETFHlAFftARCEITF_PkEAUFTTRSTVP?珏C=FrCZJTTROL.PAEAnETERSTYFHSEFrTF.in?M<HL_APFL_OB

19、JT¥P3SWOTCejIDJl*LL_RiiClF2HJll，TMSWIUEJ二LJIML.SENLEETYP3STOIOEJJB1TPUT.OPTnasTVPESSF17OWPOPTTFT.TTnrnSTVF5ITBOnLTfI_CAREIDTYF3S_CARE二口IMNIIIDTYP3S_CO!TN_II)I.FLDATETm5JMTE1_KLAGT¥P8FLAG圜画画_陇国虱圄6.4 创建全局变量全局变量GT_SBOOK用于保存预订的航班清单，GW_SBOOK用于循环处理时工作区。GV_TABIX用于流程控制，后面将讲到。SAP表格设计器;更改表格ZHZP_SM_7

20、F5rI国E|七啰，巴国今表咯绘制器表格=S1ZHZP_5M. TEST 日灯睡性口文嚣霞走走全国1国口五和窗口, 口聃P4GEI耕页面翼型泗-美联蓝型GT.SEOOK7TTEBC.S0OOXGi_SBOOKTYPESEOOKCV_TAEIKTYPE1国回网囹ffig物6.5 创建节点程序行：此处写代码获取要打印的航班清单。当然，要打印的数据可通过接口传，这里只就是为了演示节点的创建过程。输入参数，输出参数，代码段aDE 於SCODE1_，.才针r6.6 创建节点可选条件这里创建这个节点就是用于碰到打印输出就是以表格还就是模板里国用为Q阳4表格妲制著可翱%CO3ID1TIDN1既是用表格艇定是

21、楣版F岗位铜出说贞条件6.7 TURE节点下创建节点循环循环处理航班清单学靠二国生百%/4大珞色烟QUF1和瞪H0上3MITE$T陶武存房13陶福挥口.国一翳义a南和窗口白KF&G三15并面-QMATM主说口'%m况»持序句一漓'.'jurrioi1-=-*TRUE卜型断口的i，FALSE案在内部才."AtrH6也SEQML、这里可.汴加循环r件ZU徜出拙殍可以任这鼻S?拌乐号杷剧士6.8 循环下创建节点程序行用于实现第一页有表头的条件判断。Mi除行WEgE士1MHi1狗看" "SI XII Z1F_3M _ TCS T

22、9"湿！5B区在帆肆西聂论他口-之在弋-B mSE = 0 强“汽X i Uf irrerri,口主二也,布彳三一6.9 创建节点模板（Template）此节点需要创建在Loop下。并设置每行的样式，可以设置很多不同的，这里我们简单设置一种*西表精国度国在精博口'国童所索，京百同窗n-曰 TA非I，Pl MA1S 壬百口 * %CgEI新社串仃“骨 c&'jDno'ii 早* a TRUE鎏?W-OOP：3* t %ccm1 国-.I：, Ml鼻 FAL2E悟柜 苜出正项 呆:回亘国1画画医画1画I. 选择有五稻的 i.tiifti民色商所历画晅府运F

23、可陶画|圃圃|国画 修即 一 g皿* Cs £g_w_r>£br祖过6.10 模板下创建可选择节点条件设置：只有第一行才执行打印表头GeneralAttnbutesOutputOptions,ConditionsNodeCaridtionsy潮力用B3空DetermineConditionsFieMNameRCampansanValueGV_TASIX一16.11 创建文本-岫塞格Mil0U幅*口 ® 拿 MSW:.耳日岗忙修心flIM t 四=B町*TtiLiMi1户丹拈土标匚- WUE上£ !CODEi孑理厚行2T H 吗TEMPLATE! *

24、d L* E3 TRUE-.Jr *eti野牙看iTEX TJl #i?< 3% tex t-;勒坦不一H * SAL5C堂左三聿望:*工田国B；施WE航空公司2J 0“废摩史*111齿日霓XB眄H在可选的节点的True节点中创建，此处将创建表头False中创建内容另外还有一点比较重要就就是行列的设置Ttru-Xi' l二削00（值鞘心递现怦一国I a TEi 曾 4 rli诂乖和扃效<1加子市书同而 的自 电JE典眄色8哄-乐皿女>镉urti£言才耳6.12 最终的节点分布会相- C3 2HZP_SM_TEn白宓啜直 值舌格属性 国表根6f口 图至后定义”

25、口声和玄口 d ,钟4GEI 3或武* Ql MAIN 上窗口 f啾映1出的粕L收 ：，inI ru是用史也制匕1上星小痴' THUE Loori科涸耳1' 4 %3口日/我师中2翔，一TEhP/TFl哥广析： r3NCT：lN?新卸士?_R3J?自学方工%自。浦支聿;*TEKT2部件之 啜EX匕孙文本M MET4 .帚文玄*第TEXTS刊文工5%T£XH另 £E 匕' FALSE+ 2 %irxT7 所文击 7, 3*稀0TE待中；5 9匿%TEXTg讦攵事9、m%1三八1 口哥交车10 4 % TENTH :文云 J J才知0CT1之翎芝为K工?

26、T£XT12齿过孙五茶口JTBH二非归属性福出幽 t新悻犹中面保才精架,m6.13 创建表格（table）节点这类型的创建，我们讲解的时候再创建、6.14 程序调用FormFM:SSF_FUNCTION_MODULE_NAMEForm生成的FM,动态调用此FM代码如下：REPORTzhzp_call_sm_sbook、DATA:lv_fm_nameTYPErs38l_fnam、DATA: control_parametersDATA: output optionsTYPEssfctrlop、TYPEssfcompop、PARAMETERS:p_carridTYPEs_carr_id,

27、p_connidTYPEs_conn_id,p_fldateTYPEs_date,p_flagTYPEflagDEFAULT'X'control_parameters-no_dialog='X'、control_parameters-preview='X'、output_options-tddest='LONP'、*获取Form生成的FMCALLFUNCTION'SSF_FUNCTION_MODULE_NAME'EXPORTINGformname='ZHZP_SM_TEST'"Form的名

28、称IMPORTINGfm_name=lv_fm_nameEXCEPTIONSno_form=1no_function_module=2OTHERS=3、IFsy-subrc<>0、MESSAGE'TheFormisnotexit'TYPE'E'、ENDIF、*执彳TForm生成的FM进行打印CALLFUNCTIONlv_fm_nameEXPORTINGcontrol_parameters=control_parametersoutput_options=output_optionsuser_settings=spacei_carrid=p_carridi_connid=p_connidi_fldate=p_fldatei_flag=p_flagEXCEPTIONSformatting_error=1internal_error=2send_error=3user_canceled=4my_exception=5OTHERS=6、IFsy-subrc<>0、MESSAGE'Printfail'TYPE'E'ENDIF、7附注7.1 合并单元格对于在实际的报表开发中经常回需要合并单元格的情况，合并单元