Jmobile Studio User Manual
Total Page:16
File Type:pdf, Size:1020Kb
JMobile Studio User Manual Version 4.00 © 2009-2020 Exor International S.p.A. © 2009-2020 Exor International S.p.A. Subject to change without notice The information contained in this document is provided for informational purposes only. While efforts were made to verify the accuracy of the information contained in this documentation, it is provided 'as is' without warranty of any kind. Third-party brands and names are the property of their respective owners. Microsoft®, Windows®, Windows XP, Windows Vista, Windows 7, Windows 8, Windows 10 and Visual Studio are either registered trademarks or trademarks of the Microsoft Corporation in the United States and other countries. Other products and company names mentioned herein may be the trademarks of their respective owners. The example companies, organizations, products, domain names, e-mail addresses, logo, people, places, and events depicted herein are fictitious. No association with any real company, organization, product, domain name, e-mail address, logo, person, place or event is intended or should be inferred. Contents 1 Getting started 1 Changing fill color property according to tag values 72 Assumptions 2 6 Pages 73 What´s new 3 Unified pages 74 Installing the application 6 Project Validator 74 2 Runtime 11 Differentiated pages 76 HMI device basic settings 12 7 Project properties 83 Context menu options 12 Runtime 84 Built-in SNTP service 15 Plug-in 89 3 Runtime on PC 17 Project 90 Typical installation problems 20 Web 94 4 My first project 23 Events 95 The workspace 24 Regional Settings 95 Creating a project 25 8 The HMI simulator 97 Designing a page 27 Data simulation methods 98 The Widget Gallery 28 Simulator settings 98 Label widget 30 Launching and stopping the simulator 99 Data field widget 36 9 Transferring the project to HMI device 101 Message widget 39 Download to HMI device 102 Attaching widget to tags 43 Update package 105 Dialog pages 45 The Runtime loader 107 5 Programming concepts 47 Upload projects 108 Data types 48 10 Tag editor 109 "Attach to" parameters 49 Communication protocols 110 Formula 54 Adding tags 111 Events 59 Exporting tags 114 Widgets positioning 62 Importing tags 114 Managing overlapping widgets 63 Tag find and rename 118 Grouping widgets 64 Tag find and replace 120 Changing multiple widgets properties 71 11 Indexed addressing 123 JMobile Studio | User Manual | v400 (2020-02-04) | EN | © 2009-2020 Exor International S.p.A. I Creating an indexed addressing set 124 Services variables 183 Using indexed tag set in pages 127 NFC Support 186 12 Tag cross reference 129 Direct I/O variables 187 Updating data in the Tag Cross Reference PLCM09 variables 193 pane 133 JSmart variables 197 13 System Variables (Attach To) 135 15 Actions 201 Alarms variables 137 Alarm actions 202 Buzzer variables 137 Database actions 203 Communication variables 138 Event actions 206 Daylight Saving Time variables 138 MultiLanguage actions 206 Device variables 139 Keyboard actions 207 Dump information variables 141 Media Player actions 209 FTP client variables 141 FTP actions 209 Keypad variables 142 Page actions 212 Network variables 142 Print actions 219 PLC variables 143 Recipe actions 221 Printing variables 144 Remote Client actions 225 Remote Client variables 144 System actions 226 Version variables 145 Tag actions 238 Screen variables 145 Trend actions 241 SD card variables 146 Text Editor actions 245 Server variables 146 User management actions 245 Time variables 146 Widget actions 248 Touch screen variables 147 16 The HMI Client 253 USB drive variables 148 Client application on PC 254 User management variables 148 Client application on HMI 255 14 System Variables (Protocol) 151 Settings and time zone options 256 Protocol Editor Settings 152 17 Using the integrated FTP server 261 Tag Import 152 FTP settings 261 Default variables 153 18 Using VNC for remote access 263 HandHeld variables 169 Starting VNC server on WinCE devices 264 HandHeld - wireless variables 172 Starting VNC server on Linux devices 265 Retentive Memory variables 178 Starting VNC viewer 265 II JMobile Studio | User Manual | v400 (2020-02-04) | EN | © 2009-2020 Exor International S.p.A. 19 Corvina Cloud 267 25 Offline node management 329 20 Alarms 269 Offline node management process 330 Alarms Editor 270 Manual offline node management process 330 Remote alarms acknowledge 273 Manual offline configuration 330 Alarm state machine 274 Automatic offline node detection 331 Setting events 274 26 Multi-language 333 Active Alarms widget 277 The Multi-language editor 335 Alarms History widget 282 Changing language 336 Additional Alarms widgets 282 Multi-language widgets 336 Managing alarms at runtime 283 Exporting/importing multi-language strings 339 Enable/disable alarms at runtime 283 Changing language at runtime 340 Displaying live alarm data 284 Limitations in Unicode support 340 Exporting alarm buffers to .csv files 286 27 Scheduler 343 Exporting alarm configuration 286 Creating a schedule 344 Events Buffer 289 HighResolution schedule 345 22 Recipes 291 Recurring schedule 345 Managing recipes 291 Configuring location for schedules 346 Configuring a recipe widget 294 Configuring the Scheduler widget 347 Recipe status 295 Scheduling events at runtime 348 Uploading/downloading a recipe 296 28 21 CFR Part 11 Compliance 351 Backup and restore recipes data 297 x.509 Certificate 356 23 Trends 299 Signed CSV files 359 Data logging 300 Signed PDF files 360 Exporting trend buffer data 305 Compliant applications 363 Realtime trend widget 306 29 User management and passwords 365 History trend widget 307 Enable/disable security management 366 Scatter diagram widget 309 Configuring groups and authorizations 366 Trend widget tips 310 Modifying access permissions 367 Table trend widget 316 Assigning widget permissions from page view 372 24 Data transfer 323 Configuring users 373 Data transfer editor 324 Default user 375 Exporting data to .csv files 326 Managing users at runtime 375 Data transfer limitations and suggestions 326 JMobile Studio | User Manual | v400 (2020-02-04) | EN | © 2009-2020 Exor International S.p.A. III Force remote login 376 Connection Limits 418 30 Audit trails 377 37 OPC UA Server 421 Enable/disable audit trail 378 Features 421 Electronic Signature 379 Network 421 Table audit widget 383 Authentication 421 Exporting audit trail as .csv files 384 Using x.509 Certificates 422 31 Reports 387 Using self-signed certificates 425 Adding a report 388 Using external certificates 429 Configuring text reports 388 Alarm map 430 Configuring graphic reports 389 38 MQTT Interface 431 Print triggering events 390 Tags configuration 431 Default printer 391 Settings 433 32 Screen saver 393 Topic and Payload 433 33 Backup/restore of Runtime and project 395 MQTT Broker Settings 435 34 Keypads 397 39 Special widgets 441 Creating and using custom keypads 399 BACnet widget 442 Deleting or renaming custom keypads 401 Browser widget 442 Keypad type 402 Canvas Widget 443 Keypad position 402 Combo Box widget 446 35 External keyboards 405 Consumption Meter widget 450 Search and filter 407 Control list widgets 451 Displayed keys 407 DateTime widget 455 Removing action associations 407 Gesture area widget 457 Keyboard layout 408 IP Camera widgets 461 Enable/disable keyboard 408 JavaScript function block widget 464 Associating actions to keys 408 Media Player widgets 466 36 Storing data to external databases 411 Multistate Image widget 469 Installing SQL4Automation 413 Multistate Image Multilayer widget 470 Configuring SQL4Automation 413 Network Adapters widget 471 Configuring the HMI project 415 RSS Feed widget 472 Transfer data with JavaScript 416 Scrolling RSS Feed widget 473 Database tables 417 Table widget 473 Custom tables 418 TextEditor widget 489 IV JMobile Studio | User Manual | v400 (2020-02-04) | EN | © 2009-2020 Exor International S.p.A. Variables widget 491 Keywords 545 40 Custom widgets 493 Global functions 546 Creating a custom widget 494 Handling read/write files 547 Adding properties to a custom widget 496 Sign in from JavaScript 550 Using structured tags 499 Limitations in working with widgets in JavaScript 552 JavaScript in custom widgets 501 Debugging of JavaScript 552 User's Gallery 504 43 Handling Gestures 557 41 Sending an email message 507 44 Web access 559 Configuring the email server 508 Supported platforms and browsers 560 Configure emails 508 Web pages 560 42 JavaScript 511 Testing the Web project 562 JavaScript editor 513 Downloading the Web project 563 Execution of JavaScript functions 513 Web connectivity issues 564 Events 515 Web supported features 565 Widget events 516 Troubleshooting and FAQ 569 Page events 518 Privacy 569 System events 519 45 License activation of HMI device Objects 521 software modules 571 Widget class objects 521 Activate the device 572 Widget properties 522 Save a license 573 Widget methods 525 Import a license 573 Page object 526 46 Protecting access to HMI devices 575 Page object properties 526 Changing password on HMI device 576 Page object methods 527 Ports and firewalls 576 Project object 529 47 Tips and tricks to improve performance 579 Project object properties 530 Static Optimization 580 Project object methods 530 FAQ on Static Optimization 583 Project object widgets 539 Page caching 584 Print reports object 540 Image DB 584 Group object 543 Precaching 584 Group object methods 543 FAQ on precaching 584 State object 544 48 Functional specifications and State object methods 544 compatibility 587 JMobile Studio | User Manual | v400 (2020-02-04) | EN | © 2009-2020 Exor International S.p.A. V Table of functions and limits 588 HMI devices capabilities 589 Compatibility 591 Converting projects between different HMI devices 591 49 System Settings 593 Linux Devices 594 WinCE Devices 620 50 Updating system components in HMI devices 631 Update of system components from the application 632 Settings 633 VI JMobile Studio | User Manual | v400 (2020-02-04) | EN | © 2009-2020 Exor International S.p.A. 1 Getting started JMobile Studio is a software application designed to create graphical HMI pages.