sapscript(sap中文教程).docx

1 SAP script Forms 21. 1SAPscript 的组成 21. 2Forms: 组件和技术31 概念31. 2. 1. 1 修改 SAP Forms 32. 1. 2 Forms：概念3L2.1. 3 Client和语言版本:概念 4组件41.2. 2.1Header Data 41.2. 2.2Paragraph Formats and Attributes 61.2. 2.3Character Formats and Attributes 81.2. 2.4Windows 81.2. 2. 5 Pages （页面）101.2. 2.6Pages window（页面窗口） 111.2. 2.7Text Elements （文本元素） 121.2.3 技术15在Form中包含图形15L2.3.2在FORM中包含公司logo 17在form中打印条形码242. 3. 4 Using Boxes, Lines, and Shading 271. SAPscript Control Commands 302. 1Control Commands 语法 302. 2Control Commands 种类 302.2. 1 显示分页：NEW-PAGE 302.2.2 限制分页：PROTECT 312.2.3 下一个 main window 命令：NEW-WINDOW 312. 2. 4 给文本 symbol 分配值：DEFINE 31格式化日期字段：SET DATE MASK 322.2.6 格式化 Time 字段:SET TIME MASK 33设置与国家相关的格式：SET COUNTRY 332.2.8 设置 symbol 位：SET SIGN 342. 2. 9 Initializing Numbered Paragraphs： RESET 342. 2. 10包含其他文本:INCLUDE 35改变样式:STYLE 352. 2. 12 格式化地址：ADDRESS 352. 2. 13 it main window 中设置 Header Text： TOP 372.2. 14 在 main window 中设置 Footer Text： BOTTOM 37条件文本：IF 372.2.16 条件文本：CASE 382. 2. 17 调用 ABAP 子程序：PERFORM 382.2.18 合计:SUMMING 40R SAPsrrint Svmhclv403. ISyntax of Symbols 403. 2System Symbols 41 VAR Window （可变窗口）可变窗口的内容在每一个page中都要处理一次。系统输出仅仅适合窗口尺寸，超出窗口的文本被自动截掉； 可变窗口也不会触发换页处理。不象CONST Window, page window如果声明为VAR Window,意味着在不同的 Form pages中可以有不同的尺寸。注意:在窗口内容处理方面,系统并不区分CONST Window和VAR Window,唯一的区别就是在全部Form中具 有同样尺寸。 CONST window （常量窗口）从版本4. 0开始，在系统内部处理中，并不区分CONST Window和VAR Window,所以，如果创立一个新的window, 总是使用VAR类型的。1. 2. 2. 5 Pages （页面）对每一个Form必须定义至少一个page,而且必须在Form的header属性标签中指定“first” page。否那么，不能进 行文本格式化。另外，应该指定当到达第一页的末尾的时候，接下来的一页是哪页。如果没有指定的话，输出就在当 前页的末尾终止。为了定义一个page,需要为它指定名字和属性： 下一页的名字 page的计数模式 page数的数字类型 资源名字 打印模式文档的单个pages通常有不同的layouts：发票的第一页与接下来的页不一样，在这些页上不需要重复通用信息， 比方地址或者客户数据，象窗口中的文本元素一样，page也有名字，在有需要换页的情况下，需要通过这些名字来 指定下一页，如果想文档的样式变化越多，就需要在SAPscript中定义越多的page。下列图说明如何利用事务代码SE71维护一个page。在WIN32操作系统中可以利用Form Painter。Form Edit Goto Attributes Utilities System HelpADDRESS 凌MAIN。SENDEE1. 2. 2. 6 Pages window（页面窗口）Pages window就是定义在页面中的窗口，这里的页面和窗口都是已经预先定义好的，定义pages window的主要任务 就是将窗口和页面关联起来，一个页面中可以有多个窗口。在定义pages windows时，窗口的名字与page的名字关联起来。必须指定分配给page的窗口的位置和大小。通过指定左边和上边距来定义窗口的位置，指定其高度和宽度来定义窗口的大小。注意：1）在所有pages中的main window的宽度必须相同。其他的窗口类型在不同的pages中可以有不同的尺寸 和位置。2）为了打印多列，需要在一个page中定义多个main windowo因为文本条目是连续的，一旦第一个main window被写满之后，输出可以在第二个窗口继续。当定义windows和pages的时候，可以不必指定位置和输出的文本间隔。为了指定这些值，可以直接创立一个page windowo 当定义page window时，需要指定： 显示在page上的window window的尺寸（包括大小、宽度、高度） 页面中各个window的位置如下列图所示：1. 2. 2. 7 Text Elements （文本元素）SAPscript将form中的单个文本组件称之为Text Elements （文本元素），为了获得较好的结构和可读性，可以 为form中的每一个Text Elements分配一个固定的名字，打印程序通过这些定义的名字来访问Text Elements。Text Elements与window相关，就是说，打印程序仅仅能够调用定义在窗口中的文本元素。下列图显示了定义在 main window 中的 HEADING和FLIGHTIST强个 Text ElementSo电Window MAINlext Edit Goto Format include System Help圃踊到曲11创目LJ包血|X | Select Insert Line Format | PagePasteReplace1 + 2 + 3 + 4+5 + 6+7 /E ；： BhEADINGUL l&uline(67)&IL Airline,.FlightNr.， ,FlightDate,Price UL |8culine(67)& /E FLIGHTLIST /：MsET TIME MASK =IL &Flights-CARRID&z,&flights-C0NNID&_&flights-FLDATE&_8(flights-PRICE&|可以将这里定义的Text Elements和ABAP程序中（比方TEXT-001）定义的文本相比拟来学习，但是，Text Elements 比ABAP程序中（比方TEXT-001）定义的文本更灵活，主要表现在： Text Elements的长度没有限制； Text Elements可以包含变量符； 在一个Text Elements中可以使用几个不同的格式选项； 在Text Elements中可以使用SAPscript控制语句。在window中，可以使用两种不同的Text Elements, 一种叫做有名Text Elemonts；另外一种叫做无名Text Elements。1）有名 Text Elements通过段落格式“/E”来识别有名Text Elements,在行编辑器中，看起来象这样：Text Edit Goto Format Include Systc01*/E<NAME>字符串NAME代表Text Elements的名字，名字可以有30个长度，而且可以包含字母、数字、特殊字符。名 字后面接下来就是这个Text Elements的文本行。一个Text Elements在下一个Text Elements开始处结束。 注意:Text Elements的名字仅仅在本地有效（LOCAL）,即不同的窗口可以包含相同的Text Elements的名字° 为了输出有名Text Elements,必须在程序中（ABAP）使用函数模块WRITE_FORM。下列图说明了发票中的列头Text ElementSoWinText Edit Goto Format Include System Help囱 一国固旧品1叵丽| Select | Insert | Line | Format ( Psge | Paste | Repla(1.2.3.ZE I HEADINGASAirline,Date,Price,Currency!2）无名 Text Elements无名Text Elements或者叫做缺省文本元素是这样的一些文本行和控制语句，它们显示在相应window contents的起始处，没有“/E”段落格式。包括所有的行直到出现“/E”段落格式，或者直到末尾，如果中间没有其他“/E”标志出现,因此,在一个window中只能包括一个无名Text Elementso这两种Text Elements之间的区别在于： 对于有Text Elements来说，只有当系统显示调用函数模块WRITE_FORM时，才被输出；而对名Text Elements, 系统会自动处理。 Main window 中的 Text Elements 仅仅出现一次，它不会出现在包含 main window 的 form 的 subsequent page 中。 其它window类型（除main window外）的无名Text Elements每次都会出现。下面的例说明了在form中的ADDRESS window的无名Text Elements,这个Text Elements输出客户地址， ADRS_SENDER标准文本仅仅在第一页显示（通过IF AND CASE语句可以控制）。Window MAI IText Edit Goto Format Include System HelpMB0101国口回回区匚画画回Select Insert LineFormat 口四已（Paste | Replace.+.1.2.3.4/： IF &PAGE& EQ '1'/： INCLUDE ADRS_SENDER OBJECT TEXT ID ADRS/： ADDRESS PARAGRAPH ASNAME&S CUSTOM -NAME &/：'POSTCODE &SCUSTOM-POSTCODE&ITY&S CUSTOM-CI TY&/： ENDADDRESS3）激活 Text Elements当函数模块WRITE_FORM的时候，可以通过设置FUNCTION参数的值在打印程序中激活窗口中的Text Elements, FUNCTION可以是下面的值： SET用当前的值代替所有window中激活的文本元素 APPEND将当前的Text Elements追加到激活的Text Elements DELETE从激活的Text Elements列表中删除当前的Text Elements注:激活Text Elements是指当当前page调用时，系统准备输出的window Text Elements。在main window BODY域中,APPEND和SET具有相同的效果，DELETE对其没有影响,在TOP和BOTTOM域中, 与上面描述的相同。1. 2. 3技术3.1在Form中包含图形这一节主要介绍在form中包括图形的技术，主要介绍如何在form中打印公司logo和如何打印条形码。1）在form中打印公司logo为了能够打印公司log。，不管是在form中，还是在PCL-5打印机预定的宏中，下面的规那么有助于选择合适的 方法：如果不能够以TIF6. 0的格式提供logo,那么公司logo应该在PCL-5打印机预定的宏中进行打印;如果没有PCL-5打印机，那么需要将公司logo包含在form中; 在其他任何情况下，将公司logo包含在form中。如果在打印公司log。的时候，正确的参照了这里的说明，但还是没有能够正确打印出公司的log。，可能是因为 你提供的logo的图形格式不是基于TIF6. 0的，如果文件格式不正确，SAP并不给出任何错误信息。F面介绍在form中包含公司logo的步骤:Step-by-Step Guide1. 在FORM中包含公司logoTask 1 Convert your company logo into a SAPscript standard text.1. Create your company logo with a graphic program and save it in the Baseline TIFF 6. 0 format.In this guide, the filename is LOGO. TIEFrom the SAP main menu, choose Tools f ABAP Workbench,2. On the ABAP Workbench screen, choose ABAP Edi tor.3. In the Program field, enter RSTXLDMC.4. Choose Execute.6.7.8.Determine the location of LOGO. TIEIn the File name field, enter the file name with its location.Note: UNIX file names are case sensitive.In the Type field, enter the appropriate type for the raster image. BMON stands for a black and white raster image.Use BMON for monochrome printers because these printers normally do not perform a gray-level conversion. BCOL stands for a color raster image with up to 256 colors.For this example, use BMON.9. In the Text name field, enterZHEX-MACRO-LOGO.10. Choose Execute.The upload may take a while. The result should be a protocol as shown.11. At the end of the protocol, a Standard text ZHEX-MACRO-LOGO ID ST Language EN saved successfully message indicates that the standard text was created.12. Choose Back four times to return to the S/P main menu.1.2.Choose ABAP Editor.You can easily display the created standard text.1. Choose Tools Word processing Standard text.2. In the Text name field, enter ZHEX-MACRO-LOGO.3. Choose Display.For additional information about report RSTXLDMC, access the report documentation:Choose Tools > ABAP Workbench.4. In the Program field, enter RSTXLDMC.5. Select Documentation.6. Choose Display.Step-by-Step GuideTask 2 Include the standard text ZHEACRO LOGO in the sales order confirmation formZ_9H_RV0RDER01.1. From the SAP main menu, choose Tools -> Word processing Form.2. In the Form field, enter Z_9H_RV0RDER01, and in the Language field, enter EN.3. In the Sub-objects section, select Page layout,4. Choose Change.The synchronized screens of the Form Painter appear.3. 3Program Symbols 423. 4Standard Symbols 433. 5Text Symbol s 434. lOffset (偏移量) 434. 20utput Length 444. 3 Omitting the Leading Sign 444. 3 Omitting Leading Zeros 454. 4 Space Compression 454. 5 Number of Decimal Places 454.6 Omitting the Separator for 'Thousands' 464. 7 Specifying an Exponent for Floating Point Numbers 464. 8 Right-Justified Output 464. 9 Fill Characters 474. 10 Suppressing Output of Initial Values 474. HLocal Dates (Currently Only for Japan) 474. 12Changing the Value of a Counter 474. 13Preceding and Subsequent Texts(Pre-Text/Post-Text) 485. SAP script Function Modules 495. 10PEN_F0RM 515. 2CLOSE_FORM 525. 3WRITE_FORM 526 一个完整的例子531 SAPscript FormsSAPscript 的组成SAPscript由下面五个局部组成:5. In the Design window, create a new window by choosing Create window form the form layout manipulation menu.PageD。为|OptionsForm: Change Page Layout: Z_9H_RVORDER01Eorm Edit Goto &tnbutes Utilities System Help旷I三I回上能x | m M I r“ 弟 Definfcon 坐 Texts © & Pacagtaph formats Chaia以er famaUThe new window is automatically named Windowl.6. Activate Windowl and choose Rename window from the form layout manipulation menu.Eorm Edit Goto &tnbutes Utilities System Help2 0 能x1的回|把WINDOWloHEADERDRESSaOTOlo工N：FOOTERpi Form: Change Page Layout: Z_9H RVORDEROIForm Z_9H_RVORDER01 : Layout of page FIRSTCreate page Delete poge Copy page Renome page First page Next page Page overview Create window Delete window Cut window Cop window Insert v/ndawRename windowEdit wndow text AJign with grid Design/text7. Rename Windowl as LOGO.8. Choose Execute.-H Rename win.Fromto-WIND0W1v logo10. Activate the LOGO window and choose Edit window text from the form layout manipulation window.The PC Editor for the LOGO window appears.Eorm Edit Goto &tnbutes Utilities System Help Form. Change Page Layout: Z_9H RVORDER01OGOo二正 ADEM知 DRESS。NFOlci i i i i fOOTERpI IEdit window textAlign wrth gnd DesignAextForm Z_9H_RVORDER01 :少out of page FIRST 向目Create page Delete poge Copy page Rename page First page Next page Poge overview Create window Delete window Cut window Cop window Insert window Rename window9. Define the position of the window LOGOusing the graphical Form Painter.With graphics or macros thesystem considers only the window position but not the size.The Left margin must be specified in CH (characters) and the Upper margin must be specified in LN (line).In the PC Editor choose the Insert command button.The Insert Additional Information screen appears.11. Select CommandEnter INCLUDE ZHEX-MACRO-LOGO OBJECTTEXT ID ST in the command line.12. Choose Continue.The new command line (gray highlighted) appears in the PC Editor.13. Choose Back.The window text is automatically saved by the system.14. Confirm the information.17. Activate the changed form.Your company logo appears on the first page of form Z 9H RV0RDER01 using the standard text ZHEX-MACRO-LOGO and the window LOGO for the print output.If the company logo should be displayed on the subsequent pages, you must copy the window LOGO to page NEXT.You have to repeat the following procedure for all defined pages:1. In the administrative screen, choose the window LOGO.2. Copy the window.3. Choose page NEXT.4. Insert the window.The position and size of the window LOGO defined for page FIRST apply to the other pages.5. Activate the form.注：关于如何在PCL-5打印机中打印公司logo,请参见相关资料，这里从略。1. 2. 3.3在form中打印条形码Step-by-Step GuideStep-by-Step GuideTask Define the material numbers on the sales order confirmation Z 9HRV0RDER01 as a ”3of 9" bar code with a check digit.1. From the SAP main menu, choose Tools > Word processing-> Form.2. In the Form field, enter Z_9H_RV0RDER01, and in the Language field, enter EN.3. Select Character formats.4. Choose Change.5. In the String field, enter B3. Form: Change Character Strings: Z_9H_RVORDER01sun6.7. In the Description field, enter Bar code 3 of 9 w/check.Choose Enter.The new character format appears in the character formats frame.In the Bar field, press the F4 help key and choose the appropriate bar code from the list of available bar codes.MForm Edit Goto AttribMI” 卡 Definition Q。Utilities System Help o 盘 x B 昌 mi ih © © c e 世幻?Paragraph formats 也Character formatsSuingDescriptionMark.PfOt.Hidd.Sup.Sub.BBoldOFFB3bar code 3 of 9 w/checkOFFIItalicOffKKey wordOffPRString protectedOFFOnOFFOFFOFFSSmall key wordOffUString underlinedOFFSuing2 ff. 7科 国Choose BC_CD39C.9. Save the new character format.The bar code is now defined and can be used. Next, we have to adjust the output of the Main window.10. Choose Layout.11. In the Design 八力activate the Mainwindow and choose Edit window text.String更9|B3 Descript.|bar code 3of 9OnOffMarkerProtectedCcBar codeI|bC_CD39C± HiddenccSuperscriptcrSubscriptccw/checkRetain11l.d« 拿 Definbon R Texts 0 Paragrach formats Chardder focrwPage(FIRST 三Aut page4 ,四&回幽 M ±J幺IWindowtWindow|MAINP Man wndowDefault par.Left margh|7.35(ciiUpper margin|28.35(LNWindow width|70.3li(CHWindow hcsgH|36.85(LN©回匐国幽幽&l型De 匈“ Text|OptiomHEADERpForm Z_9H_RVORDER01 : Layout of page FIR.Edit window textAlign wilh grid Design/lextCreate page Delete page Copy page Rename page First poge Next page Poge overview Create window Delete window Cut windowCop window In-， Rename window12. In the text editor, scroll down until you see /E ITEM_LINE.13. Place the cursor at the end of the first line under /E ITEM_LINE.14. Choose Enter to create a new line.Window MAINIkG盘X，昌阴画© © e e世幻1M曾.%Insert Line Format Page 倡隧Text Edit Goto Format Insert System Help12367il ip UL / /EIPPe<k>Material,Description</><k>, ,Qty.Price,.Price unit,Ualue</>&ULINE(71)&ITEM_LINE &/,'Customer material number 'UBDPfi-IDNKD' ,&&,Iten 'UBDPA-POSEX& ,&'Batch ,UBDPA-CHARG&ITEM LINE PRICE QUANTITV,&UBDPA-KWMENG(I12)&,&UBDPA-URKME&,&KOMUD-KBETR(112)6,&KOMUD-KOEIN&,&KOMUD-KPEIN(I)&,.&KOMUD-KMEIN&,&KOMUD-KWERT(I14)& ITEM_LINE_PRICE_TEXT,&K0MUD-UTEXT(17)&,&KOMUD-KBETR(I12)&,.&K0MUD-K0EIN&/E八/E/:八ID/,&KOMUD-KPEIN(I)R,.&KOMUD-KMEIN&,&KOMUD-KWERT(I14)R ITEM_TEXTINCLUDE &UBDPA-TDNAMER OBJECT UBBP ID 0001 PARAGRAPH IT ITEM TERMS OF PAVMENT PROTECTIF &UBDPA-ZTERMTX1& NE &SPACE& OR &UBDPA-ZTERMTX2& NE &SPACE& OR &UBDP &'Terms of payment 'UBDPA-ZTERM_TX1&&,UBDPA-ZTERM TX2&Z_9H_RUORDER01Lines 26 - 45 / 165zJIn the new line, enter ,<B3>&VBDPA-MATNR&</>.15. Choose Back.16. Confirm all the subsequent popup windows.The two commas, for the first tab, position the bar code under the material number. <B3> changes the current character string to B3, which defines the bar code. <%> ends the character string and returns to ILSome of the bar codes are higher than one line, w