Oracle APEX中如何创建返回项目当前流程步骤的SQL函数

• 语法层面缺失关键子句：直接执行SELECT查询未加INTO子句承接返回结果，后续判断中直接引用表列名的写法在Oracle PL/SQL中是非法的，会直接触发编译报错
• 返回值定义不规范：Oracle中函数返回VARCHAR类型必须指定长度，且推荐使用原生的VARCHAR2类型，否则会报类型定义错误
• 逻辑判断有遗漏：没有覆盖“项目刚创建、还未提交审批”的初始状态，遇到这类项目会返回空值
• 判断逻辑虽然顺序碰巧从后往前匹配，但如果后续新增流程节点很容易出现优先级错配，没有明确的优先级规则
• 缺少边界校验：传入不存在的项目ID时没有对应提示，也没有异常捕获机制，遇到数据异常会直接抛出系统级错误

CREATE OR REPLACE FUNCTION progress(p_project_id IN NUMBER) RETURN VARCHAR2(100) IS
  -- 定义本地变量承接各流程节点的匹配结果
  v_send_approval_id send_for_approval.id%TYPE;
  v_approval_id approval.id%TYPE;
  v_start_project_id start_project.id%TYPE;
  v_project_record_cnt NUMBER;
BEGIN
  -- 先校验传入的项目ID是否存在
  SELECT COUNT(1)
    INTO v_project_record_cnt
  FROM project
  WHERE id = p_project_id;

  IF v_project_record_cnt = 0 THEN
    RETURN 'No project matching the input ID';
  END IF;

  -- 关联查询各流程节点数据，通过INTO绑定到本地变量
  SELECT send_for_approval.id, approval.id, start_project.id
    INTO v_send_approval_id, v_approval_id, v_start_project_id
  FROM project
  LEFT JOIN send_for_approval ON send_for_approval.id_project = project.id
  LEFT JOIN approval ON approval.id_project = project.id
  LEFT JOIN start_project ON start_project.id_project = project.id
  WHERE project.id = p_project_id;

  -- 按流程节点的推进倒序判断，越靠后的节点优先级越高
  IF v_start_project_id IS NOT NULL THEN
    RETURN 'Current step is the start of the project';
  ELSIF v_approval_id IS NOT NULL THEN
    RETURN 'Current step is approval';
  ELSIF v_send_approval_id IS NOT NULL THEN
    RETURN 'Current step is send for approval';
  ELSE
    RETURN 'Current step: project created, waiting to submit for approval';
  END IF;

-- 异常捕获块，避免直接抛出系统错误
EXCEPTION
  WHEN OTHERS THEN
    RETURN 'Function execution failed: ' || SQLERRM;
END progress;
/

• PL/SQL中所有SELECT返回的列，必须通过INTO子句赋值给预先定义的本地变量，不能在查询结束后直接引用原表的列名做逻辑判断，这是原代码无法运行的最核心原因
• 流程状态判断必须遵循后置节点优先匹配的规则：比如已经走到项目启动环节的项目，必然已经经过了提交审批、内部审批的步骤，必须先判断最高优先级的启动状态，否则会返回更早的错误流程节点
• 建议给后续新增的流程节点（比如结项、验收）按同样的优先级规则补充判断分支，避免逻辑错配
• 函数返回长度根据实际需要的文案长度配置，避免出现返回值被截断的问题

内容的提问来源于stack exchange，提问作者imstuckaf