Creating and deleting objects - Metasys - LIT-12012116 - Server - Metasys UI - 6.0

Johnson Controls System Configuration Tool (JCT) Help

Brand
Metasys
Product name
Metasys UI
Document type
User Guide
Document number
LIT-12012116
Version
6.0
Revision date
2022-05-20
Language
English

What is the Create and Delete Object feature?

With this feature you can manage objects in Metasys UI and JCT. You can create and delete single or multiple objects, discover objects under integrations, and fully configure objects.
Note: Object discovery is not available in JCT.

What do the Create and Delete Object feature icons look like?

The following table outlines the Create and Delete Object feature icons.

Table 1. Create and Delete Object feature icons
Icon Icon name Icon description

Add Network Item Opens the Create Item wizard, where you can create an object.

Delete Network Item Opens the Delete Item window, where you can delete an object.

How do I access the Create and Delete Object feature?

  1. Click the Network tab to open the Network tree.
  2. The Create and Delete Object feature is represented by a toolbar over the navigation tree. The toolbar contains the Add Network Item icon, the Tree Settings icon, and the Delete Network Item icon.

Who can access and use the Create and Delete Object feature?

This feature is accessible to both Administrator and Non-Administrator users.

You require the Configure Items permission for at least one authorization category to view the Create and Delete Object toolbar in the Network tree. If you do not have this permission for any of the authorization categories, the toolbar is not displayed. In addition, to view the network tree, you require the User Can View The Item Navigation Tree (Default Tree) property in your User Details within the User Management feature in Metasys UI.

The available actions depend on your authorization. The following table outlines the actions and required authorization.
Table 2. Create and Delete Object feature required authorization
Action Required authorization and other requirements
Creating an object Configure Items permission for at least one of the authorization categories. This applies to all object types and to all means of object creation, including discovery.
Creating an extension on an object Configure Items permission for the authorization category of the parent object, as extensions inherit the parents' authorization category.
Deleting an object
  • Configure Items permission for the authorization category of the object you wish to delete.
  • An object that has one or more child objects is deletable only if all of its child objects are also deletable.
  • An object is only deletable if you can create that object with Metasys UI.

Which object types are supported?

Depending on the object that you select from the Network tree, the Create Item wizard displays the available object types. For example, when you select an engine from the Network tree, one of the options for General Type is Extension, and the corresponding options for Object Type are Alarm, Trend, Averaging, Totalization, or Load . The following table outlines these different options in more detail.

Table 3. Create Item wizard - type options
Network tree selection General Type options Object Type options
Site None
Metasys Server Integration (OAS, NAE85, and LCS85 only)
  • BACnet Integration
  • Field Bus MSTP
  • VND Integration
Object
  • Folder
Additionally, OAS only:
  • AV
  • BV
  • Calendar
  • MV
  • Schedule
Extension
  • Alarm
  • Averaging
  • Totalization
  • Load
  • Trend
Engine Integration
  • BACnet Integration
  • Field Bus MSTP
  • LON Trunk
  • N2 Trunk
  • VND Integration
Object
  • AV
  • Accumulator
  • Auto Shutdown
  • BV
  • Calendar
  • Data Broadcast
  • Electric Demand Control
  • Event Enrollment
  • Folder
  • Generator Load Control
  • Global Data
  • Group
  • Interlock
  • Loop
  • MV
  • Multiple Command
  • Notification
  • Optimal Start
  • Program (Control System)
  • Pulse Meter
  • Schedule
  • Signal Select
  • Solar Clock
  • Trend Log
Extension
  • Alarm
  • Averaging
  • Totalization
  • Load
  • Trend
Integration Field Device

The object types depend on the selected field device. The following object types are supported:

  • For BACnet IP: General BACnet Device or JCI Family IP BACnet Device
  • For Field Bus MSTP: General BACnet Device or JCI Family BACnet Device
  • For LON Trunk: LON Controller
  • For N2 Trunk: Controller
  • For VND Integration: VND Controller
Object Folder
Extension
  • Alarm
  • Averaging
  • Totalization
  • Load
  • Trend
Field Device Field Point
The object types depend on the selected field point. The following object types are supported:
  • For General BACnet Device: Accumulator, AI, AO, AV, Averaging, BI, BO, BV, Calendar, Characterstring Values, Command, Electric Demand Control, Event Enrollment, Generator Load Control, Group, Integer Value, Life Safety Point, Life Safety Zone, Load Control, Loop, MI, MO, MV, Notification, Positive Integer Value, Program (Control System), Pulse Converter, Schedule, Trend Log Multiple, and Trend Log
  • For JCI Family IP BACnet Device: Accumulator, AI, AO, AV, BI, BO, BV, Calendar, MV, Notification, Schedule, and Trend Log
  • For JCI Family BACnet Device: Accumulator, AI, AO, AV, BI, BO, BV, Calendar, MV, Notification, Schedule, and Trend Log
  • For VND Controller: AI, AO, BI, BO, MI, and MO
  • For N2 Controller: AI, AO, BI, BO, MI, MO, Accumulator, and N2 Pulse Counter
  • For LON Controller: AI, AO, BI, BO, MI, and MO
Object Folder
Extension
  • Alarm
  • Averaging
  • Totalization
  • Load
  • Trend
Folder Object
  • AV
  • Accumulator
  • Auto Shutdown
  • BV
  • Calendar
  • Data Broadcast
  • Electric Demand Control
  • Event Enrollment
  • Folder
  • Generator Load Control
  • Global Data
  • Group
  • Interlock
  • Loop
  • MV
  • Multiple Command
  • Notification
  • Optimal Start
  • Program (Control System)
  • Pulse Meter
  • Schedule
  • Signal Select
  • Solar Clock
  • Trend Log
Note: When you select a folder under an integration, you can add a field device within that folder. When you select a folder under a field device, you can add field points.
Any other object type that supports alarms and trends, such as AV, BV, extensions, etc. Extension
  • Alarm
  • Averaging
  • Totalization
  • Load
  • Trend
You can also view and edit the following objects:
Table 4. Objects available for viewing and editing or viewing only
General Type Object
Integration View and edit the following objects after creation in SMP or SCT:
  • N1 Migration
  • Wireless Supervisor
  • XL5K Integration
  • SA Bus (internal object)
  • External Data Connector integration on 12.0 engines for MQ Telemetry Transport (MQTT)
Field point on BACnet IP and MS/TP devices View and edit the following object after creation in SMP or SCT: Electric Demand Monitoring
Field point on LON and N1 controllers View and edit the following objects after creation in SMP: Generic Integration Object (GIO)
Object

View and edit the following objects after creation in SMP or SCT:

  • Demand Limiting Load Rolling (DLLR)
  • Electric Demand Monitoring

View and edit the following objects after creation in CCT:

  • Activity Sequencer
  • Local Application
  • Local Hardware
Extension Resource File
Other

View the following objects after creation in SMP or SCT:

  • Summary Definition
  • Views

View the following objects after creation in SCT: UGT / GGT Graphic

How do I manually create and configure an object or integration?

  1. Select the location (object) in the Network tree where you wish to create the new object.
  2. Click or tap the Create icon in the upper left of the Network tree. The Create Item wizard opens.
  3. Select a general type from the General Type drop-down list.
  4. Select an object type from the Object Type drop-down list.
  5. Review the unique identifier in the Unique Identifier field and change it, if required.
    Note: A default value is used for the unique identifier. The unique identifier is used to form part of the Item Reference of the object, which cannot be modified after creation. You can change the object's name in the Configuration tab of the wizard. The object's name displays in the Network tree.
  6. Click or tap NEXT.
  7. Complete the required fields in the Configuration tab and, if applicable, the fields for any additional tab in the wizard. For example, if you create a Multiple Command object, complete the fields under the Action Tables tab. If you create a Schedule object, complete the fields under the Schedule tab. If you create an Event Enrollment object, complete the fields under the Event tab next to the Configuration tab.
  8. Click or tap CREATE.
Note: To completely configure objects such as Schedule, Interlock, Multiple Command, and others; for example, you need to complete the configuration in the edit mode of the newly created object. The system automatically navigates to the new object after creation.

How do I manually create and configure an extension?

  1. Select the location (object) in the Network tree where you wish to create the new extension.
  2. Click or tap the Create icon in the upper left of the tree. The Create Item wizard opens.
  3. Select a general type from the General Type drop-down list.
  4. Select an object type from the Object Type drop-down list.
  5. Select an attribute from the Attribute drop-down list.
  6. Enter a unique identifier in the Unique Identifier field.
    Note: A default value is used for the unique identifier. The unique identifier is used to form part of the Item Reference of the object, which cannot be modified after creation. You can change the object's name in the Configuration tab of the wizard. The object's name displays in the Network tree.
  7. Click or tap NEXT.
  8. Complete the required fields in the Configuration tab to configure the extension.
  9. Click or tap CREATE.

Which extensions can I create?

From Metasys Release 12.0, you can create alarm, trend, averaging, and totalization extensions. See Alarm extensions, Trend extensions, Totalization extensions, Averaging extensions, and Load extensions for more information about these extension types.

Where does a newly created object appear in the network tree?

When you create a new object on the server, an engine, or a controller, the newly created object is appended to the bottom of the list of its parent object. You can reorganize the list with the Organize Tree functionality. See Tree settings for more information.

How do I delete an object?

  1. Select an object in the Network tree that you want to delete.
    Important: The object's child objects are also deleted by this action.
  2. Click or tap the Delete icon. The Delete Item window opens.
  3. Review the information pertaining to the deletion of a single object and its children.
  4. Click or tap DELETE.

See also Who can access and use the Create and Delete Object feature? for more information about authorization to delete an object.

Who can see the results of a create or delete operation?

The result of any create or delete operation takes effect immediately for the user who performed the action. However, all other users have to refresh the web browser to see the changes in their Network tree.

Is the Create and Delete Object feature supported on all devices?

Yes, the Create and Delete Object feature is supported on desktop, tablets, and smartphones.