Technology Perspective from Japan

Autodesk Platform Services の始め方

Autodesk Platform Services（以下、APS）は、オートデスクが提供する Web API（Web サービス API）セットです。API エコノミーに参画すべく、オートデスクが注力するデザイン データの活用を主眼とした複数の API を提供しています。 API セットは、Authentication API、Data Management API、Webhooks API、Viewer などの無償 API に加え、課金対象（有償）の Model Derivayive API、Design Automation API、Reality Capture API で構成されています。有償 API の場合、API の使用量に応じて課金する従量課金制を採用しています。 APS を評価するにあたって、事前に契約や申請、購入、あるいは、クレジットカードの登録等をする必要はありません。初めてAPS を利用する場合には、90 日間の無償ライアルを活用することが出来ます。 APS API を利用するアプリの登録とキーの取得 の手順で開発に必要なデベロッパーキーを取得（アプリの登録）をお... Read more →

APS VS Code Extension

VS Code 用に用意されていた Autodesk Forge Tools Extension （エクステンション）が、Forge の名称変更とともに更新されています。新しい名称は Autodesk Platform Services VSCode Extension で、従来と同じ URL https://marketplace.visualstudio.com/items?itemName=petrbroz.vscode-forge-tools からインスールすることが出来ます。 機能的には同じなので、もし、旧 Autodesk Forge Tools をご存じない場合には、次のブログ記事に目を通してみてください。 Visual Studio Code での Forge 開発 VS Code Forge Extension を使った Viewer ワークフローの確認 VS Code Forge Tools での環境変更 VS Code Forge Tools での 3-legged OAuth Design Automation API：VS Code を使った WorkItem... Read more →

Design Automation API：adskDebug オプション

Design Automation API を利用したタスクの実行単位を WorkItem と呼んでいます。WorkItem の実行時には、タスクを処理するための仮想環境がクラウドに動的に作成されて、WorkIem の実行終了とともに破棄されます。 なんらかの要因で WorkItem の実行が失敗してしまった場合、GET workitems/:id エンドポイントで得られる JSON レスポンスや、同レスポンスにあるレポートログ（report.txt）の URL を取得、ダウンロードして原因を特定していくのが一般的です。 ただ、レポートログの参照のみでは、仮想環境上で使用、あるいは、生成/編集されたファイルを物理的に入手して調べることが出来ません。WorkItem が使用したファイルを入手出来れば、内容を解析する手助けにもなります。 このような場面では、昨年追加された adskDebug オプションを使用することが出来ます。 WorkItem 呼び出し時に POST workitems エンドポイントのリクエストボディ（ JSON ペイロード）に次のように指定すると、WorkIem 実... Read more →

Viewer の「一人称視点ツール」

APS Viewer（旧 Forge Viewer）と APS Viewer を利用した Autodesk Viewer、BIM 360 Viewer などでは、さまざまな標準ツールが用意されています。その中には、APS Viewer：スクリーンキャプチャ で少し触れた「一人称ツール」があります。 一人称ツールを利用すると、キーボードやマウス操作を利用して、カンバスに表示中の 3D モデル内をウォークスルーしたり、周囲を見回したり、上下に移動したりするなど、自由に視点を変更することが出来ます。 ツールバーから一人称ツールのボタンをクリックして起動すると、操作可能なキーボード操作が画面に表示されます。 表示中の視点で [↑] キーを押し続けると、画面に表示される ✛ カーソルに向かってウォークスルーが始まります。[←] キーと [→] キーで左右に進行方向を変えたり、[↓] キーで後退することも出来ます。 ウォークスルー中に視点が上下に移動してしまったり、[Q] キーや [E] キーで始点を上下に移動しようとしても元に戻ってしまう現象が出る場合には、「設定ツール」で [ナビゲーション] ... Read more →

Design Automation API：アクティブ トランザクションの影響

AutoCAD Mechanical には他の AutoCAD ベースの業種別ツールセットにはないアクティブ トランザクション機構が存在します。Design Automation API for AutoCAD を利用する際にも、扱う図面によっては、このアクティブ トランザクションの影響を受けるケースがあります。Design Automation API for AutoCAD の処理対象図面に AutoCAD Mechanical オブジェクトが存在する場合です。 Design Automation API for AutoCAD とオブジェクト イネーブラ でご紹介したとおり、Design Automation API for AutoCAD 環境には AutoCAD Mechanical 用のオブジェクト イネーブラが用意されているので、WorkItem 実行時に図面に AutoCAD Mechanical オブジェクトを検出すると、同オブジェクト イネーブラがロードされるようになります。 AutoCAD Mechanical 用のオブジェクト イネーブラがロードされると、この時... Read more →

Flex トークンと課金対象者

APS アプリの作成時、アプリが APS クラウド リソースにアクセスする認証を得るために、APS API を利用するアプリの登録とキーの取得 の手順で Client ID と Client Secret から成る「デベロッパーキー」を取得する必要があります。 デベロッパーキーは、1 つのアカウントで複数個、取得することが出来ます。言い換えれば、アプリ毎に異なる Client ID と Client Secret の組み合わせを使用することが可能です。 アカウントが複数のデベロッパーキーを別々のアプリで使用すると、Usage Analytics ページ：Flex トークン残高と消費量の確認 でご案内した方法を使って、アプリ毎に消費した Flex トークン数を把握することが出来ます。 逆に、別々のアプリで 1 つのデベロッパー（ 1 組の Client ID と Client Secret のペア）を利用することも出来ます。ただし、この場合、消費トークンをアプリ毎に把握することは出来なくなります。 いずれの場合でも、APS API の課金対象者となる方は、デベロッパーキーを取得したアカウ... Read more →

AutoCAD Mechanical のアクティブ トランザクション

AutoCAD .NET API で開いた図面上で新規にオブジェクトを作成したり、既存のオブジェクトを編集したりする際、トランザクション マネージャを利用して対象オブジェクトをオープン（既存オブジェクト編集時のみ）、編集、コミットの手順を踏んで処理します。作成/編集されたオブジェクトは、コミットの時点で編集内容が図面上に反映されます。 一方、AutoCAD Mechanical 上で同様の処理をおこなう場合、AutoCAD Mechanical 固有の アクティブ トランザクション（Active Transaction）という機構が有効になり、標準のトランザクションをラップする動作をします。言い方を変えるなら、AutoCAD Mechanical 側で最上位となるトランザクションを持つため、アドインが対象オブジェクトを編集するために用意したトランザクションは、この時点でネストされた状態になってしまいます。 この状態は、TransactionManager.TopTransaction プロパティで知ることが出来ます。 [CommandMethod("MyCommand", Comman... Read more →

Model Derivative API：DWG・RVT の 2D 変換時オプション

Model Derivative API：DWG 変換の最適化による変更について でご案内のとおり、DWG ファイルを Viewer 表示する際の 2D View >> SVF/SVF2 変換について、Model Derivative API の POST job エンドポイントに新しい変換オプションが追加されています。 2D View を SmartPDF 化して変換するか否かは、advanced オプションに新設された 2dviews フィールドで指定することが出来ます。この値に ”pdf” を指定すると、2D View が SmartPDF 化して変換され、冗長なプロパティが抽出されなくなります。逆に、2dviews フィールドに "legacy" を指定すると、従来のように、すべてのプロパティが抽出されます。2dviews フィールドを指定しない場合には、"legacy" 指定時と同じくすべてのプロパティが抽出されます。 { "input": { "urn": encodedURN }, "output": { "formats": [ { "type": "svf2", "v... Read more →

Data Exchange API によるデータ交換

頻繁におこなわれる関係者間の設計・デザイン コラボレーションでは、使用する製品やツールが持つ互換性のないファイル形式が障壁になることがあります。業種や製品、ツールを超えて、シームレスにコラボレーションすることが、これまで以上に重要になってきています。そこでオートデスクが登場させたのが Autodesk Platform Services（旧 Forge）のData Exchange API（ベータ）です。Data Exchange を使用すると、アプリや業界を問わず、データのロックを解除し、適切なタイミングで適切な関係者と適切な文脈でデータを共有する柔軟性を得ることができます。「データのロックを解除し」とは、ファイル内の情報を個々に取り出したり、書き込んだりしたり出来るよう、粒状データ化することを意味します。 例えば、Revit で病院を設計している建築事務所が、Inventor で病院の階段の手すりを製造している製作所と、どのようにやり取りするかを考えてみましょう。アーキテクトは、モデルのジオメトリ（例えば、階段の寸法）やメタデータ（例えば、壁の材料特性）などの情報を製作者と共有する... Read more →

APS アプリ作成時のアプリケーション タイプ

APS ポータル（https://aps.autodesk.com/） でアプリを作成してデベロッパーキー（Client Id と Client Secret）を取得する際、必ず Applications ページ（https://aps.autodesk.com/myapps/）を利用することになります。 このアプリ作成時、新しくアプリ タイプを選択すようになりましたので、ご紹介しておきたいと思います。 アプリ タイプの選択は、ページ上部の [+ Create application] をクリックした際に表示されます。 それぞれのアプリ タイプは、次のような用途を想定して用意されます。 Traditional Web App 「Most flexiible」が示すように、これは最も柔軟なオプションで、Forge 世代を含め、過去の作成された全アプリで利用されてきたアプリ タイプです。使用するシナリオに合わせて、2-legged と 3-legged の OAuth をサポートするので、どのタイプを選択すべきか判断出来ない場合には、とりあえず、このタイプを選択することをお薦めします。 T... Read more →