Building Automation Knowledge Base

Issue How to add Web Service and create SOAP Web Service with Graphic Product Line EcoStruxure Building Operation Environment StruxureWare Building Operation site with release 1.2 or later Cause What are Web Services and how to add to my existing StruxureWare Building Operation site. How to add SOAP Web Service files and how to add to a project or site How to create values from SOAP Web Service Files How to add values to graphic that uses the values from SOAP Web Service Resolution Wikipedia: A Web Service is a method of communication between two electronic devices over the web (internet). W3C: A "Web Service" as "a software system designed to support interoperable machine-to-machine interaction over a network." Web Services: are hardware, programming language, and operating system independent Applications written in different programming languages and running on different platforms can seamlessly exchange data over intranet or the internet using Web Services Web Service interfaces are supported in both the AS and ES(does not support connection over a ProxyServer) Like BACnet, Lon, and Modbus, you can create a Web Service interface. EWS Interface - EcoStruxure Web Services Script Web Service - Generic Consume via Script (Web Service addition Script Web Service) Simple XML Web Service - Rest Generic Consume via Binding Tool (Web Service addition Simple XML Web Service) SOAP Web Service - SOAP Generic Consume via Binding Tool This article explains adding Sunrise and Sunset for a particular location data using SOAP Web Service: Select New > Interface > Web Service > SOAP Web Service Next Paste the URL which has the SOAP Web Service feature ((to find sunset/sunrise for your area, Google WSDL data) and location coordinates Get Operations button pulls in the data. Select Next  which shows the values and times and then select Create Create values by highlighting SOAP Web Service then File > New > Value Choose Next and highlight the specific for the values then select Create Here are the SOAP Web Service sunrise/sunset values If desired, Bind those values to a graphic Lastly for SOAP Web Service a graphic is created and the values which come from the SOAP Web Service are place on the page

Issue Sometimes just looking at the error message you get from e.g. TAC Vista or SmartStruxure when you try to send an email and it fails can lack information. Product Line EcoStruxure Building Operation, TAC Vista Environment TAC Vista SmartStruxure WireShark Cause It is not necessarily all SMTP error messages and their explanation that are implemented in the software. Resolution For general information on WireShark usage read Using WireShark to analyse communications on an Ethernet network. If McAfee antivirus with HIPS is installed on the PC, use RawCap to capture the communication, as you will not see traffic originating from your PC online in WireShark. Additional reference for this article: Enhanced SMTP status codes   First of all when working with WireShark logs, it's a good idea to filter and focus the communication type you want to look at. In this case it's SMTP, so simply type smtp in the display filter and hit enter.   The easiest way to isolate a single smtp "conversation" between client and server, is to find one of the packets in the conversation, and in the "Analyze" menu click on "Follow TCP Stream".   This will give you the complete conversation in a separate window.   When you have used "Follow TCP Stream" be sure to set the display filter to "smtp" again when closing the window.   This is what happens if authentication is needed by the SMTP server but the client is not using authentication.   Here is the same attempt to send an email, but this time the client has enabled authentication   A little trick when using authentication is that WireShark can actually decrypt the Base64 encoded username and password. Simply right click on any SMTP packet, click "Protocol Preferences" and click "Decrypt AUTH parameters".   He are the packets decrypted   An error not easily detected by e.g. TAC Vista is error 535 "Incorrect authentication data". As stated in the enhanced status code table linked above, it simply means that either username, password or both is incorrect.   Though the product used may not have support for SSL and TLS, you can encounter SMTP server requiring it. Here is an example of a SMTP requesting SSL     For further info on troubleshooting sending emails from TAC Vista, please read Troubleshooting Sending Emails from a Vista Server.

Issue Device ID / Device Instance of SE8000 series BACnet controllers Duplicate BACnet Network Address alarms How to have 254 SSL Room Controllers on an Automation Server (AS) as shown in the SBO Automation Server and SE7000 and SE8000 - Architectural Guidelines Product Line EcoStruxure Building Expert, EcoStruxure Building Operation Environment Automation Server Enterprise Server SE8000 Room Controller BACnet Cause There can be confusion from the difference in naming between SmartStruxure Lite(SSL) Room Controller(RC), SmartStruxure Building Operation and even Niagara(JACE). Bacnet Instance number in SSL = Object ID in SmartStruxure Building Operation COM Address in SSL = MAC Address in SmartStruxure Building Operation Resolution On the AS, considered is the Object ID of the two Comm Ports (as with all object IDs) they need to be unique across the system. A common ID is 1001 for CommA and 1002 for CommB of the first AS, then on the second AS CommA 2001, CommB 2002 etc. The key thing with BACnet is that every object (point, device, program, port etc) must have a unique Object ID. The SE8000 uses the Com Address referred to as the BACnet MAC Address in the AS. This, as detailed in BACnet COM Address of Room Controller SE7000 and SE8000, is the address range on just that one MS/TP bus. 1 – 127 are valid addresses, the AS (or bus master) will be address 0. If a second AS is on the same system this could use 83001 – 83127 for CommA, 84001 – 84127 CommB etc. Also SE8000 uses the BACnet Instance number which is called the BACnet Object ID in the AS. (This is the ID which must be unique across the whole system) So if you have the 2 ports used on one AS all 254 devices must have unique ID’s. When changing the Comm address in the SSL SE8000 to any value between 1 and 127, the Instance number will change as well. For example Comm address 9 would result in an Instance number of 83009. These will cover 127 stats that will go on CommA, and result in Instance numbers between 83001 and 83127. Any value above 127 will keep the Instance number unchanged. For CommB however, a site would need to change the Instance number manually. For example the first RC connected to CommB would be the 128th and would default to address 83127. So it is required to manually change the Instance number to 1083001 (up to 1083127). This defines unique Comm Addresses for ComB on the remaining 127 RC. When using an Automation Server (AS) you can find the Object ID and MAC address for devices on MSTP by using WorkStation and going to AS > System > Hardware > BACnet devices > Network_xxxx. A screen shot is below with the added columns Status, System Status, Object ID, and MAC address. In this first example, b3 controllers use the Object ID or Device ID of their serial numbers so each b3 is unique across the network. B3 controllers with serial numbers greater than 4194302 (the maximum allowed Object ID in BACnet) will be assigned a Device Object ID using a hashing algorithm to ensure it is unique. From an SE8000 series RC, BACnet network set-up screen shows when BACnet is detected in models. Select desired parameter and use up or down arrow to set parameter to desired value. The default BACnet instance number is generated by the model number and COM address of the controller. For example, The instance number of a SE8300A5B00 with a COM address of 57 is generated as "83057." The default instance number appears first. To change the instance number, use number pad and press Accept and Save. Below is a screenshot of the WorkStation logged into an AS, with the BACnet Interface and the MSTP network. The added columns show the Object ID and MAC address. Below is a screen shot of the WorkStation logged into the AS, with the System > Hardware Devices > Network_xxxx. The added columns show the Object ID and MAC address.  The screen shot below is the AS > BACnet Interface > MSTP Network > Configuration Settings.

Issue "Communication Failed" Alarm occurs when Adding an AS. Source: /Server 1/Servers/ASL/System/Server Communications/Models/2deef04c-05d1-41ae-9c3f-f84a9f7e0b41 Alarm "cannot verify lead object" appears even though AS is online. Product Line EcoStruxure Building Operation Environment StruxureWare Alarm Queue Cause The AS is unable to communicate with the ES. The ES may be able to communicate with the AS allowing the user to view and control the AS, but Value Binds will not work. This type of error can also occur as a result of multiple networks being accessed by the same PC.  It is important that if you are using multiple networks that the ES be configured with the IP address for the correct network. Resolution Ensure that no Firewalls are blocking configured ES and AS ports Ensure all devices are on the same Windows Domain In workstation, select the Enterprise server's Communication Tab and verify that the IP address listed for the ES matches the ES PC IP address. Right click on the ES and select Advanced > Repair Server Communication For more information see Creating Windows Firewall rules to allow StruxureWare Building Operation to communicate on the TCP port

Issue Send an SMS text message when an alarm occurs. Product Line EcoStruxure Building Operation Environment Alarming SMS Text Cause Sending an SMS Text message in response to an alarm condition will allow the responsible personnel to react immediately, even if they are not currently at the workstation. Resolution EcoStruxure Building Operation does not support direct SMS texting. One workaround is to use an Email to SMS Test service provider that handles conversion of emails to SMS, as emails are easily created in EcoStruxure Building Operation.   If direct SMS functionality is required there are work arounds with 3rd party programs such as SysManSMS via file output options (see Using Sysman alert server with StruxureWare Building Operation). Note that this third party products such as this are not supported or tested by Schneider Electric.

Issue Wanting to use SNMP to be able to create alarm traps from the network Product Line EcoStruxure Building Operation Environment StruxureWare Building Operation site Cause Simple Network Management Protocol (SNMP) is an "Internet-standard protocol for managing devices on IP networks. Devices that typically support SNMP include routers, switches, servers, workstations, printers, modem racks, and more. SNMP is used mostly in network management systems to monitor network-attached devices for conditions that warrant administrative attention such as an alarm in StruxureWare Building Operation.  Resolution For SNMP to be able to create alarms from the network in StruxureWare Building Operation, beginning with Building Operation 1.3 - StruxureWare Building Operation supports an older version of this service which uses the default community password. As such, the decision to open this port should be done based upon a risk/benefit assessment. The only form of SNMP that is currently supported is the ability of SmartStruxure to respond to the network management queries that might be issued by an SNMP client.  Through release 1.5, SNMP is only supervising the equipment and can not receive traps from SNMP. Beginning in the 1.6 release, you can send SNMP traps from an alarm. In future releases it may be able to export alarm traps to SNMP, but this is really an IT function. Release 1.6.1 introduces support for SNMP alarm traps v3.0 notifications. This requires an add-on option on for the corresponding server, either the Automation Server and/or Enterprise Server. Refer to Testing SNMP alarms with SmartStruxure for further help on testing SNMP in 1.6.1 version and above

Issue How to transfer data from TAC Vista to EBO(EcoStruxure Building Operation) as a temporarily solution while a transition between TAC Vista and EBO is done?    Product Line EcoStruxure Building Operation, TAC Vista Environment TAC Vista SmartStruxure Solution EcoStruxure Web Services TAC Vista SmartStruxure Interface 1.5 Cause If EBO need data from TAC Vista during a transition period the TAC Vista SmartStruxure interface can be used.   Resolution Please see the video or follow the instructions below:   On the Vista server(s) install the TAC Vista SmartStruxure Interface first. Refer to TAC Vista to SmartStruxure Interface will not connect when TAC Vista and SmartStruxure are installed on the same machine if there are any issues installing or getting the two programs to communicate when on the same PC. In StruxureWare Workstation, on the Enterprise server object or the Automation server object right click and create new interface, and select the EcoStruxure Web Service interface in Workstation. Click next. In the Server, enter the IP address of Vista server. If it is local, just use localhost. Enter the username and password of Vista Server. Pay attention that only the user in the default System user group can be used. Don't try to create other System group. And all the letters in the password field need to be in capital letters. This is a defect that will be addressed in the next release of TAC Vista to SmartStruxure interface. Please be selective with the port that you are using. If the Vista to SmartStruxure Interface program is on the same PC as the Enterprise server than a different port other than 80 or 443 will have to be used. Please refer to TAC Vista to SmartStruxure Interface will not connect when TAC Vista and SmartStruxure are installed on the same machine if the two softwares need to be on the same machine. Click Create. The next step is to Host TAC Vista objects into SmartStruxure. Refer to How to host TAC Vista objects using Web Services in StruxureWare Building Operation for the guide of how to host Vista objects into SmartStruxure. NOTE: There is a defect for Version 1.0 of TAC Vista to SmartStruxure interface under Non-English operation system. The EcoStruxure Web Services interface will not come online in SmartStruxure. Refer to TAC Vista to SmartStruxure Interface does not connect in non-English Operation System for solution.

Issue BACnet COV subscription system Product Line EcoStruxure Building Operation Environment BACnet Settings COV subscriptions v1.7 and earlier Cause A site will have a problem with the amount of traffic because of misconfigured COV Increments. The problem is that Building Operation, the  ES and AS resubscribes to values every 10 seconds and one by one. So for example: hh:mm:ss 00:00:00 Value1 00:00:10 Value2 00:00:20 Value3 00:00:30 Value4 ... 05:00:00 Value1800 If you have more than 1800 subscriptions the ES or AS is not able to do all subscriptions in 5 hours.   5 hours is used because Building Operation subscribes to the values with a lifetime of 5 hours.   Resolution BACnet COV subscription system is not influenced by the requested transfer rate in the edit bindings system (Subscriptions using BACnet). That is used in the case where the external device does not support COV, and read-property must be used instead. The design in 1.4 and 1.5 simply did not anticipate such large numbers of COV subscriptions. Workaround: 1.Exit Workstation 2. Stop the Enterprise Server Edit using notepad the server.properties file located in "C:\Program Files\Schneider Electric StruxureWare\Building Operation 1.x\Enterprise Server\etc\ Find at the bottom: # Set GenericConsume communication defaults Add the two following lines: NspServer.BACnetPlugIn.COVSubscriptionLifetime entry = 28800 NspServer.BACnetPlugIn.COVTimerPeriod entry = 5 Save your changes and close the server.properties file. This changes the default values from 5 hours to 8 hours and 10 seconds to 5 seconds. NOTE From version 1.8 the BACnet Interface manager (/Server 1/System/Interface Manager/BACnet) provides access to these settings (COV subscription lifetime (default 8 hours) and Server COV renew rate(default 5 seconds)) The settings will be controlled via the Enterprise Server if connected.

Issue Unable to discover BACnet devices from a BACnet interface, discover broadcast address and/or devices are offline after changing IP Address on AS or ES. Bacnet devices are offline after a power cycle or loss of IP connection at the AS or ES. Product Line EcoStruxure Building Operation Environment StruxureWare Building Operations site using devices configured with BACnet Cause Broadcasting on wrong network from either the Automation Server or the Enterprise Server can be a problem. In the example below an AS is broadcasting for a BACnet device (in this case a MNB Controller). In the IP Network for the BACnet Interface, check your settings for Broadcast Address. The key is to ensure your BACnet broadcast address is in the correct range.   In this first screen capture, we have a BACnet network interface using the IP Network with a red failure to communicate indicator on the MNB. In this example, the broadcast is on 192.168.1.255 Resolution The computer being used as well as the BACnet devices we want to discover and use are in the following IP network and settings: Changing the broadcast address to match what the BACnet network is using resolves the issue (BBMD and BBDT from Enterprise Server or Automation Server). Lastly, choose to discover devices For subnet calculations and how to setup your subnet addresses, several recommended calculator are SuperNet Online or SubnetMask a downloadable program from Solar Winds.  When the IP Network broadcast address is set incorrectly, a Wireshark capture may reveal that no WHO-IS message is sent out from the SmartStruxure server when a device discovery is attempted. When in doubt as to whether the 'IP Broadcast Address' is correct, a simple test is to set the IP Broadcast address to 255.255.255.255, doing so will instruct the SmartStruxure server to broadcast on ALL subnets, if the problem was caused by an incorrect broadcast address it will be resolved but care must be taken not to leave the default address set to 255.255.255.255 as this will cause unnecessary traffic on all sub-nets, instead, review your calculations for what the appropriate broadcast address should be and set it appropriately. Key Concept: The AS will retain the Broadcast address, and if moved to a new Subnet, the old Broadcast address must be updated. One can do either of the following:  Edit the IP Broadcast Address Setting  Delete the BACnet Interface and recreate in the new Subnet

Issue Instructions on how to download an .MOT file into a Xenta Programmable controller Product Line TAC Vista, EcoStruxure Building Operation Environment Xenta Programmable Controllers Xenta 280, 281, 282, 283, 300, 301, 302, 401, 401:B Download Wizard Cause To reinstall or upgrade the firmware of a Xenta programmable controller, a .MOT file must be loaded using the Download Wizard. Resolution Get the latest (or desired) .MOT version onto the PC's hard drive. Download the appropriate .MOT for the controller requiring new firmware. To find the version of firmware in a controller, see How to view the current firmware version on a Xenta controller using the RS-232 cable. Go to the The Exchange Download Center and view the MOT files Locate the proper version and controller combination in the asset title. Download the desired .MOT version   Download the .MOT file into the controller Start the Download Wizard. Note: The download wizard is installed when Menta or EcoStruxure Building Operation Workstation is installed on the machine. Start > Programs > Schneider Electric > TAC Tools X.X.X > Download Wizard (For versions prior to 5.1.4, the path will be "TAC" instead of "Schneider Electric.") Follow instructions on the Download Wizard. System Choose to Retain Current .MOT or Download new.  Typically the choice will be to download a new .MOT. Ensure the device type is correct and matches the controller and .MOT file. Browse to the .MOT file downloaded from the Buildings Business Extranet. Application Choose to Retain Current, Clear memory, or Download New.  Typically the choice will be to clear memory. This is referring to the Menta application inside the controller.  If the application is cleared, the controller will be "applicationless" and cannot be downloaded through the Vista System Plug-in.  Some Menta application will need to be loaded through a Menta direct download before the controller can function again in a network. If you choose to load a Menta application through the Download Wizard, browse to the desired .MTA file.  Configuration If the application is set to clear memory, the configuration section will be grayed out.  No selections are necessary. This refers to the network description files.  The typical selection if the option is available is to retain current. Press Apply Download status is shown in % finished.  Do not interrupt this process! When the dialog states that the download has completed, close Download Wizard.  Load a Menta application if necessary through Menta direct download. For more information on Menta Cable needed to download, see Schematic for the RS-232 cable used to direct download Menta applications and system files.

Issue Web Service addition Script Web Service Product Line EcoStruxure Building Operation Environment StruxureWare Building Operation site with release 1.2 or later Cause What are Web Services and how to add to my existing StruxureWare Building Operation site. How to add Script Web Service files and how to add to a project or site How to create values from Script Web Service Files How to add values to graphic that uses the values from Script Web Service Resolution Wikipedia: A Web Service is a method of communication between two electronic devices over the web (internet). W3C: A "Web Service" as "a software system designed to support interoperable machine-to-machine interaction over a network." Web Services: 1. are hardware, programming language, and operating system independent 2. Applications written in different programming languages and running on different platforms can seamlessly exchange data over intranet or the internet using Web Services 3. Web Service interfaces are supported in both the AS and ES 4. Like BACnet, Lon, and Modbus, you can create a Web Service interface.      EWS Interface - EcoStruxure Web Services      Script Web Service - Generic Consume via Script      Simple XML Web Service - Rest Generic Consume via Binding Tool (Web Service addition Simple XML Web Service)      SOAP Web Service - SOAP Generic Consume via Binding Tool (Web Service addition SOAP Web Service) This article explains adding Sunrise and Sunset for a particular location data using Script Web Service: -Select New...Interface...Web Service...Script Web Service This first example is for a Calculation program for Results=A+B -Enter the WSDL Service and Endpoint are auto-filled Not necessarily all the time IP Cameras -Script Web Services Interface: -Script Programs can bind to the web service with the "Webservice" declaration. -When the name bound service is typed and a "." is put after it, intellisense drop down will show the available methods WSDL file is brought into the database Drop down methods become available even if the URL of the WSDL is not -The web service capabilities can be used within the code for manipulation, data gathering, or whatever else. -Script Web Services Post and Gets -Script programs can send requests directly to a web service with the SendWebRequest keyword. -The syntax requires 5 specific arguments BaseURL - URL that will be processing the message Method - Method of processing the POST and GET (dictated by URL) Headers - Defines certain parameters that are meaningful to the URL (IsMobileApp:True;IsAndroidClient:True) Content-Type - Defined by the URL Message - What is actually being sent to the URL -Script Web Services - Considerations -Bindings to a web service require a recompile -Display of captured information will get localized   Next, Create a Script Program for Calculations Here is a simple script program which defines the calc and values The below shot is the values A=12, B=3, and the Results of the calculation. Below are the binding for the Script Calc program to the Values The below shot is the binding of the Calc program to the Script Web Service The results are a calculation in which we supply value A and B and the Script Web Service performs the calculation with results of 15.   We can change the value of A to from 12 to a value of 13 which Results in 16 as shown in the shot below.

Issue LNS plug-ins are needed in order to configure certain application specific controllers. Product Line EcoStruxure Building Operation Environment Workstation Open LNS Server Cause Many application specific controllers can be configured through Workstation but this can be very time consuming. Starting with Version 1.4.0, SmartStruxure is now able to support LNS plug-ins. Key points and features Click SBO v1.4 Activation Key for OpenLNS Server - SmartStruxure solution - PA-00285 to download the StruxureWare Building Operation v1.4 - Activation key for OpenLNS Server product announcement. Echelon OpenLNS Server must be installed on the computer that plug-ins will be used. LNS Server plug-ins can be used at the workstation to configure TAC Xenta devices using TAC STR 350 plug-in 5.1.9 or later. (earlier versions won't work) LNS Server plug-ins can be used at the workstation to configure TAC Xenta devices using TAC 100 plug-in 5.1.9 or later. (earlier versions won't work) LNS Server plug-ins can be used at the workstation to configure third party LON devices. The LNS plug-in capability will only work if the device does not require to be online to configure. If the manufacturer's plug-in requires active communication with the device then the plug-in implementation will not work. StruxureWare Building Operation database is automatically updated to any changes created with the plug-in. Resolution For LNS plug-ins to work in SmartStruxure, Echelon OpenLNS Server must be purchased and installed on the computer where plug-ins will be used. Purchasing Echelon OpenLNS Server An activation key must be purchased in order to install Echelon OpenLNS Server. The activation key is available to purchase through Schneider Electric using the part number SXWSWLNSX00001. The activation key can be purchased through standard product ordering procedures. After ordering, the activation key will be sent to you via email within a few days. Installing Echelon OpenLNS Server WARNING: You can not install OpenLNS Server on the same computer as TurboLNS without upgrading Turbo to Open. You will now be converting any TurboLNS databases to OpenLNS if they are opened on this computer. Once you have purchased the OpenLNS activation key and received it via email from Schneider Electric then you can now install Echelon OpenLNS. Double click on the executable to start the OpenLNS install wizard. Click Next. Select 'I accept the terms in the license agreement' and click Next. Fill out the information and enter you activation key. Click Next. Click Install. Click Next. Click Finish. NOTE - At step 7 above, if the PC is not connected to the internet, the registration may require an email to be send manually to Echelon to register the licence code.  Uninstalling Echelon OpenLNS Server Make sure you reference the OpenLNS Server License Guide here for information on how to return the OpenLNS license in order to use it again.   Registering LNS Plug-ins Note: Before registering LNS plug-ins, they must be installed on the computer first. If working with TAC Vista Xenta 100 and TAC STR 350 controllers, the plug-ins must be version 5.1.9 or greater. ZBuilder is included in the TAC Vista 100 download. These can be downloaded off of the Extranet in the same place as the SmartStruxure software. See LNS plugins for SmartStruxure 1.4 are not included in the release, but downloaded separately for more information. In SmartStruxure Workstation, go to the Control Panel. Click on 'LNS Plug-in Registration'. In the 'Available LNS Plug-ins' field, select the plug-ins you want to register and then click the right arrow to move to the 'Registered LNS Plug-ins" field. Click the save icon on the System tab. Note: If registering the TAC Xenta 100 plug-in, you will be prompted to select the devices you want to register. Then click OK.   Using the LNS Plug-ins Note: All changes made in the LNS plug-ins are offline configuration changes. The LNS plug-in support in SmartStruxure will not support devices that are required to be online for plug-in use.  Right click on the controller, click Configure... The LNS server is checked for a matching device template and the current device configuration is saved to the LNS server. Click Next. Double click on the plug-in listed in the window. This will launch the LNS plug-in. Make configuration changes to the controller and then save or exit the plug-in. Click Next. Click Next. The configuration changes that have been made will be listed in the window while they are being saved to the LNS server. Click Finish. Now the configuration changes that were made in the LNS server need to be downloaded to the controller. Right click on the controller in Workstation and select 'Download device configuration'.

Issue Every item shown in the Objects window of the TGML editor can be considered a Node. In the figure shown below, this relatively simple TGML page has 14 nodes. Nodes are hierarchical with parent and children nodes. One important concept when scripting in TGML is finding the desired node. Examples of this are: Changing the color of a rectangle when a bound signal is offline Writing a new value to a text box every time the database value updates Opening a new page when the user left clicks on a component Product Line EcoStruxure Building Operation, TAC Vista Environment StruxureWare Building Operation TAC Vista TGML Graphics Editor Cause Within a script, there are two functions that will pinpoint a specific node, but have very different applications. These are: getTarget() getCurrentTarget() An example function of how to use these functions is: function click(evt){ target = evt.getTarget(); } Resolution getTarget() - returns where an event is coming from getCurrentTarget() - returns the parent of the script Both examples below chart the differences between the two functions using the screen capture below. If the bind object in the figure above changes its value, here is what getTarget() and getCurrentTarget() would each return if they were a part of each script (A, B, C). Script getTarget() getCurrentTarget() A Bind Component B Bind Rectangle C Bind Bind If the user clicks on the rectangle in the figure above, here is what getTarget() and getCurrentTarget() would each return if they were a part of each script (A, B, C). Script getTarget() getCurrentTarget() A Rectangle Component B Rectangle Rectangle C N/A N/A Also check out the JavaScript Essentials - Programs and Statements Quick-Help video on the Exchange.

Issue A warning banner is displayed at the top of the Workstation window that states "A license violation has been detected." even though a valid evaluation license has been activated on the machine or site. The user will also find another warning message on the LicenseManager screen, under the System folder, that provides greater detail. This message will state specifically what is missing, for example "An additional X automation server license(s) are required. Please purchase the required licenses." Product Line EcoStruxure Building Operation Environment EBO Enterprise Server 2.X and newer EBO Workstation 2.x and newer Cause The new scalable licensing structure established in version 2.0 requires licenses for each automation server device (and field devices if the system is a new database). The evaluation (demo) license will account for the required licenses as long as it is valid but sometimes can be stuck in a state where it has not been validated.  Resolution In the majority of situations, simply rebooting or performing a warm start of the Enterprise Server will clear this warning as long as there is a valid evaluation (temporary) license hosted in the license administrator the ES is referencing. Troubleshooting Steps: Restart the Enterprise Server. Restart the License Server (if on a different machine as the ES). If required, restart the ES again. Check for any errors in the License Server and verify that the Vendor Daemon is up and running. See Unable to log into WorkStation due to license error codes -12, -15, -18 or -97 for more details around this troubleshooting step. If these steps have not resolved the issue, then open a support case with your local country support organization.  For more information about the enforcement of licenses see the EcoStruxure Building Management WebHelp article, Licensing Enforcement. 

Issue How to add Web Service and create Simple XML Web Service with Graphic Product Line EcoStruxure Building Operation Environment StruxureWare Building Operation site with release 1.2 or later Cause What are Web Services and how to add to my existing StruxureWare Building Operation site. How to add XML files and how to add to a project or site How to create values from the XML Files added How to make a graphic that uses the values from XML Service Resolution Wikipedia: A Web Service is a method of communication between two electronic devices over the web (internet). W3C: A "Web Service" as "a software system designed to support interoperable machine-to-machine interaction over a network." Web Services: Are hardware, programming language, and operating system independent Applications written in different programming languages and running on different platforms can seamlessly exchange data over intranet or the internet using Web Services Web Service interfaces are supported in both the AS and ES(does not support connection over a ProxyServer) Like BACnet, Lon, and Modbus, you can create a Web Service interface. EWS Interface - EcoStruxure Web Services Script Web Service - Generic Consume via Script (Web Service addition Script Web Service) Simple XML Web Service - Rest Generic Consume via Binding Tool SOAP Web Service - SOAP Generic Consume via Binding Tool (Web Service addition SOAP Web Service) This article explains adding Weather for a particular location data using Simple XML: Select New > Interface > Web Service > Simple XML Specify the URL for this data (to find the weather for your area, Google XML data Make changes to polling, alarm, retry interval Choose Create Now you can Create a value from that Simple XML Web Service by highlighting and select New > Value > and type of value. Select Analog for temperature, String Value for wind direction and so forth. One can add as many of the values as desired. The Simple XML List View would look like the below screen capture. Lastly for Simple XML Web Service a graphic is created and the values which come from the XML Web Service are place on the page. Also check out the SmartStruxure - Web Services - Simple XML Interface Quick-Help video on the Exchange.

Issue BACnet MSTP Wireshark capture Product Line EcoStruxure Building Operation Environment Schneider Electric StruxureWare Building Operation AS using MSTP for BACnet Cause Example of Wireshark capture and WriteProperty in MSTP    Resolution Using Wireshark, a bacapp.confirmed_service == 15 filter is applied which shows only BACnet WriteProperty packets Below is a screenshot of the Wireshark screen after applying the filter. I have Requests (REQ) and Acknowledgements (ACK) shown: Below is a Request, and clarification on what is Requested. A third party Metz (address 91) device is requested from the AS (address 0) for Analog Value 1 to be 0.00 Below is a Request, and clarification on what is Requested. A third party Metz (address 91) device is requested from the AS (address 0) for Analog Value 1 to be a value of 100.00 Filters which may be useful: Capture Filters   udp port 47808 BACnet/IP packets on UDP port 47808 udp port 47808 or udp port 47809 BACnet/IP packets on UDP port 47808 or 47809 Display Filters   bvlc || bacnet || bacapp all BACnet packets bacnet BACnet NPDU packets bacnet.mesgtyp BACnet Network Layer (router) packets bvlc BACnet/IP packets bvlc.function == 0x0b BACnet/IP Broadcast packets bacapp APDU packets bacapp.confirmed_service == 12 readProperty packets bacapp.confirmed_service==14 readPropertyMultiple bacapp.confirmed_service == 15 writeProperty packets bacapp.confirmed_service==16 writePropertyMultiple bacapp.confirmed_service==1 confirmedCOVNotification bacapp.confirmed_service==5 subscibeCOV bacapp.unconfirmed_service == 0 I-Am packets bacapp.unconfirmed_service == 8 WhoIs packets bacapp.unconfirmed_service == 2 unconfirmedCOVNotification packets bacapp.unconfirmed_service==3 unconfirmedEventNotification bacapp.unconfirmed_service==6 timeSynchronization     mstp.frame_type>2 exclude all token passing mstp.frame_type>127 view all proprietary traffic mstp.frame_type==0 only token passing mstp.frame_type==1 only poll for master mstp.frame_type==2 only poll for master responses bacapp.instance_number==[BACnet ID] all traffic from/to a specific ID mstp.dst==[MAC address] all traffic to a specific MSTP address mstp.src==[MAC address] all traffic from a specific MSTP address ip.dst==[IP address] all traffic to a specific IP address ip.src==[IP address] all traffic from a specific IP address      || (between filters) combines above filters (or)  && (between filters) combines above filters (and)   Also check out the BACnet-Capturing MS/TP Traffic Quick-Help video on the Exchange.

Issue General use of the Wireshark program. Product Line Access Expert, Andover Continuum, EcoStruxure Building Expert, EcoStruxure Building Operation, Pelco, Satchwell MicroNet, Satchwell Sigma, TAC IA Series, TAC INET, TAC Vista Environment Ethernet Networks Cause General Information on using WireShark. Resolution Wireshark is an Ethernet packet analysis programme, Which can be downloaded from: Latest version available from Wireshark Locally stored version 1.0.9 Installing Wireshark If necessary, unzip the WireShark executable file to a suitable location on the PC/Laptop you wish the programme to be installed on. Run the executable file and follow the on-screen instructions. Rules for capturing LAN traffic using Wireshark: Do not use a switch or router to connect the LAN capture PC to the network as these will filter important network activity that you will need to see. You will want to capture everything that is passing over the network at the point of concern. Usually, this means tapping into the ethernet at the Controller or controllers, that is having an issue. midBit-Technologies-LLC-10-100 is an example of a device that can be used to easily tap into the network to take the capture. The monitoring PC must see all traffic from the controller's point of view. The monitoring PC can be connected in either two ways: Connected to the network at the controller The customers IT department can mirror all the network traffic from the controllers port to another port the PC can be connected to. If connected to the network at the controllers, the connection must be made through a true ethernet hub. A hub will not selectively filter important network traffic as a switch or a router will do. More information on what a "true ethernet hub" can be found at http://wiki.wireshark.org/HubReference There are however some switches that feature port mirroring, please see How to Configure a NETGEAR Prosafe Plus Switch for Mirroring. If connected to a mirrored port, the port must mirror 100% of the network traffic to and from the controller. No filtering should be done. Once a complete capture file has been obtained it can be filtered after the fact using WireShark or EtherReal. Using Wireshark Run WireShark Start a trace by choosing the "Capture" menu and then select "Interfaces" Choose the appropriate interface. Generally, this can be identified by its IP Address, but if not, then the packets increasing are an indication. Press the "Start" button. The trace will start and will be similar to the following screenshot. After an appropriate time, the trace can be stopped by selecting "Capture" menu and "Stop" To save the capture file, choose "File" menu and "Save As".

Issue Support is required for the Automated Engineering Tool commonly known as AET Product Line EcoStruxure Building Operation, Automated Engineering Tool Environment AET Cause Further support is required for Automated Engineering Tool AET. Resolution For more information including videos, user guides, specification sheets, etc about the tool, please visit the Schneider Electric Exchange and EcoStruxure Building Management System WebHelp. For assistance or to report problems with the AET applications/programs, please post your questions on the Exchange Community.  In order to report functional problems with AET, please reference the support contact information found in Automated Engneering Tool - PA-00559 or email  aet.support@schneider-electric.com  

Issue There may be a situation where the External Interface File (XIF) needs to be extracted out of the controller in order to properly set up the controller in a building automation system.  Product Line EcoStruxure Building Operation, TAC IA Series, TAC Vista Environment External Interface File (XIF) NodeUtil Loytec XIF Builder Cause These tools will help with the extraction of an XIF file. An XIF file is used to create a Niagara R2 shadow object, a Niagara G3 LMNL file, LonWorks device template, and a SmartStruxure device template.  Resolution The device manufacturer should provide an XIF, and in most cases, a DRF kit as well. The XIF provided by the manufacturer of the controller should be used first but if issues arise it may be required to extract the file from the controller. There are a number of tools available that will create an XIF, but the DRF kit cannot be created by any tool and must be supplied by the manufacturer. This MUST be provided along with the device. The list below covers some of the tools which are available. NodeUtil                          (header: bad,           NVs: ok,                      DMA/File-SCPTs are omitted) Vista's XIF-builder           (header: bad,           NVs: almost ok..,       DMA/File-SCPTs are omitted)  Loytec plugIn                  (does a perfect XIF from a device using Loytec's stack)   NodeUtil is available from the Echelon website (free registration is required) - The NodeUtilLauncher package attached makes it easy to use NodeUtil with Loytec interfaces. Loytec XIF Builder is available from the Loytec website (free registration is required) Using Lonmaker and the XIF Builder. Using NL220 and the XIF Builder. If the uploaded XIF still contains some detailed prompted error, refer to Error displayed when importing a device XIF into SmartStruxure.

Issue Steps to backup within StruxureWare/EcoStruxure Building Operation Product Line EcoStruxure Building Operation Environment StruxureWare/EcoStruxure Building Operation site with AS and/or ES Backup, Automation Server, Enterprise Server, Workstation, .xbk, xbk, backup set, db backup, db_backup Cause Must an AS or ES be stopped in order to do a full backup? Is a raw copy of the database folder from within Windows Explorer sufficient for backing up an ES?  For instructions on how to restore a backup in StruxureWare/EcoStruxure Building Operation, see How to restore a StruxureWare Building Operation server backup set. Resolution Concerning the backup and comparing SQL to the proprietary database that StruxureWare/EcoStruxure creates begs the question, are these backup complete? StruxureWare freezes the database while a backup is in progress in different ways. For configuration changes, StruxureWare Building Operation queues up the changes until the backup completes. For historical data, StruxureWare Building Operation buffers the data based on the limits of the buffer size. A stop of the ES is not necessary, nor is a stop of an AS. Because of this freeze and buffering, the data is put into that backup folder referenced in the pdf you sent. Three rules to remember: Restores of backups must be same software revision Do not rename the backup set A StruxureWare/EcoStruxure Building Operation backup should not be renamed after it has been created. When creating a backup, give the appropriate prefix to the standard name format.     The backup file will be shown as below. Should the backup name need to changed, then either create a new backup, or, zip up the backup using the new name.   Backups default to every Sunday morning 1:00am Here is the procedure for backing up an AS or ES: In Workstation, in the System Tree pane, select an Automation Server (AS) or Enterprise Server (ES) On the Actions menu, click Backup. This opens the Backup Options window In the Include column, select the servers that you want to include in the backup In the Backup content column, select the type of data you want to backup for each server: Select All Data to back up both the historical and configuration databases. This combined option protects the configuration, historical data, and custom object type data for a specified date and time Select Configuration only to back up the configuration database and custom object type data. This data option protects the configuration data for a specified date and time In the Backup set description column, type a brief description up to 255 characters to help identify the content of the backup Click Backup Verify that each backup succeeded and click Close Backup Files of ES: The backup data files are stored in the C:\ProgramData\Schneider Electric StruxureWare\Building Operation 1.X\Enterprise Server\db_backup\LocalBackup or  C:\ProgramData\Schneider Electric EcoStruxure\Building Operation 2.X\Enterprise Server\db_backup\LocalBackup   Backup Files of AS: Login to AS from WorkStation and navigate to System > Backup and Restore > Backup sets> Local. Then Right-click on the backup file and Save To... (then select a folder on your HDD) Note: Let this not be confused with the 'Starting a Project Tutorial [101248].pdf' in section 5.1 page 44, where it describes the user simply doing a raw copy of the database folder from within Windows Explorer. This can be mistaken with the orderly backup that uses the inbuilt StruxureWare backup facility. This copy procedure described has no chance to freeze the database. The user can just do it at any random time and StruxureWare has no idea that the copy has been made. A sample database should be created using the Backup/Restore functions of the system, not by just doing a raw folder copy as the server may be in the middle of transactions to various files in that folder. A copy of this folder could be used, but only while the SE.EnterpriseServer.exe process has been stopped. However, it is recommend using the system’s backup facility to accomplish this (Not all items are backed up such as Alarm data. The Backup/Restore help section of StruxureWare Building Operation Guide discusses what is and isn’t backed up).