Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

The Alias Group object allows custom item names to be linked to protocol item names. This is particularly useful with numeric item names.  An Alias Group can be created for use with a single device, a group of devices of the same protocol (if the item names are the same for devices of the protocol), or for the ACM server.   Device level alias groups are assigned on the "Options" tab of the device, and a server level alias group is assigned on the "Aliasing" tab of the $Server object.  Device objects may have multiple alias groups while the $Server object can have only one.

...

To add a device level alias to an Alias Group, enter the alias name to be used by OPC clients and the protocol item that it represents. For example, to create an alias for the modbus Modbus register 5176 of an Omni Modbus device, use the alias name "Mass" and the item name "5176". 

...

Info
In an OPC Client, the item must include the device name.  e.g. To retrieve the Mass value from a device named "ModbusOmniDevice", the OPC Item would be "ModbusOmniDevice.Mass".

Anchor
Server Level Alias Groups
Server Level Alias Groups
Server Level Alias Groups

When an alias group is assigned to the $Server object, it is the only alias group used by ACM - overriding all other alias group assignments. To create an alias for use at the server level, the item name property must include both the device name and the item name. A $Server alias object can use a string in any format for the alias name, but the item name must contain the device name and the item name. Using the same example from above, an alias for register 5176 could be entered as "ModbusOmniDevice.Mass" or "MassFromOmniDevice". The item name would be entered as ‘ModbusOmniDevice.5176’ (including the device name). 

...

Item modifiers and item scaling can be used in alias groups, but the modifier will must be appended to the item name and NOT the alias name. For example if the raw value returned for Mass is 2500 and the scaled value should be .25, the alias name might be entered as ‘Scaled Mass’ and the item name would be entered as ‘5176{SG:.001,0}’.  For more information on item scaling, please see Item Scaling section.

Configuration

...

Info

See the General Object Configuration

...

 guide for assistance configuring the General tab.

Alias Records

Edit Records

Click the Edit Records button to open the Alias Record Collection dialog box to add the alias names and item names.

...

The name by which the item will be referenced.  Modifiers and scaling are not allowed on the Alias Name.  Max Length: 255 characters.

...

Info
titleSaving Record Collection Changes

When record editing is complete, Click Close to return to the owning object type. Click the Save button  to save any changes made to the record collection.

Anchor
AliasGroupOptions
AliasGroupOptions
Options

Image RemovedImage Added

Output Destinations

All items in the alias group are sent collectively to the selected destination..  

     ACM Mobile: Sends the items to ACM Mobile app user

...

  • Auto Poll: When checked, ACM will advise the items in the Alias Group and poll them on the interval specified, even without being advised by an external client. 
  • MQTT: When checked, ACM will publish the items in the Alias Group via MQTT after they are polled (using the broker settings configured in ACM Monitor).

Interval

This is the schedule interval that is applied to the items in the alias group. If the interval is configured as "Unassigned", then the items will be polled on interval one of the schedule used by the device they belong to. If the interval is configured as something other than "Unassigned", for example "Interval 2" then the items will be polled on the selected interval (interval two in this example) of the schedule used by the device. Selecting a specific schedule has the same effect as adding an interval number to all the items with text like "<I2>".

Info
If items within the alias group already have an interval number applied to the item name, that interval will be used for those items even if the Alias Group's interval is different.