DriveWorks Pro 22

How To: Automatically Launch a Dashboard Tile (KB23012601)

How To: Automatically Launch a Dashboard Tile

There are two methods to control what page is displayed when a DriveApp is launched:

• Start Parameter
• Integration Theme

Start Parameter

You can set the Start Parameter with the name of the Dashboard you want to display:

• Home|AllUserTeams=TRUE

  Will display the default Dashboard

• CPQ|AllUserTeams=TRUE

  Will display the default CPQ Dashboard

• CPQ Quotes and Orders|AllUserTeams=TRUE

  Will display the CPQ Quotes and Orders Dashboard

Please see Start Parameter for more information on DriveApp Start Parameters.

Integration Theme

When displaying DriveApps in the web, using the Integration Theme, you can trigger a click programmatically to launch a Dashboard Tile.

This makes use of a Specification Macro within the Dashboard that performs the Dashboard Tile click programmatically.

There are a few additional steps that need to be followed in order to run this Macro via the Integration Theme:

1. Allow access to the Macro named 'LaunchTile' inside the Project named 'DriveApp-Dashboard'

   You will need to allow access to any Team that will be running the DriveApp

   <project name="DriveApp-Dashboard">
     <macro name="LaunchTile">
       <team name="Administrators"/>
     </macro>
   </project>

2. Add the following after the runDriveApp() method from the Integration Theme Client SDK.

   await DW_CLIENT.runMacro(GROUP_ALIAS, driveApp.id, { macroName: 'LaunchTile', macroArgument: '<tileIndex>' })

const hostedDriveAppId = await DW_CLIENT.getSpecificationConstantByName(GROUP_ALIAS, driveApp.id, 'EmbeddedDriveAppId');
await DW_CLIENT.runMacro(GROUP_ALIAS, hostedDriveAppId.value, { macroName: 'LaunchTile', macroArgument: '<tileIndex>' });