Technology Perspective from Japan

Design Automation API for Revit - Learn Autodesk Forge チュートリアル .NET Core Sample のセットアップ

これまで、Postman Sample で Design Automation API の利用手順をご紹介いたしました。

• Design Automation API for Revit - Postman Sample のセットアップ
• Design Automation API for Revit - Postman Sample で動作確認 1
• Design Automation API for Revit - Postman Sample で動作確認 2

今回から、Forge Platform API を包括的に習得いただけるチュートリアル Learn Autodesk Forge（英語）の Design Automation API のセクション、Modify your models セクションについて、ご紹介いたします。

Modify your models セクションでは、.NET Core を利用して Forge アプリを開発する手順と、 AutoCAD、Inventor、Revit、3ds Max のアドインの対応方法がそれぞれ解説されております。

このセクションでは、Revit プロジェクトの窓ファミリタイプの幅と高さを変更して、OSS の Bucket に保存する learn.forge.designautomation サンプルが GitHub で公開されております。

今回は、このサンプルをローカル環境でテストするための環境構築の手順をご案内いたします。

以前のブログ記事（Forge の開発環境）では、Node.js をベースとした開発環境のセットアップ手順についてご案内しておりますが、今回のサンプルは .NET Core をベースとするため、Visual Studio を利用します。
一部、重複している点もございますので、既にインストールされているツールがある場合は、スキップしてください。

また、Design Automation API for Revit は、現時点（2019年3月）ではパブリックベータ版ですので、SDK もプレリリース版を使用します。今後、内容が変更される可能性があることを予めご了承ください。

 

1. Visual Studio 2017

下記の URL から Visual Studio 2017 Community（無償） または、Visual Studio 2017 Professional（有償） のインストーラをダウンロードしてください。

• https://visualstudio.microsoft.com/ja/downloads/

インストーラを実行すると、Visual Studio 2017 にインストールできるワークロードの選択ウィンドウが表示されます。
この[ワークロード]タブの一覧から、「.NET デスクトップ開発」と「ASP.NET と Web 開発」の２つを選択してください。

次に、ポップアップウィンドウ上部の[個別のコンポーネント]タブをクリックします。
Revit 2019 API を利用するためには、Microsoft .NET Framework 4.7（もしくは 4.7.1） が必要です。

個別のコンポーネントの一覧から、.NET Framework 4.7 もしくは 4.7.1 に該当する下記のコンポーネントの項目のチェックボックスをクリックして追加します。

既に Visual Studio 2017 がインストールされている場合は、下記の URL に記載されている方法で、ワークロードと個別のコンポーネントを追加でインストールすることができます。

• https://docs.microsoft.com/ja-jp/visualstudio/install/modify-visual-studio?view=vs-2017

インストールが完了したら、Visual Studio 2017 を起動し、[ファイル]->[新規作成]->[プロジェクト]を選択して[新しいプロジェクト]のテンプレート選択ウィザードを表示し、下記のテンプレートが一覧にあるかご確認ください。

• [Visual C#]->[Windows デスクトップ]->[クラス ライブラリ（.NET Framework）]
  
  • Revit 2019 アドインを作成して、編集、ビルド、デバッグを実行するために使用するテンプレートです。
    
    
• [Visual C#]->[.NET Core]->[ASP.NET Core Webアプリケーション]
  
  • Design Automation API を利用する Forge アプリを作成するために使用するテンプレートです。

 

2. Revit 2019

Revit 2019 アドインを編集、ビルド、デバッグし、Revit プロジェクトを閲覧するためには、Revit 2019 が必要です。
下記のアドレスから、Revit 2019 をインストールしてください。

• https://www.autodesk.co.jp/products/revit/free-trial

インストールが完了したら、下記のディレクトリに RevitAPI.dll が保存されていることを確認してください。

• C:\Program Files\Autodesk\Revit 2019\RevitAPI.dll

 

3. 7zip のインストール

7zip は、オープンソースの高圧縮率のファイルアーカイバ（圧縮・展開/圧縮・解凍ソフト）です。Revit アドインのバンドルパッケージを Visual Studio のビルドイベントで自動で ZIP 圧縮して作成する際に 7zip を利用します。

下記のいずれかのアドレスから、7zip をダウンロードし、インストールしてください。

• https://www.7-zip.org/
• https://sevenzip.osdn.jp/（日本語サイト）

インストールが完了したら、下記のディレクトリに実行ファイルがあることを確認してください。

• C:\Program Files\7-Zip\7z.exe

 

4. ngrok ツールの入手

ngrok は、ローカル Webサーバーをインターネットに公開することができるツールです。

ローカルマシンで起動している Webサーバーを、ngrok ツールを実行して、任意のポート番号を指定して、インターネット上に一時的に公開することができます。その際、一時的にグローバルの IP アドレスが割り当てられます。

下記のアドレスから、ngrok をダウンロードします。Windows 64bit の場合は、「ngrok-stable-windows-amd64.zip」がダウンロードできます。このファイルを解凍して、任意のディレクトリに配置します。

• https://ngrok.com/download

5. Google Chrome

Design Automation API で処理した Revit プロジェクトを Forge Viewer で表示するためには、HTML5、CSS3、WebGL をサポートする Webブラウザが必要です。下記の Webブラウザがサポート対象ですが、Google Chrome を推奨いたします。

• Chrome 50+
• Firefox 45+
• Opera 37+
• Safari 9+
• Microsoft Edge 20+
• Internet Explorer 11

下記のアドレスから、Google Chrome をダウンロードし、インストールしてください。

• https://www.google.co.jp/chrome/

Windows 版Windows 版（10 / 8.1 / 8 / 7、64 ビット）の同意画面で [同意してインストール] ボタンで同意後、セットアップ プログラムである ChromeSetup.exe を任意の場所にダウンロードします。

ダウンロードした ChromeSetup.exeをダブルクリックすると、インストールに必要なモジュールのダウンロードが始まり、インストールが自動的に実行されます。

インストールが完了したら、下記のディレクトリに実行ファイルがあることを確認してください。

• C:\Program Files (x86)\Google\Chrome\Application\chrome.exe

 

6. Git for Windows のインストール

GitHub 上のサンプル プログラムを入手して利用する際にコマンド プロンプト(bash) で git コマンドを利用して、クライアント コンピュータに GitHub リポジトリの内容をクローンして利用します。今回は、git for Windows を使用することとします。

下記のアドレスから、git for Windows をダウンロードし、インストールしてください。

• https://gitforwindows.org/

インストーラを実行すると、git for Windows のインストールを開始します。[Information] 画面が表示されたら [Next >] ボタンをクリックします。

後続する複数の画面では、全項目を既定値のまま [Next >] ボタンをクリックしていきます。

[Configuring the terminal emulator to use with Git Bash] 画面が表示されたら、[Use Windows' default console window] を選択して、[Next] ボタンをクリックします。

[Configuring extra options] 画面が表示されたら、そのまま [Install] ボタンをクリックします。

インストールが終了したら、コマンド プロンプトを起動して git コマンドが有効なことを確認してください。git --version と入力して git version 2.21.0.windows.1 と表示されれば正常です。

以上で learn.forge.designautomation サンプル の環境セットアップは完了です。

次回は、サンプルのソースコードを入手して、ローカル環境で実行する手順をご紹介します。

By Ryuji Ogasawara

Design Automation API for Revit - Postman Sample で動作確認 2

前回のブログ記事に引き続き、Postman で SketchIt サンプルの動作を確認する手順をご紹介します。
既に AppBundle と Activity の登録が完了している状態ですので、今回は、実際のジョブとなる WorkItem を作成して、処理結果を取得するところまでを解説いたします。

9. WorkItem の作成

Postman コレクションの [SketchItApi]->[WorkItem]フォルダ配下にある[Send Workitem]リクエストを選択します。

エンドポイントは、https://developer.api.autodesk.com/da/us-east/v3/workitems、メソッドは POST となります。

Body タブでは、JSON 形式で、WorkItem のパラメータを送信します。

"activityId": Activity ID の指定
"arguments": Activity で定義した入出力のパラメータに対応する実際の値

"sketchItInput"プロパティの"url"には、JSON 形式の座標データを、"result"プロパティの"url"には、処理結果を出力するクラウドストレージの URL を設定します。

ここでは、環境変数"sketchItResultUrl"を参照するように設定されていますが、これまでのステップでは、この URL はまだ取得しておりません。

そのため、WorkItem 作成のリクエストは、この段階では完了することはできません。

実は、WorkItem で設定するファイル（Revit プロジェクトやテキストファイル）のクラウドストレージの URLは、事前に取得しなければなりません。
そして、この URL のことを、署名付き URL （Signed URL）といいます。

Forge の Data Management API では、この署名付き URL（Signed URL）を取得する方法がサポートされています。

以降、Forge の Data Management API を利用して、署名付き URL（Signed URL）を取得する手順を説明いたします。

10. Authentiocan API によるアクセス トークンの取得

前回、Design Automation API を利用するために、2-legged 認証で、scope をコードの生成と実行の権限に相当する、"code:all" に指定してアクセス トークンを取得しました。

Data Management API を利用するためには、前回とは異なるリソースへのアクセス権限が必要になります。

"bucket:read bucket:update bucket:create bucket:delete data:write data:create data:read"

Postman コレクションの[DataAPI]->[Authentication]フォルダ配下にある [New token]リクエストを選択します。
すると、[New token]リクエストの画面がメイン画面に表示されます。

Body タブをアクティブにすると、scope パラメータに上記のスコープの値が設定されていることが確認できます。

Send ボタンをクリックすると、リクエストが送信され、レスポンスには、アクセス トークンとその有効期限が返却されます。
取得されたアクセス トークンは、環境変数に新たに dataApiToken パラメータとして追加されます。

以降の Data Management API のリクエストには、この環境変数のパラメータを通じて、アクセス トークンが設定されます。

11. Bucket の作成

Postman サンプルでは、処理結果の出力先に、OSS（ Object Storage Service） の Bucket を利用します。
Bucket に関する解説は、下記のブログ記事をご参照ください。

• Forge が使用するクラウド ストレージ
  
• Bucket に関してのサマリー
  
  

Postman コレクションの[DataAPI]->[Bucket]フォルダ配下にある [Create Bucket]リクエストを選択します。

エンドポイントは、https://developer.api.autodesk.com/oss/v2/buckets、メソッドは POST となります。

Body タブをアクティブにすると、bucketKey パラメータに環境変数"bucketKey"が設定されることがわかります。
policyKey パラメータには、24時間有効な "transient"が設定されています。

※環境変数"bucketKey"は、アクセストークン取得時のスクリプト処理（[Tests]タブに記載されているスクリプト）で、自動的に環境変数"dasNickName"を小文字変換した文字列が設定されます。別の名前で Bucket を作成したい場合は、この値を変更してください。

リクエストを送信すると、レスポンスには、200 OK と Bucket の情報が返却されます。

12. 処理結果を出力する Revit プロジェクトファイルの保存場所を確保する

Bucket が作成できたら、次はファイルを保存するための場所を確保する必要があります。

エンドポイントは、https://developer.api.autodesk.com/oss/v2/buckets/:bucketKey/objects/:objectName、メソッドは PUT となります。

このエンドポイントは、ファイルのデータを送信することで、直接ファイルをアップロードすることもできますが、この段階では、Revit ファイルはまだ作成されていないため、データは送信しません。

そのため、ここでは SketchIt.rvt というファイルの保存場所を確保します。

レスポンスには、200 OK と確保したファイルの保存場所の情報が返却されます。

13. 書き込みアクセス権のある署名付き URL （Signed URL）の取得

確保したファイルの保存場所から、書き込みアクセス権のある署名付きURLを取得します。

エンドポイントは、https://developer.api.autodesk.com/oss/v2/buckets/:bucketKey/objects/:objectKey/signed で、メソッドは POST です。

このエンドポイントは、指定された有効期限内にオブジェクトをダウンロード・アップロードするために使用できる署名付きURLを作成します。
署名付きURLが指すオブジェクトが削除されるか、または署名付きURLが期限切れになる前に期限切れになると、署名付きURLは無効になります。

URLが最初に１度だけ使用された後に期限切れになるようにURLを設定したり、URLへの読み取りまたは書き込みアクセス権を設定することもできます。

アクセス権は、URL クエリパラメータとして、以下 のいずれかを指定して設定できます。

• access=read
• access=write
• access=readwrite

したがって、今回は、確保したファイルの保存場所に Revit プロジェクトファイルを保存するため、access=write を設定します。

レスポンスには、200 OK と併せて、署名付き URL （Signed URL）が返却されます。

※AWS S3 でも類似の事前署名付き URL （Pre-signed URL）がサポートされております。詳細はこちらの記事（署名付き URL を使用したオブジェクトのアップロード）をご参照ください。

14. WorkItem の作成

ステップ 10 ～ 13 で、処理結果を出力するための署名付き URL （Signed URL）を取得することができました。
これでようやく、ステップ 9 WorkItem の作成に戻って、リクエストを送信することができます。

既に環境変数"sketchItResultUrl" には、事前署名付き URL （Pre-signed URL）が設定されています。

もう一度、Postman コレクションの [SketchItApi]->[WorkItem]フォルダ配下にある[Send Workitem]リクエストを選択し、Send ボタンをクリックして、リクエストを実行します。

レスポンスには、200 OK と合わせて、WorkItem の処理の進捗状況を表す status と、WorkItem の ID が返却されます。

15. WorkItem 進捗状況の確認

WorkItem ID を通じて、処理の進捗状況とログを確認することができます。

エンドポイントは、https://developer.api.autodesk.com/da/us-east/v3/workitems/:id で、メソッドは GET です。

status の値は、下記のいずれかが返されます。
処理に失敗した場合は failedInstructions、成功した場合は success となります。

• pendinginprogress
• cancelled
• failedDownload
• failedInstructions
• failedUpload
• failedLimitProcessingTime
• failedLimitDataSize
• success

reportUrl の値は、ログファイルの URL です。ブラウザからアクセスして、report.txt というファイルをダウンロードすることができます。

16. 処理結果のダウンロード

最後に Data Management API を利用して処理結果をダウンロードします。

エンドポイントは、https://developer.api.autodesk.com/oss/v2/buckets/:bucketKey/objects/:objectName、メソッドは GET です。

リクエストを送信後、レスポンスの右上にある Download ボタンをクリックすると、SketchIt.rvt を取得できます。
Revit 2018 で開いて確認してみましょう。

Postman サンプルでの動作確認は終わりです。
ご興味のある方は、他の2つのサンプルもお試しください。

次回は、Learn Autodesk Forge チュートリアルのサンプルを動作確認するためのセットアップ手順をご紹介します。

By Ryuji Ogasawara

Design Automation API for Revit - Postman Sample で動作確認 1

前回のブログ記事では、Design Automation API for Revit について、Postman サンプルで動作を確認するためのテスト環境のセットアップ手順をご紹介しました。

今回は、実際に Postman サンプルで動作を確認してみましょう。
Postman サンプルには、以下の３つのサンプルが同梱されていますが、今回は、SketchIt サンプルを使用します。

CountIt サンプル
Revit プロジェクトと Revit リンクに配置されている壁、床、ドア、窓カテゴリの数量を集計し、その結果をテキストファイルで出力します。
どのカテゴリを集計するかをプロパティで指定することができます。

SketchIt サンプル
新規の Revit プロジェクト上に壁と床を作成するサンプルです。結果は、Revit プロジェクトファイルとして出力します。
プロパティで作成する壁や床の座標を指定します。

DeleteWalls サンプル
既存の Revit プロジェクト上に配置されている壁を全て削除して、別の Revit プロジェクトとして出力します。

1. 環境変数の確認と Revit アドインのバンドルパッケージの準備

前回の手順で、環境変数を設定いただきましたが、もう一度、環境変数が設定されているか確認しましょう。
Forge アプリの Client ID と Client Secret、そして Nickname をそれぞれ設定します。

※ニックネームはグローバルで一意でなければなりません。他のユーザーに既に使用されている場合は、そのニックネームを使用することはできません。

同様に、Revit アドインのバンドルパッケージをローカルにダウンロードしておきます。

• SketchItApp.zip
  
  

2. Authentiocan API によるアクセス トークンの取得

まず、Design Automation API を利用するために、Authentication API の 2-legged 認証によって、Access Token（アクセス トークン） を取得します。

エンドポイントは、https://developer.api.autodesk.com/authentication/v1/authenticate、メソッドは POST となります。

2-legged 認証のワークフローについては、こちらのブログ記事（Forge での OAuth 認証シナリオ）をご参照ください。

Postman コレクションの[Authentication]フォルダ配下にある [New token]リクエストを選択します。
すると、[New token]リクエストの画面がメイン画面に表示されます。

Headers タブをアクティブにすると、Content-Type パラメータに "application/x-www-form-urlencoded" という値が予め設定されております。

Body タブをアクティブにすると、client_id、client_secret、grant_type、scope の各パラメータが確認できます。

この API のエンドポイントに POST リクエストを送信する際、Client ID と Client Secret は、Postman の環境変数に設定されている値が自動的に入力されるよう参照が設定されております。

そして、grant_type と scope というパラメータにも予め値が設定されています。

• grant_type は、サーバー間の認証の場合、client_credentials を指定します。
• scope は、Design Automation API の場合、コードの生成と実行の権限に相当する、code:all を指定します。

Access Token と Scope に関する解説は、こちらのブログ記事（Access Token について）をご参照ください。

Send ボタンをクリックすると、リクエストが送信され、レスポンスには、アクセス トークンとその有効期限が返却されます。

取得されたアクセス トークンは、環境変数に新たに dasApiToken パラメータとして追加されます。以降の Design Automaion API のリクエストには、この環境変数のパラメータを通じて、アクセス トークンが設定されます。

 

3. Nickname の作成

Postman コレクションの [Nickname]フォルダ配下にある[Create nickname]リクエストを選択します。

エンドポイントは、https://developer.api.autodesk.com/da/us-east/v3/forgeapps/me、メソッドは PATCH となります。

Headers タブをアクティブにすると、Content-Type パラメータに "application/json" という値が予め設定されております。また、Authorization パラメータには、"Bearer {{dasApiToken}}" として環境変数 "dasApiToken"を参照するよう設定されています。マウスカーソルを変数の上に移動すると、設定される実際の値がツールチップで表示されます。

Body タブをアクティブにすると、nickname パラメータの値に、環境変数"dasNickName"を参照するように設定されているのが確認できます。
レスポンスには、Status 200 OK が返却されます。

Nickname が作成できたら、環境変数"dasNickName"の CurrentValue にも同じ値をセットします。

 

4. AppBundle の登録

Postman コレクションの [SketchItApi]->[App]->[Create]フォルダ配下にある[Create app]リクエストを選択します。

エンドポイントは、https://developer.api.autodesk.com/da/us-east/v3/appbundles、メソッドは POST となります。

Body タブでは、リクエストパラメータに、AppBundle の id、使用する engine、description を設定します。
それぞれの値は予め設定されています。
エンジンは、Revit アドインを実行する際に使用する Revit のバージョンを指定します。
現状の Design Automation API for Revit では、Revit 2018 と Revit 2019 に対応しています。

レスポンスには、リクエストで送信したパラメータに加えて、AppBundle のバージョンと、Revit アドインのバンドルパッケージをアップロードするためのクラウドストレージの URL とそれに必要なパラメータが返却されます。
初めて AppBundle を作成した場合、初回はバージョン 1 が自動的に付与されます。

 

5. Revit アドインのバンドルパッケージのアップロード

Postman コレクションの [SketchItApi]->[App]->[Create]フォルダ配下にある[Upload app to Design Automation]リクエストを選択します。

エンドポイントは、AppBundle 登録時に返されたアップロード URLで、メソッドは POST となります。

Body タブでは、リクエストパラメータに、AppBundle 登録時のレスポンスで取得したパラメータがそれぞれ設定されています。
file パラメータの値フィールドにある Select Files ボタンをクリックして、アップロードする Revit アドインのバンドルパッケージを選択します。

レスポンスには、Status 200 OK が返却されます。

 

6. AppBundle の Alias の登録

Postman コレクションの [SketchItApi]->[App]->[Create]フォルダ配下にある[Create a new app alias]リクエストを選択します。

エンドポイントは、https://developer.api.autodesk.com/da/us-east/v3/appbundles/SketchItApp/aliases、メソッドは POST となります。

Body タブでは、AppBundle のバージョンを指定して、そのバージョンに対するエイリアスを設定します。ここでは、"test"という Alias を登録します。

レスポンスには、Status 200 OK で設定した値が返却されます。

 

7. Activity の登録

エンドポイントは、https://developer.api.autodesk.com/da/us-east/v3/activities、メソッドは POST となります。

Body タブでは、JSON 形式で、Activity の定義を送信します。

"id": Activity を識別するための ID
"commandLine": 実行するエンジンのパスと引数
"parameters": 入出力のファイルに関する詳細な定義
"engine": アプリケーションのエンジンとバージョン（Autodesk.ApplicationName+Version）
"appbundles": AppBundle の指定（Nickname.AppBundleId.AliasId）
"description": 説明

"parameters"の"sketchItInput"プロパティは、入力ファイルの定義です。
Design Automation API 側からみたときに、処理を実行するために取得する必要があることから、"verb"の値は、"get"を指定します。
SketchIt サンプルは、新規に Revit プロジェクト上に壁と床を作成するため、予め入力として Revit プロジェクトは必要ありません。

ただし、作成する壁や床の座標データを送る必要があります。
この座標データは、JSON 形式の文字列で WorkItem のリクエストパラメータで送信します。そして、送信された座標データは、JSON ファイルとして作業領域（ワーキングディレクトリ）に一時的に保存され、Revit アドインのプログラムから JSON ファイルを開いてデータにアクセスすることができます。

Revit プロジェクトを入力として送信した場合も同様に、作業領域（ワーキングディレクトリ）に一時的に保存され、WorkItem の処理が終了したら、自動的に作業領域は削除されます。

"parameters"の"result"プロパティは、出力ファイルの定義です。
出力結果を任意のクラウドストレージにアップロードすることから、"verb"の値は、"put"を指定します。

レスポンスには、Status 200 OK で設定した値が返却されます。

 

8. Activity の Alias の登録

AppBundle の Alias の登録と同様に、Activity にも Alias を登録します。ここでは、AppBundle の Alias と同じ "test" が設定されていますが、別の名称でも問題ありません。

レスポンスには、Status 200 OK で設定した値が返却されます。

これで、Design Automation API の Nickname、AppBundle と Activity の登録ができました。

次回は、WorkItem の作成、処理結果を出力するためのクラウドストレージの URL の取得、WorkItem の進捗確認と処理結果のダウンロードまでの動作を確認します。

By Ryuji Ogasawara

Forge 1 Day Workshop - Design Automation API for Revit - 開催 - 2019月4月

来る 4月2日（火）東京、4月5日（金） 大阪にて、Design Automation API を利用して Revit アドインを Forge のクラウド上で実行する方法を把握していただくワークショップを開催いたします。

Design Automation API を利用すれば、Revit がデスクトップの環境になくても、クラウド上で Revit API を使用したカスタム処理を実行して、 Revit のモデルを作成・編集したり、データを抽出したりすることができます。

このワークショップでは、2-legged OAuth を利用して独自に作成した Bucket に Revit プロジェクトをアップロードし、Design Automation API で Revit アドインを実行してパラメータを編集・保存し、ダウンロードする手順をご案内いたします。

これまでに開催された Forge 1 Day Workshop（2-legged OAuth）へのご参加経験があれば、より理解が深まります。

当日は、実際に開発作業が可能なノートPCをお持込みいただき、開発に必要な手順を説明して環境を設定していただいた後に、すでに弊社ブログや GitHub に記載されている手順に沿って、実際にハンズオンで手順をトレースしていただきます。下記に参加要領とお申し込み方法を記載いたしますので、参加をご検討いただけますと幸いです。

なお、応募は定員になり次第締め切らせていただきますので、予めご了承ください。

日時/場所：

東京 4月2日（火） 10:00～17:00

オートデスク 東京本社 セミナールーム （定員 10 名）>> 定員になりましたのでお申込み受付を終了しました。お急ぎの方は大変恐れ入りますが、大阪会場への参加、または次回開催への参加をご検討ください。
東京都中央区晴海 1－8－10 トリトンスクウェアオフィスタワーX 24F

大阪 4月5日（金） 10:00～17:00

オートデスク 大阪営業所 セミナールーム （定員 10 名）
大阪府大阪市淀川区宮原3-5-36 新大阪トラストタワー 3F

参加費：

無料

内容：

• Web 開発の理解
• Web 開発の用語と基礎知識
• Design Automation API の仕組み
• Postman サンプルによる Design Automation API の理解
• Revit アドインとバンドルパッケージの作成（Revit 2019 API - .NET C#）
• Forge SDK を利用した Forge Platform API の利用（ASP.NET Core）
  • Authentication API
  • Data Management API
  • Design Automation API

申込方法：

以下の情報をメールでお知らせください。

宛 先： adn@myautodesk.jp （ADN 事務局）
件 名： 「Forge - 1 Day Workshop Design Automation 編 参加申し込み」
本 文： 参加人数を把握するため、ご参加の会場名も含め、次の順序でご記入ください

会場：東京・大阪（いずれを明記）

ADN ID（ADN に加入されている場合のみ）：

会社名：

部署：

役職：

参加者氏名とフリガナ：

E-mail アドレス：

電話番号：

• お申込み後、訪問者記入用紙 兼 受講票をメールでお渡ししますので、必要項目にご記入の上、当日プリントアウトしてお持ちください。 内容、時間等は、変更になる場合がございます。

事前にご準備いただく開発環境：

• Forgeのデベロッパキー（Consumer Secret と Consumer Key）の取得が必要です。また、アクセスキーの取得には、Autodesk ID が必要となります。Autodesk ID、アクセスキーをお持ちでない場合には、次のブログ記事に沿って それらを事前に取得しておくことをお勧めいたします。
  http://adndevblog.typepad.com/technology_perspective/2016/07/app-registration-and-getting-keys-for-forge-api.html

• Postman サンプルを実行するために、事前に次の URL から Postman をインストールしてください。
  https://learning.getpostman.com/docs/postman/launching_postman/installation_and_updates/

• 事前に次の URL から Visual Studio 2017 Community（無償） または、Visual Studio 2017 Professional（有償） を Windows 環境にインストールしてください。
  https://visualstudio.microsoft.com/ja/downloads/
  
  ※インストーラのワークロードの選択画面で、「.NET デスクトップ開発」と「ASP.NET と Web 開発」の２つを選択してください。既に Visual Studio 2017 がインストールされている場合は、下記の URL に記載されている方法で、ワークロードを追加でインストールすることができます。
  https://docs.microsoft.com/ja-jp/visualstudio/install/modify-visual-studio?view=vs-2017
  
  ※インストールが完了したら、Visual Studio 2017 を起動し、[ファイル]->[新規作成]->[プロジェクト]を選択して[新しいプロジェクト]のテンプレート選択ウィザードを表示し、下記のテンプレートが一覧にあるかご確認ください。
  
  • [Visual C#]->[Windows デスクトップ]->[クラス ライブラリ（.NET Framework）]
  • [Visual C#]->[.NET Core]->[ASP.NET Core Webアプリケーション]

• Revit 2019 アドインの編集、ビルド、デバッグには、Microsoft .NET Framework 4.7（4.7.1も可） が必要です。また、Forge の開発環境には、.NET Core SDK（2.1 または 2.2）を利用いたします。下記の URL からそれぞれ該当するパッケージをダウンロードして、インストールしてください。
  https://dotnet.microsoft.com/download/visual-studio-sdks
  
  ※インストールが完了したら、「コントロール パネル\すべてのコントロール パネル項目\プログラムと機能」に該当するパッケージがインストールされているかご確認ください。
  
  • Microsoft .NET Core SDK 2.1.xxx または 2.2xxx
  • Microsoft .NET Framework 4.7 SDK または 4.7.1 SDK

• Revit アドインのバンドルパッケージを作成するにあたり、7zip を事前にインストールしてください。
  https://www.7-zip.org/

• IIS は有効化する必要ございません。今回は、Visual Studio 2017 のデバッグ環境でサーバーを起動します。

• Revit プロジェクトを閲覧するために、事前に Revit 2019 をインストールしてください。
  https://www.autodesk.co.jp/products/revit/free-trial

• 仮想環境に上記の開発環境をご準備いただく場合は、WiFi 接続が問題なく動作するよう事前にドライバを調整してください。

補足事項：

• 日本語プレゼンテーションで説明を加えながら、Postman サンプルと Learn Autodesk Forge のチュートリアル（英語）を活用していきます。

  https://forge.autodesk.com/en/docs/design-automation/v3/developers_guide/postman/
  http://learnforge.autodesk.io/#/?id=learn-autodesk-forge

   

• 当日は、ゲストWiFiの利用方法をご案内いたします。お持込いただく PC には、WiFi 接続機能があることをご確認ください。

• ノートPC のお貸し出しはしておりません。

ぜひ、この機会をご活用ください。

By Ryuji Ogasawara

Developer Days 2019 サマリー（一部公開）

ADN（Autodesk Developer Network）にご加入い ただいている方を対象に、2019年3月1日にオートデスク・東京オフィスで開催した Developer Days 2019（通称 DevDays 2019）の一部資料を、公開可能な Forge 関連から公開します。本資料は、英語で開催している Webinar 形式の DevDays Online 同様、イベント内でご案内した当該バージョン製品の出荷後、順次、一般向けにも公開する予定です。 

アジェンダ：

13:00～13:10 ADN からのお知らせ（非公開）

- ADN メンバーの方は、メンバー専用サイト ADN Extranet の日本語リソースからプレゼン資料を入手いただけます。

ADN プログラムで利用可能な ADN Extranetと提供する製品ライセンス等について改めてご案内します。

13:10～13:40 Desktop and Cloud Together

- ADN メンバーの方は、メンバー専用サイト ADN Extranet の日本語リソースからプレゼン資料と収録動画も入手いただけます。

お客様のニーズと要望に最も合うようにデスクトップとクラウドの両方で価値を提供すれば、ビジネスを拡大するために既知の API とコードを活用することが出来ます。オートデスクのデスクトップ製品は、クラウドを利用したForge 開発プラットフォームと無関係ではありません。今後、中核技術としてデスクトップ製品への流用が検討されているほか、クラウド利用の CAD へと広がりを見せつつあります。デスクトップ製品のアドイン/プラグイン開発知識も決して無駄にはなりません。このセッションでは、そんな未来を展望しました。

プレゼン資料をダウンロード

13:40～14:10 Forge アップデート

- ADN メンバーの方は、メンバー専用サイト ADN Extranet の日本語リソースからプレゼン資料と収録動画を入手いただけます。

2016 年の Forge 登場から現在までを振り返り、近年追加された API と今後追加される予定の API についてご案内しました。Project Quantum に投入する予定だった HFDM によるデータ管理に、従来のファイルを融合させた、次世代のデータ管理プラットフォームとなる Unified Data Platform ＝ Forge Data Platform についても言及しています。

プレゼン資料をダウンロード

<2019年3月7日

14:10～14:20                                                    <休憩> 

14:20～15:10 AutoCAD と AutoCAD API（製品リリースまで非公開）

- ADN メンバーの方は、メンバー専用サイト ADN Extranet の日本語リソースからプレゼン資料と収録動画を入手いただけます。

オートデスクの旗艦製品である AutoCAD の新バージョンの新機能、変更点とアプリケーションの移植情報をご案内します。

15:10～16:00 Inventor、Vault と Fusion 360（製品リリースまで非公開）

- ADN メンバーの方は、メンバー専用サイト ADN Extranet の日本語リソースからプレゼン資料と収録動画を入手いただけます。

Inventor と Vault の新バージョンの新機能、変更点とアプリケーションの移植情報をご案内します。また、Fusion 360 ついてもご案内しました。

16:00～16:10                                                    <休憩> 

16:10～17:10 Revit と BIM 360、Civil 3D（製品リリースまで非公開）

- ADN メンバーの方は、メンバー専用サイト ADN Extranet の日本語リソースからプレゼン資料と収録動画を入手いただけます。

BIM をけん引する業界トップの Revit とその関連製品の新バージョンの新機能、変更点とアプリケーションの移植情報をご案内します。さらに、BIM の運用の場を広げる目的で、Forge BIM 360 API に追加された機能ついてご紹介しました。 

BIM 360 API プレゼン資料をダウンロード

17:10～17:30 Forge を利用したビジネスについて（非公開）

- ADN メンバーの方は、メンバー専用サイト ADN Extranet の日本語リソースからプレゼン資料を入手いただけます。

オートデスクが  Forge に対しておこなうクラウド クレジットによる課金対象と、3rd Party が Forge を使って開発したアプリのエンドユーザにおこなう課金は異なります。このセッションでは、それらの違いとオートデスクがどこまで課金に介入していくかを明確にし、ベスト プラクティスについてご案内しました。 

By Toshiaki Isezaki

Developer Days 2019 開催のお知らせ

ADN（Autodesk Developer Network）にご加入い ただいている方を対象に、デスクトップ製品と Autodesk Forge の情報を日本語でお届けする Developer Days を開催いたします。ご案内する内容は開発に関する内容が中心になりますが、一部デスクトップ製品については新機能もあわせてご案内します。

今回のテーマは

The Desktop and Cloud Together

です。

開催期日：

2019年3月1日（金） Developer Days 東京

• 都合により、今回、大阪会場での開催はございません。恐れ入りますが東京会場への参加をご検討ください。また、後日、東京会場で収録した動画を ADN Extranet で配布いたしますので、同動画の参照もご検討ください。

開催場所： 

オートデスク 東京本社 セミナールーム/トレーニング ルーム

アジェンダ：

13:00～13:10 ADN からのお知らせ

ADN プログラムで利用可能な ADN Extranetと提供する製品ライセンス等について改めてご案内します。

13:10～13:40 Desktop and Cloud Together 

お客様のニーズと要望に最も合うように、デスクトップとクラウドの両方で価値を提供すれば、ビジネスを拡大するために既知の API とコードを活用することが出来ます。オートデスクのデスクトップ製品は、クラウドを利用したForge 開 発プラットフォームと無関係ではありません。今後、中核技術としてデスクトップ製品への流用が検討されているほか、クラウド利用の CAD へと広がりを見せつつあります。デスクトップ製品のアドイン/プラグイン開発知識も決して無駄にはなりません。このセッションでは、そんな未来を展望します。

13:40～14:10 Forge アップデート

2016 年の Forge 登場から現在までを振り返り、近年追加された API と今後追加される予定の API についてご案内します。

14:10～14:20

<休憩> 

14:20～15:10 AutoCAD と AutoCAD API

オートデスクの旗艦製品である AutoCAD の新バージョンの新機能、変更点とアプリケーションの移植情報をご案内します。

15:10～16:00 Inventor、Vault と Fusion 360 

Inventor と Vault の新バージョンの新機能、変更点とアプリケーションの移植情報をご案内します。また、Fusion 360 ついてもご案内します。

16:00～16:10

<休憩> 

 

16:10～17:10 Revit と BIM 360

BIM をけん引する業界トップの Revit とその関連製品の新バージョンの新機能、変更点とアプリケーションの移植情報をご案内します。さらに、BIM の運用の場を広げる目的で、Forge BIM 360 API に追加された機能ついてご紹介します。 

17:10～17:30 Forge を利用したビジネスについて

オートデスクが  Forge に対しておこなうクラウド クレジットによる課金対象と、3rd Party が Forge を使って開発したアプリのエンドユーザにおこなう課金は異なります。このセッションでは、それらの違いとオートデスクがどこまで課金に介入していくかを明確にし、ベスト プラクティスについてご案内します。 

申込方法：

次の情報をメールでお知らせください。定員になり次第締め切らせていただきます。

宛 先： adn@myautodesk.jp  （ADN 事務局）

件 名： 「Developer Days 2019 参加申し込み」

本 文：

• ご参加者の ADN ID、会社名、部署、役職、ご参加者氏名（フリガナ）、e-mail、電話番号
• 訪問者記入用紙、兼、受講票を順次メールでお渡ししますので、当日はプリントアウトしてお持ちください。
• セミナーの内容、時間、場所は、変更になる場合がございますことを予めご了承ください。

By Toshiaki Isezaki

Design Automation API for Revit - Postman Sample のセットアップ

前回のブログ記事では、Design Automation API for Revit の基本的な仕組み、用語、開発手順について解説いたしました。
今回は、実際の API について、Postman サンプルで動作を確認するためのセットアップ手順をご紹介します。

Postmanは、Web API ( RESTful API ) をテストするときに役立つツールです。

各種 OS 向けのクライアントアプリケーションや、 Chromeの拡張機能ツールとして提供されており、これらのツールを使用すれば、プログラムコードを作成することなく、HTTP リクエスト・レスポンスを確認することができます。

Web API をはじめて利用する際には、いきなり Webアプリケーションの開発を始めるのではなく、このようなツールを活用して、実際に API の動作を確認することで理解を深めることができます。

以前、このブログ記事でも Postman による RESTful API のテストについてご紹介しました。

ここで簡単に Web API のおさらいをしておきましょう。

Web API のリクエストを実行すると、その API のエンドポイントを提供しているサーバーに対して何らかのアクションを実行できます。
これらのアクションは HTTP メソッドという形で定義されております。
最も一般的なアクションは、GET、POST、PUT、および DELETEです。

たとえば、GETを使用すると、サーバーからデータを取得できます。POSTを使用すると、サーバー内の既存のファイルまたはリソースにデータを追加できます。PUTを使用すると、サーバー内の既存のファイルまたはリソースを置き換えることができます。また、DELETEを使用すると、サーバーからデータを削除できます。

Postman は、この Web API のリクエストを簡単に送信するツールです。

Design Automation API for Revit のドキュメントページでは、この Postman のサンプル（ベータ版）を Postman コレクションという形で公開しております。

• Postman Samples (Beta)

このドキュメントページに掲載されているセットアップ方法をご紹介します。

1. Postman のインストール

インストールの手順は下記の Postman 公式ドキュメントをご参照ください

• Installation and Updates

2. Forge アプリの作成と Client ID と Client Secret の取得

Postman サンプルを利用するためには、Forge アプリを作成する必要があります。

Forge ポータルサイトでこれから作成する Forge アプリを登録して、 Forge Platform API の利用に必要な Client ID と Client Secret を取得します。この処理は、手動でおこなう必要があります。具体的な手順は、過去のブログ記事を参考にしてください。

• Forge API を利用するアプリの登録とキーの取得

 

3. Postman Collection の入手とインポート

Postman Collection をダウンロードして、Postman アプリケーションでインポートします。Postman アプリケーションの左上の Import ボタンを押すと、インポートダイアログが表示されます。先ほどダウンロードした Collection ファイルを選択します。

• Design Automation for Revit - Postman Collection

Postman Collection とは、Postman で作成した Web API の複数の HTTP リクエストをコレクションとしてまとめて JSON 形式のテキストファイルで書き出したものです。

• Intro to collections

インポートが完了すると、下記のようにサイドバーにコレクションが表示されます。

 

4. Postman Environment の入手とインポート

Postman Environment をダウンロードして、Postman アプリケーションでインポートします。先ほどと同じインポートダイアログで Environment ファイルを選択します。

• Design Automation for Revit - Postman Environment

複数の HTTP リクエストで共通して利用するパラメータは、環境変数のような形式で管理することができ、これも Postman Environment として、同じ形式のテキストファイルで保存できます。

• Manage environments

インポートした Postman Environment をドロップダウンリストから選択し、クイックルックツールで確認します。

 

5. 環境変数の設定

クイックルックで表示されている大ログの右上の Edit ボタンを押すと、MANAGE ENVIRONMENTS ダイアログが表示されるので、Client ID と Client Secret を設定します。

またここで、ニックネームも設定することができます。ニックネームはグローバルで一意でなければなりません。他のユーザーに既に使用されている場合は、そのニックネームを使用することはできません。

6. Revit アドイン バンドルパッケージの準備

Revit アドインのバンドルパッケージを用意します。

もしまだ Revit アドインをお持ちでない場合、あらかじめ用意されているサンプルのアドインをダウンロードして使用することができます。

• SketchItApp.zip
• CountItApp.zip
• DeleteWallsApp.zip

これで Postman サンプルの準備は完了です。

次回はこの Postman サンプルを使って動作を確認してみましょう。

By Ryuji Ogasawara

Design Automation API for Revit 開発手順の理解

前回のブログ記事で、Design Automation API for Revit パブリックベータ版公開のアナウンスを致しました。
今回は、Developer's Guide の Step-by-Step チュートリアルをベースに開発手順の流れを解説いたします。

ステップ 1 – Revit アドインの変換（もしくは新規作成）とバンドルパッケージの準備

まず、Design Automation for Revit で実行する Revit アドインを用意します。
既に Revit アドインのソースコードをお持ちの場合は、ソースコードの一部を修正して Design Automation 用に変換することができます。
パブリックベータ版では、Revit 2018 と Revit 2019 のアドインをサポートしております。

Revit アドインの開発方法については、下記のページをご参照ください。

• Revit デベロッパー センター
  
  
• Revit API 開発者向けコンテンツのご案内

従来の Revit アドイン開発と同様に、Microsoft Visual Studio を利用し、Revit のバージョンに対応する .NET Framework のバージョンを設定します。

• Revit 2018 -> .NET Framework 4.6
• Revit 2019 -> .NET Framework 4.7

次に参照ライブラリ（ DesignAutomationBridge.dll ）をダウンロードして、プロジェクトの参照設定に追加します。同時に、RevitAPIUI.dll を参照設定している場合は、その参照を削除します。

Revit アドインは、通常は外部アプリケーションや外部コマンドのためのインターフェースを実装しますが、Design Automation の場合は、外部DBアプリケーションインターフェースを実装します。

DesignAutomationBridge.DesignAutomationReadyEvent イベントのイベントハンドラに、実際のカスタム処理を追加します。

ローカルの Revit 環境でテストして、バグがないことを確認します。
DesignAutomationBridge.DesignAutomationReadyEvent イベントを一時的に ApplicationInitialized イベントに置き換えることで、Revit アプリケーションの初期化時にカスタム処理を実行することができます。

デバッグして問題がなければ、アセンブリファイルを指定のディレクトリ形式で ZIP 圧縮して、バンドルパッケージを作成します。

これで、Revit アドインの準備は完了です。

 

ステップ 2 – Forge アプリの作成

Design Automation API を利用するためには、Forge アプリを作成する必要があります。

まずは作成するアプリケーションの情報を登録して、Client ID と Client Secret を取得します。

• Forge API を利用するアプリの登録とキーの取得

Forge アプリは、Web 開発が主体となるため、開発環境は自由です。
サーバーには Node.js や ASP.NET などをお勧めしております。

• Forge の開発環境

Design Automation API を利用するために、Authentication API の 2-legged 認証によって、Access Token（アクセス トークン） を取得します。
2-legged 認証については、下記のブログ記事で解説しております。

• Forge での OAuth 認証シナリオ

Forge アプリでアクセストークンを取得できれば、以降は Design Automation API の呼び出しになります。

 

ステップ 3 – Forge アプリのニックネームの作成

Design Automation は、Forge アプリを識別するために Client ID を使用しますが、これは人間には覚えづらい文字列（例えば、YnhayiOjhgnsd&jsafh890ryehQW）となっています。

Forge アプリから Design Automation に処理を依頼するときにも、この Client ID が必要となりますが、より覚えやすいニックネームで名前を付けてマッピングを行うことができます。

 

ステップ 4 – Appbundle のパブリッシュ

ステップ 1 で作成した Revit アドインを Design Automation で実行するために、バンドルパッケージを Appbundle として Design Automation に登録します。

Appbundle を作成する際、任意の名前で ID を指定し、Revit アドインを実行する Revit のバージョン（2018 もしくは 2019）を指定します。

Appbundle の作成が成功すると、レスポンスの JSON データに、バンドルパッケージをアップロードするエンドポイント URL が返されます。このエンドポイント URL に対して、バンドルパッケージをアップロードします。

実はこれだけでは Appbundle の作成は完了しておりません。

作成した Appbundle は、開発中に何度もバンドルパッケージを再アップロードしたり、更新が発生します。

そのような状況に対応するために、Appbundle には、バージョンとエイリアスを指定する仕組みが備わっております。エイリアスは、Appbundle のバージョンに対して開発者が任意の名称でつけるラベルです。

たとえば、はじめて Appbundle を作成した場合、バージョンは自動的に 1 に指定されます。
このバージョンをテスト版として利用する場合は、エイリアスに test や development といった名前をつけます。

このように Appbundle のバージョン 1 に対して、test とエイリアス名をつけた場合、ステップ 3 で作成したニックネームと合わせて、Appbundle は下記のように識別することができます。

• 形式: YourNickname.SomeAppBundleId+SomeAliasName
• 例: MyFirstForgeApp.DeleteWallApp.test

 

ステップ 5 – Activity のパブリッシュ

ステップ 4 で登録した Appbundle では、実際にどういったデータをインプットして、どういったデータをアウトプットするのか定義しませんでした。
そのため、次は Activity を登録して、Design Automation で実行されるアクションを定義します。

たとえば、Revit モデルとテキストファイルをインプットとして Revit アドインに渡して、アドインの処理の結果として、Revit モデルを返却するといったように、入出力のパラメータを定義します。

そして、このアクション定義と Appbundle を紐づけるために、先ほどの Appbundle の識別コードを指定します。
Activity でも、バージョンとエイリアスの仕組みがありますので、任意の名前をつけます。

Activity も同様に下記のような形式で識別することができるようになります。

• 形式: YourNickname.SomeActivityId+SomeAliasName
• 例: MyFirstForgeApp.DeleteWallActivity.test

バージョンとエイリアスは、Design Automation API V3 で新規に追加された仕組みです。開発時に、リリース用、テスト用、ステージング用など、それぞれラベリングしてバージョン指定することで、開発効率が向上します。

 

ステップ 6 – Workitem のポスト

Appbundle と Activity の登録ができれば、最後は Design Automation にジョブを依頼します。
このジョブを Workitem と呼びます。Workitem が Activity を呼び出し、Activity は Appbundle を呼び出します。

Workitem では、Revit アドインに渡す Revit モデルやテキストファイルの実際の URL、出力結果のアップロード先のクラウドストレージの URL と、実行する Activity を指定します。

レスポンスには Workitem の ID が返却されますので、この ID を利用して、処理の進捗状況を確認することができます。

このように、WorkItem と Activity、Appbundle は相互に関連付けられて、最終的に Revit アドインが実行される仕組みになっております。

今回は、Design Automation API を利用して Forge アプリを開発する手順をご紹介しました。より詳細な解説は、先日の BIM & Forge セミナーのレコーディングとスライドでご覧いただけます。

次回は、Postman を使って実際に API を利用する方法をご紹介いたします。

By Ryuji Ogasawara

Design Automation API for Revit パブリックベータ版の公開

先日の BIM & Forge セミナーで告知していた通り、1月28日、Design Automation API for Revit がパブリックベータ版として公開されました。

これまでは、招待制で一部のパートナー様にプライベート ベータ版としてご利用いただいておりましたが、今後は、Forge アプリを開発されるデベロッパーの皆様にもお試しいただくことができます。

今回は、Design Automation API for Revit の概要をご紹介し、次回以降、複数回にわたってチュートリアル形式で開発方法をご案内いたします。

これまでリリースされてきた Forge プラットフォーム API は、 Authentication API で認証・認可を行い、Data Management API でクラウド上の CAD データにアクセスし、 Model Derivatives API でデータ変換を行い、Web ブラウザで Viewer を通じてデータを表示・閲覧することが主な用途でした。

Web ブラウザで CAD データを簡単に閲覧できる仕組みが登場したことで、より多くの潜在的なユーザー層に、CAD データを活用する機会をご提供することができました。

しかし、残念ながら、現状の Viewer は、CAD ソフトウェアのモデリング機能を搭載していないため、CAD データを作成・編集することはできません。

Autodesk は、こうした制約に対する一つの解として、Design Automation API をリリースしました。

Design Automation API は、クラウド上で CAD エンジンのコア API を利用する環境を提供します。
Forge プラットフォームを活用して、自動化されたジョブを、大規模かつ効率的に実行することができます。

• 繰り返し行う処理
• 頻度の高い処理
• 大規模な演算処理能力を必要とする処理

従来は AutoCAD のエンジンのみがサポートされておりましたが、V3 では、Inventor、3ds Max、そして Revit が追加されました。

Design Automation API for Revit は、Revit のエンジンを Forge のサービスとしてクラウド上で実行できる環境を提供します。

次のようなメリットがあります。

• Revit がローカルのデスクトップ環境にインストールされていなくても、クラウドサービスを通じて Revit アドインを実行
• Revit のサブスクリプションが不要
• これまで Revit API を利用して開発した Revit アドインのソースコード資産を再利用
• 任意のクラウドストレージ上のデータを読み取り、保存できるため、いつでもどこからでもアクセス可能

Revit アドインを Forge にアップロードし、クラウドネイティブなアプリケーションやサービスを構築すれば、Revit データを「作成」、「抽出」、「編集」することができます。

これまで、Revit のターゲット層は主に設計者でしたが、より幅広いユーザーが Revit データを活用できるようになります。

Revit アドインのプログラムでは、Revit DB API にフルアクセスすることができ、次のようなワークフローが想定されます。

• カスタムの Revit ファミリを作成
• モデル作成の自動化
• モデルデータの抽出・解析
• レポートの自動生成
• 設計基準に合わせて既存モデルを編集
• 設計図書の自動作成

ただし、いくつかの制約事項もございます。

• Revit ユーザーインターフェースの表示・操作、RevitAPIUI.dll アセンブリの参照はできません。
• REST API で直接 Revit のデータにアクセスできません。
• 複雑なセッション管理は想定されていません。（バッチ処理を想定）
• Revit アドインから外部ネットワークにアクセスすることはできません。
• ユーザーとのインタラクションが発生する処理はサポートされておりません。

先日開催した BIM & Forge セミナーの 4つ目のセッションでは、Design Automation API の概要、仕組みと開発要件、開発の流れ、制約事項などを詳しく解説しております。ぜひご参照ください。

BIM & Forge セミナーのサマリー
https://adndevblog.typepad.com/technology_perspective/2019/01/bim-forge-seminar-summary.html

Design Automation API V3 のドキュメントへのアクセス方法

デフォルトでは V2 が表示されますので、下記のリンクから直接アクセス頂くか、ドキュメントのバージョンを V3 に指定すると閲覧できます。

https://forge.autodesk.com/en/docs/design-automation/v3/developers_guide/overview/

Step-by-Step Tutorials では、Revit 版の詳細なチュートリアルをご確認いただけます。

最後に注意点として、パブリックベータ版は、より多くのデベロッパーの皆様からフィードバックを頂いて、API を改善し、機能追加の優先度を整理し、スケーラビリティを検証することが目的となります。

そのため、あくまでもプロトタイプ検証などの用途としてご利用いただき、プロダクションレベルのアプリケーションではご利用されないようお願い致します。

また今後、API が一部変更される可能性があることをご了承ください。

次回から、チュートリアルに沿って、サンプルを実装する手順を解説いたします。

By Ryuji Ogasawara

開発ブログ プラットフォームの継続

昨年、開発ブログ プラットフォームの変更について の記事で、このブログ サイト Autodesk Perspective From Japan を含む開発系のブログについて、システムの変更に伴う URL の予告していましたが、その後の社内評価の結果、急遽、現行 Typepad システムを使い続けることになりました。

Autodesk Perspective From Japan も現在の URL https://adndevblog.typepad.com/technology_perspective/ で引き続きご覧いただくことが出来ます。

お騒がせして申し訳ありません。今後ともよろしくお願いいたします。

By Toshiaki Isezaki