Dynamic Model Updater Macro

Let's take a quick look at implementing a dynamic model updater in a macro:

Task

Dave raised and solved an interesting issue concerning macros, an area that we have not discussed much here yet, in his Revit API discussion forum thread on IUpdater in a project macro on startup:

I'm trying to use IUpdater in a macro that automatically starts when a project opens. Is this possible?

So far, I used Macro Manager / Create to set up some boilerplate.

Then, I pasted in Autodesk's WallUpdater example code from the knowledge article on Implementing IUpdater into my public partial class ThisDocument.

I figured out how to run the code on project startup by calling it from the boilerplate's private void Module_Startup.

But I haven't had any luck calling WallUpdater.

Here is my code:

using System;
using Autodesk.Revit;
using Autodesk.Revit.DB;
using Autodesk.Revit.UI.Selection;
using Autodesk.Revit.UI;
using Autodesk.Revit.Attributes;
using System.Collections.Generic;
using System.Linq;

namespace test
{
  [Transaction( TransactionMode.Manual )]
  [Autodesk.Revit.DB.Macros.AddInId( "redacted" )]
  public partial class ThisDocument
  {
    private void Module_Startup( object sender, EventArgs e )
    {
      TaskDialog.Show( "hello",
        "this pops up when you open the project" );
    }

    private void Module_Shutdown( object sender, EventArgs e )
    {
    }

    #region Revit Macros generated code
    private void InternalStartup()
    {
      this.Startup += new System.EventHandler( Module_Startup );
      this.Shutdown += new System.EventHandler( Module_Shutdown );
    }
    #endregion

    public class WallUpdaterApplication : IExternalApplication
    {
      public Result OnStartup( UIControlledApplication a )
      {
        // Register wall updater with Revit
        WallUpdater updater = new WallUpdater(
          a.ActiveAddInId );

        UpdaterRegistry.RegisterUpdater( updater );

        // Change Scope = any Wall element
        ElementClassFilter wallFilter
          = new ElementClassFilter(
            typeof( Wall ) );

        // Change type = element addition
        UpdaterRegistry.AddTrigger(
          updater.GetUpdaterId(), wallFilter,
          Element.GetChangeTypeElementAddition() );

        return Result.Succeeded;
      }

      public Result OnShutdown( UIControlledApplication a )
      {
        WallUpdater updater = new WallUpdater( a.ActiveAddInId );
        UpdaterRegistry.UnregisterUpdater( updater.GetUpdaterId() );
        return Result.Succeeded;
      }
    }

    public class WallUpdater : IUpdater
    {
      static AddInId m_appId;
      static UpdaterId m_updaterId;
      WallType m_wallType = null;

      // constructor takes the AddInId for the add-in
      // associated with this updater
      public WallUpdater( AddInId id )
      {
        m_appId = id;
        m_updaterId = new UpdaterId( m_appId, new Guid(
          "FBFBF6B2-4C06-42d4-97C1-D1B4EB593EFF" ) );
      }

      public void Execute( UpdaterData data )
      {
        Document doc = data.GetDocument();

        // Cache the wall type
        if( m_wallType == null )
        {
          TaskDialog.Show( "hello", "world" );
        }

        if( m_wallType != null )
        {
          TaskDialog.Show( "hello", "world" );
        }
      }

      public string GetAdditionalInformation()
      {
        return "Wall type updater example: updates all "
          + "newly created walls to a special wall";
      }

      public ChangePriority GetChangePriority()
      {
        return ChangePriority.FloorsRoofsStructuralWalls;
      }

      public UpdaterId GetUpdaterId()
      {
        return m_updaterId;
      }

      public string GetUpdaterName()
      {
        return "Wall Type Updater";
      }
    }
  }
}

All the samples I've found so far appear to be written as add-ins.

I found one single sample showing an IUpdater in a macro, for wrangling revisions with Ruby. Unfortunately, that's a bit too complex for me to follow at this point, especially in Ruby.

I was hoping to find an RVT with a vanilla C# IUpdater macro embedded, similar to the SDK Revit_Macro_Samples.rvt.

Solution

The Boost your BIM article on automatically running API code when your model changes looks promising...

Yes, I got it working!

Here are the steps I followed:

  private void Module_Startup( object sender, EventArgs e )
  {
    RegisterUpdater();
  }

  public class FamilyInstanceUpdater : IUpdater
  { ... }
  public void RegisterUpdater()
  { ... }
  public void UnregisterUpdater()
  { ... }

Make sure FamilyInstanceUpdater, RegisterUpdater, and UnregisterUpdater are inside the scope of ThisDocument.

For testing, I found it handy to replace boostyourbim's Execute code with this:

  public void Execute( UpdaterData data )
  {
    Document doc = data.GetDocument();
    TaskDialog.Show( "Revit", "hello" );
  }

At this point, the macro should be working. Any time you draw an element, you'll get a little popup that says 'hello'.

If you close your project with a successfully built macro, the macro will run automatically the next time you open the project.

I'm sure lots of improvements can be made. For instance, Jeremy recommended using DocumentOpened. And my version currently works for columns and beams, but not for walls. Any input would be appreciated.

Meanwhile, thanks very much to Jeremy for taking a look and to boostyourbim for their code. Hope this helps someone.

Many thanks to Dave for his research and sharing the solution!

Drill Up the Filter

The initial version works for columns and beams, but not for walls.

This is due to the FamilyInstanceUpdater.

It defines a familyInstanceFilter variable as new ElementClassFilter( typeof( FamilyInstance ) ).

Beams and columns are family instances, and walls are not.

To expand the filter to include Wall objects as well as FamilyInstance objects, you can change its name and definition to something like this:

  ElementFilter f = new LogicalOrFilter(
    new ElementClassFilter( typeof( FamilyInstance ) ),
    new ElementClassFilter( typeof( Wall ) );


Macro photography