Oracle Apex: Creating a Shuttle Item

In Oracle Apex, a shuttle item is a kind of list item having a multi-select option. It has two boxes (left and right) containing lists; the left side shows the source of the list and right side the selected values.

The user can select the list options using its controls. Selected values are stored in a single colon-delimited string.

In this tutorial, you will learn how to create a shuttle item in Oracle Apex.

Here I am going to give two examples for this:

  1. Storing shuttle item values into a single field of a table.
  2. Storing shuttle item values into a separate table as multiple records.

Creating a Shuttle Item in Oracle Apex

In the following example, we are going to store the selected shuttle item values into a field.

Example 1: Storing Shuttle Item Selected Values into a Field

To do this, you can use any of your existing Varchar2 column in the table, but it should have a good length to store the selected values.

Or you can add a new column as Varchar2(4000) into your table.

Now open your page in Oracle Apex, go to the region your table based on and add the new item and change its type to Shuttle.

Select the source as SQL query and specify the SQL query something like below:

select product_name d, product_id r
   from demo_product_info
order by product_name

You can also select the other type of sources such as Static Values and Shared Components LOV, etc.

So now we have the product_name as the display column and the product_id as the return column.

Below is the screenshot for the above setting:

Oracle Apex shuttle item settings.

You also need to specify the source table column for the shuttle item.

Now save the changes and run the page to test. The output will be as shown in the below image:

Oracle Apex shuttle item demo.

The selected product ids will be stored into a field like 1001:1008:1011:1020.

Example 2: Storing Selected Shuttle Item Values into a Separate Table

To store the selected values into a table, you can create a process just after the default form process and use the following PL/SQL code:

Declare
  Cursor c_values
   is 
  Select
    t.column_value As prodcut_ids
  From
     Table ( apex_string.split(:P9_PRODUCTS, ':') ) t
  Where
     t.column_value Is Not Null;
Begin
  for c in c_values loop
     insert into your_table (product_id)
       values (c.product_ids);
  end loop;
End;

The above PL/SQL code will insert the selected shuttle item values as multiple records.

Vinish Kapoor
Vinish Kapoor

Vinish Kapoor is a seasoned software development professional and a fervent enthusiast of artificial intelligence (AI). His impressive career spans over 20 years, marked by a relentless pursuit of innovation and excellence in the field of information technology. As an Oracle ACE, Vinish has distinguished himself as a leading expert in Oracle technologies, a title awarded to individuals who have demonstrated their deep commitment, leadership, and expertise in the Oracle community.

4 Comments

  1. How can I disable the shuttle buttons, except for the remove button, when a selected value (right box) equals 'All Stores'. The buttons need to be enabled when 'All Stores' is removed from the right box. Thanks.

  2. On edit, I want to show the selected values (that are stored in database table as multiple record) on right side of shuttle item.

  3. Great work, can I Store Selected Shuttle Item Values in a collection .. if yes kindly share the code
    Thanks

Comments are closed.