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

ZONLINESHOP_JOBRUN

数据库表

每次运行记一条;基线 = 最近一条成功记录

2

ZONLINESHOP_JOBOUT

数据库表

每条订单的推送结果(按订单号覆盖 = 幂等;失败可补推)

3

ZONLINESHOP_ALOG

应用日志对象(APLO)

作业日志,Fiori 作业详情里可读

4

ZCL_ONLINESHOP_JOB_SYNC

实现类

if_apj_dt_exec_object + if_apj_rt_exec_object + F9 自测

5

ZJCE_ONLINESHOP_SYNC

Job Catalog Entry

绑定实现类,声明参数(= 老系统的选择屏)

6

ZAJT_ONLINESHOP_SYNC

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 报表 + SUBMIT ... VIA JOB

没有 SM36/SM37 事务码;ABAP Cloud 不提供"把 REPORT 提交到后台"的入口

实现类 + Application Job(本章)

JOB_OPEN / JOB_CLOSE 函数排期

不在 ABAP Cloud 可用/已发布的 API 范围

cl_apj_rt_api=>schedule_job(见 §5.2)

BDC / SHDG 录屏批导 + SM35

没有 Dynpro 屏幕可录,也没有 SM35

批量走 API/RAP action;大数据量交给 Job 调 API

后台 RFC、IN BACKGROUND TASK 当定时器

不可"排期、监控、授权",不属于应用作业体系

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 右键包 Z_Onlineshop → New → Other ABAP Repository Object → 搜 database table → Next

与 03 章建表同一入口

2

Name / Description

ZONLINESHOP_JOBRUN / Online shop job run history

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);
}

字段

用途

run_uuid

每次运行一个 UUID(作业没有自增号,用 UUID 做主键)

window_from / window_to

本次实际处理的增量窗口(日期),排障第一眼看它

start_time / end_time

运行起止时间戳(UTC),用于算耗时与下次基线

run_status

R 运行中 / S 成功 / E 失败——只有 S 参与基线与补推

record_cnt / message

处理条数 + 结果摘要,和作业日志互相印证

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

ZONLINESHOP_ALOG / Online shop job log

3

选 TR → Finish,在编辑器里加一个 Subobject:Name SYNC、Description Order sync

代码里 create_with_header 用 object='ZONLINESHOP_ALOG'、subobject='SYNC'

4

Ctrl+F3 激活

Problems 无红叉

📦 我司统一复用日志对象 ZZ_ALO_API + 子对象 ZZ_ALO_API_SUB(见 sap-fi-master/src/zzcl_job_fi008.clas.abap L119–120、zzcl_job_fi010.clas.abap L62–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

ZCL_ONLINESHOP_JOB_SYNC / Online shop order sync job

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.

参数

kind

界面控件

语义

P_FROM

select_option(区间)

日期范围

手工指定增量起点;留空 = 跟随基线

P_FULL

parameter(单值)

勾选框

勾上 = 忽略基线,从 c_init_from 全量重跑

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,再进后台)

  1. 在类编辑器里按 F9(Run As → ABAP Application (Console))。

  2. Console 输出:F9 控制台自测:不是 Application Job 实例(因为还没排期)→ 窗口信息 → 待处理订单 N 条,分 x 包 → 每包完成 → 成功处理 N 条 → F9 自测结束。

  3. 打开 ZONLINESHOP_JOBRUN 的 Data Preview:新增 1 行,run_status = S、record_cnt = N、window_from = 20200101(全量模式)。

  4. 打开 ZONLINESHOP_JOBOUT:每个订单 1 行,sync_status = S。

  5. 再按一次 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

搜不到时搜 Application Job / 在 Others 下找,以本机 ADT 版本为准

2

Name / Description

ZJCE_ONLINESHOP_SYNC / 在线商店订单增量同步作业

3

Executable Class(可执行类)

选 ZCL_ONLINESHOP_JOB_SYNC

4

选 TR → Finish,打开条目核对 Parameters 区域

应列出 P_FROM / P_FULL;没带出来就 Add 手工加,Name 必须与 get_parameters 的 selname 完全一致

5

可选:给参数配显示文本、顺序、分组;需要下拉选择的参数配 Value Help(指向一个 CDS 视图)

日期/勾选框由参数类型决定,不用手配

6

Ctrl+F3 激活

激活后系统自动生成对应 IAM App(命名规律 <目录条目>_SAJC),授权见 §7

4.2 Job Template ZAJT_ONLINESHOP_SYNC

步骤

操作

填什么

1

右键包 → New → Other ABAP Repository Object → 搜 Job Template → Next

—

2

Name / Description

ZAJT_ONLINESHOP_SYNC / 在线商店订单增量同步

3

Catalog Name(作业目录条目)

ZJCE_ONLINESHOP_SYNC

4

选 TR → Finish,打开模板的 Parameters 页填默认值

P_FROM 留空(跟随基线)、P_FULL 不勾

5

Ctrl+F3 激活

报错先查:目录条目是否已激活、参数名是否与 selname 一致

验证:两个对象都激活、无红叉,且都挂在同一个 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 / 创建(或直接在模板列表选中 ZAJT_ONLINESHOP_SYNC 后点 Schedule / 计划)

打开参数页

4

选择作业模板 ZAJT_ONLINESHOP_SYNC

参数页自动预填模板默认值(P_FROM 空、P_FULL 未勾)

5

首次验证建议勾 P_FULL(全量重跑),给作业起个名(Job Text,如 首次全量验证)

这样能立刻看到数据;日常增量不勾

6

计划设置:Start Immediately / 立即开始(或 Scheduled Start 填日期/时间/Time Zone 时区);重复频率选 Once / 一次(周期任务选 Daily/Weekly 并设结束条件)

时区默认取用户时区,跨时区场景要显式确认

7

点 Schedule / 计划 提交

提示作业已创建,回到作业清单

5.2 监控(实例 / 日志 / 取消 / 重跑)

场景

在哪看

判据 / 说明

成功与否

作业清单(Instances/Jobs)

状态 Running → Finished;失败显示 Aborted(红)

运行细节

打开作业 → Job Log / 作业日志

应看到:窗口、订单条数、每包进度、成功处理 N 条(就是 add_log 写的内容)

实例号

作业详情表头 / 日志首行

也可在代码里用 cl_apj_rt_api=>get_job_runtime_info( ) 取 jobname/jobcount 写进日志,便于和结果表对账

取消

清单里勾选作业 → Cancel / 取消

运行中 = 终止;未开始 = 删除;周期作业会删整条周期链

重跑

复制/再次 Schedule;或用 API cl_apj_rt_api=>schedule_job

重跑前确认幂等(本练习结果表按订单号覆盖)

确认业务结果

ADT 里 Data Preview 查 ZONLINESHOP_JOBRUN / _JOBOUT

JOBRUN 有 S 记录且 record_cnt 与日志一致;JOBOUT 每个订单 1 行

🔗 在 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(*_SAJC)+ 业务目录 + 业务角色

参数页空白/报错

目录条目参数名与 selname 不一致(大小写、下划线)

两边改成完全一致后重新激活

作业 Finished 但没处理数据

增量窗口为空(基线已推进到今天)

勾 P_FULL 全量重跑,或排期时填 P_FROM 验证

作业 Aborted

execute 抛了未捕获异常(本章代码会把错误写入 E 记录后再抛 cx_apj_rt_content)

看 Job Log 最后一条;修数据/代码后重跑(E 记录不推进基线)

日志里没有消息

没调 save_log、没加 assign_to_current_appl_job、日志对象没激活

按 3.5 检查;日志对象/子对象必须激活并传输

作业跑很久/锁表

没有分包、一个长事务

分包 + 每包 COMMIT WORK AND WAIT(本章写法)


6. 设计要点(新作业照着过一遍)

  1. 增量窗口:基线取"上次成功运行的结束时间",不是"本次开始时间";失败记录(E)不推进基线,下一次自动重跑失败窗口。

  2. 时区:不要写死 TIME ZONE 'UTC+8';用 cl_abap_context_info=>get_user_time_zone( ),并记住作业以排期用户上下文运行——如果该用户时区是 UTC,窗口会偏,正式作业应把业务时区做成参数或固定值(我司 zzcl_job_mm002 的 +8h 硬编码与 zzcl_job_sd005 的 'UTC+8' 都属此类待改项)。

  3. 幂等:窗口按天/时间戳取数都可能重复处理同一条;外部接口必须按业务键 upsert(本章结果表按 order_uuid 覆盖写)。重跑不重复入账,比"保证不重跑"更现实。

  4. 失败补推:两条口子——JOBRUN 里 E 记录重跑整个窗口;JOBOUT 里 sync_status='E' 精确补推。正式项目建议"先补 E 再跑新窗口"。

  5. 锁与并发:同一模板别排出重叠实例(周期 ≥ 最长运行时间);需要强互斥时用锁对象,或用"运行中(R)记录 + 超时清理"做互斥。

  6. 大数据量:分包 + 每包提交;日志按"包"写而不是按"行"写,否则日志表会炸。

  7. 什么时候不用 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 角色)。

类

场景

关键实现(行号)

值得学 / 要改

zzcl_job_mm002

物料增量扩充库位并推送

L24–43 时间转 UTC 再 +8h;L50–53 读 ZTJOB_LOG 取基线;L57–85 按 creationdatetime 窗口查 released CDS I_Product;L87–171 批量校验工厂/库位(i_productplantbasic、i_storagelocation、i_productstoragelocationbasic + 配置表 zzt_mm003),缺失则 EML MODIFY ENTITIES OF i_producttp_2 扩充;L174–178 回写基线;L182–192 F9 自测

教学样板:增量窗口 + released CDS 取数 + EML 改标准 BO 的完整组合。两个待改点见下

zzcl_job_fi010

费用/成本中心数据推送 FII002

L19–77 execute:组 filters → zzcl_query_fi002->read_data → CALL FUNCTION 'ZZFM_FII002';L60–77 写日志;L81–91 get_parameters 声明勾选框 JOB(增量推送)

参数声明了但 execute 里根本没解析(死参数);日志里 lv_text 赋值被注释(L67),循环加的是空条目

zzcl_job_fi011

企业项目数据推送 FII003

L21–22 get_parameters 空;L25–29 execute 直接调 send_data( );L42–80 用 i_enterpriseproject WITH PRIVILEGED ACCESS 取数 + ZZFM_FII003

无应用日志 → 排障只能看作业状态;PRIVILEGED ACCESS 绕过权限,后台作业可接受但要留痕

zzcl_job_sd005

销售价格条件推送 MES

L50–58 解析 JOB 参数;L60–72 zzcl_comm_tool=>get_last_execute( lv_numb ) 取上次执行时间 + 'UTC+8' 换算;L74–91 先捞失败记录(zztsd007.send_num <= 10)再重推;L93–164 增量查询 + HTTP 调标准 API + 合并去重;L168–207 包大小从 zzt_rest_append 读(默认 1000)+ 分包推送;L190–234 Application Log 每包一条

最完整样板:公共工具取基线、失败补推、分包、日志齐全。可改进:'UTC+8' 硬编码;HTTP 逻辑与作业逻辑耦合在一起

两个批判点(老章节说的就是我司模式的两个坑,这里给证据):

  1. 时区硬编码:zzcl_job_mm002 L36–39 手工 +8*3600 秒,zzcl_job_sd005 L62 直接 TIME ZONE 'UTC+8'——迁海外租户/换夏令时就错窗。新作业按 §6 第 2 条改。

  2. 基线时机与"失败也推进":zzcl_job_mm002 L174–178 在 execute 末尾无条件回写基线,而 L143–163 的 EML failed/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 章


➡️ 下一步