Wonderware SmartGlance

Transcription

1 Wonderware SmartGlance Mobile Reporting Connector Guide Version 2016 July 2016

2 2016 Schneider Electric Software, LLC. All rights reserved. No part of this documentation shall be reproduced, stored in a retrieval system, or transmitted by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of Schneider Electric Software, LLC. No liability is assumed with respect to the use of the information contained herein. Although precaution has been taken in the preparation of this documentation, Schneider Electric Software, LLC assumes no responsibility for errors or omissions. The information in this documentation is subject to change without notice and does not represent a commitment on the part of Schneider Electric Software, LLC. The software described in this documentation is furnished under a license agreement. This software may be used or copied only in accordance with the terms of such license agreement. ArchestrA, Avantis, DYNSIM, edna, EYESIM, Foxboro, Foxboro Evo, I/A Series, InBatch, InduSoft, InStep, IntelaTrac, InTouch, PIPEPHASE, PRiSM, PRO/II, PROVISION, ROMeo, Schneider Electric, SIM4ME, SimCentral, SimSci, Skelta, SmartGlance, Spiral Software, VISUAL FLARE, WindowMaker, WindowViewer, and Wonderware are trademarks of Schneider Electric SE, its subsidiaries, and affiliated companies. An extensive listing of Schneider Electric Software, LLC trademarks can be found at: All other brands may be trademarks of their respective owners. Schneider Electric Software, LLC Rancho Parkway South Lake Forest, CA U.S.A. (949) Publication date: 7/22/2016

3 Contact Us Contact Schneider Electric Software Technical Support Contact our Software Technical Support Group if you have a question or issue with Avantis, SimSci, Skelta, or Wonderware software products. Priority for Customer First Members: custfirstsupport@wonderware.com Customers without a support agreement: wwsupport@wonderware.com Americas: Lake Forest, California, U.S. Tel: / Asia Pacific: Shanghai, China Tel: (All Asia) / (China) / gcssupport.apac@schneider-electric.com Europe and Middle East, Africa (EMEA): Bratislava, Slovakia Tel: / See our website at for a list of toll-free numbers. Contact Schneider Electric Software Learning Services Contact Software Learning Services for assistance regarding classes, schedule, offerings, frequently asked questions, tuition, policies, and more. Phone: in the U.S. and Canada direct Fax: software.training@schneider-electric.com

4

5 Contents Welcome to Wonderware SmartGlance Mobile Reporting Connector What's New in SmartGlance MRC Chapter 1 Installing SmartGlance MRC System requirements Windows 8.1 prerequisites Windows 10 prerequisites Windows Server 2008 R2 prerequisites Windows Server 2012 R2 prerequisites Install.NET Framework Installation Install SmartGlance MRC Upgrade to SmartGlance MRC Use silent installation for SmartGlance MRC Starting silent installation Silent installation syntax for 64-bit computer Silent installation syntax for 32-bit computer Silent installation syntax for common setup Verifying the installation Uninstall SmartGlance MRC Repair SmartGlance MRC installation Chapter 2 Configuring SmartGlance MRC Configure the authentication mode Configure proxy server settings Configure website communication settings Configure data transfer ID Configure SmartGlance web administrator settings Configure data providers Configure the connection type Chapter 3 Using SmartGlance MRC About security roles Administrator Manager User Version

6 Contents Manage mobile users View a list of mobile users Add a user profile Edit a user profile Delete a user profile View a user's permissions Export user profiles Import multiple users Manage mobile groups View groups Add a group Edit a group Delete a group View users within a group View a group's permissions Export a group Import multiple groups Manage data providers View data providers Add a data provider Import multiple data providers Edit data provider Delete a data provider Export data providers Manage mobile reports View a list of reports Add a report Add tag data to a report Add tabular data to a report Subscribe users to a report Subscribe groups to a report Import multiple reports Export reports Edit a report Copy a report Import multiple tags into a report Delete a report Chapter 4 Troubleshooting Issue: "1603 Fatal error during installation" displays Possible cause Solution Issue: Can't access SmartGlance MRC website Possible Cause Solution Issue: Reports not sent to SmartGlance API Solution Issue: Reports aren't published on the mobile device Solution Issue: "Method not found: Boolean ISNet.WebUI.ISNetControl.get_IsMvc() " displays at login Possible cause Version 2016

7 Contents Wonderware SmartGlance Mobile Reporting Connector Guide Solution Issue: "No connection could be made because the target machine actively refused it" displays at login Possible Cause Solution Issue: SmartGlance MRC doesn't respond (Windows Server 2008 R2 or 2012 R2) Solution Issue: Need to verify that DCOM port 135 is open on Historian Server Solution Issue: Need to set <customerrors> element in the configuration file Solution Issue: SmartGlance MRC website has strange formatting in Internet Explorer Solution Issue: Need to change compatibility view settings in Internet Explorer Solution Issue: Need to view SmartGlance MRC log messages Solution Issue: Need debug tools and logs Solution Issue: Need to enable SMC log files Solution Issue: Need to change the default port number for DataReportConfig and ProviderManager web services Solution Issue: Need to find the LocalDB MS Log file Solution Issue: Need to connect to a LocalDB instance Solution Issue: Need to export SmartGlance MRC LocalDB to SQL Server Solution Appendix Remove log components for an earlier version of SmartGlance MRC Security matrix Sample queries for tabular reports Corporate Energy Management Wonderware Manufacturing Execution System Wonderware Alarm Database Wonderware Intelligence Wonderware IntelaTrac Well Field Application Software Asset Manager SmartGlance MRC and Microsoft SharePoint Verify the service endpoint Version

8 Contents Backup and restore SmartGlance MRC configuration data Configure maximum data points Archived Documentation Version 2016

9 Welcome to Wonderware SmartGlance Mobile Reporting Connector 2016 Wonderware SmartGlance Mobile Reporting Connector (MRC) 2016 gives you the control to make your plant's reports and real-time data available anywhere, anytime. Coworkers receive real-time reports through Wonderware SmartGlance on their phones, tablets, and other mobile devices. Note: For a PDF version of all help topics for Wonderware SmartGlance Mobile Reporting Connector 2016, click here For links to help for earlier versions of SmartGlance MRC, see Archived Documentation (see "Archived Documentation" on page 134). Version

10 What's New in SmartGlance MRC 2016 What's New in SmartGlance MRC 2016 SmartGlance MRC 2016 includes these new features: Improved user experience and robustness SmartGlance MRC 2016 includes several improvements to improve robustness and user experience. Improved connectivity for Historian and SQL Connectivity with Wonderware historian and SQL Server is more robust in SmartGlance MRC Windows 10 compatibility SmartGlance MRC 2016 is supported on computers running Windows 10. Setup with Installshield 2015 The SmartGlance MRC 2016 setup program has been upgraded to use Installshield Note:On-premises server support and ibutton color support are not included in this version of SmartGlance MRC. 10 Version 2016

11 CHAPTER 1 Installing SmartGlance MRC The installation process for SmartGlance MRC includes: System requirements on page 11 SmartGlance MRC installation Product Compatibility For a list of products that are compatible with SmartGlance MRC 2016, see: SmartGlance MRC can also retrieve data from any standard Microsoft SQL Server. System requirements This section describes the software system requirements to install SmartGlance MRC Operating System,.NET Framework, and SQL Server Required software Operating System Supported.NET Framework Version 4.5 Note: For information about which operating systems are compatible with SmartGlance MRC 2016, see: MLClient/ MLClient/ Note: If.NET Framework is not already installed on your computer, SmartGlance MRC setup will install it for you. *Language: English (United States) and Server Collation: SQL_Latin1_General_CP1_CI_AS Other requirements Component Requirement IIS 7.5, 8.0, or 8.5 Browsers Internet Explorer 11 Google Chrome 42 or later Firefox Mozilla 38 or later Version

12 Installing SmartGlance MRC If you encounter any formatting issues while viewing the SmartGlance MRC website in Internet Explorer, see Troubleshooting (see "Troubleshooting" on page 57). Windows 8.1 prerequisites Before installing SmartGlance MRC 2016 on Windows 8.1, you must install the required web server roles and.net Framework 4.5 features. To install the required roles and features 1. From the Windows Start menu, click Control Panel, and then click Programs and Features. 2. Click Turn Windows features on or off. 3. Check the following to enable Microsoft.NET Framework 4.5 features: o.net Framework 4.5 Advanced Services 4. Expand Internet Information Services > World Wide Web Services > Application Development Features and check the following: o.net Extensibility 4.5 o ASP.NET 5. Expand Internet Information Services > World Wide Web Services > Common HTTP Features and check the following: 12 Version 2016

13 Installing SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide o Static Content (if not enabled) 6. Click OK. Windows 10 prerequisites Before installing SmartGlance MRC 2016 on Windows 10, you must install the required web server roles and.net Framework 4.6 features. To install the required roles and features 1. From the Windows Start menu, click Control Panel, and then click Programs and Features. 2. Click Turn Windows features on or off. 3. Check the following to enable Microsoft.NET Framework 4.6 features: o.net Framework 4.6 Advanced Services 4. Expand Internet Information Services > World Wide Web Services > Application Development Features and check the following: o.net Extensibility 4.6 Version

14 Installing SmartGlance MRC o ASP.NET 5. Expand Internet Information Services > World Wide Web Services > Common HTTP Features and check the following: o Static Content (if not enabled) 6. Click OK. Windows Server 2008 R2 prerequisites Before installing SmartGlance MRC 2016 on Windows Server 2008 R2 (64-bit), you must install the required web server roles. To install the required web server roles 1. Open Server Manager. o o On Windows Server 2008: From the Start menu, click All Programs, click Control Panel, click Administrative Tools, and then click Server Manager. On Windows Server 2008 R2: From the Start menu, click All Programs, click Administrative Tools, and then click Server Manager. 14 Version 2016

15 Installing SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide 2. Click Add Roles. 3. In the Select Server Roles dialog box, select Server Roles from the left pane. On the right, mark the Web Server (IIS) check box. 4. Click Next. The focus moves to the Web Server (IIS) section on the left pane. Version

16 Installing SmartGlance MRC 5. Click Next. The focus moves to the Role Services section on the left pane. Note: If Web Server is installed already on your computer, you can access Role Services from Server Manager > Roles > Add Role Services. 6. In the Select Roles Services dialog box, from the Role services list, check the following: o ASP.NET 7. In the Add Roles Wizard dialog box, click Add Required Role Services. This updates the Roles services list. 16 Version 2016

17 Installing SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide 8. Click Next. 9. Review the roles, role services, and features that you want to install and then click Install. 10. When installation completes, click Close. Windows Server 2012 R2 prerequisites Before installing SmartGlance MRC 2016 on Windows Server 2012 R2, you must install the required web server roles. To install the required web server roles 1. From Apps, click Server Manager. The Server Manager Dashboard appears. 2. Click Add roles and features. 3. The Add Roles and Features Wizard opens and displays the Before you begin page. Click Next. 4. On the Select server roles page, click Server Roles in the left pane. On the right, expand Web Server (IIS), and then expand Application Development. 5. Check the following: o ASP.NET 4.5 (Installed) o.net Extensibility 4.5 Version

18 Installing SmartGlance MRC 6. Click Next and expand.net Framework 4.5 Features. Check the following: o.net Framework 4.5 o ASP.NET Click Next. The Confirm Installation Selections window appears. 8. Review the roles, role services, and features that you want to install and then click Install. 9. When the installation completes successfully, click Close. Install.NET Framework Use this table to determine how you'll install.net Framework for use with SmartGlance MRC Operating System Update Method Source Windows Server 2008 R2 Standalone Installer Download it from: aspx?id= Version 2016

19 Installing SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide Windows Server 2012 R2 Enable from IIS aspx?id= Go to Start > Administrative Tools > Server Manager. 2. Click Add Features. 3. Select.NET Framework 4.5 Features >.NET Framework 4.5. Windows 8.1 Enable from IIS 1. Go to Start > Control Panel > Programs > Programs and Features. 2. Click Turn Windows features on or off. 3. Enable the Microsoft.NET Framework 4.5 feature. Windows 10 Enable from IIS 1. Go to Start > Control Panel > Programs and Features. 2. Click Turn Windows features on or off. 3. Enable the Microsoft.NET Framework 4.5 or 4.6 feature. Installation This section includes installation procedures for SmartGlance MRC Install SmartGlance MRC 2016 (see "Install SmartGlance MRC 2016" on page 19) Upgrade to SmartGlance MRC 2016 (see "Upgrade to SmartGlance MRC 2016" on page 22) Use silent installation (see "Use silent installation for SmartGlance MRC " on page 23) It also covers repairing and uninstalling: Uninstall SmartGlance MRC (see "Uninstall SmartGlance MRC " on page 24) Repair the SmartGlance MRC installation (see "Repair SmartGlance MRC installation" on page 24) Install SmartGlance MRC 2016 If this is the first time you are installing SmartGlance MRC on your computer, follow these steps. SmartGlance MRC setup installs components for Web Server and Application Server. You can install these components on the same computer, but in different folders. To install SmartGlance MRC Download the Wonderware SmartGlance Mobile Reporting Connector (MRC) 2016 setup. 2. Unzip the downloaded file on the server. Note: Be sure to run Setup.exe with Administrative privileges. 3. Run Setup.exe to install SmartGlance MRC. Setup validates the System requirements on page 11 and displays messages about any updates needed. Version

20 Installing SmartGlance MRC 4. Click Install. Setup displays the status of any pending requirements that setup detects. 5. Click Next. 6. Read and accept the license agreement. Then click Next. 7. Define destination locations: o o Accept the default paths for the website and files, or make changes using the Browse buttons. Accept the default ports, or type new ones for Website Port Number and Windows Service Port Number. 20 Version 2016

21 Installing SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide Important: The TCP port for Website and Service should not match and should not be used by other applications. 8. Click Next. 9. Accept the default to add desktop shortcuts, or unmark the check boxes to change that. 10. Click Finish. The Wonderware SmartGlance Mobile Reporting Connector - Configuration Utility opens automatically. Learn more about using SmartGlance MRC Configuration Utility (see "Configuring SmartGlance MRC" on page 27). Version

22 Installing SmartGlance MRC Upgrade to SmartGlance MRC 2016 Use these steps to upgrade from an earlier version of SmartGlance MRC. Be sure all System requirements on page 11 are met first. To upgrade to SmartGlance MRC Follow the steps to install SmartGlance MRC 2016 (see "Install SmartGlance MRC 2016" on page 19). 2. When asked if you want to migrate the existing information to SmartGlance MRC 2016, click Yes. Note: Clicking No clears existing SmartGlance MRC information. If that happens, use the following procedure to recover. The existing information is migrated to default LocalDB if you have updated from an erlier version or configured an earlier version of SmartGlance MRC using local database. If you change the Connection Type to SQL Server Database, the existing information must be manually migrated from LocalDB to SQL Server Database. 3. Click OK. The SmartGlance MRC service account is now changed into Network Service, so all the Historian 10 and SQL data providers with no alternate credentials specified may not connect. Be sure to manually update alternate credentials for these data providers. The other tabs of SmartGlance MRC - Configurator Utility are enabled and populated with the existing information. You can now use the SmartGlance MRC Configuration Utility (see "Configuring SmartGlance MRC" on page 27) to save configurations before accessing SmartGlance MRC. Important: After the upgrade process and before starting the latest version of SmartGlance MRC, make sure that you have cleared your web browser's cache. After the configurations are saved, the SmartGlance MRC website opens. To recover information from SmartGlance MRC that was accidentally removed 1. Using Windows Explorer, browse to the SmartGlance MRC installation path: <Drive>\Wonderware\MobileReportingConnector The default path for 32-bit system is: <Drive>\Program Files\Wonderware\MobileReportingConnector The default path for for 64-bit system is: <Drive>\Program Files(x86)\Wonderware\MobileReportingConnector 2. Take a backup of the configuration files from the BackupConfigFiles folder. 3. Uninstall SmartGlance MRC (see "Uninstall SmartGlance MRC " on page 24). 4. Install the earlier version of SmartGlance MRC that was upgraded. 5. Restore the SmartGlance MRC configuration (see "Backup and restore SmartGlance MRC configuration data" on page 131). 6. Upgrade to SmartGlance MRC 2016 (described above). 22 Version 2016

23 Installing SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide Use silent installation for SmartGlance MRC SmartGlance MRC supports silent (command line) installation. Silent installation runs through the entire installation process without user interaction. You can run Setup.exe from the command line that points to a setup file containing pre-scripted responses to SmartGlance MRC installation prompts. Starting silent installation The syntax for the silent installation command consists of the full path to the Setup.exe file (typically the folder location on your local computer), the command line switch for silent installation, and the full path to the setup file. You can use generic Setup.exe or one of the following, depending on your system properties. If you are using a 32- bit computer: MobileReportingConnectorSetup2016(x86).exe If you are using a 64-bit computer: MobileReportingConnectorSetup2016(x64).exe You can provide the Data Transfer ID details to silently configure the installation as well, if you are running the setup files based on your system properties. If you are using the generic Setup.exe, you do not need to specify the Data Transfer ID details. Silent installation syntax for 64-bit computer C:\\ bin\x64\ MobileReportingConnectorSetup2016(x64).exe s f2 c:\.log /z Note: The full file specification of the log file (filename plus location of file) should be included to trace any issues in case of silent install failure. For example: C:\Wonderware\bin\x64\ MobileReportingConnectorSetup2016(x64).exe s f2 c:\logfile.log /z 7581CC2B-XXXX-XXXX-XXXX-ED1248C83BED Silent installation syntax for 32-bit computer C:\\ bin\x86\ MobileReportingConnectorSetup2016(x86).exe s f2 c:\.log /z Note: The full file specification of the log file (filename plus location of file) should be included to trace any issues in case of silent install failure. For example: C:\Wonderware\bin\x86\ MobileReportingConnectorSetup2016(x86).exe s f2 c:\logfile.log /z 7581CC2B-XXXX-XXXX-XXXX-ED1248C83BED Silent installation syntax for common setup C:\\ Setup.exe silent For example: C:\Wonderware\ Setup.exe silent The /silent option completely disables the graphical user interface of Setup.exe. There is no input from or feedback to the user. However, the installation logs progress to logfile.log in the previous examples. Version

24 Installing SmartGlance MRC Verifying the installation After running the silent installation successfully, you can verify the installation by opening the website using the site. You can also verify the successful configuration of the SmartGlance MRC by opening the SmartGlance MRC Configurator Utility (see "Configuring SmartGlance MRC" on page 27) and validating the data transfer ID details. Uninstall SmartGlance MRC You can use the SmartGlance MRC installation program to remove the previous installation SmartGlance MRC on your computer. (You can also use the Windows Add/Remove Programs from the Windows Control Panel.) To uninstall SmartGlance MRC using the SmartGlance MRC installation program 1. Run Setup.exe as administrator. The Repair or Remove the Program dialog box appears. 2. Click Remove, and then click Next. A confirmation dialog box appears. 3. Click Yes. The Uninstall Complete dialog box appears. 4. Click Finish. After uninstalling SmartGlance MRC from your computer, you must manually clean up LocalDB. Failure to do this might result in conflict with the existing shared version of LocalDB and the latest version when you would want to install the latest version of SmartGlance MRC. To manually clean up LocalDB 1. Open the LocalDB info in the command prompt using the Network Service account. 2. Run the following command to stop the MRCLocalDBInstance database: sqllocaldb stop MRCLocalDBInstance 3. Run the following command to delete the MRCLocalDBInstance: sqllocaldb delete MRCLocalDBInstance 4. From the desktop, open Windows File Explorer to the following path that contains the physical LocalDB *.MDF and *.LDF database files. 5. Paste %UserProfile% into the Windows File Explorer address bar to navigate to that user s directory profile, assuming that you are currently logged into the computer as the LocalDB Owner profile. 6. Delete the MRCLocalDB.mdf and MRCLocalDB_log.ldf files from C:\Windows\ServiceProfiles\NetworkService. Repair SmartGlance MRC installation You can use the SmartGlance MRC installation program to repair corrupt files for the existing installed features. (You can also use the Windows Add/Remove Programs from the Windows Control Panel.) To repair SmartGlance MRC features with the installation program 1. Run Setup.exe as administrator. The Repair or Remove the program dialog box appears. 2. Click Repair, and then click Next. The Maintenance Complete dialog box appears. 3. Click Finish. 24 Version 2016

25 Installing SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide Version

26

27 CHAPTER 2 Configuring SmartGlance MRC The SmartGlance MRC Configuration Utility automatically launches as soon as setup is complete. You can also do the following to open it. Note: You must have Administrative permissions (see "About security roles" on page 36) to run the MRC Configuration Utility. To open the SmartGlance MRC Configuration Utility Double-click. You cannot delete or modify the default administrator configured in the SmartGlance MRC Configuration Utility. Only a default administrator has the permissions to change the address and password of the default administrator. Note: Be sure to close the SmartGlance MRC website before updating configuration settings with SmartGlance MRC Configuration Utility. Version

28 Configuring SmartGlance MRC Configure the authentication mode From the Authentication tab, you can configure the authentication mode to either Local Mode or Active Directory. When the authentication mode is Local, SmartGlance MRC users with administrative privileges or managers can log into SmartGlance MRC. When the authentication mode is Active Directory, active directory users who have administrator or manager rights in SmartGlance MRC can log into SmartGlance MRC. You can configure the default administrator in the SmartGlance MRC Configurator tool while setting the authentication mode. Note: You cannot delete or modify the default administrator configured in the SmartGlance MRC Configuration tool. Only a default administrator has the rights to change the address and password of the default administrator. To set up the authentication mode as Local 1. Under Authentication Mode, click Local Mode. 2. In Admin User, type the administrator's user name. 3. In Admin Password, type the administrator's password. 4. In , type a valid address of the administrator. 28 Version 2016

29 Configuring SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide 5. Click Set Authentication Mode. To set up the authentication mode as Active Directory 1. Under Authentication Mode, click Active Directory. 2. In Active Directory Data Source, type the Active Directory's data source. 3. In Active Directory Search Base, type the Active Directory's search base. 4. In Admin User, type the administrator's user name. 5. In Admin Password, type the administrator's password. 6. Click Test LDAP. If everything is working well, "LDAP test successful" displays and the field shows an address. 7. Click Set Authentication Mode. Configure proxy server settings If SmartGlance MRC uses a proxy server to connect to the SmartGlance server, you can configure the proxy server settings from the Proxy Server tab. You can set the proxy server as either the default proxy or a customized proxy. To set up the default proxy server setting 1. Under Proxy Server Setting, click Default Proxy. 2. Click Set Proxy Server. To set up customized proxy server setting 1. Under Proxy Server Setting, click Custom. 2. In Proxy Server Address, type the proxy server address that SmartGlance MRC will use to communicate with SmartGlance. 3. In Proxy Server Port, type the port number. 4. If the proxy server being used requires authentication, mark the Proxy Authentication Required check box. 5. In Username, type the authentication user name. 6. In Password, type the authentication password. Version

30 Configuring SmartGlance MRC 7. Click Set Proxy Server. Configure website communication settings From the Website Settings tab, you can set the IIS session timeout value and the Windows Service port for MRC. To set the IIS session timeout 1. In IIS Session Timeout, type the number of minutes (1-60) until the session times out.the default is 20 minutes. Note: IIS Session timeout define action window time for a user and thus represents, the delay in which an attacker can try to steal and use an existing user session. It is recommended that you do not set session timeout value greater than 20 minutes. 2. Click Set Communication Details. To set the Windows Service port 1. In Windows Service Port, type the port number ( ). The default is Click Set Communication Details. Configure data transfer ID A data transfer ID is your unique customer ID sent to you by after you purchase a valid license for Wonderware SmartGlance. You can also get a trial account data transfer ID if you want to have a free trial of SmartGlance MRC. 30 Version 2016

31 Configuring SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide From the Data Transfer ID tab, you can register your data transfer ID. If you have not received one, you can generate a data transfer ID for use when you test drive the product. The Generate Data Transfer ID check box is available only when you have configured with a cloud-hosted server. (See Configure SmartGlance web administrator settings on page 32.) To get a free-trial data transfer ID 1. Click the Generate Data Transfer ID check box. 2. In User , type your address. 3. In Company Name1, type the first line of the company name that you want to register with SmartGlance. 4. In Company Name2, type the the second line of the company name that you want to register with SmartGlance. 5. Click Submit. Note: You can find the information you typed on the SmartGlance Server tab for Cloud Hosted Server. You will receive an message with the data transfer ID. To register your data transfer ID 1. In Data Transfer ID, type the data transfer ID you received. 2. Click Set Data Transfer ID. Now you can use SmartGlance MRC. Version

32 Configuring SmartGlance MRC Configure SmartGlance web administrator settings From the SmartGlance Web Admin tab, you can configure the SmartGlance web administrator settings. You can provide details to log into the SmartGlance server. If the SmartGlance server credentials are valid, the reports being updated or deleted from the Wonderware Mobile Reporting Connector will also be updated or deleted from the SmartGlance server. To configure web administrator settings 1. In User , type the address registered with SmartGlance. 2. In Password, type the password registered with SmartGlance. 3. In Company Name 1, type the first line of the company name registered with SmartGlance. 4. In Company Name 2, type the second line of the company name registered with SmartGlance. 5. Click Set Web Admin Settings. Note: To find the Company Name 1 and Company Name 2 values for your company, click the SmartGlance Web Admin link and log into the SmartGlance website as an administrator. Configure data providers From the Data Providers tab, you can configure customized data providers. 32 Version 2016

33 Configuring SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide Note: Please be sure MRC can ping all SQL Server and Wonderware Historian server computers configured in the application as data providers. This allows the MRC service to work properly. Before configuring the custom data provider, make sure that you have the CAB files with the necessary data provider details. To import a list of data providers 1. In Load Data Provider, type the name of the CAB file (*.cab) containing the data provider details. 2. Click Import Data Provider. After you have imported the custom data provider, you can configure reports using this provider. Note: If you specify any user interface in the custom data provider, it appears when you add or edit the data provider of that particular type. Version

34 Configuring SmartGlance MRC Configure the connection type From the Connector Type tab, you can configure the SmartGlance MRC connection type as either the default or as a specific SQL server database. Setting the connection type to default associates SmartGlance MRC with a SQL Server Express LocalDB that is installed on the same computer as the SmartGlance MRC service. Setting the connection type to SQL Server Database creates a SQL database either locally to the WMRC service or remotely on a dedicated database server. To set the connection type to default 1. Click Default Type. 2. Click Set Default Connection. To set the connection type as SQL Server database 1. Click SQL Server Database. 2. In Server Name, type the database server name. 3. In Authentication Type, select either Windows Authentication or SQL Server Authentication. 4. If you selected SQL Server Authentication, type a user name and password. Note: The Username and Password fields are disabled if you selected Windows Authentication. In that case, SmartGlance MRC uses the Log On As credentials. 5. Click Test Connection. If everything is working well, "Test Connection successful" displays. 6. Click OK. 7. In Database Name, type a name for the SmartGlance MRC database. 8. Click Create Database. 34 Version 2016

35 CHAPTER 3 Using SmartGlance MRC You can use SmartGlance MRC to manage mobile users and groups, the data providers used to create reports, and the reports that your coworkers access via SmartGlance on their mobile devices. To start SmartGlance MRC Double-click. Logging into SmartGlance MRC You can log into SmartGlance MRC using using either of these modes of authentication (see "Configure the authentication mode" on page 28): Local authentication With this mode, SmartGlance MRC users with administrative or manager privileges can log into the application with a user name and password. Active directory authentication To log into SmartGlance MRC, the active directory users must be registered with SmartGlance MRC as administrators or managers. The default administrator is configured in the SmartGlance MRC Configuration Utility while setting the mode of authentication. Active directory authentication also supports single sign on. With single sign on enabled, the active directory users with administrative or manager privileges in SmartGlance MRC are automatically logged into the application. You can set the authentication mode using the SmartGlance MRC Configurator utility. For more information, see Configure the authentication mode on page 28. To enable single sign on The first four steps of this procedure let you configure Internet Explorer for automatic login. 1. Open the Internet Options dialog box by choosing Internet Options either from Control Panel or from the Tools menu in Internet Explorer. 2. In the Internet Options dialog box, on the Security tab, select Local intranet, and then click Custom Level. 3. In the Security Settings dialog box, under Logon, select Automatic logon only in Intranet zone, and then click OK. 4. In the Internet Options dialog box, click OK. The remaining steps of this procedure disable anonymous authentication. 5. Open Internet Information Services (IIS) Manager: o In Windows 2008 R2: On the taskbar, click Start, point to Administrative Tools, and then click Internet Information Services (IIS) Manager. o In Windows 7: From the Start menu, click Control Panel. Version

36 Using SmartGlance MRC Click System and Security. Click Administrative Tools. Double-click Internet Information Services (IIS) Manager. 6. In the Connections pane, expand the server name, expand Sites, go to the level in the hierarchy pane that you want to configure, and then click the MobileReportingConnector website. 7. Scroll to the IIS section in the Home pane, and then double-click Authentication. 8. In the Authentication pane, right-click Anonymous Authentication. The shortcut menu appears. 9. Click Disable. 10. Select Windows Authentication, and then right-click it. The shortcut menu appears. 11. Click Enable. Configuring SSL for SmartGlance MRC website By default, the SmartGlance MRC website uses HTTP protocol to communicate between the browser and the server. With this protocol, information exchanged between the browser and server is not encrypted and is subject to security issues such as phishing. Because of this, it is recommended to encrypt the information exchange between the browser and server. To do this, you should manually configure the SmartGlance MRC website to use HTTPS protocol. For more information configuring SSL, see About security roles SmartGlance MRC supports three security roles: Administrator, Manager, and User. These security roles can be assigned to users and groups. You can view permissions for a user's or group's security role by using the Permissions option for that user or group. Administrator The user who belongs to the Administrator security role has the maximum permissions. An administrator can: Create users, groups, data providers, and reports Edit users, groups, data providers, and reports Delete a users, groups, data providers, and reports 36 Version 2016

37 Using SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide Manager User A user who belongs to the Manager security role can: Create reports, users with User role, and groups with User role Edit reports, users or groups with User role Users that access the SmartGlance mobile application typically have User security role and do not need Administrator or Manager capabilities. Those assigned User security role cannot log into the SmartGlance MRC website. They cannot create, edit, or delete any user, group, data provider, or report. Manage mobile users In SmartGlance MRC, you can view, create, and manage profiles for SmartGlance users. Once a user profile is created, you can subscribe that person to various SmartGlance reports (see "Add a report" on page 48) from the Reports page of SmartGlance MRC. You can also assign Administrator or Manager security role (see "About security roles" on page 36) to users who need to use the SmartGlance MRC website. After logging into SmartGlance MRC, the Users page appears by default. You can also do the following to open it. To begin managing users Click, and then click Users. View a list of mobile users To view a list of mobile users Click, and then click Users. By default, the list shows ten users at a time. Version

38 Using SmartGlance MRC To change the records per page From the Records per page list in the upper-right corner, choose how many records to display per page. To sort names in the list (ascending or descending order) In the table header, click . Note: The selected page size in the Records per page list is stored in the cookies. So, if you delete the temporary Internet files or cookies, the Records per page list is reset to the default value of 10. Add a user profile When SmartGlance MRC is configured, it is set up to use either Local or Active Directory authentication mode (see "Configure the authentication mode" on page 28). This mode affects which fields are displayed on the Add User page. To add a user in Local authentication mode 1. Click, and then click Users. 2. Click. 3. In , type an address of the user registered with the SmartGlance server. 4. In Name, type a unique name for the new user. 5. From Security Role, select a security role (see "About security roles" on page 36) for this new user. Note: Only users with Administrator or Manager security role can log into SmartGlance MRC. Users with User security role cannot unless they are added to a group with Administrator or Manager permissions. 6. In Password, type the password. Password is mandatory if you select the Administrator or Manager security role. 7. Click Add. To add a user in Active Directory authentication mode 1. Click, and then click Users. 2. Click. 3. In the Search box, type a user name. A list of user names matching the search criteria appears. 4. Select from the list of search results. The and Name box display the corresponding address and user name. 5. From Security Role list, select a security role (see "About security roles" on page 36) for this new user. 6. Click Add. 38 Version 2016

39 Using SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide Edit a user profile When SmartGlance MRC is configured, it is set up to use either Local or Active Directory authentication mode (see "Configure the authentication mode" on page 28). This mode affects which fields are displayed on the Edit User page. To edit a user profile 1. Click, and then click Users. 2. Select the user profile that you want to modify. 3. Click. 4. Make changes as needed. Note: When a security role (see "About security roles" on page 36) is updated, the change is applied the next time the user logs in to the SmartGlance MRC website. 5. If you want to change the password, check Change Password and type a new password. 6. Click Update. Delete a user profile To delete a user profile 1. Click, and then click Users. 2. Select a user that you want to remove from the list. 3. Click. View a user's permissions To view permissions 1. Click, and then click Users. 2. Select the user and then click. The View Security Role Permissions page shows the user's security role and related permissions (see "About security roles" on page 36). It also shows the security role and related permissions for any groups to which the user belongs. Export user profiles To export user profiles 1. Click, and then click Users. 2. Select the user that you want to export. (Press CTRL to select multiple users.) 3. Click. 4. Save and/or open the CSV file. CSV files list the name, , and security role for each user. For example: "Dwayne, Dwayne@snackbox.com, Manager" where Name is Dwayne, is Dwayne@snackbox.com, and Security Role is Manager. Version

40 Using SmartGlance MRC Import multiple users To import users (Local authentication mode only) 1. Click, and then click Users. 2. Click. 3. Click Browse and select a CSV file. 4. Click Ignore or Overwrite to specify how to handle any duplicate records. Note: All users will be imported with the User security role, even if they were assigned another security role before import. You can edit a user (see "Edit a user profile" on page 39) to change the assigned security role. 5. Click Import. You can see the number of users successfully imported in the message which appears below the Import button. Tips For a sample CSV file of multiple users, click Download Template. CSV files list the name, , and security role for each user. For example: "Dwayne, Dwayne@snackbox.com, Manager" where Name is Dwayne, is Dwayne@snackbox.com, and Security Role is Manager. Click Save Logs to save the imported log in a text file format. The Import Log lists whether each user record was successfully imported, a duplicate record, or ignored. For duplicates, you will be able to choose to overwrite or ignore the record. Manage mobile groups From SmartGlance MRC, you can define groups of users who can access your plant's data via SmartGlance on their mobile devices. 40 Version 2016

41 Using SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide To begin managing groups Click, and then click Groups. View groups To view groups Click, and then click Groups. By default, the list shows ten groups at a time. To change the records per page From the Records per page list in the upper-right corner, choose how many records to display per page. To sort names in the list (ascending or descending order) In the table header, click Name. Note: The selected page size in the Records per page list is stored in the cookies. So, if you delete the temporary Internet files or cookies, the Records per page list is reset to the default value of 10. Add a group When SmartGlance MRC is configured, it is set up to use either Local or Active Directory authentication mode (see "Configure the authentication mode" on page 28). This mode affects which fields are displayed on the Add Groups page. To add a group in Local authentication mode 1. Click, and then click Groups. 2. Click. Version

42 Using SmartGlance MRC 3. In Name, type a unique name for the group. 4. In Description, type a description. 5. From All Users, select users to be part of this group. Note: Users that are assigned a User security role cannot be added to a group with Admin or Manager security role. 6. From Security Role, select the security role (see "About security roles" on page 36) to associate with this group. 7. Click Add. To add a group in Active Directory authentication mode 1. Click, and then click Groups. 2. Click. 3. In Search, type a group name to find all matching ones. 4. In Name, select the group name you want. 5. In Description, type a description for the group. 6. From Security Role, select the security role (see "About security roles" on page 36) to associate with this group. 7. Click Add. Edit a group When SmartGlance MRC is configured, it is set up to use either Local or Active Directory authentication mode (see "Configure the authentication mode" on page 28). This mode affects which fields are displayed on the Edit Group page. To edit a group 1. Click, and then click Groups. 2. Select a group that you want to modify. 3. Click. 4. Edit the fields you want to change. Note: When a group's security role (see "About security roles" on page 36) is updated, the related rights for each user within the group are updated the next time the user logs into the SmartGlance MRC website. 5. Click Update. Delete a group To delete a group 1. Click, and then click Groups. 2. Select a group that you want to remove from the list. 3. Click. 42 Version 2016

43 Using SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide View users within a group To view the users in a group 1. Click, and then click Groups. 2. Select a group. 3. Click. View a group's permissions To view a group's permissions 1. Click, and then click Groups. 2. Select the group and and then click. Export a group The View Security Role Permissions page shows the group's security role and related permissions (see "About security roles" on page 36). To export a group (Local authentication mode only) 1. Click, and then click Groups. 2. Select the group that you want to export. (Press CTRL to select multiple groups.) 3. Click. 4. Save and/or open the CSV file. CSV files list the name, , security role, and users in the group. Multiple user names are separated by a pipe " " character. For example: "Day Shift","Shift: 7am-3pm","User","Ann Morris Yuki Tanaka Kelly Doyle" where Name is Day Shift, Description is Shift: 7am-3pm, Security Role is User, and Users are Ann Morris, Yuki Tanaka, and Kelly Doyle. Import multiple groups To import groups (Local authentication mode only) 1. Click, and then click Groups. 2. Click. 3. Click Browse and select a CSV file to import. 4. Click Ignore or Overwrite to specify how to handle any duplicate records. Note: The group will be imported with the User security role, even if it was assigned another security role before import. 5. Click Import. You can see the number of users successfully imported in the message which appears below the Import button. Tips For a sample CSV file of multiple users, click Download Template. Version

44 Using SmartGlance MRC CSV files list the name, , security role, and users for each group. Multiple user names are separated by a pipe " " character. For example: "Day Shift","Shift: 7am-3pm","User","Ann Morris Yuki Tanaka Kelly Doyle" where Name is Day Shift, Description is Shift: 7am-3pm, Security Role is User, and Users are Ann Morris, Yuki Tanaka, and Kelly Doyle. Click Save Logs to save the imported log in a text file format. The Import Log lists whether each group record was successfully imported, a duplicate record, or ignored. For duplicates, you will be able to choose to overwrite or ignore the record. Manage data providers MRC retrieves data for mobile reports from data providers, including SQL Server databases, Wonderware Historian data sources, or any custom data providers that you configured during installation. Note: Please be sure MRC can ping all SQL Server and Wonderware Historian server computers configured in the application as data providers. This allows the MRC service to work properly. To begin managing data providers Click, and then click Data Providers. Note: Connectivity Extension Pack (CEP) extends the reach of MRC to use additional data providers. With CEP, SmartGlance MRC also supports InTouch LGH data files (*.lgh) along with data from any ADO.NET compatible data source for enhanced data access to third-party data sources/systems. Once MRC is installed, you can install CEP on the same computer. Then you can configure additional data providers from the MRC Data Provider page and the CEP management console. To download and install LGH/CEP data connectors, please contact your channel partner or Wonderware product owner. View data providers To view data providers Click, and then click Data Providers. By default, the list shows ten data providers at a time. 44 Version 2016

45 Using SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide To change the records per page From the Records per page list in the upper-right corner, choose how many records to display per page. To sort names in the list (ascending or descending order) In the table header, click Name. Note: The selected page size in the Records per page list is stored in the cookies. So, if you delete the temporary Internet files or cookies, the Records per page list is reset to the default value of 10. Add a data provider To add new data providers 1. Click, and then click Data Providers. 2. Click. 3. Type an alias for the new data provider. 4. From the Type dropdown, select the data provider type (such as SQL Data Source or Wonderware Historian 2012). 5. Complete the fields that display next. o o If you choose a Wonderware Historian type, enter the server name, user name and password for the historian. If you choose a SQL type, enter the server name, database name, authentication, user name, and password. (Specify Windows authentication in domain\username format.) Important: If connection to SQL Server fails using alternate Windows credentials, ensure that the alternate user has "Log on as a service" right for the computer running SmartGlance MRC. If connection to Historian fails using alternate Windows credentials, be sure that the alternate user is part of aaadministrator group in the Historian and has "Log on as a service" right for the computer running SmartGlance MRC. 6. Click Add. To add "Log on as a service" right to a user account 1. Open the Local Security Policy tool. (From the Start menu, type "Local Security Policy" in the text box to find it on your system.) 2. Click Local Policies, and then click User Rights Assignments. 3. In the details pane, double-click Log on as a service. 4. Click Add User or Group, and then type the account name to add it to the list of accounts with this right. 5. Click OK. Version

46 Using SmartGlance MRC Import multiple data providers You can import multiple data providers using a single CSV file. Note: If you try to import custom data providers using the Import option, the system skips the import for that particular data provider. To import multiple data providers 1. Click, and then click Data Providers. 2. Click. 3. Click Browse and select a CSV file. 4. Click Ignore, Overwrite, or Append with _New to specify how to handle any duplicate records. 5. Click Import. You can see the number of data providers successfully imported. Tips For a sample CSV file of multiple users, click Download Template. CSV files list the type, name, server name, database name, SQL integrated security, username, and password. SQL data provider example: "SQL Server", "Telematics SQL Provider", "Telematics", "NorthWind", "True", "telematics\admin", "Password1" Historian data provider example: "Historian 9/10 Server", "Northern Historian 10 Provider", "Historian10Server", "", "", "domain\mrcadmin", "Password1" Note: For Wonderware Historian v 11 or v 11.5 username and password fields are mandatory. For Wonderware Historian v 9, 10 username and password fields are optional. If username and password are not provided, by default, SmartGlance MRC service credentials are used to log into the Wonderware Historian v 9 or v 10 server. If username and password are provided, they are used as alternate Windows credentials to log into the server. Click Save Logs to save the imported log in a text file format. The Import Log displays the log messages for each data provider in the CSV file. Edit data provider To edit a data provider 1. Click, and then click Data Providers. 2. Select a data provider that you want to modify. 3. Select a group that you want to modify. 4. Click. 5. Make the needed changes. 6. Select Change Password check box to edit the Password field. 7. Click Update. 46 Version 2016

47 Using SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide Delete a data provider To delete a data provider 1. Click, and then click Data Providers. 2. Select a data provider that you want to remove from the list. 3. Click. Export data providers The Export option available in the Data Providers tab summary page allows you to export data providers. You can export a single data provider, or the selected data provider depending on your requirement. Note: If you try to export custom data providers, only name and type fields are exported to a CSV file. To export data providers 1. Click, and then click Data Providers. 2. Select a data provider that you want to export. 3. Click. 4. Save and/or open the CSV file. CSV files list the type, name, server name, database name, SQL integrated security, username, and password. SQL data provider example: "SQL Server", "Telematics SQL Provider", "Telematics", "NorthWind", "True", "telematics\admin", "" Historian data provider example: "Wonderware Historian 2012", "Northern Historian 10 Provider", "Historian10Server", "", "", "domain\mrcadmin", "" Note: Passwords are not exported. Manage mobile reports You can use SmartGlance MRC to define the plant data that your mobile workforce views from their mobile devices via SmartGlance. You can define both tag reports and tabular reports. Tag reports are generated from Wonderware Historian tag values. Tabular reports are generated from values fetched from SQL data sources. You can also define which users and groups are subscribed to each report. Version

48 Using SmartGlance MRC To begin managing reports Click, and then click Reports. View a list of reports To view reports Click, and then click Reports. By default, the list shows ten reports at a time. To change the records per page From the Records per page list in the upper-right corner, choose how many records to display per page. To sort names in the list (ascending or descending title order) In the table header, click Title 1 or Title 2. Note: The selected page size in the Records per page list is stored in the cookies. So, if you delete the temporary Internet files or cookies, the Records per page list is reset to the default value of 10. Add a report To add a new report 1. Click, and then click Reports. 48 Version 2016

49 Using SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide 2. Click to see the Add Reports dialog box. 3. In Report Title 1, type a unique title for the report. 4. In Report Title 2, type a secondary title. 5. In Description, describe the report. 6. For Report Refresh, specify how often the report data is sent to the SmartGlance server. Type a number, then choose Frequency Type (Seconds, Minutes,...). 7. For Data Frequency, specify how frequently the report fetches data from the data provider. Type a number (from 30 to ) and choose Frequency Type. Notes: Be careful setting Report Refresh and Data Frequency values. Setting them too high can significantly impact response time. For example, if Report Time is 10 minutes and Data Frequency is 30 seconds, and the report has 30 tags, the service is attempting to fetch 600 tags each time it contacts the data provider. SmartGlance Server stores 120 data points of historical data on the server. Because of this, the Report Refresh and Data Frequency settings also impact the amount of data displayed to mobile devices. For example, sending data every minute results in 2 hours of data at 1-minute resolution (1 minute x 120 data points. Sending data every 30 seconds results in 1 hour of data at 30-second resolution (30 seconds x 120 data points.) 8. Check Enable Start Time and specify a Start Time to send the reports beginning at that start time. If the Start Time is before the current time, reports start sending the next day. By default, Enable Start Time is unchecked and SmartGlance MRC starts sending reports immediately after report update. 9. Check Enable Backfill values on next update if you are using Historian data for a tag report and want historical values to be used to fill in the report. This allows users to see trends from the first report they receive. 10. Under Report Type, select Tag or Tabular. If you select Tabular, these fields are disabled: Data Frequency, Thousand Separator, Decimal Mark, and Date/Time. Version

50 Using SmartGlance MRC 11. Specify characters for Thousands Separator and Decimal Mark. 12. From Date/Time, select the date/time format for sent data. Note: By mobile device means that the time is dictated by the mobile device's local time. This option is available only when SmartGlance MRC is configured with the cloud-hosted server. If you update the SmartGlance MRC configuration to on-premises Server, any reports set with By mobile device option will be reassigned yyyy/mm/dd hh:mm:ss format. 13. From Tag value precision, select the number of decimal places of precision to apply to the all data in the report. (You can also assign this value for specific tags (see "Add tag data to a report" on page 50).) 14. Click Next. Tip: If you want to save time-stamped XML debug output files to an Output subdirectory within the Application Server s installation directory, check Output to XML. Add tag data to a report To customize the tags in a report 1. Add a report (see "Add a report" on page 48) or edit a report (see "Edit a report" on page 55). 2. Click the Tags tab at the top of the dialog box. 3. Click the down arrow and select a data provider from the list of providers added to SmartGlance MRC. A list of tags from this data provider displays. or Type a tag name in Search and then click displays.. A list of tag names matching the search criteria You can also search for tag names by giving a part of the text and the percent sign (%). For example, "bl%" to search for tags beginning with "bl" or "%max%" to search for tags containing "max". 4. Click one or more tags, and then click to move those tags to the Selected Tags list. 5. Refine the Selected Tags list: o Drag tags to rearrange them. 50 Version 2016

51 Using SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide o Click a tag and click to remove it from the list. o o Double-click the Alias field for a tag and type an alias. Double-click the Precision field for a tag and select the number of decimal places of precision to report. If you set a precision value for the entire report and set one for a tag, the tag value is used for that tag. a. Type a description or further information for the report. This information displays when the user taps in SmartGlance. ibutton customization on page Optionally, subscribe users (see "Subscribe users to a report" on page 52) and groups (see "Subscribe groups to a report" on page 52) to the report. 7. Click Add. ibutton customization You can define the drill-down and friendly URL feature of SmartGlance in the ibutton Description field. o o For the drill-down functionality, use this format in ibutton Description:!#Report Title 1 of child/destination report=report Title 2 of child/destination Report##Display url/link to click on#! For the friendly URL property, use this format in ibutton Description:!< URL HERE ## ENTER URL DISPLAY NAME HERE >! Note: ibutton color is not supported in SmartGlance Mobile Reporting Connector Add tabular data to a report To add tabular data to a report 1. From the Provider dropdown, select from the list of available SQL providers. 2. In SQL Statement, enter a query to fetch the data to be viewed in the Report. 3. Click Preview to preview the data being fetched from the database. 4. Optionally, subscribe users (see "Subscribe users to a report" on page 52) and groups (see "Subscribe groups to a report" on page 52) to the report. 5. Click Add. Version

52 Using SmartGlance MRC Running stored procedures You can run SQL stored procedures from SmartGlance MRC while configuring tabular reports. The syntax for running stored procedures is: [Stored Procedure Name] [Parameter1],[Parameter2],.. For example, to run a stored procedure named MRC_WellData with a parameter named Well0031, the syntax is: MRC_WellData 'Well0031' Note: Separate additional parameters by commas. For best results, create a stored procedure, a view, or use SQL Server Linked Servers, when you need to: o o o Maintain a single complex query across reports Require parameterized SQL from WSMRC Combine data from multiple database tables or databases together into a single source You can then run a single Select statement from SmartGlance MRC to perform these tasks. Subscribe users to a report To define which users see a report 1. Add (see "Add a report" on page 48) or edit (see "Edit a report" on page 55) a report. 2. Click the Users tab at the top of the dialog box. 3. Check the name of each user to subscribe, or check Select All. 4. Click the Add or Update button. Subscribe groups to a report To define which groups see a report 1. Add (see "Add a report" on page 48) or edit (see "Edit a report" on page 55) a report. 2. Click the Groups tab at the top of the dialog box. 3. Check the name of each group to subscribe, or check Select All. 4. Click the Add or Update button. Import multiple reports To import multiple reports 1. Click, and then click Reports. 2. Click Browse and select a CSV file to import. 3. Click Import. You can see the number of reports successfully imported. Note: For a sample CSV file of multiple users, click Download Template. 52 Version 2016

53 Using SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide CSV file format for tag reports Type,Title1,Title2,Subtitle,Description,ReportRefresh,ReportFreqType,DataFrequency,DataFreqType,T housandseparator,decimalmark,datetime, StartTime,TagValuesPrecision,OutputXML,TagDetails,Users,Groups For example: Tag,"Mixing Batch Process","Area51","This Tag Report shows data for the Golden Mixing Batch Process." 1, "Minutes",30,"Seconds",10:30 AM, 6, "Comma","Decimal Point","hh:mm:ss","",True,,"", "Sample Data provider;simbot.silolevel;silo Level;>50:""RED""/:""WHITE""; Sample Data provider;simbot.outvalvepressure;outvalue Pressure;; Sample Data provider;simbot.intanklevel;intank Level;; Sample Data provider;simbot.silopressure;silo Pressure;; Sample Data provider;simbot.silotemp;silo Temp;;","admin","Admin Group" is a vaild format. Where: Type is Tag, Title1 is Mixing Batch Process, Title2 is Area51, Description is This report shows the Golden Mixing Batch Process, ReportRefresh is 1,ReportFreqType is Minutes, DataFrequency is 30, DataFreqType is Seconds, StartTime is 10:30 AM, TagValuesPrecision is 6, Thousandseparator is Comma, DecimalMark is Decimal Point, DateTime is hh:mm:ss, OutpulXML is True, Tagdetails is Sample Data provider;simbot.silolevel;silo Level;>50:""RED""/:""WHITE""; Sample Data provider;simbot.outvalvepressure;outvalue Pressure;; Sample Data provider;simbot.intanklevel;intank Level;; Sample Data provider;simbot.silopressure;silo Pressure;; Sample Data provider;simbot.silotemp;silo Temp;;", Users is admin and Groups is Admin Group. Field-specific formatting considerations For Freq Type, Thousand Separator, Decimal Mark report fields, ensure that the value entered in CSV file matches with one of the list values. For example, the DecimalMark field in the CSV can have values only as Decimal Point or Comma, because these are the two values available in the respective list. However, the values entered in the CSV file are case insensitive. For the DateTime field in the CSV, be sure to use this formatting: Date/Time field value yyyy/mm/dd hh:mm:ss mm/dd/yyyy hh:mm:ss dd/mm/yyyy hh:mm:ss yy/mm/dd hh:mm:ss mm/dd/yy hh:mm:ss dd/mm/yy hh:mm:ss hh:mm:ss MMM d, h:m:s PM/AM Device-culture Format in CSV file YYYYMMddHHmmss MMddYYYYHHmmss ddmmyyyyhhmmss YYMMddHHmmss MMddYYHHmmss> ddmmyyhhmmss HHmmss> Mmmdhms YYYY-MM-DD hh:mm:ss[.nnnnnnn] [+ -]hh:mm (UTC format) If the value in the CSV file does not match any of the predefined formats, "yyyy/mm/dd hh:mm:ss" is selected by default for the Date/Time field in the report. While importing reports, if any report parameters contains a comma (","), make sure to put that value within quotation marks (for example, MMM d, h:m:s AM/PM ). Version

54 Using SmartGlance MRC CSV file format for tabular reports Type,Title1,Title2,Subtitle,Description,ReportRefresh,ReportFreqType,StartTime, OutputXML,TabularDataProviderName,SQLQuery,Users,Groups For example: Tabular,Machine Usage Report,HoursperWeek,This report shows the use of each machine by shift,35,seconds,10:30 AM, False,SQLDB,"Select * from Table","","admin","Admin Group" is a valid format. Where: Type is Tabular, Title1 is Machine Usage Report, Title2 is HoursperWeek, Description is This report shows the use of each machine by shift, ReportRefresh is 35,ReportFreqType is Seconds, StartTime is 10:30 AM, OutpulXML is False, TabularDataProviderName is SQLDB, SQLQuery is Select * from Table, Users is admin, and Groups is Admin Group. Note: Importing a CSV file with more than 1000 records could cause the import to fail. To resolve this, go to C:\Program Files\Wonderware\SmartGlanceMobileReportingConnector\ClientBin\MobileReportingConnector and open web.config. Then modify the entry <httpruntime requestvalidationmode="2.0" /> to <httpruntime requestvalidationmode="2.0" executiontimeout="5000" /> to increase the timeout to Export reports To export multiple reports 1. Click, and then click Reports. 2. Select the report that you want to export. 3. Click. 4. Save and/or open the CSV file. CSV file format for exported reports Type,Title1,Title2,Description,ReportRefresh,ReportFreqType,DataFrequency,DataFreqType,Thousan dseparator,decimalmark,datetime,tagvaluesprecision,starttime,outputxml,tabulardataproviderna me,sqlquery,tagdetails,users,groups Example of an exported tabular report Tabular, Machine Usage Report, HoursperWeek,This report shows the shiftwise usage of machine, 2, Minutes, 0, Seconds, None, Decimal Point, yyyy/mm/dd hh:mm:ss,, FALSE, MachinaryUsageRepository, "select * from Shifts",, john is a valid format. where: Type is Tabular, Title1 is Machine Usage Report, Title2 is HoursperWeek, Description is This report shows the shiftwise usage of machine, ReportRefresh is 2,ReportFreqType is Minutes, DataFrequency is 0, DataFreqType is Seconds, Thousandseparator is None, DecimalMark is Decimal Point, DateTime is yyyy/mm/dd hh:mm:ss,starttime is blank,outputxml is FALSE,TabularDataProviderName is MachinaryUsageRepository, SQLQuery is "select * from Shifts",Tag Details is blank,users is john, and Groups is blank. 54 Version 2016

55 Using SmartGlance MRC Wonderware SmartGlance Mobile Reporting Connector Guide Example of an exported tag report Tag,"Mixing Batch Process","Area51","This Tag Report shows data for the Golden Mixing Batch Process.,30,"Minutes",30,"Seconds","Comma","Decimal Point","hh:mm:ss","12:00 AM", 6, FALSE,,"","Sample Data provider;simbot.silolevel;silo Level;>50:"RED"/:"WHITE"; or call Sample Data provider;simbot.outtemp;out Temp;==30; or call ","","" is a valid format. Where: Type is Tag, Title1 is Mixing Batch Process, Title2 is Area51, Description is This Tag Report shows data for the Golden Mixing Batch Process., ReportRefresh is 30,ReportFreqType is Minutes, DataFrequency is 30, DataFreqType is Seconds, Thousandseparator is Comma, DecimalMark is Decimal Point, DateTime is hh:mm:ss, StartTime is 12:00 AM, Tag value precision is 6, OutputXML is FALSE,TabularDataProviderName is blank,sql Query is blank,tag Details is Sample Data provider;simbot.silolevel;silo Level;>50:"RED"/:"WHITE"; mrexample@sample.com or call Sample Data provider;simbot.outtemp;out Temp;==30; mrexample@sample.com or call ,Users is blank, and Groups is blank. About exported CSV files Edit a report Individual tag details will be displayed in the following format. DataProviderName;TagName;Alias;IButtonDescription Semicolons (";") are reserved characters and cannot be used for User Name, Group Name, and the tag details such as DataProviderName,TagName, and Alias. To edit a report 1. Click, and then click Reports. 2. Select a report that you want to modify. 3. Click. 4. Make modifications as needed. 5. Click Update. The reports updated in SmartGlance MRC are also updated on the SmartGlance server, if the valid SmartGlance server details were provided in the the SmartGlance MRC Configurator Utility (SmartGlance server tab). For more information, see Configure SmartGlance server on page 32. Copy a report To create a new copy of a report 1. Click, and then click Reports. 2. Select a report that you want to copy. 3. Click. 4. In the Report Title 1 and Report Title 2 boxes, type the details for the new report. 5. Click Copy. Version

56 Using SmartGlance MRC Import multiple tags into a report To import multiple tags into a report 1. Click, and then click Reports. 2. Select the tag report that you want to work with. 3. Click to import tags. 4. In the Data Providers list, select the Historian data provider for the tags you are importing 5. Click Browse and select a CSV file. Important: Be sure to use the latest template for importing. If you use a template version earlier than SmartGlance MRC 2016, you might encounter errors.click Download Template for a sample CSV file for tag data. 6. Click Import. CSV file format for imported tag data The following is the details of a CSV file format. CSV file format for importing multiple tags: TagName,Alias,Precision,iButtonDescription SysConfigStatus,Config Status1,2,!#Title1=Title2##Jump Report#! For example: SysConfigStatus,Config Status1,2, System Configuration Status is a valid format. Where: SysConfigStatus is the TagName, Config Status1 is the Alias, 2 is Precision, System Configuration Status is the ibuttondescription. Delete a report To delete a report 1. Click, and then click Reports. 2. Select a report that you want to remove from the list. 3. Click. Reports deleted from SmartGlance MRC are also deleted from the SmartGlance server, if the valid SmartGlance server details were provided in the the SmartGlance MRC Configurator tool (SmartGlance Server tab). For more information, see Configure SmartGlance server on page Version 2016

57 CHAPTER 4 Troubleshooting Check topics in this section for solutions to issues you may have with SmartGlance MRC installation or configuration. Click an issue for details about how to resolve it: Issue: "1603 Fatal error during installation" displays on page 58 Issue: Can't access SmartGlance MRC website on page 59 Issue: Reports not sent to SmartGlance API on page 59 Issue: Reports aren't published on the mobile device on page 60 Issue: "Method not found: Boolean ISNet.WebUI.ISNetControl.get_IsMvc() " displays at login on page 61 Issue: "No connection could be made because the target machine actively refused it" displays at login on page 61 Issue: SmartGlance MRC website interface isn't working correctly on page 62 Issue: SmartGlance MRC doesn't respond (Windows Server 2008 R2 or 2012 R2) on page 62 Issue: Need to verify that DCOM port 135 is open on Historian Server on page 62 Issue: Need to set <customerrors> element in the configuration file on page 63 Issue: SmartGlance MRC website has strange formatting in Internet Explorer on page 64 Issue: Need to change compatibility view settings in Internet Explorer on page 64 Issue: Need to view SmartGlance MRC log messages on page 64 Issue: Need debug tools and logs on page 65 Issue: Need to enable SMC log files on page 67 Version

58 Troubleshooting Issue: Need to change the default port number for DataReportConfig and ProviderManager web services on page 69 Issue: Need to find the LocalDB MS Log file on page 70 Issue: Need to connect to a LocalDB instance on page 71 Issue: Need to export SmartGlance MRC LocalDB to SQL Server 2012 on page 72 Issue: "1603 Fatal error during installation" displays Possible cause Solution Corrupt Windows installer. Be sure that the Windows operating system where you want to install SmartGlance MRC is not corrupted. To fix this issue, you should unregister Windows and then re-register it. To unregister Windows 1. Click the Windows Start button. 2. In the text box, type: msiexec /unregister Windows will be unregistered. To register Windows 1. Click the Windows Start button. 2. In the text box, type: msiexec /regserver Windows will be registered. 58 Version 2016

59 Troubleshooting Wonderware SmartGlance Mobile Reporting Connector Guide Issue: Can't access SmartGlance MRC website Possible Cause Some of the possible reasons can be: Solution Connectivity issues with IIS Issues with Wonderware SmartGlance Mobile Reporting Connector service To rule out connectivity issues with IIS Verify that any other websites hosted by IIS are working. If Windows SharePoint Services are installed, fix any port number conflicts. Read more here (see "SmartGlance MRC and Microsoft SharePoint 2010 " on page 129). Analyze the error messages. If the error messages are generic, do the following: a. Open Internet Options. b. Click the Advanced tab. c. Unmark the Show friendly HTTP error messages check box. To rule out issues with the Wonderware SmartGlance Mobile Reporting Connector service Make sure that the Wonderware SmartGlance Mobile Reporting Connector service is started. Make sure that the DataReportConfigWS service is accessible through this URL: Issue: Reports not sent to SmartGlance API Solution Check the Wonderware System Management Console (SMC) log file for errors. Mark the Output to XML check box for the report that is not being sent to the SmartGlance API. The SmartGlance Mobile Reporting Connector service saves time stamped XML debug output files to an Output subdirectory within the Application Server s installation directory. The output is typically generated in the program files installation directory - <drive>:\program Files\Wonderware\SmartGlanceMobileReportingConnector. Version

60 Troubleshooting Determine whether your network requires the use of a Proxy Server If yes, configure the Proxy Server setting (see "Configure proxy server settings" on page 29) in the SmartGlance MRC Configuration tool. For tag data reports, verify that the Wonderware Historian Server is running. Wait a while after starting the Wonderware Historian Server to ensure that all the Historian components have started and are now running. Make sure that Firewall Application and Port exceptions are configured properly. Port Range to o o Used by WWMobileReportingConnectorService.exe Used by iexplore.exe to load the Connector Web page from Internet Explorer Note: SmartGlance MRC relies on Windows to provide an available port within the default dynamic port range for TCP/IP. The default range in Windows 2008 is between to This range can be restricted for security reasons. Get started here: Port 443 o Used for SSL Communication to the SmartGlance Hosted Server Note: Download and use CurrPort from Nirsoft to diagnose the issue. Learn more here: Issue: Reports aren't published on the mobile device Solution Make sure the report is enabled (checked) in the SmartGlance mobile application. Tap Refresh in the SmartGlance mobile application to be sure you have the latest results. Ensure that the report you are requesting actually has data to be displayed. If no data is available, the report may not appear. Mark the Output to XML check box for the report which is not being sent to the SmartGlance API. The Mobile Reporting Connector service will save a timestamped XML debug output files to an Output subdirectory within the Application Server s installation directory. The output is typically generated in the program files installation directory - <drive>:\program Files\Wonderware\SmartGlanceMobileReportingConnector For a tabular data report, run the SQL Query directly in SQL Server Management Studio to ensure that the expected results appear directly in SQL Server. For a tag data report, run a query directly against the Historian to verify that data is available and is being received in good quality (OPC Value of 192). Ensure that the registered user's address is designated to receive this report either explicitly as a single user or as part of a group distribution list. If the SmartGlance server is overloaded with information, it may cause a buffer overflow or timeout, and prevent the receipt of information by the SmartGlance server. Try reducing the Report Refresh and Data Frequency set for the report (see "Add a report" on page 48). Or, configure the MaxDataPoints value (see "Configure maximum data points" on page 132) so that smaller chunks of information are sent to the SmartGlance API. 60 Version 2016

61 Troubleshooting Wonderware SmartGlance Mobile Reporting Connector Guide Issue: "Method not found: Boolean ISNet.WebUI.ISNetControl.get_IsMvc() " displays at login Possible cause Solution Because the SmartGlance MRC website relies on a third-party.net control, the.net framework may be referencing the wrong version of the DLL or assembly. Verify the list of DLLs and their file version numbers provided in the following table against the same DLLs in the SmartGlance MRC website directory. The default SmartGlance MRC website directory where these DLLs are stored is C:\Program Files\Wonderware\SmartGlanceMobileReportingConnector\ClientBin\MobileReportingConnector\bi n. Assembly Name Assembly Version ISNet.dll ISNet.ActiveReports.Exporting.dll ISNet.WebUI.dll ISNet.WebUI.WebGrid.dll If the files are present and the file versions are correct, check the Microsoft Global Assembly Cache (GAC) to ensure that another program has not registered DLLs with the same names. The.NET Framework by default will use these DLLs before looking at the default application directory. To check for DLLs with the same name in the GAC, open Windows Explorer and navigate to C:\Windows\assembly. Go through the list and look for the DLLs specified in the table. Verify that the version numbers are the same. If they are not then there is a conflict between the originating software that registered these DLLs and WMRC. For example, it is a known issue that the Skelta BPM.NET Workflow product uses an older version of these DLLs and registers them in the GAC. If this is the case, install WSMRC on a different computer. Issue: "No connection could be made because the target machine actively refused it" displays at login Possible Cause Solution The Wonderware SmartGlance Mobile Reporting Connector service did not have read/write permissions on the SmartGlance Mobile Reporting Connector installation directory. Ensure that the Wonderware SmartGlance Mobile Reporting Connector service has read/write permissions to the SmartGlance Mobile Reporting Connector installation directory and all its subfolders. The default path for 32-bit system is <Drive>\Program Files\Wonderware\SmartGlanceMobileReportingConnector. Version

62 Troubleshooting Issue: SmartGlance MRC doesn't respond (Windows Server 2008 R2 or 2012 R2) Solution For Windows Server 2008 R2 1. Open the Server Manager. 2. Under Security Information, click Configure IE ESC. The Internet Explorer Enhanced Security Configuration page appears. 3. Click Off. For Windows Server 2012 R2 1. Open the Server Manager. 2. Click Local Server. The Local Server Property page appears. 3. Click IE Enhanced Security Configuration. The Internet Explorer Enhanced Security Configuration page appears. 4. Click Off. Issue: Need to verify that DCOM port 135 is open on Historian Server Solution 1. Click the Windows Start button. 2. In the text box, type: telnet <HistorianServer> 135 If the port is open, a blank command prompt appears. Otherwise, an error message displays. To show the number of records returned by a SQL Query Knowing the number of records returned by a SQL query can help you to test query performance and also diagnose any data constraints from WSMRC or the SmartGlance application. Follow these steps: 62 Version 2016

63 Troubleshooting Wonderware SmartGlance Mobile Reporting Connector Guide 1. Create a simple SQL query for your data source. Try to keep the number of records small. For example, 10 records. 2. Verify that the report was created and successfully pushed to the SmartGlance mobile application. 3. Use the following example to customize the query created in step 1 so you can find the number of rows returned: -- Query to enumerate the number of rows returned by a SQL query for troubleshooting purposes SELECT * FROM (SELECT TOP 1001 ROW_NUMBER() OVER (ORDER BY UDA) AS RowID, -- << a column name is needed for the OVER portion of the function. Replace UDA here with your own column; You can also change 1001 to whatever row count is required. * FROM dbo.signalsnarrow -- this example used the Well Field Database. Change the table name here to your own accordingly ) AS Nested_Selected ORDER BY RowID Desc 4. Increase the number of records returned in the query to test higher row counts across multiple test iterations. For each test iteration, check the Wonderware System Management Console (SMC) Logger and confirm that WSMRC is sending the query. 5. Increase the number of records consistently to gauge a linear progression or decline of performance (such as loading times or timeouts). Issue: Need to set <customerrors> element in the configuration file Solution The <customerrors> element provides information about custom error messages for an ASP.NET application. You can set the <customerrors> element in the configuration file based on the following specifications: Required Attribute Attribute Option Description Mode On Off RemoteOnly Specifies whether custom errors are enabled, disabled, or shown only to remote clients. Specifies that custom errors are enabled. If no defaultredirect is specified, you can see a generic error. Specifies that custom errors are disabled. This allows display of detailed errors. Specifies that custom errors are shown only to remote clients and ASP.NET errors are shown to the local host. This is the default. Version

64 Troubleshooting Issue: SmartGlance MRC website has strange formatting in Internet Explorer Solution Make sure that you are using only the System requirements on page 11. Make sure the Compatibility Settings are turned off (see "Issue: Need to change compatibility view settings in Internet Explorer" on page 64). Issue: Need to change compatibility view settings in Internet Explorer Solution 1. Open Internet Explorer. 2. Press the ALT key to display the Menu bar (or right click the Address bar and then select Menu bar). 3. Click Tools, and then click Compatibility View Settings. The Compatibility View Settings window appears. 4. Unmark these two check boxes: o o Include updated website lists from Microsoft Display intranet sites 5. Click Close. Issue: Need to view SmartGlance MRC log messages Solution To view SmartGlance MRC log messages, you can use a filter to separate them from other Wonderware System Management Console (SMC) log messages. Follow these steps: 1. Copy the following code into a text editor and save it with an *.aaflt extension. gfilter> ssage> lter Type="1" Enabled="1" ReadOnly="1"> gflag>error</logflag> gflag>warning</logflag> ilter> lter Type="1" Enabled="1" ReadOnly="0"> mponent>mobilereportingconnector.wwhistorianprovider</component> mponent>mobilereportingconnector.datagrazerserver</component> ilter> lter Type="1" Enabled="1" ReadOnly="0"> mponent>log Viewer</Component> ilter> lter Type="1" Enabled="1" ReadOnly="0"> gtext>mobilereportingconnectorservice</msgtext> ilter> essage> ogfilter> 64 Version 2016

65 Troubleshooting Wonderware SmartGlance Mobile Reporting Connector Guide Important: Be sure to use a text or XML editor (such as Notepad++) with XML set as the language style when you save the filter template. Ensure that the code is written as a single line string with no hard-line carriage returns. 2. Click the filter icon. The Filter dialog box appears. 3. Right-click the Filter dialog box. The shortcut menu appears. 4. On the shortcut menu, select and then click the Load Filter option. The Load Filter From dialog box appears. 5. Browse the file that you have saved in Step 1 and then click Open. The filter gets loaded with the filter criteria specified in the browsed file. 6. Click OK. The SMC log is filtered to display the SmartGlance MRC log messages only. Issue: Need debug tools and logs Solution When troubleshooting SmartGlance MRC, the debug tools and logs listed below can come in handy. Wonderware System Management Console View the Wonderware System Management Console (SMC) to check all the errors, warnings, and informational messages generated by SmartGlance MRC. Third-Party Tools Note: Wonderware does not endorse use of the third-party tools listed and does not provide any kind of support for them. You may use other tools, if required. Windows Event Viewer Application log and System logs View the Windows Event Viewer Application log and System logs to check the issues logged by the operating system. IIS Trace Logs View IIS Trace Logs to identify issues while connecting to the SmartGlance MRC website. Windows Communication Foundation log View the Windows Communication Foundation (WCF) log to monitor traffic between SmartGlance MRC and the SmartGlance server. SmartGlance MRC uses WCF to POST messages via HTTP to the SmartGlance API. For more details about WCF log, see Do the following: a. In a text editor (such as, Notepad++), open the MobileReportingConnectorService.exe.config file from the default path: C:\Program Files\Wonderware\SmartGlanceMobileReportingConnector\Server b. Add the following block of code: <system.diagnostics> <sources> <source name="system.servicemodel" switchvalue="critical, Error, Warning" propagateactivity="true"> Version

66 Troubleshooting <listeners> <add name="tracelistener" type="system.diagnostics.xmlwritertracelisten er" initializedata= "c:\log\traces.svclog" /> </listeners> </source> </sources> </system.diagnostics> Fiddler2 from Telerik You can use an HTTP sniffer to inspect the HTTP(s) traffic between SmartGlance MRC and the SmartGlance server. The product Fiddler2 is one example of an HTTP sniffer. Fiddler allows you to inspect traffic, set breakpoints, and monitor incoming or outgoing data. Fiddler includes a powerful event-based scripting subsystem, and can be extended using any.net language. You can download Fiddler from: ( Also, as WMRC uses HTTPS to encrypt messages, you can view these messages decrypted in Fiddler. For more information, see TeamViewer QuickSupport You can use TeamViewer QuickSupport to remotely troubleshoot SmartGlance mobile application on Android phones. For more information, see: n ( en) CurrPorts from Nirsoft CurrPorts is network monitoring software which is used to verify all local ports and their status. You can download it from: ( Notepad++ Notepad++ is an open-source code editor that supports many languages. It can used to view and edit XML, Web.config, and SQL file types and syntax. You can download it from: ( Android SDK from Google This provides an Android Emulator to simulate an Android phone on your desktop computer. It is particularly useful to do presentations to a large audience or troubleshooting inside a secured environment. You can download it from: ( WireShark from the WireShark Foundation This is an open-source network protocol analyzer that helps you to identify communication problems across the network between servers. You can download it from: ( AirDroid This is used for remote Android screen-sharing and management. You can download it from: ( Belarc Advisor 66 Version 2016

67 Troubleshooting Wonderware SmartGlance Mobile Reporting Connector Guide This tool builds a detailed profile of your installed software and hardware, network inventory, missing Microsoft hotfixes, anti-virus status, security benchmarks, and displays the results in your Web browser. However, all of your PC profile information is kept private on your PC and is not sent to any web server. You can download it from: ( Process Notifier This is used to send notifications when a process or service on your computer starts or stops. You can use this tool to get alerts when the Wonderware Mobile Reporting Connector service starts or stops. You can read more about it and download it from: our-pc-start-stop/#more ( Service Tray This is used to monitor and control any Windows service from a tray icon. This tool can be used to display alerts when the Wonderware Mobile Reporting Connector service starts or stops. You can download it from: ( Anfish Android Application This is an Android application that provides detailed device information such as the type of ROM, manufacturer, CPU, storage, screen size, camera, sensors, and other features. You can download it from: ( Core Monitor HD This is an ipad diagnostic tool to collect memory and process information. You can download it from: ( Puffin Browser for ipad SmartGlance MRC is not supported on ipad. However, the Puffin browser does allow some functionality on the ipad. You can download it from: ( Issue: Need to enable SMC log files Solution For deep analysis of explicit communication between SmartGlance MRC and Wonderware Historian, you can use Wonderware System Management Console (SMC) log files. To expose this level of verbose debug information, you can enable Log Flags from SMC for the SmartGlance MRC application. To enable SMC log files 1. Open the Wonderware System Management Console (SMC). (If you don't have a shortcut on your desktop, go here: Start -> All Programs -> Wonderware -> System Management Console or Start -> All Programs -> ArchestrA -> System Management Console.) 2. Use the tree view on the left side to navigate to the SmartGlance MRC log files. 3. Right-click the SmartGlance MRC Client Machine (Local). The shortcut menu appears. Version

68 Troubleshooting Alternatively, you can also remotely connect to the SmartGlance MRC computer from another SMC Logger console for convenience. 4. Select Log Flags. The Log Flag Editor window appears. 5. In the Global Log Flags section, do the following: a. Select the Trace log flag and highlight the following components in the Components Using Trace section. aahmdas MobileReportingConnector.DataGrazerServer MobileReportingConnector.SGReportSend MobileReportingConnector.WWHistorianProvider b. Select the Start-Stop log flag and highlight the following components in the Components Using Start-Stop section. aahmdas MobileReportingConnector.DataGrazerServer MobileReportingConnector.SGReportSender MobileReportingConnector.WWHistorianProvider c. Select the Entry-Exit log flag and highlight the following components in the Components Using Entry-Exit corner. aahmdas MobileReportingConnector.DataGrazerServer MobileReportingConnector.SGReportSender MobileReportingConnector.WWHistorianProvider 6. From the File menu, click Apply. 7. Close the Log Flag Editor window. Important: This will cause a large amount data to be captured in the logger. It's best to turn on these log flags only for short periods of time during a diagnostic analysis. After the verbose logs have been collected, please follow the steps in reverse order to remove the log flags. Once the Log Flags are enabled, you can also simulate the parameters of the SmartGlance MRC API call to the Historian by representing the API call with a similar representative SQL Query. Use the following query to help understand the nuances and parameters of SmartGlance MRC queries the Historian. Note, however, that SmartGlance MRC does not actually execute a SQL query against the Historian, but rather uses the Historian SDK to perform API calls using DCOM. This query can be executed from SQL Server Management Studio against the Historian Runtime database. 68 Version 2016

69 Troubleshooting Wonderware SmartGlance Mobile Reporting Connector Guide -- Example SmartGlance MRC Historian Query for Historical (not Live) data values -- This query attempts to replicate the equivalent SQL Query that the SmartGlance MRC is requesting from the Historian but in reality is using the Historian SDK. USE Runtime AS DATETIME AS DATETIME AS INTEGER -- Report Refresh from the SmartGlance MRC here as to be broken down into a Start Time and an End Time where the difference between them in time is the Report Refresh value = ' :24:25' -- << to be set >> in the format YYYY-MM-DD HH:MM:SS = ' :24:55' -- << to be set >> in the format YYYY-MM-DD HH:MM:SS ; This value should be the 'larger or greater' of the two time values. = '10' -- << Data Frequency field from the SmartGlance MRC expressed in seconds -- Start Query SELECT * FROM History WHERE TagName = 'SimBot_001.SimBot_07' -- << Change tagname to your own --AND wwinterpolationtype = System Default i.e., Check SMC > System Configuration > Parameters > InterpolationTypeInteger and InterpolationTypeReal AND wwqualityrule = 'Extended' AND wwresolution * This is equivalent to the Data Frequency field in the SmartGlance MRC in Milliseconds AND wwretrievalmode = 'Average' -- Refer to the documentation 'Wonderware Historian Concepts Guide' for details AND wwtimestamprule = 'End' -- Refer to the documentation 'Wonderware Historian Concepts Guide' for details --AND Datetime > GETDATE() This is just for troubleshooting purposes and days is approximately 30 mins. AND DateTime -- This is derived from the Report Refresh field in the SmartGlance MRC aka Start Date AND DateTime -- This is determined by the Report Refresh field in the SmartGlance MRC aka End Date --ORDER BY DateTime Desc -- Optional and not actually applied by the SmartGlance MRC -- The query results will always return one additional record than what appears on the SmartGlance mobile app. Once the Log Flags are enabled and an example data set can be seen in SQL Server Management Studio, you can compare the trace logs with the results of the SQL Query. Issue: Need to change the default port number for DataReportConfig and ProviderManager web services Solution By default, SmartGlance MRC uses port 8000 for DataReportConfig and DBProvider web services. You can change the port number manually to avoid having a conflict with other applications, such as Wonderware Intelligence and Skelta BPM.NET. Version

70 Troubleshooting To change the default port number for DataReportConfig and ProviderManager web services 1. Close all the open instances of Internet Explorer or any other browser. 2. Stop the Mobile Reporting Connector Service. 3. Using Windows Explorer, browse to the SmartGlance MRC installation path: <Drive>\Wonderware\SmartGlanceMobileReportingConnector. The default path for 32-bit system is <Drive>\Program Files\Wonderware\SmartGlanceMobileReportingConnector and for 64-bit system is <Drive>\Program Files(x86)\Wonderware\SmartGlanceMobileReportingConnector. 4. Locate the MobileReportingConnectorService.exe.config file and create a backup. 5. Use a text editor (such as Notepad++) to open MobileReportingConnectorService.exe.config. 6. Search for "8000" and replace it with another port number, say This makes 8999 the new custom port. You can set any value from to Save and close the file. 8. In Windows Explorer, browse to this path: <Drive>\Wonderware\SmartGlanceMobileReportingConnector\ClientBin\MobileReportingConnecto r. For 32-bit system the path is <Drive>\Program Files\Wonderware\SmartGlanceMobileReportingConnector\ClientBin\MobileReportingConnector and for 64-bit system the path is <Drive>\Program Files(x86)\Wonderware\SmartGlanceMobileReportingConnector\ClientBin\MobileReportingConnec tor. 9. Locate the web.config file and create a backup. 10. Use a text editor to open web.config. 11. Search for "8000" and replace it with another port number, say This makes 8999 the new custom port. You can set any value from to Note: Be sure that you use the same port number as used in the MobileReportingConnectorService.exe.config file. 12. Save and close the file. 13. Run this command from console as Administrator : http add urlacl url= user= NT AUTHORITY\NETWORK SERVICE http add urlacl url= user= NT AUTHORITY\NETWORK SERVICE 14. Start the Mobile Reporting Connector service. Now you can browse SmartGlance MRC website using Internet Explorer. Issue: Need to find the LocalDB MS Log file Solution The LocalDB Instance is owned by Network service unless you have modified the owner by modifying the SmartGlance MRC service login account. You can access the SmartGlance MRC LocalDB instance's error file in: 70 Version 2016

71 Troubleshooting Wonderware SmartGlance Mobile Reporting Connector Guide C:\Windows\ServiceProfiles\NetworkService\AppData\Local\Microsoft\Microsoft SQL Server Local DB\Instances\MRCLocalDBInstance Issue: Need to connect to a LocalDB instance Solution Microsoft SQL Server 2014 Express LocalDB gets installed with SmartGlance MRC Microsoft SQL Server 2014 Express LocalDB is an execution mode of SQL Server Express. LocalDB installation copies a minimal set of files necessary to start the SQL Server Database Engine. Before you connect to a LocalDB instance, download PSTools from: This tool allows you to perform administration of local and remote systems. Note: LocalDBinstance is owned by Network service only. You can connect to a LocalDB instance with PSTools through either the command prompt or SQL Server Management Studio. To connect to a LocalDB instance with PSTools through the command prompt 1. Open the command prompt as an administrator. 2. Browse to the PSTools folder in your computer and run "psexec -i -u "NT AUTHORITY\NETWORK SERVICE" cmd.exe". 3. Type sqllocaldb info MRCLocalDBInstance. The LocalDB instance details are displayed along with the Version. Note: The command sqllocaldb is a free command line utility that is installed with SmartGlance MRC to check if the database has been created and is RUNNING. 4. If the status is "Stopped", start the instance by running the command sqllocaldb start MRCLocalDBInstance. 5. Connect to the MRCLocalDB instance by running the command Sqlcmd -S (localdb)\mrclocaldbinstance. Important: To run this command successfully, you need SQL Server Command Line Utility. You can download it from, SQL Server Command Line Utility. This component requires both Windows Installer 4.5 and Microsoft ODBC Driver 11 for SQL Server. You can download the ODBC Driver from, ODBC Driver. 6. To connect to the SmartGlance MRC database, type "use MRCLocalDB" and then type "go". To connect to a LocalDB instance with PSTools through SQL Server Management Studio (SSMS) You need SQL Server 2012 and PSTools to connect to LocalDB using SQL Server Management Studio (SSMS) The name of the LocalDB instance is: (localdb)\mrclocaldbinstance Note: You must open the SSMS with the Network Service account using the PSTools. 1. Open the command prompt as an administrator. 2. Browse to the PSTools folder in your computer and run "psexec -i -u "NT AUTHORITY\NETWORK SERVICE" Ssms.exe ". The SSMS dialog box appears. Version

72 Troubleshooting 3. In the SSMS, use Windows Authentication to connect to the LocalDB instance. 4. Select the Server Name as "(localdb)\mrclocaldbinstance" and then click Connect. You can now see the MRCLocalDB. Issue: Need to export SmartGlance MRC LocalDB to SQL Server 2012 Solution You can export the SmartGlance MRC LocalDB instance to another database using SQL Server 2012 Management Studio This exported database can serve as a backup and can be used to recover the information later, if required. Note: The export and import of SmartGlance MRC LocalDB is supported only with SQL Server It is not supported on earlier versions of SQL Server. To export SmartGlance MRC LocalDB to SQL Server Access SQL Server Management Studio 2012 with the Network Service account using the PSTools (see "Issue: Need to connect to a LocalDB instance" on page 71). 2. Right-click the MRCLocalDB database, point to Tasks, and then click Export Data. The SQL Server Export Import Wizard appears. 3. Click Next. The Choose a Data Source dialog box appears. 4. In the Data source list, select SQL Server Native Client In the Server Name list, select (localdb)\mrclocaldbinstance. 6. In the Authentication group, select Use Windows Authentication. 7. In the Database list, select MRCLocalDB. 8. Click Next. The Choose a Destination dialog box appears. 9. In the Destination list, select SQL Server Native Client In the Server Name list, select the server name. 11. In the Authentication group, select Use Windows Authentication. 12. In the Database list, select the database to which the MRCLocalDB has to be exported, say MRCDB. 13. Click Next. The Specify Table Copy or Query dialog box appears. 14. Select Copy data from one or more tables or views. 15. Click Next. The Select Source Tables and Views dialog box appears. 16. Select the tables and click Next. The Run Package dialog box appears. 17. Select the Run immediately box. 18. Click Next. The Complete the wizard dialog box appears. 19. Click Finish. The execution was successful dialog box appears. 20. Click Close. 72 Version 2016

73 Appendix In This Appendix Remove log components for an earlier version of SmartGlance MRC Security matrix Sample queries for tabular reports SmartGlance MRC and Microsoft SharePoint Verify the service endpoint Backup and restore SmartGlance MRC configuration data Configure maximum data points Remove log components for an earlier version of SmartGlance MRC When you uninstall an earlier version of SmartGlance MRC, or upgrade from an earlier version to SmartGlance MRC 2016, the following logger components are not deleted from the Archestra System Management Console (SMC) automatically. WWMobileReportingConnector.DataGrazerServer WWMobileReportingConnector.Logger WWMobileReportingConnector.WWHistorianProvider WWMobileReportingConnectorService You must delete these logger components from the SMC manually after installing the latest version of SmartGlance MRC or upgrading from an earlier version to SmartGlance MRC Make sure that only the following latest logger components are available in the SMC after installing or upgrading to SmartGlance MRC MobileReportingConnector.DataGrazerServer MobileReportingConnector.Logger MobileReportingConnector.HistorianProvider MobileReportingConnectorService To delete the Logger components of an earlier version from SMC 1. Run the Wonderware System Management Console (SMC) from Start -> All Programs -> Wonderware -> System Management Console or Start -> All Programs -> ArchestrA -> System Management Console. 2. Using the tree view on the left side, navigate to the log files of the SmartGlance MRC. Version

74 Appendix 3. Right-click the SmartGlance MRC Client Machine (Local). The shortcut menu appears. Alternatively, you can also remotely connect to the SmartGlance MRC computer from another SMC Logger console for convenience. 4. Select Log Flags. The Log Flag Editor window appears. 5. In the left pane, identify and navigate to the following logger components that are not deleted from the SMC. o o o o WWMobileReportingConnector.DataGrazerServer WWMobileReportingConnector.Logger WWMobileReportingConnector.WWHistorianProvider WWMobileReportingConnectorService 6. Select each of the logger components individually and then click Remove components to remove the logger components from the SMC. A confirmation message appears. 7. Click Yes. 8. Click File -> Apply. 9. Close the Log Flag Editor window. Security matrix Source Application This security matrix provides complete information about the communication between different applications after the installation of Wonderware SmartGlance Mobile Reporting Connector. This information is useful for IT administrators to monitor network traffic, configure the necessary firewall security settings, and ensure proper communication between various applications. For a more detailed spreadsheet of this information, click here. Source Endpoint(s) Target Application Target Endpoint Remarks SmartGlance MRC SmartGlance MRC SmartGlance MRC SmartGlance MRC Wonderware Historian Microsoft SQL Server SmartGlance Server API SmartGlance Server API 135 The SmartGlance MRC application uses RPC to reach the Wonderware Historian API on a remote server. This is how SmartGlance MRC retrieves the data set for a "Tag" Report from the Historian The SmartGlance MRC application uses the default Microsoft O/S Dynamic Port Range for outbound queries against SQL Server data sources. SQL Server listens on 1433 for inbound requests to SQL Server. 80 The SmartGlance MRC application uses the default Microsoft O/S Dynamic Port Range for outbound queries to the SmartGlance Server. The SmartGlance Server - when installed On-Premise - typically defaults to port 80. This port is configurable and can be modified. In this case the SmartGlance WebAdmin Server Page defaults to The SmartGlance MRC application uses the default Microsoft O/S Dynamic Port Range for outbound queries to the SmartGlance Server. The SmartGlance Server - when hosted in the Cloud - is configured to use port 443 to support SSL 256-bit encryption. In this case the SmartGlance WebAdmin Server Page is restricted to 74 Version 2016

75 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide SmartGlance Server SmartGlance Server Mobile Device (Phone or Tablet) Mobile Device (Phone or Tablet) APNS 2195 For Apple mobile devices and push notifications only, the SmartGlance server communicates with these devices via the Apple Push Notification Service (APNS). APNS Feedback Service 5223 SmartGlance App 5223 SmartGlance App 2196 For Apple mobile devices and push notifications only, the SmartGlance server communicates with these devices via the Apple Push Notification Service (APNS) Feedback Service. For Apple mobile devices and push notifications only, the SmartGlance server communicates with these devices via the Apple Push Notification Service (APNS). For Apple mobile devices and push notifications only, the SmartGlance server communicates with these devices via the Apple Push Notification Service (APNS) Feedback Service. Sample queries for tabular reports SmartGlance MRC performs secure database queries against one or more data sets to aggregate the reporting content. SmartGlance MRC provides built-in support for retrieving data from the Historian provider using the Wonderware Historian provider. It also provides a generic SQL data source provider to allow users define their own custom queries for any SQL-based databases. This section provides sample SQL queries for tabular reports designed to be executed on various Schneider Electric products such as Corporate Energy Management (CEM) and Manufacturing Execution System (MES). The sample queries given in this section are based on the following assumptions: You are familiar with the functionality and features of SmartGlance MRC. The sample queries, although functional, should be used only for understanding and getting started on writing queries for tabular reports. The queries can be modified, extended, and optimized as per the specific implementation needs. Some queries have built-in references to specific date and time ranges which can be customized if required. SQL data providers based on each application's specific database have to be created. Getting started This section helps you get started on writing queries for tabular reports by taking a simple "Hello World" query as an example. Begin with the following: 1. Create a SQL Data Provider based on the default MASTER database of SQL. 2. Create a tabular report based on this SQL provider using the query given below: SELECT 'Hello World' AS Greetings, CONVERT(TIME(0),GETDATE()) AS TIME When you view this report on the mobile device, it has two columns (Greetings and Time) with values "Hello World" and current date and time stamp respectively. Version

76 Appendix Important recommendations When you design queries for tabular reports, please follow these recommendations: Review your queries periodically for performance improvements. It is recommended to: o o o o o Use Stored Procedures Avoid any reference to SQL #temp tables in the queries Use standard SQL performance tools to improve the query performance Verify the execution path of the query to identify the bottle necks Consider defragmenting and rebuilding indexes to improve performance o Consider reducing the original pool of data by archiving old data and only keeping current (30 day) production data Design queries so that the execution time of the query is always less than the set Data Frequency value to avoid having any negative performance impact. Design queries with optimum number of rows and columns to avoid any report display performance issues. You can add filters to the query to be as concise as possible. Do not use reserved SQL keywords such as EXECUTE, EXEC, and SET. This is not allowed in the SQL property bag to avoid SQL injections that can compromise authorized access to the database. Build a permanent database view for the database being queried to shift the query execution server side and maintain a centralized query definition. The database views for tables from various Invensys products will be kept constant or will be updated when the database schema changes. Therefore it is advisable to query database views instead of accessing the table directly. Use the "Start Time" option in SmartGlance MRC while configuring tabular reports. This allows you send the report data batch at a specified time. Thus, controlling and purposefully staggering the reports to fire at precise time interval can play an important role in improving the performance of the database. Sample query The following query on Wonderware Historian database shows how to make tabular report data appear as time series data by pivoting the data set. 76 Version 2016

77 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide CREATE PROCEDURE MRC_1440 AS SELECT * FROM ( SELECT CASE TagName WHEN 'SysTimeMin' THEN 'Min' -- WHEN 'SimBot_001.SimBot_02' THEN 'Simbot 02' -- WHEN 'SimBot_001.SimBot_03' THEN 'Simbot 03' -- WHEN 'SimBot_001.SimBot_04' THEN 'Simbot 04' -- WHEN 'SimBot_001.SimBot_05' THEN 'Simbot 05' -- WHEN 'SimBot_001.SimBot_06' THEN 'Simbot 06' ELSE TagName END AS 'TagName',Value --,CONVERT(VARCHAR(10), DateTime, 6) AS [StartDate] -- Diagnostic to show the applied Date.,CONVERT(VARCHAR(10), DateTime, 108) AS [StartTime] -- The row that we are pivoting on FROM Runtime.dbo.History WHERE TagName IN ( 'SysTimeMin' -- The TagName. Add more as needed in the format of 'Tag1','Tag2' etc. ) AND wwversion = 'Latest' AND wwretrievalmode = 'Cyclic' AND wwresolution = One Minute in milliseconds (i.e., the interval) Version

78 Appendix AND DateTime >= (cast(getdate() as date)) -- FLOOR (i.e., Today's date at exactly midnight) AND DateTime <= GETDATE() --AND DateTime <= DATEADD(HOUR, datediff(hour, 0, dateadd(hour, 1, GETDATE()-((1.00/60.00)/24.00))),0) -- CEILING (i.e., Query up until the last whole minute) ) [Source] PIVOT ( --SUM([Last Hour]) SUM([Value]) FOR StartTime IN ( [00:00:00],[00:01:00],[00:02:00],[00:03:00],[00:04:00],[00:05:00],[00:06:00],[00:07:00],[00:08:00],[00:09:00],[00:10:00],[00:11:00],[00:12:00],[00:13:00],[00:14:00],[00:15:00],[00:16:00],[00:17:00],[00:18:00],[00:19:00],[00:20:00],[00:21:00],[00:22:00],[00:23:00],[00:24:00],[00:25:00],[00:26:00],[00:27:00],[00:28:00],[00:29:00],[00:30:00],[00:31:00],[00:32:00],[00:33:00],[00:34:00],[00:35:00],[00:36:00],[00:37:00],[00:38:00],[00:39:00],[00:40:00],[00:41:00],[00:42:00],[00:43:00],[00:44:00],[00:45:00],[00:46:00],[00:47:00],[00:48:00],[00:49:00],[00:50:00],[00:51:00],[00:52:00],[00:53:00],[00:54:00],[00:55:00],[00:56:00],[00:57:00],[00:58:00],[00:59:00],[01:00:00],[01:01:00],[01:02:00],[01:03:00],[01:04:00],[01:05:00],[01:06:00],[01:07:00],[01:08:00],[01:09:00],[01:10:00],[01:11:00],[01:12:00],[01:13:00],[01:14:00],[01:15:00],[01:16:00],[01:17:00],[01:18:00],[01:19:00],[01:20:00],[01:21:00],[01:22:00],[01:23:00],[01:24:00],[01:25:00],[01:26:00],[01:27:00],[01:28:00],[01:29:00],[01:30:00],[01:31:00],[01:32:00],[01:33:00],[01:34:00],[01:35:00],[01:36:00],[01:37:00],[01:38:00],[01:39:00],[01:40:00],[01:41:00],[01:42:00],[01:43:00],[01:44:00],[01:45:00],[01:46:00],[01:47:00],[01:48:00],[01:49:00],[01:50:00],[01:51:00],[01:52:00],[01:53:00],[01:54:00],[01:55:00],[01:56:00],[01:57:00],[01:58:00],[01:59:00],[02:00:00],[02:01:00],[02:02:00],[02:03:00],[02:04:00],[02:05:00],[02:06:00],[02:07:00],[02:08:00],[02:09:00],[02:10:00],[02:11:00],[02:12:00],[02:13:00],[02:14:00],[02:15:00],[02:16:00],[02:17:00],[02:18:00],[02:19:00],[02:20:00],[02:21:00],[02:22:00],[02:23:00],[02:24:00],[02:25:00],[02:26:00],[02:27:00],[02:28:00],[02:29:00],[02:30:00],[02:31:00],[02:32:00],[02:33:00],[02:34:00],[02:35:00],[02:36:00],[02:37:00],[02:38:00],[02:39:00],[02:40:00],[02:41:00],[02:42:00],[02:43:00],[02:44:00],[02:45:00],[02:46:00],[02:47:00],[02:48:00],[02:49:00],[02:50:00],[02:51:00],[02:52:00],[02:53:00],[02:54:00],[02:55:00],[02:56:00],[02:57:00],[02:58:00],[02:59:00] 78 Version 2016

79 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide,[03:00:00],[03:01:00],[03:02:00],[03:03:00],[03:04:00],[03:05:00],[03:06:00],[03:07:00],[03:08:00],[03:09:00],[03:10:00],[03:11:00],[03:12:00],[03:13:00],[03:14:00],[03:15:00],[03:16:00],[03:17:00],[03:18:00],[03:19:00],[03:20:00],[03:21:00],[03:22:00],[03:23:00],[03:24:00],[03:25:00],[03:26:00],[03:27:00],[03:28:00],[03:29:00],[03:30:00],[03:31:00],[03:32:00],[03:33:00],[03:34:00],[03:35:00],[03:36:00],[03:37:00],[03:38:00],[03:39:00],[03:40:00],[03:41:00],[03:42:00],[03:43:00],[03:44:00],[03:45:00],[03:46:00],[03:47:00],[03:48:00],[03:49:00],[03:50:00],[03:51:00],[03:52:00],[03:53:00],[03:54:00],[03:55:00],[03:56:00],[03:57:00],[03:58:00],[03:59:00],[04:00:00],[04:01:00],[04:02:00],[04:03:00],[04:04:00],[04:05:00],[04:06:00],[04:07:00],[04:08:00],[04:09:00],[04:10:00],[04:11:00],[04:12:00],[04:13:00],[04:14:00],[04:15:00],[04:16:00],[04:17:00],[04:18:00],[04:19:00],[04:20:00],[04:21:00],[04:22:00],[04:23:00],[04:24:00],[04:25:00],[04:26:00],[04:27:00],[04:28:00],[04:29:00],[04:30:00],[04:31:00],[04:32:00],[04:33:00],[04:34:00],[04:35:00],[04:36:00],[04:37:00],[04:38:00],[04:39:00],[04:40:00],[04:41:00],[04:42:00],[04:43:00],[04:44:00],[04:45:00],[04:46:00],[04:47:00],[04:48:00],[04:49:00],[04:50:00],[04:51:00],[04:52:00],[04:53:00],[04:54:00],[04:55:00],[04:56:00],[04:57:00],[04:58:00],[04:59:00],[05:00:00],[05:01:00],[05:02:00],[05:03:00],[05:04:00],[05:05:00],[05:06:00],[05:07:00],[05:08:00],[05:09:00],[05:10:00],[05:11:00],[05:12:00],[05:13:00],[05:14:00],[05:15:00],[05:16:00],[05:17:00],[05:18:00],[05:19:00],[05:20:00],[05:21:00],[05:22:00],[05:23:00],[05:24:00],[05:25:00],[05:26:00],[05:27:00],[05:28:00],[05:29:00],[05:30:00],[05:31:00],[05:32:00],[05:33:00],[05:34:00],[05:35:00],[05:36:00],[05:37:00],[05:38:00],[05:39:00],[05:40:00],[05:41:00],[05:42:00],[05:43:00],[05:44:00],[05:45:00],[05:46:00],[05:47:00],[05:48:00],[05:49:00],[05:50:00],[05:51:00],[05:52:00],[05:53:00],[05:54:00],[05:55:00],[05:56:00],[05:57:00],[05:58:00],[05:59:00],[06:00:00],[06:01:00],[06:02:00],[06:03:00],[06:04:00],[06:05:00],[06:06:00],[06:07:00],[06:08:00],[06:09:00],[06:10:00],[06:11:00],[06:12:00],[06:13:00],[06:14:00],[06:15:00],[06:16:00],[06:17:00],[06:18:00],[06:19:00],[06:20:00],[06:21:00],[06:22:00],[06:23:00],[06:24:00],[06:25:00],[06:26:00],[06:27:00],[06:28:00],[06:29:00],[06:30:00],[06:31:00],[06:32:00],[06:33:00],[06:34:00],[06:35:00],[06:36:00],[06:37:00],[06:38:00],[06:39:00],[06:40:00],[06:41:00],[06:42:00],[06:43:00],[06:44:00],[06:45:00],[06:46:00],[06:47:00],[06:48:00],[06:49:00],[06:50:00],[06:51:00],[06:52:00],[06:53:00],[06:54:00],[06:55:00],[06:56:00],[06:57:00],[06:58:00],[06:59:00] Version

80 Appendix,[07:00:00],[07:01:00],[07:02:00],[07:03:00],[07:04:00],[07:05:00],[07:06:00],[07:07:00],[07:08:00],[07:09:00],[07:10:00],[07:11:00],[07:12:00],[07:13:00],[07:14:00],[07:15:00],[07:16:00],[07:17:00],[07:18:00],[07:19:00],[07:20:00],[07:21:00],[07:22:00],[07:23:00],[07:24:00],[07:25:00],[07:26:00],[07:27:00],[07:28:00],[07:29:00],[07:30:00],[07:31:00],[07:32:00],[07:33:00],[07:34:00],[07:35:00],[07:36:00],[07:37:00],[07:38:00],[07:39:00],[07:40:00],[07:41:00],[07:42:00],[07:43:00],[07:44:00],[07:45:00],[07:46:00],[07:47:00],[07:48:00],[07:49:00],[07:50:00],[07:51:00],[07:52:00],[07:53:00],[07:54:00],[07:55:00],[07:56:00],[07:57:00],[07:58:00],[07:59:00],[08:00:00],[08:01:00],[08:02:00],[08:03:00],[08:04:00],[08:05:00],[08:06:00],[08:07:00],[08:08:00],[08:09:00],[08:10:00],[08:11:00],[08:12:00],[08:13:00],[08:14:00],[08:15:00],[08:16:00],[08:17:00],[08:18:00],[08:19:00],[08:20:00],[08:21:00],[08:22:00],[08:23:00],[08:24:00],[08:25:00],[08:26:00],[08:27:00],[08:28:00],[08:29:00],[08:30:00],[08:31:00],[08:32:00],[08:33:00],[08:34:00],[08:35:00],[08:36:00],[08:37:00],[08:38:00],[08:39:00],[08:40:00],[08:41:00],[08:42:00],[08:43:00],[08:44:00],[08:45:00],[08:46:00],[08:47:00],[08:48:00],[08:49:00],[08:50:00],[08:51:00],[08:52:00],[08:53:00],[08:54:00],[08:55:00],[08:56:00],[08:57:00],[08:58:00],[08:59:00],[09:00:00],[09:01:00],[09:02:00],[09:03:00],[09:04:00],[09:05:00],[09:06:00],[09:07:00],[09:08:00],[09:09:00],[09:10:00],[09:11:00],[09:12:00],[09:13:00],[09:14:00],[09:15:00],[09:16:00],[09:17:00],[09:18:00],[09:19:00],[09:20:00],[09:21:00],[09:22:00],[09:23:00],[09:24:00],[09:25:00],[09:26:00],[09:27:00],[09:28:00],[09:29:00],[09:30:00],[09:31:00],[09:32:00],[09:33:00],[09:34:00],[09:35:00],[09:36:00],[09:37:00],[09:38:00],[09:39:00],[09:40:00],[09:41:00],[09:42:00],[09:43:00],[09:44:00],[09:45:00],[09:46:00],[09:47:00],[09:48:00],[09:49:00],[09:50:00],[09:51:00],[09:52:00],[09:53:00],[09:54:00],[09:55:00],[09:56:00],[09:57:00],[09:58:00],[09:59:00],[10:00:00],[10:01:00],[10:02:00],[10:03:00],[10:04:00],[10:05:00],[10:06:00],[10:07:00],[10:08:00],[10:09:00],[10:10:00],[10:11:00],[10:12:00],[10:13:00],[10:14:00],[10:15:00],[10:16:00],[10:17:00],[10:18:00],[10:19:00],[10:20:00],[10:21:00],[10:22:00],[10:23:00],[10:24:00],[10:25:00],[10:26:00],[10:27:00],[10:28:00],[10:29:00],[10:30:00],[10:31:00],[10:32:00],[10:33:00],[10:34:00],[10:35:00],[10:36:00],[10:37:00],[10:38:00],[10:39:00],[10:40:00],[10:41:00],[10:42:00],[10:43:00],[10:44:00],[10:45:00],[10:46:00],[10:47:00],[10:48:00],[10:49:00],[10:50:00],[10:51:00],[10:52:00],[10:53:00],[10:54:00],[10:55:00],[10:56:00],[10:57:00],[10:58:00],[10:59:00] 80 Version 2016

81 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide,[11:00:00],[11:01:00],[11:02:00],[11:03:00],[11:04:00],[11:05:00],[11:06:00],[11:07:00],[11:08:00],[11:09:00],[11:10:00],[11:11:00],[11:12:00],[11:13:00],[11:14:00],[11:15:00],[11:16:00],[11:17:00],[11:18:00],[11:19:00],[11:20:00],[11:21:00],[11:22:00],[11:23:00],[11:24:00],[11:25:00],[11:26:00],[11:27:00],[11:28:00],[11:29:00],[11:30:00],[11:31:00],[11:32:00],[11:33:00],[11:34:00],[11:35:00],[11:36:00],[11:37:00],[11:38:00],[11:39:00],[11:40:00],[11:41:00],[11:42:00],[11:43:00],[11:44:00],[11:45:00],[11:46:00],[11:47:00],[11:48:00],[11:49:00],[11:50:00],[11:51:00],[11:52:00],[11:53:00],[11:54:00],[11:55:00],[11:56:00],[11:57:00],[11:58:00],[11:59:00],[12:00:00],[12:01:00],[12:02:00],[12:03:00],[12:04:00],[12:05:00],[12:06:00],[12:07:00],[12:08:00],[12:09:00],[12:10:00],[12:11:00],[12:12:00],[12:13:00],[12:14:00],[12:15:00],[12:16:00],[12:17:00],[12:18:00],[12:19:00],[12:20:00],[12:21:00],[12:22:00],[12:23:00],[12:24:00],[12:25:00],[12:26:00],[12:27:00],[12:28:00],[12:29:00],[12:30:00],[12:31:00],[12:32:00],[12:33:00],[12:34:00],[12:35:00],[12:36:00],[12:37:00],[12:38:00],[12:39:00],[12:40:00],[12:41:00],[12:42:00],[12:43:00],[12:44:00],[12:45:00],[12:46:00],[12:47:00],[12:48:00],[12:49:00],[12:50:00],[12:51:00],[12:52:00],[12:53:00],[12:54:00],[12:55:00],[12:56:00],[12:57:00],[12:58:00],[12:59:00],[13:00:00],[13:01:00],[13:02:00],[13:03:00],[13:04:00],[13:05:00],[13:06:00],[13:07:00],[13:08:00],[13:09:00],[13:10:00],[13:11:00],[13:12:00],[13:13:00],[13:14:00],[13:15:00],[13:16:00],[13:17:00],[13:18:00],[13:19:00],[13:20:00],[13:21:00],[13:22:00],[13:23:00],[13:24:00],[13:25:00],[13:26:00],[13:27:00],[13:28:00],[13:29:00],[13:30:00],[13:31:00],[13:32:00],[13:33:00],[13:34:00],[13:35:00],[13:36:00],[13:37:00],[13:38:00],[13:39:00],[13:40:00],[13:41:00],[13:42:00],[13:43:00],[13:44:00],[13:45:00],[13:46:00],[13:47:00],[13:48:00],[13:49:00],[13:50:00],[13:51:00],[13:52:00],[13:53:00],[13:54:00],[13:55:00],[13:56:00],[13:57:00],[13:58:00],[13:59:00],[14:00:00],[14:01:00],[14:02:00],[14:03:00],[14:04:00],[14:05:00],[14:06:00],[14:07:00],[14:08:00],[14:09:00],[14:10:00],[14:11:00],[14:12:00],[14:13:00],[14:14:00],[14:15:00],[14:16:00],[14:17:00],[14:18:00],[14:19:00],[14:20:00],[14:21:00],[14:22:00],[14:23:00],[14:24:00],[14:25:00],[14:26:00],[14:27:00],[14:28:00],[14:29:00],[14:30:00],[14:31:00],[14:32:00],[14:33:00],[14:34:00],[14:35:00],[14:36:00],[14:37:00],[14:38:00],[14:39:00],[14:40:00],[14:41:00],[14:42:00],[14:43:00],[14:44:00],[14:45:00],[14:46:00],[14:47:00],[14:48:00],[14:49:00],[14:50:00],[14:51:00],[14:52:00],[14:53:00],[14:54:00],[14:55:00],[14:56:00],[14:57:00],[14:58:00],[14:59:00] Version

82 Appendix,[15:00:00],[15:01:00],[15:02:00],[15:03:00],[15:04:00],[15:05:00],[15:06:00],[15:07:00],[15:08:00],[15:09:00],[15:10:00],[15:11:00],[15:12:00],[15:13:00],[15:14:00],[15:15:00],[15:16:00],[15:17:00],[15:18:00],[15:19:00],[15:20:00],[15:21:00],[15:22:00],[15:23:00],[15:24:00],[15:25:00],[15:26:00],[15:27:00],[15:28:00],[15:29:00],[15:30:00],[15:31:00],[15:32:00],[15:33:00],[15:34:00],[15:35:00],[15:36:00],[15:37:00],[15:38:00],[15:39:00],[15:40:00],[15:41:00],[15:42:00],[15:43:00],[15:44:00],[15:45:00],[15:46:00],[15:47:00],[15:48:00],[15:49:00],[15:50:00],[15:51:00],[15:52:00],[15:53:00],[15:54:00],[15:55:00],[15:56:00],[15:57:00],[15:58:00],[15:59:00],[16:00:00],[16:01:00],[16:02:00],[16:03:00],[16:04:00],[16:05:00],[16:06:00],[16:07:00],[16:08:00],[16:09:00],[16:10:00],[16:11:00],[16:12:00],[16:13:00],[16:14:00],[16:15:00],[16:16:00],[16:17:00],[16:18:00],[16:19:00],[16:20:00],[16:21:00],[16:22:00],[16:23:00],[16:24:00],[16:25:00],[16:26:00],[16:27:00],[16:28:00],[16:29:00],[16:30:00],[16:31:00],[16:32:00],[16:33:00],[16:34:00],[16:35:00],[16:36:00],[16:37:00],[16:38:00],[16:39:00],[16:40:00],[16:41:00],[16:42:00],[16:43:00],[16:44:00],[16:45:00],[16:46:00],[16:47:00],[16:48:00],[16:49:00],[16:50:00],[16:51:00],[16:52:00],[16:53:00],[16:54:00],[16:55:00],[16:56:00],[16:57:00],[16:58:00],[16:59:00],[17:00:00],[17:01:00],[17:02:00],[17:03:00],[17:04:00],[17:05:00],[17:06:00],[17:07:00],[17:08:00],[17:09:00],[17:10:00],[17:11:00],[17:12:00],[17:13:00],[17:14:00],[17:15:00],[17:16:00],[17:17:00],[17:18:00],[17:19:00],[17:20:00],[17:21:00],[17:22:00],[17:23:00],[17:24:00],[17:25:00],[17:26:00],[17:27:00],[17:28:00],[17:29:00],[17:30:00],[17:31:00],[17:32:00],[17:33:00],[17:34:00],[17:35:00],[17:36:00],[17:37:00],[17:38:00],[17:39:00],[17:40:00],[17:41:00],[17:42:00],[17:43:00],[17:44:00],[17:45:00],[17:46:00],[17:47:00],[17:48:00],[17:49:00],[17:50:00],[17:51:00],[17:52:00],[17:53:00],[17:54:00],[17:55:00],[17:56:00],[17:57:00],[17:58:00],[17:59:00],[18:00:00],[18:01:00],[18:02:00],[18:03:00],[18:04:00],[18:05:00],[18:06:00],[18:07:00],[18:08:00],[18:09:00],[18:10:00],[18:11:00],[18:12:00],[18:13:00],[18:14:00],[18:15:00],[18:16:00],[18:17:00],[18:18:00],[18:19:00],[18:20:00],[18:21:00],[18:22:00],[18:23:00],[18:24:00],[18:25:00],[18:26:00],[18:27:00],[18:28:00],[18:29:00],[18:30:00],[18:31:00],[18:32:00],[18:33:00],[18:34:00],[18:35:00],[18:36:00],[18:37:00],[18:38:00],[18:39:00],[18:40:00],[18:41:00],[18:42:00],[18:43:00],[18:44:00],[18:45:00],[18:46:00],[18:47:00],[18:48:00],[18:49:00],[18:50:00],[18:51:00],[18:52:00],[18:53:00],[18:54:00],[18:55:00],[18:56:00],[18:57:00],[18:58:00],[18:59:00] 82 Version 2016

83 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide,[19:00:00],[19:01:00],[19:02:00],[19:03:00],[19:04:00],[19:05:00],[19:06:00],[19:07:00],[19:08:00],[19:09:00],[19:10:00],[19:11:00],[19:12:00],[19:13:00],[19:14:00],[19:15:00],[19:16:00],[19:17:00],[19:18:00],[19:19:00],[19:20:00],[19:21:00],[19:22:00],[19:23:00],[19:24:00],[19:25:00],[19:26:00],[19:27:00],[19:28:00],[19:29:00],[19:30:00],[19:31:00],[19:32:00],[19:33:00],[19:34:00],[19:35:00],[19:36:00],[19:37:00],[19:38:00],[19:39:00],[19:40:00],[19:41:00],[19:42:00],[19:43:00],[19:44:00],[19:45:00],[19:46:00],[19:47:00],[19:48:00],[19:49:00],[19:50:00],[19:51:00],[19:52:00],[19:53:00],[19:54:00],[19:55:00],[19:56:00],[19:57:00],[19:58:00],[19:59:00],[20:00:00],[20:01:00],[20:02:00],[20:03:00],[20:04:00],[20:05:00],[20:06:00],[20:07:00],[20:08:00],[20:09:00],[20:10:00],[20:11:00],[20:12:00],[20:13:00],[20:14:00],[20:15:00],[20:16:00],[20:17:00],[20:18:00],[20:19:00],[20:20:00],[20:21:00],[20:22:00],[20:23:00],[20:24:00],[20:25:00],[20:26:00],[20:27:00],[20:28:00],[20:29:00],[20:30:00],[20:31:00],[20:32:00],[20:33:00],[20:34:00],[20:35:00],[20:36:00],[20:37:00],[20:38:00],[20:39:00],[20:40:00],[20:41:00],[20:42:00],[20:43:00],[20:44:00],[20:45:00],[20:46:00],[20:47:00],[20:48:00],[20:49:00],[20:50:00],[20:51:00],[20:52:00],[20:53:00],[20:54:00],[20:55:00],[20:56:00],[20:57:00],[20:58:00],[20:59:00],[21:00:00],[21:01:00],[21:02:00],[21:03:00],[21:04:00],[21:05:00],[21:06:00],[21:07:00],[21:08:00],[21:09:00],[21:10:00],[21:11:00],[21:12:00],[21:13:00],[21:14:00],[21:15:00],[21:16:00],[21:17:00],[21:18:00],[21:19:00],[21:20:00],[21:21:00],[21:22:00],[21:23:00],[21:24:00],[21:25:00],[21:26:00],[21:27:00],[21:28:00],[21:29:00],[21:30:00],[21:31:00],[21:32:00],[21:33:00],[21:34:00],[21:35:00],[21:36:00],[21:37:00],[21:38:00],[21:39:00],[21:40:00],[21:41:00],[21:42:00],[21:43:00],[21:44:00],[21:45:00],[21:46:00],[21:47:00],[21:48:00],[21:49:00],[21:50:00],[21:51:00],[21:52:00],[21:53:00],[21:54:00],[21:55:00],[21:56:00],[21:57:00],[21:58:00],[21:59:00],[22:00:00],[22:01:00],[22:02:00],[22:03:00],[22:04:00],[22:05:00],[22:06:00],[22:07:00],[22:08:00],[22:09:00],[22:10:00],[22:11:00],[22:12:00],[22:13:00],[22:14:00],[22:15:00],[22:16:00],[22:17:00],[22:18:00],[22:19:00],[22:20:00],[22:21:00],[22:22:00],[22:23:00],[22:24:00],[22:25:00],[22:26:00],[22:27:00],[22:28:00],[22:29:00],[22:30:00],[22:31:00],[22:32:00],[22:33:00],[22:34:00],[22:35:00],[22:36:00],[22:37:00],[22:38:00],[22:39:00],[22:40:00],[22:41:00],[22:42:00],[22:43:00],[22:44:00],[22:45:00],[22:46:00],[22:47:00],[22:48:00],[22:49:00],[22:50:00],[22:51:00],[22:52:00],[22:53:00],[22:54:00],[22:55:00],[22:56:00],[22:57:00],[22:58:00],[22:59:00] Version

84 Appendix,[23:00:00],[23:01:00],[23:02:00],[23:03:00],[23:04:00],[23:05:00],[23:06:00],[23:07:00],[23:08:00],[23:09:00],[23:10:00],[23:11:00],[23:12:00],[23:13:00],[23:14:00],[23:15:00],[23:16:00],[23:17:00],[23:18:00],[23:19:00],[23:20:00],[23:21:00],[23:22:00],[23:23:00],[23:24:00],[23:25:00],[23:26:00],[23:27:00],[23:28:00],[23:29:00],[23:30:00],[23:31:00],[23:32:00],[23:33:00],[23:34:00],[23:35:00],[23:36:00],[23:37:00],[23:38:00],[23:39:00],[23:40:00],[23:41:00],[23:42:00],[23:43:00],[23:44:00],[23:45:00],[23:46:00],[23:47:00],[23:48:00],[23:49:00],[23:50:00],[23:51:00],[23:52:00],[23:53:00],[23:54:00],[23:55:00],[23:56:00],[23:57:00],[23:58:00],[23:59:00] ) ) AS PivotTable Writing queries for the ibutton ibutton is a SmartGlance functionality which allows users to get information relevant to a particular data point or report. The ibutton description values can be set using SQL queries while creating the tabular reports. This section provides examples of SQL queries for setting the ibutton description values. Sample queries The sample queries given below can be executed by putting them in the SQL query box of tabular reports. Important The query should have a minimum of four columns including the ibutton description. The last column of the Select statement is used as the ibutton description. The queries written for ibutton, Drill down, and Friendly URL functionalites should be enclosed within <Request><SelectStatement> </SelectStatement></Request> block. Sample query 1 If the table schema doesn't contain a column for ibutton description, it can be included in the Select query as shown in the query given below. <Request> <SelectStatement> Select 'Col A', 'Col B','Col C', 'My Text' + CHAR(13) + 'Second Line' AS buttondescription </SelectStatement> <LastColumnAsDescription>true</LastColumnAsDescription> </Request> 84 Version 2016

85 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide It is recommended to use CHAR(13) in the ibutton description column for better presentation in the mobile device. Sample query 2 This sample query on Wonderware Alarm DB shows ibutton description as a result of joining two fields. <Request> <SelectStatement> select top 1 'Col A', tagname, 'Col B','My Text' + CHAR(13) + [TagName] AS buttondescription from dbo.v_alarmeventhistory2</selectstatement> <LastColumnAsDescription>true</LastColumnAsDescription> </Request> Enhanced ibutton queries All the sample reports for CEM, MES, Alarm DB and all other tabular reports can now have additional contextual information for each ibutton row or record including links to navigate to other reports. To learn about these features in general, visit the following website The following sample queries have been enhanced for use in SmartGlance MRC. SmartGlance MRC example for the "drill down" feature <Request> <SelectStatement> SELECT name, database_id, compatibility_level, collation_name + CHAR(13) + '!#Report Title=Other Report##Jump Report#!' AS buttondescription FROM sys.databases </SelectStatement> <LastColumnAsDescription>true</LastColumnAsDescription> </Request> Please note that: + is used to concatenate different strings together to make a single block of text. CHAR(13) is used to create carriage returns for better formatting in the ibutton text. The above query can be run against the MASTER database for SQL Server 2008 using the generic SQL Server data provider. Version

86 Appendix SmartGlance MRC example for friendly URL <Request> <SelectStatement> SELECT name, database_id, compatibility_level, collation_name + CHAR(13) + 'Drill down to the!#sky TEST=ABC G##Jump Report#!' + CHAR(13) + + CHAR(13) + 'Or click this!< ## SmartGlance link>! to learn more' AS buttondescription FROM sys.databases </SelectStatement> <LastColumnAsDescription>true</LastColumnAsDescription> </Request> Please note that: Ensure that the excel format for Friendly URL is enclosed between the less than and greater than symbols (< and > ). Since the SQL Statement is embedded inside XML tags, special characters such as '>' and '<' can be misinterpreted and may cause the query to fail. To avoid this, XML escape characters should be used. Following is a list of XML escape characters: Special character < < > > & Entity representation & " " Note: The XML escape characters end with a semicolon. Corporate Energy Management The Schneider Electric Corporate Energy Management (CEM) application records energy consumption from a single point in a manufacturing process to the entire energy usage of the whole manufacturing facility and associated office buildings. For example, it is used to monitor water, power and electricity usage. These queries are designed for use with CEM v Version 2016

87 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide CEM Current Rates.sql This query of the CEM database shows the meter rates in the selected currency for all meters. Version

88 Appendix CEM Daily Costs.sql This query of the CEM database displays the daily summary costs per meter in the last six days with each column heading reflecting each day. 88 Version 2016

89 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide Version

90 Appendix Wonderware Manufacturing Execution System These queries are designed for use with Manufacturing Execution System (MES) v Version 2016

91 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide MES 24hr OEE.sql This query of the MES database shows OEE and OEE components (utilization, quality, and performance) by entity in the past 24 hours. Version

92 Appendix MES 24hr Prod.sql This query of the MES database shows all items produced along with the quantity produced categorized as Good Quantity, Bad (rejected) Quantity in the last 24 hours from the current time. MES 24hr Prod by Ent.sql This query of the MES database shows all entities and items produced on those entities in the last 24 hours from now along with the quantity and unit of measure. MES Current WO.sql This query of the MES database shows all entities that have a Running Work Order State along with Work Order id and Item being produced. 92 Version 2016

93 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide MES OEE Current.sql This query of the MES database lists all finished goods along current vs target % OEE. Wonderware Alarm Database These queries are designed for use with the Wonderware Alarm Database (WWALMDB) version that comes with InTouch 10. These are not intended to replace true real-time ALERT or ALARM functionality. Rather they are provided here for convenient static Alarm analysis at any given moment in time. WWALMDB Top 10 Recent.sql This query of WWALMDB shows the top 10 most recent Alarms in the last 24 hours. The number of alarms and the time period are customizable options. WWALMDB Top 10 Standing.sql This query of WWALMDB shows the top 10 Standing or Unacknowledged Alarms in the last 24 hours. The number of alarms, type of alarms, and the time period are customizable options. Version

94 Appendix WWALMDB Worst Offenders Tagname.sql This query of WWALMDB shows the tag names (in descending order) that have the maximum number of alarms registered against them in the last 24 hours. Optionally, it should also be possible to specify a minimum count threshold to report only the highest alarm count or worst offenders. WWALMDB Worst Offenders Area.sql This query of WWALMDB shows the (Alarm) areas (in descending order) that have the maximum number of alarms registered against them in the last 24 hours. Optionally, it should also be possible to specify a minimum count threshold to report only the highest grouping of alarm counts or worst offenders. WWALMDB All alarms with numerical truncated This query of WWALMDB shows the (Alarm) areas (in descending order) that have the maximum number of alarms registered against them in the last 24 hours. Optionally, it should also be possible to specify a minimum count threshold to report only the highest grouping of alarm counts or worst offenders. Wonderware Intelligence These queries are for use with Wonderware Intelligence v Version 2016

95 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide vwoeedata This query of the Intelligence database creates a view that assembles OEEData measure table with its dimensions. Version

96 Appendix OEE By Equipment This query of the Intelligence database retrieves OEE and its metrics by Equipment for a given period of time (TBD) and drills down to Daily OEE by Equipment Report. 96 Version 2016

97 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide Daily OEE By Equipment This query of the Intelligence database retrieves Daily OEE and its metrics by Equipment. Wonderware IntelaTrac This query is designed for use with the IntelaTrac v4.1 database. Intelatrac Exceptions.sql This query of the IntelaTrac database allows the report viewer to see a list of Severities per Base. The highest Severities will be listed first per Base so that the user can see current activity of interest. You can also see any associated notes and the IntelaTrac user who took the reading. Version

98 Appendix Note: This query is not time-bound. Consider adding a time constraint to the query if required. Well Field Application This query is designed for use with Well Field Application (WFA) database v Version 2016

99 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide USE [WellData] GO /****** Object: StoredProcedure [dbo].[getcurrentsummarydatamobile] ******/ IF EXISTS (SELECT * FROM sys.objects WHERE object_id = OBJECT_ID(N'[dbo].[GetCurrentSummaryDataMobile]') AND type in (N'P', N'PC')) DROP PROCEDURE [dbo].[getcurrentsummarydatamobile] GO /****** Object: StoredProcedure [dbo].[getdailyhistorydatamobile]******/ IF EXISTS (SELECT * FROM sys.objects WHERE object_id = OBJECT_ID(N'[dbo].[GetDailyHistoryDataMobile]') AND type in (N'P', N'PC')) DROP PROCEDURE [dbo].[getdailyhistorydatamobile] GO /****** Object: StoredProcedure [dbo].[gethourlyhistorydatamobile]******/ IF EXISTS (SELECT * FROM sys.objects WHERE object_id = OBJECT_ID(N'[dbo].[GetHourlyHistoryDataMobile]') AND type in (N'P', N'PC')) DROP PROCEDURE [dbo].[gethourlyhistorydatamobile] GO /****** Object: StoredProcedure [dbo].[getpastsummarydatamobile]******/ IF EXISTS (SELECT * FROM sys.objects WHERE object_id = OBJECT_ID(N'[dbo].[GetPastSummaryDataMobile]') AND type in (N'P', N'PC')) DROP PROCEDURE [dbo].[getpastsummarydatamobile] GO Version

100 Appendix /****** Object: StoredProcedure [dbo].[getweeklysummarydatamobile] ******/ IF EXISTS (SELECT * FROM sys.objects WHERE object_id = OBJECT_ID(N'[dbo].[GetWeeklySummaryDataMobile]') AND type in (N'P', N'PC')) DROP PROCEDURE [dbo].[getweeklysummarydatamobile] GO /****** Object: StoredProcedure [dbo].[getdailyefmdatamobile]******/ IF EXISTS (SELECT * FROM sys.objects WHERE object_id = OBJECT_ID(N'[dbo].[GetDailyEFMDataMobile]') AND type in (N'P', N'PC')) DROP PROCEDURE [dbo].[getdailyefmdatamobile] GO /****** Object: StoredProcedure [dbo].[gethourlyefmdatamobile]******/ IF EXISTS (SELECT * FROM sys.objects WHERE object_id = OBJECT_ID(N'[dbo].[GetHourlyEFMDataMobile]') AND type in (N'P', N'PC')) DROP PROCEDURE [dbo].[gethourlyefmdatamobile] GO /****** Object: StoredProcedure [dbo].[getlowbatteriesdatamobile]******/ IF EXISTS (SELECT * FROM sys.objects WHERE object_id = OBJECT_ID(N'[dbo].[GetLowBatteriesDataMobile]') AND type in (N'P', N'PC')) DROP PROCEDURE [dbo].[getlowbatteriesdatamobile] GO /****** Object: StoredProcedure [dbo].[getefmexceptionsdatamobile] ******/ IF EXISTS (SELECT * FROM sys.objects WHERE object_id = OBJECT_ID(N'[dbo].[GetEFMExceptionsDataMobile]') AND type in (N'P', N'PC')) DROP PROCEDURE [dbo].[getefmexceptionsdatamobile] 100 Version 2016

101 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide GO /****** Object: StoredProcedure [dbo].[getcommfailuresdatamobile]******/ IF EXISTS (SELECT * FROM sys.objects WHERE object_id = OBJECT_ID(N'[dbo].[GetCommFailuresDataMobile]') AND type in (N'P', N'PC')) DROP PROCEDURE [dbo].[getcommfailuresdatamobile] GO /****** Object: StoredProcedure [dbo].[getcurrentsummarydatamobile] *****/ SET ANSI_NULLS ON GO SET QUOTED_IDENTIFIER ON GO -- ============================================= -- Description: Pulls the data for the -- CurrentSummary page's main grid -- ============================================= CREATE PROCEDURE [dbo].[getcurrentsummarydatamobile] AS BEGIN SET NOCOUNT ON; int = 1 varchar(max) = '' --Build ColumnList Version

102 Appendix varchar(150) = '' varchar(150) = '' DECLARE cur CURSOR FOR SELECT ColumnName, Replace(Alias,'''','''''') as alias FROM UI_DynamicDataGridColumns WHERE GridID and ColumnName <> 'DateTime' ORDER BY OrderInDataGrid OPEN cur FETCH NEXT FROM WHILE (@@FETCH_STATUS = 0) BEGIN + '[' + '] AS ''' + ''',' FETCH NEXT FROM END CLOSE cur DEALLOCATE cur + 'CONVERT(VARCHAR(20),[' + (SELECT DISTINCT ColumnName FROM UI_DynamicDataGridColumns WHERE GridID AND ColumnName = 'DateTime')+ '],113) as RecordTime, ' = SUBSTRING(@ColumnList, 0, LEN(@ColumnList))--Trim the trailing comma --Ensure there are columns to build the dynamic query from IF (LEN(@ColumnList) = 0) BEGIN varchar(50) 102 Version 2016

103 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide = (SELECT GridName FROM UI_DynamicDataGrids WHERE GridID RAISERROR('The DynamicDataGrid "%s" has no columns assigned.', 16, END --Build Dynamic Query & return results varchar(150) = (SELECT TOP 1 SourceTableOrViewName FROM UI_DynamicDataGrids WHERE GridID varchar(max) = 'SELECT ' + ', ''Summary for the Area: ''+ [WellName] + ''as on '' + CONVERT(VARCHAR(20),[DateTime],113) As ibutton FROM ' + ' ' + 'WHERE RowType IN (''Asset'', ''Area'', ''Run'', ''LiftType'') ORDER BY CASE WHEN RowType = ''Asset'' THEN 1 WHEN RowType = ''Area'' THEN 2 WHEN RowType = ''Run'' THEN 3 WHEN RowType = ''LiftType'' THEN 4 ELSE 5 END' EXEC (@DynamicQuery) END /****** Object: StoredProcedure [dbo].[getdailyhistorydatamobile] ******/ SET ANSI_NULLS ON Version

104 Appendix GO SET QUOTED_IDENTIFIER ON GO -- ============================================= -- Description: Pulls the data for the -- Daily History page's main grid ============================================= CREATE PROCEDURE [dbo].[getdailyhistorydatamobile] AS BEGIN SET NOCOUNT ON; int = 8 varchar(max) = '0027' varchar(max) = '' --Build ColumnList varchar(150) = '' varchar(150) = '' --Set the first column as Date and Time + 'CONVERT(VARCHAR(12),[' + (SELECT DISTINCT ColumnName FROM UI_DynamicDataGridColumns WHERE GridID AND ColumnName = 'Date')+ '],113) As DateTime, ' 104 Version 2016

105 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide DECLARE cur CURSOR FOR SELECT ColumnName, Replace(Alias,'''','''''') as alias FROM UI_DynamicDataGridColumns WHERE GridID and ColumnName <> 'Date' ORDER BY OrderInDataGrid OPEN cur FETCH NEXT FROM WHILE (@@FETCH_STATUS = 0) BEGIN + '[' + '] AS ''' + ''',' FETCH NEXT FROM END CLOSE cur DEALLOCATE cur = SUBSTRING(@ColumnList, 0, LEN(@ColumnList))--Trim the trailing comma --Ensure there are columns to build the dynamic query from IF (LEN(@ColumnList) = 0) BEGIN varchar(50) = (SELECT GridName FROM UI_DynamicDataGrids WHERE GridID RAISERROR('The DynamicDataGrid "%s" has no columns assigned.', 16, END --Build Dynamic Query & return results varchar(150) Version

106 Appendix = (SELECT TOP 1 SourceTableOrViewName FROM UI_DynamicDataGrids WHERE GridID varchar(max) ='' = 'SELECT TOP 90 ' + ', ''Daily History for the Area: ''+ [WellName] + ''as on '' + CONVERT(VARCHAR(12),[Date],113) As ibutton FROM ' + ' ' + 'WHERE ID = ''' + ''' ORDER BY Date DESC' EXEC (@DynamicQuery) END /****** Object: StoredProcedure [dbo].[gethourlyhistorydatamobile]******/ SET ANSI_NULLS ON GO SET QUOTED_IDENTIFIER ON GO -- ============================================= -- Description: Pulls the data for the -- Hourly History page's main grid ============================================= CREATE PROCEDURE [dbo].[gethourlyhistorydatamobile] AS BEGIN SET NOCOUNT ON; int = 9 varchar(max) 106 Version 2016

107 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide = '0027' varchar(max) = '' --Build ColumnList varchar(150) = '' varchar(150) = '' --Set the first column as Date and Time + 'CONVERT(VARCHAR(20),[' + (SELECT DISTINCT ColumnName FROM UI_DynamicDataGridColumns WHERE GridID AND ColumnName = 'DateTime')+ '],113) As DateTime, ' DECLARE cur CURSOR FOR SELECT ColumnName, Replace(Alias,'''','''''') as alias FROM UI_DynamicDataGridColumns WHERE GridID and ColumnName <> 'DateTime' ORDER BY OrderInDataGrid OPEN cur FETCH NEXT FROM WHILE (@@FETCH_STATUS = 0) BEGIN + '[' + '] AS ''' + ''',' FETCH NEXT FROM END CLOSE cur DEALLOCATE cur = SUBSTRING(@ColumnList, 0, LEN(@ColumnList))--Trim the trailing comma Version

108 Appendix --Ensure there are columns to build the dynamic query IF = 0) BEGIN varchar(50) = (SELECT GridName FROM UI_DynamicDataGrids WHERE GridID RAISERROR('The DynamicDataGrid "%s" has no columns assigned.', 16, END --Build Dynamic Query & return results varchar(150) = (SELECT TOP 1 SourceTableOrViewName FROM UI_DynamicDataGrids WHERE GridID varchar(max) ='' = 'SELECT ' + ', ''Hourly History for the Area: ''+ [WellName]+ '' on '' + CONVERT(VARCHAR(20),[DateTime],113) As ibutton FROM ' + ' ' + 'WHERE ID = ''' + ''' ' + 'AND DateTime >= GetDate() - 7 ' + 'ORDER BY DateTime DESC' EXEC (@DynamicQuery) END /****** Object: StoredProcedure [dbo].[getpastsummarydatamobile]******/ SET ANSI_NULLS ON GO SET QUOTED_IDENTIFIER ON 108 Version 2016

109 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide GO -- ============================================= -- Description: Pulls the data for the -- yesterday History main grid ============================================= CREATE PROCEDURE [dbo].[getpastsummarydatamobile] AS BEGIN int 1 int = 4 nvarchar(max) = '' --Build ColumnList varchar(150) = '' varchar(150) = '' DECLARE cur CURSOR FOR SELECT ColumnName, Replace(Alias,'''','''''') as Alias FROM UI_DynamicDataGridColumns WHERE GridID and ColumnName <> 'Date' ORDER BY OrderInDataGrid OPEN cur FETCH NEXT FROM WHILE (@@FETCH_STATUS = 0) Version

110 Appendix BEGIN + '[' + '] AS ''' + ''',' FETCH NEXT FROM END CLOSE cur DEALLOCATE cur --Set the last column as Date ='' = '[' +(SELECT ColumnName FROM UI_DynamicDataGridColumns WHERE GridID AND ColumnName = 'Date')+ ']' + ' +',113) AS + ', ' = SUBSTRING(@ColumnList, 0, LEN(@ColumnList))--Trim the trailing comma --Ensure there are columns to build the dynamic query from IF (LEN(@ColumnList) = 0) BEGIN varchar(50) = (SELECT GridName FROM UI_DynamicDataGrids WHERE GridID RAISERROR('The DynamicDataGrid "%s" has no columns assigned.', 16, END varchar(150) = (SELECT TOP 1 SourceTableOrViewName FROM UI_DynamicDataGrids WHERE GridID nvarchar(max) 110 Version 2016

111 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide = 'SELECT ' + ', ''Summary for the Area: ''+ [WellName]+ '' on '' + CONVERT(VARCHAR(12),[Date],113) As ibutton FROM ' + ' ' + 'WHERE DaysBack = ' + CAST(@DaysBack AS varchar(5)) + ' AND [Type] IN (''Asset'', ''Area'', ''Run'') ORDER BY CASE WHEN [Type] = ''Asset'' THEN 1 WHEN [Type] = ''Area'' THEN 2 WHEN [Type] = ''Run'' THEN 3 ELSE 4 END' EXEC (@DynamicQuery) END /****** Object: StoredProcedure [dbo].[getweeklysummarydatamobile]******/ SET ANSI_NULLS ON GO SET QUOTED_IDENTIFIER ON GO -- ============================================= -- Description: Pulls the data for the -- Weekly report for SmartGlance ============================================= CREATE PROCEDURE [dbo].[getweeklysummarydatamobile] AS Version

112 Appendix BEGIN int = 4 int = 6 nvarchar(max) = '' nvarchar(max) ='' --Build ColumnList varchar(150) = '' varchar(150) = '' varchar(150) = (SELECT TOP 1 SourceTableOrViewName FROM UI_DynamicDataGrids WHERE GridID DECLARE cur CURSOR FOR SELECT ColumnName, Replace(Alias,'''','''''') as Alias FROM UI_DynamicDataGridColumns WHERE GridID And ColumnName <> 'Date' ORDER BY OrderInDataGrid OPEN cur FETCH NEXT FROM WHILE (@@FETCH_STATUS = 0) BEGIN --Identify the data column type to perform aggregation 112 Version 2016

113 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide = (SELECT t.name from sys.columns As c Join sys.types as t on c.user_type_id = t.user_type_id where and c.name IF (@ColumnType = 'int' = 'decimal' ='real') + 'ROUND(SUM(' + '),2) as ''' + ''', ' ELSE + '[' + '] as ' + ',' FETCH NEXT FROM END CLOSE cur DEALLOCATE cur --Ensure there are columns to build the dynamic query from IF (LEN(@ColumnList) = 0) BEGIN varchar(50) = (SELECT GridName FROM UI_DynamicDataGrids WHERE GridID RAISERROR('The DynamicDataGrid "%s" has no columns assigned.', 16, END nvarchar(max) = 'SELECT ' + ' CONVERT(VARCHAR(12),GETDATE()-7,113) AS ''Start Date'', CONVERT(VARCHAR(12),GETDATE(),113) AS ''End Date'', ''Weekly Summary for the Area: ''+ [WellName]+ '' from ''+ CONVERT(VARCHAR(12),GETDATE()-7,113) + ''to ''+ CONVERT(VARCHAR(12),GETDATE(),113) As ibutton FROM ' + ' ' + Version

114 Appendix 'WHERE [RowType] IN (''Asset'', ''Area'', ''Run'', ''LifeType'') AND Date between GETDATE()-7 and GETDATE() GROUP BY WellName, RowType ORDER BY CASE WHEN [RowType] = ''Asset'' THEN 1 WHEN [RowType] = ''Area'' THEN 2 WHEN [RowType] = ''Run'' THEN 3 WHEN [RowType] = ''LiftType'' THEN 4 ELSE 5 END' EXEC (@DynamicQuery) END /****** Object: StoredProcedure [dbo].[getdailyefmdatamobile]******/ SET ANSI_NULLS ON GO SET QUOTED_IDENTIFIER ON GO -- ============================================= -- Description: Pulls the data for the -- Daily EFM page's main grid ============================================= CREATE PROCEDURE [dbo].[getdailyefmdatamobile] AS BEGIN 114 Version 2016

115 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide SET NOCOUNT ON; int = 13 nvarchar(50) = N'MTR0027' varchar(max) = '' table ( ColumnName varchar(150) ) --SET the first column as Date and Time = 'CONVERT(VARCHAR(12),[' + (SELECT DISTINCT ColumnName FROM UI_DynamicDataGridColumns WHERE GridID AND ColumnName = 'RecordTime')+ '], 113) as DateTime, ' --Get Visible Grid Columns INSERT SELECT ColumnName FROM UI_DynamicDataGridColumns WHERE GridID AND ColumnName <> 'RecordTime' ORDER BY OrderInDataGrid --Build ColumnList varchar(150) = '' DECLARE cur CURSOR FOR SELECT DISTINCT ColumnName OPEN cur FETCH NEXT FROM cur WHILE (@@FETCH_STATUS = 0) Version

116 Appendix BEGIN + '[' + '],' FETCH NEXT FROM cur END CLOSE cur DEALLOCATE cur = SUBSTRING(@ColumnList, 0, LEN(@ColumnList))--Trim the trailing comma --Ensure there are columns to build the dynamic query from IF (LEN(@ColumnList) = 0) BEGIN varchar(50) = (SELECT GridName FROM UI_DynamicDataGrids WHERE GridID RAISERROR('The DynamicDataGrid "%s" has no columns assigned.', 16, END --Build Dynamic Query & return results varchar(150) = (SELECT TOP 1 SourceTableOrViewName FROM UI_DynamicDataGrids WHERE GridID varchar(max) = 'WITH tmp AS ( SELECT ' + ', RecordTime, e.wellname as WellName, Row_Number() OVER (PARTITION BY MeterID, RecordTime ORDER BY UpdateTime DESC) R 116 Version 2016

117 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide FROM ' + ' d, ConfigWell e WHERE MeterID = ''' + ''' and d.meterid = e.meter1 and RecordTime > GetDate() - 90 and RecordInterval = ''1440'' ) SELECT ' + ', WellName, ''Daily EFM for the Area: ''+ [WellName]+ '' on '' + CONVERT(VARCHAR(12),[RecordTime],113) As ibutton FROM tmp WHERE R = 1 ORDER BY RecordTime DESC' EXEC (@DynamicQuery) END /****** Object: StoredProcedure [dbo].[gethourlyefmdatamobile]******/ SET ANSI_NULLS ON GO SET QUOTED_IDENTIFIER ON GO -- ============================================= -- Description: Pulls the data for the -- Hourly EFM page's main grid ============================================= CREATE PROCEDURE [dbo].[gethourlyefmdatamobile] AS BEGIN SET NOCOUNT ON; int = 14 nvarchar(50) = N'MTR0027' Version

118 Appendix varchar(max) = '' table ( ColumnName varchar(150) ) --Set the first column as Date and Time = 'CONVERT(VARCHAR(20),[' + (SELECT DISTINCT ColumnName FROM UI_DynamicDataGridColumns WHERE GridID AND ColumnName = 'RecordTime')+ '],113) As RecordTime, ' --Get Visible Grid Columns INSERT SELECT ColumnName FROM UI_DynamicDataGridColumns WHERE GridID AND ColumnName <> 'RecordTime' ORDER BY OrderInDataGrid --and ColumnName in ('FlowMinutes','StaticPressure','Temperature') --Build ColumnList varchar(150) = '' DECLARE cur CURSOR FOR SELECT DISTINCT ColumnName OPEN cur FETCH NEXT FROM cur WHILE (@@FETCH_STATUS = 0) BEGIN + '[' + '],' FETCH NEXT FROM cur END CLOSE cur 118 Version 2016

119 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide DEALLOCATE cur = SUBSTRING(@ColumnList, 0, LEN(@ColumnList))--Trim the trailing comma --Ensure there are columns to build the dynamic query from IF (LEN(@ColumnList) = 0) BEGIN varchar(50) = (SELECT GridName FROM UI_DynamicDataGrids WHERE GridID RAISERROR('The DynamicDataGrid "%s" has no columns assigned.', 16, END --Build Dynamic Query & return results varchar(150) = (SELECT TOP 1 SourceTableOrViewName FROM UI_DynamicDataGrids WHERE GridID varchar(max) = 'WITH tmp AS ( SELECT ' + ', e.wellname as WellName, Row_Number() OVER (PARTITION BY MeterID, RecordTime ORDER BY UpdateTime DESC) R FROM ' + ' d, ConfigWell e WHERE MeterID = ''' + ''' and d.meterid = e.meter1 and RecordTime > GetDate() - 14 and RecordInterval = ''60'' ) SELECT ' + ', WellName, ''Hourly EFM for the Area: ''+ [WellName]+ '' at '' + CONVERT(VARCHAR(20),[RecordTime],113) As ibutton FROM tmp WHERE R = 1 ORDER BY RecordTime DESC' Version

120 Appendix EXEC END /****** Object: StoredProcedure [dbo].[getcommfailuresdatamobile]******/ SET ANSI_NULLS ON GO SET QUOTED_IDENTIFIER ON GO -- ============================================= -- Description: Pulls the Communication Failure data for the ============================================= CREATE PROCEDURE [dbo].[getcommfailuresdatamobile] AS BEGIN SET NOCOUNT ON; int = 12 varchar(max) = '' --Build ColumnList varchar(150) = '' varchar(150) = '' varchar(50) = '' 120 Version 2016

121 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide --Set the First Column as Area/Location + '[' + (SELECT DISTINCT ColumnName FROM UI_DynamicDataGridColumns WHERE GridID AND ColumnName = 'Name')+ '],' varchar(150) = (SELECT TOP 1 SourceTableOrViewName FROM UI_DynamicDataGrids WHERE GridID DECLARE cur CURSOR FOR SELECT ColumnName, Replace(Alias,'''','''''') as alias FROM UI_DynamicDataGridColumns WHERE GridID and ColumnName <> 'Name' ORDER BY OrderInDataGrid OPEN cur FETCH NEXT FROM WHILE (@@FETCH_STATUS = 0) BEGIN --Identify the data column type = (SELECT t.name from sys.columns As c Join sys.types as t on c.user_type_id = t.user_type_id where and c.name IF (@ColumnType = 'datetime') + ' +'],113) AS ''' + ''', ' ELSE + '[' + '] AS ''' + ''',' FETCH NEXT FROM END CLOSE cur DEALLOCATE cur Version

122 Appendix = SUBSTRING(@ColumnList, 0, LEN(@ColumnList))--Trim the trailing comma --Ensure there are columns to build the dynamic query from IF (LEN(@ColumnList) = 0) BEGIN varchar(50) = (SELECT GridName FROM UI_DynamicDataGrids WHERE GridID RAISERROR('The DynamicDataGrid "%s" has no columns assigned.', 16, END --Build Dynamic Query & return results varchar(max) = 'SELECT ' + ', ''Communication Failure Details for the Area: ''+ Name As ibutton FROM ' + ' ' + 'ORDER BY [Name] ASC' EXEC (@DynamicQuery) END /****** Object: StoredProcedure [dbo].[getefmexceptionsdatamobile]******/ SET ANSI_NULLS ON GO SET QUOTED_IDENTIFIER ON GO -- ============================================= -- Description: Pulls the EFM Exceptions data ============================================= 122 Version 2016

123 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide CREATE PROCEDURE [dbo].[getefmexceptionsdatamobile] AS BEGIN SET NOCOUNT ON; int = 10 varchar(max) = '' --Build ColumnList varchar(150) = '' varchar(150) = '' varchar(150) = '' varchar(150) = (SELECT TOP 1 SourceTableOrViewName FROM UI_DynamicDataGrids WHERE GridID DECLARE cur CURSOR FOR SELECT ColumnName, Replace(Alias,'''','''''') as alias FROM UI_DynamicDataGridColumns WHERE GridID ORDER BY OrderInDataGrid OPEN cur FETCH NEXT FROM WHILE (@@FETCH_STATUS = 0) BEGIN --Identify the data column type Version

124 Appendix = (SELECT t.name from sys.columns As c Join sys.types as t on c.user_type_id = t.user_type_id where and c.name IF (@ColumnType = 'datetime') + ' +'],113) AS + ''', ' ELSE + '[' + '] AS ''' + ''',' FETCH NEXT FROM END CLOSE cur DEALLOCATE cur = SUBSTRING(@ColumnList, 0, LEN(@ColumnList))--Trim the trailing comma --Ensure there are columns to build the dynamic query from IF (LEN(@ColumnList) = 0) BEGIN varchar(50) = (SELECT GridName FROM UI_DynamicDataGrids WHERE GridID RAISERROR('The DynamicDataGrid "%s" has no columns assigned.', 16, END --Build Dynamic Query & return results varchar(max) = 'SELECT ' + ', ''EFM Exceptions Details for the Area: ''+ [WellName] As ibutton FROM ' + ' ' + 'WHERE 124 Version 2016

125 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide Meter1Status = ''Active''' --AND (EFMDateTime <= dateadd(dd, -2, getdate()) or EFMDatetime is null)' -- Commented to get EFM Data always EXEC (@DynamicQuery) END /****** Object: StoredProcedure [dbo].[getlowbatteriesdatamobile]******/ SET ANSI_NULLS ON GO SET QUOTED_IDENTIFIER ON GO -- ============================================= -- Description: Pulls the Low Batteries data ============================================= CREATE PROCEDURE [dbo].[getlowbatteriesdatamobile] AS BEGIN SET NOCOUNT ON; int = 11 varchar(max) = '' --Build ColumnList varchar(150) = '' varchar(150) Version

126 Appendix = '' varchar(150) = '' --Get the Source Table varchar(150) = (SELECT TOP 1 SourceTableOrViewName FROM UI_DynamicDataGrids WHERE GridID DECLARE cur CURSOR FOR SELECT ColumnName, Replace(Alias,'''','''''') as alias FROM UI_DynamicDataGridColumns WHERE GridID ORDER BY OrderInDataGrid OPEN cur FETCH NEXT FROM WHILE (@@FETCH_STATUS = 0) BEGIN = (SELECT t.name from sys.columns As c Join sys.types as t on c.user_type_id = t.user_type_id where and c.name IF (@ColumnType = 'datetime') + ' +'],113) AS ''' + ''', ' ELSE + '[' + '] AS ''' + ''',' FETCH NEXT FROM END CLOSE cur DEALLOCATE cur 126 Version 2016

127 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide = SUBSTRING(@ColumnList, 0, LEN(@ColumnList))--Trim the trailing comma --Ensure there are columns to build the dynamic query from IF (LEN(@ColumnList) = 0) BEGIN varchar(50) = (SELECT GridName FROM UI_DynamicDataGrids WHERE GridID RAISERROR('The DynamicDataGrid "%s" has no columns assigned.', 16, END --Build Dynamic Query & return results varchar(max) = 'SELECT ' + ', ''Low Battery Details for the Area: ''+ Name As ibutton FROM ' + ' ' + 'ORDER BY [Name] ASC' EXEC (@DynamicQuery) END Software Asset Manager These queries are designed for use with Software Asset Manager (SAM) v1.0. Version

128 Appendix SLSProductInstalledMain view This query of the SLS database shows the list of products installed on various computers. 128 Version 2016

129 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide SLSInstalledPatchesInfo view This query of the SLS database shows the list of patches installed on various computers. SLSLicenseMain view This query of the SLS database shows the list of licenses found on various computers. SmartGlance MRC and Microsoft SharePoint 2010 SmartGlance MRC and Microsoft SharePoint 2010 use the same port number by default. So, if you are installing SmartGlance MRC on a computer that has Microsoft SharePoint 2010 installed, be sure that SmartGlance MRC 2016 is installed on a port number other than 80. Version

130 Appendix Verify the service endpoint To verify the service endpoints are installed and configured correctly To verify that the Data Report Configuration service is working, type the following endpoint address on the computer where SmartGlance MRC is installed: where [port] is the Window Service Port that you specified during SmartGlance MRC installation. If the Data Report Config service component is running without issues, this page displays: To verify that the DB Provider service is working, type the following endpoint address on the computer where SmartGlance MRC is installed: where [port] is the Window Service Port that you specified during SmartGlance MRC installation. 130 Version 2016

131 Appendix Wonderware SmartGlance Mobile Reporting Connector Guide If the DB service component is running without issues, this page displays: Backup and restore SmartGlance MRC configuration data You can back up the SmartGlance MRC configuration data so that it can be restored on the same computer or another computer. To backup the SmartGlance MRC configuration 1. Open the SSMS 2012 with the Network Service account using the PSTools. a. Open the command prompt as an administrator. b. Browse to the PSTools folder in your computer and execute "psexec -i -u "NT AUTHORITY\NETWORK SERVICE" Ssms.exe ". The SSMS dialog box appears. 2. In the SSMS, use Windows Authentication to connect to the LocalDB instance. 3. Select the Server Name as "(localdb)\mrclocaldbinstance" and then click Connect. You can now see the MRCLocalDB. 4. Right-click the SmartGlance MRC database. The shortcut menu opens. 5. Click Tasks and then click Back up. 6. Under the Destination section, click Add. The Select BackUp Destination dialog box appears. 7. Select the location and filename for the backup and then click OK. A confirmation dialog box appears. 8. Click OK and then copy the backup file into the destination environment. To restore the SmartGlance MRC configuration 1. Close all the SmartGlance MRC applications including the Wonderware SmartGlance Mobile Reporting Connector Service, on the computer on which backup is to be restored. Version