Apply Batch Tags

We have created an Apply Batch Tags form that allows the user to mass add/remove/edit tags in the database.

How to use Apply Batch Tags

Follow along by watching the *Video Coming Soon*

The user will go in Folio app.

Then, once inside the app, the user will select Tools in the top menu bar. Inside the drop down menu, there is going to be an option called "Apply Batch Tags".

After the option has been selected there is going to be a popup window with required fields to execute what you want based on the filter and tags chosen.

The required fields to fill out are:

Use this filter to find the records that you want to batch edit: This form will use the filter below to find a list of records, and then allow you to enter in a list of tags to add/edit/remove.
Enter in the list of tags you want to add or remove: the tags should be comma separated, and should look like this: numTag:67%, boolTag:true, strTag:"Foo". Hint: you can use the - minus character to delete a tag. -tagName

When all the fields have been filled in, the user can hit Apply and the form move to the next stage.

This next stage will be a confirmation, if you want to reopen the form after applying then click the "Continue Tagging" box, finally click Yes to continue.

Examples:

Recommended

Before executing anything with Apply Batch Tags, we recommend you run the filter query in folio to make sure it searches what you are looking for and not other extra stuff. Once you are more confident in what you are filtering, you can skip that step.

How to add/remove tags

First figure out what it is you are looking for and then add that in the first slot provided.

In this case, I want to find all my equipment that are vavs.

Then for the second slot provided, enter the tags you would like to add or remove.

Here I want to add a marker tag called heating, removing a marker tag called cooling, adding a numeric property tag called order with a value of 0.

For Property Tags

Examples for adding property tags - numTag:67%, boolTag:true, strTag:"Foo". Hint: you can use the - minus character to delete a tag. -tagName. If no value is provided, it will become a marker tag.

Now if we look at the vav equipment, you can see the tags that got added and removed.

How to change the value of a property tag

Lets say you wanted to change the Write Level of all Haystack points.

You would enter the filter as point and haystackConnRef. The reason haystackConnRef is used, is to make sure we only get points that are from a Haystack connector and not from a different type of connector. After that, we enter the property tag we want to change along with the value we want it to become. In this case, we are changing the Write Level so it would be entered like this haystackWriteLevel:15.

Here you can see "Write Level" is now 15.

Difference between connectorWriteLevel vs writeLevel

It may be confusing because you'll ask why we used haystackWriteLevel as opposed to writeLevel. If we change the writeLevel, we'll be changing FIN Stacks point write level and not the connectors point write level. FIN Stacks write level doesn't appear in the points view UI so the one you see there is the points write level. We just didn't include the connector type in front of the Write Level in our UI as it takes up space.

How to change history from synchronized to collected

Now we want our history to be collected every 15 mins instead of synchronized.

You would enter the filter as point and haystackConnRef. The reason haystackConnRef is used, is to make sure we only get points that are from a Haystack connector and not from a different type of connector. After that, we want to remove haystackHis property tag and add hisCollectInterval:15min.

You can see now our history will be collected every 15 mins.

Adding COV

If you want to also include COV, then for booleans, enums, strings add a marker tag called hisCollectCov. For numerics it would be a property tag with a value of what you want it to be greater than to trigger the change (hisCollectCov:2).