Apama Analytics Builder for Cumulocity IoT 10.3.2 | Apama Analytics Builder for Cumulocity IoT Documentation | Using Apama Analytics Builder for Cumulocity IoT | Using the Model Editor | Working with blocks and wires | Replacing devices and device groups
 
Replacing devices and device groups
You can search the input and output blocks for the devices and device groups that are used in the current model and replace them with other devices or device groups that are currently registered in the Cumulocity IoT inventory (visualized in the Device Management application).
The following rules apply:
*You can replace a device with another device.
*You can replace a device group with another device group.
*When you replace a device with a device group:
*all matching input devices are changed to device groups, and
*all matching output devices are changed to trigger devices.
*When you replace a device group with a device:
*a device group is changed to a device, and
*all matching trigger devices are changed to the specified device.
Note: If you change more than one device group to a device at a time, then only the first specified device will be used to replace all trigger devices.
*An entry named "Trigger Device" is not available for selection in the dialog.
After you have replaced the devices, you need to verify that the measurements that are used by the input and output blocks of the current model still refer to the appropriate measurements. The Cumulocity IoT fragment and series are not changed by the replacement, which may or may not apply to the newly defined device.
* To replace devices or device groups
1. In the toolbar of the model editor, click . This toolbar button is only enabled when at least one device or device group has been defined in the current model. Any defined trigger devices are not considered in this case.
2. In the Current device and device group drop-down list box of the resulting dialog box, select the device or device group that you want to replace. All devices and device groups that are used in the model are available for selection.
3. In the Replace with drop-down list box, select the device (at the top of the list) or device group (further down in the list) that you want to use instead. All devices and device groups that are registered in the Cumulocity IoT inventory are available for selection.
By default, 10 devices and 10 device groups can be shown, sorted alphabetically. You can configure the maximum number of shown devices and device groups as described in Configuring the number of shown devices and device groups. With a large inventory, you will have to search for any devices and device groups that are not shown initially. To do so, enter the name or part of the name in the text box that is shown with this drop-down list box.
The search is case-sensitive. The characters that you type in may be contained at any position within the name. The content of the drop-down list box is updated with each character that you type. When the required entry is shown, click it to select it.
4. If you want to replace further devices or device groups, click Add row. This is only shown if more than one device or device group has been defined in the current model.
A new row is shown, containing additional Current device and device group and Replace with drop-down list boxes, and you can now select one more device or device group to be replaced. Any devices and device groups that you have previously selected for replacement are no longer offered for selection in the Current device and device group drop-down list box.
Repeat this step until all required devices and device groups have been selected for replacement. You can add as many rows as there are devices or device groups in the current model.
5. If you want to remove a row (for example, when you no longer want to replace the selected device or device group), click next to that row. This is only available if the dialog box currently shows more than one row.
6. Click Replace.

Copyright © 2018-2019 | Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors.