https://www.augi.

com/articles/detail/getting-started-with-revit-macros

Introducción a Revit macros

Introducción
Seamos realistas, a veces trabajando en Autodesk® Revit® puede ser una tarea.
Hay algunas tareas que son simplemente aburrido, o repetitivo, o ambos. hojas de
cambio de nombre, salas de renumeración, el cambio de nombres de familia son
todas las tareas necesarias, pero no ayuda precisamente a que para el trabajo
emocionante, sobre todo si tiene que hacerlo más de una vez.

 Afortunadamente, Revit proporciona herramientas para la automatización de este

tipo de tareas repetitivas. Al escribir las macros, puede Revit personalizado a medida
de los detalles de cómo se trabaja. Puede afinar sus herramientas para hacer su
trabajo más rápido y con mayor precisión.

¿Qué es una macro?

Una macro es una serie de comandos y funciones creadas por el usuario que se
escriben utilizando la interfaz de programación de aplicaciones de Revit (API) y
crean en SharpDevelop, un entorno de desarrollo integrado de código abierto (IDE)
integrado en Revit. Las macros se almacenan dentro de los archivos de proyecto de
Revit y se ejecutan directamente desde Revit. A diferencia de otras aplicaciones en
las macros, macros de Revit no se pueden grabar. Debe escribir todo el código de
las macros.

La elección de un idioma
Una de las mejores cosas de escribir macros en Revit es que se puede elegir entre
cuatro idiomas diferentes para escribir el código. Dado que la API de Revit se
construye en el marco Microsoft .Net 4.0, puede escribir macros en el directorio C #,
Visual Basic .NET, Python, Ruby o lenguajes de programación. Todos los idiomas
compilar en el mismo lenguaje intermedio por lo que tiene acceso completo a la API
de Revit, independientemente del idioma que elija. Usted puede construir
exactamente la misma macro en términos de funcionalidad utilizando cualquiera de
los idiomas soportados. La elección de un idioma es en gran medida una cuestión de
preferencia personal y estilo de aprendizaje.

Los ejemplos de este artículo se escriben utilizando VB.Net, que es un gran lenguaje
de los programadores principiantes. Que evolucionó a partir de Microsoft Basic y
conserva la amistad de básico hacia los nuevos programadores. código VB.Net es
más manejable que otros idiomas y es más fácil de leer y entender.
Un beneficio adicional para aprender a escribir macros en Revit es que se puede
poner estas nuevas habilidades de programación para utilizar en otros aspectos de
su trabajo. Una vez que haya una comprensión de la lengua, se puede escribir
código para otras aplicaciones o crear sitios web o aplicaciones independientes. Los
beneficios de aprender a escribir código son muy amplias y le pagarán muchos
dividendos a lo largo de su carrera.

El SDK de Revit 2014

Para empezar, se debe instalar el SDK de Revit 2014. El SDK (kit de desarrollo de
software) contiene los archivos de ayuda y código de ejemplo que le ayudará a
medida que aprende a programar macros. El SDK de Revit 2014 se puede instalar
desde la página principal del instalador de Revit o puede ser descargado desde el
sitio web de Autodesk Developer Network:
http://usa.autodesk.com/adsk/servlet/index?id=2484975&siteID=123112 .

El SDK se instalará en el disco duro y crear las siguientes carpetas y archivos.

Tómese su tiempo para revisar los archivos. Las muestras de macro en particular,
son útiles cuando se empieza a crear sus propias macros.

Figura 1: La carpeta SDK

Su primera macro!
Listo para crear su primera macro? Como verá, el proceso es muy sencillo. Siga
estos pasos y usted estará en su camino a la maestría macro.

1. Abra el Administrador de macros

En Revit 2014, crear un nuevo archivo de proyecto. Una vez creado el archivo, abra
el Administrador de macros mediante la selección de la cinta de Manejo y haciendo
clic en el icono Macro Manager.

Figura 2: El Manejo de la cinta

Las macros pueden residir en el archivo de proyecto activo o dentro de la aplicación.

Macros guardadas en el archivo de proyecto puede ser utilizado por cualquier
usuario que abre ese archivo. Macros guardadas en la aplicación se guardan en la
configuración de Revit del usuario. Estas macros se pueden utilizar en cualquier
archivo de modelo, pero sólo por el usuario que ha creado la macro.

Figura 3: Administrador de macros

2. Crear un nuevo módulo

Para crear una macro, primero debe crear un nuevo módulo. Un módulo es
simplemente un conjunto de macros. Cada macro dentro del módulo debe tener un
nombre único y todas las macros en el módulo debe compilar sin errores.

Haga clic en la pestaña "Proyecto 1" y luego haga clic en el botón de módulo en la
sección "Crear". En el cuadro de diálogo "Crear un nuevo módulo", título de su
módulo "MyFirstModule." Elige VB.Net como el lenguaje del módulo a continuación,
haga clic en Aceptar para crear el módulo.

Una vez Revit ha creado el módulo, SharpDevelop pondrá en marcha en el fondo.

SharpDevelop es el entorno de desarrollo integrado que se construye a Revit para la
programación de macros.

3. Crear una nueva macro

 Ahora que tenemos un módulo, vamos a crear una macro para ir en el módulo.
Hacer Revit la aplicación activa y haga clic en el botón de macro en la sección
"Crear" del cuadro de diálogo Administrador de macros. En el cuadro de diálogo
Crear un nuevo macro, el título de la macro "" MyFirstMacro "y establecer el idioma
de VB.Net. Haga clic en OK para crear la macro.

Figura 4: Crear macro

4. Escriba su macro

De vuelta en el cuadro de diálogo Administrador de macros, seleccione

"MyFirstMacro" de la lista y haga clic en el botón "Editar". Esto le llevará a
SharpDevelop. En la ventana de código SharpDevelop, verá código estándar que se
crea automáticamente. Desplazarse a la parte inferior de la pantalla y verá el código
de partida para "MyFirstMacro."
Figura 5: Código de inicio

Su primera macro va a simplemente pop-up un cuadro de mensaje en Revit. Sólo se

necesita una línea de código. Entre "Public Sub MyFirstMacro ()" y "End Sub",
escriba lo siguiente:

TaskDialog.Show ( "Mi Primera Macro", "Esta es mi primera macro!")

5. Construir su macro

Una vez que haya escrito el código, está listo para construir la macro. Todas las
macros se deben construir o compilar antes de Revit puede ejecutarlos. En los
menús desplegables SharpDevelop, seleccione "Build" y luego "Generar solución."

Figura 6: Generar soluciones

Cualquier error en su código o advertencias se resaltan en la ventana de error y

advertencias en la parte inferior de la interfaz SharpDev. Si no aparece la ventana de
errores, haga clic en la opción "Ver" desplegable a continuación, seleccione
"Errores" de la lista.
En este ejemplo, cuando cree el proyecto en el IDE de macros de Revit, observe que
está generando el proyecto DocVisualBasic y su código de macro VB.NET de nivel de
documento reside en ThisDocument.vb. Puede utilizar el Explorador de proyectos del
IDE para ver su ubicación temporal en el disco. Recuerde que el código para crear
correctamente macros de nivel de documento está almacenado en el archivo RVT
después de guardar dicho archivo. Los archivos del proyecto se eliminan de la ubicación
temporal cuando Revit se cierra.

El cuadro de texto colocado por la macro