ABAP-SMARTFORMS创建报表表格.docx

Smartform报表实例
目的：根据用户需求自定义打印报表。
说明：Smartform的创建需要指定页格式、样式，如果报表中存在条码，则需要指定条码格式。
涉及内容：页格式（SPAD）、条码格式（SE73）、样式（SMARTFORMS）、报表（SMARTFORMS）。
1.4 SMARTFORMS创建报表表格
1.4.1 创建报表表格
1、T-CODE:SMARTFORMS，输入表格名称，点击”创建“按钮，如图1.4.1-1：

图1.4.1-1
2、输入表格的描述，然后保存，如图1.4.1-2：

图1.4.1-2

1.4.2 全局设置-表格属性
1、在表格属性的“输出选项”页签中指定页格式和样式，可以是系统标准的也可以是前面创建的，本练习选择前面自定义的页格式和样式，如图1.4.2-1：

图1.4.2-1

1.4.3 全局设置-表格接口
1、在表格接口的“导入”页签中配置Import参数（要同程序中调用该Smartform的程序的参数相同），本练习配置了5个导入参数，如图1.4.3-1：

图1.4.3-1
说明：
a、可选和值传递选项处可以根据实际情况而定，如果勾选了可选的选项，则在程序调用时可不对该参数进行传递值，否则为必须传递的参数，如果没有对必须传递的参数传值就会报错；
b、自定义上面的9个参数为系统生成，在“导出”页签中也有3个系统生成的参数，本练习不会使用到，所以不做详细介绍；
c、“表”和“例外”页签中也可以进行参数配置，但是本练习都没使用到，所以也不做详细介绍；
d、导入参数也可以是导入内表，这样可以在“页和窗口”的主窗口中进行循环打印。

1.4.4 全局设置-全局定义
1、在全局定义的“全局数据”页签中配置Smartform中的参数，如图1.4.4-1：

图1.4.4-1
说明：
a、全局数据中的参数通常是为了将表格接口中导入的参数进行处理并赋值。
2、在全局定义的“初始化”页签中将导入Smartform的参数进行处理后赋值给输出参数，如图1.4.4-2：

图1.4.4-2
说明：
a、输入参数为值需要处理的参数；
b、输出参数为输入参数处理后的数值返回，可以和输入参数同名，也可以再“全局数据”页签中进行自定义，本练习使用的是自定义的参数；
c、本练习的值处理代码如下：
MATNR = MATNR1  .
MAKTX = MAKTX1  .
BISMT = BISMT1  .
LGORT = LGORT1  .
CALL FUNCTION 'CONVERSION_EXIT_CUNIT_OUTPUT'
  EXPORTING
    INPUT                =  MEINS1
   LANGUAGE             = SY-LANGU
 IMPORTING
*   LONG_TEXT            =
   OUTPUT               = MEINS
*   SHORT_TEXT           =
* EXCEPTIONS
*   UNIT_NOT_FOUND       = 1
*   OTHERS               = 2
          .
IF SY-SUBRC <> 0.
* Implement suitable error handling here
ENDIF.
*MEINS = MEINS1  .
CONDENSE  MATNR .
CONDENSE  MAKTX .
CONDENSE  MEINS .
CONDENSE  BISMT .
CONDENSE  LGORT .

1.4.5 页和窗口-新页面
经过1.4.1-1.4.4就完成了数据的处理。接下来是设计报表的界面，并将参数值显示到报表中。
1、新页面属性中页格式选择“横向格式”，如图1.4.5-1：

图1.4.5-1

1.4.6 页和窗口-主窗口
主窗口是在创建表格时就自动生成的窗口，只有在主窗口中才能实现循环，所以如果报表中有循环数据的话，需要在主窗口中设计。主窗口属性配置如下：
1、在“输出选项”中进行窗口的位置、大小、边框、底纹（行带有选项）等属性的配置，如图1.4.6-1：

图1.4.6-1
说明：
a、图中勾选“行带有”后，主窗口就有了边框，不勾选则没有；
b、位置和大小处的左边距+宽度不能超过页格式的总宽度，否则报错；
c、位置和大小处的上边距+高度不能超过页格式的总高度，否则报错。

1.4.7 页和窗口-模块（TEMPLATE）
1.4.7.1 创建模块
在窗口（主窗口或者T次窗口，T次窗口为自定义的窗口）中创建模块，可以实现在窗口的长宽范围内按照指定的位置显示有需要显示的元素（文本、条码、图片等等）。具体模块的创建步骤如下：
1、在主窗口（或者T次窗口）名上右击，点击创建模块，如图1.4.7.1-1：

图1.4.7.1-1
2、新建模块后在模块的属性界面“输出选项”页签中可以看到样式名称，只有在全局设置-表格属性中指定了样式后，这里才会自动带出前面指定的样式，同时，这里也可以根据实际的需要指定跟前面不一样的样式，如图1.4.7.1-2：

图1.4.7.1-2

1.4.7.2模块-模板设置
在模块的“模板”页签中，可以配置模块分为了几个格子（行列），并且每个格子的宽与高是多少，以及每个格子是否有边框。具体模板的设计步骤如下：
1、在”模板“页签中点击”细节“按钮，进入到模板的行列设置界面，操作如图1.4.7.2-1：

图1.4.7.2-1
2、在模板的行列设置界面中，可以设置模板的宽度、对齐方式、行列数以及行列的宽与高，如图1.4.7.2-2：

图1.4.7.2-2
说明：
a、该模板设置了3行，第一行为3列，第二行为2列，第三行为2列；
b、模板的宽度为6.7cm，也就是设置的最大行的行宽不能超过6.7cm，否则报错；
c、图中行列的设置中可以配置具体的行高、列宽。
设置完模板的行列后，点击”表绘制器“返回”模板“页签的主界面图1.4.7.1-1。
3、在”模板“页签的主界面选中需要设置边框的格子，然后进行边框设置，如图1.4.7.2-3：

图1.4.7.2-3

1.4.7.3模块-条件设置
模块的”条件“页签用于控制模块是否显示，只有符合条件的情况下模块才能显示。另外，在窗口中也有”条件“页签，设置原理都一样。
1、在“确定条件“中输入条件判断，操作如图1.4.7.3-1：

图1.4.7.3-1
说明：
a、该模块只有在MATNR1不为空时才显示。

1.4.8 页和窗口-程序行元素
如果全局设置中的参数还需要一些处理才能使用或者得出新的数据，则可以使用程序行元素对全局设置中的参数进行转换。如下为转换例子：
1、右击模块名，新建“程序行”，操作如图1.4.8-1：

图1.4.8-1
2、生成“程序行”元素，在“一般属性”页签中将需要处理或者作为条件的参数输入到“输入参数”处（可多个），然后在“输出参数”处输入转换后被赋值并将被使用的参数，再在代码块中对参数进行逻辑处理并赋值，操作如图1.4.8-2：

图1.4.8-2
说明：
a、该例子中输入参数和输出参数一样，也可以不一样，具体根据实际情况而定；
b、代码也是根据实际需要进行编写。
3、因为在模块中，它的子元素是从上往下执行的，所以如果模块中存在程序行元素，则需要把它放在输出参数显示的文本前面，如图1.4.8-3：

图1.4.8-3

1.4.9 页和窗口-文本元素
在前面对模块进行了行列设置后，如果要在行列中显示文本信息，则需要为模块创建文本元素。具体操作如下。
1.4.9.1 创建文本元素
1、右击模块名，新建“文本”，操作如图1.4.9.1-1：

图1.4.9.1-1
2、生成“文本”元素，如图1.4.9.1-2：

图1.4.9.1-2

1.4.9.2 一般属性设置
文本元素可以直接在“一般属性”页签的文本块中输入固定文本，也可以将全局设置中的参数引导进来。下面将组合固定文本和全局参数。
1、点击“字段列表打开/关闭”按钮，然后在界面中显示字段名称列表，如图1.4.9.2-1：

图1.4.9.2-1
2、找到该文本元素需要显示的参数字段，然后拖拽到文本块中，操作如图1.4.9.2-2，效果如图1.4.9.2-3：

图1.4.9.2-2

图1.4.9.2-3
3、在参数的前后可以添加需要的描述，如图1.4.9.2-4：

图1.4.9.2-4
说明：
a、因为参数为引导，不能直接更改，只能删除后重新导入，而且如果需要添加文本描述，要注意光标位置。
4、完成文本内容的输入或者导入后，可以为文本选择段落格式（前面定义的样式的段落格式，也可以放空不选）和字符格式（前面定义的样式的字符格式，也可以放空不选），如图1.4.9.2-5：

图1.4.9.2-5

1.4.9.3 Web属性设置
文本元素的Web属性可以用来设置文本元素以何种形式输出，如复选框、单选等等。本例子中没有进行Web属性设置，所以下面仅做简单介绍：
1、设置文本元素的Web属性，如图1.4.9.3-1：

图1.4.9.3-1

1.4.9.4 输出选项设置
1、文本元素的输出选项可以设置文本的边框、间距、颜色、底纹以及该文本元素对应模块的哪个行列，如图1.4.9.4-1：

图1.4.9.4-1
说明：
a、该文本元素对应了模块的第一行、第三列，及在模块的第一行、第三列中显示。

1.4.10 页和窗口-新窗口
如果报表表格的显示信息较为复杂，可在页面中创建新窗口进行报表部分元素的显示，已降低主窗口对复杂元素的组合使用。新窗口的创建步骤如下：
1.4.10.1 创建新窗口
1、右击页面，点击“窗口”，创建如图1.4.10.1-1，显示如图1.4.10.1-2：

图1.4.10.1-1

图1.4.10.1-2
说明：
a、在“一般属性”页签中可以选择新窗口的“窗口类型”，因为在一个页面中，只能有一个主窗口，而在新建页面时就自动生成了主窗口，所以新建的窗口通常选择“T次窗口”类型。

1.4.10.2 输出选项设置
新窗口的输出选项设置同主窗口（1.4.6节）的设置原理。
1、设置新窗口的边距、高、宽以及边框（行带有选项），如图1.4.10.1-1：

图1.4.10.1-1
说明：
a、新窗口创建后，在新窗口下同样可以创建程序行、文本、图像等元素。

1.4.11 页和窗口-其他元素
除了上面介绍的几个报表页面中的元素，系统还有几个本练习中没有使用到的元素，下面就简要介绍下：
1、页：创建新的页，如图1.4.11-1；
2、图形：在页面中插入图片，如图1.4.11-1；
3、地址：在页面中插入地址，如图1.4.11-1；

图1.4.11-1
4、表：为在主窗口中创建可循环显示的表格（如：库存报表数据），如图1.4.11-2；
5、逻辑流：包括程序行在内的几种代码元素，略。

图1.4.11-2
到这里，Smartform表格的创建就完成了。激活即可使用。