Copyright © 2019 APEX Consulting
APEX Bad Practices

<bragging>

</bragging>

3 Membership Tiers
• Oracle ACE Director
• Oracle ACE
• Oracle ACE Associate
bit.ly/OracleACEProgram
500+ Technical
Experts Helping
Peers Globally
Connect:
Nominate yourself or someone you know: acenomination.oracle.com
@oracleace
Facebook.com/oracleaces
oracle-ace_ww@oracle.com

Get organised
Dude, where’s my
code?
And what about
JavaScript …
Miscellaneous

Get organised

Naming stuff

Need a Page Item Value on other pages?
Use an Application Item
Use P0_EMPNO
Use P1_EMPNO

$(“#P1_EMPNO”)apex.item(“P1_EMPNO”)

Divide and conquer

A few Applications
with a lot of Pages

A lot of Applications
with a few Pages

MASTER
SEED
subscription
APP 1
APP 2
APP 3
copy
subscription subscription subscription

✅
❌
❔
❌
❌
❌
❌
✅
✅
✅
❌
❌
❌
✅
✅
✅
❌
❌
❌
❌
❌
❌
❌
✅
❌
✅
❌
✅
✅
❌
❌
❌
❌
❌
❌

Page 0

Unsubscribe

NEVER Unsubscribe

Don’t put your files
in the APEX directories

/usr/local/tomcat/webapps/i

/usr/local/tomcat/webapps/
mycode
/mycode/js/myJsFile.js

Get organised
Dude, where’s my
code?
And what about
JavaScript …
Miscellaneous

Get organised
Dude, where’s my
code?
And what about
JavaScript …
Miscellaneous

Dude, where’s my code?

Process
Region / Item Source
Condition
Read Only Condition
Item Default
Dynamic Action
Validation
Where CAN you put your PL/SQL?

Where SHOULD you put your PL/SQL?
Reusable
Testable
Compiled
Dependencies

Some more remarks
regarding PL/SQL

select *
from my_big_table
where field = v('P2_EMPNO')

select *
from my_big_table
where field =
( select v('P2_EMPNO')
from dual )

with param as
( select v('P2_EMPNO') empno
from dual )
select *
from my_big_table
, param
where field = param.empno

with param as
( select /*+ MATERIALIZE */
v('P2_EMPNO') empno
from dual )
select *
from my_big_table
, param
where field = param.empno

FORMAT MASK

render / submit / ajax

Beware of
undocumented
features

APEX 5
APEX 18
:APXWS_SEARCH_STRING_1
:APXWS_EXPR_1
:apex$f1
https://roelhartman.blogspot.com/2016/07/prevent-general-row-based-search-in.html

Get organised
Dude, where’s my
code?
And what about
JavaScript …
Miscellaneous

Get organised
Dude, where’s my
code?
And what about
JavaScript …
Miscellaneous

And what about
JavaScript …

Page “JavaScript section”
Page header / footer
Region header / footer
Item Pre / Post Text
URL target
Dynamic Action When / Condition
DA Action : Execute JavaScript Code
Where CAN you put your JavaScript?

Where SHOULD you put your JavaScript?
In a file (on your network / static app file)
(reference in the User Interface Details)
In a Plugin (JavaScript file)
Roels Rule : No JavaScript anywhere else

The code is more what you'd call "guidelines" than actual rules

How should you code your JavaScript?
$(“#P1_EMPNO”)
or
apex.item(“P1_EMPNO”)

How should you code your JavaScript?
$v(“#P1_EMPNO”)
or
apex.item(“P1_EMPNO”).getValue()

How should you code your JavaScript?
$v(“P1_EMPNO”)
or
apex.item(“P1_EMPNO”).getValue()

Know your APEX JavaScript API’s
https://docs.oracle.com/en/database/oracle/application-express/19.1/aexjs/index.html

Beware of undocumented features

gReport

htmldb_Get

A lot of stuff in the Interactive Grid

Watch your plugins …

Beware of undocumented features

Beware of DOCUMENTED features

function render
( p_dynamic_action in apex_plugin.t_dynamic_action
, p_plugin in apex_plugin.t_plugin
)
return apex_plugin.t_dynamic_action_render_result
is
l_result apex_plugin.t_dynamic_action_render_result;
begin
l_result.javascript_function :=
'function(){
openModal( this.affectedElements[0].id );
}';
return l_result;
end;

function render
( p_dynamic_action in apex_plugin.t_dynamic_action
, p_plugin in apex_plugin.t_plugin
)
return apex_plugin.t_dynamic_action_render_result
is
l_result apex_plugin.t_dynamic_action_render_result;
begin
l_result.javascript_function :=
'function(){
openModal( this.affectedElements[0].id );
}';
return l_result;
end;

function render
( p_dynamic_action in apex_plugin.t_dynamic_action
, p_plugin in apex_plugin.t_plugin
)
return apex_plugin.t_dynamic_action_render_result
is
l_result apex_plugin.t_dynamic_action_render_result;
begin
l_result.javascript_function :=
'function({
apex.theme.openRegion( this.affectedElements[0].id );
}';
return l_result;
end;

Get organised
Dude, where’s my
code?
And what about
JavaScript …
Miscellaneous

Get organised
Dude, where’s my
code?
And what about
JavaScript …
Miscellaneous

Miscellaneous

Dynamic Actions are cool

Page Process / Computation

Region refresh
Page refresh
Row refresh

function render
( p_dynamic_action in apex_plugin.t_dynamic_action
, p_plugin in apex_plugin.t_plugin
)
return apex_plugin.t_dynamic_action_render_result
is
l_result apex_plugin.t_dynamic_action_render_result;
begin
l_result.javascript_function :=
'function(){
var myGrid = apex.region( this.affectedElements[0].id )
.widget().interactiveGrid("getViews").grid;
myGrid.model.fetchRecords( myGrid.getSelectedRecords() );
}';
return l_result;
end;

Get organised
Dude, where’s my
code?
And what about
JavaScript …
Miscellaneous

Copyright © 2019 APEX Consulting
Q& A@roelh
roel@apexconsulting.nl
http://www.apexconsulting.nl

@roelh
roel@apexconsulting.nl
http://www.apexconsulting.nl
Copyright © 2019 APEX Consulting