SAPFROMS说明文档.doc

SAPscript用途：SAP SCRIPT常用来打印需要输出到纸张的报表、凭证。SAP SCRIPT 使用页、窗口、段落格式和文本来控制输出。文本存在于窗口之中，每个文本有段落格式来指定字体，间隔等信息。窗口存在于页上，在页窗口设置每个窗口的位置。建立SAPscript事务码： SE71 格式绘制器1. 创建SAPscript（form）2. SAPscript 组件分为表头、页数、窗口、页窗口、段落格式、字符格式在此选择表头、页数、窗口、页窗口、段落格式、字符格式在此输入描述3. 表头：基本设置中，需要设定纸张、方向、缺省页和缺省段、字体类型和大小等信息。缺省页和缺省段需要先在页数和段落格式里定义。缺省页缺省段4. 页数：指定页的描述、下一页和计算输出页码的方式。下一页指的是当前页输出完成后，输出下一页的类型。一般指定为自身，确实需要换页时再在程序中控制。页码输出样式页码计算方法下一页5. 窗口：在这里建立、修改、删除窗口。MAIN窗口只能有一个。一般循环内表输出的多行内容，写在MAIN窗口里。一旦main window内容填满后，就会自动换页，在下一页的main window中继续输出余下的内容，而且格式保持不变。6. 页窗口：修改窗口在页上的位置7. 段落格式：可以设置各种段落格式的字体，行间距，左右间距等信息。行间距如果不设置，将使用基本设置里的缺省字体设置输出时每列的位置和左右对齐方式8. 字符格式：修改字体。可以使同一种段落格式下，用不同的字体输出。设置字体9. 在“窗口”或“页窗口”选中窗口后，点击文本元素按钮，可以修改窗口中的内容。输出或命令的内容。变量名要加上&，用,确定段落格式中的左右间距段落格式。/*表示注释，/:表示命令程序对SAPscript的调用调用时，如果SAPscript和程序中变量名称相同，变量的值会自动传入SCRIPT* 首先使用OPEN_FORM函数打开SAPscriptcall function OPEN_FORM.OPEN_FORM function module作用是打开将要打印的form，在你使用其它form function比如（WRITE_FORM, START_FORM, CONTROL_FORM.）之前，必须先要调用这个function module。必须通过使用CLOSE_FORM function module来结束将要打印的form，否则，系统不会显示或者打印任何东西。在一个ABAP程序中，可以使用多个OPEN_FORMCLOSE_FORM对，这样的话，可以在一个程序中，将几个不同的输出格式输出到缓冲池中。语法(ABAP程序)：CALL FUNCTION OPEN_FORMEXPORTING FORM = SPACELANGUAGE = SY-LANGUDEVICE = PRINTERDIALOG = XOPTIONS = SPACEAPPLICATION = TXARCHIVE_INDEX = SPACEARCHIVE_PARAMS = SPACEIMPORTING LANGUAGE =RESULT =NEW_ARCHIVE_PARAMS =EXCEPTIONS CANCELED =DEVICE =FORM =OPTIONS =UNCLOSED =参数说明：1) Exporting 参数FORM-控制输出格式的form的名字，当调用了OPEN_FORM后，可以使用其它Function Modules来向这个form中输出文本。如果没有指定这名字，则在调用任何output functions时，必须使用START_FORM来启动一个有效的form。缺省值：SPACELANGUAGE-form使用的语言，缺省值：SY-LANGUDEVICE-指定form的输出设备，缺省值：PRINTERDIALOG-打印时是否显示打印对话框，可能值 ,不显示；X，显示；缺省值为XOPTIONS-用这个参数来设置打印选项，打印选项在结构ITCOP中定义，缺省值SPACEAPPLICATION-当DEVICE为SCREEN的时候，在显示格式化文本的界面上，需要定义一些menu，这些menu为在SCREEN中选择其他打印设备提供输入。参数值为SAPscript提供的一个界面名字，关于这些界面的对象名，可以参考表TTXOB，缺省值为TXARCHIVE_INDEX-为要打印的归档输入索引信息，参考结构TOA_DATA，缺省值：SPACEARCHIVE_PARAMS-归档参数，参考ABAP Dictionary结构ARC_PARAMS，缺省值：SPACE2) Importing 参数LANGUAGE-当前系统使用的form的语言环境，参考字段：THEAD-TDSPRASRESULT-保存打印结果信息，存储在结构ITCPP中NEW_ARCHIVE_PARAMS-包含归档处理结果，存储在结构ARC_PARAMS中3) Exceptions 参数CANCELED-用户取消当前这次form打印DEVICE-有效的设备类型FORM-包含系统不能找到的form的名字OPTIONS-包含无效的formatting optionsUNCLOSED-当旧的from仍然打开的时候，系统被告知要打开一个新的form，必须先关闭旧的form如果SAPscript有多页，使用START_FORM指定页call function START_FORM.* 输出call function WRITE_FORM.系统将在ELEMENT参数中指定的element输出到当前打开的form。语法：CALL FUNCTION WRITE_FORMEXPORTING ELEMENT = SPACEWINDOW = MAINFUNCTION = SETTYPE = BODYIMPORTING PENDING_LINES =EXCEPTIONS ELEMENT =FUNCTION =TYPE =UNOPENED =UNSTARTED =WINDOW =参数说明：1) Exporting 参数ELEMENT-指定想输出到指定window（WINDOW参数）中的文本元素的名字，这个文本元素必须定义在form window中，如果没有指定文本元素，将用缺省值：SPACEWINDOW-指定想输出的文本元素所在的window，缺省为：MAINFUNCTION-这参数决定如何输出文本元素，输出类型依赖与window的类型和区域，具体参见sap online helpTYPE-这个参数仅仅针对main window而言，这个参数决定将文本元素输出到main window的什么位置，可能值为：TOP, BODY, BOTTOM；缺省值为：BODY2) Importing 参数PENDING_LINES-如果文本输出到main window的BOTTOM位置，可能会因为main window中没有足够的空间来容纳这些文本，这时候，系统就会自动将这些文本输入到下一页的BOTTOM位置，这种输出就叫做PENDING；如果输出是PENDING，则参数PENDING_LINES包含X，而且打印程序也会做出相应的反映，例如，文本末尾的显示分页命令NEW-PAGE可以显示触发PENDING输出到下一页的BOTTOM位置。3) Exceptions 参数ELEMENT-指定的文本元素不存在FUNCTION-指定的值不存在，FUNCTION的可能值为SET, APPEND, DELETETYPE-指定的window区域类型无效，TYPE的可能值为BODY, TOP, BOTTOMUNOPENED-如果这里没有form被打开，则出错UNSTARTED-如果这里没有form被打开，则出错WINDOW-在当前的form中指定的window不存在l * 对应START_FORMcall function END_FORM.* 完成打印工作后，调用CLOSE_FORM关闭SAPscriptcall function CLOSE_FORM.功能：关闭用OPEN_FORM打开的form。语法：CALL FUNCTION CLOSE_FORMIMPORTING RESULT =TABLES OTFDATA = ?.EXCEPTIONS UNOPENED =参数说明：RESULT-CLOSE_FORM处理结果，存储在结构ITCPP中OTFDATA-如果在参数OPTIONS中，字段TDGETOTF包含X，系统就返回在OTFDATA表中定义 的OTF输出格式（？）UNOPENED-如果这里没有form被打开，则出错。Text Element通过段落格式“/E”来标示Text Elements。不同的窗口可以包含相同的Text Elements的名字。在/E后面是text element的名字。/E下面，到下一个/E（如果下一个/E存在）或最后就是这个text element的定义区域对于Text Elements来说，只有当系统显示调用函数模块WRITE_FORM时，才被输出。当调用函数WRITE_FORM的时候，可以通过设置FUNCTION参数的值在打印程序中激活窗口中的Text Elements，FUNCTION可以是下面的值：l SET用当前的值代替所有window中激活的文本元素l APPEND将当前的Text Elements追加到激活的Text Elementsl DELETE 从激活的Text Elements列表中删除当前的Text Elements常用变量&PAGE& 当前页号&SAPSCRIPT-FORMPAGES& START_FORM 和END_FORM之间的总页数&SAPSCRIPT-JOBPAGES& OPEN_FORM 和CLOSE_FORM 之间的总页数.常用命令BOX 画一个框（横线/竖线）。Xpos ypos指的是框左上角相对窗口的坐标。/: BOX 判断/: IF condition./: ELSE./: ENDIF.例如只在首页输出某内容，可以加上如下判断/: IF &PAGE& = 1. /: ENDIF.分支/: CASE /: WHEN /: ENDCASE.设置时间、日期、数字格式/: SET TIME MASK = HH:MM/: SET DATE MASK = DD.MMMM.YY