Oracle Apex Release Notes
Oracle Apex Release Notes
Oracle Apex Release Notes
Release Notes
Release 23.1
F74114-03
June 2023
Oracle APEX Release Notes, Release 23.1
F74114-03
This software and related documentation are provided under a license agreement containing restrictions on
use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your
license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license,
transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse
engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is
prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If
you find any errors, please report them to us in writing.
If this is software, software documentation, data (as defined in the Federal Acquisition Regulation), or related
documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S.
Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs (including any operating system, integrated software,
any programs embedded, installed, or activated on delivered hardware, and modifications of such programs)
and Oracle computer documentation or other Oracle data delivered to or accessed by U.S. Government end
users are "commercial computer software," "commercial computer software documentation," or "limited rights
data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental
regulations. As such, the use, reproduction, duplication, release, display, disclosure, modification, preparation
of derivative works, and/or adaptation of i) Oracle programs (including any operating system, integrated
software, any programs embedded, installed, or activated on delivered hardware, and modifications of such
programs), ii) Oracle computer documentation and/or iii) other Oracle data, is subject to the rights and
limitations specified in the license contained in the applicable contract. The terms governing the U.S.
Government's use of Oracle cloud services are defined by the applicable contract for such services. No other
rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications.
It is not developed or intended for use in any inherently dangerous applications, including applications that
may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you
shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its
safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this
software or hardware in dangerous applications.
Oracle®, Java, and MySQL are registered trademarks of Oracle and/or its affiliates. Other names may be
trademarks of their respective owners.
Intel and Intel Inside are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are
used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Epyc,
and the AMD logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered
trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content, products,
and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly
disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise
set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be
responsible for any loss, costs, or damages incurred due to your access to or use of third-party content,
products, or services, except as set forth in an applicable agreement between you and Oracle.
Contents
2 New Features
2.1 Template Components 2-1
2.2 PWA Push Notifications 2-2
2.3 Modernized Object Browser 2-2
2.4 Page Processing Improvements 2-3
2.5 REST Data Source Enhancements 2-3
2.6 Property Graph Support 2-4
2.7 SQL Developer Web Integration 2-4
2.8 Capture ECID in APEX Webservice Log 2-4
2.9 Application Continuity 2-4
2.10 APEX Administrator Digest 2-5
2.11 Auto-Provisioning Restrictions 2-5
2.12 New Application Administration API Package 2-5
2.13 New Color Picker 2-6
2.14 Import and Export in Theme Roller 2-6
2.15 Region Display Selector Enhancements 2-6
2.16 Plug-In Attributes Updates 2-6
2.17 Improved App Icon Fidelity 2-6
2.18 Translation of Runtime Messages into Icelandic 2-7
2.19 Save and Run Page from Code Editor 2-7
2.20 Context-Sensitive APEX Help 2-7
iii
2.21 Multi-Tenant Authentication 2-7
2.22 Approvals Component Enhancements 2-7
2.23 JavaScript API Updates 2-7
2.24 JavaScript Library Upgrades 2-8
3 Changed Behavior
3.1 Rich Text Editor 3-1
3.2 Unsupported Format Masks in Date Picker 3-1
3.3 HTML Sanitization 3-1
3.4 Shuttle Item Events 3-2
3.5 Combined JavaScript File Change 3-2
3.6 Substitutions in HTML Expressions of Interactive Report 3-2
3.7 App Builder UI Changes 3-3
3.8 Compatibility Mode 3-3
3.9 Enabling Network Services in Oracle Database 3-6
3.9.1 When and Why Network Services Must be Enabled 3-6
3.9.2 Granting Connect Privileges 3-7
3.9.3 Troubleshooting an Invalid ACL Error 3-8
5 Deprecated Features
5.1 CKEditor5 Deprecated 5-1
5.2 Deprecated Object Browser Features 5-1
5.3 Preventing Double Escaping of LOV Display Values 5-1
5.4 Display Only Item with Format HTML (Unsafe) Deprecated 5-2
5.5 Deprecated Functions and Procedures 5-2
iv
7 Desupported Features
7.1 Desupported Query Builder 7-1
7.2 Desupported User Interfaces Removed 7-1
7.3 Desupported JET Date Picker Item Type Migrated 7-2
7.4 DOM Object Desupported 7-2
7.5 Legacy Bulk Utilities Desupported 7-2
9 Fixed Bugs
v
10.3 Known Issues for jQuery Upgrade 10-2
10.4 Interactive Grid support for REST Enabled SQL 10-3
10.5 Group By Component Type mode prevents Default View 10-3
10.6 Known Issues for Data Generator 10-3
10.7 Known Issue Using Readable Export Format 10-3
10.8 Known Issue when Displaying RESTful Module Definition Full URL 10-4
10.9 Known Issue when Displaying Full URL for Enabled Object Definition when using a
Named Pool in ORDS 10-4
11 Documentation Accessibility
12 Privacy Notice
Index
vi
1
About These Release Notes
These release notes contain important information not included in the Oracle APEX
documentation.
• Before You Begin
See Also:
Oracle APEX Installation Requirements in Oracle APEX Installation Guide
1-1
Chapter 1
Before You Begin
Tip:
APEX-based REST Services were desupported in release 22.1. Oracle
REST Data Services (ORDS) release 21.4.2 now ships with migration scripts
that enable you to upgrade any remaining APEX-based REST Services to
ORDS-based Services. To learn more, see Migration of Oracle APEX
RESTful Service Modules in Oracle REST Data Services Release Notes.
1-2
Chapter 1
Before You Begin
See Also:
About Accessing Your Development Environment in Oracle APEX App Builder
User’s Guide
1-3
2
New Features
Oracle APEX release 23.1 includes a number of new features. These new features are not
present in APEX release 22.2 and earlier releases.
• Template Components
• PWA Push Notifications
• Modernized Object Browser
• Page Processing Improvements
• REST Data Source Enhancements
• Property Graph Support
• SQL Developer Web Integration
• Capture ECID in APEX Webservice Log
• Application Continuity
• APEX Administrator Digest
• Auto-Provisioning Restrictions
• New Application Administration API Package
• New Color Picker
• Import and Export in Theme Roller
• Region Display Selector Enhancements
• Plug-In Attributes Updates
• Improved App Icon Fidelity
• Translation of Runtime Messages into Icelandic
• Save and Run Page from Code Editor
• Context-Sensitive APEX Help
• Multi-Tenant Authentication
• Approvals Component Enhancements
• JavaScript API Updates
• JavaScript Library Upgrades
2-1
Chapter 2
PWA Push Notifications
Fully Declarative - Template Components let you create plug-ins with attributes that
can be set declaratively in Page Designer. Attributes defined in the plug-in are
available in Page Designer for any column or region using the plug-in type.
Actions and Menu Buttons - With the introduction of Action Positions and Action
Templates for plug-ins, you can define actions and menu buttons with row-level
conditions for Template Components.
Universal Theme Components - Six out-of-the-box Template Components are added
to Universal Theme and available as region types in Page Designer: Avatar, Badge,
Comments, Content Row, Media List, and Timeline. These new regions remember
pagination, work with faceted search and smart filters, and support the external Order
By Item. When working with apps that use the latest version of Universal Theme,
Comments, Content Row, Media List, and Timeline are available in the Create Page
wizard.
Partials for Report Columns - Use partial components as Interactive Report column
types to display content like avatars and badges or apply a Template Component
directly in any HTML Expression using new template directive syntax.
For more information, see Template Components in Oracle APEX App Builder User’s
Guide.
2-2
Chapter 2
Page Processing Improvements
between an object's tabs--for example, between the spec and body of a package, or the
columns and data of a table.
Accessible - Object Browser is now coded to accessibility guidelines, making it easier to
work on database objects with assistive technologies like screen readers.
Changed Functionality
As part of streamlining the Create Object wizards, some functionality that used to be in the
wizard is now only available when editing the object.
Additional changes to the Object Browser include:
• Data downloads from tables, views, or materialized views are now in .XLSX format
instead of .CSV format.
• The REST tab for tables, views, packages, procedures, and functions is moved. It is now
available in the RESTful Services, Enabled Objects section.
• The UI Defaults tab for tables is moved. To access the UI defaults for a selected table, go
to the Columns tab and select More, then UI Defaults
Deprecated Functionality
For a list of items that are deprecated, see Deprecated Object Browser Features.
More Information
For more information on the modernized Object Browser, see Managing Database Objects
with Object Browser in Oracle APEX SQL Workshop Guide.
2-3
Chapter 2
Property Graph Support
• Use "Status Code" and "Reason Phrase" to easily get the server response into the
page items.
• Use "Data Profile" to easily fetch a JSON response attribute into a page item.
Discover REST Sources with Swagger - APEX now supports REST Source
discovery based on a Swagger/OpenAPI response. Create a complete REST Data
Source based on a response, including a data profile and additional metadata like
operations, URL, or other parameters.
Raw Selectors - A new switch item is added to REST Data Source Profiles to select
rows as they are. When enabled, all selectors are used exactly as specified and APEX
does not sanitize row and column selectors when generating the SQL query for JSON
parsing.
2-4
Chapter 2
APEX Administrator Digest
2-5
Chapter 2
New Color Picker
• (s|g)et_proxy_server
• get_no_proxy_domains
Tip:
The Vita theme and the Redwood Light theme are not compatible. It is not
possible to export from one and import into the other.
2-6
Chapter 2
Translation of Runtime Messages into Icelandic
2-7
Chapter 2
JavaScript Library Upgrades
– getPushSubscription
– hasPushSubscription
– subscribePushNotifications
– unsubscribePushNotifications
• model interface method getDataOverflow
2-8
Chapter 2
JavaScript Library Upgrades
• jQuery 3.6.4
• MapLibre 2.4.0
• MarkedJS 4.2.5
• prism.js 1.29.0
• Terser 5.16.1
2-9
3
Changed Behavior
Some existing behaviour changes in this release.
• Rich Text Editor
• Unsupported Format Masks in Date Picker
• HTML Sanitization
• Shuttle Item Events
• Combined JavaScript File Change
• Substitutions in HTML Expressions of Interactive Report
• App Builder UI Changes
• Compatibility Mode
• Enabling Network Services in Oracle Database
You must enable network services in Oracle Database to send outbound mail, use Web
services, or use template-based PDF report printing with BI Publisher in Oracle APEX.
3-1
Chapter 3
Shuttle Item Events
If you previously used both change and shuttlechangeorder Dynamic Actions or event
handlers, only the change handler is needed now. If you need to distinguish the two
cases, the change event happens after the shuttlechangeorder event.
3-2
Chapter 3
App Builder UI Changes
3-3
Chapter 3
Compatibility Mode
3-4
Chapter 3
Compatibility Mode
an end user could enter their own format. Oracle Application Express release 5.0 includes a
new item that enables the user to choose an application date format or user entered format.
Because applications created before release 5.0 do not have an item, a Compatibility Mode
of 5.0 checks if the user has entered some data. If no data has been entered, it picks the
application date format.
When a session timeout occurs and no timeout URL is specified, Oracle Application Express
raises an error instead of redirecting to the application's home page. If the session setup for
an Ajax requests fails, Oracle Application Express also raises an error. For Ajax requests that
expect JSON, the response is a JSON string with members that describe the error. For other
requests, the error appears on an error page.
Page items based on a database column where the attribute Source Used is set to Only
when current value in session state is null will raise an error when the page item gets
rendered. Using this setting for a database column is very dangerous and can result in
accidentally overwriting data when viewing and saving multiple records. Always set the
Source Used attribute to Always, replacing any existing value in session state.
Tip:
Please pay attention when changing the Compatibility Mode to 5.1/18.1/18.2.
Buttons, such as Cancel or Previous, where the Execute Validation flag has
incorrectly been set to Yes and which use an After Submit branch, never execute
validations when the user clicks the button. You can address this issue by using the
new client-side validations, or by setting Execute Validations to No.
In release 5.1, any Ajax-based Dynamic Actions where the "Wait for Result" attribute is set to
Yes perform an asynchronous Ajax call. Prior to 5.1, such calls would be made
synchronously.
3-5
Chapter 3
Enabling Network Services in Oracle Database
Note:
The following does not apply to APEX instances running on Oracle
Autonomous Database. APEX can communicate with external endpoints
over the internet without additional configuration.
Note:
When upgrading APEX, the upgrade automatically configures Network
Services based on the configuration of the previous APEX version.
3-6
Chapter 3
Enabling Network Services in Oracle Database
Tip:
To run the examples described in this section, the compatible initialization
parameter of the database must be set to at least 11.1.0.0.0. By default, the
parameter is set properly, but a database upgraded from a version prior to 11g may
require an update. For information about changing database initialization
parameters, see Specifying the Database Compatibility Level in Oracle Multitenant
Administrator's Guide.
See Also:
About Report Printing in Oracle APEX App Builder User’s Guide.
BEGIN
DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
host => '*',
ace => xs$ace_type(privilege_list => xs$name_list('connect'),
principal_name => 'APEX_230100',
principal_type => xs_acl.ptype_db));
END;
/
The following example demonstrates how to provide less privileged access to local network
resources. This example enables access to servers on the local host only, such as email and
report servers.
BEGIN
DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
host => 'localhost',
ace => xs$ace_type(privilege_list => xs$name_list('connect'),
principal_name => 'APEX_230100',
principal_type => xs_acl.ptype_db));
END;
/
3-7
Chapter 3
Enabling Network Services in Oracle Database
REM Show the dangling references to dropped users in the ACL that is
assigned
REM to '*'.
DECLARE
ACL_ID RAW(16);
CNT NUMBER;
BEGIN
-- Look for the object ID of the ACL currently assigned to '*'
SELECT ACLID INTO ACL_ID FROM DBA_NETWORK_ACLS
WHERE HOST = '*' AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL;
-- If just some users referenced in the ACL are invalid, remove just
those
-- users in the ACL. Otherwise, drop the ACL completely.
SELECT COUNT(PRINCIPAL) INTO CNT FROM XDS_ACE
WHERE ACLID = ACL_ID AND
EXISTS (SELECT NULL FROM ALL_USERS WHERE USERNAME =
PRINCIPAL);
ELSE
DELETE FROM XDB.XDB$ACL WHERE OBJECT_ID = ACL_ID;
END IF;
3-8
Chapter 3
Enabling Network Services in Oracle Database
END;
/
COMMIT;
Once the ACL has been fixed, you must run the first script in this section to apply the ACL to
the APEX_230100 user.
3-9
4
Ideas App Implementations
APEX thrives because of community engagement and feedback. The APEX Ideas app
makes it easier for you to contribute directly to the product direction of APEX.
4-1
5
Deprecated Features
Deprecated features are features which Oracle plans to desupport or remove in a future
release of Oracle APEX. If a feature is related to application metadata or an API, existing
applications can still use the feature, but Oracle strongly recommends that developers start to
modify their applications as described in this section. Use APEX Advisor to scan existing
applications for deprecated attributes.
• CKEditor5 Deprecated
• Deprecated Object Browser Features
• Preventing Double Escaping of LOV Display Values
• Display Only Item with Format HTML (Unsafe) Deprecated
• Deprecated Functions and Procedures
select *
from apex_application_lovs
where lov_type = 'Dynamic'
5-1
Chapter 5
Display Only Item with Format HTML (Unsafe) Deprecated
select *
from apex_application_page_items
where lov_named_lov is null
and ( upper(lov_definition) like '%HTF.ESCAPE_SC%'
or upper(lov_definition) like '%APEX_ESCAPE.HTML%'
or upper(lov_definition) like '%WWV_FLOW_ESCAPE.HTML%' );
If the queries returns no rows, then no action is required. Otherwise, check the LOV
definition and/or page items, remove any manual escaping, and test your applications
to ensure that the values still appear as intended.
5-2
6
Deprecated in Previous Releases
The following section lists features which were deprecated in a previous release but have not
been fully removed or desupported from Oracle APEX.
Oracle strongly recommends that developers start to modify their applications as described in
this section. Use APEX Advisor to scan existing applications for deprecated attributes.
• Deprecated APEX Item Markup
• Deprecated jQuery Date Picker
• Previously Deprecated APIs
• Deprecated Utilities
• Deprecated Legacy Web Service References
• jQuery UI Deprecated
.important-text.apex-item-textarea + .apex-item-textarea-counter {
font-weight: bold;
}
This currently works, but may not in the future because it relies on undocumented class
names and the counter element directly following the textarea element. It is also not a best
practice to add event handlers in Custom Attributes.
Future releases may document new custom element markup, classes, and CSS variables to
allow more supportable customization.
6-1
Chapter 6
Deprecated jQuery Date Picker
6-2
7
Desupported Features
Desupported features are no longer available. If a desupported feature has to do with
application metadata or APIs, then existing applications may not work as they did previously.
Oracle recommends modifying the application to replace the feature.
• Desupported Query Builder
• Desupported User Interfaces Removed
• Desupported JET Date Picker Item Type Migrated
• DOM Object Desupported
• Legacy Bulk Utilities Desupported
7-1
Chapter 7
Desupported JET Date Picker Item Type Migrated
– apex_application_pages.page_transition
– apex_application_pages.popup_transition
– apex_application_themes.ui_type_id
– apex_application_themes.ui_type_name
– apex_application_themes.default_page_transition
– apex_application_themes.default_popup_transition
– apex_appl_plugins.supported_ui_types
– apex_appl_plugin_std_attrs.supported_ui_types
– apex_appl_plugin_attributes.supported_ui_types
• Removed Page Designer Properties:
– Page Transition
– Popup Transition
– User Interface
Older applications created when APEX could have two User Interfaces now only use
the active user interface. Inactive user interfaces are removed from the metadata.
7-2
Chapter 7
Legacy Bulk Utilities Desupported
7-3
8
Desupported in Previous Releases
The following section lists features that were desupported in a previous release.
If a desupported feature has to do with application metadata or APIs, then existing
applications may not work as they did previously. Oracle recommends modifying the
application to replace the feature.
• Desupported Attributes in App Builder
• Desupported Properties
• Desupported View Columns
• FullCalendar 3 Desupported
• App Builder Defaults Desupported
• Copying Legacy Themes Desupported
• CKEditor4 Desupported
• Desupported Public Package APIs
• Desupported Page Positions
• Desupported Region Positions
• Custom Page Region Templates with Duplicated Positions Desupported
• Legacy Substitution Strings Desupported
• Desupported JavaScript Functions
• Post Calculation for Page Items Desupported
• Show / Hide All Page Items On Same Line Attributes Desupported
• apex.server Plug-in and Process Function Async Option Desupported
• apex.widget.initPageItem Function Desupported
• Popup LOV Template Desupported
• Based On - Output of PL/SQL Code attribute Desupported
• Syntax {COLUMN_NAME}_LABEL in Interactive Grid Icon and Detail Views Desupported
• Removed Content Delivery Network
• APEX-Based REST Services Desupported
8-1
Chapter 8
Desupported Properties
8-2
Chapter 8
Desupported Public Package APIs
• Toolbar: unchanged
• Toolbar Style: Multiline
• Minimum Height: 180
• Maximum Height: null
• Allow Custom HTML: Enabled
The properties Toolbar Position and Skin do not have a CKEditor5 equivalent, and are
removed. Any code included in the JavaScript Initialization Code attribute is automatically
commented out.
Oracle recommends manually checking the functioning of each Rich Text Editor item.
Note:
With this update, any code referencing CKEditor4 and the CKEDITOR global object
no longer works.
8-3
Chapter 8
Custom Page Region Templates with Duplicated Positions Desupported
• APP_IMAGES
• IMAGE_PREFIX
• THEME_DB_IMAGES
• THEME_IMAGES
• WORKSPACE_IMAGES
While the legacy substitutions still function, Oracle recommends developers update
their environments to use updated substitutions (listed below).
Legacy New
IMAGE_PREFIX APEX_FILES
WORKSPACE_IMAGES WORKSPACE_FILES
APP_IMAGES APP_FILES
THEME_IMAGES THEME_FILES
THEME_DB_IMAGES THEME_DB_FILES
8-4
Chapter 8
Show / Hide All Page Items On Same Line Attributes Desupported
8-5
Chapter 8
APEX-Based REST Services Desupported
If you were using this option, it's recommended to instead use the more modern,
Oracle-provided CDN approach. For further information, see Announcing Oracle APEX
Static Resources on Content Delivery Network.
Note:
Oracle REST Data Services (ORDS) release 21.4.2 now ships with migration
scripts that enable you to upgrade any remaining APEX-based REST
Services to ORDS-based Services. To learn more, see Migration of Oracle
APEX Restful Service Modules in Oracle REST Data Services Release
Notes.
8-6
9
Fixed Bugs
The following section lists bugs fixed in this release.
9-1
Chapter 9
9-2
Chapter 9
9-3
Chapter 9
9-4
Chapter 9
9-5
Chapter 9
9-6
10
Open Bugs and Known Issues
This section describes bugs and known issues for Oracle APEX release 23.1.
Tip:
This section is current as of the writing of this document. To view the most current
listing of changed behavior, go to the Known Issues page:
https://www.oracle.com/tools/downloads/apex-downloads/apex-231-known-issues/
• Known Issue with Confirm or Alert Dynamic Action Messages When Upgrading
• Known Issue using 'Source Display' region type plug-in in previously installed Sample
Apps
• Known Issues for jQuery Upgrade
• Interactive Grid support for REST Enabled SQL
• Group By Component Type mode prevents Default View
• Known Issues for Data Generator
• Known Issue Using Readable Export Format
• Known Issue when Displaying RESTful Module Definition Full URL
• Known Issue when Displaying Full URL for Enabled Object Definition when using a
Named Pool in ORDS
Resolution
Prior to upgrading, run a query to check whether any messages are affected:
select *
from apex_application_page_da_acts
where action_name in ('Alert', 'Confirm')
and ( lengthb( attribute_01 )
10-1
Chapter 10
Known Issue using 'Source Display' region type plug-in in previously installed Sample Apps
If the query does not return any rows, proceed with the upgrade.
If the query does return rows, convert the affected rows into application text messages
and reference them with substitution syntax before proceeding with the upgrade.
Resolution
1. Open the application to edit it.
2. Navigate to Shared Components, under Other Components select Plug-ins, and
Source Display.
3. Update the PL/SQL Code to remove the following lines of code (lines 35 - 48):
union all
select reg.source_type, fs.series_seq, fs.series_name,
fs.series_query source
from apex_application_page_regions reg,
apex_application_page_flash5_s fs
where reg.application_id = :APP_ID
and reg.page_id = :APP_PAGE_ID
and reg.static_id = d_region_static_id
and fs.application_id = reg.application_id
and fs.page_id = reg.page_id
and fs.region_id = reg.region_id
and reg.source_type in (
'Flash Chart',
'Map'
)
10-2
Chapter 10
Interactive Grid support for REST Enabled SQL
Solution
Reduce the amount of DML rows.
Resolution
1. In Page Designer, open Developer Console in the browser, and run the following
command:
10-3
Chapter 10
Known Issue when Displaying RESTful Module Definition Full URL
Resolution
Remove the module name from the full URL.
Example
For the default module, oracle.example.hr, the full URL displays as:
Resolution
Add the ORDS named pool to the full URL.
Example
For an AutoREST enabled object definition with ORDS configured to use a named
pool, the full URL displays as:
10-4
11
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility
Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.
11-1
12
Privacy Notice
This privacy notice describes what to expect when Oracle APEX directly collects information
about users of applications that you create or install. Note that all APEX internal applications
(such as Application Builder) are written in APEX, so the same facts apply to developers and
administrators who are using these applications. Oracle is not responsible for information
collection of applications that were developed by customers.
Event Logging
APEX provides extensive logging of user triggered events. For example, developers and
administrators can use this data to find security and performance issues. The log data
includes the user’s IP address and application username plus event specific information.
Below is a brief list of event log types.
• Activity Log - Page views and Ajax requests. Can be disabled by developers and
instance administrators.
• Login Access Log - Successful and failed login attempts.
• Debug Log - Application-specific instrumentation, such as internal variable values.
Disabled by default, the debug log can be enabled by end users and developers.
• Click Count Log - Clicks on external links within applications.
• Web Service Activity Log - Requests to external web services from inside the database.
• Developer Activity Log - Changes to application components.
• SQL Workshop Log - History of SQL statements in the development environment's SQL
Workshop.
Session Cookies
• ORA_WWV_USER_instance id - Security cookie for internal applications, like Application
Builder.
• ORA_WWV_APP_application id, ORA_WWV_APP_workspace cookie id, custom name -
Security cookie for applications. Developers can choose custom cookie names in an
application's authentication scheme.
• ORA_WWV_RAC_INSTANCE - Session cookie for the Real Application Cluster (RAC) node
instance number, for node pinning on the web server. Only sent when multiple RAC
nodes are detected.
12-1
Chapter 12
Persistent Cookies
• ORA_WWV_REMEMBER_LANG - The user’s selected application language.
• ORA_WWV_REMEMBER_UN - (Optional) Workspace and username of the previous login
to the development environment login page. See check box Remember
workspace and username on the development environment login page for
details.
• LOGIN_USERNAME_COOKIE - (Optional) Username of the previous login to developed
applications. See check box Remember username on login pages of new
applications for details. To make this cookie optional on login pages of existing
applications, add a Remember username checkbox to the page. The API
documentation for APEX_AUTHENTICATION.GET_LOGIN_USERNAME_COOKIE and
APEX_AUTHENTICATION.SEND_LOGIN_USERNAME_COOKIE has examples for the
PL/SQL process code to set the check box value and to only send the cookie
when the check box is checked.
Session Storage
• Object Browser - Session storage keys used for the Object Browser:
– ORA_WWV_apex.objectBrowser.openTabs - Stores a JSON structure with
information about the currently open object.
– ORA_WWV_apex.objectBrowser.viewState - Stores view state for the current
view of the current open object.
– ORA_WWV_apex.objectBrowser.lastSchema - Stores an opaque number
related to the last used schema.
– ORA_WWV_apex.objectBrowser.treeExpansionState - Stores a list of
expanded tree nodes.
– ORA_WWV_apex.objectBrowser.treeSelection - Stores the selected tree
node.
– ORA_WWV_apex.objectBrowser.objectFilter - Stores the current filter.
• Spatial Map Region - Session storage keys used on the map component:
– ORA_WWV_apex.spatialMap.application id.page.region id.zoomState -
Stores the current zoom level on the map
– ORA_WWV_apex.spatialMap.application id.page.region id.lngState -
Stores the current longitude on map
– ORA_WWV_apex.spatialMap.application id.page.region id.latState -
Stores the current latitude on map
– ORA_WWV_apex.spatialMap.application id.page.region id.bearingState
- Stores the current tilt in degrees on the map
– ORA_WWV_apex.spatialMap.application id.page.region id.pitchState -
Stores current direction user is facing measured clockwise as an angle on the
map
• ORA_WWV_apex.facets.application id.page.region id.clientSideFiltering -
Stores the facets where the user has enabled or disabled on client-side filtering.
• ORA_WWV_apex.facets.application id.page.region id.hiddenFacets - Stores
the facets where the user has set Visibility to Off.
12-2
Chapter 12
Local Storage
• ORA_WWV_apex.builder.devToolbar.options - This stores the Developer Toolbar user
preference settings: Auto Hide, Show Icons Only, and Display Position.
• ORA_WWV_apex.builder.pageDesigner.model.componentIds - This stores a pool of not
yet used IDs for new components in Page Designer.
12-3
Index
B R
browser release numbering
requirement, 1-1 convention, 1-2
requirements
browser, 1-1
I
installation W
enabling network services, 3-6
Web browser
requirements, 1-1
N web server
network services Oracle REST Data Services, 1-2
enabling, 3-6 requirements, 1-2
granting connect privileges, Oracle Database
12c, 3-7
invalid ACL error, 3-8
O
Oracle APEX
browser requirement, 1-1
Index-1