feat: ✨ Added command data monitoring, IoT domain information, and OCI settings information

Command Data Monitoring: This feature is now integrated throughout the application, providing real-time visibility and insights into command-related activities. Domain Information Visibility: Easily access domain group and domain details for the environment where the app is installed. Settings Page: A dedicated page is now available for entering OCI credentials and other essential OCI configuration details. This setup is required to unlock new and upcoming features in the OCI IoT Explorer.

Signed-off-by: Micheal Simmons <[email protected]>

Author: micheal-simmons

apex/dashboard/.gitattributes

@@ -1 +1 @@
-f102.sql filter=lfs diff=lfs merge=lfs -text
+iot_explorer.app.sql filter=lfs diff=lfs merge=lfs -text

apex/dashboard/CHANGELOG.md

@@ -0,0 +1,30 @@
+# IoT Explorer - Release Notes
+
+## September 16th 2025
+
+### New Features
+
+- Inclusion of command data throughout the application
+- Copy button added to OCIDs
+- Settings page added for user tenancy information
+- IoT Platform domain group and domain information added
+
+### Changes
+
+- Direct link from OCI IoT Platform object listings to recent activity
+
+### Bug Fixes
+
+- Report column names and order consistancy
+
+## August 25th 2025
+
+### Inital Release
+
+Features
+
+- Traffic monitoring dashboard
+- Listing of OcI IoT Platform objects (models, adapters, and instances)
+- Reports of Raw Data, Errors, and Historized data
+- Dynamic tree structure of OCI IoT Platform objects, their relationships, and most
+recent data collected

apex/dashboard/README.md

@@ -5,14 +5,28 @@ This APEX application serves as a dashboard for monitoring IoT devices and messa
 
 ## Prerequisites
 
-1. Complete setup of Iot Platform including:
-    1. Configure an IoT Domain's Access to REST
-    2. Configure an IoT Domain's Access to APEX
+1. Complete setup of Iot Platform including access to APEX:
 2. Create an APEX user to install and access the application.
 
 Documentation about creating APEX users can be found in the
 [APEX Administration Guide](https://docs.oracle.com/en/database/oracle/apex/24.2/aeadm/managing-users-across-an-application-express-instance.html#GUID-CE23292D-05D1-4E79-BF40-8BC31E74E6C8).
 
+### Optional
+
+It is recommended that you create an OCI user and group that OCI IoT Explorer can use to
+access OCI REST APIs. However, any user with sufficient access will suffice.
+
+1. Begin by creating an OCI user group.  
+2. Next, create a user with an API Key assigned to that group.
+
+Then, as the admin-level user, create a new policy and set the following.
+
+```text
+Allow group <grp_name> to manage iot-family in compartment <cmp_name>
+Allow group <grp_name> to manage iot-domain-family in compartment <cmp_name>
+Allow group <grp_name> to manage iot-digital-twin-family in compartment <cmp_name>
+```
+
 ## Setup
 
 After completing your IoT Platform setup, you should be able to access your APEX
@@ -58,10 +72,10 @@ The following will walk you through the installation of the IoT Explorer
 application.
 
 1. Click "Import".
-2. Select the F102.sql file.
+2. Select the iot_explorer.app.sql file.
 3. Click the "Next" button.
 4. Set the "Parsing Schema" to your workspace (e.g., ****************__wksp).
-5. You may either reuse application number 105 or allow APEX to auto-assign a new
+5. You may either reuse the application number or allow APEX to auto-assign a new
 application number.
 6. Click "Install Application".
 
@@ -87,3 +101,16 @@ as well as telemetry sent to the platform (raw, rejected, and historized data).
 
 The "IoT Tree" page organizes the IoT objects and telemetry received by each object
 in a hierarchy starting with models, next adapters, then digital twins.
+
+The 'Settings' page allows you to enter a user's credentials and information
+about your tenancy.  This information, along with OCI policies allows the
+application to make the REST API calls to the IoT service. Any features requiring a
+value that has not been set will display a message to that effect.
+
+## Removal
+
+To remove the OCI IoT Explorer:
+
+1. Select the application from the APEX Application Builder and click "Delete
+Application" on the left.
+2. Load iot_explorer_teardown.sql into APEX SQL Workshop -> Scripts and run.

apex/dashboard/f102.sql

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:007df5138ee8fb979636739cdf20bbf3823fa1d9015ab70350d7d264eb8e7771
+size 845208