Procesar modelos vinculados en Revit Automation API: guía paso a paso

¿Qué aprenderás en esta guía?

Uno de los problemas que pueden surgir al vincular un modelo de Revit a un trabajo de automatización basado en la nube es que, en lugar del archivo RVT único esperado, se descargue un paquete ZIP. Esto no siempre significa que haya ocurrido un error de descarga: según la guía de Autodesk, si los archivos vinculados de un modelo de Revit Cloud Worksharing no tienen el mismo estado de publicación actualizado que el modelo principal, el paquete puede incluir tanto el RVT principal como los RVT vinculados.

En esta guía aprenderás a determinar si el modelo es un archivo de Revit Cloud Worksharing, si está marcado como diseño compuesto y qué método de automatización elegir. También veremos las diferencias entre el flujo de trabajo para los archivos publicados antes del 7 de febrero de 2025 y el de los publicados en esa fecha o después.

Autodesk indica que la API de Revit se puede utilizar para automatizar tareas repetitivas y ampliar las funciones de Revit. Revit Automation API permite realizar operaciones como crear, inspeccionar y modificar datos de Revit mediante aplicaciones y servicios basados en la nube. En este ejemplo, el objetivo es incorporar correctamente un archivo de Revit a un elemento de trabajo de automatización.

Requisitos y preparación

Para este flujo de trabajo necesitas una aplicación que pueda trabajar con las API de Autodesk Platform Services (APS), una forma de consultar la información de los archivos y sus versiones, y los archivos de modelo que se incorporarán al elemento de trabajo. La página de API de Autodesk incluye guías para desarrolladores, SDK, ejemplos de código y recursos de soporte de la comunidad. Revit Automation API permite crear aplicaciones basadas en la nube con acceso a Revit DB API sin necesidad de instalar Revit en un equipo de escritorio.

Un anuncio anterior de Automation API en las fuentes menciona una suscripción activa a Forge o una cuenta de prueba. Esta información no confirma las condiciones actuales de acceso ni los precios; consulta los recursos actualizados de APS para comprobar los requisitos de cuenta y los precios antes de empezar a implementar la solución. La documentación no especifica una versión concreta de Revit para esta operación.

Antes de empezar, prepara lo siguiente:

• El registro del archivo o la versión del modelo de Revit Cloud Worksharing que se procesará en APS.

• Las credenciales necesarias para realizar llamadas autenticadas a la API.

• Una herramienta que permita consultar la fecha de publicación y los atributos de la versión del archivo.

• Los datos de registro que indiquen la fecha de publicación del modelo y el nombre del archivo principal.

Paso a paso: determina el tipo de modelo y el método de transferencia

1. Comprueba si el archivo corresponde a un modelo de Revit Cloud Worksharing. La guía de Autodesk recomienda revisar el campo attributes.extension.type en las llamadas a la API que devuelven el contenido de una carpeta de proyecto, el registro de un elemento o la información de una versión. Si el valor de este campo es versions:autodesk.bim360:C4RModel, el archivo se identifica como un modelo de Revit Cloud Worksharing. En lugar de decidir únicamente por la extensión, consulta los datos de la versión.

2. Consulta si el diseño es compuesto. El campo attributes.data.isCompositeDesign del mismo registro de versión indica si el modelo es compuesto. Si el valor es true, se trata de un diseño compuesto de Revit; el contenido descargado puede ser un ZIP que incluya los archivos RVT vinculados al modelo principal. Si el valor es false, según la explicación de Autodesk, el archivo principal y sus vínculos se han publicado con sus versiones más recientes y la descarga puede obtenerse como un único RVT.

3. Identifica el nombre de archivo del modelo principal. En un modelo compuesto, el campo attributes.data.compositeParentFile indica el nombre del archivo principal de Revit. Este dato es necesario, sobre todo en el flujo de trabajo anterior, para saber qué archivo del ZIP debe utilizarse como modelo principal. No deduzcas el nombre del archivo principal: utiliza el valor del registro de versión.

4. Elige el método según la fecha de publicación. Si el archivo se publicó antes del 7 de febrero de 2025, puedes utilizar el método anterior de Autodesk: establece zip en true para el archivo de entrada del elemento de trabajo y asigna el nombre del archivo del modelo principal a pathInZip. Así, al incorporar el paquete ZIP al trabajo de automatización, se indica la ruta del archivo principal que abrirá Revit.

5. Para los modelos publicados el 7 de febrero de 2025 o después, sigue el método nuevo. Para un archivo publicado en esa fecha o más adelante, Autodesk recomienda utilizar la llamada GET linked Revit files para obtener el modelo principal y los archivos RVT vinculados que no se han publicado. Incorpora al elemento de trabajo la información del modelo principal y de los archivos vinculados que devuelve la llamada. En lugar de aplicar directamente el método ZIP anterior, utiliza el método que corresponda según esta fecha.

6. Valida las entradas del elemento de trabajo. Si elegiste el método anterior, asegúrate de que el ajuste ZIP y el valor de pathInZip sean correctos. Con el método nuevo, comprueba que, junto con el modelo principal, también se hayan incorporado los archivos vinculados devueltos por la llamada. En el ejemplo de Autodesk se utilizan URL firmadas para estos archivos; no copies las URL del texto de ejemplo: utiliza los valores actualizados de la respuesta de tu propia llamada a la API.

Errores frecuentes

• Dar por hecho que el ZIP es un archivo dañado: Si los modelos vinculados no se han publicado con sus versiones actualizadas, recibir un ZIP puede ser lo esperado.

• Confundir el tipo de modelo con su estado compuesto: El valor C4RModel identifica el tipo de archivo de Cloud Worksharing; isCompositeDesign indica si el diseño es compuesto. Comprueba ambos campos.

• Elegir el RVT principal por suposición: Obtén el nombre correcto del archivo en el ZIP a partir del campo compositeParentFile.

• Pasar por alto la fecha: La guía describe métodos de transferencia distintos para los archivos publicados antes y después del 7 de febrero de 2025.

• Utilizar enlaces de acceso temporales del ejemplo: Las URL firmadas de la fuente forman parte de una respuesta de ejemplo. Utiliza los enlaces devueltos por tu propia llamada.

Efectos en los flujos de trabajo de arquitectura y visualización

Este método es importante para los equipos que integran en sus flujos de trabajo en la nube basados en Revit tareas repetitivas de revisión de modelos, extracción de datos, generación de informes o documentación automática. Entre los usos que menciona Autodesk están la inspección y el análisis de datos de Revit, la exportación de datos, la creación de familias personalizadas de Revit y la generación automática de documentación. Los estudios de arquitectura, los equipos de interiorismo y los responsables de BIM pueden reducir el riesgo de utilizar datos de entrada incorrectos o incompletos si comprueban el estado de las versiones de los modelos vinculados antes de automatizar el proceso.

Para los equipos de visualización, transferir juntos el archivo principal y sus vínculos también permite que la automatización trabaje con los datos de proyecto previstos. Sin embargo, esta guía no aporta información sobre el rendimiento de render, los requisitos de hardware ni la compatibilidad con un software de visualización específico. Antes de implementarla, verifica las condiciones de acceso a la API, el estado de la licencia y la compatibilidad del flujo de trabajo con los datos de Revit.

Próximos pasos

Haz la primera prueba con un modelo que no sea crítico. Registra los atributos de la versión del archivo, confirma la fecha de publicación y elige el método adecuado según esa fecha. Comprueba en el resultado de la automatización que se haya procesado el RVT principal esperado. Después, consulta las guías de Revit API de Autodesk, los tutoriales de iniciación y los ejemplos de código para adaptar el flujo de trabajo a tus necesidades de extracción de datos o generación de informes.

Fuente y licencia

Esta guía se ha adaptado al turco a partir de las páginas de Autodesk sobre Revit Automation API y Revit API, así como de un artículo para desarrolladores que explica cómo incorporar diseños compuestos de Revit a elementos de trabajo de automatización. Todas las fuentes son contenidos oficiales para desarrolladores de Autodesk y se ofrecen bajo una licencia abierta.