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

Question

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

源代码看起来像这样：

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表：

|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 Documentation也不是很有帮助。

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的值，该值只是字符串集合的集合。您必须使用此函数的主要原因是它还可以绑定SQL代码中的任何绑定变量。例如，如果您有一个页面项P1_VALUE并想在查询中使用它的值，您可以放入区域的源：

select *
  from table
 where column1 = :P1_VALUE

APEX_PLUGIN_UTIL.GET_DATA将自动绑定项目的值。

如何处理结果。以下代码将输出一个简单的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>