APEX Oracle文本项多行值填充问题：内容显示但未换行

排查与解决步骤 #

• 验证SQL查询有效性：单独执行填充用的SQL语句，检查是否返回预期结果。重点核对WHERE条件中的绑定变量值是否正确，是否因过滤规则过严导致无数据。
• 检查文本项属性：
  • 确认项类型为多行文本区域（Textarea）或单行文本框（按需选择），且未设置隐藏状态。
  • 确保项的“可更新”属性为“是”，否则赋值后无法正常显示。
• 规范赋值方式：
  • 若查询返回单行数据，使用直接赋值：

    :P_10_TEXTITEM := (SELECT column_name FROM your_table WHERE condition);
    

  • 若查询返回多行数据，需用LISTAGG聚合函数拼接或循环赋值，避免因多行结果导致赋值失败。
• 权限与调试：
  • 确认执行SQL的用户拥有目标表的查询权限。
  • 开启APEX调试模式查看赋值过程是否报错；或在PL/SQL块中加入DBMS_OUTPUT.PUT_LINE输出查询结果，验证数据是否正常获取。

排查与解决步骤 #

• 确认文本项类型：必须将P18_SHARED_NEW_COMMISSIONS设置为多行文本区域（Textarea），单行文本框无法解析换行符。
• 优化换行符适配：
  • 替换chr(13)||chr(10)为APEX_UTIL.NEW_LINE，该常量会自动适配操作系统的换行规则：

    :P18_SHARED_NEW_COMMISSIONS := :P18_SHARED_NEW_COMMISSIONS || row.EName || ': ' || NVL(row.Comm, 'N/A') || APEX_UTIL.NEW_LINE;
    

  • 若仍无效，可尝试单独使用chr(10)（适用于Linux/Unix环境）。
• 初始化变量：循环前清空目标项，避免旧值干扰拼接结果：

  :P18_SHARED_NEW_COMMISSIONS := NULL; -- 循环前添加
  for row in (select EName, Comm from EMP
               where instr( ':'||:P18_SHARED_SALESMAN||':',  ':'||EmpNo||':' ) > 0 )
  loop
        :P18_SHARED_NEW_COMMISSIONS := :P18_SHARED_NEW_COMMISSIONS || row.EName || ': ' || NVL(row.Comm, 'N/A') || APEX_UTIL.NEW_LINE; 
  end loop;
  

• 处理NULL字段：用NVL函数替换Comm字段的NULL值，避免出现“XXX: ”的不整齐显示：

  row.EName || ': ' || NVL(row.Comm, 0) -- 或替换为'无提成'等自定义文本
  

• 替代循环的高效方案：使用LISTAGG函数直接拼接，无需循环且换行更可靠：

  SELECT LISTAGG(EName || ': ' || NVL(Comm, 'N/A'), APEX_UTIL.NEW_LINE) WITHIN GROUP (ORDER BY EName)
  INTO :P18_SHARED_NEW_COMMISSIONS
  FROM EMP
  WHERE INSTR(':'||:P18_SHARED_SALESMAN||':', ':'||EmpNo||':') > 0;
  

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