Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/autodesk-forge/design.automation-.net-library

.NET library for Design Automation: Contains helper methods to perform tasks related to Design Automation. Shows workflows of AWS S3 such as uploading objects to bucket.
https://github.com/autodesk-forge/design.automation-.net-library

autocad csharp design-automation

Last synced: about 2 months ago
JSON representation

.NET library for Design Automation: Contains helper methods to perform tasks related to Design Automation. Shows workflows of AWS S3 such as uploading objects to bucket.

Host: GitHub
URL: https://github.com/autodesk-forge/design.automation-.net-library
Owner: Autodesk-Forge
License: mit
Created: 2014-11-13T05:51:42.000Z (about 10 years ago)
Default Branch: master
Last Pushed: 2023-04-15T23:58:29.000Z (over 1 year ago)
Last Synced: 2024-04-09T21:50:07.161Z (9 months ago)
Topics: autocad, csharp, design-automation
Language: C#
Homepage:
Size: 384 KB
Stars: 12
Watchers: 34
Forks: 12
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        Design Automation .NET Library

========================

(Formely AutoCAD I/O)

[![.net](https://img.shields.io/badge/.net-4.5-green.svg)](http://www.microsoft.com/en-us/download/details.aspx?id=30653)

[![odata](https://img.shields.io/badge/odata-4.0-yellow.svg)](http://www.odata.org/documentation/)

[![Design Automation](https://img.shields.io/badge/Design%20Automation-v2-green.svg)](http://developer.autodesk.com/)

[![visual studio](https://img.shields.io/badge/visual%20studio-2015%2F2017-yellowgreen.svg)](https://www.visualstudio.com/)

[![License](http://img.shields.io/:license-mit-red.svg)](http://opensource.org/licenses/MIT)

## Description

This is an auxiliary library with helper methods to perform tasks related to Design Automation. It packs the workflows of creating activity, submitting workitem, deleting activity, updating activity etc. It also provides the some workflows of AWS S3 such as uploading objects to S3 bucket. Test with other client projects such as 

  * [design.automation-windows-services-sample](https://github.com/Autodesk-Forge/design.automation-windows-services-sample)

  * [design.automation-workflow-winform-sample](https://github.com/Autodesk-Forge/design.automation-workflow-winform-sample)

## Thumbnail

![thumbnail](/thumbnail.png) 

## Setup

### Dependencies 

* Download and install [Visual Studio](https://visualstudio.microsoft.com/downloads/). In the latest test, Visual Studio version is 2017. 

* If testing with AWS S3, ensure you have already [AWS account and S3 storage](https://aws.amazon.com/s3/). 

### Prerequisites

1. **Forge Account**: Learn how to create a Forge Account, activate subscription and create an app at [this tutorial](http://learnforge.autodesk.io/#/account/). Make sure to select the service **Design Automation**.

2. Make a note with the credentials (client id and client secret) of the app. 

## Running locally  

* Open the project. Restore the packages of the project by [NuGet](https://www.nuget.org/). The simplest way is

  * VS2012: Projects tab >> Enable NuGet Package Restore. Then right click the project>>"Manage NuGet Packages for Solution" >> "Restore" (top right of dialog)

  * VS2013/VS2015/2017:  right click the project>>"Manage NuGet Packages for Solution" >> "Restore" (top right of dialog)

* Add other missing references

* Build the library project to generate the dll.

* Test with other client projects such as 

  * [design.automation-windows-services-sample](https://github.com/Autodesk-Forge/design.automation-windows-services-sample)

  * [design.automation-workflow-winform-sample](https://github.com/Autodesk-Forge/design.automation-workflow-winform-sample)

  

## Troubleshooting

* be sure to connect to the endpoint which is the same region of your S3 bucket!  line 168 of [GeneralUtilities.cs](./AutoCADIOUtil/GeneralUtilities.cs)

  ![thumbnail](./help/AWS-region.png) 

## Further Reading 

* [Design Automation API help](https://forge.autodesk.com/en/docs/design-automation/v2/developers_guide/overview/)

* [ Intro to Design Automation API Video](https://www.youtube.com/watch?v=GWsJM344CJE&t=107s)

* [Working with Amazon S3 Buckets](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html)  

 

## Known Issues

* as of writing, Design Automation of Forge is released with version 2. Odata is used with .NET project. In futher version, OData might not be used. 

## License

These samples are licensed under the terms of the [MIT License](http://opensource.org/licenses/MIT). Please see the [LICENSE](LICENSE) file for full details.

## Written by 

Jonathan Miao & Albert Szilvasy