Command line parameters to auto-launch dashboards and slide shows

Using command line parameters, you can modify the properties of the iMonitor Viewer desktop shortcut you created to auto-launch dashboards and slide shows without manually selecting options from the iMonitor Viewer application. (See Create a desktop shortcut for iMonitor Viewer if you haven't yet created one.)

Use the following command line parameters, symbols, and rules to specify the dashboards and/or slide shows you want to auto-launch when you double-click the iMonitor Viewer desktop shortcut:

• fullscreenmode - Launches iMonitor Viewer in full screen mode.

• runslideshow - Starts the specified slide show automatically.

• slideshow - Supply the slide show name after switching.

• dashboard - Supply the dashboard name after switching.

Command symbols allowed:

• --

• -

• /

• :   in front of template names

Use the following rules when entering the command line details for the dashboard or slide show: 

• The command line must separate commands and template names with spaces.

• If a template name is more than one word, it must be enclosed in double quotation marks ("), for example:
  
  <”application full name”>[space]<command symbol><command>[space]<:”file name 1”[space]”file name 2”>

Examples

Launch dashboard Auto Assembly

"C:\Program Files (x86)\Aegis\FactoryLogix Applications>FactoryLogix_iMonitorViewer.exe" --dashboard : "Auto Assembly"

Launch Dashboard 1 and Dashboard 2 in full screen mode

"C:\Program Files (x86)\Aegis\FactoryLogix Applications>FactoryLogix_iMonitorViewer.exe" --fullscreenmode  --dashboard : "Dashboard 1" "Dashboard 2"

Run the slide show The Factory in full screen mode

"C:\Program Files (x86)\Aegis\FactoryLogix Applications>FactoryLogix_iMonitorViewer.exe" --fullscreenmode  --slideshow : "The Factory" --runslideshow

Launch the dashboard Yield Gauge

"C:\Program Files (x86)\Aegis\FactoryLogix Applications>FactoryLogix_iMonitorViewer.exe" /dashboard : "Yield Gauge"

Procedure

After you configure the iMonitor Viewer desktop shortcut properties using the command line parameters, you can run a selected dashboard or slide show automatically when you double-click the desktop shortcut or set up the shortcut to run automatically at Windows startup. Regardless of the auto start option you use, you need to ensure that you already granted access to the user or group whose machine the dashboards and slide shows will run on. Additionally, when running slide shows, be sure you set up the slide transitions ahead of time in iMonitor Viewer.

1. Log into the Analytics client application, then select iMonitor Designer.

2. Select File > Open, then locate and select the dashboard or slide show you want to run automatically.
   
3. Select Save As.
   
   
   
   
4. Use the options on the Grant Access tab to ensure that the dashboard or slideshow has the correct access permissions granted before you run it automatically in iMonitor Viewer, then select OK.
   

5. Right-click the iMonitor Viewer desktop shortcut icon, then select Properties.
   
   
   
   

6. Select the Shortcut tab, then modify the Target field using the command line parameters for the dashboard or slide show you want to run.
   
   
   
   Now when you double-click the iMonitor Viewer desktop shortcut, the specified dashboard and/or slide show will run automatically.
   
   

7. (Optional) To set up a dashboard and/or slide show to run automatically at Windows startup, do the following:
   
   

   • Drag and drop the iMonitor Viewer desktop shortcut icon you created and customized into your Windows Startup folder located here:
     
     C:\Users\<user name>\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup
     
     (Be sure to also enable viewing of hidden folders so you can see them.) The next time you start Windows, the specified dashboard and/or slide show will open and run automatically.
     
     

     Note:

     The All Users Startup folder should be located here: C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup. You can create the folders if they aren't there. 

Run a dashboard or slide show from a command prompt

An optional way to open and run a dashboard or slideshow is to open a Command Prompt window, then enter the command line parameters for the dashboard and/or slideshow you want to run. Here's an example:

Troubleshooting

If you have a problem opening and running a dashboard or slide show from the iMonitor Viewer shortcut or at Windows startup (if configured), check the following:

• Ensure that the FactoryLogix Realtime Analysis Service is running. If necessary, stop, then restart the service in Server Management > Services Settings. 
• Log into the Analytics client application, select iMonitor Viewer, then open and run a dashboard or slide show from the application. 
• Double-check the command line parameters you set up in the iMonitor Viewer desktop shortcut Target field.
• If configured to auto start a dashboard or slide show at Windows startup, open the Windows Startup folder, right-click the iMonitor Viewer shortcut, then double-check the command line parameters you set up in the iMonitor Viewer desktop shortcut Target field.