SAP ABAP Web Dynpro 核心开发指南

遇到 4XX 或 5XX 错误时，可按以下方式排查：

• 403 错误：通常是服务未激活。检查 URL 路径，进入事务码 SICF 找到对应节点并激活。
• 500 错误：可能是 IP 或域名问题。尝试刷新页面或切换显示/修改状态。若无效，检查本地 hosts 文件 (C:\Windows\System32\drivers\etc\hosts)，确保 SAP 服务器 IP 映射正确。

绘制控件并运行

1. 绘制控件：拖动文本控件到顶部区域，填写 Text 属性后回车保存。
2. 插入控件：也可通过右上角树形菜单插入。
3. 生成应用：
   • 创建应用（此时访问可能报 500，需进一步保存）。
   • 保存应用。
   • 浏览器直接输入生成的 URL 访问，按提示登录。

各界面作用详解

View（视图）分页签

• Properties：基本属性，如描述、创建者及关联组件信息。
• Layout：界面绘制区域。
• Inbound/Outbound Plugs：入口和出口插件，用于视图间的跳转和参数传递，类似 Dialog 的 PAI/PBO 事件。
• Context：当前视图相关的变量操作。
• Attributes：类属性，用于操控变量和控件。
• Actions：定义行为及触发事件。
• Methods：封装的业务方法。

Window（窗体）分页签

• Window：查看当前窗体包含的视图列表，并可设置默认视图。

三大控制器架构

理解控制器是掌握 WDA 的关键，它们基于同一个基础架构扩展：

1. 基本控制器：包含 Properties、Methods、Attributes、Context。
   • Standard Hook Methods：WDDOINIT（初始化自动执行）和 WDDOEXIT（退出自动执行）。
   • WD_THIS / WD_CONTEXT：标准属性，分别代表组件本身和上下文。
2. 组件控制器：比基本控制器多出事件处理能力，用于全局交互。
3. 视图控制器：多了 Inbound/Outbound Plugs 相关配置，处理视图级逻辑。
4. Window 控制器：描述窗体内视图之间的跳转关系。

必会技术功能：视图跳转

要在两个视图间来回跳转，需完成以下步骤：

1. 创建第二个视图：例如 VIEW2，确保已保存到对象列表。
2. 加入窗体：在 Window 配置中将 VIEW2 添加到窗体结构中。
3. 建立跳转关系：
   • 在 VIEW01 创建 Outbound Plug，在 VIEW2 创建 Inbound Plug。
   • 在 Window 层面手动关联这两个 Plug（通常是将 Inbound 拖到 Outbound 上）。
   • 在 VIEW01 中绘制按钮，绑定 Action 触发 Outbound Plug。
4. 代码逻辑：Inbound Plug 对应的 Event Handler 可用于进入新页面后的初始化逻辑。

Context（上下文）概念与应用

Context 是 WDA 中数据的存储位置，类似于变量。控制器和视图都有各自的 Context。

基本概念

• 节点形式：以树状图展示，圆圈●代表节点，三角形▲代表属性。
• 范围限制：如 (c=0…n) 表示内表，(c=1…1) 表示单行结构。
• Lead Selection：当前选中的行数据。
• 多实例 vs 单实例：
  • 多实例：一次性取完所有数据，占用内存大，响应快。
  • 单实例：按需取数，选中谁取谁，占用内存小，响应稍慢。
• Supply Function：当 Lead Selection 变化时，自动调用的数据获取方法，常用于单实例场景。

Context Mapping（上下文映射）

为了实现数据在不同页面共享，需要将组件级别的 Context 与视图级别的 Context 进行映射：

1. 组件级别定义：参考数据字典创建节点和属性。
2. 视图级别映射：将组件 Context 节点拖拽至视图 Context，系统会自动生成对应字段。若两边字段不一致，可手动指定映射关系。

实战案例：数据传递

需求：在 VIEW01 输入值，跳转至 VIEW2 显示。

1. 组件 Context 创建：在组件级别创建节点，添加两个属性（如输入框的值）。
2. VIEW01 映射：将组件 Context 映射到 VIEW01 Context，并通过表单向导增加输入框控件，实现双向绑定。
3. VIEW2 映射：同样将组件 Context 映射到 VIEW2 Context，并将控件关联到这些属性上。
4. 跳转触发：在 VIEW01 输入框的回车事件中关联 Action，触发 Outbound Plug 跳转。

控件详解与布局方式

控件分类

• Text：文本显示。
• Action：按钮、链接等交互元素。
• Selection：下拉框、单选等选择控件。
• Complex：Table、Tree 等复杂控件。
• Layout：容器类控件。
• Graphic：图片等图形。
• Integration：集成相关控件。

页面布局方式

1. 流式布局 (FlowLayout)：控件尽量挤在一行，宽度不足时自动换行，类似 CSS 浮动。
2. 行布局 (RowLayout)：可设置 RowData（紧跟前一个）或 RowHeadData（换行显示）。
3. 矩阵布局 (MatrixLayout)：类似 HTML Table，不换行，列宽由最宽控件决定，支持 colSpan 和 hAlign。
4. 网格布局 (GridLayout)：自定义行列，控件可灵活放置到指定单元格，支持 colSpan 调整占位。
5. 表单布局 (FormLayout)：每行撑满屏幕，自适应宽度，适合表单录入。使用 FormData（紧跟）、FormHeadData（换行）控制对齐。

动态控制控件属性

根据业务需求动态隐藏或显示控件是常见场景。

1. 声明变量：在 Context 中创建布尔类型属性（如 inv_or_dis）。
2. 绑定属性：将控件的 Visible 属性绑定到该变量。
3. 逻辑控制：在按钮的 onAction 方法中编写代码，读取并翻转变量值，从而改变控件可见性。

Table 控件与 Service Call

Table 控件用于展示内表数据，数据源需来自 Context 中的内表节点。

调用 BAPI 获取数据

1. 了解 BAPI：例如 BAPI_FLIGHT_GETLIST，入参为始发地和目的地，出参为航班清单。
2. 创建 Service Call：
   • 打开向导，选择 Function Module。
   • 填写函数名 BAPI_FLIGHT_GETLIST。
   • 将参数映射到 Component Controller 的 Context 中（Obj Type 选 C），以便在界面显示或选择。
   • 完成向导后，系统自动生成调用方法和 Context 节点。
3. Context Mapping：
   • 将 IMPORTING 参数映射到 VIEW01（输入参数）和 VIEW2（输出结果）的 Context。
4. 触发调用：
   • 在 VIEW2 的 Inbound Plug 的 Event Handler 中调用封装好的 Service 方法，即可在进入页面时自动获取数据并填充 Table。

总结

本文介绍了 SAP ABAP Web Dynpro 的核心开发流程，从基础架构、控制器、上下文映射到布局与数据交互。尽管 Web Dynpro 属于较早期的技术，但其 MVC 思想与组件化设计在现代开发中仍有借鉴意义。掌握这些内容，有助于更好地维护现有系统或进行技术迁移。