Approved Library Location

Knowledge BaseUser Guidance & Protections
Approved Library Location

In this article:


Approved Content Sources provides Guardian level of protections by presenting a Command Message when an end user attempts to load a Revit family from a non-approved location. Furthermore, Approved Content Sources provides the ability for Guardian to respond differently to incoming families based on different conditions and rules, such as enacting Incoming Properties when the family comes from a non-approved source and disabling scanning and processing for content inserted from the firm’s content management solution.  

Guardian does this by comparing incoming families with any rules created by administrators. These rules can be specific to the location the file is loaded from, the families category, or even the name of the file itself. If a match is determined, Guardian will, or will not, scan and process the family’s Incoming Properties as determined by the User Experience set by Company/Project Administration for that rule. If the protection mode for the triggered rule is set to Guide or Prevent, Guardian will provide the end-user a customized Command Message.

Why You Need This Feature

Firms and Project Administrators spend a tremendous amount of time and money creating and maintaining Revit family libraries that align with the firm’s standards and BIM infrastructure at large. Too many times these standards are undermined when end users load Revit families from locations other than the firm’s library. Guardian’s Approved Content Sources does exactly as its name implies, it ensures Revit families are being sourced from the firm’s libraries and discourages families from unknown sources.

As BIM Managers, we work hard to keep a clean, curated, and comprehensive family library. It is imperative to a healthy file and to maintaining company standards. It is generally preferred that end users use this content first before downloading from online sources or digging into that desktop folder they have been collecting over the years.  

Customize Approved Content Sources

When Approved Content Sources is first enabled within Project Configurations under the Custom Interactions tab, it will be adopted by each project model once the model is registered. Approved Content Sources can be further customized at the project level within Project Settings on a model-by-model basis.

Project Configurations dialog for enabling behaviors when loading families

Enabling Customize behaviors when loading families that meet rules will activate Approved Content Sources.

Select the Setting Cog (A) to customize the Guardian protections for Approved Content Sources.

Dialog for loading family rules

Within the Loading Family Rules dialog, one or more rules can be established. Guardian provides pre-loaded rules to use as a template. Any created rules will show in this dialog (B).

Select the Create New button (C) to create a new rule. Once created, the rules can be modified, deleted, or re-ordered. It is important to note that the rules will run in order from top to bottom until a match is found (if any at all).

Rule dialog for adding a new custom rule

Within the Rules dialog, a rule name can be entered and the criteria for the rule can be set.

Many condition types are available to specify the type of file or file location that the rule should capture.

Guardian condition types

The User Experience for Revit families loaded into projects can be specified under the Scanning/Processing Experience section of each rule.

The available options are explained below:

  • Do not do anything: Guardian will not perform any action on incoming Revit families.
  • Silent Mode: Guardian will perform all standard actions in the background. No dialogs will be shown to end users.
  • Show Dialogs (one time mappings): End users will be prompted with a dialog where they can see incoming properties and create one time mappings if desired.
  • Show Dialogs (full mappings): End users will be prompted with a dialog where they can view incoming properties and create full mappings if desired. Any mappings created will be added to the current applied Mapping Configuration.

The Protection Mode can be customized for when end users load families from non-approved sources.

  • Set the Guardian Protection Mode to: Monitor, Guide or Prevent.
  • Send email: If checked, will notify the Project Administrator when an end user attempts to overwrite a protected family.
  • Req. Comment: If checked, requires the end user to provide a comment to proceed.
  • Edit Message: Allows the Project Administrator to customize a Command Message that the end user will see when they attempt to override a protected family.  

End user experience

When an end user attempts to load a family from a non-approved content source, Guardian will alert them with the custom Command Message provided by the Project Administrator. Depending on the applied Protection Mode settings, the end user may be required to input a comment and/or password before proceeding.

The Command Message will also show the name of the rule that triggered the protection.

Guardian command message for loading a Revit family

Depending on the User Experience, the end user will be required to process the incoming Revit family’s Incoming Properties.

Have questions?

Reach out to learn more, ask any questions, or meet the team! We'd love to learn more about your challenges and explore the more proactive solution.

Get in Touch