Creating macros

• In Administration panel go to Text Macros panel and click on Add button
  
  
  

  Open

  

  
  
  

• Type in macro Name

• Perspective set field

• Choose Target class from active configuration

• Choose Target Field of chosen class. This field's value (if it exists) will show on resolved macro
  
   

  Open

  

  
  
  

• Click Add button to finish adding macro. Macro will show on the list.
   

Adding macros to Print Templates

• Go to Templates manager and click on desired Template

• On Draw toolbar select Add text button and click on template below to point macro into desired place.

• In Edit Text dialog choose Macro checkbox to enable macro list. 
  
  
  

  
  
  

Added macro will be shown in Template Editor in unresolved state - visible as macro name in square brackets.

Macros added to Template Editor will resolve on printouts and in print preview if prepared template is selected.

Print Preview - editable text macros

Users can define editable text place-holders for print templates. This functionality is available as a text macro called "Template".

Values can be filled in at a print preview stage.

Preparing a Print Template with editable elements

In Template Editor, during defining new text, activate Macro checkbox and choose Template as macro type.
Text content will become displayed as [Template], but in contrast to other macro types, it can be edited.

Enter name of custom macro as desired, thus defining hint advising what content is supposed to be entered manually when using this template for printing.

Using a template with editable texts

During Print Preview, texts from print template defined as "template macros" can be selected for editing.

Click (left or right) onto chosen text element to display short form showing text to be filled-in with a hint displayed as filed label.

Alternatively, click "Fill in" button displayed near Print button to show form with all texts in this specific template that can be filled.

This is a convenient function that allows user to fill in all texts in one place, without the need to click individual elements. 

System Macro "Current User"

Since 4.8

New system macro has been added called Current-User to list of other system macros. It can be added both in print template and on a drawing directly. 

When resolved on a drawing, print-preview or a printout it will display current user Full Name attribute. 

Adding macros on vector overlay or redline

If user have enough set of rights macro can be added in viewer to selected layer in main HDC panel for selected drawing. It will only exists on this one drawing.
It should resolve (show database data based on it's configuration) only in view/print-preview mode of viewer, and be unresolved in Edit/Redline mode (to be implemented yet).

Those macros are treated in many ways as standard entities - for instance they can be linked to objects. 
So if you add Building Number macro to drawing connected to Floor you can link it to desired Building to display it's properties.

 

After linking building to this macro it will resolve and show building number.

Macros behaviour when it does not resolve to data

When macro do not resolve into expected data from object's property than you will see:

• Metadata field that macro refers is empty:  -- ;

• Macro does not exists (added to print template and then deleted from macro list): XX ;

• Macro cannot be resolved - object not found: - ;

• Macro field not exists (very rare): ** .