Skip to content

Revit + ACC + Vault Integration Solution

Overview

Move Revit authoring and collaboration to ACC’s Revit Cloud Worksharing while retaining Vault as the authoritative repository for issued deliverables and content. Use MinuteView to automate the end-to-end flow from ACC publish output → Vault ingestion, ensuring metadata, revisioning and lifecycle controls are honoured.

Current State & Drivers

  • The current setup uses Revit Server + Vault. The Revit-Vault integration (commit/archive + content search) works well for content but less so for full project models in multi-firm/distributed team scenarios.
  • Autodesk now advocates RCW on ACC for Revit collaboration.
  • Vault remains the enterprise library for content and downstream documentation.

Goals & Non-Goals

Goals

  • Use ACC for Revit project collaboration and storage.
  • Maintain Vault as the system of record for issued docs (PDFs/DWFs etc).
  • Keep Vault as the central Revit content library (families/templates).
  • Automate the ingestion of published outputs from ACC into Vault using MinuteView.

Non-Goals

  • Storing live workshared RVT models in Vault.
  • Replacing day-to-day authoring workflows in Revit/ACC.

Target Architecture

pgsql
[Revit (RCW)] --Publish--> [ACC Docs: Project/Sheets]
                               |
         APS Webhooks (dm.version.added / modified)
                               v
                    [MinuteView Webhook Endpoint]
                          |   (filter: *.pdf in Sheets)
                          v
               [MinuteView Ingestion & Mapping]
                          |
                Vault API/SDK (metadata + file)
                          v
                [Autodesk Vault (System of Record)]
                       (lifecycle, security, search)

Detailed Data Flows

Revit Authoring & Publish (ACC)

  1. Authors use Revit Cloud Worksharing in ACC.
  2. On milestone or daily cadence, team triggers Publish in Revit → ACC generates the set of 3D view + 2D sheets.
  3. Published sheet-set (PDFs) lands in ACC Docs, in a designated “Published/Sheets” folder.

Event Capture (MinuteView)

  1. MinuteView registers APS Webhooks on ACC project/folder: event types dm.version.added / dm.version.modified.
  2. On a new PDF version added event, MinuteView receives the webhook callback.
  3. MinuteView verifies the asset is fully downloadable (handles translation wait/derivative readiness).

Vault Ingestion (MinuteView)

  1. MinuteView maps ACC metadata to Vault properties: project code, model, sheet number/title, revision, discipline, publish date, etc.
  2. Uploads the PDF to the appropriate Vault folder, sets proper lifecycle state, version increments, and adds links to related records.
  3. Optional: generate Transmittal bundle (ZIP + manifest) and store in Vault.

Revit Content (Families/Templates) Management

  • Vault remains the central content library for Revit families and templates.
  • Use “Revit Interoperability for Vault” to index family parameters and enable parameter-based search inside Revit via the Vault Add-in.
  • Designers insert families from Vault; BIM/CAD managers own the content library lifecycle.

Technical Considerations

  • Ensure Revit Cloud Worksharing subscription eligibility.
  • Publish semantics: default 3D view + all 2D sheets unless configured otherwise.
  • Webhook event handling: build retry/back-off logic to handle translation latency.
  • Desktop Connector: avoid for live workshared models — okay for downstream read-only assets.
  • Vault client version must align with Revit / Vault server compatibility matrix.

Security & Compliance

  • Use least-privilege service account for MinuteView (with necessary Vault and ACC scopes).
  • Secure webhook endpoints (shared secret or HMAC validation) per APS guidance.
  • Encrypt all in-flight and at-rest assets; log and audit ingestion and versioning events.

Risks & Mitigations

RiskMitigation
Event fires before PDF is readyImplement polling/derivative readiness check + retry logic.
Publish folder mis-use leads to ingestion noiseEnforce publishing into designated folder(s); filter ingestion.
Content library becomes inconsistentEnforce content governance, use Vault approval workflows.

Optional Extensions

  • Enable selective 3D view/data export from ACC for downstream manufacturing/coordination, tracked via Vault.
  • Automate Transmittal package creation: ZIP bundle + manifest + Vault record.
  • BI Dashboard: track publish cadence, ingestion latency, content usage metrics.

Why This Approach Works

  • Keeps authors in the modern ACC/Revit Worksharing environment that Autodesk supports.
  • Vault remains your enterprise system of record for content and issued deliverables.
  • MinuteView provides a scalable, event-driven integration glue that avoids manual file transfers.
  • Maintains governance, revisioning, metadata integrity and single-source truth.

Tentech 2024