06 · 门② Application Job —— 公有云定时/批量任务的唯一通道(完整实操)
📄 [教程] 总纲 PPT(
docs/SAP公有云开发.pptx)第 13–14 页「JOB」:if_apj_dt_exec_object 设置参数/if_apj_rt_exec_object JOB 执行/配置 JOB/释放 JOB;Day2 PPT slide 19「Reuse Components in Developer Extensibility」表格中 Application Job(Creating a Job Catalog Entry and a Job Template;Maintaining Application Jobs Using an API)与 Application Logs 两行 🔗 [官方] Application Jobs(ABAP environment 总览) · 用 IF_APJ_DT_EXEC_OBJECT / IF_APJ_RT_EXEC_OBJECT 建作业类 · 在 ADT 建 Job Catalog Entry 与 Job Template · 创建应用程序作业(S/4HANA Cloud 应用帮助) · 官方示例仓库 SAP-samples/abap-platform-application-jobs
本章目标:
说清公有云为什么没有 SM36/BDC/JOB_OPEN 可用,定时/批量任务只能走 Application Job;
在 Eclipse ADT 里写出完整可编译、可 F9 自测的作业实现类(两个接口 + 参数 + 日志 + 增量窗口 + 幂等 + 失败补推骨架);
在 ADT 建 Job Catalog Entry / Job Template,在 Fiori「应用程序作业」里排期 → 看实例 → 读日志 → 取消/重跑;
读懂我司
ZZCL_JOB_*存量代码(zzcl_job_mm002/fi010/fi011/sd005)并知道要改进的两个点。
本章产出(全部建在包 Z_Onlineshop,挂同一个传输请求):
# |
对象 |
类型 |
作用 / 验收 |
|---|---|---|---|
1 |
|
数据库表 |
每次运行记一条;基线 = 最近一条成功记录 |
2 |
|
数据库表 |
每条订单的推送结果(按订单号覆盖 = 幂等;失败可补推) |
3 |
|
应用日志对象(APLO) |
作业日志,Fiori 作业详情里可读 |
4 |
|
实现类 |
|
5 |
|
Job Catalog Entry |
绑定实现类,声明参数(= 老系统的选择屏) |
6 |
|
Job Template |
参数默认值(= 老系统的系统变式),可传输 |
7 |
一次作业实例 + 日志 |
运行时数据 |
Fiori 里状态 Finished、日志可读、基线与结果表有数据 |
✅ 衔接:03 章建了
ZONLINESHOP,04 章让它能建单/查单,05 章打通了 HTTP 出入站。本章不改 03/04 的对象,只新增上表对象,写一个"增量同步订单"的作业。练习不真连外部系统:push_order把结果写进本地结果表;真实项目把这一段换成 05 章的cl_web_http_client调用即可。作业的用户授权(IAM App / 业务目录 / 业务角色)在 08 章统一讲。
1. 为什么公有云只剩 Application Job 一条通道
本地部署时代,定时任务有一堆办法;ABAP Cloud(公有云唯一可用的 ABAP 版本)把这些入口全关了:
本地部署的老办法 |
公有云为什么行不通 |
现在的替代 |
|---|---|---|
SM36/SM37 + SE38 报表 + |
没有 SM36/SM37 事务码;ABAP Cloud 不提供"把 REPORT 提交到后台"的入口 |
实现类 + Application Job(本章) |
|
不在 ABAP Cloud 可用/已发布的 API 范围 |
|
BDC / SHDG 录屏批导 + SM35 |
没有 Dynpro 屏幕可录,也没有 SM35 |
批量走 API/RAP action;大数据量交给 Job 调 API |
后台 RFC、 |
不可"排期、监控、授权",不属于应用作业体系 |
Job 里调出站通信(05 章) |
操作系统 cron / 数据库作业 |
公有云租户没有 OS/DB 权限 |
Fiori「应用程序作业」标准排期 |
心智模型:一条链、四步走。 总纲 PPT 第 13–14 页把 JOB 讲成"两个接口 + 配置/释放",翻成工程语言就是:
① 实现类(ADT,开发者写)
├─ if_apj_dt_exec_object~get_parameters 声明参数与默认值(= 报表选择屏)
└─ if_apj_rt_exec_object~execute 作业真正执行的逻辑
② Job Catalog Entry 作业目录条目(ADT)
└─ 绑定 ① 的类;在编辑器里给参数配显示文本/顺序/分组/值帮助
③ Job Template 作业模板(ADT)
└─ 绑定 ②;给参数填默认值(业务用户排期时可改);挂 TR 传输
④ Fiori「应用程序作业」排期
└─ 选模板 → 改参数 → 定开始时间/时区/重复频率 → 生成作业实例 → 监控实例与日志
实现类/目录条目/模板都是 ADT 里的开发对象、挂 TR 传输;作业实例和日志是运行时数据,只存在于 Fiori 应用里。目录条目 = 老系统的"选择屏声明",模板 = 老系统的"系统变式"。
🔗 SAP 已提供新一代单接口
IF_APJ_RT_RUN(参数改成类公有属性、在目录条目里维护),见 Creating ABAP Class with Interface IF_APJ_RT_RUN。release 2608 上旧双接口仍完整可用,我司存量 Job 全部是旧接口——本章跟随线上代码用旧接口,新作业换不换新接口由团队评审决定。
2. 动手 1:准备三个辅助对象(两张表 + 一个日志对象)
场景:每天把 ZONLINESHOP 里上次成功运行之后新增的订单,每包 100 条分批"推送给外部系统",并留下可查的运行记录与作业日志。
2.1 运行记录表 ZONLINESHOP_JOBRUN(基线就存在这里)
步骤 |
操作 |
填什么 / 为什么 |
|---|---|---|
1 |
Project Explorer 右键包 |
与 03 章建表同一入口 |
2 |
Name / Description |
|
3 |
选 TR → Finish,把下面的 DDL 整段覆盖模板内容 |
字段名后面代码里要用,照抄 |
4 |
Ctrl+F3 激活 |
只看 Problems 无红叉才算过 |
@EndUserText.label : 'Online shop job run history'
@AbapCatalog.enhancement.category : #NOT_EXTENSIBLE
@AbapCatalog.tableCategory : #TRANSPARENT
@AbapCatalog.deliveryClass : #A
@AbapCatalog.dataMaintenance : #RESTRICTED
define table zonlineshop_jobrun {
key client : abap.clnt not null;
key run_uuid : sysuuid_x16 not null;
jobname : abap.char(30);
window_from : abap.dats;
window_to : abap.dats;
start_time : timestampl;
end_time : timestampl;
run_status : abap.char(1);
record_cnt : abap.int4;
message : abap.char(255);
}
字段 |
用途 |
|---|---|
|
每次运行一个 UUID(作业没有自增号,用 UUID 做主键) |
|
本次实际处理的增量窗口(日期),排障第一眼看它 |
|
运行起止时间戳(UTC),用于算耗时与下次基线 |
|
|
|
处理条数 + 结果摘要,和作业日志互相印证 |
2.2 结果表 ZONLINESHOP_JOBOUT(幂等 + 失败补推的载体)
同法新建数据库表 ZONLINESHOP_JOBOUT(Online shop order push result),DDL 如下:
@EndUserText.label : 'Online shop order push result'
@AbapCatalog.enhancement.category : #NOT_EXTENSIBLE
@AbapCatalog.tableCategory : #TRANSPARENT
@AbapCatalog.deliveryClass : #A
@AbapCatalog.dataMaintenance : #RESTRICTED
define table zonlineshop_jobout {
key client : abap.clnt not null;
key order_uuid : sysuuid_x16 not null;
run_uuid : sysuuid_x16;
order_id : abap.int4;
material : abap.char(18);
quantity : abap.int4;
sync_status : abap.char(1);
sync_time : timestampl;
message : abap.char(255);
}
💡 主键用
order_uuid而不是"运行号 + 订单号":同一订单重复推送只保留最新一条结果,天然幂等;sync_status = 'E'的记录就是下次要补推的清单。真实推送时,请让外部接口同样按业务键 upsert,否则本地幂等挡不住对方重复入账。
验证(2.1 + 2.2):两张表激活后出现在包下 Database Tables;右键表 → Open With → Data Preview 能看到全部字段、0 行数据(此时空表正常)。
2.3 应用日志对象 ZONLINESHOP_ALOG
步骤 |
操作 |
填什么 |
|---|---|---|
1 |
右键包 → New → Other ABAP Repository Object → 搜 Application Log Object(不同 ADT 版本可能在 Others 分类下,以本机版本为准)→ Next |
— |
2 |
Name / Description |
|
3 |
选 TR → Finish,在编辑器里加一个 Subobject:Name |
代码里 |
4 |
Ctrl+F3 激活 |
Problems 无红叉 |
📦 我司统一复用日志对象
ZZ_ALO_API+ 子对象ZZ_ALO_API_SUB(见sap-fi-master/src/zzcl_job_fi008.clas.abapL119–120、zzcl_job_fi010.clas.abapL62–64)。一个公司只建一个日志对象、按子对象区分业务,便于集中查询。也可以用设计时 API
cl_bali_object_handler=>get_instance( )->create_object( ... )用代码建日志对象(SAP 官方示例仓库的ZAPP_CL_DEMO_01_SETUP就是这么做的);ADT 图形方式更直观,效果一样。
3. 动手 2:写实现类 ZCL_ONLINESHOP_JOB_SYNC
3.1 建类
步骤 |
操作 |
填什么 |
|---|---|---|
1 |
右键包 → New → ABAP Class |
— |
2 |
Name / Description |
|
3 |
选 TR → Finish |
得到空类模板 |
4 |
把 3.2–3.5 的代码依次贴入(定义 → 实现),Ctrl+F3 激活 |
四段拼起来就是完整类,无省略 |
3.2 类定义(常量 / 私有类型 / 方法声明)
CLASS zcl_onlineshop_job_sync DEFINITION
PUBLIC
FINAL
CREATE PUBLIC.
PUBLIC SECTION.
INTERFACES if_apj_dt_exec_object.
INTERFACES if_apj_rt_exec_object.
INTERFACES if_oo_adt_classrun. " F9 控制台自测
CONSTANTS: c_template TYPE char30 VALUE 'ZAJT_ONLINESHOP_SYNC',
c_pack_size TYPE i VALUE 100,
c_init_from TYPE dats VALUE '20200101'.
PRIVATE SECTION.
TYPES: BEGIN OF ty_order,
order_uuid TYPE sysuuid_x16,
order_id TYPE int4,
material TYPE char18,
quantity TYPE int4,
creationdate TYPE dats,
END OF ty_order,
tt_orders TYPE STANDARD TABLE OF ty_order WITH EMPTY KEY.
DATA: mo_log TYPE REF TO if_bali_log,
mo_out TYPE REF TO if_oo_adt_classrun_out.
METHODS: add_log IMPORTING iv_text TYPE string,
get_baseline_date RETURNING VALUE(rv_date) TYPE dats,
push_order IMPORTING is_order TYPE ty_order iv_run TYPE sysuuid_x16,
write_run IMPORTING iv_run TYPE sysuuid_x16 iv_from TYPE dats
iv_to TYPE dats iv_start TYPE timestampl
iv_status TYPE char1 iv_cnt TYPE i iv_msg TYPE string.
ENDCLASS.
3.3 参数定义 if_apj_dt_exec_object~get_parameters
METHOD if_apj_dt_exec_object~get_parameters.
" ① 参数定义:Fiori 排期界面按这张表渲染控件(= 老报表的选择屏)
et_parameter_def = VALUE #(
( selname = 'P_FROM' kind = if_apj_dt_exec_object=>select_option
datatype = 'D' length = 8 param_text = '增量起始日期' changeable_ind = abap_true )
( selname = 'P_FULL' kind = if_apj_dt_exec_object=>parameter
datatype = 'C' length = 1 param_text = '全量重跑' checkbox_ind = abap_true
changeable_ind = abap_true ) ).
" ② 默认值:模板/排期没给参数时用这里兜底(勾选框默认不勾)
et_parameter_val = VALUE #(
( selname = 'P_FULL' kind = if_apj_dt_exec_object=>parameter
sign = 'I' option = 'EQ' low = '' ) ).
ENDMETHOD.
参数 |
|
界面控件 |
语义 |
|---|---|---|---|
|
|
日期范围 |
手工指定增量起点;留空 = 跟随基线 |
|
|
勾选框 |
勾上 = 忽略基线,从 |
3.4 执行主体 if_apj_rt_exec_object~execute
METHOD if_apj_rt_exec_object~execute.
DATA: lv_force TYPE abap_bool, lr_from TYPE RANGE OF dats,
lv_from TYPE dats, lv_to TYPE dats, lv_run TYPE sysuuid_x16,
lv_start TYPE timestampl, lv_status TYPE char1 VALUE 'E',
lv_msg TYPE string, lv_cnt TYPE i,
lx_error TYPE REF TO cx_root.
GET TIME STAMP FIELD lv_start.
TRY.
lv_run = cl_system_uuid=>create_uuid_x16_static( ).
CATCH cx_uuid_error INTO DATA(lx_uuid).
RAISE EXCEPTION TYPE cx_apj_rt_content EXPORTING previous = lx_uuid.
ENDTRY.
" 1) 解析参数:Fiori 排期界面和模板默认值,最终都落进 it_parameters
LOOP AT it_parameters INTO DATA(ls_param).
CASE ls_param-selname.
WHEN 'P_FROM'.
APPEND VALUE #( sign = ls_param-sign option = ls_param-option
low = ls_param-low high = ls_param-high ) TO lr_from.
WHEN 'P_FULL'.
IF ls_param-low = abap_true.
lv_force = abap_true.
ENDIF.
ENDCASE.
ENDLOOP.
" 2) 增量窗口:显式日期 > 全量 > 上次成功基线(不是"作业开始时刻")
lv_to = cl_abap_context_info=>get_system_date( ).
IF lv_force = abap_true.
lv_from = c_init_from.
ELSEIF lr_from IS NOT INITIAL.
READ TABLE lr_from INTO DATA(ls_from) INDEX 1.
lv_from = ls_from-low.
ELSE.
lv_from = get_baseline_date( ).
ENDIF.
" 3) 建作业日志(后台写入并挂到作业实例;F9 自测时打到控制台)
mo_log = cl_bali_log=>create_with_header(
header = cl_bali_header_setter=>create( object = 'ZONLINESHOP_ALOG'
subobject = 'SYNC' ) ).
add_log( |{ c_template }:窗口 { lv_from } ~ { lv_to },运行 { lv_run }| ).
" 4) 取数 + 分包处理;异常统一落 E,失败记录不推进基线
TRY.
DATA lt_orders TYPE tt_orders.
SELECT order_uuid, order_id, material, quantity, creationdate
FROM zonlineshop
WHERE creationdate >= @lv_from AND creationdate <= @lv_to
ORDER BY creationdate, order_id
INTO TABLE @lt_orders.
DATA(lv_total) = lines( lt_orders ).
DATA lv_packages TYPE i.
IF lv_total > 0.
lv_packages = ceil( CONV decfloat16( lv_total ) / c_pack_size ). " 注意:先把分子转浮点再除,否则整数除法会少一包
ENDIF.
add_log( |待处理订单 { lv_total } 条,分 { lv_packages } 包(每包 { c_pack_size })| ).
DO lv_packages TIMES.
DATA lt_pack TYPE tt_orders.
CLEAR lt_pack.
DATA(lv_begin) = c_pack_size * ( sy-index - 1 ) + 1.
DATA(lv_end) = c_pack_size * sy-index.
APPEND LINES OF lt_orders FROM lv_begin TO lv_end TO lt_pack.
LOOP AT lt_pack INTO DATA(ls_order).
push_order( is_order = ls_order iv_run = lv_run ).
lv_cnt += 1.
ENDLOOP.
COMMIT WORK AND WAIT. " 每包提交一次,缩小事务与锁范围
add_log( |第 { sy-index }/{ lv_packages } 包完成,累计 { lv_cnt } 条| ).
ENDDO.
lv_status = 'S'.
lv_msg = |成功处理 { lv_cnt } 条|.
CATCH cx_root INTO lx_error.
lv_status = 'E'.
lv_msg = lx_error->get_text( ).
ENDTRY.
" 5) 写日志落库 + 运行记录(失败记录不参与下次基线)
add_log( lv_msg ).
IF sy-batch = abap_true.
cl_bali_log_db=>get_instance( )->save_log(
log = mo_log assign_to_current_appl_job = abap_true ).
ENDIF.
write_run( iv_run = lv_run iv_from = lv_from iv_to = lv_to
iv_start = lv_start iv_status = lv_status
iv_cnt = lv_cnt iv_msg = lv_msg ).
IF lv_status = 'E'.
RAISE EXCEPTION TYPE cx_apj_rt_content EXPORTING previous = lx_error.
ENDIF.
ENDMETHOD.
3.5 辅助方法 + F9 自测入口
METHOD if_oo_adt_classrun~main.
mo_out = out.
DATA lt_parameters TYPE if_apj_rt_exec_object=>tt_templ_val.
" 模拟排期界面传参:勾"全量重跑",保证第一次就能看到数据
APPEND VALUE #( selname = 'P_FULL' sign = 'I' option = 'EQ' low = 'X' ) TO lt_parameters.
TRY.
if_apj_rt_exec_object~execute( it_parameters = lt_parameters ).
CATCH cx_apj_rt_content INTO DATA(lx_content).
out->write( |作业异常(后台会显示 Aborted):{ lx_content->get_text( ) }| ).
ENDTRY.
out->write( |F9 自测结束:检查 ZONLINESHOP_JOBRUN / ZONLINESHOP_JOBOUT| ).
ENDMETHOD.
METHOD add_log.
IF sy-batch = abap_true.
mo_log->add_item( item = cl_bali_free_text_setter=>create(
severity = if_bali_constants=>c_severity_information
text = iv_text ) ).
ELSEIF mo_out IS BOUND.
mo_out->write( iv_text ).
ENDIF.
ENDMETHOD.
METHOD get_baseline_date.
DATA: lv_last TYPE timestampl, lv_time TYPE sy-uzeit, lv_tz TYPE timezone.
" 基线 = 最近一次"成功"运行的结束时间;R/E 记录不参与
SELECT MAX( end_time ) FROM zonlineshop_jobrun
WHERE run_status = 'S'
INTO @lv_last.
IF lv_last IS INITIAL.
rv_date = c_init_from.
RETURN.
ENDIF.
TRY.
lv_tz = cl_abap_context_info=>get_user_time_zone( ).
CATCH cx_abap_context_info_error.
lv_tz = 'UTC'.
ENDTRY.
CONVERT TIME STAMP lv_last TIME ZONE lv_tz
INTO DATE rv_date TIME lv_time.
ENDMETHOD.
METHOD push_order.
" ★ 真实推送替换点:换成 05 章的 cl_web_http_client 调用/EML 调用即可
GET TIME STAMP FIELD DATA(lv_now).
DATA(ls_out) = VALUE zonlineshop_jobout(
order_uuid = is_order-order_uuid run_uuid = iv_run
order_id = is_order-order_id material = is_order-material
quantity = is_order-quantity sync_status = 'S'
sync_time = lv_now message = '练习模式:写本地结果表' ).
MODIFY zonlineshop_jobout FROM @ls_out.
ENDMETHOD.
METHOD write_run.
GET TIME STAMP FIELD DATA(lv_end).
DATA(ls_run) = VALUE zonlineshop_jobrun(
run_uuid = iv_run jobname = c_template
window_from = iv_from window_to = iv_to
start_time = iv_start end_time = lv_end
run_status = iv_status record_cnt = iv_cnt
message = CONV char255( iv_msg ) ).
MODIFY zonlineshop_jobrun FROM @ls_run.
COMMIT WORK AND WAIT.
ENDMETHOD.
3.6 验证(先 F9,再进后台)
在类编辑器里按 F9(Run As → ABAP Application (Console))。
Console 输出:
F9 控制台自测:不是 Application Job 实例(因为还没排期)→ 窗口信息 →待处理订单 N 条,分 x 包→ 每包完成 →成功处理 N 条→F9 自测结束。打开
ZONLINESHOP_JOBRUN的 Data Preview:新增 1 行,run_status = S、record_cnt = N、window_from = 20200101(全量模式)。打开
ZONLINESHOP_JOBOUT:每个订单 1 行,sync_status = S。再按一次 F9(把
main里的P_FULL那行注释掉再跑一次也行):新一行window_from变成上次成功记录的日期附近——基线自动推进;JOBOUT行数不翻倍(按订单号覆盖 = 幂等)。
⚠️ F9 自测同样会写运行记录、推进基线。要重新体验"首次全量",先清空两张表,或在 F9 里保留
P_FULL = 'X'。
4. 动手 3:建 Job Catalog Entry 与 Job Template(ADT)
4.1 Job Catalog Entry ZJCE_ONLINESHOP_SYNC
步骤 |
操作 |
填什么 |
|---|---|---|
1 |
右键包 → New → Other ABAP Repository Object → 搜 Job Catalog Entry → Next |
搜不到时搜 |
2 |
Name / Description |
|
3 |
Executable Class(可执行类) |
选 |
4 |
选 TR → Finish,打开条目核对 Parameters 区域 |
应列出 |
5 |
可选:给参数配显示文本、顺序、分组;需要下拉选择的参数配 Value Help(指向一个 CDS 视图) |
日期/勾选框由参数类型决定,不用手配 |
6 |
Ctrl+F3 激活 |
激活后系统自动生成对应 IAM App(命名规律 |
4.2 Job Template ZAJT_ONLINESHOP_SYNC
步骤 |
操作 |
填什么 |
|---|---|---|
1 |
右键包 → New → Other ABAP Repository Object → 搜 Job Template → Next |
— |
2 |
Name / Description |
|
3 |
Catalog Name(作业目录条目) |
|
4 |
选 TR → Finish,打开模板的 Parameters 页填默认值 |
|
5 |
Ctrl+F3 激活 |
报错先查:目录条目是否已激活、参数名是否与 |
验证:两个对象都激活、无红叉,且都挂在同一个 TR 里(Fiori 应用只消费已激活/已传输的模板,不建模板就选不到作业)。
5. 动手 4:Fiori 排期、监控与排错
本章没有 UI 截图:下面用"页面 → 字段 → 结果"写死操作路径。不同 release 的按钮可能是英文(Schedule/Create)或中文(计划/创建),以本机 D 租户版本为准。
5.1 排期(Schedule)
步骤 |
操作 |
填什么 / 期望 |
|---|---|---|
1 |
浏览器打开 D 租户 Fiori Launchpad(与 ADT 同一 SSO 账号) |
不用重新登录 |
2 |
搜索并打开应用 Application Jobs / 应用程序作业 |
没看到应用 = 缺 IAM 授权(见 5.3 与 08 章) |
3 |
Create / 创建(或直接在模板列表选中 |
打开参数页 |
4 |
选择作业模板 |
参数页自动预填模板默认值( |
5 |
首次验证建议勾 P_FULL(全量重跑),给作业起个名(Job Text,如 |
这样能立刻看到数据;日常增量不勾 |
6 |
计划设置:Start Immediately / 立即开始(或 Scheduled Start 填日期/时间/Time Zone 时区);重复频率选 Once / 一次(周期任务选 Daily/Weekly 并设结束条件) |
时区默认取用户时区,跨时区场景要显式确认 |
7 |
点 Schedule / 计划 提交 |
提示作业已创建,回到作业清单 |
5.2 监控(实例 / 日志 / 取消 / 重跑)
场景 |
在哪看 |
判据 / 说明 |
|---|---|---|
成功与否 |
作业清单(Instances/Jobs) |
状态 |
运行细节 |
打开作业 → Job Log / 作业日志 |
应看到:窗口、订单条数、每包进度、 |
实例号 |
作业详情表头 / 日志首行 |
也可在代码里用 |
取消 |
清单里勾选作业 → Cancel / 取消 |
运行中 = 终止;未开始 = 删除;周期作业会删整条周期链 |
重跑 |
复制/再次 Schedule;或用 API |
重跑前确认幂等(本练习结果表按订单号覆盖) |
确认业务结果 |
ADT 里 Data Preview 查 |
|
🔗 在 RAP action / 其他程序里触发作业,用已发布的作业 API:
cl_apj_rt_api=>schedule_job( iv_job_template_name = 'ZAJT_ONLINESHOP_SYNC' ... ),用get_job_status( )查状态、cancel_job( )取消——这就是"按钮立即推一批 + Job 兜底补推"组合拳里的 Job 侧(老章节的JOB_OPEN/JOB_CLOSE已被它取代,Day2 PPT slide 19「Maintaining Application Jobs Using an API」)。
5.3 排错表
现象 |
可能原因 |
处理 |
|---|---|---|
Fiori 里找不到应用/模板 |
模板未激活或未传到该租户;用户没有 IAM 授权 |
查 ADT 激活状态与 TR;按 08 章配 IAM App( |
参数页空白/报错 |
目录条目参数名与 |
两边改成完全一致后重新激活 |
作业 Finished 但没处理数据 |
增量窗口为空(基线已推进到今天) |
勾 |
作业 Aborted |
|
看 Job Log 最后一条;修数据/代码后重跑(E 记录不推进基线) |
日志里没有消息 |
没调 |
按 3.5 检查;日志对象/子对象必须激活并传输 |
作业跑很久/锁表 |
没有分包、一个长事务 |
分包 + 每包 |
6. 设计要点(新作业照着过一遍)
增量窗口:基线取"上次成功运行的结束时间",不是"本次开始时间";失败记录(
E)不推进基线,下一次自动重跑失败窗口。时区:不要写死
TIME ZONE 'UTC+8';用cl_abap_context_info=>get_user_time_zone( ),并记住作业以排期用户上下文运行——如果该用户时区是 UTC,窗口会偏,正式作业应把业务时区做成参数或固定值(我司zzcl_job_mm002的 +8h 硬编码与zzcl_job_sd005的'UTC+8'都属此类待改项)。幂等:窗口按天/时间戳取数都可能重复处理同一条;外部接口必须按业务键 upsert(本章结果表按
order_uuid覆盖写)。重跑不重复入账,比"保证不重跑"更现实。失败补推:两条口子——
JOBRUN里E记录重跑整个窗口;JOBOUT里sync_status='E'精确补推。正式项目建议"先补 E 再跑新窗口"。锁与并发:同一模板别排出重叠实例(周期 ≥ 最长运行时间);需要强互斥时用锁对象,或用"运行中(R)记录 + 超时清理"做互斥。
大数据量:分包 + 每包提交;日志按"包"写而不是按"行"写,否则日志表会炸。
什么时候不用 Job:用户点按钮触发的动作用 RAP action(04 章);单据保存时的同步校验用 determination/validation;界面实时交互绝不塞后台。组合拳:按钮走 action 立即推一批,Job 夜间补推失败记录。
7. 公司实践:四个真实 Job 走查(📦)
📦 [代码] 四个包的 Job 类都在 docs/顾问开发的代码--现有线上代码/ 下(路径相对该目录:sap-zzmm-master/src/、sap-fi-master/src/、sap-zzsd-master/src/),全部实现 if_apj_dt_exec_object + if_apj_rt_exec_object + if_oo_adt_classrun 三接口,命名 ZZCL_JOB_<模块><NNN>,模板 ZAJT_* / ZZ_JT_*,目录条目 ZJCE_* / ZZ_JCE_*,业务目录 ZZ_BC_JOB_*(.sia1 权限目录 + .sia7 角色)。
类 |
场景 |
关键实现(行号) |
值得学 / 要改 |
|---|---|---|---|
|
物料增量扩充库位并推送 |
L24–43 时间转 UTC 再 +8h;L50–53 读 |
教学样板:增量窗口 + released CDS 取数 + EML 改标准 BO 的完整组合。两个待改点见下 |
|
费用/成本中心数据推送 FII002 |
L19–77 execute:组 filters → |
参数声明了但 execute 里根本没解析(死参数);日志里 |
|
企业项目数据推送 FII003 |
L21–22 |
无应用日志 → 排障只能看作业状态; |
|
销售价格条件推送 MES |
L50–58 解析 |
最完整样板:公共工具取基线、失败补推、分包、日志齐全。可改进: |
两个批判点(老章节说的就是我司模式的两个坑,这里给证据):
时区硬编码:
zzcl_job_mm002L36–39 手工+8*3600秒,zzcl_job_sd005L62 直接TIME ZONE 'UTC+8'——迁海外租户/换夏令时就错窗。新作业按 §6 第 2 条改。基线时机与"失败也推进":
zzcl_job_mm002L174–178 在 execute 末尾无条件回写基线,而 L143–163 的 EMLfailed/reported只收进变量、没有中断流程 → 失败的数据下一轮窗口不会再来,等于漏推;基线用的还是"进入时刻"(L26–43)。新作业按本章写法:只有S才推进基线,失败落E记录 + 结果表补推。
授权与发布:Job Catalog Entry 激活后自动生成 IAM App(命名 <目录条目>_SAJC),授权对象是 S_START(启动 TADIR 对象检查);配置里能查到实例:sap-zzmm-master/src/zz_bc_job_mm002.sia1.xml 的 APP_ID = ZZCL_JCE_MM002_SAJC(同一目录还挂了维护应用 ZUI_ZTMM003_MBC,业务用户排完作业还能维护配置表 ZZT_MM003);sap-zzsd-master/src/36024fe65c…ht.sush.xml 的 DISPLAY_NAME = R3TR SAJC ZZ_JCE_SD005。业务用户要能排期/看日志,必须走 08 章的"业务目录 → 业务角色"链路;只激活不授权,应用里看不到模板。
8. 检查清单
能说出 Application Job 四件套(实现类 → 目录条目 → 模板 → Fiori 排期)各自建在哪、谁维护
两接口的职责分得清:
get_parameters只管参数定义/默认值,业务逻辑全在execute实现类通过 F9 自测:控制台有输出、
JOBRUN有S记录、JOBOUT有结果第二次运行窗口自动前进(基线 = 上次成功结束),结果不重复
ADT 里 Job Catalog Entry + Job Template 激活并挂 TR;Fiori 里能排期出
Finished实例作业详情能读到 Application Log(
ZONLINESHOP_ALOG/SYNC),失败时能看到E记录与日志能复述我司
zzcl_job_mm002的增量窗口逻辑,并指出 +8h 硬编码、失败仍推进基线两个问题知道"重跑靠幂等、补推靠结果表",并知道作业的用户授权在 08 章
➡️ 下一步
下一章:07 · 分析报表(Embedded Analytics)与自定义 UI——本章的
ZONLINESHOP_JOBRUN天然是报表数据源,下一章教你用 CDS custom entity + unmanaged query 把它做成可筛选的分龄/趋势报表。主线回顾:01 · 环境准备与开发工具 → 03 · 门② ABAP Cloud 基础与数据字典 → 04 · 门② RAP 业务对象开发