autoLink

Click the icon for a Video Example (requires internet connection)

autoLink allows the user to place “smart” annotation symbols within the Revit project referencing a specific view detail and sheet number.  These symbols are then linked to the specific detail and updated during each save, sync, or print of the project.  AutoLinks can be used in place of text notes or in a variety of locations where a section, elevation, or callout is not suitable.

Placing autoLinks

To get started with autoLink you must first make sure that you adjust the autoLink settings to point to the element category and parameter name. By default, autoLink is set to point to a generic annotation with a parameter 'autoLink'.

To place autoLink symbols for the first time in a project use the 'Place autoLink' button on the workFlow panel. This command will load the autoLink symbol into the project if necessary and will allow you to place autoLinks with a single click. You can also assign autoLinks to a parameter in an element and it will allow you to link to a reference view. This is useful for numerous applications, including door schedules and linking actual elements to their drafting view details.

Once an autoLink has been placed, simply select it and edit the reference text just like you would with a normal Revit annotation. If you are referencing an element, simply modify the text instance parameter in that element and sync/save to set the link.  The program will search for any viewport changes and update your autoLink reference to maintain an accurate link. 

autoLink Settings

The autoLink settings dialog consists of five primary settings:

1. Parameter/Category grid - This data grid allows you to fill in specific parameter names and their category.  Please make sure the parameter name exists in an element of that category, otherwise autoLink will not be able to establish a link.  Note that if you add a new parameter with a category that did not exist previously, you will need to restart Revit before it will link properly.  Also, if you wish to delete a parameter from this grid, select the row and press delete.
2. DISABLE autoLink updating - If you prefer not to update your autoLinks every time you Save/Sync or Print, check this box and you can temporarily suspend the automatic updating capabilities.
3. View Reference not found - This setting controls how autoLink behaves when a link is not found. This can happen if the user mis-types a link, when the view that is linked is removed from it's sheet, or when the view is deleted. There are 3 options for dealing with broken links:
   1. Default Text - This will change the autoLink to display whatever text is in the 'Default Link' field rather than an actual link.
   2. Previous autoLink - This option will revert back to the previous correct autoLink (if one is available).
   3. No Change - This option will continue to display the autoLink text even though it is incorrect.  If the “Show Error Message” checkbox is checked, the user will be reminded that this autoLink is incorrect each update.
4. Update autoLinks - Select this checkbox to manually update the autoLinks that are currently placed.
5. Show autoLink update list - Leave this checked if you would like to be notified of every autoLink or viewport that has been modified, otherwise you can uncheck this box for silent mode.

Instant Updater

Due to the potential for an instant update warning screen to appear to users that do not have the autoLink add-in installed, the instant updater has been disabled in v2.0.  However, keep in mind that the add-in will still instantly notify you if you are attempting to reference a view that does not exist.

Customizing autoLink Symbols

It is very simple to create or edit an autoLink symbol.  If you understand how to create or edit a Generic Annotation family component, here are the steps:

1. Create a text parameter that autoLink will use to track viewport changes; this parameter must be created as an instance parameter.
2. Set the autoLink settings to reference the above parameter.
   
3. You will probably need to create a few family types to cover different widths of text for annotation families.  The current autoLink symbol uses visibility parameters to turn on/off different text corresponding to text width.
4. Simply save the family as a new family component and load it into your test project.  The only limitation to creating your own family component is that parameters must be instance or project parameters.