Últimas noticias
Visibilidad de Scope Box en Revit: cómo controlarla en las vistasProcesar proyectos con modelos vinculados mediante Revit Automation APIDesenfoque de movimiento realista en Blender: obturador y flujo de trabajoRhino Flow y FlowAlongSrf: cómo adaptar geometría a curvas y superficiesUso de la cámara panorámica en Blender: 360°, VR y proyección de domoObtén datos de superficies e intersecciones con Raycast Node en BlenderAfter Night There Is Nothing: instalación de tres cúpulas en SharjahGraphic Override Rules en Archicad 29: guía para crear reglasAnálisis de imágenes arquitectónicas con Gemma 4: instalación y uso en PythonCrear biseles controlados y no destructivos con Bevel Modifier en Blender
TutorialesRevitOMARevit Automation API

Procesar proyectos con modelos vinculados mediante Revit Automation API

Esta guía explica cómo determinar si los proyectos de Revit Cloud Worksharing se descargan como ZIP o como un único archivo RVT, y cómo incorporar modelos vinculados al flujo de trabajo de Automation API.

Flujo de trabajo BIM en la nube representado con volúmenes arquitectónicos vinculadosImagen IA
Imagen ilustrativa generada con IA.Imagen: 3dsınıfı / FCA AI

En resumen

  1. Comprueba el campo `isCompositeDesign` para saber si un modelo de Revit Cloud Worksharing es un diseño compuesto.
  2. Si `isCompositeDesign` es true, la descarga puede ser un paquete ZIP que incluya el modelo principal y archivos RVT vinculados.
  3. Para los archivos publicados el 7 de febrero de 2025 o después, se puede usar GET linked Revit files para obtener los modelos vinculados.
  4. En el flujo de trabajo anterior, la entrada ZIP se indica con `zip: true`, y el nombre del modelo principal dentro del ZIP se especifica mediante `pathInZip`.

Qué aprenderás en esta guía

Analizaremos paso a paso por qué un archivo publicado mediante Revit Cloud Worksharing a veces se descarga como un ZIP en lugar de como un único RVT, y cómo incorporar este diseño a un flujo de trabajo de Automation API. La distinción clave es si el modelo es un diseño compuesto: el paquete puede incluir modelos RVT vinculados además del archivo host. Por eso, al preparar una tarea de automatización no basta con fijarse en la extensión del archivo; también hay que comprobar la información de la versión en la respuesta de la API.

La guía se basa en los campos de API descritos en la documentación de Autodesk Platform Services y en dos flujos de trabajo diferentes. La fecha que marca el cambio entre el método anterior y el nuevo es el 7 de febrero de 2025. El objetivo no es explicar todos los pasos de autenticación y configuración de la aplicación, sino interpretar la información del modelo y elegir el formato de entrada adecuado.

Requisitos

  • Ten acceso al proyecto de Revit Cloud Worksharing y a la API de Autodesk Platform Services para consultar la información de los archivos. El ejemplo de las fuentes examina los datos del proyecto y de las versiones de archivo mediante llamadas a la API.

  • Para trabajar con Automation API, ten en cuenta las condiciones de prueba activa de Forge o de suscripción indicadas en las fuentes. La fuente correspondiente remite a otra página para consultar los detalles de precios; aquí no se especifican precios actuales.

  • Comprueba la fecha de publicación del modelo y los campos attributes.extension y attributes.data de la respuesta de la versión del archivo.

  • No des por hecho que se necesita una instalación de Revit de escritorio para este flujo de trabajo: la descripción de Autodesk de Revit Automation API menciona el acceso a la API de la base de datos de Revit sin instalar Revit de escritorio. Sin embargo, esto no significa que no se necesiten acceso a la API ni las entradas del proyecto requeridas.

Como las fuentes no indican un número de versión concreto de Revit, precios actuales de suscripción ni una configuración de autenticación completa, no se hacen suposiciones sobre estos datos.

Paso a paso: identificar el diseño y preparar la tarea

  1. Confirma que el archivo representa un modelo de Revit Cloud Worksharing. En la respuesta a las llamadas a la API para consultar el contenido del proyecto, el elemento de archivo o las versiones, revisa el campo attributes.extension.type. Si el valor es versions:autodesk.bim360:C4RModel, la fuente indica que se trata de un modelo de Revit Cloud Worksharing. Esta comprobación es el primer paso para interpretar correctamente la información del diseño compuesto.

  2. Consulta la marca de diseño compuesto. Busca el campo attributes.data.isCompositeDesign en la respuesta de la misma versión. Si el valor es true, el modelo se identifica como un diseño compuesto; la descarga puede ser un paquete ZIP que contenga el modelo host y archivos RVT vinculados. Si el valor es false, la fuente indica que se obtiene un único archivo RVT cuando se publican las últimas versiones del host y los archivos vinculados.

  3. Identifica el nombre del modelo principal. En un diseño compuesto, el campo attributes.data.compositeParentFile proporciona el nombre del archivo Revit host. Este valor se utiliza especialmente en el flujo de trabajo anterior, cuando hay que seleccionar el modelo principal dentro del ZIP. Trata el contenido de este campo como un nombre de archivo; no lo sustituyas por una suposición propia.

  4. Evalúa la fecha de publicación según el umbral del 7 de febrero de 2025. La fuente describe el uso del método anterior para los modelos publicados antes de esa fecha y del nuevo para los publicados en esa fecha o después. Toma la decisión a partir del valor attributes.createTime del archivo. Aplicar el mismo formato de entrada a todos los modelos sin comprobar la fecha puede hacer que la entrada real no coincida con la que espera el elemento de trabajo.

  5. Configura la entrada ZIP en el flujo de trabajo anterior. Si el archivo se publicó antes del 7 de febrero de 2025 y contiene un diseño compuesto, establece zip en true en la configuración inputFile del elemento de trabajo. En el campo pathInZip, introduce el nombre del archivo host indicado en compositeParentFile. Así, la tarea recibe el paquete ZIP como entrada y se especifica qué archivo RVT debe procesarse dentro de él. La fuente muestra este método mediante una tarea de exportación DXF de ejemplo; la lógica debe aplicarse según las entradas que espere la actividad seleccionada.

  6. Obtén juntos el host y los archivos vinculados con el nuevo flujo de trabajo. Para los archivos publicados el 7 de febrero de 2025 o después, la llamada GET linked Revit files puede devolver el modelo host y los archivos RVT vinculados que no se hayan publicado. En la respuesta, comprueba el archivo host y los resultados de linkedFiles; revisa los nombres de los modelos, la información de las versiones y el estado de publicación. Después, transfiere a las entradas del elemento de trabajo las URL firmadas que proporciona esta llamada. El ejemplo de la fuente muestra el estado Published para el host y NotPublished para el archivo vinculado; estos estados ayudan a entender que el host y los archivos vinculados pueden no tener el mismo estado de publicación.

  7. Valida la estructura de entrada antes de ejecutar la tarea. El método anterior utiliza el ZIP y el nombre del host dentro del ZIP; el nuevo utiliza las direcciones del host y de los archivos vinculados que devuelve GET linked Revit files. No combines ambos enfoques como si fueran una sola estructura. Comprueba que las entradas esperadas por la actividad del elemento de trabajo coincidan con los archivos obtenidos de la API.

Errores frecuentes

Interpretar una descarga ZIP como señal de que el archivo está dañado puede llevar a conclusiones equivocadas cuando hay modelos vinculados sin publicar. Primero, revisa el campo isCompositeDesign y el nombre del host. Otro error es usar zip: true para todos los archivos sin comprobar el valor de isCompositeDesign; en un modelo no compuesto, este ajuste puede no coincidir con la entrada RVT única esperada.

También hay que tener en cuenta la fecha de publicación. Según la fuente, los archivos anteriores al 7 de febrero de 2025 se procesan con el método anterior, mientras que los publicados en esa fecha o después se gestionan con el enfoque GET linked Revit files. Por último, no sustituyas el valor de compositeParentFile por un nombre de archivo aleatorio ni omitas los archivos vinculados al obtener solo el modelo host con el método nuevo.

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

Esta distinción es importante para los equipos que exportan, revisan o generan informes automáticamente a partir de datos de Revit en la nube. Es posible que no se hayan publicado todos los modelos vinculados de un proyecto al mismo tiempo; por eso, una automatización que espera un único RVT puede trabajar con datos incompletos si no gestiona correctamente las entradas compuestas. Comprobar de antemano la información del modelo ayuda a que la automatización procese el conjunto de archivos adecuado.

Para los estudios de arquitectura y los equipos BIM, los aspectos clave no son el hardware, sino el acceso a la API, las condiciones de suscripción y la configuración correcta de las entradas de archivo. Los equipos de visualización también pueden aprovechar este flujo de trabajo en tareas repetitivas, como exportar o analizar modelos; sin embargo, las fuentes no ofrecen información sobre compatibilidad con software de renderizado específico, tiempos de procesamiento ni costos. Antes de pasar a producción, conviene realizar una prueba de validación con la actividad y la estructura de archivos que se vayan a utilizar.

Próximos pasos

Los recursos para desarrolladores de Revit API de Autodesk incluyen guías de inicio, ejemplos de código y soporte de la comunidad. Primero, valida en la respuesta de la versión del archivo el tipo de modelo, la marca de diseño compuesto y el nombre del host. Después, selecciona el método adecuado según la fecha de publicación y prueba la entrada del elemento de trabajo. Al ampliar el flujo, puedes valorar los casos de uso mencionados en las fuentes, como extraer y modificar datos de Revit, generar informes automáticamente y producir documentación.

Fuentes y licencia

Esta guía se basa en la descripción general de Revit API de Autodesk Platform Services, el anuncio de Automation API y la guía para procesar diseños compuestos de Revit. Las tres fuentes son de acceso abierto (licencia=libre); el contenido se ha adaptado al turco.

Fuentes

3 fuentes
A
aps.autodesk.comaps.autodesk.com/developer/overview/revit
Resumen
A
aps.autodesk.comaps.autodesk.com/blog/design-automation-api-revit-inventor-3ds-max-now-available
Resumen
A
aps.autodesk.comaps.autodesk.com/blog/make-composite-revit-design-work-revit-automation-api
Resumen

No republicamos los textos de las fuentes; las citas breves van marcadas y el resto es resumen y comentario propios.

La opinión de 3dsınıfı
3dValoración del editor

Para los estudios de Turquía, la ventaja más práctica de este enfoque es que permite detectar antes de iniciar la automatización las entradas ZIP inesperadas causadas por el estado de publicación de los modelos vinculados. En especial para los equipos que realizan exportaciones periódicas y análisis de modelos, elegir el formato de entrada correcto puede reducir los reintentos y la necesidad de separar archivos manualmente.

Al decidir una inversión, la prioridad debería ser el acceso a la API, las condiciones de suscripción y la compatibilidad con el flujo de trabajo actual, antes que disponer de hardware potente. Como las fuentes no indican los precios actuales ni los costos de procesamiento, los estudios deben evaluar sus propios casos de uso con una prueba pequeña. Para los estudiantes, también es un ejemplo útil para aprender cómo se incorporan modelos Revit vinculados a la automatización en la nube; aun así, hay que comprobar por separado la compatibilidad con versiones concretas del software.

Preguntas frecuentes

¿Cómo se sabe si un archivo es un diseño compuesto en Revit Automation API?

Comprueba el campo `attributes.data.isCompositeDesign` de la versión del archivo. Si el valor es `true`, el diseño está identificado como compuesto y la descarga puede ser un ZIP con el host y los archivos RVT vinculados.

¿Qué método se utiliza para incorporar modelos Revit vinculados a Automation API?

Para los archivos publicados el 7 de febrero de 2025 o después, la llamada GET linked Revit files puede proporcionar el host y los archivos vinculados. Las URL firmadas de la respuesta se transfieren a las entradas del elemento de trabajo.

¿Se necesita instalar Revit de escritorio para usar Revit Automation API?

Según la descripción de Autodesk de Revit Automation API, se puede acceder a la API de la base de datos de Revit sin instalar Revit de escritorio. Las fuentes también especifican los requisitos de acceso a la API y de suscripción.

Los comentarios y el foro están en turco.Únete al debate
+

Noticias relacionadas