Technology Perspective from Japan

2019/02/20

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

投稿情報: 2019/02/20 00:05 カテゴリー: API カスタマイズ, クラウドサービス, デスクトップ製品 | 個別ページ | コメント (0)

2019/02/18

Forge Viewer バージョン 6.4 リリース

新しい Forge Viewer バージョン 6.4 がリリースされていますので、その機能や変更点をご紹介しておきます。 Extension については、LMV Ninja でお試しいただけます。LMV Ninja については、過去のブログ記事 LMV Ninja を使った URN 指定表示 などをご参照ください。

新機能

CrossFadeEffects Extension

CrossFade エフェクトは、複数のカラーターゲットへのレンダリングとそれらのブレンドをサポートするビューアのオプション機能です。以前は、このコードはビューア本体のコードの一部でしたが、今回、新しい Extension である "CrossFadeEffects" に移動することのなりました。Extension 名は Autodesk.CrossFadeEffects となります。

例:

var extName = 'Autodesk.CrossFadeEffects';
NOP_VIEWER.loadExtension(extName);

function setCameraToRoom() {
    var cam = {
       fov:          53.13010235415598,
       isPerspective:true,
       orthoScale:   6.442020414517138,
       position:     {x:-23.63091853857176, y: 0.9033896546012906, z:-4.261154219883789},
       target:       {x:-20.871083468967406, y: 6.520671770079398, z:-5.787286273399167},
       up:           {x:0.10446560472788749, y: 0.21262602957092375, z:0.9715333802694284}
    };
    NOP_VIEWER.impl.setViewFromCamera(cam, true);
}

function fadeExample() {

    // apply fade transition
    var viewer = NOP_VIEWER;
    var ext = viewer.getExtension(extName);   
    ext.fadeToViewerState(setCameraToRoom, 1.5);
}

Geolocation Extension

WGS-84 形式（x：経度、y：緯度、z：高さ（m））の GPS 座標をビューアシーン座標に変換したり、その逆の変換をおこなうための機能を提供します。シーンにロードされた単一の 3D モデルをサポートします。 Extension 名は Autodesk.Geolocation です。

例:

viewer.loadExtension('Autodesk.Geolocation').then(function (extension) {
    extension.activate();
});)

機能:

hasGeolocationData()

モデルに位置情報データが含まれているかをブール値を返します（モデルに位置情報データが含まれている場合は true）。

lmvToLonLat( lmvPoint )

viewer.clientToWorld（）などで取得したビューア座標を WGS-84 形式の座標（x：経度、y：緯度、z：高さ（メートル））に変換します。

戻り値：THREE.Vector3：WGS-84 形式の GPS 座標：（x：経度、y：緯度、z：高さ）

lonLatToLmv( lonLat )

WGS-84 形式の座標（x：経度、y：緯度、z：高さ（メートル））をビューアシーン座標に変換します。

戻り値：THREE.Vector3: シーンの 3D 点

openGoogleMaps( [ pointLL84 ] )

指定された GPS 位置に PIN を付けて Google マップのURLを返します。引数が指定されていない場合、URL はモデルの位置情報があればそれを使用します。

activate()

モデルをクリックして点を設定し、テストおよびデバッグ用のオプションのパネル UI（英語）を表示します。

デンマーク語ロケールのサポート
viewer.impl.getScreenshotProgressive へのリーフレットのサポート
getScreenshotProgressiveでゴーストオブジェクトをサポート
Markup Extension でのアンドゥのサポート
異なる dpi リーフレット-pdfファイルの比較をサポート
viewer.setTheme（ 'bim-theme'）による BIM カラーテーマ
メソッドBubbleNode.useAsDefault（）：Boolean

変更点

設定パネルの環境 UI の再デザイン
[PushPin Extension] LMV IDとともに外部 ID を保存
[PushPin Extension] globalOffsetをviewerState に保存
FloorSelector：モバイルでの実行時には crossFade 効果を使用を抑止

By Toshiaki Isezaki

投稿情報: 2019/02/18 00:50 カテゴリー: API カスタマイズ, クラウドサービス | 個別ページ | コメント (0)

2019/02/15

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 アドインをお持ちでない場合、あらかじめ用意されているサンプルのアドインをダウンロードして使用することができます。

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

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

By Ryuji Ogasawara

投稿情報: 2019/02/15 16:00 カテゴリー: API カスタマイズ, クラウドサービス, デスクトップ製品 | 個別ページ | コメント (0)

2019/02/13

Forge Viewer シーンへの複数モデルの表示

Forge Viewer には Model Derivative API で SVF 変換したデザインをストリーミング配信を使って表示することが出来ます。通常、表示は変換に使用したシードファイル（CAD 毎に異なる返還前のデザインファイル）単位で Basic Viewer や Basic Application などの方法で実装することになります。ただ、ビューア上でコンフィギュレータなど、単一のシードファイルにないモデルを Forge Viewer の同一シーンに表示させたいことがあるかもしれません。

Forge Viewer JavaScript ライブラリでは、そのような用途に Viewer3D.LoadModel メソッドを用意しています。もちろん、この方法で表示させたいモデルも、事前に Model Derivative API で SVF 変換しておく必要があります。

実際の使用では、Autodesk.Viewing.GEOMETRY_LOADED_EVENT イベントを登録、イベントを検出して、カンバス内に Basic Viewer や Basic Application などでメインとなるモデルを表示、ジオメトリのロード完了時に呼び出されるコールバック関数内に LoadModel() を記載する事になります。最初のパラメータには、カンバス上に（2つめ以降に）表示させたいモデルの URN を指定します。この URN 指定では、メインモデルを表示で指定した Base64 エンコードしたシードファイルの URN ではなく、変換済の SVF を示す URN を直接指定します。分かりやすくご紹介するなら、シードファイルを変換した際に作成されるマニフェストにある SVF を指し示す URN 文字列となります。

ここで Base64 エンコードしたシードファイルの URN を指定してしまうと、Viewer コード実行時に次のエラーが表示されるので分かりやすいはずです。

上記例だと、指定すべき値は "dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6ZnBkLWphcGFuLWF2cGc1ZmdyaDVxYnBvOGhrMTV
sc3p6ZzhkcmZrbnJvdXdtd2QwcDhsbXNlMzJwN29qb3h6NXB6b251dGktN2cvVG93ZXItTm9Cb3VuZG
FyeS5ud2Q" ではなく、"urn:adsk.viewing:fs.file:dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6ZnBkL
WphcGFuLWF2cGc1ZmdyaDVxYnBvOGhrMTVsc3p6ZzhkcmZrbnJvdXdtd2QwcDhsbXNlMzJwN29qb
3h6NXB6b251dGktN2cvQnVpbGRpbmctTm9Cb3VuZGFyeS5ud2Q/output/0/0.svf" となります。

LoadModel() で重要になるのは、各モデルの位置合わせです。一般に、CAD データでは尺度という概念を持ち、用途によっては、更に緯度経度といった位置情報も持ち合わせています。ただし、three.js をベースにする Forge Viewer には、そのような概念はありません。

例えば、Navisworks 内で複数のモデルをインポート、位置合わせしたと仮定します。

この状態で、メインモデル、サブモデル１、サブモデル２単位に個別に NWD ファイルで出力、Model Derivative API で変換して LoadModel() で配置した場合、表示されたモデルが重なってしまったり、モデルの大きさが変わってしまう結果になってしまいます。

Forge Viewer は、ロードするモデルの境界ボックスの中心をカンバス原点に合わせて配置・表示します。つまり、モデル毎に設定される原点が異なるため、上記のように意図しない結果になってしまいます。

ここで必要になるのが、2 つめの options パラメータで指定する Global Offset の値です。Global Offset は、この配置時に、どの程度オフセット（ずらして）配置するかを指定します。前述のように、Navisworks のシーン内で相対位置が決まっている場合には、LoadModel() でメインモデルと同じ Global Offset 値を継承して配置すれば、相対位置を維持したまま表示をおこなうことが可能です。

...    
    // Intialize Viewer
    var options = {};
    options.env = "AutodeskProduction";
    options.accessToken = getToken();
    options.document = "urn:" + urn;
    options.language = "ja";
                
    var viewerElement = document.getElementById('viewer3d');
    _viewer = new Autodesk.Viewing.Private.GuiViewer3D(viewerElement, {}); // With default UI

    Autodesk.Viewing.Initializer(options, function () {
        _viewer.initialize();
        _viewer.setTheme("light-theme");
        loadDocument(_viewer, options.document);
        _viewer.addEventListener(Autodesk.Viewing.GEOMETRY_LOADED_EVENT, onViewerGeometryLoaded);
        });
    }

    function onViewerGeometryLoaded(event) {
        var urn = "urn:adsk.viewing:fs.file:dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6ZnBkLWphcGFuLWF2cGc1ZmdyaDVxYnBvOGhrMTVsc3p6ZzhkcmZrbnJvdXdtd2QwcDhsbXNlMzJwN29qb3h6NXB6b251dGktN2cvQnVpbGRpbmctTm9Cb3VuZGFyeS5ud2Q/output/0/0.svf";
        _viewer.loadModel(urn, { globalOffset: event.model.getData().globalOffset });
        urn = "urn:adsk.viewing:fs.file:dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6ZnBkLWphcGFuLWF2cGc1ZmdyaDVxYnBvOGhrMTVsc3p6ZzhkcmZrbnJvdXdtd2QwcDhsbXNlMzJwN29qb3h6NXB6b251dGktN2cvVG93ZXItTm9Cb3VuZGFyeS5ud2Q/output/0/0.svf";
        _viewer.loadModel(urn, { globalOffset: event.model.getData().globalOffset });
        _viewer.removeEventListener(Autodesk.Viewing.GEOMETRY_LOADED_EVENT, onViewerGeometryLoaded);
        
    }
...

SVF 変換間に同一シーンで位置合わせをおこなっていない場合には、three.js を併用したマトリックス変換をモデル挿入後に実施し、位置や大きさを変化させる方法もあります。新しい Forge Viewer チュートリアル改訂版～その2 でご紹介している Viewing.Extension.Transform.min.js ファイルで定義された Extension が参考になるかと思います。

同じモデル群に対して位置合わせ等をテストする場合には、コードを修正しても表示に反映されず、期待した結果にならない場合があります。コードの変更による位置等の変化が確実な場面では、前回実行した内容がブラウザキャッシュに残っていて、適切に反映されない原因になっていることもあります。ブラウザキャッシュをクリアすると問題が解消することがありますのでお試しください。

なお、英語ブログになってしまいますが、併せて次の記事もご確認いただくこともお勧めします。

Aggregating multiple models in the Viewer

Preparing your viewing application for multi-model workflows

Preparing your viewing application for multi-model workflows - Part 2: Model Loader

By Toshiaki Isezaki

投稿情報: 2019/02/13 03:15 カテゴリー: API カスタマイズ, クラウドサービス | 個別ページ | コメント (0)

2019/02/08

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 アドイン開発と同様に、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

投稿情報: 2019/02/08 17:54 カテゴリー: API カスタマイズ, クラウドサービス, デスクトップ製品 | 個別ページ | コメント (0)

2019/02/06

Content-length ヘッダー指定要件の必須化

Forge Data Management API のパフォーマンス改善の一環として、Forge チームは Forge API Proxy レイヤーでリクエスト/レスポンスのバッファリングを無効にする計画をしています。必要な Content-Length ヘッダー情報なしで POST または PUT リクエストを送信した場合、Forge Proxy は 2 月末からコミュニケーションを拒否する予定です。この変更の影響を受ける最初の API は OSS PUT objects と OSS PUT resumable のリクエストとなる予定ですが、今後、すべての POST PUT リクエストが影響を受ける可能性があります。

通常、ほとんどの SDK および REST クライアントはこのヘッダーを自動的に追加します。 REST プログラミングのベストプラクティスに従っていることを確認して、リクエストにヘッダー提供してください。 Forge チームはすでにこの問題を抱えている人々に直接連絡を取っているので、オートデスクから電子メールを受け取っていなければ、おそらく響はないものと思いますが、念のため、ご確認をお願いいたします。

By Toshiaki Isezaki

投稿情報: 2019/02/06 00:03 カテゴリー: API カスタマイズ, クラウドサービス | 個別ページ | コメント (0)

2019/02/04

3-Legged OAuth で A360 データを表示するサンプル

Forge を包括的に習得いただける Tutorial ページに、Learn Autodesk Forge（英語）があります。この中に、3-Legged OAuth を利用して A360 などのオートデスクストレージにアクセスし、ストレージ内に保存されているデザインデータを表示する learn.forge.viewhubmodels サンプルがあります。ちょうど、Postman による Viewer 利用手順の理解 - 3 legged 認証 に相当する内容を Forge SDK を使ってトレースすることになります。ここでは、Windows で learn.forge.viewhubmodels サンプルをローカル Node.js 開発環境にクローンし、セットアップ、テストしていく手順をご案内します。

リポジトリの内容からローカルでテストするには、事前に Git for Windows や Node.js をセットアップしておく必要があります。また、実行時には Forge で利用する Client ID と Client Secret（Consumer Key と Consumer Secret）を事前に Forge ポータル から取得しておく必要があります。これらの手順は、それぞれ、次のブログ記事でご案内しています。

Forge の開発環境

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

※ このサンプルをローカル環境で実行するには、Forge ポータルでのアプリ作成時に、あらかじめ CallBack URL に http://localhost:3000/api/forge/callback/oauth を設定しておく必要があります。

Web ブラウザで GitHub 上の learn.forge.viewhubmodels リポジトリページを開きます。
画面右側の [Clone or download] ボタンをクリックして、表示される URL https://github.com/Autodesk-Forge/learn.forge.viewhubmodels.git をクリップボードにコピーしておきます。
GitHub 上のプロジェクトを、リポジトリから開発に使用するクライアントコンピュータにコピーします。コマンドプロンプトを起動して、リポジトリ内容をコピーしたいフォルダ（ディレクトリ）に CD コマンドで移動し、git clone -b nodejs https://github.com/Autodesk-Forge/learn.forge.viewhubmodels.git （クリップボード内の URL）と入力します。例えば、C:\Users\<Windows ログインユーザ名>\Documents\GitHub フォルダに移動して git clone -b nodejs https://github.com/Autodesk-Forge/learn.forge.viewhubmodels.git を実行すると、C:\Users\<Windows ログインユーザ名>\Documents\GitHub フォルダ下に learn.forge.viewhubmodels フォルダが作成され、GitHub リポジトリからソースコードがコピーされます。
クローン（コピー）されたプロジェクトに Node.js の実行で必要となるパッケージ（ミドルウェア）をインストールします。CD コマンドで現在のフォルダを learn.forge.viewhubmodels フォルダへ移動してから、npm install と入力します。
このサンプルでは、実行時にシステム環境変数から Client ID と Client Secret、CallBack URL を取得します。コマンドプロンプト上で SET コマンドを使って、環境変数を指定します。上記、※ で作成したアプリから Client ID、Client Secret、CallBack URL を読み取り、それぞれ、システム環境変数、FORGE_CLIENT_ID、FORGE_CLIENT_SECRET、FORGE_CALLBACK_URL を設定します。クリップボードとメモ帳などを利用してコピー＆ペーストしながら SET コマンドを実行してみてください。
```
set FORGE_CLIENT_ID=<<YOUR CLIENT ID FROM DEVELOPER PORTAL>>
set FORGE_CLIENT_SECRET=<<YOUR CLIENT SECRET>>
set FORGE_CALLBACK_URL=<<YOUR CALLBACK URL>>
```
ここまでの手順で実行の準備は完了です。カレントフォルダが learn.forge.viewhubmodels フォルダであることを確認したら、npm start と入力、リターンキーを押して Node.js サーバーを起動します。
Web ブラウザを起動して、URL の localhost:3000 と入力してリターンすると、ページ左側に [Autodesk Sign In] ボタンが表示されるはずです。
[Autodesk Sign In] ボタンをクリックして、アクセスしたい A360 ストレージのオーナーの Autodesk ID（ユーザ名とパスワード）でサインインを試みます。このページを表示している Forge アプリは、本来。当該オーナーの A360 ストレージにはアクセス出来ないことに注意してください。このため、ユーザ名、パスワードを入力してサインインが完了すると、Forge アプリのストレージアクセスを許可（認可）するか、サインインしたオーナーに確認するための画面を表示します。

ここで表示されるアクセス権の種別（データ書き込みや表示など）は、Forge アプリが Access Token を取得する処理で指定した Scope の内容が反映されたものとなります。 [許可] をクリックすると、A360 ストレージデータのオーナーが Forge アプリにアクセス許可を与えることになります。
Hub >> Project >> Folder >> Item >> Version の順で当該 A360 のストレージ構造をナビゲートし、任意の Version をクリックすると、デザイン（モデル）が Viewer 領域に表示されます。

もちろん、A360 内でナビゲートした内容と同じ構造で、同じデザインバージョンを表示出来ているはずです。

A360 側で一度表示したデザインデータは、既に SVF 変換されていて、マニフェストを取得出来る点に注意してください。つまり、Forge アプリ側で Model Derivative API を使った明示的な SVF 変換は不要です。

BIM 360 Docs ストレージにも同様の 3-Legged OAuth を介して取得した Access Token を使って Data Management API でアクセスすることが出きます。ただし、そのような BIM 360 統合アプリには、事前に BIM 360 側でストレージにアクセスすることになる Forge アプリの Client ID を登録する必要があります。詳しくは、過去のブログ記事 BIM 360 Docs と Data Management API アクセス をご参照ください。

By Toshiaki Isezaki

投稿情報: 2019/02/04 00:11 カテゴリー: API カスタマイズ, クラウドサービス | 個別ページ | コメント (0)

2019/02/01

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

投稿情報: 2019/02/01 00:15 カテゴリー: API カスタマイズ, クラウドサービス, デスクトップ製品 | 個別ページ | コメント (0)

2019/01/30

BIM & Forge セミナーのサマリー

1月22日（火）東京、1月25日（金）大阪で BIM & Forge セミナーを開催し、合計で約 100 名の皆様にご参加いただきました。

当日ご紹介したプレゼンテーション資料と動画（一部除く）を下記に公開いたしますので、ご確認ください。

13:00～14:00 BIM 360 ファミリ製品とデータ管理－アナビ、森

Revit など、BIM を標ぼうする CAD ソフトウェアで作成した BIM データをクラウド上に保存し、関係者間でコラボレーションするプラットフォームに BIM 360 Docs があります。ここでは、BIM 360 Docs が持つ効果的な機能や Revit との連携に加え、次世代 BIM 360 と言われている BIM 360 の製品体系と役割を整理しました。

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

14:00～14:10 <休憩>

14:10～15:00 Forge 概要と BIM 360 の関係－伊勢崎

Forge Platform API の 1 つに BIM 360 API があります。このセッションでは、Revit API など、デスクトップ製品 API と Forge の考え方や違いを示し、Forge が現在提供するソリューションと BIM 360 の関係を明示的ご案内しました。

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

15:00～15:15 <休憩>

15:15～16:05 Forge による BIM 360 Docs 統合－伊勢崎

オートデスクがクラウドを使って実現しようとしている方向性をご紹介した後に、Forge を使って BIM 360 に統合する手順と方法、また、統合によって得られる効果をコストも含めてご説明しました。

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

16:05～16:20 <休憩>

16:20～17:20 Forge Design Automation API for Revit での自動化－小笠原

Design Automation API を利用すれば、Revit がデスクトップの環境になくても、クラウド上で Revit API を使用したカスタム処理を実行して、 Revit のモデルを作成・編集したり、データを抽出したりすることができます。このセッションでは、Revit アドインの開発経験のある方や Forge にご興味のある方を対象に、Design Automation API でサポートされる機能の概要と、また機能的な制約、そして活用方法をご紹介いたしました。

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

もし、3-legged OAuth を使った Forge アプリからのオートデスクストレージサービスへのアクセス方法に興味をお持ちの場合には、Forge 1 Day Workshop - A360 活用編 も併せてご確認ください。

By Toshiaki Isezaki

投稿情報: 2019/01/30 00:10 カテゴリー: API カスタマイズ, クラウドサービス | 個別ページ | コメント (0)

2019/01/28

A360 ストレージサービスのわかりにくいところ

オートデスクが継続して開発、拡張に取り組んでいるクラウドサービスに、デスクトップ CAD 製品で作成したファイルをクラウドにアップロードしてバックアップしたり、関係者とコラボレーションしたりするためのストレージサービスがあります。（Buzzsaw を除き）2011 年 9 月の Autodesk Cloud Documents から A360 までの発展の詳細は、オートデスククラウドストレージサービスの遷移 のブログ記事でご案内したことがありますが、現在、A360 Team の分化が原因で製品構成が把握しにくくなっている感があります。ここでは、改めて、現在の状況をまとめておきたいと思います。

まず、新規に契約、あるいは、お使いいただけるストレージサービスについてです。2019 年 1 月現在、オートデスクがストレージサービスとして提供しているのは、個人用途の A360 Personal、製造業向けでチーム用途の Fusion Team、そして、建設業のチーム用途となる BIM 360 Docs の 3 種類です。BIM 360 Docs は、A360 Team から名称変更した BIM 360 Team の新規販売の停止後、BIM 360 Glue や Field といったユーティリティサービスのストレージを統合する目的も担っています。別の言い方をするなら、建設業向けに提供される各種クラウドサービスのデータ集約の場として利用されるのが BIM 360 Docs であり、BIM 360 Docs 上のデータを活用する BIM 360 サービス群が、いわゆる、次世代 BIM 360 と言えます。

BIM 360 Team は、サブスクリプションとして提供されていましたが、現在、新規に契約することは出来ません。ただし、過去にサブスクリプション契約されていた方は、契約を更新して利用し続けることが出来ます。

A360 Drive？

さて、オートデスクのストレージサービスをお使いいただく中で混乱しがちな点の 1 つめは、A360 Drive（A360 ドライブ）です。ストレージサービスには、データ管理の方法にフォルダベースの管理を提供する A360 Drive と、プロジェクトベースの管理を提供する A360 があります。後者には、A360 Personal、旧 A360 Team、旧 BIM 360 Team、Fusion Team、BIM 360 Docs がありますが、ユーザインタフェースを A360 Drive に切り替えられるのは、A360 Personal、旧 A360 Team、旧 BIM 360 Team、Fusion Team のみです。

ただし、既定値で A360 Drive への切り替えがオフになっています。A360 Drive の利用が必要な場合は、A360 の設定をを変更し「A360 Drive を表示」をオンにしてみてください。

「A360 Drive を表示」がオンになると、ページ左上にに表示される A360 アイコンをクリックすることで、A360 Drive への切り替えがおこなえるようになります。

A360 Drive の名称は、Fusion Team、旧 BIM 360 Team から切り替えた場合も同一です。Fusion Drive や BIM 360 Drive のような表記にはなりません。最も重要なのは、プロジェクトベース管理のストレージサービスでアップロード、管理しているファイルは、フォルダベースの A360 Drive 上には表示されない点です。また、Forge の Data Management API でアクセスすることが出来るのは、プロジェクトベースのストレージのみです。A360 Drive にアクセスする Forge Platform API は提供されていません。

A360 Drive は、フォルダベース管理の系譜を持つ Autodesk Cloud Documents や Autodesk 360 を利用されていた方向けに用意されているものなので、新規活用はお勧めしていません。ご注意ください。

A360 Personal？

旧 A360 Team、旧 BIM 360 Team、Fusion Team、BIM 360 Docs はサブスクリプション製品（有償）ですが、A360 Personal は無償です。といっても、明示的にユーザインタフェースに A360 Personal と表示される訳ではありません。Autodesk ID を作成（A360 にサインアップ）して、A360 を使い始めると、すでに A360 Personal を利用していることになります。

A360 Personal はプロジェクトベースのデータ管理を提供しますが、作成出来るプロジェクト数は 1 つに制限されています（既定で作成されている Demo Project を除く）。もし、[プロジェクトを作成] をクリックして次のようなメッセージが表示されるなら、お使いの A360 は A360 Personal ということになります。

A360 Personal のアップグレード先？

もし、複数のプロジェクトを利用する必要がある場合には、上記の画面から Team 版にアップグレードすることが出来ます。ここでいうアップグレードとは、Fusion Team か BIM 360 Docs への新規サブスクリプション契約を指すことになります。前述のとおり、A360 Team や BIM 360 Team への新規契約は停止されているのが理由です。

Fusion Personal？

A360 Personal を利用中に、ページに表示される A360 のアイコンが、いつの間にか Fusion のアイコンになってしまう場合があります。

Fusion 360 をお使いの方はご存知と思いますが、Fusion 360 は作成したデザインの保存にプロジェクトベースの A360 ストレージを利用しています。もし、A360 Personal で使用した Autodesk ID を使って Fusion 360 にサインイン、使用してしまうと、A360 Personal 側も Fusion（Personal）アイコンで再ブランド化されてしまいます。これは、自動的に Fusion Team へアップグレードされた訳ではなく、Fusion 360 の 30 日間トライアル（体験版）モードが適用されたことを意味するマーケティング的なアイコンの変更です。このトライアルの開始と同時に、本来、A360 Personal で 1 つしか作成出来ないプロジェクトが複数作成出来るようになってしまいます。

トライアル期間を経て Fusion 360、あるいは、Fusion Team をサブスクリプション契約しないと、トライアル期間中に作成したプロジェクトやプロジェクト内のファイルは読み取り専用になり、新しいデータの書き込みは出来なくなってしまいます。具体的には、プロジェクトに新しいファイルをアップロードしたり、既存のファイルに新しいバージョンを追加したりすることは出来ません。ご注意ください。

残念ながら、Fusion 360 のトライアル期間 30 日を終了しても、A360 Personal に戻るようなことは出来ません。同様に A360 アイコンに戻す設定等はありません。なお、トライアル期間中に作成したプロジェクトやアップロードしたファイルは、トライアル期間終了後もダウンロードすることは可能です。

各オンラインヘルプ

ここまでご紹介してきたのは、オンラインヘルプに記載された機能的なものではなく、オートデスクの都合で変更してきた販売・運用上のルールによるものが大きく関係しています。このため、将来、内容が変更される可能性がある点をご理解ください。ご参考まで、次に各ストレージサービスのオンラインヘルプドキュメントの URL を記しておきます。

A360：http://help.autodesk.com/view/ADSK360/JPN/

Fusion Team：http://help.autodesk.com/view/FSNT/JPN/

BIM 360 Team：http://help.autodesk.com/view/BIM360T/JPN/

BIM 360 Docs：http://help.autodesk.com/view/BIM360D/JPN/

By Toshiaki Isezaki

投稿情報: 2019/01/28 00:03 カテゴリー: クラウドサービス | 個別ページ | コメント (2)