Building Automation Knowledge Base

Issue TGML Graphic worked without error in EcoStruxure Building Operation 2.0 WebStation. After an upgrade to 3.0, WebStation displays one of the following errors on page load: Script error in DocumentLoadEvent (Component_Name) Refused to evaluate a string as JavaScript because 'unsafe-eval' is not an allowed source of script in the following Content Security Policy directive: "script-src 'self' blob: 'unsafe-inline'". Do you want to continue running this script? This site says... Script error in DocumentLoadEvent (Component_Name) Blocked by Content Security Policy Do you want to continue running this script? Script error in DocumentLoadEvent (Component_Name) call to eval() blocked by CSP Do you want to continue running this script? Product Line EcoStruxure Building Operation Environment Building Operation 3.0 TGML Graphics Cause A new security setting in 3.0 disallows eval() statements by default in TGML JavaScripts presented in WebStation. An eval() statement executes a string of characters as code, which can open security vulnerabilities if enabled, something akin to a SQL injection or cross-site scripting attack. If graphics were created in earlier versions and relied on eval() to execute dynamic code, the user will be notified upon opening the graphic in 3.0 WebStation. Resolution Any graphics relying on eval() to execute dynamic code should have their JavaScript functions rewritten to avoid use of eval(). This is the preferred approach with respect to cyber-security. Work-Around It is possible, but not recommended, to disable the new security check in WebStation TGML graphics. Within WorkStation open the Control Panel Go to Security Settings Check the box for "Enable WebStation to use unsafe string evaluated JavaScript methods like 'eval' For more information, see Web Help article: Enabling WebStation to Use Unsafe JavaScript Methods. For the latest solution to this issue please refer to: Cannot Open Graphics in WebStation 

Issue Need to know if various AS-B footprints and their databases are interchangeable.  Product Line EcoStruxure Building Operation Environment Building Operation Automation Server Bundled Building Operation Automation Server Bundled (AS-B-24) Building Operation Automation Server Bundled (AS-B-24-L) Building Operation Automation Server Bundled (AS-B-24-H) Building Operation Automation Server Bundled (AS-B-36) Building Operation Automation Server Bundled (AS-B-36-L) Building Operation Automation Server Bundled (AS-B-36-H) Building Operation Automation Server Bundled (AS-B-24-P) Building Operation Automation Server Bundled (AS-B-24H-P) Building Operation Automation Server Bundled (AS-B-36-P) Building Operation Automation Server Bundled (AS-B-36H-P Cause There are several different footprints and versions of the AS-B hardware. This can cause confusion on whether these servers are interchangeable. Below are a few example scenarios:   Can an AS-B-24 be replaced with an AS-B-24-L? Can a backup from and AS-B-36-L be restored into an AS-B-24? Can a backup from and AS-B-24-L be restored into an AS-B-36-L? Can a backup from an AS-B-24 be restored into an AS-B-24-H or an AS-B-24-P or an AS-B-24H-P? Can a backup from an AS-B-36 be restored into an AS-B-36-H or an AS-B-36-P or an AS-B-36H-P?  Resolution The answer to 1, 2, and 3 of the above scenarios is "No". The various AS-B hardware ARE NOT INTERCHANGEABLE. Backup sets can only be restored from one AS-B to another AS-B of the EXACT SAME HARDWARE TYPE. If an import of one type of AS-B into an AS-B of a different hardware type is attempted, the error below will be encountered.    The answer to 4 and 5 of the above scenarios is "yes". Whether the AS-P has HOA switches or not or is a scalable type, does not change the backup.  

Issue Support for OPC or DDE integration with EcoStruxure Building Operation Product Line EcoStruxure Building Operation Environment Building Operation Enterprise Server Building Operation Automation Server Premium Cause The OPC Server is a software program that converts hardware communication protocol into the OPC protocol. The OPC client software is any program that needs to connect to the hardware. The OPC client uses the OPC server to get data from or send commands to the hardware. Resolution Neither the OPC server nor the DDE configuration is supported at this time. There is not currently a roadmap for direct OPC client or server capability within the EcoStruxure Building Operation. To avoid problems with OPC Integration (and lose a project), there are two options for OPC integeration: It is possibe to use a converter to convert OPC to/from one of EBO supported protocols.  For example, use a 3rd party software to translate all the OPC points into BACnet Objects, “OPC Server -> BACnet Server”, or translate all EBO BACnet points to OPC. Perhaps one of the software programs below will be of benefit. Take into consideration what specifically will the ES be doing. If it is exchanging point values then it should work fine. Kepware Matrikon SCADA engine Note: These are 3rd party products that are not supported by Shneider Electric.    Use a SmartConnector Extension to be a middleware between EBO and OPC cilent or server. Check available extenstions at Exchange shop and SmartConnector Server and refer to EBO SmartDriver and Smart Connector KB article for more information.

  Issue Is it possible to use the RP-C relays to control LED Light?  The specification sheet does not specify the maximum inrush current. Product Line EcoStruxure Building Operation Environment Building Operation Room Controller (RPC) 24 V Building Operation Room Controller (RPC) 230 V Cause RP-C is not designed for switching light loads, and especially not LED loads. LED loads will result in a very high inrush current and require relays that are designed for that. Furthermore, the light application often requires relays that keep the light on in case of power failures which is not the case for RP-C. Resolution The CRS light modules and the Hotel Relay modules have that type of relays and can handle peak currents up to 800A, which is typical for LED loads. If using the CRS modules is not an option for the customer another possibility is to use a contactor connected to the RP-C.

Issue How to add Basic Authentication header to SendWebRequest function in Script RESTful Web Services Product Line EcoStruxure Building Operation Environment Building Operation Enterprise Server Building Operation Enterprise Central Building Operation Automation Server Building Operation Automation Server Premium Building Operation Automation Server Bundled Cause A 3rd party web service requires basic authentication for HTTP requests to ensure that data is requested securely, otherwise, the request will be rejected with an "Authorization Error".   Resolution Basic Authentication is a type of Authorization Request Headers, which transmits credentials as user-id/ password pairs, encoded using Base64, as defined in RFC 7617 - The 'Basic' HTTP Authentication Scheme (ietf.org).  Follow the below steps to create a Basic Authentication header in Script RESTful Web Services: Combine the User ID and the Password with a colon ex. "aladdin:opensesame". Encode the resulting string in base64 using script function to base64 encode a string posted in the Community or using the online encoder as Base64 Encode and Decode - Online, ex.  "aladdin:opensesame" will be "YWxhZGRpbjpvcGVuc2VzYW1l" after Base64 encoding. Construct SendWebRequest header in the following format:  Authorization: Basic <credentials>, as below example:  Headers= "Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l"'User ID=alaadin Password=opensesame Resultstring= SendWebRequest(BaseUrl,Method,ContentType,Headers,Message) Note: Basic Authentication is not a secure method of user authentication unless used in conjunction with HTTPS/TLS, as the user ID and password are transmitted as clear text. User ID and Password are Base64 encoded but Base64 can be easily decoded.  For more information refer to Script RESTful Web Services WebHelp and Authorization - HTTP | MDN (mozilla.org)

Issue Trend charts don't display any data in Advanced Display v3 (ADv3) although the data can be seen in a trend log list  The trend charts display data normally on other WorkStation and WebStation clients. Product Line EcoStruxure Building Operation Environment Advanced Display V3 Cause The ADv3 date is incorrect, therefore the trend chart when opening shows an interval that doesn't include any data. Resolution Set the correct date and time in the ADv3:   Exit the SmartX HMI Kiosk app - Short press the power button (less than 3 seconds) Enter the password to exit the app and return to SmartX HMI Kiosk To Exit the Kiosk mode repeat the previous 2 steps. In the Home screen mode slide up and tap Settings Tap the System option Tap the option Date and Time and adjust accordingly or enable the option Automatic date and time.  

Issue Some graphics are not visible from specific WorkStations but are visible in other WorkStations or WebStation. The graphic has an orange exclamation point overlay in the system tree and the graphic has an INVALID OBJECT error with the following error description: "An unexpected error occurred when fetching type udt <alpha numeric string>. The type cannot be decoded." No Showing graph in WorkStation Product Line  EcoStruxure Building Operation Environment Building Operation WorkStation Cause This issue is due to corruption in the WorkStation cache. Note that the WorkStation cache is NOT cleared when WorkStation is uninstalled, it needs to be manually removed. Resolution Uninstall ALL versions of WorkStation on the PC Navigate to: %AppData%\Schneider Electric EcoStruxure\Building Operation\ Delete the WorkStation folder Re-install WorkStation and open the graphics again.          

Issue “Invalid certificate for https communication” alarm pops up after upgrading to EBO 4.0     Product Line EcoStruxure Building Operation Environment EcoStruxure Building Operation Cause "Invalid certificate settings for Server to Server communication" is set to enabled (Generate Alarm) by default for new installations/upgrades. This function was deliberately designed to alert existing installations that their sites might be subject to security-related issues, and necessary action needs to be taken. Resolution If users want to get rid of this alarm, they need to: Suppress the alarm by unchecking the “Generate alarm” under Security Settings/ Invalid certificate settings for server to server communication   Or Replace the server certificates with one that can be validated against a CA certificate.   Note: Please refer to the following web pages for more information. CA Certificate Management Security Settings – Control Panel  SSL Certificates 

Issue Unable to login to Webstation when it is embedded in an iframe on a webpage even though the security setting Enable WebStation to be embedded into another website is set. Clicking Log on after entering credentials just makes the login page reload. Security Setting "Enable WebStation to be embedded into another website" security setting   Webstation login page in iframe Webstation might even go into a login loop if the Guest account is activated and Webstation logs in automatically to this account: Product Line EcoStruxure Building Operation Environment Building Operation Enterprise Server Building Operation Enterprise Central Building Operation Webstation Building Operation Automation Server Building Operation Automation Server Premium Building Operation Automation Server Bundled Cause The Webstation login functionality relies on HTTPS redirect to function properly when it is embedded in an iframe. Error message in the browser developer tool console says: Blocked autofocusing on a <input> element in a cross-origin subframe. Resolution Webstation needs to redirect web clients to HTTPS. There is a setting in Security Manager that controls this. Follow the steps below to activate the redirect: Login to Workstation and go to Control Panel and then Security Settings. Check Redirect web clients to HTTPS and save the change.

Issue WorkStation will play audible alarms but the same alarms will not play in WebStation Product Line EcoStruxure Building Operation Environment Building Operation WebStation   Cause Alarms can be viewed in WebStation but they do not have audible alarm sounds.  Resolution Audible alarms are available in WebStation from 3.2 onward.   See online help topic: WebStation and WorkStation Differences - EcoStruxure WebHelp

Issue Users or engineers may be unsure of how to access the best support for issues with EBO Smart Connectors, especially where site specific Smart Connectors have been developed, or believe the issue is with the underlying framework. Product Line EcoStruxure Building Operation Environment Integration Cause Unlike EBO, which is a standard EcoStruxure product that falls under normal R&D, the Smart Connector (formerly known as Mongoose) was developed by Schneider Electric Buildings Labs and a separate R&D Team.   Resolution If using a Smart Connector developed specifically for a project by a separate Integration Team within Schneider-Electric, then it is always best to go back to that team with your technical issues. In all other cases, the Smart Connector Framework is now supported via normal Product Support channels by raising a support case with your local Customer Care Centre, just as you would for any other EcoStruxure Issue.   The  SmartConnector Developer Forum: can still also still be found on the community.  

Issue Numbers are rounded. Why two values of nearly equal magnitude are subtracted, significant digits are lost.  This occurs in a variety of places within EcoStruxure Buildings Operation, and explained using a script program in the example below. Product Line Ecostruxure Building Operation Environment Building Operation Enterprise Server Building Operation Automation Server Cause In a string program and the NumToStr function, if a number (example 5.7) is entered and Save is selected, then the Value in the Variables window at the bottom shows 5.6999998. The value is altered from the original. Resolution When looking at a value in the watch window or variables view, there is no rounding so you are going to see the full length of the float number which suffers from a thing called “loss of significance” More information on float numbers can be found at: https://en.wikipedia.org/wiki/Loss_of_significance This phenomenon happens everywhere. An alternative would be to add a formatting feature to do the rounding. Script handles numbers as IEEE754 single precision floats, so the accuracy is limited to (IIRC) seven significant digits. The accuracy loss starts around 1.677E7. On www.binaryconvert.com/convert_float.html?decimal site, a decimal number can be converted to binary and then back to decimal in order to see how the decimal number will be handled in Script. Script handles numbers as IEEE754 single precision floats, so the accuracy is limited to (IIRC) seven significant digits.   The accuracy loss starts around 1.677E7.   On this site you can convert a decimal number to binary and then back to decimal in order to see how the decimal number will be handled in Script. http://www.binaryconvert.com/convert_float.html?decimal

Issue Site upgrading ES from 3.2.1.630 to 3.2.3.59. After the upgrade, some graphics and custom types are missing Before Upgrade: EBO 3.2.1.630   After upgrading to EBO 3.2.3.59   Product Line EcoStruxure Building Operation Environment Building Operation Workstation Building Operation Enterprise Server Cause Error "is not defined in the target version, discarding object ~ " is found in the upgrade log. Resolution This video demonstrates the steps to upgrade ES successfully displaying all Graphics and Custom types Upgraded ES from 3.2.1.630 to 3.2.3.59 Graphics and custom types were missing Used CP11 3.2.3.1300 to upgrade Successful upgrade showing all Graphics and Custom Types When upgrading within the same version (from 3.2.1 to 3.2.3) we must use a hotfix. We shouldn’t be using the Full installer since the work folder and original folder is the same.

Issue If an application hangs or crashes, Windows systems are sluggish or have problems, or new software fails to install properly one of the first places to look for information on what may be happening is the Windows Event Log. Product Support personnel may ask to see a copy of the Windows Event Log. Product Line TAC INET, TAC Vista, Andover Continuum, Satchwell MicroNet, Satchwell Sigma, TAC IA Series, Field Devices, EcoStruxure Building Operation, Other, EcoStruxure Building Expert, Access Expert, Security Expert Environment Windows Operating System Cause If an application hangs or crashes, Windows systems are sluggish or have problems, or new software fails to install properly one of the first places to look for information on what may be happening is the Windows Event Log. Resolution   Open the Event viewer by one of the ways below: Start Event Viewer by pressing Windows key + R to open the Run dialog box and type eventvwr. Right-Click on "This PC" and select "Manage" then navigate to Computer Management (Local) > System Tools > Event Viewer. Select the type of logs the need to be exported. Application, Security, and System logs in the Windows Logs and Schneider Electric Security Expert logs under Applications and Services Logs (for Security Expert cases) are required.  For each log, view recent messages then click the "Action" menu and select "Save All Events As". Enter the log name, include the log type (Application, Security, or System) in the log name, and location the click "Save". For non-English Windows, make sure to select English (United States) in "Display information" then click OK. 

Issue The WorkPlace Tech application drawing contains a hardware tag that is outlined in red and displays this error message when viewing the right-click Display Errors option for the tag Product Line TAC IA Series, EcoStruxure Building Operation Environment I/A Series WorkPlace Tech Building Operation Workstation (WorkPlace Tech Editor) Microsoft Visio Cause The issue may be caused by incorrect copying and pasting of objects inside or between drawings.  An absolute cause has not been determined  Resolution Open the application in WorkPlace Tech or Editor.  Don't open the .vsd or .vsdx file in Visio alone. Enable the Developer in the Visio ribbon. File/Options/Customize Ribbon/check "Developer"  The Developer must be enabled to have the Show ShapeSheet option available  Right-click the Input object and select Show ShapeSheet In the ShapeSheet:  Step 1. Select the corrupted string for the Connection Points Step 2. Delete the string Step 3. Click the green check mark to save Unlink and Relink the connector between the previously corrupt object, UI01 in this case, and the Analog Input object.  Note, that this could be a Binary Input object as well.  This will add the correct string to the Connection Points.  

Issue Unable to use the “Contact Open” nor the “Battery Low” statuses of a SED-WDC-G-5045 on EBO.   Product Line EcoStruxure Building Operation Environment Building Operation Workstation Building Operation Automation Server Premium Cause The SED-WDC-G-5045 points (Contact Open, Battery Low and others) are not exposed individually but in a string of 10 points, bit 0 to bit 9.     Resolution 1. Add a: New object / Program / Script program. 2. Rename it to identify it, in this example it has been renamed Script program SED 3. Right-click on it, click on Edit, Script Editor window will open 4. Paste the below 4-lines script 5. Save 6. Change the “Type” from “Floating” to “Boolean” 7. Save 8. Close Script Editor window   Numeric input IASZone Numeric output ContactOpen, BatteryLow ContactOpen = (IASZone Bitand 2 ^ 0) > 0 BatteryLow = (IASZone Bitand 2 ^ 3) > 0       9. Right-click on “Script Program SED”, click on “Edit bindings” 10. Drag the “IAS Zone” point and drop it on the “Input / IASZone” bindingSave     12. Create a Digital Value 13. Bind it to the Contact Status point from the” Script Program SED” output. 14. Save      

Issue When launching Workplace Tech or Workplace Tech Editor (EBO), the Workplace Tech ribbon does not appear or displays an error indicating it has not executed. Product Line TAC IA Series, EcoStruxure Building Operation Environment Building Operation Workstation (Workplace Tech Editor) I/A Series WorkPlace Tech Cause Smartware Studio 360 release 5.1.540 and later contains a 64-bit version of the Microsoft Access database.  It was modified to allow for installation with either Office 32-bit or 64-bit.  Workplace Tech and Editor requires a 32-bit version of Visio.  Microsoft normally does not allow 32-bit and 64-bit applications to be installed on the same OS.  Because of this, the COM Add-in for the Workplace Tech ribbon can fail. Resolution The Microsoft Access DataBase engine can be uninstalled in the Programs and Features of Windows.  For Studio 360 to function properly, it will need to be reinstalled.    

Issue Proper handling and preparation of existing .vsd files help eliminate the crashing and lockup of the Visio application. Product Line EcoStruxure Building Operation, TAC IA Series Environment Workplace Tech Editor EcoStruxure 1.9.x - 3.2.3 Workplace Tech 5.9.1 - 5.9.4 Visio 2013, Visio 2016 Note: This does not apply to Workplace Tech Editor EBO 2022 (and newer) and Workplace Tech 5.10.x Cause The product is affected by the version of Visio in use as well as the file size and unused objects in the drawing. Resolution When using Workplace Tech 5.9.x with Visio 2013 or 2016, the file has to be opened in "Compatibility Mode." DO NOT CONVERT. Illustration 1 While the .vsd file is open in Visio, not in Workplace Tech, use the "Reduce File Size" option and select the boxes in Illustrations 1&2. Illustration 2 In Visio 2016, after opening the "Inspect Diagram," (Illustration 3), select the first 3 boxes in the "Reduce File Size" option (Illustration 4). Illustration 3 Illustration 4 Save the file for use in the Workplace Tech Project or to be imported into your AS-P as a .vsd. Add the "cleaned" file to your project or import it to Workplace Tech Editor. Make sure the Visio 2013 or 2016 is at the most recent version and build. You can find this under the file/account/About Visio. If Version 1802 is available in your Microsoft Office update Channel, use it. Version 1801 was used in testing. For Visio 2013 Build 15.0.4971.1000 MSO 15.0.5007.1000 was tested (Illustration 5) Illustration 5

Issue Need to upgrade sites with Report Server to EBO 2022 or higher. Product Line EcoStruxure Building Operation Environment Building Operation Enterprise Server Building Operation Enterprise Central Building Operation Report Server Building Operation Timescale Database Cause WebReports/Report Server isn’t supported in EBO 2022 (V4.0) or higher. Resolution Since WebReports/Report Server isn’t supported in EBO 2022 (V4.0) or higher, there is a Data Migration Assistant (DMA) tool available which read data from a WebReports 3.x and write it to External Log Storage. You use External Log Storage feature to store historical data from EcoStruxure BMS. The amount of stored data is limited only by the equipment you use, and not by the capacities of the feature.  When the External Log Storage feature is activated and configured, WorkStation and WebStation display the historical data in the event and trend views from the External Log Storage. Any server in the system can be configured to write historical data to the TimescaleDB database.   Data Migration Assistant (DMA) Tool can be downloaded from here. License required: External Log Storage requires license, refer to Software and Features that Require Licenses and Part Number Summary and Hardware Software Matrix  Hardware and Software requirement for External Log Storage: Ensure that the hardware and software requirements for TimescaleDB (www.timescale.com) and PostgreSQL (www.postgresql.org) are met. High-performance SSD storage is required and additional CPU/RAM capacity is required for larger EcoStruxure BMSs. As an example, at least 64 GB of RAM is recommended for systems with 100 EcoStruxure BMS servers. Refer to: Information Technology System Planning Guide (se.com) Merging Log data: External Log Storage decreases the amount of extended trend logs retained on the EcoStruxure BMS servers. You can merge log data from an extended trend log to the source log in External Log Storage. For more information, see Merging of Trend Log Data. Enhanced Reporting (XLSX Report Templates): The EcoStruxure BMS servers (3.2 or higher) provide built-in functionality for basic reporting that can deliver reports in any text format and XLSX, without any dependencies to other external software. Reports for XLSX can be enriched by using advanced functionality such as formulas, conditional formatting, charts and sparklines. If External Log Storage is configured and connected (PostgreSQL/TimescaleDB), then historical report data can be fetched from there. Refer to: Examples for the new native EBO Notification Reports - Communities (se.com)  

Issue Is it possible to edit a document object like a text file from WebStation? Product Line EcoStruxure Building Operation Environment Building Operation WebStation Cause From WebStation, it is only possible to view a document. Resolution No it is not possible to change a document object from WebStation.   For other differences between WorkStation and WebStation, see the online help topic WebStation and WorkStation Differences