TagWorks

TagWorks™ is a family of AddIns or Apps that adds functionality to Bentley Systems MicroStation® CONNECT. It's a tool for architects, engineers, planners and technicians.

When you annotate a DGN element, TagWorks provides two types of label …

  1. A text-only label, which is typically composed of a MicroStation text node element
  2. A SmartText™ label, or annotation cell, which is composed from a cell template. An annotation cell may contain graphics, plain text and SmartText. Usually, you design the template to match your organisation's style requirements.

TagWorks Labels

Text Labels

A TagWorks text label is a MicroStation text node element. The text in the text node is populated with data about the tagged element …

AreaAnnotator example DGN model

Cell Labels

A TagWorks annotation cell label is composed from a cell template that you design. Possibly, your CAD administrator will take responsibility for the label template design so it's maintained with other CAD standards. The cell template is a normal MicroStation cell. You store that cell template in a normal MicroStation cell library.

You can download a sample cell library. Use a copy of that cell library to create your own label templates.

The cell template can contain a mixture of DGN graphic elements, text elements and SmartText elements. The SmartText in the screenshot below are those words surrounded by dollar signs (e.g. $purpose$) …

Annotator label template

Note: There is bug in MicroStation CONNECT that prevents text fields in a cell from being updated automatically. That is, if you tag and subsequently edit an area feature, the area and perimeter of that feature will initially be correct but won't be correct after you modify that area feature.

That bug is known to exist in MicroStation CONNECT Update 11 and earlier. The bug does not exist in MicroStation V8i.

SmartText™

SmartText is text that an application, such as one of the TagWorks family, can replace automatically. TagWorks applications use SmartText in label templates that you design. SmartText is a placeholder: it is the name of an TagWorks property wrapped in special delimiter characters, such as a dollar sign.

You can download a sample cell library. Use a copy of that cell library to create your own label templates.

For example, one TagWorks property is Purpose. In a template cell, place text $purpose$ to instruct TagWorks to replace $purpose$ with the value of that Item Type property in the DGN element that you are tagging.

Annotator label created from template

In the above examples, you can see SmartText in several places. One example is $ID$. You put that SmartText where you want the ID to appear when you tag an area feature. Once the feature is tagged, AreaAnnotator substitutes the actual value of the ID for the SmartText in your label cell. It continues substituting the actual value for each piece of SmartText it finds in your label design. Finally, it adds the label to the active DGN model.

Rotating Text in a Cell Template

Certain TagWorks applications — DoorKeeper for example — provide the facility to rotate text in a label. To achieve that result, the label template must be designed in a particular way.

Unrotated Label

Once placed as a TagWorks label, the text can be rotated …

Rotated Label

The label template should have a nested inner cell named Annotation-01 or similar. That inner cell should contain text and SmartText™ that you want to be rotated after placement.

Rotating Label Structure

The sample cell library includes some templates that are designed to have rotatable SmartText.

Sample Label Template Cell Library

You can download a sample cell library. It contains label templates for several TagWorks applications.