Merge pull request #22 from oracle-samples/iot_explorer_update

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

Author: wsanders00

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