Desigo™ CC User Guide Version 3.
Copyright Notice Copyright Notice Notice Document information is subject to change without notice by Siemens Switzerland Ltd. Companies, names, and various data used in examples are fictitious unless otherwise noted. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Siemens Switzerland Ltd.
Table of Contents About this Document ............................................................................................ 9 1 Getting Started ......................................................................................... 13 1.1 User Interface ................................................................................................ 13 1.2 Graphical Elements and Controls ................................................................. 14 1.3 Operational Workflows ...........
2.3 2.4 2.5 2.6 2.2.3 Operating and Engineering Mode ..................................................45 2.2.4 Navigation Bar Reference ..............................................................47 2.2.5 Recently Viewed Reference ..........................................................48 System Browser ............................................................................................49 2.3.1 Working with System Browser .......................................................49 2.
4.2 Displaying Properties ................................................................... 118 4.1.10 Dragging Object Properties from the Graphics Viewer................ 118 4.1.11 Editing a Graphic ......................................................................... 119 4.1.12 Enabling Point Centered Display Mode ....................................... 119 4.1.13 Navigating to a Linked Element ................................................... 119 4.1.
7.2 Building Technologies Printing Trend Data ......................................................................198 7.1.5 Manual Correction Application .....................................................200 Trends Reference ........................................................................................204 7.2.1 Overview of Trends Application ...................................................204 7.2.2 Trends in Distributed Systems .....................................................
8.2.6 Reports Ribbon — Filter Tab ....................................................... 290 8.2.7 Reports Ribbon — Layout Tab .................................................... 299 8.2.8 Reports Ribbon — Data Tab ....................................................... 301 8.2.9 Reports Ribbon — Settings Tab .................................................. 302 8.2.10 Report Management Section ....................................................... 316 8.2.11 Related Items Tab ...............
11 Reactions ................................................................................................ 371 11.1 Enabling or Disabling a Reaction ................................................................371 11.2 Reactions Reference ...................................................................................371 11.2.1 12 Properties and Commands of a Reaction ....................................372 Organization Modes .....................................................................
About this Document About this Document Purpose This manual describes the features of the Desigo CC management station. It provides casual users with in-depth reference information for the different system features, including workflows, and is designed to support users in their daily siterelated monitoring and controlling activities. Scope This document applies to Desigo CC Version 3.0. Target Audience End-Users are the primary users of the system.
About this Document Liability Disclaimer We have checked the contents of this manual for agreement with the hardware and software described. Since deviations cannot be precluded entirely, we cannot guarantee full agreement. However, the data in this manual are reviewed regularly and any necessary corrections included in subsequent editions. Suggestions for improvement are welcome.
About this Document Document Conventions The following table lists conventions to help you use this document in a quick and efficient manner. Convention Examples Numbered Lists (1, 2, 3…) indicate a procedure with sequential steps. 1. Turn OFF power to the field panel. 2. Turn ON power to the field panel. 3. Open the panel. One-step procedures are indicated by a bullet point. ● Expand the Event List. Conditions that you must complete or must be met ⊳ The report you want to print is open.
About this Document Safety Messages According to ANSI Z535.6 ANSI standard safety messages are used throughout Help to make you aware of important information. ANSI distinguishes between property damage messages and personal injury messages. ● The property damage message has this label: NOTICE.
Getting Started User Interface 1 1 Getting Started This section provides an introductory overview of the Desigo CC user interface and its typical navigation workflows. 1.1 User Interface The exact screen layout will vary depending on your particular system’s configuration, and you may not see all the components described. Main Screen Layout in Building Automation Profiles 1 2 1 Name Description Summary bar The main point of entry to all the functions of the software.
1 Getting Started Graphical Elements and Controls In particular, depending on the operational workflow, the following windows can display in the work area: ● Event List A list of all the events in the building-control system. This is the starting point for viewing and handling events. Depending on the particular system’s configuration, Event List may be hidden or minimized into an Event bar and you can open it in the work area when needed by clicking its icon (in the Summary bar or in the Event bar).
Getting Started Graphical Elements and Controls 1 Interacting with the Graphical Elements You can arrange panes of a window in different layouts or interact with a window and its panes in various ways. These include: ● Click the icons on the window title bar top to minimize, restore down, or maximize the window. ● Click the icons on the window title bar to quickly switch between the available preset layouts: – : Selection, Primary, and Contextual panes.
1 Getting Started Operational Workflows 1.3 Operational Workflows This section introduces you to the most common workflows for navigating and interacting with Desigo CC. Basic Navigation Workflow The following graphic shows the typical workflow for navigating the system: 8 7 6 1 2 3 4 5 1. Select a view (1) in System Browser, in the Selection pane, such as Application View. The selected view displays in the System Browser tree. 2.
Getting Started Operational Workflows 1 Object Association Workflow The following graphic shows the typical workflow for manual selection and dragand-drop, in order to associate two objects: 1 3 4 2 1. Select a view (1) in System Browser, in the Selection pane, for example Application View. The selected view displays in the System Browser tree. 2. Navigate the tree to select the object (2) you want to work with, for example Activity Log. 3.
1 Getting Started Starting and Exiting the System 1.4 Starting and Exiting the System This section contains instructions for: starting up or shutting down the Desigo CC client application, changing your password, or doing an operator switchover. Perform the procedures in this section as needed. 1.4.1 Launching an Installed Client You want to start Desigo CC on a computer where the Desigo CC software is installed as a normal Windows application. 1.
Getting Started Starting and Exiting the System 1.4.3 1 Launching a Windows App Client You want to start Desigo CC from a computer configured to operate as a Windows App Client, where the client software is downloaded and installed on demand from a browser. The authentication certificate was previously installed on the computer (see Browsing a Website or Web Application URL). 1. Launch Microsoft Internet Explorer. 2.
1 Getting Started Starting and Exiting the System 1.4.5 Interrupting the Auto Logoff You are working on a Desigo CC station and your user group was configured for auto-logoff after a period of operator inactivity. The log off message box displays the time remaining before the automatic log off. To stop the logoff, move the cursor or press any key on the keyboard. The auto log off is interrupted. 1.4.
Getting Started Starting and Exiting the System 1.4.8 1 Changing Your Password You are logged on as Desigo CC user, and the option to change the user’s password is available in the system menu. 1. In the Summary bar, select Menu > Operator > Change User Password. The password change window appears. 2. Enter the old password and new password. 3. Confirm password. 4. Click Change Password. A message informs you that the changes have been successfully saved.
1 Getting Started System Screen 1.5 System Screen This section provides reference information and instructions for getting around the Desigo CC user interface. 1.5.1 System Screen Reference This section provides reference information on the main components of the Desigo CC user interface. For related procedures see Working with the System Screen [➙ 27]. 1.5.1.1 Main Screen Layout Reference After starting Desigo CC and logging on, the main system screen displays.
Getting Started System Screen 1 System Manager Reference [➙ 42] Event List Reference [➙ 96] Investigative Treatment Window Reference [➙ 98] Assisted Treatment Window Reference [➙ 99] Working with the System Screen [➙ 27] 1.5.1.2 Summary Bar Reference The Summary bar is located along the top of the system screen, and is the main point of entry to all the functions of Desigo CC.
1 Getting Started System Screen 6 System menu From here, the operator can access other functions. See System Menu Reference [➙ 26]. 7 System integrity indicator Displays the status of the network connection to the management-system server. See System Integrity Indicator Reference [➙ 25]. 8 Expand/collapse Expands/collapses the Summary bar. See Expanding and Collapsing the Summary Bar [➙ 28]. 9 Event filter Lets you filter the alarms in Event List. See Filtering Event List [➙ 85].
Getting Started System Screen 1.5.1.4 1 System Integrity Indicator Reference The system integrity indicator, located on the Summary bar [➙ 23], indicates the network connection and system status. Its color and animation reflect the connection status, as follows: Green and animated Network connection with the server is active and the system is healthy (that is, server running properly).
1 Getting Started System Screen Audio Alert Status 1.5.1.6 Active1) The system has detected a new alarm, or there are still alarms in the unprocessed state. You can temporarily silence or permanently turn off the audio alert. Muted You temporarily silenced the audio alert. After 24 hours the system will automatically re-activate the sound (audio alert reminder). Disabled2) You completely disabled the audio alert.
Getting Started System Screen 1 Printouts Selection Dialog Box The Printouts Selection dialog box displays when you print from the system menu. It lets you select system application printouts. Print Preview Dialog Box The Print Preview dialog box displays when you print from the system menu, or from an application. It lets you adjust the various printer options (margins, orientation, scaling and so on) before launching the print job.
1 Getting Started System Screen 1.5.2.2 Expanding and Collapsing the Summary Bar Expanding the Summary Bar The Summary bar displays collapsed. 1. In the Summary bar, click down on the top right or an event indicator. The Summary bar expands. Collapsing the Summary Bar The Summary bar displays expanded. 1. In the Summary bar, click up on the top right. The Summary bar collapses. Related Topics Main Screen Layout Reference [➙ 22] Summary Bar Reference [➙ 23] 1.5.2.
Getting Started System Screen 1.5.2.4 1 Temporarily Muting the Audio Alert The audio alert buzzer on a Desigo CC station is sounding, and you want to mute it temporarily. 1. In the Summary bar, click Audio Alert . The icon changes to muted and the sound stops, even if there are still unacknowledged events. Muting applies only to the pre-existing events: the audio alert will still sound for any new events that come in. 1. To manually unmute the audio alert, click Audio Alert again.
1 Getting Started System Screen Related Topics Summary Bar Reference [➙ 23] 1.5.2.7 Moving a System Window to a Second Monitor NOTE: When an additional monitor is available, you can move any system window, such as, System Manager, Investigative/Assisted Treatment, Help or Event List (in some Client Profiles only), from the default monitor to a second monitor. The Summary bar cannot be moved. Desigo CC is running as an Installed Client or Windows App Client on a computer connected to two monitors.
Getting Started Types of Stations in the Management Platform 1 Related Topics Printouts Reference [➙ 26] 1.6 Types of Stations in the Management Platform The Desigo CC software has a client-server architecture, in which a server component handles all interactions with the field networks and devices installed on the site, while one or more clients provide the user-facing application that operators interact with.
1 Getting Started Client Station Troubleshooting Windows App Client A computer used to access Desigo CC as a light application, downloaded and installed on-demand directly from the Internet Explorer browser. Once installed, it looks like the standard Desigo CC client software, but allows access to local resources only. Each time the user launches the Windows App Client, a search for system updates is performed.
Getting Started Client Station Troubleshooting 1.7.2 1 Troubleshooting Logon Problems User’s logon credentials You can log on to the system as a Desigo CC user or Windows user by providing the username, password and domain name. System domain NOTE: The current version of Desigo CC supports only one domain. This means that you can only log on to the configured default domain. If you belong to a domain different from the default, you can log on only as a Desigo CC user or local user under [station name]\[
2 System Manager Working with System Manager 2 System Manager This section provides information and instructions for using the System Manager window of Desigo CC. 2.1 Working with System Manager This section provides step-by-step instructions for some common System Manager tasks. For background information, see System Manager Reference [➙ 42]. Perform the procedures in this section as needed. 2.1.
System Manager 2 Working with System Manager 2.1.3 Changing the Pane Layout of System Manager You want to adjust or customize the arrangement of the panes in the System Manager window. 1. In the System Manager window header, if the lock pane layout icon is active (undimmed), click it so that it becomes dimmed. Otherwise the pane layout cannot be changed. 2. To switch between the available preset layouts, click the icons in the title bar: – : Selection, Primary, and Contextual panes.
2 System Manager Working with System Manager 2.1.4 Allowing or Preventing Opening of the Secondary Pane Normally, the Secondary pane opens on demand, when you make a selection that requires it. When the Secondary pane opens, it takes up half the space that would otherwise be allotted to the Primary pane. You want to prevent the Secondary pane from opening, so that the Primary pane will always occupy its full width. 1.
System Manager Working with System Manager 2 To enable automatic propagation, deselect the Manual navigation check box. The next time you select an object in the tree, the Primary and Contextual panes will automatically refresh to reflect the new selection. Related Topics Manually Propagating a Selection to Other Panes [➙ 37] System Manager Navigation Workflows [➙ 43] 2.1.
2 System Manager Working with System Manager 4. Select the Manual navigation check box if you do not want the Primary and Contextual panes to refresh while you are doing this. 5. Right-click the object in the tree and select Send to the Secondary Pane. The content pertaining to the selected object displays only in the Secondary pane, whereas the content of the Primary and Contextual panes is not changed. Related Topics Setting How Selections Propagate to Other Panes [➙ 36] 2.1.
System Manager 2 Working with System Manager 2. Do one of the following to find the set of objects you want to select: – Navigate to the desired objects in the System Browser tree. Click expand a collapsed node and view its children, or click – to to collapse an expanded node and hide its children. Run a search by name/description and other criteria such as discipline, type, and so forth. See Searching for Objects [➙ 49]. 3.
2 System Manager Working with System Manager 3. Click an item in the drop-down list (for example, Documents) to make it the new selection. System Browser, the Primary pane, and the Contextual pane all update to reflect the new selection. NOTE: The selection made here propagates to the other panes even if you selected Manual navigation in System Browser. 4. Continue moving around the tree in this way until you reach the object you are interested in.
System Manager 2 Working with System Manager 2.1.13 Setting a Favorite Location in System Manager You want to bookmark a particular selection as your favorite location, so that it displays as the initial location whenever you open System Manager and that you can easily access by clicking Favorite location in the Navigation bar. 1. Select the object you want to set as the favorite location, so that it displays in the Primary pane. 2.
2 System Manager System Manager Reference 2.2 System Manager Reference This section provides reference information for using the System Manager window. For related procedures see Working with System Manager [➙ 34]. 2.2.1 Overview of System Manager System Manager is a multi-pane window for navigating, monitoring, and controlling all the components and subsystems of your site.
System Manager System Manager Reference 2 Description 1 Selection pane. Typically contains System Browser, for locating and selecting system objects in a hierarchical tree view. A drop-down menu lets you switch between different tree views (for example, Management View, Application View or other customizable views). Your selection here is propagated to the Primary pane on the right, and to the Contextual pane below it.
2 System Manager System Manager Reference Primary Navigation Workflow The following is a typical workflow that illustrates how the different System Manager panes work together: 1. Select an object in the Selection pane (1). See Selecting an Object in System Browser [➙ 38]. Information and commands for that object display in the Primary pane and in the Contextual pane (2). You can immediately monitor and control the selected object. 2. Click the Primary pane to select a new object (3).
System Manager System Manager Reference 2 1 3 4 2 NOTE: System Browser supports drag-and-drop of single or multiple objects from any of the views—including the Search Result view. You can cancel a dragging operation by pressing the ESC key or by dragging the objects back to the original view (or other no-drop zone) and dropping them. 2.2.3 Operating and Engineering Mode When you log onto Desigo CC, System Manager starts in Operating mode.
2 System Manager System Manager Reference 1 2 3 Figure 4: System Manager - Operating Mode Description 1 System Manager Operating mode is indicated by a light blue color. 2 Depending on the object selected in System Browser, the Primary pane displays only the Textual Viewer tab or the Textual Viewer and other tabs. Each tab gives access to the related operating application. 3 The Operating button is available only if you have access rights for Engineering mode; otherwise, it does not display.
System Manager System Manager Reference 1 2 3 2 4 Figure 5: System Manager - Engineering Mode Description 2.2.4 1 System Manager Engineering mode is indicated by a light pink color. 2 Depending on the object selected in System Browser, multiple engineering tabs may display in the Primary pane header. Each tab gives access to a configuration application relevant to the selected object.
2 System Manager System Manager Reference 2.2.5 Recently Viewed Reference Recently Viewed is a navigation aid located in the Selection pane of the System Manager window. It lets you quickly return to a recently-visited view in the Primary pane. To access Recently Viewed, click its stacked tab at the bottom of the Selection pane. You will see a history of the 20 most recent views in the Primary pane, displayed as either thumbnails (snapshots) or links (3).
System Manager System Browser 2 2.3 System Browser This section provides information and instructions for using the System Browser. 2.3.1 Working with System Browser This section provides step-by-step instructions for some common System Browser tasks. For background information, see System Browser Reference [➙ 51]. Perform the procedures in this section as needed. 2.3.1.1 Selecting Views 1. From the Views list box, click the drop-down arrow. 2.
2 System Manager System Browser 2.3.1.5 Choosing a Display Mode 1. In System Browser, click the Display Mode drop-down list. 2. Select the mode you want for displaying objects. The object displays in the new mode throughout the various panes in System Manager. 2.3.1.6 Making a Manually Selected Object the New Primary Selection The Manual Navigation box is checked, with one or more objects selected. Do one of the following: – – – Right-click and select Send to the Primary Pane.
System Manager System Browser 2 4. (Optional) Click the icon to display detailed information about the selected data points. 5. Do one of the following: – – Change the value and click Send or Change. Click a command button to execute the respective function. Only objects properties that have been changed will be logged in the Activity Log database. 2.3.2 System Browser Reference This section provides background information for using System Browser.
2 System Manager System Browser available only to you. You access saved searches by clicking the drop-down list arrow in the Search list box. Filtering helps you limit the number of objects shown during a search, while also providing an efficient way to find objects without scrolling through the entire tree or without having to remember which node an object belongs to. You access the filtering fields by clicking Filter Search .
System Manager System Browser 2 Views You can select from different views of the object types in the building control system, depending on how your system is set up. Selecting a view does not change the physical makeup of the system. The views merely represent convenient and different ways of looking at the system. Default views include Application View and Management View. The currently selected view is saved from session to session.
2 System Manager System Browser 2.3.2.2 System Browser Workspace System Browser displays objects in the building control system through various views, and also supports searching and filtering. 6 1 2 7 3 4 8 5 Figure 6: System Browser Workspace 54 | 393 Siemens Building Technologies Name Description 1 Views List box Allows you to select the view of the system by clicking the dropdown arrow. 2 Search List box Allows you to search for objects in the currently selected view.
System Manager System Browser 4 Manual Navigation check box 2 One of two methods for making objects the primary selection in System Manager. By default, automatic selection is enabled, which means that any object you select in System Browser automatically becomes the new primary selection for the system. If you want to scroll through the System Browser tree and highlight an object without making it the primary selection, check the Manual Navigation box, and then single-click the object.
2 System Manager Textual Viewer 2.4 Textual Viewer This section provides information and instructions for using the Textual Viewer. 2.4.1 Working with Textual Viewer This section provides step-by-step instructions for some common Textual Viewer tasks. For background information, see Textual Viewer Reference [➙ 57]. Perform the procedures in this section as needed. 2.4.1.1 Customizing Columns System Manager is in Operating mode. 1.
System Manager Textual Viewer 2.4.1.4 2 Sorting Objects System Manager is in Operating mode. You have more than one object displaying in Textual Viewer, and you would like to sort them. 1. In the column you want to sort, click the column heading. 2. Do one of the following: – – If the column is arranged in alphabetical order and you want to arrange it in reverse alphabetical order, select the column heading. When the up arrow displays, click the column heading again.
2 System Manager Textual Viewer 2.4.2.2 Textual Viewer Workspace Textual Viewer Workspace 58 | 393 Siemens Building Technologies Name Description 1 Object Displays a list of objects in the system. A bolded object indicates a parent object with associated children objects. 2 Title bar Displays the name of the object with the primary selection. If you select multiple objects, the name of the first object you selected will display.
System Manager Textual Viewer 2 Customize Columns Dialog Box 2 1 3 4 Name Description 1 Available Columns Displays a list of columns not currently shown in Textual Viewer. 2 Movement arrows Allow you to move columns to control whether they are hidden or shown. 3 Visible Columns Displays a list of columns that will show in Textual Viewer. 4 Selection buttons Move Up/Move Down: Allow you to rearrange the order in which columns display. OK: Allows you to accept the changes you have made.
2 System Manager Operation/Extended Operation 2.5 Operation/Extended Operation This section provides information and instructions for using the Operation and Extended Operation tabs in the Contextual pane of System Manager. 2.5.1 Working with Operation/Extended Operation This section provides step-by-step instructions for some common tasks in the Operation/Extended Operation tabs. For background information, see Operation/Extended Operation Reference [➙ 61].
System Manager Operation/Extended Operation 2.5.2 2 Operation/Extended Operation Reference This section provides background information for using the Operation and Extended Operation tabs. For related procedures, see Working with Operation/Extended Operation [➙ 60]. 2.5.2.1 Overview of Operation/Extended Operation The Operation and Extended Operation tabs allow you to display and change the current state of an object’s properties in your building control system.
2 System Manager Operation/Extended Operation Command Priorities and Priority Arrays Some objects in your building control system use specialized command priorities to determine whether an operator or a particular control program is in control. Command Priority The Present Values of six object types in your building control system are based on a command priority and established in a hierarchy that ranks from highest (1 – Manual Life Safety) to lowest (16 - Available).
System Manager Operation/Extended Operation 2 Multiple-Object Commanding With multiple-object commanding, you are not really commanding objects at all. Instead, you are commanding one property type, Present Value for instance, for more than one object of the same type. If you select multiple objects of the same type, for example, Analog Output, the icon next to the property name in the Operation or Extended Operation tab indicates this with a triangular symbol in the lower right-hand corner.
2 System Manager Operation/Extended Operation 2.5.2.2 Operation/Extended Operation Workspace The Operation and Extended Operation tabs display the name of the currently selected objects, a list of properties associated with the object, the current value of the properties, and command buttons for initiating commands on commandable properties. Operation/Extended Operation Workspace 1 Name Description Property name Displays the name of one or more properties associated with the selected objects.
System Manager Related Items 4 Command button 2 Displays the name of a command that you can initiate. Some commands are sent immediately after you initiate them by releasing the command button. Others require you to enter arguments before they can be sent. When a command requires arguments (additional fields requiring information to continue with the command), the property row will expand after you click the command button.
2 System Manager Related Items 2.6.1.3 Viewing Icons You have selected an object with Related Items displayed as links. From Related Items, click the Icons button. The Related Items display in the Icons view. 2.6.1.4 Grouping Items in the List You have selected an object with Related Items displayed in a flat list. From Related Items, click the Group button. All related items are grouped according to type—for example, Report, Graphic, Schedule, etc. 2.6.1.
System Manager Related Items 2 Related Items. For example, text might be displayed as description, name, description plus name, or name plus description. The second set of buttons, Group and Ungroup, allows you to switch between categories or flat-list views of the items in the list. The Group view shows items arranged by object type (analog input, digital output, schedules, graphics, reports, PDFs, Word files, web links, etc.) and is expanded by default, but which you can collapse as well.
2 System Manager Related Items 2.6.2.2 Related Items Workspace Related Items allows you to switch between small images and text views of the items in the list, or between categories and flat-list views of the items in the list. 1 2 Related Items Workspace 1 Name Description Links/Icons buttons The Links button allows you to view items as text displays. The display mode that is currently selected in System Browser determines how text displays in Related Items.
Alarms Working with Alarms 3 3 Alarms This section provides information and instructions for handling alarms in Desigo CC. 3.1 Working with Alarms This section provides step-by-step instructions for some common alarm-handling tasks in Desigo CC. For background information see Event List and Alarms Operation Reference [➙ 92]. Perform the procedures in this section as needed. 3.1.1 Opening and Closing Event List Opening Event List The Event List is not visible and you want to display it. 1.
3 Alarms Working with Alarms Related Topics Deselecting (Suspending) an Event in Event List [➙ 81] Interrupting Handling of an Alarm [➙ 80] Event Descriptor Reference [➙ 102] Event Status and Suggested Action Reference [➙ 110] 3.1.3 Selecting Multiple Events in Event List You want to select multiple events in Event List, to handle them all together. 1. To perform a multiple selection, do one or more of the following: – – – Use CTRL+A to select all the events in the list.
Alarms Working with Alarms 3 – Close event. Click the icon in the Commands column to send the – Reset command. Suspend the event. You finished handling this event, and the event is ready to be cleared from the list. Click the event button again to deselect the event. It will then be removed from Event List. 3. While handling the alarm according to the Suggested action, also check the Command column for any other, optional commands available to you.
3 Alarms Working with Alarms Related Topics Investigative Treatment Window Reference [➙ 98] Event Descriptor Reference [➙ 102] Interrupting Handling of an Alarm [➙ 80] 3.1.6 Handling an Event with Assisted Treatment Scenario: You want to handle an alarm using the guided Assisted Treatment feature. An operating procedure was configured for the assisted treatment of that alarm. Perform the procedures in this section as needed. 3.1.6.1 Starting Assisted Treatment of an Event 1.
Alarms Working with Alarms – 3 operating procedure. See Completing an Operating Procedure of Assisted Treatment [➙ 73]. Wait for condition. The event cannot be reset until the event source is back to normal. You must correct the situation that caused the alarm, or wait for the event source to return to the Quiet state, before you can finish handling this event. – Reset event. In the Commands column, click Reset . – – Close event. In the Commands column, click Close . Suspend the event.
3 Alarms Working with Alarms 2. When you find a step you can execute, click it to select it. The step expands and changes to a darker color to indicate that it is being executed. Information and tools for performing that step display in the Default tab. For example, if you selected a document step, the document that you must read will display. 3. Perform the tasks required for the selected step.
Alarms Working with Alarms 3.1.6.4 3 Executing a Document Step in Assisted Treatment You are in the Assisted Treatment window and the operating procedure includes a Document step that you want to do. Figure 7: Document Step 1. From the Steps list, select the Document step. The contents of the document display in the Default tab. 2. Read the document carefully and follow any instructions. 3. Click Backward or Forward to move through any other documents included in this step.
3 Alarms Working with Alarms 3.1.6.5 Executing a Remote Notification Step in Assisted Treatment You are in the Assisted Treatment window and the operating procedure includes a Remote Notification step that you must execute manually. Figure 8: Reno Step 1. From the Steps list, click the Remote Notification step. The Message Status list displays in the Default tab. 2.
Alarms Working with Alarms 3 Related Topics Handling an Event with Assisted Treatment [➙ 72] Assisted Treatment Window Reference [➙ 99] Remote Notifications Message Status List [➙ 144] 3.1.6.6 Executing a Graphic Step in Assisted Treatment You are in the Assisted Treatment window and the operating procedure includes a Graphic step that you want to do. Figure 9: Graphic Step From the Steps list, select the Graphic step. A graphic of the facility displays in the Default tab.
3 Alarms Working with Alarms 3.1.6.7 Executing an Alarm Printout Step in Assisted Treatment You are in the Assisted Treatment window, and the operating procedure includes an Alarm Printout step that you must manually execute. 1. From the Steps checklist, select the Alarm Printout step. The preconfigured alarm report displays in the Default tab. When you select this step for the first time, a new report is generated. On subsequent selection, the same report is reloaded. 2.
Alarms Working with Alarms 3.1.6.8 3 Executing a Report Step in Assisted Treatment You are in the Assisted Treatment window, and the operating procedure includes a Report step that you must manually execute. 1. From the Steps checklist, select the Report step. The preconfigured report displays in the Default tab. A new report is generated each time that you select this step. 2.
3 Alarms Working with Alarms 3.1.6.9 Executing a Treatment Form Step in Assisted Treatment You are in the Assisted Treatment window, and the operating procedure includes a Treatment Form step that you must manually execute. 1. From the Steps checklist, select the Treatment Form step. The form that you must complete displays in the Default tab. 2. Complete the form, using the provided controls (for example, editable fields or drop-down lists) to enter the necessary information. 3.
Alarms Working with Alarms 3 Event status remains as it was when you interrupted handling the event. 2. You can go back to handling this event at any time by selecting it again. Related Topics Selecting an Event in Event List (Fast Treatment) [➙ 69] Handling an Event with Investigative Treatment [➙ 71] Handling an Event with Assisted Treatment [➙ 72] Event List and Alarms Operation Reference [➙ 92] 3.1.8 Deselecting (Suspending) an Event in Event List An event is selected.
3 Alarms Working with Alarms Related Topics Event Descriptor Reference [➙ 102] 3.1.11 Inspecting the Source of an Event in System Manager Scenario: From Event List, you want to jump to check the source of an event in System Manager. 1. In the event descriptor of the event you are interested in, click the text in the Source column. The System Manager opens and automatically navigates to the event source.
Alarms Working with Alarms 3 Related Topics Event List Reference [➙ 96] Investigative Treatment Window Reference [➙ 98] Assisted Treatment Window Reference [➙ 99] 3.1.13 Changing the Sorting of Events You want to change the default sorting of events in Event List, for example to order them first by Category. In Event List, click on the Category column header. Default event sorting changes according to the applied criterion.
3 Alarms Working with Alarms Related Topics Handling all Recurrences Together from a Parent Event [➙ 84] Handling Individual Recurrences of an Event Separately [➙ 84] Recurring Events Reference [➙ 114] 3.1.14.2 Handling all Recurrences Together from a Parent Event Scenario: You want to handle all the recurrences of an event at the same time by selecting the parent event and sending alarm-handling commands from there.
Alarms Working with Alarms 3 child recurrence is cleared from the list, the next most recent child recurrence in the set becomes the topmost one, and the details of the parent event will refresh to show its data. Related Topics Expanding or Hiding the Recurrences of an Event [➙ 83] Handling all Recurrences Together from a Parent Event [➙ 84] Recurring Events Reference [➙ 114] 3.1.15 Printing the Whole Event List 1. In Event List, right-click and select Print Event List. 2.
3 Alarms Working with Alarms 3.1.16.2 Applying a Simple Filter to Event List You want to filter Event List by a single criterion, for example, category, date/time, discipline, or source status. 1. In the Summary bar, click the filter icon . 2. Select what you want to filter by (for example, Event Status), and then click the criterion you want to apply (for example, Unprocessed). Event List is filtered to show only the events that match the criterion. The color of the filter icon changes to red .
Alarms Working with Alarms – – – – – – 3 Name/Description: Type in some part of the name or description of the event source. For example Main Server. System (available only for distributed systems). Date and Time: Filter based on when the events occurred. For example yesterday or last quarter hour. Tag: Set whether you want to selectively show or hide tagged events. NOTE: This criterion is not available for UL 864-compliant and ULC S527compliant fire stations and Total Building Solution NA profiles.
3 Alarms Working with Alarms 3.1.16.6 Applying a Previously Saved Event List Filter You previously saved an Event List filter for future use [➙ 87]. 1. In the Summary bar, click the filter icon and select Advanced Filter. 2. In the Advanced Filter dialog box, select the filter you want to apply from the Saved filters drop-down list. 3. Click Apply. Event List is filtered. Related Topics Modifying or Deleting a Saved Event List Filter [➙ 88] 3.1.16.
Alarms Working with Alarms 3 2. Click tag . The event is now tagged, and the tag icon displays in its event descriptor. In case of recurrences of an event, the parent recurring event and all its recurrences are tagged and the Hide tagged events filter applies. If a new recurrence occurs, the parent recurring event shows again and displays only the new recurrence. NOTE: The Recurring Events counter shows the total number of recurrences, regardless of whether they are tagged. 3.
3 Alarms Working with Alarms The list of events will no longer be filtered by tags, but any other filters you applied will still remain active. (Check the Event List header to see them.) Related Topics Tagging Events in Event List [➙ 88] Removing Filters from Event List [➙ 86] Applying an Advanced Filter to Event List [➙ 86] 3.1.16.
Alarms Working with Alarms 3.1.17.2 3 Adding, Removing, or Rearranging Columns in Event List You want to add or remove columns in Event List or you want to rearrange their order. 1. Right-click on the column headers in Event List, and select Customize columns. The Customize columns dialog box displays. 2. Do one or more of the following: – To add a column to Event List, select it in the Available columns list and click Add .
3 Alarms Alarms and Event Treatment Reference 3.2 Alarms and Event Treatment Reference This section provides background information on the alarm management feature of Desigo CC. 3.2.1 Event List and Alarms Operation Reference This section provides background information on alarm-handling. For related procedures, see Working with Alarms [➙ 69]. 3.2.1.
Alarms Alarms and Event Treatment Reference ● 3 Assisted Treatment. If an operating procedure was configured for a particular alarm, the icon in the event button indicates that you can open a dedicated window, with the alarm’s event descriptor displayed along the top, that provides a step-by-step checklist of actions you must complete for handling that alarm. For example, these might include printing out a report, completing a form, reading a document, and so on.
3 Alarms Alarms and Event Treatment Reference ● Operator’s activities relating to alarm handling (for example, initiating/suspending alarm handling, acknowledging/resetting an event, and so on). This log data is available when you generate an Activity Log report.
Alarms Alarms and Event Treatment Reference 3 Event Lamp Display Graphical Display Background Color and Behavior Status Solid gray. No events for that category. Flashes from gray to the category color. New events for that category have occurred in the system, and are still unprocessed. Flashes from gray to the dark category color. Filter by category activated. New events for that category have occurred in the system, and are still unprocessed. Solid category color and not flashing.
3 Alarms Alarms and Event Treatment Reference 3.2.1.3 Event List Reference The Event List displays all the detected alarms with each alarm in a separate row. This window is your main starting point for dealing with alarms. When opened, the Event List displays in the main work area of the user interface (see System Screen Reference [➙ 22]). When it is closed, depending on the profile Event List may be either entirely hidden or collapsed to a vertical bar down the left side of the screen.
Alarms Alarms and Event Treatment Reference 3 1 Summary bar Contains a set of event lamps that provide an overview of the events in the system. For details see Event Lamps Reference [➙ 94] and Summary Bar Reference [➙ 23]. 2 Event Detail bar In some configurations, prominently displays events that require immediate attention across the top of the screen. 3 Title bar Depending on what you select, the title bar of the Event List shows: ● Event List, if no event is selected in the list.
3 Alarms Alarms and Event Treatment Reference 3.2.1.4 Investigative Treatment Window Reference 1 2 3 4 6 5 7 Figure 13: Investigative Treatment Workspace 98 | 393 Siemens Building Technologies 1 Summary bar Contains a set of event lamps that provide an overview of the events in the system. For details see Event Lamps Reference [➙ 94] and Summary Bar Reference [➙ 23].
Alarms Alarms and Event Treatment Reference 7 3.2.1.5 Contextual pane 3 Displays by default and provides additional information, actions, and resources about the point in alarm. The following tabs are available: ● Operation/Extended Operation: Lets you inspect all the properties of the point in alarm, and view and execute any commands/actions available for that object. ● Detailed Log: Lets you view a detailed log of the currently selected event.
3 Alarms Alarms and Event Treatment Reference 4 Event descriptor Contains the event button, event details and alarm-handling commands for the event currently being processed. For details see Event Descriptor Reference [➙ 102]. The background color reflects the event category color, but in a darker shade. The icon in the event button indicates that the event is being processed by assisted treatment.
Alarms Alarms and Event Treatment Reference ● ● ● 3 Automatic or manual Mandatory or optional Repeatable or not repeatable 1 4 5 2 6 3 Figure 15: Steps Workspace 1 Symbol that indicates a mandatory step. 2 Step identifier. This number may or may not correspond to the execution order. 3 Briefly describes the type step.
3 Alarms Alarms and Event Treatment Reference ● Whether the steps must be executed sequentially, or may instead be freely executed in any order, depends on how the assisted-procedure was configured. ● When you move your cursor over a step during the execution of an assisted procedure: – If it turns into hand, this means that you can execute the step. – If it turns into arrow, this means that you cannot execute the step because it is locked.
Alarms Alarms and Event Treatment Reference 3 NOTE: You cannot move, resize, or remove the Event button column. Cause Description of the event followed by the condition (either numeric value or descriptive text) that caused the event. For example, Temperature too high (39°C), Fault (INACTIVE), and so on. This description changes when the event source passes from the Active to the Quiet state. Path Indicates the entire System Browser path of the object in alarm.
3 Alarms Alarms and Event Treatment Reference Source Indicates the object in alarm. Whether the source name or description displays depends on the current display mode. See Setting How Objects are Labeled in System Manager [➙ 36]. For workstation-based alarms, [object name].[property name] displays in this column. How driver-based alarms display - [object name] or [object name].[property name]) - depends on the specific driver.
Alarms Alarms and Event Treatment Reference Information 3 The following become visible only when the event descriptor is selected: : Displays the History Database dialog box for that Event ID, where you can add a note for the event. See Entering an Event Note in the History Database [➙ 81]. : Displays the information text, which indicates technical information about a field point. It also displays the same information shown in the Message Text column.
3 Alarms Alarms and Event Treatment Reference Tag 3.2.1.7 Lets you to tag/untag events, so that you can selectively show/hide them in Event List. See Using Tags to Selectively Show or Hide Events [➙ 88]. This button will be visible but inactive in the Event Detail bar, and the Tag column will not appear in Investigative/Assisted Treatment. Event Button Reference An event button is a graphic indicator that displays on the left side of an alarm's event descriptor [➙ 102].
Alarms Alarms and Event Treatment Reference Waiting for condition Active Wait for condition or Complete Operating Procedure 3.2.1.8 3 You acknowledged the event but no further action is yet possible, and the Reset command is not available. Ready to be Closed Active Reset event You already selected the event, and the Reset command is available. Ready to be Closed Quiet Reset event The event source is back to normal. The Reset command is available.
3 Alarms Alarms and Event Treatment Reference Event Categories in Total Building Solution AT Profile English Text German Text Color Notes Fire Alarm Brandalarme Red Events related to an immediate threat to life, safety or health, created by Emergency call. Fire Fault Brandstörungen Yellow Events related to an immediate threat to life, safety or health, created by system Fire Control Brandsteuerungen Green Events related as an immediate threat to property or may become life-threatening.
Alarms Alarms and Event Treatment Reference 3.2.1.9 3 Event Disciplines Reference Icon (examples) Discipline Building Automation Building Infrastructure Energy Management Fire Management System Notification Security 3.2.1.10 Alarm-Handling Commands Reference Command Description Notes Acknowledge the event Available when event status = Unprocessed and suggested action = Acknowledge event.
3 Alarms Alarms and Event Treatment Reference Visibility of Alarms and Commands ● ● ● ● 3.2.1.11 You cannot handle events generated by field points for which you do not have proper user privileges. Such alarms and the related commands will not be visible to you in Event List.
Alarms Alarms and Event Treatment Reference Closed Suspend the event - 3 You reset the You closed the event, and the event and now you source status is can clear it. back in normal condition. You can clear the event.
3 Alarms Alarms and Event Treatment Reference No Reset (ACK only required) ● ● Alarm handling started (and at least Unprocessed one alarm-handling command sent) Waiting for Event source back to Quiet condition Waiting for condition (due to mandatory steps) Ready to be closed Closed ● ● Alarm handling not started yet (and no alarm-handling command sent yet) Event source back to Quiet Unprocessed Waiting for condition (due to mandatory steps) Ready to be closed Closed No ACK, No Reset ● Alarm handl
Alarms Alarms and Event Treatment Reference 3.2.1.12 3 Event Sorting Reference ● ● ● If there are no arrows in any of the column headers, it means the default Event List sorting is applied. In some Client Profiles: – A small up or down arrow in one of the column headers in Event List indicates that a non-default sorting order was applied. – In the case of recurring events, the sorting only applies to the parent event.
3 Alarms Alarms and Event Treatment Reference 3.2.1.13 Recurring Events Reference A recurring event occurs when the same event source repeatedly generates the same alarm condition. More specifically, this happens when the same property of a field point continuously switches between the active and quiet states. For related procedures, see Handling Recurrences of an Event [➙ 83].
Graphics Viewer Working with Graphics Viewer 4 4 Graphics Viewer This section provides information and instructions for using the Graphics Viewer application in Desigo CC. 4.1 Working with Graphics Viewer This section provides step-by-step instructions for performing common Graphics Viewer tasks. For background information, see Graphics Viewer Reference [➙ 123]. Perform the procedures in this section as needed. 4.1.
4 Graphics Viewer Working with Graphics Viewer 3. Click the command button that displays the command you want to execute. If the command does not have arguments associated with it, the command is sent and the status displays. 4. (Optional) If the command button has arguments associated with it, proceed to Step 5. 5. (Optional) Complete the required fields if any are associated with the command. 6. Click Send. The system displays the status of the command. 4.1.
Graphics Viewer Working with Graphics Viewer 4 1. In System Browser, select Application View. 2. Select Application > Graphics or an existing sub-folder as the location for your new graphics folder. 3. Click New and select New Folder. 4. In the Create New Folder dialog box, type a name for the new folder. 5. Click OK. The folder is available in System Browser. 4.1.5 Deleting a Graphic Item You want to delete a graphic item, a graphic or a folder, from the Graphics folder.
4 Graphics Viewer Working with Graphics Viewer 4.1.8 Displaying and Hiding Coverage Area A graphic is displayed in the Graphics Viewer and you want to display the coverage area for the cameras or any monitoring device on the graphic. The coverage area shows the objects on your graphic that are within the viewing or monitoring range of a camera or device. System Manager is in Operating mode. 1. In System Browser, select Application View. 2. Select Applications > Graphics. 3. Click Coverage Area .
Graphics Viewer Working with Graphics Viewer 4 A graphic is displayed in the Graphics Viewer. If you are dragging an object or symbol to the Graphics Editor, you must have another System Manager pane open. See, Launching a New System Manager. 1. Hover over an element or symbol in the Graphics Viewer. A red border displays around the highlighted object. 2. Click and drag. The cursor changes to . 3. Release the mouse button when the cursor changes to over the intended drop target.
4 Graphics Viewer Working with Graphics Viewer You have an element on a graphic that if selected links to an internal or external element. 1. (Optional) Move your cursor over the element to display the tooltip and view the linked path and descriptive text about the linked element. 2. Click or double-click the element. If the link is an internal Desigo CC link, the linked item becomes the primary selection. If the link is external, the document, website, or application displays. 4.1.
Graphics Viewer Working with Graphics Viewer 4.1.17 4 Selecting Objects within Graphics Viewer You have a graphic open, and you would like to view the properties of an object on the graphic. System Manager is in Operating mode. 1. In System Browser, select Application View. 2. Select Applications > Graphics > [graphic]. 3. Click the object. You can also select multiple objects by holding down the CTRL key while clicking on more than one object.
4 Graphics Viewer Working with Graphics Viewer 4.1.19 Working with the Aerial View You have a graphic open and would like to display the Aerial View. System Manager is in Operating mode. 1. In System Browser, select Application View. 2. Select Applications > Graphics > [graphic]. 3. Click Aerial View . The Aerial View displays. 4. Do one of the following: – – Click a specific area to adjust the view. The clicked area is the center.
Graphics Viewer Graphics Viewer Reference 4 4.2 Graphics Viewer Reference This section provides background information for using the Graphics Viewer. For related procedures, see Working with Graphics Viewer. 4.2.1 Overview of Graphics Viewer The Graphics Viewer allows you to display and view graphics in your facility.
4 Graphics Viewer Graphics Viewer Reference 4.2.1.1 About Tooltips Tooltips are customizable properties that display as a yellow text box when you mouse-over an element or object on the active graphic. The text box for a tooltip contains descriptive text, the current value of the graphic object, and the names of the associated objects based on the view selected in System Browser. When you move your cursor over an object or element on the active graphic, an associated tooltip displays. Tooltips 4.2.1.
Graphics Viewer Graphics Viewer Reference 4.2.1.4 4 Point Centered Display Mode Point Centered Display mode ensures that a selected data point or group of data points will always be centered in the Graphics Viewer. For example, you might be required to put a data point in this mode if you are monitoring a fire system in a chemical manufacturing facility with key sensors that must always be viewed.
4 Graphics Viewer Graphics Viewer Reference More about the Status and Commands Window The Status and Commands window is a floating view that displays over an object on the canvas, and can be moved around in the Graphics Viewer. The Status and Commands window displays a connection line to its associated objects on the canvas. The connection point of the connection line, anchors itself in the following manner: ● Non-engineered elements: The connection point aligns itself to the center of the element.
Graphics Viewer Graphics Viewer Reference 4 coverage area, a tooltip displays the object’s name or description. The background color of the coverage area varies depending on the configuration of the project. When you initially load a graphic, the coverage area of a camera is not visible in the Graphics Viewer. You must toggle the Coverage Area icon from the Graphics Viewer toolbar to view the coverage area of any monitoring devices on the graphic.
4 Graphics Viewer Graphics Viewer Reference If you click a symbol on a graphic or, the referenced object of the symbol becomes the secondary selection, while the primary selection remains the same in System Browser. The following figure illustrates the primary selection in System Browser, Analog Output 1. In the Graphics Viewer, the Operation tab changes its display to correspond to the new, secondary selection. System Browser displays the original, primary selection, to show your starting point.
Graphics Viewer Graphics Viewer Reference 4 When you select an object from System Browser that is associated with a graphic, the Graphics Viewer displays the representative graphic and the object’s associated symbol on the graphic is selected. As a result, the Operation tab displays the object properties to correspond to the selection. Double-clicking a symbol on a graphic makes the referenced object associated with the symbol the primary selection in System Browser and all workflows update accordingly.
4 Graphics Viewer Graphics Viewer Reference Data Point Access Privileges Data points are integrated into a graphic by associating them with elements. These data points and elements can be evaluated by creating expressions that result in a graphic that allows you to view dynamic values of a facility, building, or piece of equipment. Data points therefore always display using the elements they are associated with.
Graphics Viewer Graphics Viewer Reference 4 Zoom View Displays the Zoom view and allows you to zoom in on the active graphic by adjusting the slider. Aerial View Switches between Aerial View being visible or hidden in the Graphics Viewer area. Zoom Real Allows you to zoom in on the active graphic. To activate, click the icon. To de-activate, left- click anywhere on the graphic. Scale to fit Scales the graphic to fit in the viewing area.
4 Graphics Viewer Graphics Viewer Reference 4.2.2.2 Views The Graphics Viewer provides you with two floating views, the Aerial View and the Graphic Navigation View, to help you navigate the active graphic. Both views can be resized and toggled to display or not, using the Graphics Viewer toolbar. Aerial View The Aerial View provides you with a bird’s-eye view of the active graphic at all times.
Graphics Viewer Graphics Viewer Reference 4 Navigation View The Graphic Navigation View allows you to customize and navigate through views of the active graphic by selecting a depth and then filtering, by discipline or by layer, which of the associated layers to display. If you choose to filter the layers by discipline, only the layers designated with that discipline display in the graphic view.
4 Graphics Viewer Graphics Viewer Reference 4.2.2.3 Status and Commands Window The Status and Commands window displays the following information about an object, its properties, and its status. Name Description 1 Icon Displays the icon associated with the property type. 2 Object path and object name The path and the name of the object. 3 Property name Displays the name of one or more properties associated with the object the selected objects.
Graphics Viewer Graphics Viewer Reference 6 Command area 4 Displays the name of a command that you can initiate. If a command button has a triangle in the lower right-hand corner, the command has multiple buttons or options, and clicking on the triangle displays the options. Some commands are sent immediately after you initiate them by clicking on the Command button. Others require you to enter arguments before they can be sent.
4 Graphics Viewer Graphics Viewer Reference 4.2.2.4 Status and Commands Connection Lines Visibility of the connection line and its connection point are controlled as follows: ● A connection line and its connection point are only visible if the element is visible. ● An element is only visible when the layer is visible that contains the element. ● A layer is only visible if a depth is visible that contains that particular layer.
Graphics Viewer Graphics Viewer Reference 4 PLUS SIGN Zoom In (+20%) Z-key Activates Quick Zoom mode. Cursor changes to the magnifying glass and allows you to draw a viewport directly on the active graphic. The previous tool mode is restored when the key is released. 4.2.2.6 F5 Refresh. All views are refreshed. All open graphics are reloaded.
5 Remote Notifications Working with Remote Notifications 5 Remote Notifications This section provides instructions and background information for using Remote Notifications: in Desigo CC. 5.1 Working with Remote Notifications This section provides step-by-step instructions for some common Remote Notifications tasks. For background information, see Remote Notifications Reference [➙ 143]. Perform the procedures in this section as needed. 5.1.
Remote Notifications Working with Remote Notifications 5 Next Step: If required, proceed to Monitoring the Progress and Outcomes of Sent Notifications [➙ 139]. Related Topics New Remote Notification in the Secondary Pane [➙ 152] Address Book Reference [➙ 378] Creating Recipient Groups for Remote Notifications in the Address Book [➙ 376] Remote Notifications Reference [➙ 143] 5.1.
5 Remote Notifications Working with Remote Notifications Related Topics Remote Notifications Message Status List [➙ 144] 5.1.3 Re-Sending a Remote Notification from the Message Status List Scenario: You want to re-send a remote notification that was previously not completed successfully (for example, its overall outcome was Failed or Aborted). System Manager is in Operating mode. 1. In System Browser, select Application View. 2. Select Applications > Remote Notifications.
Remote Notifications Working with Remote Notifications 5 Next Steps: If required, proceed to: ● Monitoring the Progress and Outcomes of Sent Notifications [➙ 139] ● Stopping a Remote Notification from Event List [➙ 141] Related Topics Remote Notifications Reference [➙ 143] 5.1.5 Stopping a Remote Notification from Event List Scenario: Sending of a remote notification is in progress. The notification was configured with Starting Mode = Manual and Can be stopped = Yes.
5 Remote Notifications Working with Remote Notifications Related Topics Monitoring the Progress and Outcomes of Sent Notifications [➙ 139] Remote Notifications Message Status List [➙ 144] 5.1.7 Halting the Escalation of a Remote Notification Scenario: Sending of a remote notification is in progress. You want to halt its escalation, so that the message is not sent to the escalation recipients. System Manager is in Operating mode. You are displaying the Message Status list. 1.
Remote Notifications Remote Notifications Reference 5 NOTE: When you disable a remote notification, the management platform generates an event. This event is automatically cleared when you re-enable the remote notification. Related Topics Remote Notifications Reference [➙ 143] 5.2 Remote Notifications Reference This section provides background information on the remote notifications feature of Desigo CC and communication services (email. SMS, pager). 5.2.
5 Remote Notifications Remote Notifications Reference How Recipients can Reply to a Remote Notification When the recipients receive a remote notification message (via email, SMS, or pager) they can acknowledge the notification by replying to the message in the following ways. ● Email: reply to the email message without adding any additional text.
Remote Notifications Remote Notifications Reference 5 – ● Select Project > System Settings > Related Items Templates > New Remote Notification View the remote notifications triggered by a point currently in alarm: – Select the point in alarm in System Browser. (You can do this by doubleclicking the event source in the event descriptor of the alarm that triggered the notification.
5 Remote Notifications Remote Notifications Reference Compact Notification Summary (information in unexpanded/topmost row) For new (operator-issued) notifications: [type of sending (always manual)] – [date and time] – [overall RENO outcome ] For alarm-triggered notifications: [Name] – [Alarm ID] – [type of sending (automatic/manual)] - [overall RENO outcome] Type of sending For alarm-triggered notifications, can be automatic or manual depending on configuration.
Remote Notifications Remote Notifications Reference 5 Recipients Summary The first level of the recipients’ summary shows a list of the recipient groups configured for the remote notification. You can expand each recipient group to see further details about that group and its members.
5 Remote Notifications Remote Notifications Reference Status Applies to group status, escalation status, and notification status of an individual contact. 148 | 393 Siemens Building Technologies Empty The remote notification has not started yet. Running The remote notification is in progress. Pending The message has been sent to the designated recipients and the system is awaiting a reply (the timeout for a response has not yet elapsed).
Remote Notifications Remote Notifications Reference 5.2.2.2 5 RENO Messages Toolbar Controls In Operating mode, when you work with remote notifications, the RENO Messages toolbar is available. It allows you to start, stop, and clear remote notifications. Alarm-based notifications Start RENO procedure Stop RENO procedure New notifications Start sending or re-sending the currently selected remote notification. The icon is dimmed while sending is in progress.
5 Remote Notifications Remote Notifications Reference 5.2.2.3 Message Status Summary Situation Status Remote notification outcome Groups Recipients The remote notification is initialized, but has not yet started. Initialized — — The remote notification is automatic and time-delayed, and the operator stops it before it starts. Aborted Cancelled Cancelled Pending Acknowledged The remote notification has Running started (regardless of whether it is automatic or manual).
Remote Notifications Remote Notifications Reference The operator has stopped the manual remote notification. Aborted Cancelled 5 Acknowledged Timed out The status of the recipients that replied does not change. Cancelled The status of the recipients that did not reply within the timeout does not change. The status of the recipients that replied after the remote notification is aborted changes to Acknowledged. No replies are required for a group and the related recipients.
5 Remote Notifications Remote Notifications Reference 5.2.3 New Remote Notification in the Secondary Pane You can open RENO Message in the Secondary pane, and can switch to the New Remote Notification workspace. Here you can compose a message, define the recipients, and send an operator-issued remote notification, that is, one that is not triggered by an alarm.
Schedules Working with Schedules 6 6 Schedules This section provides background information and instructions for using BACnet schedules, management station schedules and the Timeline Viewer in Desigo CC. 6.1 Working with Schedules This section provides step-by-step instructions for using BACnet schedules, management station schedules and the Timeline Viewer. For background information, see Schedules Reference [➙ 165]. Perform the workflows in this section as needed. 6.1.
6 Schedules Working with Schedules 6.1.1.3 Adding a Command System Manager is in Operating mode. 1. In System Browser, select Application View. 2. Select Application View > Schedules > BACnetCommands. 3. From the Text Group drop-down list, select the text group you want associated with this command. 4. In the Command Table Action List, click New. 5. Highlight the text in the new action list, and enter a name. 6. From System Browser, drag the desired object to the action list. 7.
Schedules Working with Schedules 6.1.1.6 6 Adding an Exception Entry System Manager is in Operating mode. 1. In System Browser, select Application View. 2. Select Schedules > BACnetSchedules. 3. Open the schedule you want to add an exception entry to. 4. Right-click the exception to which you want to add an entry. 5. Click Add New Exception Entry. 6. In the Schedule entries section, complete the fields. 7. Click Save 6.1.1.7 . Copying a BACnet Calendar System Manager is in Operating mode. 1.
6 Schedules Working with Schedules 5. In the Save Object As dialog box, enter a name. 6. From the Field Device drop-down list, select the panel you want this command associated with. 7. Click OK. 6.1.1.10 Deleting a BACnet Calendar System Manager is in Operating mode. 1. In System Browser, select Application View. 2. Select Schedules > BACnetCalendars. 3. Open the calendar you want to delete. 4. From the Scheduler toolbar, click Delete. 5. Click OK. 6.1.1.
Schedules Working with Schedules 6 delete default entries at other times, as long as there are still entries at beginning and end of day. You can also replace the entry at beginning or end of day with a non-default entry. 6. Click Save 6.1.1.14 . Deleting an Exception System Manager is in Operating mode. 1. In System Browser, select Application View. 2. Select Schedules > BACnetSchedules. 3. Open the schedule. 4. Right-click the exception you want to delete.
6 Schedules Working with Schedules 1. To delete a calendar entry, click the Delete icon associated with the entry. NOTE: Do not click the Delete icon from the Scheduler toolbar, or you will delete the entire calendar. 2. To add a calendar entry, click the New+ button, and then select the settings you want. 3. Click Save 6.1.1.17 . Modifying a Command System Manager is in Operating mode. 1. In System Browser, select Application View. 2. Select Schedules > BACnetCommands. 3.
Schedules Working with Schedules 6.1.1.20 6 Modifying an Exception Entry System Manager is in Operating mode. 1. In System Browser, select Application View. 2. Select Schedules > BACnetSchedules. 3. Open the schedule you want to modify. 4. In the schedule area, select the exception entry you want to modify. NOTE: Exception entries are highlighted with a red bar on the left side of the entry. 5. In the Exceptions tab, modify the fields as needed.
6 Schedules Working with Schedules 5. Click Save . 6. In the Create New Object dialog box, do the following: a. Complete the Name and Description fields. b. Click OK. The new object displays in System Browser. 6.1.2.3 Adding a Weekly Schedule Entry 1. In System Browser, select Application View > Schedules > Management Station Schedules. 2. Open the schedule to which you want to add a new weekly schedule entry. 3. Right-click in the schedule area. 4. Click Add New Weekly Schedule Entry. 5.
Schedules Working with Schedules 6.1.2.6 6 Copying a Management Station Calendar 1. In System Browser, select Application View > Schedules > Management Station Calendars. 2. Open the calendar you want to copy. 3. Click Save As . 4. Complete the Name and Description fields. 5. Click OK. 6.1.2.7 Copying a Management Station Schedule 1. In System Browser, select Application View > Schedules > Management Station Schedules. 2. Open the schedule you want to copy. 3. Click Save As . 4.
6 Schedules Working with Schedules 4. In the Schedule Entries tab, locate the entry you want to delete and click Delete . NOTE: You cannot delete default values. 5. Click Save 6.1.2.11 . Deleting an Exception 1. In System Browser, select Application View > Schedules > Management Station Schedules. 2. Open the schedule with the exception you want to delete. 3. In the schedule area, right-click the exception you want to delete.
Schedules Working with Schedules 6.1.2.14 6 Modifying a Weekly Schedule Entry 1. In System Browser, select Application View > Schedules > Management Station Schedules. 2. Open the schedule you want to modify. 3. In the schedule area, click the weekly schedule you want to modify. Schedules are highlighted with a blue bar on the side of the entry. 4. In the Schedule Entries tab, modify the Time and Value fields as needed.
6 Schedules Working with Schedules 6.1.3.2 Bringing the Current Day into View Using the Time Range scrollbar, you have scrolled away from the current day and would like to return to it quickly. 1. From the Timeline toolbar, select Show Today . NOTE: Selecting the Show Today icon does not affect any preset time period you have chosen. 6.1.3.3 Changing the Preset Time Span 1. From the Timeline toolbar, click Preset time spans . 2. Select the time span you want to display in the viewer.
Schedules Schedules Reference 6 6.2 Schedules Reference The Schedules component of the management platform enables you to: ● Set up schedules to automate the operation of the building control site: Schedules are defined on a weekly and daily basis. You can specify a different hourly timetable for each day of the week. For example, you could schedule a heating system to work from 9 a.m. to 6 p.m. on Mondays and Fridays and from 8 a.m. to 8 p.m.
6 Schedules Schedules Reference an entry for Occupied/Unoccupied, save it, and then drag it from System Browser to a schedule of your choice. The schedule will determine what time the command executes, the start and end dates, and the frequency of repetition. BACnet calendars allow you to override a scheduled event. In this sense, you can consider them as exception schedules, consisting of dates only.
Schedules Schedules Reference 6.2.1.2 Siemens Building Technologies 6 BACnet Schedule Workspace User Guide Version 3.
6 Schedules Schedules Reference Name Description 1 Schedule Name Displays the name of the schedule. 2 Scheduler Toolbar Includes the following icons: New+: Opens a New BACnet Schedule, New Management Station Schedule, New BACnet Calendar, New Management Station Calendar, or New BACnet Command Table. Save: Saves the schedule to the system. Save As: Allows you to save another instance of the schedule with a different name and description. Delete: Deletes the schedule from the system.
Schedules Schedules Reference 6 6.2.1.3 Siemens Building Technologies Current Time Indicator 6 Displays a light-blue bar indicating the time of day. BACnet Calendar Workspace Name Description 1 New+ Button Opens a new calendar entry. 2 Applied Schedules Displays a list of schedules referencing the calendar. Clicking a schedule in this section sends data about the object to either the Operation or Extended Operations tabs.
6 Schedules Schedules Reference 6.2.1.4 170 | 393 Siemens Building Technologies BACnet Command Workspace Name Description 1 New+ Button Opens a new command table. 2 Scheduler Toolbar Includes the following icons: New+: Opens a New BACnet Schedule, New Management Station Schedule, New BACnet Calendar, New Management Station Calendar, New BACnet Command Table, or New Management Station trigger. Save: Saves the command object to the system.
Schedules Schedules Reference 6.2.2 6 Management Station Schedules Reference This section provides background information for using management station schedules. For related procedures, see Working with Management Station Schedules [➙ 159]. 6.2.2.1 Overview of Management Station Schedules and Calendars You can create daily or weekly schedules for your management stations, and a management station can run multiple calendars or schedules at the same time.
6 Schedules Schedules Reference 6.2.2.2 172 | 393 Siemens Building Technologies Management Station Schedule Workspace User Guide Version 3.
Schedules Schedules Reference 6 Name Description 1 Schedule Name Displays the name of the schedule. 2 Scheduler Toolbar Includes the following icons: New+: Opens a New BACnet Schedule, New Management Station Schedule, New BACnet Calendar, New Management Station Calendar, or New BACnet Command Table. Save: Saves the schedule to the system. Save As: Allows you to save another instance of the schedule with a different name and description. Delete: Deletes the schedule from the system.
6 Schedules Schedules Reference 6.2.2.3 174 | 393 Siemens Building Technologies Management Station Calendar Workspace Name Description 1 New+ Button Opens a new calendar entry. 2 Applied Schedules Displays a list of schedules referencing the calendar. 3 Scheduler Toolbar Includes the following icons: New+: Opens a New BACnet Schedule, New Management Station Schedule, New BACnet Calendar, New Management Station Calendar, or New BACnet Command Table. Save: Saves the calendar to the system.
Schedules Schedules Reference 6.2.3 6 Timeline Viewer Reference This section provides background information for using Timeline Viewer. For related procedures, see Working with Timeline Viewer [➙ 163]. 6.2.3.1 Overview of Timeline Viewer Timeline Viewer allows you to view the details of multiple management station and field panel schedules simultaneously, spanning a range of time. To do this, System Manager must be in Operating mode.
6 Schedules Schedules Reference 6.2.3.2 176 | 393 Siemens Building Technologies Timeline Viewer Workspace Name Description 1 Time Range Scrollbar Allows you to control the date range of schedules. 2 Schedule Name Displays the name of the schedule with schedule details appearing on the row below it. 3 Schedule Details Hovering on an interval displays a tool tip with schedule details. Intervals also use color coding and hatch marks to provide basic information at a glance.
Trends Working with Trends 7 7 Trends This section provides background information and instructions for using the Trends application in Desigo CC. 7.1 Working with Trends This section provides step-by-step instructions for using the Trends application. For background information, see Trends Reference [➙ 204]. Perform the procedures in this section as needed. 7.1.1 Defining Trend Views You need a Trend View definition to graphically record data.
7 Trends Working with Trends Start Yes Change user default No Change user default System Browser Data point tree System Browser Data point tree Create Trend View System Browser Trend-Log object Select data point Select Trend-Log Select data point Select New Trend in Related Items Assign data serie - Properties - Axis - Legend - Background Configure diagram Configure data serie - Line type - Line size - Line color - Marker - Label - Quality attributes Save Trend View End 1.
Trends Working with Trends 7. Click Save 7 . NOTE: The values display in the Trend View as soon as the data point value changes. 8. Select the Trend View Definitions folder. 9. Complete the Name field for the Trend View and click OK. 7.1.1.1 Creating Trend View Definition A Trend View definition normally is customized only once in a project. This ensures that all Trend Views that are created look the same (see User Default table). 1. In System Browser, select Application View. 2.
7 Trends Working with Trends NOTE: You can create additional sub-folders as needed. However, it is recommend saving Trend Views in a structured manner by building topology or electrical and mechanical installations. 7.1.1.3 Creating New Trend View from System Browser You are in System Browser, and the Trend application is closed. 1. In System Browser, select Application View. 2. Select Trends > Trend View Definitions. The Trend application opens. 3. Click New > New Trend . 4.
Trends Working with Trends 7.1.1.4 7 Creating and Saving New Trend View 1. In System Browser, select Application View. 2. Select Applications > Trends. 3. Click New and then New Trend . 4. Select one of the following: – – Offline Trend-Log Object in the folder Offline Log Objects. Online Trend-Log Object in the folder Online Log Objects. 5. Click or drag-and-drop to add the Trendlog object to the new Trend View. 6.
7 Trends Working with Trends – – From the Grid drop-down list, select the corresponding background grid for the Trend View. From the Background drop-down list, select the corresponding background color for the trend view or click More color to define a customized color. 4. In the Titles group box, do the following: – – – Complete the Name field for your Trend View. Complete the Title field for the left Trend View border. Complete the Title field for the right Trend View border. 5. Click Save .
Trends 7 Working with Trends 7.1.1.9 Defining Line Properties A Trend View is open. 1. Select the series for editing from the legend for the Trend View. 2. Click Properties . 3. Click the Series Properties tab. 4. Select Visible and enable it. 5. Select the appropriate type from the Series line type drop-down list. 6. Select the appropriate style from the Series line style drop-down list. 7. Select the appropriate color from the Series stroke color drop-down list. 8.
7 Trends Working with Trends 3. Click the Series Properties tab. 4. Select the Show markers check box. – Select the corresponding type from the Marker style drop- – down list. Select the appropriate size from the Marker size drop-down list. 5. Click Save . The edited properties are saved to the Trend database. 6. Click Stop to stop the new data updates in the trend view. The markers display on the trend view. NOTE: Be careful not to select too thick a line if you want to display markers.
Trends Working with Trends 7 NOTE 1: Measured values display on top of one another when the changes to the measured values occur in quick succession or the selected time range is too large. Since the measured values are no longer readable, select a smaller time range or switch off the labels. NOTE 2: You can see the measured values only when you stop the Trend View. Related Topics Displaying Quality Attributes [➙ 219] Series [➙ 225] 7.1.1.
7 Trends Working with Trends 7.1.1.13 Positioning the Y-Axis A Trend View is open. 1. Select the series for editing from the legend for the Trend View. 2. Click Properties . 3. Click the Series Properties tab. 4. In the drop-down list, select Y-axis position 5. Click Save . . The Y-axis displays either on the left or right side of the chart. NOTE: The position is set and cannot be changed for digital and multistate data types. Related Topics Series [➙ 225] 7.1.1.
Trends Working with Trends 7 The Trend View is open. 1. Right-click the legend header. 2. Enable the required column. The selected column is added to the legend view. 3. Click and hold down the left mouse button on the column header. 4. Move the column to the desired location and release the mouse button. 5. Point to the separator line and adapt the column width. 6. Click Save . NOTE: Changes to this legend view are not saved to the Trend View definition. 7.1.1.
7 Trends Working with Trends NOTE: The Create Trendlog Object in BACnet Device option is not available if you select an object which is not of type BACnet. 4. In the Create BACnet Trendlog Object dialog box: – – – – Enter a unique Trendlog Object Name. Select the Device where you store the offline Trendlog object. Enter the Buffer size from 0‒500. Select the Logging Type: Polled: The data entry is polled periodically as per the settings in Logging interval, Align intervals, and Interval offset.
Trends Working with Trends 7 When the Logging Type is polled, enter the Log Interval cycle time (seconds) used to log values of an external data source in the trend log buffer. 6. Click OK. The offline Trendlog multiple object is created. 7. Click OK. The offline Trendlog multiple object is saved and visible in System Browser after 10 – 60 seconds in the folder Trends > Offline Log Objects > [own path structure]).
7 Trends Working with Trends of the same type. For example, if you have selected 2 Analog Input objects, that are associated with 2 individual trend log objects, the properties of the trend log objects display in the Contextual pane. However, if one trended object is associated with a trend log object and another with a trend log multiple object, then the properties do not display as these objects are of different types. 4.
Trends Working with Trends 7 4. Click anywhere on the row. The fields to set the execution time opens. 5. Set the date, day and time to execute the macro. 6. In System Browser, select Applications > Logics > Macros > [MyMacro Trendlog upload] and drag-and-drop the object to the Output expander section. 7. Click Save As . 8. Enter a name and description. 9. Click OK. The reaction for Trendlog upload is defined. 7.1.2.
7 Trends Working with Trends NOTE: An entry in the Event list displays if a trendlog object has an invalid address. The message can be suppressed by: - Setting the Log Enable property to Disable. - Clearing the BACnet reference. 7.1.2.7 Deleting Offline Trendlog Objects 1. In System Browser, select Application View. 2. Select Trends > Offline Log Objects > [Trendlog Object]. 3. Select the offline Trendlog object in the data point legend. 4. Right-click and select Delete Trendlog Object in BACnet Device.
Trends Working with Trends 7.1.3.2 7 Selecting the Time Range using the Time Range Scrollbar Setting Time Range and Time Window You want to define the visible time range as well as the corresponding time window for a Trend View. You are in an active Trend View. 1. In the Trend View, navigate to the left or right slider (dark grey area) of the time range slider. The shape of the mouse pointer changes and the tooltip displays. 2.
7 Trends Working with Trends – – Select month and year with the Click the appropriate date. symbols. 6. Click the displayed time at Start time and enter the desired start time. 7. Click the displayed End time. The Calendar dialog box opens. 8. Click the displayed time at End time and enter the desired end data in the Calendar dialog box. – – Select month and year with the Click the appropriate date. symbols. 9. Click the displayed time at End time and enter the desired stop time. 10. Click OK.
Trends Working with Trends 7 4. In the Interval text field, enter a time range from 1 to X and select the corresponding time unit in the drop-down list. 5. From the Start/end time drop-down list, select Ending. 6. Click the displayed date and enter the desired stop date in the Calendar dialog box. – – Select Month/Year with the Click the appropriate Date. symbols. 7. Click the displayed time and enter the desired stop time. 8. Click OK.
7 Trends Working with Trends Start/Stop Range You are in an active Trend View. 1. In the Trend View, point the mouse to the left or right end point (dark grey area) for the Time Range slider. The mouse pointer changes shape and the tooltip displays. 2. Right-click the Time Range slider. Predefined time ranges display. 3. Select the desired time range. The time range displays with the corresponding data period in the Trend View.
Trends Working with Trends 7 3. Drag the pointer to the right zoom end range. The selected zoom range displays in the Trend View. 4. Click Zoom . The original time range, prior to the zoom in, displays, even if you zoom multiple times. 7.1.3.10 Selecting Table View Switching between graphic and table allows for efficiently analyzing data. A Trend View is open. 1. Click Stop . The automatic data update is stopped. 2. Click table view . The table opens in default view.
7 Trends Working with Trends 1. Click Properties . The menu bar displays above the Trend View. 2. Select the series you want to hide in Legend. 3. Click Series Properties. 4. Clear the Visible check box. The menu bar is hidden. The series is hidden in the Trend View. The Trend data is still recorded for this series, but is no longer displayed. 5. Click Save . Repeat Steps 2 through 4 for each additional series you want to hide. NOTE: As an alternative, you can click either or in the legend.
Trends Working with Trends 7.1.4.1 7 Printing Trend Data from Reports You have selected an existing Report Definition in System Browser > Reports or you have created a Report Definition. One or more local printers are configured in the System. 1. Click the Home tab. 2. Do one of the following: – From the Insert group box, click the Plot group box, and select a Trends plot and drag-and-drop it onto the selected Report Definition. NOTE: The cursor changes and indicates the selected plot name.
7 Trends Working with Trends – Paper size. 5. Click Print and Close to print, or click Close. 7.1.5 7.1.5.1 Manual Correction Application Accessing the Manual Correction Application From System Browser 1. In System Browser, select Application View. 2. Select Applications > Trends > Manual Correction. 3. Drag the object whose property details are to be displayed from System Browser to the Manual Correction tab. 4.
Trends Working with Trends 7 4. Specify the time range for which you want to view the details by specifying the date and time in the Time filter section. By default, the time range is defined for a 24-hour time period. 5. Click Run . The date/time, value, unit, and status of the selected trended property displays in the Filtered Data section in a column pattern in a grid. NOTE: You can fetch the latest data from the database by modifying the time period in the Time filter. 7.1.5.
7 Trends Working with Trends 1. Select the data entry row to be modified in the Filtered Data section and click Edit . The Edit Trend Entry dialog box displays. 2. Modify the value and add comments. NOTE: The comments entered are logged in the activity log. 3. Click OK. 4. Click Run . The Filtered Data section refreshes to display the updated value for the selected row. NOTE: You can also modify a row by right clicking the row and selecting Edit Trend Entry from the options. 7.1.5.
Trends Working with Trends 7 Applying the Custom Filter You can apply the custom filter on the Time and Value columns. The information of the selected trended property displays in the Filtered Data section. 1. Navigate to the Time or Value column on which you want to apply the custom filter. 2. Click the inverted triangle icon and select Custom Filter from the menu options. The Custom Filter dialog box displays. 3.
7 Trends Trends Reference – number) number of hours for which you want to display the data. The last 'X' number of hours is with reference to the value of the hour present in the To field in the Time Filter section. For example, if the value in the To field is "5/17/2016 05:23:19 PM", and you select the Last 1 Hour option, then the data for the 04:00:00.000 PM to 04:59:59.999 PM time period will display.
Trends Trends Reference Time interval based 1 70.8°F 2 70.3°F 3 70.8°F 7 4 72.5°F Room temperature Interval 73.0°F 72.0°F 71.0°F 70.0°F COV based = 1.0 ● 1 70.0°F 2 71.0°F 3 72.0°F 4 71.0°F 5 72.0°F 6 71.0°F Triggered Refers to the BACnet reference names of the selected trigger from reaction, scheduler or the BACnet reference. NOTE: The Trends application is covered by a license. In order to access the Trends application, you must ensure that the Trends license is available in your system.
7 Trends Trends Reference NOTE: An uninterrupted site connection with the management station is required. Measured values may be irretrievably lost when the site is interrupted during data recording. Therefore, online trend is not well suited for long-term secure data recording. Offline Trend Offline trend data is used for long-term storage and retrieval of historical data for the analysis of entire plants or single processes. With offline trend, data is recorded directly in the automation station.
Trends Trends Reference 7 Online Trendlog Objects Data recorded by online trending and saved to the trend database (for example, using save continuously) can be retrieved and displayed in the trends. Online Trendlog objects record data also when the Trend View is closed. Database Storage Capacity In the database, 10 GB is saved for the SQL Server Express and 250 GB of historical data for SQL-Server. Once 90% of the database size is reached, 10% of the oldest data entries are deleted.
7 Trends Trends Reference 7.2.5 Trends Workspace Trends are divided into the following main elements: 1 208 | 393 Siemens Building Technologies 2 3 5 4 Name Description 1 System Browser Displays available Trendlog objects, as well as created Trend Views. 2 Configuration Toolbar Displays buttons for commonly used commands (New, Save, Print, zoom). 3 Compare view Allows you to compare measured values from the same Trend View.
Trends Trends Reference 7.2.5.1 7 System Browser All Trendlog objects or Trend View definitions display hierarchically in the System Browser in a tree structure. Click or drag-and-drop to temporarily view Trendlog objects in a Trend View or configure a specific object and save it in a Trend View. Offline Trend Lists all available offline Trendlog objects available in the automation station for a project. Online Trend Lists all available online Trendlog objects.
7 Trends Trends Reference 7.2.5.2 Toolbar You can perform some commands directly in Trend View. This allows you to optimally process the data in Trend View. Trend View Configurator Toolbar Name Description New Trend Opens a new Trend View. New Folder Creates a new folder. Delete Deletes the current Trend View. Save Saves the current Trend View. NOTE: This command is not available until you modify the current trend view. Save As Saves the Trend View under a new name.
Trends 7 Trends Reference 7.2.5.3 Compare View You can link the same or another Trend View for data analysis that applies the same X-axis for the time range to both Trend Views. The current lower Trend View serves as the basis for the upper Trend View. Any changes to the time range in the current Trend View are reflected in the comparative Trend View. Predefined buttons allow you to offset the comparative Trend View to the current Trend View by the selected value.
Trends 7 Trends Reference NOTE 1: The legend displays the last left measured value in the time bar. NOTE 2: In the legend, the displayed value is not displayed based on the intersection of the time bar and trend curve. Instead, the time/date display is based on the time bar position. 7.2.5.4 Trend View The Trend View consists of a chart area where series are viewed and manipulated.
Trends 7 Trends Reference 8 Online: Current value from the automation station. Offline Trend: The values are displayed as a function of the time bar [3]. 9 Displays time or date range display across the entire selected display range. 10 Displays time range scrollbar. 13 Displays time and/or date display for the grid. 14 Displays time range display between grid sections.
7 Trends Trends Reference 11, 13 Timeline slide left/right. Click the end of the time range slider (dark grey area) and pull the slider to the desired time/date position, which the tooltip continuously displays. The range of the time window is changed at the same time you slide the end points. 12 Time range slider time window for the displayed window.
Trends Trends Reference 7 As of defined start date. Start date Time period Data recording Current date As of defined stop date. End date Time period Data recording Current date As of current date. Enddatum Time period Data recording Current date Recorded Time Range Select Full View to display the recorded data. Only the Trend View to the date of the last save is displayed when the current date does not match the date of the last save. Siemens Building Technologies User Guide Version 3.
7 Trends Trends Reference Time period Data recording Current date Context Menu 1 2 3 4 5 6 Context Menu 1 216 | 393 Siemens Building Technologies Menu Description Hide this column. Hides the selected column. Visible columns Shows/hides columns. ● Trended Object Name ● Trended Property Name ● Trended Log Object Name ● Alias ● Unit ● Value ● Time ● Date ● Y-Axis Attachment ● Remove ● Visibility ● System Name User Guide Version 3.
Trends Trends Reference 7 Context Menu 2 Menu Description Display Trended Object in Contextual Pane Displays object properties in Operation tab. Display Trendlog Object in Contextual Pane Displays object properties in Operation tab. Create Trendlog Object in BACnet Device Creates a Trendlog object on the device. Create Trendlog Multiple Object in BACnet Device Creates a Trendlog multiple object on the device. Delete the trendlog object on the BACnet device Deletes a Trendlog object on the device.
7 Trends Trends Reference 7.2.5.5 Data Point Key The legend for the series contains information on the given data point in the Trend View. NOTE: Use the context menu to hide columns by pointing to the column (Hide Column) or show/hide individual columns (Visible Columns). Column order and width is adjustable with the exception of the first column (colors, cannot be adjusted, moved or hidden). That most recent value displays in the time bar.
Trends Trends Reference 7 Quality attributes: With the reduced display, not all quality attributes can be displayed. In order to display all quality attributes, limit the time period. 7.2.5.6 Quality Attributes The Trend View can display a number of state attributes, referred to as quality attributes, along with the trend data. These enable you to identify problems with the data point being recorded, and assist with the diagnosis of plant conditions.
7 Trends Trends Reference ALARM In alarm state Indicates that the data point is in the alarm state. Return from the alarm state Indicates that the data point has returned from the alarm state. Into override (module) Indicates that the data point on a module is overridden. Return from overridden (module) Indicates that the data point's override on the module is removed.
Trends Trends Reference 1 2 3 4 5 6 7 7 Figure 19: Description 1 Timestamp for measurement. 2 Sorts values by ascending or descending timestamp. 3 Displays the trended object along with the property and alias of the object. It also displays the corresponding color of the trended object in the graphical view. 4 Displays the values in a reduced manner and with a red background if a long time frame is selected in the Trend View.
7 Trends Trends Reference 7.2.5.8 Print Preview Dialog Box 1 2 3 4 5 6 7 8 9 Print Preview and Properties Description 222 | 393 Siemens Building Technologies 1 Toolbar 2 Preview of print view. 3 Select printer. 4 Set margins in pixels. 5 Select paper size. User Guide Version 3.
Trends Trends Reference 6 Select paper format (portrait or landscape). 7 Select Fit to page to display the selected area on a page. 7 You can modify print options on the toolbar if Fit to page is cleared. 7.2.6 8 Closes the Print dialog box without printing. 9 Prints the document and closes the Print dialog box. Trend View Properties You can enter the following settings in Trend View properties to define the display for the graphical curve: ● Chart ● Axis ● Legend ● Series 7.2.6.
7 Trends Trends Reference Chart Properties Workspace Menu Description Grid Hides/shows the grid for the Trend View or displays it with horizontal or vertical lines. Background Hides/shows the background color as well as pattern for Trend View. Allows you to define or select the background from a predefined set of colors. Titles A descriptive name required for each Trend View. The name entered displays on the Trend View. You can also add your own title to the left and right axis of the Trend View.
Trends Trends Reference 7 General Each chart can display a left and right Y-axis independent of each other. Series can be selectively assigned and scaled to either axis, by default or manually. Scaling is set to automatic by default. This means that the range is defined by the highest amplitude of all displayed series, with analog data types attached to the left axis and digital data types to the right axis.
7 Trends Trends Reference Series Properties Workspace Menu Description Line Properties Defines the appropriate property type, form and color, as well as the property for the series (see the Table Line Properties below). Visible Displays the trend curve if this check box is selected. Show Markers Defines the corresponding property type, and size, as well as the corresponding property for the series. The markers are only displayed in the trend curve if this check box is selected.
Trends Trends Reference 7.2.6.5 7 Colors You can assign a color to the Trend View (background color) or to each individual series (line). You can choose between: ● Predefined set of colors. ● Custom colors. 1 4 2 5 3 6 7 8 9 Colors Workspace Description Siemens Building Technologies 1 Select from predefined colors. 2 Select with mouse. 3 Directly enter each color code. 4 Selected color. 5 Enter a color code. 6 Select pattern. 7 Select an existing color pattern on the screen.
7 Trends Trends Reference 7.2.7 Offline Trendlog Objects Offline trend data can be recorded and saved by Trendlog objects within the automation and control system even when the management station is not connected. The recorded data can then be saved in the trend database. Offline trend data can be retrieved and displayed in the Trend View. Creating or Deleting BACnet Trendlog Objects Online Creating and deleting BACnet objects online provides greater flexibility for adapting projects during operation.
Trends Trends Reference 7.2.8 7 Uploading Offline Trendlog Data Manually Offline trend data is regulated and uploaded to the management station from the device. You can manually upload the data stored on the device to conduct analysis using the most current data. You can upload trend data by selecting trend log objects from System Browser or from the legend. The following images depict the trend view before and after the upload of data.
7 Trends Trends Reference Related Topics Uploading Trend Data using System Browser [➙ 189] Uploading Trend Data using Legend [➙ 189] 7.2.9 Manual Correction Application The Manual Correction application allows you to add, modify, and delete values of trended properties of trended objects that are logged in online as well as offline trends. The application displays date/time, value, status, and unit information of the trended data in a column pattern in a grid.
Trends Trends Reference 7.2.11 7 Manual Correction Toolbar The Manual Correction Application toolbar allows you to perform the following operations: Manual Correction Toolbar 7.2.12 Name Description Run Displays the data for the selected trended object property. Add Displays the Add Trend Entry dialog box to add new entries to the grid. This button is disabled when you select multiple entries in the grid.
7 Trends Trends Reference Description Time Date/Time of the property value of the object. Value Value of the trended property of the object. Unit Unit of the trended property Status Displays either of the following values: Good – Value of displayed data is good. Bad – Value of displayed data is bad as per IOWA standards. Added – Displayed value is added by user. Corrected – Displayed value is modified by user. 232 | 393 Siemens Building Technologies User Guide Version 3.
Reports Working with Reports 8 8 Reports This section provides background information and instructions for using the Reports application in Desigo CC. 8.1 Working with Reports This section provides step-by-step instructions for using Reports .For background information, see Reports Reference [➙ 268]. Perform the procedures in this section as needed. 8.1.1 Creating a New Report Definition 1. In System Browser, select Application View. 2. Select Application View > Applications > Reports.
8 Reports Working with Reports 8.1.3 Configuring a Report Definition You can configure a Report Definition by inserting elements, applying filters, setting page layout, and/or formatting elements. 8.1.3.1 Inserting a Table 1. In System Browser, select Application View. 2. Select Applications > Reports or one of its subfolders. 3. Click the Home tab. 4.
Reports Working with Reports 8 Reordering a Column You have added a table with multiple columns in the selected Report Definition. 1. Select a table in the Report Definition. 2. Right-click the table and select Select Columns. The Select Columns dialog box displays with the available columns in the table. 3. Select the required column in the Selected Columns list. 4. Click Move Up or Move Down to reorder the column. 5. Click OK. The column in the table is arranged accordingly.
8 Reports Working with Reports 3. In the Selected Columns section, select the column whose header is to be customized. 4. Double-click the column header or press F2 to enter a new column header. The modified column header displays in the table in the report definition. NOTE: When you modify a column header for the first time, the same name displays as the header in all the languages configured in your system.
Reports Working with Reports – – – 8 From the Insert group box, click the Plot group box, and select any plot (Trends, Graphics), and drag-and-drop it onto the selected Report Definition. NOTE: The cursor changes and indicates the selected plot name. Right-click the Report Definition and select the required type of plot from the Insert Plot option. Drag-and-drop the desired Trend View Definition/Graphics View Port from System Browser onto the Report Definition.
8 Reports Working with Reports 2. Either right-click the label and select Delete, or press the DEL key. A confirmation message displays. 3. Click Yes to confirm. The selected label is deleted. 8.1.3.4 Inserting a Keyword 1. Click the Home tab. 2. Do one of the following: – – – From the Insert group box, select a keyword from the Keyword group box and drag-and-drop it in the header/footer section or anywhere in the Report Definition.
Reports Working with Reports – – 8 From the Insert group box, click the Logo group box and select a logo, and then drag-and-drop it on the Report Definition where you want to insert it. In the Report Definition, place the cursor where you want to insert the logo, right-click and select the required logo from the Insert Logo option. The logo is inserted in the Report Definition. NOTE 1: To insert a logo in the header/footer section of a Report Definition, delete any existing label.
8 Reports Working with Reports NOTE: You delete a logo from the source directory using the Manage Logo command in the Logo group box. When a logo is deleted from the source directory, the no parking symbol displays in the Report Definition (in place of the logo) with a tooltip that displays Logo is deleted or renamed from the source directory. Any subsequent execution of the Report Definition does not display anything in the PDF or XLS. 8.1.3.
Reports Working with Reports 8 1. Do one of the following: – Click the control and enter text. 2. Click Add The text entry is added to the control. Modifying Entries in the Custom Text Selection Control The Custom Text Selection control has one or more text entries. 1. Select the text entry you want to modify from the list. 2. Do one of the following: – Click the control and modify the text. 3. Click Update . The text entry is modified.
8 Reports Working with Reports 1. Click the Home tab. 2. Do one of the following: – – From the Insert group box on the Home tab, click the Form Controls group box, select the Comments table and drag-and-drop it onto the Report Definition. Right-click the Report Definition and select Insert Comments Table. The Comments table with a single row is added to the Report Definition. 8.1.3.7 Applying a Name Filter You have created a Report Definition and inserted a table or plot. 1.
Reports Working with Reports 8 Editing a Name Filter You have already applied [➙ 242] a Name filter for a table or plot in a Report Definition. 1. Open the Name Filter dialog box. 2. In the Name Filter list, select the Name filter you want to edit. The selected Name filter displays in the Name filter text box. 3. In the Name Filter text box, type in your modifications. 4. Click Accept. The updated Name filter displays in the Name Filter list. 5. Click OK.
8 Reports Working with Reports 5. (Optional) For Objects table only, specify the acceptable age of the data on which the filter is applied by selecting the Read data from field system older than option. The value entered is compared with the age of the data in the cache. If the data in the cache is older than the value entered, it is retrieved from the field system; otherwise data from the cache is used for filtering. 6. Click Add. The filter expression formed displays in the Filter expression field.
Reports Working with Reports 8 3. For Events and Event Details table only, select the column on which you want to apply the time filter from the Select Column drop-down list. 4. Select the appropriate values for Date/Time type: Exact, Custom, or Relative. 5. Click OK. NOTE: By default, the Unlimited option is selected. The Time filter is added in the Time Filter group box. 8.1.3.10 Applying a Row Filter You have selected a table in a Report Definition for which you want to apply a row filter.
8 Reports Working with Reports 3. Select the page size of your choice. The page size of the Report Definition changes accordingly. Setting Page Margins 1. Click the Layout tab. The Page Setup group box displays. 2. Click the Margin menu. A list of preconfigured margins display such as Normal, Narrow, Moderate, Wide, and More Margins. You can specify the top, bottom, left and right margins of a page as well as the header and footer margins by selecting the More Margins option. 3.
Reports Working with Reports 8 Enabling/Disabling Auto Scaling 1. Click the Layout tab. The Scaling group box displays. 2. Select the Auto scaling check box. By default, the auto scaling mechanism is enabled. 8.1.3.13 Formatting Report Elements You can format report elements for an enhanced appearance by performing the following procedures: Adjusting a Report Element Position 1. Select a report element in a Report Definition. The menus in the Position group box become available. 2.
8 Reports Working with Reports Customizing a Font 1. Select a label or a table in a Report Definition. 2. Click the Layout tab. The Font group box displays. 3. Do one of the following to apply a font, font style, or font size. – Click the drop-down arrow in the Font group box. – Right-click the report element, and select Font. The Font dialog box displays. 4. Select the font type, font size, and font style as desired. 5. (Optional) Select the Underline check box to apply it to the label.
Reports Working with Reports 8.1.6 8 Modifying a Report Definition 1. In System Browser, select Application View. 2. Select Applications > Reports. 3. Select a Report Definition and make the necessary configuration changes. 4. Do one of the following: – Click Save to replace the Report Definition with the changes. – Click Save As to create a new Report Definition. 5. In the Save Object As dialog box: a. Select the destination folder for saving the Report Definition. b. Enter a name and description.
8 Reports Working with Reports NOTE: There can only be one default template. You can create a new one or use the one provided by the system. When you create a new template, the existing default template is overwritten. In case of a Distributed Environment, the default template is system-specific. The template may contain generic and content-specific keywords. Creating a new Report Definition displays generic keywords, but not the content-specific keywords.
Reports Working with Reports 8.1.9 8 Generating a Report Manually from Related Items Tab 1. Select an object from System Browser. This object is set as the name filter for the report definition you want to execute. 2. In the Related Items tab, select an icon/link for the Report Definition. For example, Object Status. You must import the report that you want to execute. NOTE: Do not select an icon/link for New Report as this opens a new Report Definition.
8 Reports Working with Reports NOTE: If you have not configured the destination in the Report Output Definition, the report is routed to the path specified in the location supervised folder under Management System > Servers > Main Server > Report Manager > Report Default Folder. 8.1.11 Viewing Data of Deleted Objects You can view the data related to deleted objects from the Orphans, Orphan Activities, Orphan Events, and Orphan Trends tables.
Reports Working with Reports 8 5. In the Report format list, select PDF. 6. In the Destination types list, select Printer and specify the other printer details. 7. Click Add. The selected format and destination are added to the Output Definition list. 8. Click OK. The configured Report Output Definitions display. Related Topics Generating a Report Automatically [➙ 251] 8.1.
8 Reports Working with Reports 8.1.14.2 Modifying Comments in the Comments Table The report displays in Run mode and has a comments table with comments added. You can edit only your own comments. 1. Click Edit next to the row with your comments. The comments cell in that row can be edited.. 2. Make the required updates and press ENTER. The comments are updated. 8.1.14.3 Deleting Comments from the Comments Table The report displays in Run mode and has a comments table with comments added.
Reports Working with Reports 8.1.15 8 Generating a PDF Document You have run a Report Definition and it displays in Run mode. 1. Click Create and view PDF . The PDF file opens in the PDF viewer. When a PDF document exceeds the page limit of 500 pages, it splits into two documents. After clicking Create and view PDF on the generated report, you can save, print, zoom in, and zoom out of the PDF file.
8 Reports Working with Reports 2. Open the Excel file by clicking Open in the dialog box. NOTE: If you are opening the file from the temporary location, you must first ensure that you save a copy of this file at a different location on your machine and proceed with the further steps on the saved copy. 3. Open the worksheet with the table information in the saved copy of the Excel file and select a row with data. 4. From the Insert menu, select the PivotTable option.
Reports Working with Reports 18. Click Create and view Excel 8 . 19. Click Open. The Excel document displays. The first worksheet displays information on the PivotTable and the details of other tables in the Report display in the other sheets. 8.1.18 Routing Reports You can route reports to folders, email recipients as an attachment, and to local printers. Reports can be routed in the PDF, XLS, CSV, and XML formats.
8 Reports Working with Reports 7. In the Folder Alias field, type a name for the Report Output folder. 8. Click Browse to select a destination folder. To route report documents to a network folder, see the note below. The selected destination path displays in the Folder Path field. 9. (Optional) In the Folder Description field, type the folder description. 10. Click New. The output folder is added to the List of Folders for the Report Output section. 11. Click Close.
Reports Working with Reports 8.1.18.2 8 Configuring a Report Output Definition A Report Output Definition specifies the file format (PDF, XLS, CSV, or XML) in which the report output can be generated. The XML option is available only if you have the relevant license. The XML format does not contain information that is present in the header and footer section of the report.
8 Reports Working with Reports Related Topics Configuring a Report Output Folder [➙ 257] Configuring the Email Destination Type You have configured the mail server or have verified that it has been configured. 1. In System Browser, select Application View. 2. Select Applications > Reports. 3. Click the Settings tab. 4. From the Report Output group box, click Dialog Launcher The Report Output Definition dialog box displays. . 5.
Reports Working with Reports 4. From the Report Output group box, click Dialog Launcher The Report Output Definition dialog box displays. 8 . 5. Select PDF in the Report format list. NOTE: The destination type Printer is not available for XLS or CSV printing. 6. Select Printer in the Destination types list. 7. Select the required printer from Printer drop-down list. 8. Select the option to print either All or First number of pages. NOTE 1: By default, the first 100 pages are printed.
8 Reports Working with Reports NOTE 1: You can export multiple Report Definitions or multiple folders; however, you cannot export a Report Definition and a folder at the same time. NOTE 2: If the Report Definitions selected for export contain logo image files, such as .jpg, or .bmp, they are also exported to the selected location. NOTE 3: If a Report Definition file name contains special characters (such as \, <, >, |), they are replaced with an underscore (_) when the export file is created.
Reports Working with Reports 8.1.21 8 Deleting a Report Definition At least one Report Definition is available under System Browser > Reports. 1. In System Browser, select Application View. 2. Select Applications > Reports > Report Definitions > [report definition]. 3. Click Delete . A confirmation message displays. 4. Click OK. The selected Report Definition is deleted. ● ● ● ● ● 8.1.
8 Reports Working with Reports 8.1.23 Working with Reports and Operators This section provides information on some of the important reports along with information on their constraints. 8.1.23.1 Configuring an Objects Report 1. Create a new report definition with the objects table inserted. The Objects table is inserted with the following default set of columns— Object Description, Object Designation, Function, Discipline, Type, Subtype, Main Value. 2. Right-click the table and select Select Columns.
Reports Working with Reports 8 12. Run the report to view the data. If you have applied the condition filter, the details of all analog output objects with Current Priority set to 16 display. If no Condition filter is specified, then the details of all the analog output objects display. 13. Save the report definition if the configuration of columns and name filter is sufficient.
8 Reports Working with Reports 7. Run the report to view the data. The report displays the data for analog input object where value is greater than 100 in the last 24-hours. 8. (Optional) Click Save. 8.1.23.3 Viewing Event Details using Assisted Treatment You have created and configured an Operating Procedure template. Ensure that the Operational Status property for the Operating Procedure template is set to Enabled.
Reports Working with Reports 8 6. Specify the time period by adding the Time filter to the report definition. Perform the following steps to add the Time filter. a. Right-click the Event Details table, point to Filters and select Time Filter. The Time Filter dialog box displays. b. Select Relative. c. Select either the Last or Current Period option, depending on the data requirement for the last 24 hour period or current 24 hour period.
8 Reports Reports Reference for the last 10 hours or current 10 hours. In this case, we will obtain the data for the current 10 hours by selecting Current Period and specifying 10 hours. d. Click OK. 4. Run the report to view the data. The report displays the graphical representation of the data for the current 10 hour period. 5. Save the report definition. NOTE: You can enhance the report configuration at any time, in the future, by changing the Name and Time filters. 8.1.23.
Reports Reports Reference 8.2.1 8 Overview of Reports A report is a formatted and organized presentation of data. The Reports application lets you configure and produce a variety of reports on the functioning of the ^management platform. To compose a report, you configure a Report Definition that specifies: ● The elements that you want to include in the report, such as tables, plots, logos, form controls or text, and their layout.
8 Reports Reports Reference License Information Task Report Editing Report Viewing Create and configure a report definition ✔ ✘ Edit an existing report definition ✔ ✔ Save a report definition, save a report definition with a new name, save the report definition as default, saving a log view definition as a report definition ✔ ✘ Delete/Export/Import a report definition ✔ ✘ Execute a report manually or automatically and view the output in PDF or Excel format ✔ ✔ Reports for Operating Proce
Reports Reports Reference 8 Modifications ● ● ● View-Specific Columns - The column names of the view-specific columns such as Object Designation or Object Location in a distributed system depend on the presence of the views in a single system or multiple systems. Consider the following examples in which three systems are configured in a distributed system (System 1, System 2, and System 3). – A User-Defined View (UserView1) is present in System 1.
8 Reports Reports Reference 8.2.3 Reports Workspace This section gives an overview of the Reports workspace. 2 3 1 4 5 6 7 Reports Workspace 272 | 393 Siemens Building Technologies Name Description 1 System Browser Displays all the saved Report Definitions in Application View > Applications > Reports. 2 Reports Toolbar Contains icons for performing various actions in Reports.
Reports Reports Reference 8.2.4 8 Reports Toolbar The Reports toolbar contains icons that help you perform reporting operations quickly. This toolbar is present in both Edit mode and Run mode. Reports Toolbar Siemens Building Technologies Name Description New Opens a sub-menu where you can select: New Report and New Folder. Delete Removes the current Report Definition or Report folder and deletes its entire configuration from System Browser.
8 Reports Reports Reference Export Exports the Report Definitions as an .xml file to a selected location. Import Imports the Report Definitions and logos. The Import icon is enabled only when the Report folder is selected in System Browser. Save PDF as Saves the PDF report output. NOTE: Displays when clicking Create and view PDF in the generated report. ZoomIn (+10%) Allows you to zoom in the view of the PDF document by +10% with each mouse click.
Reports Reports Reference 8.2.5 8 Reports Ribbon — Home Tab The Home tab is the main tab of the Reports ribbon. 8.2.5.1 Insert Group Box Table Group Box Tables in a Report Definition can contain a huge number of records which cannot be viewed at the same time. It is recommended that you have a maximum of ten tables in a single report. If you need more than ten tables, you must create multiple reports.
8 Reports Reports Reference Table Summary Table Type Default Columns Objects Table ● and its extensions: Schedule and Related Items 276 | 393 Siemens Building Technologies Default columns displayed are: - Object Description - Object Designation - Function - Discipline - Subdiscipline - Type - Subtype - Main Value ● Columns specific to scheduling objects are: - Weekly schedule - Exceptions - Commanded objects - Effective Period ● Columns specific to Related Items objects are: - Related Items - Rela
Reports Reports Reference Active Events ● Siemens Building Technologies Category ● Cause ● State ● Object Designation ● Object Description ● Discipline ● Subdiscipline ● Creation Date Time ● Object Property ● Source Status ● User Guide Version 3.
8 Reports Reports Reference Activities 278 | 393 Siemens Building Technologies ● Source Time ● Object Description ● Object Designation ● Action ● Log Type ● Previous Value ● Value ● Status ● User Name ● Management Station ● Message Text ● Attachment ● User Guide Version 3.
Reports Reports Reference Events Siemens Building Technologies ● Event Time ● Event State ● Event Category ● Event Cause ● Event ID ● Object Description ● Object Designation ● User Name ● User Guide Version 3.
8 Reports Reports Reference Event Details 280 | 393 Siemens Building Technologies ● Default columns displayed in the Parent table are: - Event Time - Event Category - Event Cause - Event ID - Object Description - Object Designation ● User Guide Version 3.
Reports Reports Reference BACnet Event ● Information Event Stamp Fault ● Event Enable ● Acked Transitions ● Device Description ● Event Stamp OffNormal ● Event Stamp Normal ● Event Priority OffNormal ● Notify Type ● Alarm State ● Object Id ● Event Priority Normal BACnet Alam Summary BACnet Enrollment Summary Siemens Building Technologies 8 ● ● Supports only the Name and Row filter.
8 Reports Reports Reference Trends All Logs 282 | 393 Siemens Building Technologies ● DateTime ● Value ● Unit ● Quality ● Event Category ● Log Type ● Event ID ● Event Time ● Previous Value ● Event Message Text ● Quality ● Date/Time ● Record Type ● Event Cause ● Event State ● Previous Quality ● Source Description ● Action ● Source Property ● Value ● Unit ● ● User Guide Version 3.
Reports Reports Reference Orphans Orphan Activities Orphan Events Orphan Trends ● Orphan Type ● Object Identifier ● Object Location ● Object Property ● Source Time ● Object Identifier ● Object Designation ● Object Property ● Log Type ● Action ● Status ● Previous Value Text ● Value Text ● User Name ● Management Station ● Message Text ● Event Time ● Object Identifier ● Event State ● Event Category ● Event Cause ● Event ID ● Object Designation ● Object Proper
8 Reports Reports Reference clicked. A number (starting with 1) on the column header indicates the sorting priority. For example, Source time (1), Date (2), Discipline (3), and so on. You can sort the table columns in Edit mode as well as in Run mode. If you sort the table columns in Edit mode, then the sorted data displays in Run mode according to the sort criteria specified in Edit mode. When sorting is applied on an executed report, data in the current snapshot is sorted.
Reports Reports Reference Available columns 8 Displays the following information: ● Common columns applicable to any type of object. These are listed at the top of the list. For example, Discipline, Object Name, Object Description, and so on. ● Columns referring to properties supported by the selected object type. These are listed after the common columns and have a tree structure. When you click any such column, the tree expands and displays the attributes of the property.
8 Reports Reports Reference Textgroup Box Displays a label that you can add to a Report Definition. You can insert labels (Blank, Page, and Report) in the header/footer section or anywhere in the Report Definition. Using labels, you can type text to be displayed in the Report Definition or insert keywords. By default the labels display all the languages configured in the system. Keyword Group Box Keywords are pre-defined templates that can be added anywhere in a Report Definition.
Reports Reports Reference 8 Page Displays the page number when the report document (PDF) is created. Pages Displays the total number of pages when the report document (PDF) is created. NOTE: Keywords Page and Pages are replaced by page numbers and total number of pages respectively only when inserted in Header or Footer of the Report Definition. User Displays the name of the logged-in user. Desigo CC Name Displays the name of the management station that created the report.
8 Reports Reports Reference Components of Manage Logo Dialog Box Description Select logo to upload Displays selected image file path. Browse Opens the Windows Open dialog box. Upload Adds a new Logo to the Available Logos list. NOTE: The Upload button remains unavailable until a valid path and file name is selected. Thumbnail Displays the thumbnail view of an image. Logo name Saves as Logo name. The Logo name must be unique. Delete Deletes selected logos.
Reports 8 Reports Reference over written with the new group. If you add new entries, modify or delete existing entries from the associated text group, the control displays the updated values every time you run the report. If the text group is deleted, a message indicating that the group is no longer available displays. Text Group Selection Control - Edit Mode Text Group Selection Control - Run Mode Comments Table The Comments table allows you to add, modify, and delete comments in Run mode.
8 Reports Reports Reference ● ● 8.2.6 report. When you select an object from System Browser, this standard report displays as a link in the Related Items. Date/time in UTC format check box Selecting this check box, the date and time you type is represented in UTC format.
Reports Reports Reference 8 Name Filter Dialog Box Use the Name Filter dialog box to add, edit and delete Name filter conditions. The added Name filter is also added to the Name Filter group box when the dialog box is closed. Figure 26: Name Filter Dialog Box Name Filter Dialog Box Components Siemens Building Technologies Field Description Name Creates a Name filter according to the object name displayed in System Browser.
8 Reports Reports Reference Validate Checks whether the applied filter is valid or not. NOTE: Displays only for Trends Table, Trends Plot, and Graphics Plot. Accept Accepts the change made to a Name filter. This button is unavailable until a change is made to an existing Name filter. New Adds a new Name filter to the Name Filter list. This button is unavailable until a Name filter is typed in the Name field or if any existing Name filters are selected in a Name Filter list.
Reports Reports Reference 8 following Name filter in the report definition, “*.ManagementView:ManagementView.FieldNetworks.*.AO*”. When you run the report, the details of all the Analog Output objects belonging to all the devices in all the systems configured in a distributed environment will display. However, when you apply wild cards to a Name filter, the report execution may be slower.
8 Reports Reports Reference Condition Filter Syntax When you are creating a Condition filter, you must know the data type of the property for which you want to apply the filter. Following are some examples which will help you create Condition filters without syntax errors. 1. If property displays text data, for example string or enumeration, then the value must be enclosed within double quotes.
Reports Reports Reference 8 Condition Filter Dialog Box Components Siemens Building Technologies Field Description Type filter Displays only when an Objects table is selected in the Report Definition. Allows you to enter the object type description on which you want to filter the object types to be displayed in the Type drop-down list. For example, if you want the Type drop-down list to display all BACnet object types, enter BACnet as the type filter.
8 Reports Reports Reference Available columns 1) Lists all the available columns of a selected table. For an Objects table, the columns corresponding to the object type selected in Type are listed. In case of the Objects table, displays the following information: ● Common columns applicable to any type of object. These are listed at the top of the list. For example, Discipline, Object Name, Object Description, and so on. ● Columns referring to properties supported by the selected object type.
Reports Reports Reference 8.2.6.3 8 Time Filter The Time Filter group box and the dialog box launcher icon is enabled only when you select a table or plot in a Report Definition for which the Time filter is applicable. The Time filter allows you to specify time as a filter for retrieving records. Figure 27: Time Filter Dialog Box Siemens Building Technologies User Guide Version 3.
8 Reports Reports Reference Time Filter Dialog Box Components Field Description Date time specification Shows LOCAL, when the Date/Time in UTC format check box on the Home tab is not selected. Select Column Displays only when an Events, All Logs, or Activities table is selected in the Report Definition. The entries in the drop-down list depend on table selected and allow you to filter information accordingly.
Reports Reports Reference 8.2.7 8 Unlimited Default selection. Allows you to retrieve all records. Defined By Source This option only displays for Trend objects. It sets the date and time to what you have defined for the selected Trend View Definition. Null Allows you to retrieve records with Null value. Preview of Resulting Time range Displays the resulting time range for the options selected in the Time filter dialog box.
8 Reports Reports Reference Margins The Margins menu has four preconfigured margins with values displayed for quick selection: ● Normal (default) ● Narrow ● Moderate ● Wide 8.2.7.2 Placement Group Box The Placement group box provides icons so you can rearrange the position of the report elements in a Report Definition by selecting an element and using the icons: Move up , Move down , Move to top , and Move to bottom .
Reports Reports Reference 8.2.7.5 8 Auto-scaling Group Box Selecting the Auto-scaling check box adjusts the column width automatically in PDF documents that are generated when you execute a report. If the Auto-scaling check box is not selected, then the PDF may not display all table columns. 8.2.8 Reports Ribbon — Data Tab The Data tab allows you to specify the location from which the data is to be retrieved when you run the report. It also provides the option to define the Graphics filter.
8 Reports Reports Reference 8.2.9 Reports Ribbon — Settings Tab The Settings tab allows you to configure the output format and destination for a Report Definition. Report Output Group Box The Report Output group box displays the configured entries for a Report Definition. Figure 32: Report Output Group Box The Report Output Definition dialog box allows you to configure the settings. The configured Report Output Definitions are executed when the Report Definition runs automatically.
Reports Reports Reference 8.2.9.1 8 Report Output Definition Dialog Box The Report Output Definition dialog box allows you to configure the Report Definition’s output format and destination for routing reports. You can create, modify, or delete a Report Definition output entry. Figure 33: Report Output Definition Dialog Box Report Output Definition Dialog Box Components Siemens Building Technologies Field Description Report format Lists the following supported file formats.
8 Reports Reports Reference Destination Depending on the Destination types settings, you can configure the destination in one of the following ways: ● File: Configured folder name displays in the File drop-down list. ● Email: Email text field is populated with the pre-configured email contacts. ● Printer: Available printers display in the Printer drop-down list. Use report name as file Default option. Becomes available only when you select the destination type name as File or E-mail.
Reports Reports Reference 8 Figure 34: View as PDF NOTE 1: Reports do not support TrueType collections for PDF generation. To generate a PDF document for Asian languages, you must select TrueType fonts which support Asian characters in the Report Definition, for example, Arial Unicode MS. NOTE 2: You can print the PDF file by clicking Print click Create and view PDF . This button is available when you on the generated report.
8 Reports Reports Reference In order to perform analysis on a specific set of columns in a table, you can add a PivotTable or chart to the generated Excel document and set this document as a template to the report definition having this table. When you run the report and generate the Excel document, information related to the columns you added to the PivotTable or chart displays in a separate worksheet.
Reports Reports Reference 8 Figure 35: View as XLSX_PivotTable NOTE 1: If the size of the document exceeds the Excel maximum of 1000 worksheets or 1,048,575 rows, a new Excel file is created for the next set of records. NOTE 2: In case of a distributed system, the process of generating the PDF or XLS documents will stop if you switch over to a different system. During this process, if the document is likely to be split into multiple documents, then the pending documents will not be available.
8 Reports Reports Reference Generating a PDF Document You have run a Report Definition and it displays in Run mode. 1. Click Create and view PDF . The PDF file opens in the PDF viewer. When a PDF document exceeds the page limit of 500 pages, it splits into two documents. After clicking Create and view PDF on the generated report, you can save, print, zoom in, and zoom out of the PDF file.
Reports Reports Reference 8 Generating an Excel Document with a Template You have created a report definition, run it, and it displays in Run mode. Microsoft Excel 2007 or later is installed on your system. 1. Click Create and view Excel . An Excel file is created and stored at the following temporary location on your machine [Drive]:\Users\[UserID]\AppData\Local\Temp\temp\GMS.
8 Reports Reports Reference NOTE: The template path is the path of the Server machine. A Process Monitor User must have access to the folder in which the template file is present for the PivotTable to display. 17. Run the report. The generated report displays in the Run mode. 18. Click Create and view Excel . 19. Click Open. The Excel document displays. The first worksheet displays information on the PivotTable and the details of other tables in the Report display in the other sheets. 8.2.9.
Reports Reports Reference 8 Report Output Folders Configuration Components Siemens Building Technologies Field Description Folder Alias Displays the name of the destination folder. When you select File in the Destination Type field, this name will be displayed in the File drop-down list of the Destination list of the Report Output Definition dialog box. Folder Path Displays the folder path that you have selected using the Browse button. You can configure a maximum of 100 folder paths.
8 Reports Reports Reference 8.2.9.4 Destination Type - Email The Report Output Definition dialog box allows you to send a report via email. You can send all documents in one mail or configure the number of documents to be sent per email. The default is one document per email. The Email Contacts dialog box allows you to choose and filter from the list of all recipients having email addresses configured in the Contacts selection list. NOTE 1: Before sending an email you must configure the mail server.
Reports Reports Reference 8 Email Contacts Dialog Box Components Field Description Contacts selection Shows the names of the configured contacts in the Address Book followed by their email address in brackets. This list is sorted alphabetically. NOTE: A recipient may have up to three different email addresses configured. Filter List Entries Allows you to type in a filter. For example, if you type the letter “A”, the recipient list displays all the contacts starting with the letter A.
8 Reports Reports Reference Action Result A recipient email address is changed in the Address Book The new email address reflects in the Output Definition list in the Report Output Definition dialog box and Contacts section list in the Email Contacts dialog box. A listed email address of the configured The list of email addresses in the Output Definition list in the contact is deleted in the Address Book Report Output Definition dialog box displays in red.
Reports Reports Reference 8.2.9.5 8 Destination Type - Printer The Report Output Definition dialog box allows you to send a Report Output Definition to a printer. You can print all or the first 100 (default) pages. You can edit the default and enter the number of pages to be printed. Figure 37: Report Output Definition Dialog Box for Printer NOTE 1: Currently only PDF report format is supported for printing. To print a PDF report format on a printer, you must configure a server printer.
8 Reports Reports Reference 8.2.10 Report Management Section The Report Management section displays the Report execution status, such as PDF/XLS document creation status, during Report execution. The Report execution/generation mode is called Run mode. It also provides quick and easy navigation to different Report snapshots. When you select a snapshot in the Report Management section, it displays in Reports.
Reports Reports Reference 8.2.11 8 Execution Start Displays the execution start date and time. Action Displays the Stop button when the execution of a reporting object starts. When the execution is finished, the Stop button changes to the Delete button. Progress Displays the Progress information in a progress bar to indicate the execution progress. Summary Displays the execution summary.
8 Reports Reports Reference NOTE: Ensure that in a Report Definition, you have set the complete path of the system object as the Name filter (without any wild cards). If a wild card (? or *) is used in the Name filter, then this Report Definition is not set as a related report and does not display in the Related Items tab.
Reports Reports Reference 8.2.12.2 8 Run Mode The Run mode executes a Report Definition and displays the data retrieved from Reports and other services. In Run mode, the ribbon disappears. ● The ribbon disappears. ● Keywords are replaced by actual data. ● No element can be added or deleted in this mode. ● You can perform the following activities: – Sorting (ascending or descending) or changing column width. – Selecting rows in tables. – Entering text in the Editable Field control.
8 Reports Reports Reference NOTE 1: You can toggle to Edit mode by clicking Edit on the Reports toolbar. If you perform sorting in Run mode and then switch to Edit mode, the Select Edit Option dialog box displays asking whether you want to save or discard the changes you made in Run, or to create a new Report Definition based on the changes. NOTE 2: In Run mode, when you move the cursor over a table/plot, a tooltip displays the applicable filter and the number of records (only for tables).
Reports Reports Reference 2 8 3 1 4 5 Figure 41: Reports – Primary Pane Workflow Name Description 1 Report Definition Selection Location of Report Definition and Report folders in the Application View of System Browser. 2 Report Execution Reports toolbar containing Report Definition execution command icons: Run Siemens Building Technologies or Run As . 3 Executed Report Display Location of executed Report Definition. NOTE: This displays in Run mode.
8 Reports Reports Reference 8.2.13.2 Secondary Pane If the Primary pane is unlocked (horizontal pushpin icon ), then you can work with the following three additional report types in the Secondary pane: ● ● ● New Report: Opens a new Report Definition for configuration. Related Report: Opens the report related to the selected System Browser object. Show in Related Items Report: Opens a report with the Show in Related Items check box selected.
Reports Reports Reference 8.2.13.3 8 Contextual Pane — Extended Operation Tab You can generate a selected report automatically by clicking Execute in the Extended Operations tab of the Contextual pane. 1 2 3 Figure 43: Contextual Pane - Extended Operations Siemens Building Technologies Name Description 1 Report Definition Selection Location of Report Definitions and Report folders in the Application View of System Browser.
8 Reports Reports Reference 8.2.14 Validating a Report Definition The Report Definition is validated when you open or save it for: ● Columns of the tables present in the Report Definition ● Condition filters ● Availability of the content template Figure 44: Report Validation Dialog Box Columns in Tables Present in the Definition When you open or save a Report Definition, it is checked for the validity of the selected columns present in the tables.
Reports Reports Reference 8.2.15 8.2.15.1 8 Report and Operators Objects Report An Objects report contains an Objects table that displays the run time property values of system objects. To know the property values of any object, such as present value, high limit, low limit and so on, you must configure an Objects report. Each object has a corresponding object model associated with it.
8 Reports Reports Reference group (To Off Normal, To Fault, To Normal) to display as columns in the Objects table. Related Topics Configuring an Objects Report [➙ 264] 8.2.15.2 Activities Report The Activities report provides information on system activities over a period of time. For example, you can generate an Activities report to get the treatment-related information logged in the database for activities.
Reports Reports Reference 8 Object Designation[Current View] Object Designation[Management View] Object Identifier [Internal] Object Location Object Location[Application View] Object Location[Current View] Object Location[Management View] Error Associated Object Description Associated Object Name Associated Object Designation Associated Object Location Associated Object Name (Internal) Alias [Associated Object] Alias [Object] Unit ● ● ● When you add a Condition filter to the Activities table, you cannot
8 Reports Reports Reference ● ● ● Viewing event details of a particular event using Investigative Treatment. Viewing event details of a particular event using Assisted Treatment. Viewing event details for specific events using Reports. For example, you can configure an event details report to display all events of type Fault or Life Safety on an Analog Output object for a 24-hour period.
Reports Reports Reference 8.2.15.4 8 Events Report The Events table provides information related to events. It provides information such as Event Time, Event State, Event Category, Event Cause, Event ID, Object Description, and Object Designation.
8 Reports Reports Reference 8.2.15.5 Trends Plot The Trends Plot provides a graphical representation of the change of value of an object over a period of time. In order to view the change of value graphically, you must assign a Trend View Definition as a Name filter to the Plot. You cannot add a Condition filter to the Trends Plot. For example, you can create a Trends Plot if you want to track the change of value of an Analog Input object graphically over a period of 10 hours.
Reports Reports Reference – – – – – – – – – – – – – – – 8.2.15.
8 Reports Reports Reference 8.2.16 Reports Troubleshooting The following table may help you to resolve possible errors when working with reports for operating procedures. Working with Reports for Operating Procedures Problem Cause Resolution Reporting snap-in does not display. ● You do not have the Show privilege for Reporting. ● Report for operating procedures is not executed. ● Configured ● Report Definition is out of Scope. ● Configured Report Definition ● is either deleted or corrupted.
Reports Reports Reference PDF document generated for operating procedure does not display any data. Building Technologies Data is not ● available as per the filters applied ● to the configured table. ● Graphics is not available for the object in the event. ● Printer is faulty. ● Printer is out of paper. ● Printer is jammed. ● Printer is not available. ● Printer is offline ● Printer door is open. The report for the operating procedure cannot get routed to the specified folder.
9 Log Viewer Working with Log Viewer 9 Log Viewer This section provides background information and instructions for using the Log Viewer application in Desigo CC. 9.1 Working with Log Viewer This section provides step-by-step instructions for using Log Viewer. For background information see Log Viewer Reference [➙ 347]. Perform the procedures in this section as needed. 9.1.1 Accessing Log Viewer from System Browser System Manager is in Operating mode. 1. In System Browser, select Application View. 2.
Log Viewer Working with Log Viewer 9 Columns list of the dialog box. These columns represent the columns of the Log View Definition. 2. In the Available Columns list, select the check box preceding the column names you want displayed. The Selected Columns list box is updated. 3. Click OK. The Log View Definition is updated. NOTE: For each view present in the system, you can add the view-specific columns (Object Location and Object Designation) to a log view from the Select Columns dialog box.
9 Log Viewer Working with Log Viewer 2. In the Selected Columns list, select the column to be removed and click Remove . 3. Click OK. The log view refreshes automatically and the column is removed. 9.1.2.6 Resizing Columns In the Log Viewer grid, drag the column separator next to the column to be resized. The column is resized. You cannot reduce the width of a column below its minimum width. 9.1.2.
Log Viewer Working with Log Viewer 9.1.2.9 9 Modifying Search/Result Filters on Columns other than Date/Time Log data displays in the Log Viewer or the Detailed Log tab. You have applied a search/result filter to the log data. 1. Right-click the data value in the column of the filter to be modified and select Custom Filter. The Custom Filter dialog box displays. 2. Click the Search or Result Filter tab, depending on the filter that you want to modify. 3. Modify the filter condition. 4. Click OK.
9 Log Viewer Working with Log Viewer 9.1.2.12 Deleting Search Filters on Date/Time Columns Log data displays in the Log Viewer or the Detailed Log tab. You have applied a search filter to a column displaying date time data. 1. Right-click the data value in the column pertaining to the filter to be modified. 2. From the menu options, select Custom Filter. The Time Filter dialog box displays. 3. Click the Search Filter tab. 4. Select the Unlimited option. 5. Click OK. The view refreshes. 9.1.2.
Log Viewer Working with Log Viewer 9 1. Click the inverted arrow on any column displaying ENUM data. The list of data entries for the column display as menu items. 2. Select the checkbox pertaining to the entry on which you want to apply the filter. NOTE: For faster retrieval of the data entries, you can type the value of the entry to be retrieved in the text box above the Selection filter. 3. Click OK. The view displays the data filtered on the basis of the selected entry.
9 Log Viewer Working with Log Viewer Date Filters Using the Date Filters option, you can retrieve data for the current day, previous day, current week, previous week, current month, previous month, current year, or previous year. Perform the following steps to retrieve the data for the required time period. 1) Click the drop-down arrow on any column displaying date/time data, for example, Date/Time. A list of menu options displays. 2) Position your mouse pointer over Date Filters.
Log Viewer Working with Log Viewer 9 move your result filter to a search filter to obtain all the matching data from the database. Moving Result Filters to Search Filters You have applied a result filter on the data displayed in the log view. 1. Perform any of the following steps to move the result filter to a search filter. a. Click Refresh . b. Click the Move to Search Filter button in the Custom Filter dialog box for the column on which the result filter is applied and click OK.
9 Log Viewer Working with Log Viewer 6. Click Revert to Saved Search Filters . The view refreshes and displays the data according to the previously defined search filter ('Record Type' = "Activity"). The filter condition is also updated in the Filters area. 9.1.2.18 Applying Search Filters on Columns Not Present in the Log View Log data displays in the Log Viewer or the Detailed Log tab. 1. Click Search Filter . The Search Filter dialog box displays. 2.
Log Viewer Working with Log Viewer 9 NOTE: If you want to modify the search filter in a Log View Definition that is configured in a different language from your logged in language, you must change the filter language in the Configuration dialog box. This dialog box is accessed by clicking the Configuration icon. 9.1.2.20 Deleting Search Filters on Columns Not Present in the Log View Log data displays in the Log Viewer or the Detailed Log tab.
9 Log Viewer Working with Log Viewer 9.1.3 Managing Log View Folders Creating Log View folders enable you to properly organize Log View Definitions. 1. In System Browser, select Application View. 2. Select Applications > Log Viewer. Log Viewer displays. 3. Click New Folder . 4. In the Create New Object dialog box, do the following: a. Enter a unique name and description. b. Click OK. A new folder is created. NOTE: Deleting a folder also deletes its contents. 9.1.
Log Viewer Working with Log Viewer 9.1.6 9 Saving a Log View Definition as a Report Definition Log data displays in the Log Viewer or the Detailed Log tab. 1. (Optional) Perform any required configurations such as applying search filters, selecting columns, and applying sorting. 2. Click Save as Report Definition . 3. In the Save Object As dialog box, do the following: a. Select the Reports folder for saving the new Report Definition b. Enter a name and description. c. Click OK.
9 Log Viewer Working with Log Viewer 9.1.8 Deleting a Log View Definition At least one Log View Definition is available in System Browser. 1. In System Browser, select Application View. 2. Select Applications > Log Viewer > [Log View Definition]. 3. Click Delete . A confirmation message displays. 4. Click OK. The Log View Definition is deleted. 9.1.9 Printing Log Grid Contents Log data displays in the Log Viewer or the Detailed Log tab. 1. In System Browser, select Application View. 2.
Log Viewer Log Viewer Reference 9 3. Browse to the folder where the exported Log View Definitions are available. Select the xml file to be imported and click Open. A confirmation message displays and the Log View Definition is added. 9.1.12 Viewing Object Properties and Hierarchy You can view the properties as well as the hierarchy of an object associated with a log view entry using the following steps: 1. In System Browser, select Application View. 2. Select Applications > Log Viewer.
9 Log Viewer Log Viewer Reference 9.2.1 Overview of Log Viewer The Log Viewer application allows you to view the historical data related to system activities and events directly without creating and configuring a report from the Reports application. The information related to all the system activities and events displays in a columnar pattern in a grid.
Log Viewer Log Viewer Reference Record Type Type of information displayed. This information can be of type Activity or Event. Action Source Property Name of the property associated Value with the source object on change of which the activity or event occurred. 9 Nature of the activity performed by the source object. For example, for a Users object type, the value of the Action field could be Login, Primary Authentication and so on. New value of the Source Property when an activity is performed.
9 Log Viewer Log Viewer Reference 350 | 393 Siemens Building Technologies Source Location Default hierarchy of the source object composed using the description of the nodes present in the hierarchy. Source Location [Application View] Hierarchy of the source object from the Application View composed using the description of the nodes present in the hierarchy.
Log Viewer Log Viewer Reference 9.2.2 9 Log Viewer in Distributed Systems When working with Log Viewer in a distributed environment, you must understand the details of the following additions, modifications, and applicable conditions. Additions System Name column - A column named System Name has been added as an additional column that displays the name of the system to which the source object belongs.
9 Log Viewer Log Viewer Reference 9.2.3 Log Viewer Workspace This section gives an overview of the Log Viewer workspace 3 4 1 2 5 Log Viewer Workspace 352 | 393 Siemens Building Technologies Name Description 1 System Browser Displays all the saved Log View Definitions in Application View > Applications > Log Viewer. 2 Log Viewer Toolbar Contains buttons for performing various actions in Log Viewer. 3 Log View Displays the combined data from the Activity Log and Event Log. 4.
Log Viewer Log Viewer Reference 9.2.4 9 Log Viewer Toolbar The Log Viewer toolbar allows you to perform the following operations: Name Description New Folder Creates a new folder below the Log Viewer root node. Save Saves a newly created and configured Log View Definition or changes in the configuration of the currently selected Log View Definition. NOTE: This command is available only after you perform some operation on the displayed log view data.
9 Log Viewer Log Viewer Reference 9.2.5 Select Columns Dialog Box The Select Columns dialog box allows you to add, remove, or reorder columns in a log view. You can access this dialog box using any of the following methods: ● Clicking the Select Column icon. ● Clicking the Select Column icon in the Detailed Log tab. ● Clicking the drop-down arrow on a column header and selecting the Select Column menu option. ● Right-clicking a column entry and selecting Select Column menu option.
Log Viewer Log Viewer Reference 9.2.6 9 Custom Filter A Custom filter allows you to define a filter expression from which you can filter data according to your specific requirements.
9 Log Viewer Log Viewer Reference ● ● ● ● ● ● ● ● Action Result Event Mode Event Category Event State Log Type Action Quality Previous Quality Custom Filter Syntax To create a custom filter, you must know the data type of the column for which you want to apply the filter. The following examples should help you create custom filters without syntax errors. 1. If column displays text data, for example string or enumeration, then the value must be enclosed within double quotes.
Log Viewer Log Viewer Reference 9 You can also apply a Search filter if you need to filter the data for a column that is not present in the log view. The combined Search filter is always available in the Search Filter dialog box. For example, you can apply a result filter on the log data to retrieve all records with Source Description as "Analog Input 1". However, in order to save the filter condition, you must move the result filter to a Search filter.
9 Log Viewer Log Viewer Reference AND This is a logical operator that allows you to combine filter expressions and create complex filters. This button is available only when you add a new filter expression row and select the check boxes preceding the Operator drop down list in the filter expression rows. OR This is a logical operator that allows you to combine filter expressions and create complex filters.
Log Viewer Log Viewer Reference 9 Time Filter Dialog Box Components Name Description Result Filter Allows you to specify a result filter. Search Filter Allows you to specify a search filter. NOTE: The Search Filter tab does not display when the Time Filter dialog box is accessed from the Detailed Log tab in the Contextual Pane. Exact Allows you to filter data based on the exact date specified. Custom This option allows you to set the date and time as per your requirement.
9 Log Viewer Log Viewer Reference you to view, modify, and delete a combined search filter expression. You can apply the search filter on all columns except columns of type date and time. Figure 46: Search Filter Dialog Box Search Filter Dialog Box Components Description 360 | 393 Siemens Building Technologies Available Columns1 Lists all the available columns from the Activities and Events Log. Operators1 Lists all the operators associated with a specific column selected in Available Columns.
Log Viewer Log Viewer Reference Filter expression field Displays the filter expression. You can edit a filter expression in this field. NOTE: An invalid filter expression displays in red. Add/Update Allows you to add or update a filter expression. Update is enabled only when a valid filter expression is added or modified in the Filter expression field. And This is a logical operator that allows you to combine filter expressions and create complex filters.
9 Log Viewer Log Viewer Reference You can customize the information displayed in the Detailed Log tab by ● Applying Result Filters on Columns other than Date/Time ● Applying Result Filters on Date/Time Columns ● Selecting columns to be displayed ● Hiding columns ● Sorting Log Entries ● Reordering and Resizing Columns By default, the following information displays for activity and event type data in the Detailed Log tab.
Log Viewer Log Viewer Reference 9 Figure 47: Detailed Log Tab Name Description SaveAsDefault Saves the selected columns in the Detailed Log tab as a default template. Refresh Refreshes the data displayed in the Detailed Log tab. Stop Execution Stops the execution of the log view in the Detailed Log tab. Select Columns Displays the Select Columns dialog box that allows you to select the columns to display in the Detailed Log tab.
10 Macros Working with Macros 10 Macros This section provides instructions and background information for using Macros in Desigo CC. 10.1 Working with Macros This section provides step-by-step instructions for using Macros in Desigo CC. For background information, see Macros Reference [➙ 366]. Perform the procedures in this section as needed. 10.1.1 Browsing the Existing Macros in the System 1. In System Browser, select Application View. 2. Select Applications > Logics > Macros.
Macros Working with Macros 10.1.3 10 Executing a Macro from a Graphic Macros can also be executed from a graphic, if a special macro button is placed on the graphic. Clicking the button in the graphic will put the object in focus in the Operation tab. The macro can be executed from there, or you can right-click the button and open the Status and Commands window from where you can operate the macro. 10.1.
10 Macros Macros Reference 10.2 Macros Reference Macros are predefined lists of instructions that enable you to issue a sequence of commands to specified devices with a single action. Some macros can be started manually by the operator, while others may be run automatically by the system as part of automatic reactions (see Reactions Reference [➙ 371]). In Operating mode you can view the macros already configured in the system and manually execute (run) or abort (interrupt) them.
Macros Macros Reference 10 System-Defined Macros The following subfolders contain predefined special-purpose macros, created by the system: ● Backups (always present): These are macros that create backup copies of the system data. Backup History backs up the history (sql) database. Backup Online backs up the project database. ● Block Command Macros (present in some configurations).
10 Macros Macros Reference Macro Properties Property Description Operational Status Indicates whether the macro is enabled (meaning it is available to be run by the user): Activity Status ● Enabled: the macro is currently active, and the Disable command is available. ● Disabled: the macro is currently inactive, and the Enable command is available. Indicates whether the macro is currently running, aborting, or not running: Last Execution Status ● Executing: the macro is running.
Macros Macros Reference 10 NOTICE Disabling Macros Do not disable any of the system macros (in the Backups or Block Command Macros folders), as this will prevent the system from properly executing the associated functions. If a macro is used in a reaction or other automated logic (schedule, and so on) then disabling the macro will result in a failure of the corresponding reaction/schedule.
10 Macros Macros Reference ● ● 370 | 393 Siemens Building Technologies When you send an alarm-handling command from Event List (for example, ACK), the corresponding block command macro is automatically invoked (for example BLOCK_ACK_net) to broadcast that command to the entire fire network. When you send an alarm-handling command to an object from the Operation tab or Graphics Viewer tab, the block command macro may or may not be invoked. See the documentation of the specific fire network.
Reactions Enabling or Disabling a Reaction 11 11 Reactions This section provides background information and instructions for using Reactions in Desigo CC. 11.1 Enabling or Disabling a Reaction You want to manually change the operational status of a reaction. 1. In System Browser, select Application View. 2. Select Applications > Logics > Reactions > [reaction]. In the Operation tab, the Operational Status (Enabled/Disabled) of the reaction displays. 3. Click Enable or Disable.
11 Reactions Reactions Reference 11.2.1 Properties and Commands of a Reaction When you select a reaction object in System Browser, its properties and commands display in the Operation tab. 2 1 3 Figure 50: Select a Reaction to View its Information Figure 51: Reaction Properties and Commands 372 | 393 Siemens Building Technologies User Guide Version 3.
Reactions Reactions Reference 11 Reaction Properties Property Description Operational Status Indicates whether the reaction is enabled or disabled, and the reason why if it is disabled: Activity Status ● Enabled: The reaction is currently active, and the Disable command is available in all Activity Status conditions, except Executing. ● Disabled: The reaction is currently inactive, and the Enable command is available.
12 Organization Modes Manually Setting an Organization Mode 12 Organization Modes This section provides background information and instructions for using Organization Modes in Desigo CC. 12.1 Manually Setting an Organization Mode Scenario: You want to manually change the value of the Day and Night organization mode from Day to Night. 1. In System Browser, select Management View. 2. Select Project > System Settings > Organization Modes. 3. From the Organization Modes folder, select Day and Night.
Organization Modes Organization Modes Reference 12 The list under Organization Modes includes the predefined organization modes (Day and Night, Occupancy Status, On and Off, Open and Close, Operational Status) as well as any others that have been configured. Values of an Organization Mode Each organization mode has a set of associated values. For example, the predefined Occupancy Status organization mode has two possible values: Occupied or Unoccupied.
13 Address Book Working with Address Book 13 Address Book This section provides background information and instructions for using the Desigo CC Address Book. 13.1 Working with Address Book This section provides step-by-step instructions for some common Address Book tasks. For background information, see Address Book Reference [➙ 378]. Perform the procedures in this section as needed. 13.1.1 Creating Email Recipients for Reports in the Address Book 1. In System Browser, select Application View. 2.
Address Book Working with Address Book 13 5. Open the Details expander. From here you can enter the details of the new contact. 6. In the General expander, enter the contact’s full name in the Full Name field (for example, John Doe). This value has to be unique. 7. In the Devices expander, enter the contact’s email address in the Email1 field, and enter the contact’s mobile phone number in the SMS1 field. 8.
13 Address Book Address Book Reference 7. In the contacts list, click the next contact that you want to add to the Supervisors group. 8. In the Groups expander, select Supervisors from the drop-down list. 9. Click Save . 10. Repeat Steps 7-9 for all the contacts that you want to add to the Supervisors group. Related Topics Address Book Reference [➙ 378] Importing Outlook Contacts into the Address Book [➙ 378] Remote Notifications Reference [➙ 143] 13.1.
Address Book Address Book Reference 13 The left panel shows the list of contacts already configured in the address book. The Details expanders on the right displays the details of the currently selected contact. See Details of an Address Book Contact [➙ 379] for more information about these fields. Related Topics Remote Notifications Reference [➙ 143] Reports Reference [➙ 268] 13.2.
13 Address Book Address Book Reference NOTE: Groups are required for remote notifications, which are addressed to recipient groups, not to individuals. You do not need groups for reports, which can instead be emailed to individual contacts. The Groups expander shows any groups to which the selected contact is already assigned. ● To assign a contact to an existing group, you must select the group name from the drop-down list and click Add.
Address Book Address Book Reference 13 NOTE: The preferred and fallback device settings are used only by remote notifications. When you email a report you can choose from all the email addresses entered for each contact. 13.2.2 Address Book Toolbar Name Description Save Recipient Save any changes made to the details of the currently selected contact. Add Recipient Add a new contact to the address book. Remove Recipient Delete the currently selected contact.
13 Address Book Address Book Reference 13.2.4 Outlook Import Rules for the Address Book The Desigo CC address book can import CSV contacts files exported from Microsoft Outlook 2003 and 2007 but only in English language. If a CSV file is not already available, you can export contacts from Microsoft Outlook into a CSV file as follows: ● If your language is not English, change this setting to English in Microsoft Outlook before proceeding to export the contacts.
Documents Working with Documents 14 14 Documents This section provides background information and instructions for using Documents in Desigo CC. 14.1 Working with Documents This section provides step-by-step instructions for some common Documents tasks. For background information, see Documents Reference [➙ 385]. Perform the procedures in this section as needed. 14.1.1 Viewing the Documents Configured in the System 1. In System Browser, select Application View. 2. Select Applications > Documents.
14 Documents Working with Documents 14.1.3 Setting the File or Web Link of a Document Object 1. In System Browser, select Application View. 2. Select Applications > Documents > [Document]. The current contents of the document display. 3. (Optional) Click Edit to display the Document Settings panel. 4. To set the new content of the document object, do one of the following: – – Click Web URL and type in the web link that you want to use.
Documents Documents Reference 14 14.2 Documents Reference The management platform can be configured to include a set of read-only reference documents for the operator to consult. These documents can be files (.PDF, .RTF, .TXT) or web links (URLs of HTML pages). They will typically contain instructions, procedures, or other information relevant to the operation of the building automation system. Note that Microsoft .DOC and .DOCX formats are not supported.
14 Documents Documents Reference 14.2.1 Document Settings Fields When you select a document object in System Browser, you can click Edit to display the Document Settings panel which lets you modify the content of the document, and its associated objects. Web URL This option to set a web link as the content of the document. Select file This option sets a file (txt, pdf, rtf) as the content of the document.
Documents Documents Reference 14.2.2 14 Document Toolbar Controls When you select a document object, a toolbar becomes available that lets you modify, save, duplicate or delete that document object. When you select a documents folder in Engineering mode, a toolbar is available that lets you create/delete folders, or create new document objects. Selection in System Browser New Document Object Documents Folder [Operating or Engineering mode] [Engineering mode] n.a.
15 Licensing Licensing Reference 15 Licensing This section provides background information about Desigo CC Licensing feature. 15.1 Licensing Reference The Desigo CC software requires a valid license to run. Typically, the license is stored on the Desigo CC Server. Generally, a valid customer license includes: ● A set of license features to cover the hardware configuration of the system and the site, such as the number of client stations or field points.
Licensing Licensing Reference 15 Property Description License mode Desigo CC current license mode. Sabotage attempts Number of sabotage attempts. Time remaining in this session Residual time in the current Demo Mode or Engineering-license session. ● When the 30-minute demo time expires the project will be stopped and the operator will be forced to log off. ● When the 48-hour Engineering license time expires, the system will switch back to its previous license mode.
15 Licensing Licensing Reference NOTE 1: For license features covering software functionality, one assigned copy is sufficient to enable that functionality for all Desigo CC clients. For example, Assigned=1 for sbt_gms_ext_sm enables System Manager for all clients.
Licensing Licensing Reference 15.1.4 15 Demo License Mode On initial startup, or during normal operation, if no valid license is found the Desigo CC Server switches to Demo Mode, and the system operates for 30 minutes. When the 30-minute Demo Mode time limit expires, the Desigo CC Server stops the project and the operators are forced to log off. If the project is subsequently restarted, the system will run in Demo Mode for another 30 minutes.
15 Licensing Licensing Reference Courtesy Mode Characteristics ● When Courtesy Mode is active, this is visually indicated on the Summary bar in red, with a countdown timer that shows how much time is left. ● If you check the licenses, any license features that are insufficient will be highlighted in red.
Issued by Siemens Switzerland Ltd Building Technologies Division International Headquarters Gubelstrasse 22 CH-6300 Zug +41 58 724 2424 www.siemens.com/buildingtechnologies Document ID: A6V10415471 Edition: 2017-11-30 © Siemens Switzerland Ltd, 2017 Technical specifications and availability subject to change without notice.