APEX ITEM and Dynamic Tabular Forms

APEX_ITEM and
Dynamic Tabular Forms

Greg Jarmiolowski
SQLPrompt LLC
Agenda
Tabular Form Creation

Tabular Form Post Processing Built-ins
Building Forms with APEX_ITEM
Global Arrays
Custom Post processing
APEX_COLLECTIONS
Validation
Locking and Concurrency
What Are Tabular Forms

Forms for editing multiple records at once
Attribute pairs/many to many list
management
Questions and answers
The detail for a master detail relationship
Example Form
How To Create A Tabular Form

Wizard
Tabular Form Element attributes of the
report columns
SQL Query (updatable report)
SQL report using APEX_ITEM
PL/SQL region using APEX_ITEM
Using The Wizard

12+ steps no shortcuts
Automatically generates CRUD
processes
Add rows feature
Handles Concurrency
(quite ugly)
With some tweaking should
handle majority of forms
Built in Update
Built in Insert
Built in Lost Update Detection
Wizard creates a checksum field for records

MRU process compares this on post
Results are uncontrollable and not good
Column Attributes
Column Attributes
SELECT apex_item.hidden(50, ROWNUM) AS row_number

, apex_item.hidden(49, pk_column) AS pk
Report Source
SQL
, apex_item.radiogroup(ROWNUM, radio_value,
selected_value, value_label) as radiobutton
FROM wherever
WHERE whatever
Tables & Views
Column
Attributes
APEX_ITEM API
wwv_flow.accept
Page Process
Column Attributes
Missing Elements
Checkbox
Radiobutton
PopupKey
Tabular Form Element Attributes

For customizing elements and values
Format mask
Width
Attributes
Default values/calculations
Referenced Table/Column
Post Processing
For the simplest tabular reports use the
APEX_ITEM.MULTI_ROW_UPDATE
procedure
Takes an MRU string in the format:
OWNER:TABLE:pk_col1,pk_idx:pk_col2,p_idx2|col,idx:col:idx..
Can still manipulate the array values it takes

beforehand
Post Processing Basics

BEGIN
APEX_ITEM.MULTI_ROW_UPDATE(
SCOTT:EMP:EMP_ID,1|EMP_FNAME,2:EMP_LNAME,3);
END;
Simple
All or nothing
APEX Global Collections

Each form element has an HTML name
attribute
Posted form element values are added to
PL/SQL VARCHAR2 Nested Tables
Arrays are in package apex_application
Named g_f01 to g_f50 plus g_fcs
Correspond to g_ and the name attribute of the
element
Helper utility prints matrix of posted arrays
http://jornica.blogspot.com/2008/02/apexglobalarrays.html
Post Processing Basics

BEGIN
FOR i IN 1 .. apex_application.g_f01.COUNT
LOOP
-- shorten the submitted first name to 20 characters
apex_application.g_f02(i) :=
SUBSTR(apex_application.g_f02(i),1,20);
-- shorten the submitted last name to 20 characters
apex_application.g_f03(i) :=
SUBSTR(apex_application.g_f03(i),1,20);
END LOOP;
APEX_ITEM.MULTI_ROW_UPDATE(
SCOTT:EMP:EMP_ID,1|EMP_FNAME,2:EMP_LNAME,3);
END;
Global Collection Basics

Idx
1
2
3
g_f01
13432
14567
g_f02 g_f03
4
1
g_f50
g_fcs
..B2449..
..A3609..
..Z8134..
<input type=text" value="4"

name="f02"/>
Tabular form elements are posted to server and then stored in the
apex_application arrays
The name attribute of the item corresponds with the array name
G_fcs is populated by md5_checksum function
Non selected checkboxes and radio buttons (and disabled elements) are not
posted
APEX_ITEM Package
Functions that
return HTML input
items
Procedure for
updating multiple
records
Checkbox
Checksum
Date Popup
Display only
Hidden
Popup LOV
Radiogroup
Select List
Text
Textarea
Reasons For APEX_ITEM

Item types
Checkboxes
Radio Buttons
Popup Key
Very large list(s) of values
Runtime item type determination

Multiple tabular forms per page
How to Use APEX_ITEM

SELECT APEX_ITEM.DATE_POPUP(
2
, NULL
, date_entered
, MM/DD/YYYY)
. . .
Radio Button and Checkbox

Issues
List type form elements may be single or
multiselect
Select lists from APEX_ITEM are only single
select
Multi-select items are commonly stored as
children of the main record
APEX makes it simple to use multi-selects
stored as colon delimited strings
Radio Button and Checkbox

Issues
Unselected form elements are not posted to

the server
Global array positions (idx) will not match other

elements in the row
Checkbox Considerations
Checkboxes and radiobuttons
present unique challenges
If checkbox values are consistent
across all rows you can use the row
key for the value
Otherwise you need the value and a
way to associate it with the row key
Radiogroup Considerations
Radio buttons present even more
challenges
HTML radio input types are grouped
by NAME
Only one radio button per group can
be selected
Matching Keys and Values

Three main methods
Store the PK in the value attribute of the
element and associate the p_idx with a
database value
Store the PK and the database value in the
value attribute and use any p_idx (Compound
Key)
Store the database value in the value attribute
using a rownum derived p_idx and then store
that rownum in a hidden item (Triangulation)

ID
Name
Red
Green
Blue
Element
Hidden
Display
Only
Radio
Radio
Radio
P_idx ->
Value
Primary
Key
Database
Value
Primary
Key
Primary
Key
Primary
Key
Store PK in value of element and use the p_idx to

get the value for database

--delete using pk
FORALL i IN 1 .. g_f01.COUNT
DELETE mytable
WHERE id = apex_application.g_f01(i);
--insert using posted values

FORALL red IN 1 .. g_f03.COUNT
INSERT INTO mytable(ID, color)
VALUES (apex_application.g_f03(red)
, 'RED');
Compound Keys
ID
Name
Red
Green
Blue
Element
Hidden
Display
Only
Radio
Radio
Radio
P_idx ->
Database
Value
PK|RED
PK|GREEN
PK|BLUE
Value
Primary
Key (PK)
Store PK and DB value in value attribute of

element
Compound Keys
DECLARE
l_key_arr
wwv_flow_global.vc_arr2;
BEGIN
FORALL i IN 1 .. apex_application.g_f01.COUNT
DELETE mytable
WHERE ID = apex_application.g_f01(i);
FOR x IN 1 .. apex_application.g_f03.COUNT
LOOP
l_key_arr :=
apex_util.string_to_table
(apex_application.g_f03(x), '|');
INSERT INTO mytable(ID, color)

VALUES (l_key_arr(1), l_key_arr(2));
END LOOP;
END;
Triangulation Keys
Simple to create key structure
Flattens the checkbox or radio button
arrays to one array each
FROM wherever
WHERE whatever
Triangulation Keys
g_f49 is primary key

g_f50 points to the array with the value
All item values are in index 1 of arrays 1 to 48
(except for checkboxes and multiselects)
Triangulation Keys
DECLARE
l_arrnum
VARCHAR2(50);
l_stmt
VARCHAR2(200);
l_arrval
VARCHAR2(100);
BEGIN
FOR i IN 1 .. apex_application.g_f49.COUNT
LOOP
-- build string to reference the array indicated
-- by the value in array 50
l_arrnum := 'apex_application.g_f'
|| LPAD(LTRIM(RTRIM(apex_application.g_f50(i))),2, '0');
-- build pl/sql block to extract value(s) as delimited string
l_stmt := 'BEGIN '
|| ' :l_arrval := apex_util.table_to_string('
|| l_arrnum -- eg apex_application.g_f10
|| ', '':''); END;';
-- run block using out bind value
EXECUTE IMMEDIATE l_stmt USING OUT l_arrval;
save_response(:g_resp_id, apex_application.g_f49(i), l_arrval);
END LOOP;
END;
Checkbox Function
APEX_ITEM.CHECKBOX
Arguments:
p_idx = The form element name, e.g. 1 equals f01, 2 equals
f02, etc.
Typically the p_idx argument is constant for a given column.
p_value = When checked return this value
p_attributes = Custom HTML arguments added to the HTML
input type of checkbox.
p_checked_values = Colon (by default delimted list of values
p_checked_values_delimitor = Defaults to a colon ":" and is
used to pass multiple values in one string.
p_item_id = Will set the ID of the item to this value (id="...").
Must be unique! Try concatenating some string with
rownum. Required for 508 compliance
p_item_label = Creates an invisible label for an item. Used
for Section 508 Compliance. Class is hideMe508.
Multiple Checkbox Function

Most examples of checkboxes show one
idx per column
Not easy to do this in SQL with a varying
number of columns (case range >= x)
SELECT_LIST_FROM_LOV but no
CHECKBOX_FROM_QUERY or similar
Multiple Checkbox Function
CREATE OR REPLACE FUNCTION multi_checkbox_from_list(

p_idx
IN
NUMBER
, p_value_list
IN
VARCHAR2
-- p_value_list in the format of a APEX static LOV eg
Label1;Value1,Label2;Value2
, p_checked_values
IN
VARCHAR2
-- p_checked_values in the format of a colon delimited string eg
Value1:Value2
) RETURN VARCHAR2
IS
l_list_arr
l_list_item
l_return
VARCHAR2(32000);
BEGIN
l_list_arr
:= apex_util.string_to_table(p_value_list, ',');
FOR i IN 1 .. l_list_arr.COUNT LOOP
l_list_item
:= apex_util.string_to_table(l_list_arr(i), ';');
-- 2nd position in new array is the value
l_return := l_return || '<label>';
l_return := l_return
|| apex_item.checkbox(p_idx
=> p_idx
, p_value
=> l_list_item(2)
, p_checked_values => p_checked_values);
-- 1st position is the label
l_return := l_return || l_list_item(1) || '</label>';
END LOOP;
RETURN l_return;
END multi_checkbox_from_list;
Some Limitations
Submitted data is not stored
No easy way to validate
MRU Checksum Error
APEX Collections To The Rescue

APEX collections are a view and an API
to work with the data in the underlying
tables
Each collection instance belongs to and
can only be viewed by the owning
session
Has a name, row index, 50 varchar
columns, one LOB column and a
checksum column
Not All Collections Are The Same

APEX_COLLECTION
data stored in tables with an API to read
and write
APEX Global Collections
VARCHAR array package variables
PL/SQL types not SQL types
How To Create And Populate
create_collection (delete_collection)
create_or_truncate_collection
add_member
update_member
create_collection_from_query
create_collection_from_query_b
Create Collection From Query

Cannot pass query into function with
:BIND syntax
Convert :BIND to v(BIND)
REGEXP_REPLACE(sql, ':([a-zA-Z0-9_]*)', 'v(''\1'') ')
p_generate_md5 parameter creates

checksum of columns in SQL
create_collection_from_query_b does not
offer checksum
Querying Your Collection
Works just like a regular table or view

Multiple collections can be joined or
unioned
SELECT c001, c002, ..., c050

FROM apex_collections
WHERE collection_name = :mycoll
APEX Collections Checksum

API for collections can compute
checksums for stored columns
When creating the members from a query
the checksum process locks the row to
read it
The checksum can be used for lost
update detection and to prevent
tampering with read only elements
Post Processing With Collections

CREATE_OR_TRUCATE_COLLECTION
Loop over values from
APEX_APPLICATION collections and
use ADD_MEMBER function
Dump all your APEX_APPLICATION
collections into it with the
ADD_MEMBERS procedure
Generating a checksum here allows you
to determine what records changed if you
generated a checksum on select

Report Source
wwv_flow_collections
FROM wwv_flow_collections
WHERE collection_name = :l_collection
Column
Attributes
APEX_ITEM API
Tables & Views
wwv_flow_collections
wwv_flow.accept
Page Process
Validation Errors
Report query outer joined to collection
Submit process to
CREATE_OR_TRUNCATE_COLLECTION
Submit process finds validation errors and stores
information in collection
Submit process to update data for records without
validation error
Branch to same page and report query will access any
error messages in collection (or just limit it to those with
errors if errors are present)
Taking it a step further

Extract core report query to On Load process that
creates collection from the query
Report query selects from the collection instead of your
tables
On Submit process saves submitted values in another
collection
Joining collections by key and comparing
MD5_ORIGINAL column shows dirty records
Take this approach as far as you want add error
messages; decide what and when to process; etc
Useful Helper Functions

Find the nth element in delimited array
REGEXP_SUBSTR(:PX,'[^:]+',1,n)
Count elements in delimited array
REGEXP_COUNT(:PX,'[^:]+')
Useful Helper Functions

When using checkboxes for list management
instead of deleting and reinserting you can
find the intersect
-- old minus
l_delete_arr
-- new minus
l_insert_arr
new equals those we need to delete

:= l_old_arr MULTISET EXCEPT l_new_arr;
old equals those we need to insert
:= l_new_arr MULTISET EXCEPT l_old_arr;
* Works only on table types declared in SQL

APEX ITEM and Dynamic Tabular Forms

Uploaded by

Copyright:

Available Formats

APEX ITEM and Dynamic Tabular Forms

Uploaded by

Document Information

Original Description:

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

APEX ITEM and Dynamic Tabular Forms

Uploaded by

Copyright:

Available Formats

APEX_ITEM and

Dynamic Tabular Forms

Tabular Form Creation

What Are Tabular Forms

How To Create A Tabular Form

Using The Wizard

Built in Lost Update Detection

Wizard creates a checksum field for records

SELECT apex_item.hidden(50, ROWNUM) AS row_number

Tables & Views

Tabular Form Element Attributes

Can still manipulate the array values it takes

Post Processing Basics

APEX Global Collections

Post Processing Basics

Global Collection Basics

<input type=text" value="4"

Reasons For APEX_ITEM

Runtime item type determination

How to Use APEX_ITEM

Radio Button and Checkbox

Radio Button and Checkbox

Unselected form elements are not posted to

Global array positions (idx) will not match other

Matching Keys and Values

Matching Keys and Values

Store PK in value of element and use the p_idx to

Matching Keys and Values

--insert using posted values

Store PK and DB value in value attribute of

INSERT INTO mytable(ID, color)

g_f49 is primary key

Multiple Checkbox Function

Multiple Checkbox Function

CREATE OR REPLACE FUNCTION multi_checkbox_from_list(

APEX Collections To The Rescue

Not All Collections Are The Same

How To Create And Populate

Create Collection From Query

p_generate_md5 parameter creates

Querying Your Collection

Works just like a regular table or view

SELECT c001, c002, ..., c050

APEX Collections Checksum

Post Processing With Collections

SELECT apex_item.hidden(50, ROWNUM) AS row_number

Taking it a step further

Useful Helper Functions

Useful Helper Functions

new equals those we need to delete

* Works only on table types declared in SQL

You might also like

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.