Merge pull request #2 from DriveWorks/1.2.0

1.2.0 - Show Specification name in URL tab title.

README.md

@@ -1,5 +1,5 @@
 # DriveWorks Live - Integration Theme Example - Simple Login (DriveApps)
-### Release: 1.1.0
+### Release: 1.2.0
 #### Minimum DriveWorks Version: 18.1
 
 A simple distributable template that renders a predefined DriveApp after a valid login.
@@ -8,9 +8,10 @@ Please note: DriveWorks are not accepting pull requests for this example.
 Join our [online community](https://my.driveworks.co.uk) for discussion, resources and to suggest other examples.
 
 ### This example:
-- Shows a login screen - credentials attached to a config file
-- Connects to the DriveWorks API
-- After a successful login, renders a DriveApp with a basic external header
+- Shows a login screen - credentials attached to a config file.
+- Connects to the DriveWorks API.
+- After a successful login, renders a DriveApp with a basic external header.
+- Displays DriveApp Alias in tab title.
 
 ### To use:
 1. Clone this repository, or download as a .zip
@@ -48,6 +49,7 @@ If you are unable to use the dynamic library loading demonstrated in this exampl
         * Ensure you are running DriveWorks 18.2 or above
         * Ensure HTTPS is enabled in DriveWorks Live's settings
         * Ensure a valid SSL certificate has been configured via DriveWorksConfigUser.xml.
+        * Ensure if using an incognito/private window, third-party cookies are not blocked (see browser settings).
         * See [Integration Theme Settings](https://docs.driveworkspro.com/Topic/IntegrationThemeSettings) for additional guidance.
 
 ---

config.js

@@ -12,6 +12,6 @@ const config = {
     driveAppPingInterval: 0,
     // (Optional) Configure 'Run' view
     run: {
-        showWarningOnExit: true, // Toggle warning dialog when exiting "Run" view with potentially unsaved changes (where supported)
+        showWarningOnExit: false, // Toggle warning dialog when exiting "Run" view with potentially unsaved changes (where supported)
     },
 };

js/run.js

@@ -1,7 +1,7 @@
 // Get config
 const SERVER_URL = config.serverUrl;
 const GROUP_ALIAS = config.groupAlias;
-const DRIVEAPP_ALIAS = config.driveAppAlias;
+const DRIVE_APP_ALIAS = config.driveAppAlias;
 
 // Get session
 const CURRENT_SESSION = localStorage.getItem("sessionId");
@@ -51,14 +51,15 @@ function dwClientLoaded() {
  */
 async function run() {
     showUsername();
+    setTabTitle(DRIVE_APP_ALIAS);
 
     try {
 
         // Run DriveApp
-        const driveApp = await DW_CLIENT.runDriveApp(GROUP_ALIAS, DRIVEAPP_ALIAS);
+        const driveApp = await DW_CLIENT.runDriveApp(GROUP_ALIAS, DRIVE_APP_ALIAS);
 
         // Render DriveApp
-        const driveAppOutput = document.getElementById("driveapp-output");
+        const driveAppOutput = document.getElementById("drive-app-output");
         await driveApp.render(driveAppOutput);
 
         // Attach events
@@ -197,3 +198,12 @@ function beforeUnloadHandler(event) {
     event.preventDefault();
     event.returnValue = "Are you sure you want to leave this page?";
 }
+
+/**
+ * Set browser tab title
+ * 
+ * @param {Object} text - The text to display in the title.
+ */
+ function setTabTitle(text) {
+    document.title = `${text} | Run - DriveWorks`;
+}

run.html

@@ -39,7 +39,7 @@
     </header>
 
     <!-- Render Area -->
-    <div id="driveapp-output" class="output is-loading"></div>
+    <div id="drive-app-output" class="output is-loading"></div>
 
     <!-- Scripts -->
     <script src="config.js"></script>