先に開催された Autodesk University Las Vegas の会期 2 日目の午後にあった Product Design & Manufacturing Keynote 内で、ジェネレーティブ デ ザイン事例として、日本の WHILL 株式会社が紹介されていました、その様子を録画した動画が YouTube で公開されていますのでお知らせしておきたいと思います。
WHILL 社の内容は、52:43 あたりからで、例によって、YouTube の日本語字幕もご利用いただけます。動画全体と合わせて、ぜひ、ご参照ください。
ジェネレーティブデザインは、製造業だけでなく様々な業界・業種で活用が見込まれる最先端の機能として、さまざまなお客様に幅広く関心をいただいています。
この度、 WHILL 株式会社様をお迎えして、オンラインセミナーを開催する運びとなりました。
オンランセミナーの詳細は こちら をご確認ください。ご興味のある方はぜひご参加ください。
By Toshiaki Isezaki
|
|
|
AutoCAD 2019 for Mac、AutoCAD LT 2019 for Mac のリリースにともない、両製品の日本語版がリリースされました。米国では AutoCAD 2011 から Mac 版が AutoCAD for Mac の名で販売されていましたが、今回のリリースまで日本語化は見送られていました。近年になって Mac 自体が一定の支持を集めていることもあり、以前、コンソール バージョンの AutoCAD でご紹介したマルチプラットフォーム化の改修を経て、今回のリリースとなっています。
Mac OS にネイティブ対応する日本語版 AutoCAD は、マルチプラットフォームを標ぼうしていた AutoCAD R12 以来のリリースとなります。当時、ビジネス用途で Windows が主流になりつつあり、残念ながら、Macintosh（当時）版の AutoCAD はあまり話題になりませんでした。その後、オブジェクト指向な開発でソースコードの一新を図った AutoCAD R13 で開発を Windows に一本化したため、17~18 年ぶりの日本語版の登場です。
今回リリースされた AutoCAD 2019 for Mac、AutoCAD LT 2019 for Mac は基本的に Windows 版で実現している機能を踏襲していますが、Mac の特化している機能があったり、Windows 版で利用可能な機能が使えなかったりするものも存在します。今回は、おおまかにそれら内容について触れておきたいと思います。
AutoCAD 2019 for Mac の動作環境
まずは動作環境です。AutoCAD 2019 for Mac の場合、次のようになっています。
オペレーティングシステム
Apple® Mac® macOS v10.14 以降(Mojave)、v10.13 以降(High Sierra)、macOS v10.12 以降(Sierra)
モデル
Apple Mac Pro® 4.1 以降、MacBook® Pro 5.1 以降、iMac® 8.1 以降、Mac Mini® 3.1 以降、MacBook Air® 2.1 以降、MacBook 5.1 以降
CPU タイプ
64 ビット Intel CPU (Intel Core Duo CPU、2 GHz 以上推奨)
メモリ
3 GB の RAM (4 GB 以上を推奨)
ディスプレイ解像度
True Color 対応 1,280 × 800 ディスプレイ(Retina ディスプレイ搭載の 2880 x 1800 推奨)
ディスク空き容量
ダウンロードおよびインストール用に 3 GB のディスク空き容量
ポインティングデバイス
Apple® Mouse、Apple Magic Mouse、Magic Trackpad、MacBook® ProTrackpad、または MS 互換マウス
プリンタ
Mac OS X 互換プリンタ
ユーザインタフェース
Windows 版の AutoCAD や AutoCAD LT には、もっとも頻繁に利用するユーザ インタフェースとして、リボン インタフェースがあります。このリボン インタフェースや一部のインタフェースは、Microsoft 社が .NET Framework として提供している機能を利用している関係で、Mac では利用することが出来ません。Mac OS 上で動作するソフトウェアでは、Windows とは異なるユーザ インタフェース文化が存在するため、AutoCAD/LT for Mac も、その文化を踏襲するかたちで、次のような分類のユーザ インタフェースを用意しています。
もし、探しているコマンドが見つけられない場合は、[ヘルプ] メニューから検索ボックスにキーワードを入力してリターンキーを押してみてください。例えば、"ブロック" と入力すると、該当する候補がリスト提示されるので、希望する項目をマウス カーソルでポイントすると、コマンドが割り当てられたメニュー項目がアニメーションとともに矢印表示されます。コマンドがプルダウンメニューに割り当てられている場合には、この操作で簡単に該当するメニューを見出すことが出来ます。
ユーザ インタフェースの色合いを変えるカラーテーマも利用することが出来ます。お好みに応じて、[アプリケーション基本設定] ダイアログからダークテーマとライトテーマを切り替えることが出来ます。
カラーテーマ以外にも、ユーザ インタフェースもカスタマイズすることが出来ます。詳細は、オンラインヘルプから 概要 - Mac OS でのユーザ インタフェースのカスタマイズ を参照してみてください。
なお、Mac 版には Language Pack を後から導入するオプションがありません。製品のユーザ インタフェースで利用する言語は、あらかじめインストーラに組み込まれているので、製品の起動後に [アプリケーション基本設定] ダイアログで変更することになります。ここで選択可能な言語は、英語、フランス語、ドイツ語と日本語の 4 種類です。言語設定を変更した場合には、新しい設定を有効にするために AutoCAD の再起動が必要になります。
ユーザ インタフェースの言語切り替えとは別に注意していただきたいのは、文字スタイルやマルチ テキスト エディタで指定する日本語フォントの選択についてです。Mac 上で動作するソフトウェア/アプリケーションでは、一般的にフォント選択の際に日本語フォントが日本語表記で表示されます。例えば、Microsoft Office 365 for Mac に含まれる PowerPoint では、次のように表示されます。
AutoCAD/LT for Mac では、いまのところ、日本語フォントも英語表記で表示されてしまいます。これは、日本語記入出来ないということではありません。この例では、PowerPoint で ヒラギノ角ゴ～ として表示されているフォント名が Hiragino Kaku Gothic～ と表示されてしまいます。
Mac 版固有の機能も存在します。最も目新しい機能には、2016年以降に販売が開始された MacBook Pro に搭載されている Touch Bar があります。Touch Bar は従来のファンクションキーに代わるもので、ソフトウェア/アプリケーションによって割り当てれた機能を、視覚的に表示する有機 EL を使ったボタン提供させるユーザインタフェースです。 AutoCAD/LT では、この割り当てを [表示] メニューの [Touch Bar をカスタイズ...] メニューから変更することが出来ます。
Touch Bar には指紋認証をおこなう Touch ID も搭載されているので、Mac 上にソフトウェア/アプリケーションをインストールする際に、毎回システム パスワードを入力する手間が省くことも出来ます。
互換性
Mac 版も AutoCAD/AutoCAD LT が保存するのは DWG ファイル形式の図面に変わりありません。DWG ファイル形式に Windows 版と Mac 版の差はありませんので、Mac 版で保存した 2D 図面や 3D モデルも Windows 版で開くことが出来ます。もちろん、その逆も可能です。AutoCAD 2019/AutoCAD LT 2019 for Mac で開くことが出来る図面ファイル形式と保存することが出来る図面ファイル形式（DWG、DXF）は、Windows 版と同じです。
Mac 版では Windows 版のようにワークスペース機能がないため、その切り替えによって表示するユーザ インタフェースを変化させることが出来ません。ただ、機能分類的には、ほぼ同じ機能をユーザ インタフェースに実装しているはずです。モデリング機能や他の 3D 機能は、[モデリング] ツールセット タブをクリックして、ツールセットをアクティブにして利用することが可能です。3D 機能の中には、ジオメトリへのマテリアルの適用や光源の作成も含まれるわけですが、残念ながら、RapitRT レンダリング エンジンを用いた製品内レンダリングの機能は実装されていません。レンダリング画像を得るには、サブスクリプション契約から入可出来る Windows 版 AutoCAD を Windows 上で用いるか、クラウド レンダリング（https://gallery.autodesk.com/a360rendering）を利用する必要があります。
Mac 版には業種別ツールセットの用意がありませんので、Windows 版 AutoCAD で業種別ツールセットを導入して固有のカスタム オブジェクトを記入した DWG ファイルは、Mac 版で編集することが出来ません。
API
AutoCAD for Mac では、AutoLISP と ObjectARX のみがサポートされています。Windows 固有の COM（Component Object Model）を利用した ActiveX オートメーション、別名 COM API や .NET Framework を利用した AutoCAD .NET API は利用出来ません。
Windows 版でよく利用されている VBA は COM API を利用しているため、残念ながら、Mac 版で利用することは出来ません。同様に、AutoLISP の場合、Visual LISP として導入され、COM を間接的に利用している (vla-XXX) や (vlax-XXX) 関数、(vlr-XXX) 関数も利用することは出来ません。
ObjectARX を利用する場合には、https://www.autodesk.com/developer-network/platform-technologies/autocad/objectarx-license-download から AutoCAD 2019 Mac OS ObjectARX SDK をダウンロード、利用してアプリケーションをビルドする必要があります。必要な開発環境は次のとおりです。
For 64-bit ObjectARX 2019 for Mac®
※ ObjectARX アプリケーションをビルドするには Apple 社が提供する Xcode 統合開発環境がの旧バージョン 9.3 が必要です。旧バージョンの入手には Apple Develoer Center に Apple ID を使ってサインインする必要があります。
AutoCAD for Mac には、Windows 版に同梱されている AcCoreConsole.exe に相当する実行形式は提供されていません。AutoCAD LT for Mac の場合には、 Windows 版 AutoCAD LT と同様に、API を使ってカスタマイズしたり、API を使ってカスタマイズされたモジュールをロードして利用することは出来ません。
AutoCAD for Mac は AutoCAD をサブスクリプション契約していると、AutoCAD LT for Mac は AutoCAD LT をサブスクリプション契約していると、それぞれ Autodesk Accounts ページ（https://accounts.autodesk.com/）からダウンロードしてインストールすることが出来ます。
AutoCAD 2019 for Mac、AutoCAD LT 2019 for Mac は、One AutoCAD として日本語環境に新たに加わった製品です、Mac をお持ちであれば、ぜひ、試してみてください。
By Toshiaki Isezaki
|
|
|
Forge DevCon Las Vegas 2018 キーノートの様子を録画した動画が YouTube で公開されています。Autodesk University キーノートと同様に、YouTube 側の自動翻訳で字幕を表示する設定も可能です。一旦、「英語（自動生成）」を選択すると「日本語」が選択出来るようになります。
Forge が「鍛造」と訳されたりしますが、まずは、内容をご確認いただければ幸いです。
By Toshiaki Isezaki
|
|
|
Forge DevCon Las Vegas 2018 では、FDC227961 - Building for the Future: Forge Road Map 等のセッションで、昨年同様、現在開発中で今後のリリースを予定している Forge Platform API の発表がありました。アナウンスされたすべての API のリリースが確定している訳ではありませんが、ご参考まで、ここ最近に加えられた既存 API への機能追加も含めて、概略のみご紹介しておきます。
まず、既存 API に最近加えられた機能、あるいは、改善された機能です。既に Forge ポータル上のドキュメント（Change Log）に記載のあるものについては、項目名にリンクをしていますのでジャンプして詳細をご確認ください。
BIM 360 API
Viewer（Forge Viewer JavaScript API）
Model Derivative API
WebHooks API
次にご紹介するのは、現在開発中、リリースを予定している API 概要です。まず、昨年のロードマップで示されていた Design Automation API のアップデートです。
Design Automation API
現在、クラウド上の AutoCAD コアエンジのみをサポートしている Design Automation API（V2） ですが、AutoCAD の他に Inventor、Revit、3ds Max を加えた V3（バージョン3）が Public Beta となります。残念ながら、Revit（Design Automation API for Revit）のみ、Public Beta 化が 2019年1月28日（米国太平洋標準時）に設定されていますので、その点ご注意ください。Public Beta として利用可能な Design Automation API for AutiCAD、同 Inventor、同 3ds Max については、Forge ポータル上でドキュメントが公開されています。当該ページは、https://forge.autodesk.com/en/docs/design-automation/v3/developers_guide/overview/ となります。
Reality Capture API
撮影した複数の写真から、3D メッシュ、点群、オルソ画像などを演算生成する Reality Capture API について、現在、最も多く利用されている建設プロジェクトの進捗管理用途でのチューニングを進めています。具体的には、生成された点群データでも 、より明瞭に変化を把握、指摘出来るよう、点群データ生成の見直しをおこなっています。（Forge Viewer での点群表示は、引き続きサポートされていません。）
Data at the Center
Forge DevCon Las Vegas 2018 アップデート のブログ記事でご案内した点のついて、HFDM と LFDM（ファイル）を融合させると同時に、クラウドを効果的に利用してデータを管理するコンセプトの概要説明がありました。アプリケーションありきはなく、データありきでアプリケーションが従属していくような新しいコンセプトです。現在、Data at the Center を実現するいくつかの API/SDK が開発途上にあります。
残念ながら、DevCon 当日にあった当該クラス セッション、SD256005 - The Future of Data: Forge Data Platform や The Future of Workflow Forge Workflow Automation は当日の収録動画、配布資料（ダウンロード資料）とも用意されていませんが、今後、Cloud Accelerator イベントなどを通じて、評価の機会が得られることを期待しています。
最後に余談となってしまいますが、Forge DevCon Las Vegas、Autodesk University Las Vegas の開催に先だって、Forge ポータル（https://forge.autodesk.com/）もレイアウトやデザインが変更されています。これに伴い、Forge Platform API の各種アイコンも再デザインされています。新しい API の登場と勘違いのなきよう、こちらも、ご注意ください。従来、区別がつきにくかった Data Management API と Design Automation API も差が分かりやすくなっています。
By Toshiaki Isezaki
|
|
|
Autodesk University Las Vegas 2018 も今日で 3 日間の会期を終えようとしています。ここでは、この 3 日で感じられた Forge の立ち位置 についてレポートしておきたいと思います。
まず、11 月 13 日初日には General Keynote が、続いて 14 日には、午前に建設業向けに Architecture Engineering And Construction Keynote が、午後には製造業向けに Manufacturing And Product Design Keynote が開催されています。
これらの Keynote（基調講演）で伝えられたメッセージを簡単にまとめると「Automation（自動化）」になるかと思います。ちなみに、Autodesk University に 1 日先立って開催が始まった Forge DevCon Las Vegas のメッセージは、先のブログ記事 Forge DevCon Las Vegas 2018 アップデート でお伝えしたように「Data at the Center」でした。
実は、昨年の Autodesk University の General Keynote でも「Automation（自動化）」がキーワードとして挙げられています。各過程をシームレスに高度に連携させるには、議論対象のデータを中心となるクラウドに置いて、生産性向上のための自動化につなげていこう、という考えです。
Forge が基盤技術/プラットフォーム テクノロジであることを考えると、オートデスクが現在、引き続き目指すところは、設計/デザインから施工/製造の過程において、設計者、エンジニア、製造業者をシームレスにつなぐ高度な「Automation（自動化）」であり、それを実現するのが、クラウドの利用と、クラウド上のデータ プラットフォームを提供する Forge の「Data at the Center」であると捉えることが出来ます。
Automation/自動化の具体例については、既に YouTube で公開されている 動画 を参照してみてください。 少子高齢化でも生産性向上を成し遂げている事例として、日本の大和ハウス工業株式会社が取り上げられていて、とても興味深く見ることが出来ます。
なお、今回の動画は YouTube 上で公開されているので、YouTube 側の設定を変更すれば日本語字幕を表示させることが出来ます。試してみてください。妙な翻訳になってしまう場面もありますが、大筋で内容は把握いただけるものと思います。大和ハウス工業の自動化に言及が及ぶのは、48:50 を過ぎたあたりです。
印象的だったのは、Autodesk University の 3 つの Keynote のうち、どの Keynote でも、繰り返し Forge が取り上げられていた点です。
もともと、Forge はオートデスクのクラウド サービスを開発する過程で生まれた機能を、機能別に Web サービス API として公開したものです（下図左）。この状態から、今後、Data at the Center を実現する HFDM を含む各種 SDK を先に開発し、オートデスク製品に活かしていこう（下図右）、という方向に Forge の立場が変わりつつあることがわかります。
Data at the Center の素材としての Forge はまだ開発途中であるため、今回は大々的に喧伝されませんでしたが、General Keynote でも登壇し、HFDM の早期評価デベロッパである Atkins 社が AS229879 - Sketch to feasability via HFDM クラスで Data at the Center を実現する Forge App Framewok SDK について言及していました。これらを詳細にご案内できるには、もう少し時間がかかるようです。
視点は変わりますが、Autodesk University の展示会場 EXPO でも、今年は数多くの "Forge" を見ることが出来ました。Forge System Integrator 各社のブースや、System Integrator にはなっていないものの、ISV として Forge を使ったソリューションを提供している企業のブースです。
こちらは既存の Forge を使ったアプリケーション/ソリューションの展示ですが、BIM 360 との統合など、Forge がオートデスクのクラウド サービスとの連携カスタマイズのプラットフォームである点が認知され始めている証と思います。
By Toshiaki Isezaki
|
|
|
米国太平洋標準時間の 11 月 12 日（日本標準時間 11 月 13 日）、Las Vegas で 2 日間の会期予定で開催される Forge DevCon 2018 の初日を迎え、キーボート及びブレイクアウト セッションが実施されました。あと 1 日会期を残していますが、今回の DevCon でキーとなった点についてご案内しておきたいと思います。なお、キーノートの事前登録数は 1,100 名で、同じく日本からの事前登録数は 40 名でした。
キーノートでは、従来のデスクトップ製品間で起こりがちだったデザイン ファイルを使ったデータ交換について、問題の核心がデータがアプリケーションの機能ありきだった点が改めて指摘されました。具体的には、データ ファイル形式がアプリケーションの機能によってアプリケーション毎に定義されてしまい、それらの各種データ ファイル形式を使ったデータ交換機能も、各アプリケーションの実装に委ねられてしまっていた、という点です。これによって、あたかもアプリケーション間に壁が存在するような印象があったことも否めません。
これらに壁を取り除くソリューションとして説明されたキーワードが Data at the Center です。Data at the Center は、従来のアプリケーション機能で成り立っていた「点から点」のデータ交換ではなく、すべてのデータをクラウド上に初めから保存し、必要なデータをやり取りする形を採用する方法です。
実は、このコンセプトは一昨年の Forge DevCon 2016 で初めて紹介されて、着々と開発を進めてきた HFDM のコンセプトに他なりません。ただし、純粋な HFDM データに加え、従来のデザイン ファイル データ形式も同等に扱えるように改良を加えた点が異なります。重要なのは、アプリケーションありきのデータ ファイル形式（あるいはデータ交換機能）ではなく、データありきのアプリケーション開発へ、オートデスクの開発方針が転換されたものと考られる点です。今日の設計/デザイン作業が、まだデスクトップ製品（アプリケーション）と、そのデータ作成で成立していることを考えれば、妥当な方針転換とも言えるはずです。
今回の Data at the Center コンセプトの採用によって、3rd party の開発者の皆様への Forge API （Forge Data Platform）提供に遅れが出ることになってしまうかと思いますが、クラウドを真に利用し、かつ、実用性を兼ね備えた API が今後登場することが期待されます。別の言い方をすれば、Forge を使って HFDM を採用する Web アプリケーションだけでなく、従来のデスクトップ製品も、クラウドを使った Data at the Center コンセプトを採用することが示唆されたとも考えられます。
話題は変わりますが、今回は Forge Village と題した展示エリアが Forge DevCon の開催フロアで用意され、Forge System Integrator 各社をはじめ、Forge ISV 等のパートナー企業による展示がおこなわれました。日本からは、応用技術株式会社にブース展示をいただき、多くのお客様や日本でのパートナーをお探しの企業の方々にお越しいただきました。
Autodesk University のオープン前で Forge DevCon 初日のみの展示エリアという位置づけですが、Forge を目指してご来場いただく方がほとんどなので、効果的な出会いの場になったのではないかと思います。
また、Forge Village の AR|VR Village コーナーでは 、日本から参加された株式会社ホロラボ の HoloLens アプリ「AR CAD Viewer」をデモ展示いただきました。
By Toshiaki Isezaki
|
|
|
東京オリンピックの開催決定を機に、BIM を採用/利用していこうとする動きが加速しているように思います。オートデスクで BIM と言えば Revit となるわけですが、そんな背景からか、Autodesk Developer Network（ADN） への Revit APIのお問合せが増加する傾向にあります。また、Revit を導入して運用を始めてみたものの、既存システムと併用する必要から手間が増えて効率化を模索中の方、定型処理を自動化する方法を見極めたい方、Revit API を調査、活用しようとされる方等、多いのではないかと思います。
そこで、Revit API の基礎から応用まで広くカバーし、かつ、よくあるお問合せから抽出した内容をご紹介して、Revit API についての理解を深めていただく機会として、久しぶりに Revit API をテーマにした無償セミナーを開催することになりました。
下記に開催概要と、ご紹介する内容、お申込み方法をご案内いたしますので、奮ってご参加いただければと思います。
なお、応募は定員になり次第締め切らせていただきますので、予めご了承ください。
日時/場所：
東京 12月11日（火）13:00～17:10
オートデスク 東京本社 セミナールーム （定員 100 名）
東京都中央区晴海 1－8－10 トリトンスクウェアオフィスタワーX 24F
大阪12月14日（金） 13:00～17:10
オートデスク 大阪営業所 セミナールーム （定員 40 名）
大阪府大阪市淀川区宮原3-5-36 新大阪トラストタワー 3F
参加費：
無料（事前登録制）
Revit カスタマイズの種類や選択肢、Revit と Revit API の関係を解説後、Visual Studio 2017 を利用した Revit アドインの作成手順から、Revit 上に配置したボタンからアドインに実装した機能を呼び出す部分までを実際のデモを交えてご紹介します。
14:00～14:15 <休憩>
14:15～15:10 Revit データの理解 － 小笠原
Revit API を効率的に利用する上では、Revit の持つデータ構造を理解することが重要です。このセッションでは、Revit が持つファミリの種類や Revit API 上の名称などを整理し、各要素の情報を参照する Lookup Tool （ルックアップツール）とその利用方法をご案内します。
15:10～15:20 <休憩>
15:20～16:20 Revit アドイン応用 ～ 具体例 － 小笠原
Revit アドインを開発していく際に陥りがちなケースや勘違いしやすいケースに触れ、その回避策と具体的な実装についてご案内します。
16:20～16:30 <休憩>
16:30～17:10 Autodesk App ストアの利用とアドイン公開 － 伊勢崎
Autodesk App ストアには、オートデスクのデスクトップ製品用に開発されたアドイン アプリケーションが体験版/無償版/有償版を交え多数公開されています。また、どなたでも無償で開発したアドイン アプリケーションを公開することも出来ます。ここでは、公開されているアドインの導入方法や配布方法に加え、ご自身で開発したアドインの公開方法をご紹介します。
お申込方法：
以下の情報をご記入の上、メールにてお申し込みください。
宛 先： adn@myautodesk.jp （ADN 事務局）
件 名： 「Revit API＆BIM セミナー 参加申し込み」
本 文：（参加人数を把握するため、次の順序でご記入ください）
ADN ID（ADN に加入されている場合のみ）：
会場：東京・大阪（いずれを明記）
会社名：
部署：
役職：
ご参加者氏名とフリガナ：
E-mail アドレス：
電話番号：
By Toshiaki Isezaki
|
|
|
Forge DevCon Las Vegas の開催が間近になってきました。参加登録された方は、既にご希望のセッション クラスを登録されているかと思いますが、内容別にお勧めセッションをまとめておきたいと思います。
まずは、Forge の基本的な内容や利点、将来のロードマップなどをご紹介する Forge Basic のクラス群です。
建設業向けに利用されることが多い Forge ですが、建設・建築専用といわけではなく、もちろろん、製造業向けにも利用することができます。ここでは製造業向けに用意されたクラスをご紹介します。
一歩先を行く、先端的な Forge の応用という観点で、次のクラスは興味深い示唆を提供するはずです。
Forge DevCon だけではなく、AU のクラスでも Forge が題材になっているものが多数あります。下記は、その代表的なものです。
既に満席表示になっているものがあるかと思いますが、当日、空きがあれば当日受講することは可能かと思います。ぜひ、チャレンジされることをお勧めします。
By Toshiaki Isezaki
|
|
|
先日のブログ記事 Web ブラウザのデベロッパーツールについて で少し触れたこともあるので、今回は Forge を利用する上で重要になる Access Token について、まとめておきたいと思います。
Access Token は、Forge に限らず、Web 開発の世界では一般的なもので、アプリが サーバー（クラウド）上にあるリソースにアクセスする権限があるかチェックする仕組みを提供します。Forge の場合、2-legged、3-legged の違いを考えずに単純に考えると、下図のアニメーションのようになります。
先に触れたブログ記事 Web ブラウザのデベロッパーツールについて のとおり、セキュリティ上の理由から、クライアント（Web ブラウザ）の JavaScript コードから Authentication API の endpoint を呼び出すと、CORS エラーが発生して Access Token を取得することは出来ません（Access-Control-Allow-Origin: * などを返さない） 。このため、Authentication API はサーバー実装でおこなうことになります。
Authentication API によって返されるのは、Access Token を含む JSON です。
{
"access_token": "eyJhbGciOiJIUzI1NiIsImtpZCI6Imp3dF9zeW1tZXRyaWNfa2V5In0.eyJjbGllbnRfaWQiOiJ1MzZUa2lhQVpmUnRJa2p0S2ZzR0FtdXo2NEJNenZmdyIsImV4cCI6MTU0MTEzNDg0MSwic2NvcGUiOlsiYnVja2V0OmNyZWF0ZSIsImJ1Y2tldDpyZWFkIiwiZGF0YTpyZWFkIiwiZGF0YTp3cml0ZSIsImRhdGE6Y3JlYXRlIl0sImF1ZCI6Imh0dHBzOi8vYXV0b2Rlc2suY29tL2F1ZC9qd3RleHA2MCIsImp0aSI6InBvSkhpVlBMeFp6NG1wQkxSbG5raUpiQWpHN1BEeXpBa1M4ZElBZVV1TDZSdkcyUUprUTZTQ0JJOW9rSVJNMk8ifQ.Fr4lUU21AfbDcIRBvMWlOXtxd0zjd9E7Tj2V6w6pp8U",
"token_type": "Bearer",
"expires_in": 3599
}
実際の Access Token となる文字列は JSON 内に含まれる "access_token" キーの値として格納されています。また、"token_type" は、Forge で扱う Token のタイプである Bearer（ベアラ）を示しています。なお、Forge で利用する Access Token には、有効期限が設定されています。有効期限を示すのが "expires_in" キーの値として格納されている秒数を表す数字です。
先の JSON 例では、Accesss Token が eyJhbGciOiJIUzI1NiIsImtpZCI6Imp3dF9zeW1tZXRyaWNfa2V5In0.eyJjbGllbnRfaWQiOiJ1MzZUa2lhQVpmUnRJa2p0S2ZzR0FtdXo2NEJNenZmdyIsImV4cCI6MTU0MTEzNDg0MSwic2NvcGUiOlsiYnVja2V0OmNyZWF0ZSIsImJ1Y2tldDpyZWFkIiwiZGF0YTpyZWFkIiwiZGF0YTp3cml0ZSIsImRhdGE6Y3JlYXRlIl0sImF1ZCI6Imh0dHBzOi8vYXV0b2Rlc2suY29tL2F1ZC9qd3RleHA2MCIsImp0aSI6InBvSkhpVlBMeFp6NG1wQkxSbG5raUpiQWpHN1BEeXpBa1M4ZElBZVV1TDZSdkcyUUprUTZTQ0JJOW9rSVJNMk8ifQ.Fr4lUU21AfbDcIRBvMWlOXtxd0zjd9E7Tj2V6w6pp8U、有効期限が 3599 秒（約 60 分）ということになります。
取得した Access Token は、Forge の RESTful API を呼び出す際に、Header（ヘッダー）に指定して endpoint を呼び出すことで、リソースへのアクセス権を行使することが出来ます。もし、この Access Token の有効期限を過ぎてしまった際には、endpoint の呼び出しに失敗することになります。その場合には、再度 Access Token を取得しなおす必要があります（3-legged の場合は RefreshToken リクエストで Access Token を更新します）。
次のアニメーションは、2-legged OAuth を使って Bucket を作成、デザイン ファイルを当該 Bucket にアップロード後に変換し、Viewer に表示する過程を Access Token を明記したイメージです。
余談となりますが、オートデスクは Access Token のタイプを過去に 1 度変更しています。詳細は Access Token タイプの変更について の記事に譲りますが、Access Token の長さが最大 500 桁に及ぶ場合がある点に注意してください。Forge 登場後、しばらくの間、View and Data API から引き継いだ Reference Token タイプを採用していましたが、この頃、Access Token は比較的短い文字列として扱うことが出来ました。現在の JSON Web Token (JWT) タイプでは Access Token が可変長となるため、変数等に格納してプログラムで利用する際には、文字列領域の確保に配慮する必要があります。
Accesss Token については、もう 1 つ、Forge 登場後に変更を受けた点にがあります。Scope 指定なしで Access Token を利用している方へ でもご案内していますが、Access Token 発行時にアクセスレベルを指定する Scope です。Scope は、Forge を利用するアプリに対し、Forge サーバー（クラウド）側のリソース アクセスに必要な権限を与えるか否かを指定するもので、Authentication API 呼び出し時に次の文字列を使って指定します。十分な Scope を指定せずに Access Token を取得した場合、 その Access Token を指定した endpoint 呼び出しに失敗する可能性があります。
例えば、上図の例で Bucket を新規に作成してデザイン ファイルをアップロードするシナリオをご案内しました。この場面で、Bucket を作成するための POST buckets endpointの呼び出す時に、bucket:create を Scope 指定せずに取得した Access Token を与えてしまうと、401 UNAUTHORIZED のエラーコードとともに呼び出しに失敗することになります。
各 endpoint の API リファレンスには、当該 endpoint 呼び出しに必要な Scope が記載されているので、あらかじめ必要となる Scope 値を把握することが出来るはずです。
なお、取得した Access Token で異なる endpoint を呼び出す必要がある場合には、Scope 文字列を半角スペースで区切って、複数の Scope 文字列を指定することも可能です（例："bucket:create bucket:read data:read data:write data:create"）。
逆に、不要な Scope を指定してしまうと、取得した Access Token を悪用される危険性がある点にご注意ください。クライアント（Web ブラウザ）上で Forge Viewer を使って 3D モデルや 2D 図面を表示するだけなら、viewables:read の Scope で十分なはずです。この場面で不要な data:write を指定してしまと、Access Token が悪意のあるマルウェアなどに読み取られた場合、クラウド上のストレージにアクセスされてデータを書き換えられたり、削除されたりしてしまう可能性があります。
By Toshiaki Isezaki
|
|
|
ご存知のとおり、ADN/Forge チームは、これまで、ADN オープンのもとに複数の開発系のブログ サイトを運営してきました。
日本でも Autodesk Perspective from Japan の名前で本ブログ サイトを運用しています。
これらブログ サイトは、長らくTypedpad ブログ プラットフォームを利用してきましたが、今回、このプラットフォームを Wordpress を利用するオートデスク プラットフォームに移行することが決定され、2019年から運用を開始する予定で計画を進めています。従来の Typedpad ブログ プラットフォームで作成、公開済のブログ記事は、引き続き、参照し続けることが出来るようにする予定です。
新しいサイトの URL は、まだ、決まっていませんが、https://blogs.autodesk.com のフィリフックスを持つ URL になる予定です。詳細が決まりましたら、別途、ADN オープンの Facebook サイト（https://www.facebook.com/adn.open.japan）や本ブログ（https://adndevblog.typepad.com/technology_perspective/）でご案内する予定です。
By Toshiaki Isezaki
|
|
|
Subscribe