plsql - 如何从插件 SQL 源代码中的 Region Source SQL Select 语句获取结果表？

Question

我目前正在为区域开发一个 APEX 插件。它使用 SELECT 执行一些 JavaScript 代码结果转换为字符串。但出于测试原因，SELECT查询暂时写入插件的Source PL/SQL Code。

源代码如下所示:

FUNCTION f_render (p_region in apex_plugin.t_region, p_plugin in apex_plugin.t_plugin)
RETURN apex_plugin.t_region_render_result IS 
  v_js VARCHAR(512);
  v_data VARCHAR(1024);
BEGIN
  SELECT '[' || c_matrix || ']' INTO v_data FROM (
    SELECT listagg(c_row, ',') WITHIN GROUP (ORDER BY c_row) AS c_matrix FROM (
      -- next line should be re-written 
      -- for compatibility with any possible origin or target string 
      -- values and numbers, but it's another question
      SELECT '[' || "'a'" || ',' || "'b'" || ']' AS c_row FROM ( 
        -- actual test table query that should be in p_region.source
        WITH t0 AS ( 
          SELECT 'a' origin, 'a' target, 11 amount FROM dual UNION ALL
          SELECT 'a', 'b', 21 FROM dual UNION ALL
          SELECT 'b', 'a', 12 FROM dual UNION ALL
          SELECT 'b', 'b', 22 FROM dual
        ), t1 AS (
          SELECT * FROM t0
          PIVOT ( sum(amount) for target in ('a','b'))
          ORDER BY origin
        )
        SELECT * FROM t1
      )
    )
  ); 
  v_js := q'[
    console.log("@DATASTRING@");
  ]';
  v_js := REPLACE(v_js, '@DATASTRING@', v_data);
  apex_javascript.add_onload_code(p_code => v_js, p_key => null);
  RETURN NULL;
END f_render; 

《实测表》 SELECT返回此 t1 table :

|ORIGIN|'a'|'b'|
|------|---|---|
| a    | 11| 21|
| b    | 12| 22|

console.log打印这样的字符串: [[11,21],[12,22]] .而且，如果我调整一些东西，这个插件甚至会在浏览器控制台中返回这个 JS 数组作为......一个 JS 数组，因为它应该。

目前这些是必需的和正确的结果。 但是如果我更改“实际测试表” SELECT至 p_region.source并把这个 SELECT在 Source: SQL Query在 Page Designer ，它根本不起作用， APEX由于某些错误，不想保存此插件。
p_region.source应该可以使用任何 SELECT , 甚至像 SELECT * FROM table_A 这样简单的东西, 其中 table_A是类似于“实际测试表” t1 的旋转矩阵.

问题:如何正确引用 p_region.source 中的查询结果让这一切正常工作？ AFAIK，可以使用 APEX_PLUGIN_UTIL.GET_DATA 来完成或 .GET_DATA2 .但我不知道它返回什么以及如何以及在哪里测试它。我想在 dbfiddle 之类的东西中使用它来了解它的作用。

PS:我是前端初级，但是我的老板不管我的资历都给了我这个任务。在这种情况下，Oracle 文档也不是很有帮助。

Answer 1

首先，总体上什么会帮助你发展。在开发 Region Plug-in 时，有两种查看调试信息的方法:将常规数据记录到表中或直接在页面上输出。对于第一种方式(登录到表)，您需要创建一个表(具有您需要的任何结构)并从您的 PL/SQL 代码中插入行。第二种方式使用 htp.p 过程直接在网页中输出数据。例如，如果您将以下代码放入您的渲染插件函数中:

select some_value
  into v_variable
  from table1
 where ... ;

htp.p('Variable contains: ' || v_variable || '<br />');

此代码将创建如下内容:

<div> <!-- open and close div tags are generated by APEX engine -->
  Variable contains: 123<br />
</div>

您需要创建一个页面，创建一个带有您的插件类型的区域，然后在浏览器中打开该页面。之后，您将看到输出。

接下来，如何处理 SQL 查询。 APEX_PLUGIN_UTIL.GET_DATA 返回一个 apex_plugin_util.t_column_value_list 类型的值，它只是字符串集合的集合。你必须使用这个函数的主要原因是它还可以绑定(bind)SQL代码中的任何绑定(bind)变量。例如，如果您有一个页面项 P1_VALUE 并希望在查询中使用它的值，您可以输入区域的源:

select *
  from table
 where column1 = :P1_VALUE

APEX_PLUGIN_UTIL.GET_DATA 将自动在此处绑定(bind)项目的值。

如何处理结果。以下代码将输出一个简单的 html 表格:

  ...
  v_data apex_plugin_util.t_column_value_list;
begin
  ...
  v_data := apex_plugin_util.get_data(p_region.source, 1, 10, p_region.name);

  htp.p('<table><tbody>');

  for i in v_data.first .. v_data.last loop
    htp.p('<tr>');

    for j in v_data(i).first .. v_data(i).last loop
      -- your code to process data
      htp.p('<td>' || v_data(i)(j) || '</td>');
    end loop;

    htp.p('</tr>');
  end loop;
  htp.p('</tbody></table>');
  ...
end;

请注意，此函数(出于某种原因)返回一个转置表。因此，如果您有一个包含两列和三行的表:

COL1  COL2
----------
abc    123
def    456
ghi    789

上面代码的输出将是:

<table>
  <tbody>
    <tr>
      <td>abc</td><td>def</td><td>ghi</td>
    </tr>  
    <tr>
      <td>123</td><td>456</td><td>789</td>
    </tr>
  </tbody>
</table>