DAJAXValidationItem

With the experiences from my last plug in I wrote a second more powerful validation plug in. It can validate against a user defined PL/SQL function and gives the developers the flexibility to write their own validation directly in the item.

• Demo
• DAJAXValidationItem Download

DAJAXValidationItem Settings

DRegExItem

With ApEx 4 we are able to shift a few kinds of validation directly to the items. Some of them are released with ApEx 4 like the “Number Textfield” or the “Value Required” selection box within the item configuration. But there are several other syntax related validations like telephone number, zip code or email addresses. Therefore I wrote a plug in, that validate the value against a Regular Expression and we can move most of the syntax validations to our items and making them responsible for that.

For a better usability, I build a AJAX process in which shows mismatches directly after the changes and not after submitting the page. Since Oracle and JavaScript use different flavors of Regular Expressions I need to implement an AJAX process, that validate against Oracle POSIX Expressions and not to the PERL Expressions, which is used by JavaScript.

• Demo
• DRegExItem Download

The settings for the DRegExItem Plug In are straight forward and easy to set up:

DRegExItem Settings

Execute the statement as sysdba

-- restricted to local access only
EXEC DBMS_XDB.SETLISTENERLOCALACCESS(TRUE);

-- allow remote access
EXEC DBMS_XDB.SETLISTENERLOCALACCESS(FALSE);

DTreeTable ApEx Plugin puts hierarchical data in columns, but use an indented outline structure in the first column to illustrate the tree structure.

Combining the two data-viewing approaches into one view gives you the best of both worlds. You can show the hierarchy of items, plus a matrix of additional data or item attributes, in one unified structure.

You can download the plugin at
http://www.apex-plugin.com/oracle-apex-plugins/region-plugin/treetable.html

You can find a working example in my Demo Application

Watching in the source code I found that the table for the data is marked with a numeric identifier, so every data grid has an own unique name. When you set up a Advance Dynamic Action you can set the “Selection Type” to “DOM” and enter the numeric identifier as DOM object. Setting the “Event Scope” to “Live” and adding a True Action and you are finished until you copy the application within the workspace or to another system, because the identifier could be changed by ApEx.

But there is also a way to solve this problem:
1. Add a “Hidden” Page Item, e.g. P5_IR_ID
2. Add a “New Instance/After Authentication” Computation for the hidden Page Item with the following computation of Type “SQL Query (return single value)”:

   SELECT interactive_report_id
   FROM apex_application_page_ir
   WHERE application_id = :APP_ID
   AND page_id           = :APP_PAGE_ID;
   

   

3. Create a Dynamic Action:
   • Event: After Refresh
   • Selection Type: DOM
   • DOM Object: &P5_IR_ID.
   • Event Scope: live
   • Add all the True Actions you need. In my example I added an Alert action.

   

This solution will always fetch the correct Interactive Report id. You can find a working example at my Demo Application

Auch die Darstellung von mehreren Monaten gleichzeitig ist da leider nicht möglich. Um jedoch diese Features auch in einer Tabular Form nutzen zu können, gibt es momentan folgenden Workaround:

1. Wir fügen einfach einen Datepicker mit den Features, die wir haben wollen als PageItem in die Tabular Form Region ein und blenden die mit Hilfe von Stylesheets “display: none” aus. Dieser überlagert die Konfiguration von den Datepickern aus der Tabular Form mit den Einstellungen aus dem vom Page Item

Ist der Dummy Datepicker da, funktionieren die Features auch global für alle Datepicker in der Tabular Form:

Zu bewundern ist das auf meiner Demo Applikation. Ich bin gespannt, wie lange dieser Workaround funktioniert, hoffentlich so lange, bis der Datepicker in der Tabular Form auch konfigurierbar ist.

TreeTable

Aus einer Kopie vom StandardReport Template habe ich ein neues Template für ein TreeTable Template erstellt. Das Theme dafür findet ihr hier: theme_treetable_101.sql

Für das SQL-Statement gibt es ein paar Kleinigkeiten zu beachten, damit das TreeTable Template auch sauber funktioniert. Hier das Beispiel aus meiner Demo-Applikation:

SELECT
apex_item.hidden(1, levelno) HIDDEN,
ROWNUM,
(apex_item.display_and_save(4, ename) ename,
(SELECT COUNT(*) FROM emp e1 WHERE e1.mgr = e.empno
) employee,
empno
FROM
(SELECT empno,
ename,
level AS llevelnovl
FROM emp
START WITH empno       = 7839
CONNECT BY prior empno = mgr
) e

Damit das Template auch erwartungsgemäß funktioniert gibt es ein paar Dinge zu beachten:

1. Es wird immer anhand des Wertes von ‘levelno’ eingerückt. Damit das Template weiß wo er den Wert der Einrückung findet, muss es in einem apex_item mit dem Index 1 sein.
2. Die Einrückung wird immer auf das apex_item Feld mit dem Index 2 ausgeführt

Die Bilder für die Icons sind im Template in den Stylesheets definiert und können da ausgetauscht werden.

Aus den oben genannten Umständen hat sich das folgende Script mir als echte Arbeitshilfe erwiesen, welches man einfach in eine PL/SQL Region auf einer ApEx Seite einbindet. Viel Spaß damit!

DECLARE
  l_vc_fields htmldb_application_global.vc_arr2;
  v_clob clob;
  v_count   NUMBER;
  v_length  NUMBER := 1000;
  v_out     varchar2(32000);
  v_fields  varchar2(32000) := 'PACKAGE:VIEW:TRIGGER:FUNCTION:PROCEDURE';
  v_schema varchar2(40);
begin
  -- set default schema
  v_schema := apex_util.get_default_schema;

  l_vc_fields := htmldb_util.string_to_table (v_fields, ':');
  FOR j       IN 1 .. l_vc_fields.count
  loop
    htp.prn('<h1>' || l_vc_fields(j) || ' in ' || v_schema || '</h1>');
    htp.p('<textarea style="width: 950px; height: 150px">');
    htp.prn('SET SCAN OFF');
    -- get all objects
    FOR i IN
    (SELECT DISTINCT object_name,
      object_type
    FROM sys.all_objects
    where upper(object_type) = l_vc_fields(j)
    AND owner                = v_schema
    )
    loop
        SELECT REPLACE(REPLACE(dbms_metadata.get_ddl(i.object_type, i.object_name), '"' || v_schema || '".', ''), v_schema || '.', '')
        INTO v_clob
        FROM dual;
        -- add slash between header and body definition
        IF l_vc_fields(j) = 'PACKAGE' THEN
          v_clob         := REPLACE(v_clob, 'CREATE OR REPLACE PACKAGE BODY', '/' || chr(10) || 'CREATE OR REPLACE PACKAGE BODY');
        END IF;
        -- add slash between trigger defnition and alter statement
        IF l_vc_fields(j) = 'TRIGGER' THEN
          v_clob         := REPLACE(v_clob, 'ALTER TRIGGER', '/' || chr(10) || 'ALTER TRIGGER ');
        END IF;
        -- split clob in substrings
        v_count            := 1;
        v_out              := dbms_lob.substr(v_clob,v_length,v_count);
        WHILE LENGTH(v_out) > 0
        LOOP
          htp.prn(v_out);
          v_count := v_count + v_length;
          v_out   := dbms_lob.substr(v_clob,v_length,v_count);
        END LOOP;
        -- add semicolon after each statement for create view
        IF l_vc_fields(j) = 'VIEW' THEN
          htp.prn(';');
        ELSE
          htp.prn(chr(10) || '/');
        end if;
      END LOOP;
    htp.p('</textarea>');
  END LOOP;
exception when
  others then
  htp.prn(sqlerrm);
end;

Oracle hat ApEx in der Version 4.0 in seiner API drei neue Prozeduren für den Interactive Report spendiert:

• APEX_UTIL.IR_CLEAR
• APEX_UTIL.IR_FILTER
• APEX_UTIL.IR_RESET

Damit lassen sich zusammen mit der neuen Möglichkeit von “Dynamic Actions” relativ einfach und schnell vordefinierte Filter für den Interactive Report implementieren. Demo

Interactive Report - Predefined Filter

In dem Beispiel habe ich Buttons erzeugt, die mir entsprechende Filter auf den Interactive Report setzen. Dafür habe ich eine neue Dynamic Action erzeugt:

1. Advanced Dynamic Action
2. Event: Click
3. Selection Type: Item(s)
4. Item(s): P2_FILTER_BUTTON
5. Condition: – No Condition -
6. Action: Execute PL/SQL Code
7. Fire on Page Load: false
8. PL/SQL Code:

BEGIN
APEX_UTIL.IR_RESET(
p_page_id => :APP_PAGE_ID,
p_report_alias => NULL
);

APEX_UTIL.IR_FILTER(
p_page_id => :APP_PAGE_ID,
p_report_column => 'JOB',
p_operator_abbr => 'IN',
p_filter_value => 'MANAGER, PRESIDENT'
);
END;

Interactive Report - Dynamic Action 1

Interactive Report - Dynamic Action 2

Demo

Das Arbeiten mit Collections ist aber nicht sehr komfortabel, da die Benamung der Spalten auf “c001″ – “c999″ reduziert wird, besonders dann wenn es um die Abfragen geht weißt man schon nach ein paar Tagen für gewöhnlich nicht mehr die Bedeutung der Spalte “c003″.

Um das Problem zu lösen lege ich eine View auf die Collection und kann dann anschließend einfach die Werte aus der View selektieren. Die aufgebaute View sollte neben sprechenden Spaltennamen auch immer zusätzlich die Spalte “SEQ_ID” bekommen.

Folgende Prozedur erzeugt eine View für eine Collection die wiederum ein 1:1 Abbild einer echten Tabelle ist:

  PROCEDURE create_collec_view_from_table(
    p_view_name IN VARCHAR2,
    p_collection_name IN VARCHAR2,
    p_table_name IN VARCHAR2)
  AS
  v_counter NUMBER;
  v_sql VARCHAR2(4000);
  BEGIN
    v_sql := v_sql || 'CREATE OR REPLACE VIEW ' || p_view_name || ' AS';
    v_sql := v_sql || CHR(10) || 'SELECT';
    v_sql := v_sql || CHR(10) || 'seq_id AS SEQ_ID, ';
    FOR i IN (SELECT column_name FROM user_tab_columns WHERE table_name = p_table_name) LOOP
      v_sql := v_sql || CHR(10) || 'c' || TRIM(TO_CHAR(v_counter, '099')) || ' AS ' || i.column_name || ', ';
      v_counter := v_counter + 1;
    END LOOP;
    v_sql := RTRIM(v_sql, ', ');
    v_sql := v_sql || CHR(10) || 'FROM apex_collections WHERE collection_name=''' || p_collection_name || '''';
    EXECUTE IMMEDIATE v_sql;
  END create_collec_view_from_table;

Der folgende Aufruf:

BEGIN
create_collec_view_from_table(
    p_view_name => 'EMP_COLLECTION_V',
    p_collection_name => 'EMP_COLLECTION',
    p_table_name => 'EMP');
END;

erzeugt die View:

CREATE OR REPLACE VIEW EMP_COLLECTION_V
                AS
  SELECT seq_id AS SEQ_ID,
    c001        AS EMPNO,
    c002        AS ENAME,
    c003        AS JOB,
    c004        AS MGR,
    c005        AS HIREDATE,
    c006        AS SAL,
    c007        AS COMM,
    c008        AS DEPTNO
  FROM apex_collections
  WHERE collection_name='EMP_COLLECTION'