design.automation-csharp-inventor2revit

Description

This sample monitors a BIM 360 Folder for version.added event, when a new IPT file (or version) is uploaded, it triggers Design Automation for Inventor to convert it to .SAT file. Then triggers Design Automation for Revit to import this SAT file into a new Revit Family RFA (using a predefined Revit Family Template, RFT). Then opens a Revit RVT file (on the same folder where the IPT was uploaded) and updade the family. The resulting Revit file is uploaded back to BIM 360 as a new version.

This sample is based on this Webhook sample. Learn more about Webhooks and 3-legged Refresh & Access Token at this blog post. Also based on the Learn Forge Tutorial.

Thumbnail

Demonstration

Whatch the recording at Youtube.

Live version

Try it at inventor2revit.herokuapp.com, use the Table_Chair.rvt and both Chair_Orientation.ipt (with and without headrest) sample files at this folder

Setup

Prerequisites

Forge Account: Learn how to create a Forge Account, activate subscription and create an app at this tutorial.
Visual Studio: Either Community (Windows) or Code (Windows, MacOS).
.NET Core basic knowledge with C#
ngrok: Routing tool, download here
MongoDB: noSQL database, learn more. Or use a online version via MongoDB Atlas (this is used on this sample)
AWS Account: S3 buckets are used to store temporary files
Inventor 2019: required to compile changes into the plugin
Revit 2019: required to compile changes into the plugin

Running locally

Clone this project or download it. It's recommended to install GitHub desktop. To clone it via command line, use the following (Terminal on MacOSX/Linux, Git Shell on Windows):

git clone https://github.com/autodesk-forge/design.automation-csharp-inventor2revit

Visual Studio (Windows):

Right-click on the project, then go to Debug. Adjust the settings as shown below.

Visual Sutdio Code (Windows, MacOS):

Open the folder, at the bottom-right, select Yes and Restore. This restores the packages (e.g. Autodesk.Forge) and creates the launch.json file. See Tips & Tricks for .NET Core on MacOS.

Important: For Visual Code (Windows or MacOS) open only the /web/ folder. This IDE doesn't recognize the Inventor & Revit plugins, so opening the entire solution may fail.

MongoDB

MongoDB is a no-SQL database based on "documents", which stores JSON-like data. For testing purpouses, you can either use local or live. For cloud environment, try MongoDB Atlas or Compose MongoDB. With MongoDB Atlas you can set up an account for free and create clustered instances.

There are several tools to view your database, Robo 3T (formerly Robomongo) is a free lightweight GUI that can be used. When it opens, follow instructions here to connect to MongoDB Atlas.

AWS Account

Create an AWS Account, allow API Access, the access key and secret key will be used on this sample.

ngrok

Run ngrok http 3000 -host-header="localhost:3000" to create a tunnel to your local machine, then copy the address into the FORGE_WEBHOOK_URL environment variable.

Environment variables

At the .vscode\launch.json, find the env vars and add your Forge Client ID, Secret and callback URL. Also define the ASPNETCORE_URLS variable. The end result should be as shown below:

"env": {
    "ASPNETCORE_ENVIRONMENT": "Development",
    "ASPNETCORE_URLS" : "http://localhost:3000",
    "FORGE_CLIENT_ID": "your id here",
    "FORGE_CLIENT_SECRET": "your secret here",
    "FORGE_CALLBACK_URL": "http://localhost:3000/api/forge/callback/oauth",
    "OAUTH_DATABASE": "mongodb+srv://<username>:<password>@cluster0-u9dtd.mongodb.net/test?retryWrites=true",
    "FORGE_WEBHOOK_URL": "your ngrok address here: e.g. http://abcd1234.ngrok.io",
    "AWS_ACCESS_KEY": "your AWS access key here",
    "AWS_SECRET_KEY": "your AWS secret key here"
},

Before running the sample, it's recomended to already upload a RVT project and a IPT file into a BIM 360 Folder. See /samplefiles folder.

A compiled version of the Inventor and Revit plugins (.bundles) are included on the web module. Any changes on these plugins will require to create a new .bundle as a .zip file, the Post-build event should create them. These file names are hardcoded.

Before start, upload the Table_Chair.rvt and Chair_Orientation.ipt to a BIM 360 folder.

Start the app from Visual Studio (or Visual Code). Open http://localhost:3000 to start the app, select a folder to start monitoring. Upload a new version of the IPT (Chair with headrest/Chair_Orientation.ipt, same name, but with headrest) file and the process should start. You can monitor the Jobs via Hangfire dashboard: http://localhost:3000/hangfire.

Deployment

To deploy this application to Heroku, the Callback URL for Forge must use your .herokuapp.com address. After clicking on the button below, at the Heroku Create New App page, set your Client ID, Secret and Callback URL for Forge.

dukedhx / design.automation-csharp-inventor2revit Goto Github PK