Niagara R2: How to Modify Multiple Object Property Values at Once Using AdminTool

[Product_Support]

Issue

Need to change the booleanKey property value from “overridden” to “value” for hundreds of GxBoolean objects. Is there a way to update multiple objects simultaneously without editing each one individually?

Product Line

TAC IA Series

Environment

Niagara R2 (all versions)

Cause

Manually updating each object’s property is time-consuming. Niagara R2 includes an AdminTool utility that provides an admin-level command to Search and Replace property values across multiple objects in the station database.

Resolution

1. Locate AdminTool

   • Found in the Local Library: tridium/apps/AdminTool (JAR file).

2. Add AdminTool to Station

   • Copy the AdminTool app into the station.

3. Configure AdminTool

   • Open AdminTool and go to the Config tab.
   • Set parameters as follows:
     • rootNode: /db/
     • propertyName: booleanKey
     • elementName: (leave blank)
     • newValue: Value
     • recurseChildren: true

       • Explanation: When set to true, the tool will traverse all child nodes under the specified rootNode and apply changes to matching properties. If set to false, only the root node is modified.
     • objectTypeFilter: (optional)
     • nodeNameFilter: (optional)
     • propertyValueFilter: (optional)

4. Execute Search and Replace

   • Right-click AdminTool and select searchAndReplace.
   • All GxBoolean objects’ booleanKey will now be set to “value”.

Additional Info:
Refer to WorkPlace Pro Help:
Help > Index > General Index > AdminTool for more details.