Technology Perspective from Japan

Design Automation API for Revit - CountDelete サンプル

Design Automation API for Revit について、今年の1月28日にパブリックベータ版が公開されてから、下記のブログ記事で、その概要から始まり、 Postman Sample と .NET Core Sample の動作確認の方法、さらには Model Derivative API による SVF 変換と Viewer 表示の機能を追加する方法をご紹介してきました。

下記は、関連するブログ記事のリファレンスとなります。
初めから学習したいという方は、これらの記事をご参照ください。

• Design Automation API for Revit パブリックベータ版の公開
• Design Automation API for Revit 開発手順の理解
• Design Automation API for Revit - Postman Sample のセットアップ
• Design Automation API for Revit - Postman Sample で動作確認 1
• Design Automation API for Revit - Postman Sample で動作確認 2
• Design Automation API for Revit - Learn Autodesk Forge チュートリアル .NET Core Sample のセットアップ
• Design Automation API for Revit - Learn Autodesk Forge チュートリアル .NET Core Sample で動作確認
• Design Automation API for Revit - Learn Autodesk Forge チュートリアル .NET Core Sample の処理結果を Viewer で表示

そして、これらの記事で紹介している内容を、1 Day Workshop という形で学習いただける機会を設けております。
次回は、5月28日（火）東京、5月31日（金） 大阪にて開催いたしますので、ぜひご参加ください。
両日とも5月27日（月）に、申込受付を締め切らせていただきます。

• Forge 1 Day Workshop - Design Automation API for Revit - 開催 - 2019年5月

また、Design Automation API V3 のドキュメントページでは、追加の学習リソースとして、CountDelete サンプルが公開されております。
今回は、このサンプルについてご紹介いたします。

• More Learning Resources
  https://forge.autodesk.com/en/docs/design-automation/v3/tutorials/revit/more-learning-resources/

CountDelete サンプルは、２つの Revit アドインを 1つの Forge アプリケーションで、それぞれ用途に応じて切り替えて実行できるサンプルです。

1つは、Revit の要素をカテゴリ別に集計して、その結果をテキストファイルで出力するアドインと、もう一つは、指定のカテゴリのファミリインスタンスを削除して Revit プロジェクトを出力するアドインです。

このサンプルは、Learn Autodesk Forge チュートリアルの .NET Core サンプルと同じ仕組みで実装されておりますので、このサンプルを起動する手順は、こちらのブログ記事をご参照ください。

CountDelete サンプルを起動すると、次のような画面が表示されます。

右上の「Configure」ボタンをクリックすると、AppBundle と Activity を登録するためのダイアログが表示されます。

下記のダイアログで、「CountIt」と指定し、起動するエンジンを「Autodesk.Revit+2019」に設定して、「Create/Update」ボタンをクリックしてください。

AppBundle と Activity の登録が成功すると、元の画面の右サイドにあるログ出力コンポーネント上に、下記のようにそれぞれの ID が出力されます。

「DeleteElements」の AppBundle も同じ操作で登録します。

次に、このサンプルで使用する Revit プロジェクトをアップロードするための Bucket を作成します。

左サイドのコンポーネントは、Authentication API の 2-legged 認証 で Forge アプリに割り当てられている専用のストレージ領域のファイルをツリー構造で表示するオブジェクトブラウザです。Bucket が存在しない場合は、右上の「New Bucket」ボタンで新規に Bucket を作成します。

Bucket が作成できたら、その Bucket を右クリックして、コンテキストメニューから「Upload File」を選択して、Revit プロジェクトをアップロードします。

アップロードが完了すると、Bucket 配下に Revit プロジェクトが表示されます。また、Revit プロジェクトを選択すると、画面中央に「Start Translation」ボタンが表示されます。ボタンをクリックすると、SVF 変換が始まり、変換が終了したら自動的に Forge Viewer が起動します。

Existing activities から「CountItActivity+dev」を選択し、「Start workitem」ボタンをクリックすると、Design Automation API の Workitem が実行されます。

Workitem の処理が完了すると、右サイドのログ出力コンポーネントには、処理のログと、出力されたテキストファイルのダウンロードリンクが表示されます。また、左サイドのオブジェクトブラウザでは、そのテキストファイルが Bucket 上に保存されていることがわかります。

そして、それぞれのカテゴリ毎に集計した結果の数量が表示されます。

次は、削除する要素のカテゴリ「Windows」を選択し、Existing activities から「DeleteElementsActivity+dev」を選択し、「Start workitem」ボタンをクリックし、Design Automation API の Workitem を実行します。

Workitem の処理が完了したら、左サイドのオブジェクトブラウザで、新規に作成された Revit プロジェクトを選択し、「Start Translation」ボタンをクリックして SVF 変換を行います。変換が完了すると Forge Viewer が起動し、プロジェクト内に配置されている窓ファミリのインスタンスが削除されていることを確認できます。

このように、Design Automation API を利用して、複数の Revit アドインを切り替えて実行できる環境を作成したり、あるいは、特定の業務課題を解決するためのワークフローをカバーするように、複数の Revit アドインを順番に実行させる仕組みを作成することで、Forge の活用の場はさらに拡がると考えられます。

ご興味ある方は、ぜひお試しください。

By Ryuji Ogasawara

Web アプリのデプロイ：Visual Studio から Azure への直接デプロイ

過去 3 回に渡って、GitHub 上のリポジトリ（リモート リポジトリ）から Heroku と Azure にデプロイする手順をご案内してきました。この場合、Web アプリのプログラムに改編（ソースコードの変更）があった場合には、ローカル リポジトリへのコミット、リモート リポジトリへのプッシュを経て、再度デプロイする手順が必要になってきます。

もし、GitHub リモート リポジトリでの共有が不要で、かつ、Visual Studio をお使いなら、Azure へのデプロイを Visual Studio 側から直接おこなうことも可能です。今回は、その手順を紹介しておきます。 

※ ご紹介する画面遷移は2019年4月時点のものです。今後当該サービスプロバイダーによって変更される可能性があります。

---

ローカルでの Web アプリの準備

ここでは、Web アプリとして Visual Studio 2017  Professional エディションで作成した Node.js テンプレートを利用したスケルトン プロジェクトを利用します。

GitHub Desktop を使った Web アプリの GitHub へのプッシュ 記事でも Node.js テンプレートを利用したプロジェクトを作成しましたが、Visual Studio からの直接デプロイで参照される Web. config ファイルを生成しないため、新たに別のテンプレートを利用してスケルトン プロジェクトを作成することにします。

Visual Studio 2017  Professionalで Node.js プロジェクトを作成するには、インストールで Node.js 開発 を選択しておく必要があります。

1. Visual Studio 2017 Professional エディションを起動して、Node.js プロジェクトを作成します。[ファイル(F)] メニューから [新規作成(N)] >> [プロジェクト(P)] を選択します。
2. [新しいプロジェクト] ダイアログが表示されたら、「空の Azure Node.js Web アプリケーション」テンプレートを選択して [OK] ボタンをクリックします。
   
3. 作成されたスケルトン プロジェクト（NodejsWebApp2 プロジェクト）の実行をテストしてみます。[デバッグ(D)] メニューから [▶ デバッグッグの開始(S)] を選択して、Web ブラウザの起動後に server.js の実装である Hello World が表示されることを確認してください。
   

---

Visual Studio から Azure への直接デプロイ

先に作成したスケルトン プロジェクトから作成される Web アプリ NodejsWebApp2 を、Visual Studio 内から Azure に直接デプロイしていきます。

1. NodejsWebApp2 プロジェクトを開いている状態で、[ビルド(B)] メニューから [NodejsWebApp2 の発行(H)] を選択します。
   
2. [発行] ダイアログが表示されたら、[Microsoft Azure App Services(A)] をクリックしてください。
   
3. [App Service] ダイアログが表示されるので、[新規作成(N)...] ボタンをクリックしてください。
   
4. アプリ名と Visual Studio サブスクリプションが設定された [App Service の作成] ダイアログが表示されるので、必要に応じて新しいリソース グループやホスティング プランを選択（変更、あるいは、新規作成）してください。ここでは、Web アプリのデプロイ：Azure へのデプロイ の過程で作成された NodejsWebApp1-app リソース グループを使用することにします。アプリ名はユニークなものが自動的に設定されてきますので、これも必要に応じて変更してください。必要な入力/設定が完了したら、[作成(R)] ボタンをクリックしてください。
5. しばらく時間がかかりますが、再び [発行] ダイアログが表示されるはずです。[接続] タブが表示され、すべての項目が設定されていることを確認したら、[発行(P)] ボタンをクリックして Web アプリのデプロイを開始します。
   
6. しばらくの後、デプロイが正常に完了すると、デプロイされた Web アプリが表示されます（この例では https://nodejswebapp220190428054945.azurewebsites.net）。
   
   初回のデプロイ後にコードに変更が生じた際には、2.以降の手順で設定した内容をそのまま流用して、再度、発行処理をすることで、新しい内容を反映することが出来ます。

---

このように、Visual Studio からの Azure へのデプロイは簡単におこなうことが出来ます。また、ここで使用した Node.js のほかに、ASP.NET など、Visual Studio と Azure App Services がサポートする Web サーバー テクノロジを利用する Web アプリのデプロイも可能です。

By Toshiaki Isezaki

---

Web アプリのデプロイ：Azure へのデプロイ

今回は、デプロイの一例として、GitHub Desktop を使った Web アプリの GitHub へのプッシュ でご紹介した GitHub リモート リポジトリの Web アプリ（NodejsWebApp1）を、Microsoft Azure へデプロイしていきたいと思います。

言うまでもなく、Microsoft が運用するクラウド プラットフォームで、Windows 仮想環境だけでなく、Web アプリの運用もカバーする多様なサービスを提供しています。

※ ご紹介する画面遷移は2019年4月時点のものです。今後当該サービスプロバイダーによって変更される可能性があります。

---

GitHub リモート リポジトリのデプロイ

1. GitHub 同様、Azure を利用するために Microsoft アカウントが必要です。Microsoft アカウントをお持ちでなければ、https://azure.microsoft.com/ja-jp/free/ からアカウントを作成してください（無償）。
2. Microsoft アカウントで  Azure ポータル（https://portal.azure.com/）にサインインしたら、ページ左から「App Service」を選択します。
   
3. App Service ページが表示されたら、「＋ 追加」を見つけてクリックします。
   
4. Web App 作成ページが表示されます。「アプリ名」欄にデプロイするアプリの名前を入力してください。この入力が新規作成する「リソースグループ」の名前と「Application Insight」に反映されるだけでなく、URL の一部になる点にも配慮してください（例：aaa とした場合、https://aaa.azurewebsites.net/ になる）。ここは、GitHub 上のリモート リポジトリ NodejsWebApp1 にしたいところですが、既に他の開発者が同じアプリ名でデプロイ済のようなので、NodejsWebApp1-app としておきます。
   
5. [作 成] ボタンをクリックしてアプリの仮想環境を作成します。
   
6. デプロイが進行中である旨、メッセージが表示されます。デプロイが完了するのに少し時間がかかりますので、そのままお待ちください。
   
7. デプロイした Web アプリとともに、他の Web アプリ（もし、あれば）が一覧表示されるはずです。ここでは、いまデプロイした Web アプリを設定していきますので、アプリ名 NodejsWebApp1-app のリンクをクリックしてください。
   
8. NodejsWebApp1-app アプリの構成ページが表示されます。左手のデプロイ センターをクリックしてください。
   
9. デプロイ センター ページでは、デプロイ済の NodejsWebApp1-app アプリと GitHub リモート リポジトリ NodejsWebApp1-app を関連付けをおこないます。ページ中の [GitHub] をクリックして（①）、ページ下の [続 行] をクリックしてください（②）。
   
   
   1. もし、初めて GitHub との接続をする場合には、[承認] ボタンが表示されます。ここでは、Azure が GitHub リポジトリを利用出来るように認可を与える必要があるので、[承認] ボタンをクリックしてください。
      
   2. GitHub アカウントでのサインインを求められるので、適切なユーザ名とパスワードを入力してサインインします。
      
   3. [Authorize Azure App Service] ページが表示されたら、[Authorize AzureAppService] ボタンをクリックして、Azure の GitHub アクセスを認可します。
      
10. [App Service のビルド サービス] をクリックして（①）、ページ下の [続 行] をクリックしてください（②）。
    
11. GitHub アカウント名（ユーザ名）、リモート リポジトリ名、ブランチ名を入力/選択して（①）、[続 行] をクリックします（②）。
    
12. ここまで操作・設定したサマリーが表示されるので、内容を確認後、[完了] をクリックします。
    
13. しばらく時間がかかりますが、設定した内容がデプロイに反映されます。処理完了（セットアップのデプロイ完了）のメッセージが表示されたら、NodejsWebApp1-app アプリの「概要」をクリックして（①）、デプロイ済の URL をクリックしてください（②）。
    
14. デプロイ済の NodejsWebApp1-app の URL  https://nodejswebapp1-app.azurewebsites.net/ でアプリが実行されるはずです。
    

---

他の Azure Web App Serviceu 環境

今回は Node.js を使ったアプリをデプロイしましたが、Azure の App Service には他にもさまざまな環境が用意されています。必要に応じて https://docs.microsoft.com/ja-jp/azure/app-service/を確認してみてください。

---

Azure へのデプロイには他にもいくつか方法があります。もし、Web アプリの開発作業に Visual Studio をお使いであれば、Visual Studio から直接デプロイすることが可能です。次回は、その方法をご紹介します。

By Toshiaki Isezaki

Web アプリのデプロイ：Heroku へのデプロイ

今回は、デプロイの一例として、GitHub Desktop を使った Web アプリの GitHub へのプッシュ でご紹介した GitHub リモート リポジトリの Web アプリ（NodejsWebApp1）を、Heroku へデプロイしていきたいと思います。

Heroku はクラウドベースの PaaS（Platform As A Service）で、開発者が作成した Web アプリを Heroku の仮想環境で実行して、サービスとしてエンドユーザが利用する環境を提供します。デプロイ時には Web アプリを呼び出す URL が割り当てられるので、誰もがアクセス出来るようになります。

※ ご紹介する画面遷移は2019年4月時点のものです。今後当該サービスプロバイダーによって変更される可能性があります。

---

GitHub リモート リポジトリのデプロイ

1. GitHub 同様、Heroku を利用するために Heroku アカウントが必要です。Heroku アカウントをお持ちでなければ、https://signup.heroku.com/login からアカウントを作成してください（無償）。
2. https://id.heroku.com/login から Heroku アカウントでサインインします。
3. ページ右上の [New ⇕] ボタンをクリックして、ドロップダウンから [Create new app] を選択してください。
   
4. Create New App ページで「App name」欄に Web アプリ名を入力します。ここでは半角英字、数字と半角ハイフンしか利用出来ないので、nodewebapp1 と入力して、[Create app ] ボタンをクリックしてください。
   
5.  nodewebapp1 アプリのデプロイ情報を定義していきます。[Deploy] タブの「Deployment method」欄で [GitHub] を選択します。
   
6. 「Connect to GitHub」欄で [Connect to GitHub] ボタンをクリックします。
   
7. GitHub アカウントでサインインして、Heroku が GitHub リポジトリを利用出来るように認可を与えます。
   
8. 「Connect to GitHub」欄に Heroku でデプロイする GitHub アカウント名が表示されるので（①）、[Search] ボタンをクリックして（②）、同アカウント上のリモート リポジトリの一覧を表示させます。一覧からデプロイするリポジトリ NodejsWebApp1 を見つけて、右横の [Connect] ボタンをクリックしてください。
   
9. 「Connect to GitHub」欄の名前が「App connected to GitHub」に変わり、NodejsWebApp1 リポジトリに接続が完了します。
   
10. そのまま [Deploy] タブの画面を下方向にスクロールして、「Manual deploy」欄の [Deploy Branch] ボタンで master ブランチのデプロイを開始します。
    
11. デプロイ中のログ情報が順次表示されていきます。
    
12. デプロイが正常に完了すると、「Your app was successfully deployed.」メッセージが表示されます。メッセージ下の [View] ボタンをクリックすると、デプロイされた Web アプリが起動します。
    
    
    今回は https://nodejswebapp1.herokuapp.com/ の URL が自動的に適用されているはずです（アプリ名.herokuapp.com）。
    デプロイされた Web アプリは、デバイスやプラットフォームを問わず、どこからでもアクセス出来ます。
    
    

---

Web アプリ更新時の再デプロイ

Web アプリのソースコードを変更/更新した場面では、ローカル リポジトリへのコミットとリモート リポジトリへのプッシュを経て、GitHub 上に更新された状態を確認後、Heroku で再デプロイをおこなってください。この際には、Heroku 上に作成済の Web アプリは GitHub リモート リポジトリに接続された状態を維持しているので、上記手順の 10. にある [Deploy] タブでのデプロイ操作をおこなうだけです。

---

他の Heroku 環境

今回は Node.js を使ったアプリをデプロイしましたが、Heroku には他の環境やデータベース オプションなども用意されています。必要に応じて https://devcenter.heroku.com/startを確認してみてください。

---

今回デプロイした Web アプリは Forge を利用していませんが、デプロイまでの手順はおおまかに把握いただけるものと思います。

By Toshiaki Isezaki

Web アプリのデプロイ：GitHub Desktop を使った GitHub へのプッシュ

Forge は、オートデスクがクラウド サービスの開発で培った要素技術を、複数の Web API として公開しているブランド名です。Forge を利用するのは、通常、Web サーバー上に構築することになる Web アプリケーション（以降、Web アプリ）です。

Forge を利用する Web アプリの開発は、誰もがアクセス出来る Web サーバー上でおこなうのではなく、開発者が使用するコンピュータを使ってローカル コンピュータで実施し、完成した後、あるいは、完成に近い状態で Web サーバーに展開（デプロイ）するのが一般的です。

このため、ローカル コンピュータ上で Web アプリをテストする際には、Web ブラウザ上で http://localhost:3000 などのように実行することになります。この場合、開発中の Web アプリは、ローカル コンピュータからのみしか実行出来ません。逆に言えば、誰にでもアクセスしてもらうには、完成した Web アプリを Web サーバーにデプロイする必要があります。

デプロイ作業の選択肢は多様なため、いままで、このブログであまり触れていませんでした。今後、数回に渡って、ローカル コンピュータで開発している Web アプリのデプロイを前提に、基本的な概要といくつかの手順をご案内していきたいと思います。基本的な考え方を把握いただくため、Forge に特化せずに説明を加えていきます。

次回以降、Forge アプリの紹介で比較的よく利用されている Heroku や Microsoft Azure へのデプロイを前提にしていくことにします。今回は、その準備にあたる GitHub の理解とツール、手順をご紹介しすることにします。

※ ご紹介する画面遷移は2019年4月時点のものです。今後当該サービスプロバイダーによって変更される可能性があります。

---

ローカルでの Web アプリの準備

まず、Web アプリとして Visual Studio 2017  Professional エディションで作成した Node.js テンプレートを利用したスケルトン プロジェクトを利用します。なお、Visual Studio 2017  Professionalで Node.js プロジェクトを作成するには、インストールで Node.js 開発 を選択しておく必要があります。

1. Visual Studio 2017 Professional エディションを起動して、Node.js プロジェクトを作成します。[ファイル(F)] メニューから [新規作成(N)] >> [プロジェクト(P)] を選択します。
2. [新しいプロジェクト] ダイアログが表示されたら、「空の Node.js Web アプリケーション」テンプレートを選択、プロジェクト名に
3. NodejsWebApp1 と命名して [OK] ボタンをクリックします。「新しい Git リポジトリの作成(G)」にはチェックを入れないでください。
   
4. 作成されたスケルトン プロジェクトの実行をテストしてみます。[デバッグ(D)] メニューから [▶ デバッグッグの開始(S)] を選択して、Web ブラウザが起動後に server.js の実装である Hello World が表示されることを確認してください。
   

---

GitHub とは

近年、開発の現場で耳にすることが多くなった GitHub ですが、一言で言うと、開発プロジェクト用のソースコード管理をおこなうクラウド サービス、という位置づけです。無償版と有償版があり、オートデスクも有償版（GitHub Enterprise）を使って、クラウド サービスや AutoCAD などのデスクトップ製品のソースコードを管理し、チーム開発をおこなっています。

GitHub でソースコード管理するのはリポジトリという単位です。ローカル コンピュータのリポジトリを ローカル  リポジトリ、GitHub サイトjにあるリポジトリをリモート リポジトリと表現します。ローカル コンピュータ上にある開発中、あるいは、完成したソースコードはコミットすると、ローカル リポジトリに記録されます。その後、ローカル リポジトリの内容をプッシュすると、GitHub サイト上のリモート リポジトリに記録されます。この流れでリモート リポジトリを使って、共同開発者と一緒にソースコードを管理していきます。

リポジトリには、運用中のソースコードと、新機能や不具合修正した次期バージョン用のソースコードを並行して開発していけるよう、ブランチという単位も存在します。互いのブランチは独立して管理されるので、ローカル リポジトリに運用中の master とブランチと次期バージョン用の next version というのように、複数のブランチを作ってメインテナンスすることが可能です。

開発環境に依存せずに Heroku をや Azure に Web アプリをデプロイ（Web サイトを公開）には、ローカル コンピュータ上にある 実行可能なソース コード一式を、いったん、GitHub リポジトリにアップロード（プッシュ）しなければなりません。

GitHub の利用には GitHub  アカウントが必要です。もし、GitHub アカウントをお持ちでなければ、https://github.com/join?source=header-home からサインアップ（アカウント登録）することが出来ます（無償）。

---

GituHub Desktop とは

ローカル リポジトリの作成やコミット、ブランチの作成や切り替え、リモート リポジトリへのプッシュは、プロンプトによるコマンド操作が一般的ですが、少しわかりにくいのが難点でした。この点を解決したのが、ユーザ インタフェースで同等の操作が可能な GitHub Desktop です。

GitHub Desktop は、https://desktop.github.com/ から無償でダウンロード、インストールして利用することが出来ます。

---

Web アプリの GitHub へのプッシュ

前置きが長くなりましたが、ここから、ローカル リポジトリを作成、GitHub 上のリモート リポジトリへのプッシュ作業をおこなっていきます。便宜上、今回はローカル リポジトリの master ブランチをプッシュしていきます。

1. ローカルでの Web アプリの準備 で作成した Web アプリ NodejsWebApp1 プロジェクト のパスを確認します。ここでは、既定値の C:\Users\<windows user name>\source\repos\NodejsWebApp1 フォルダ下にプロジェクトがあり、アプリの実行時に実行される server.js が、C:\Users\<windows user name>\source\repos\NodejsWebApp1\NodejsWebApp1 フォルダ下に存在しているものとします。
2. GitHub Desktop を起動して、GitHub アカウントでサインインします。[File] メニューから [Options] を選択してください。
   
3. [Accounts] タブ内の 「GitHub.com」右横の [   Sign in   ] ボタンをクリックしてください。
   
4. GitHub アカウントを入力して [   Sign in   ] ボタンをクリックしてサインインを完了します。このサインイン操作で、リポジトリとアカウントが関連付けられます。 
   
5. 次に [File] メニューから [Add local repository....] を選択します。
   
6. [Add local repository] ダイアログが表示されたら、[Choose...] ボタンをクリックします。
   
7. server.js が存在する C:\Users\<windows user name>\source\repos\NodejsWebApp1\NodejsWebApp1 フォルダをナビゲートし、[フォルダーの選択] ボタンをクリックします。
   
8. "This directory does not appear to be Git repository. Would you like to create a repository here instead?" の警告メッセージとともに、[Add local repository] ダイアログが再び表示されるはずです。ここでは、このままメッセージ内の create a repository をクリックします。
   
9. NodejsWebApp1 が Name（リポジトリ名）として設定されている [Create a new repository] ダイアログが表示されるので、ここでは他の項目をそのままにして [  Create repository   ]  ボタンをクリックします。
   
   ※ GitHub 無償枠では、リモート リポジトリはすべて Public モードでソースコードを誰でも閲覧出来るようになっていましたが、2019年1月から、無償枠でもソースコードを非公開とする Private モードを選択出来るようになっています。
10. 「Current repositry」に NodejsWebApp1 が（①）、「Current branch」に master が（②）、それぞれ選択されていることを確認出来たら、[  Publish repository  ]  ボタンをクリックしてください。
    

1. [Publish repository]  ダイアログが表示されたら、「Keep this code private」のチェックを外して、[   Publish repository   ] ボタンをクリックすると、Publish（パブリッシュ＝最初のプッシュ）が始まります。
   
2. しばらく時間がかかりますが、[Publish repository]  ダイアログが消えて、何もエラーが出なければ、GitHub へのリモート レポジトリ作成の完了です。GitHub サイトにリモート リポジトリが記録されたかチェックするには、GitHub Desktop 上で [View on GitHub] ボタンをクリックします。
   
3. GitHub サイトのリモート リポジトリ NodejsWebApp1 が表示されるはずです。
   

---

ローカル リポジトリのコミットとリモート リポジトリへのプッシュ

一度、リモート リポジトリへのプッシュを済ませた後も、GitHub Desktop はローカル リポジトリのソースコード編集を監視しています。例えば、NodejsWebApp1 プロジェクトの server.js の一部を編集してファイルを上書き保存してから GitHub Desktop を起動すると、編集箇所が画面に表示されるはずです。
この状態では、またソースコードの変更がローカル リポジトリに記録（コミット）されていません。ローカル リポジトリへのコミットには、GitHub Desktop 左下の変更内容を判別する文字列を記入し、[Commit to master]（master ブランチへのコミット）ボタンをクリックする必要があります（①）。

コミットしたローカル リポジトリの内容をリモート リポジトリに反映（プッシュ）するには、ローカル リポジトリへのコミット後に、画面表示が更新されて現れる [Push origin] ボタンをクリックしてプッシュしてください（②）。

---

ここまでの操作でローカル リポジトリの作成とリモート リポジトリへのプッシュが完了しました。

なお、今後、今回の記事に関連した次の方法についてご案内していく予定です。

• Heroku へのデプロイ
• Azure へのデプロイ
• Visual Studio から Azure への直接デプロイ

次回は、GitHub リモート リポジトリの Web アプリを Heroku にデプロイし、どこからでもアクセス出来るようにしていきます。

By Toshiaki Isezaki

PlanGrid BIM リリース

オートデスクは、クラウドベースの建設プラットフォームによってデジタル化と自動化を促進するために、昨年から、PlanGrid 社、Assemble Systems 社、BuildingConnected 社の買収をそれぞれ発表してきました。

PlanGrid 社は、ゼネコン、サブコン、オーナーが、建設プロジェクトのライフサイクル全体を通じて、リアルタイムのコラボレーションを実現するためのソフトウェアとクラウドサービスを提供している企業です。

PlanGrid のユーザーは、プロジェクトの計画、パンチリスト、プロジェクトタスク、進捗状況の写真、毎日の現場レポート、提出物などにリアルタイムにアクセスすることができます。

そして、2019年4月23日に、PlanGrid と Revit を繋げる新機能「PlanGrid BIM」が発表されました。

今回は、この「PlanGrid BIM」について、その概要をご紹介します。

• https://www.plangrid.com/features/bim/

「PlanGrid BIM」の機能は大きく分けて3つあります。

• BIM 対応シート
  • ユーザーは要素をタップして、要素の寸法、材料の種類、製造元の詳細などの BIM データのプロパティにアクセスできます。
• 3D BIM Viewer
  • シンプルにタップするだけで、オフラインの場合でも、特定の要素の 3Dビューを即座に表示できます。ベータ版のビューアには、モデルの要素間で計測を簡単に行うための、ズームツール、スナップツールなどの機能が含まれています。
• Revit との統合
  • Revit アドインツールを通じて、Revit から PlanGrid にシームレスにシートをパブリッシュすることができます。 
  • BIM データ、およびシートのタイトルと番号が PlanGrid に移行されます。
  • このアドインは、Revit 2017 ~ Revit 2020 でお使い頂くことができます。

もちろん、この 3D モデルを表示する機能には、Forge Viewer が組み込まれております。

現時点では、BIM 360 とは連携されておりませんが、今後は、Forge や BIM 360 との連携が強化されていく予定です。

また、「PlanGrid BIM」をトライアルでお試し頂くこともできます。

Revit と Forge を連携して、Forge Viewer を活用している事例としても参考になりますので、ご興味のある方は、下記の手順で実際にお試しください。

1. まず、右上の「SIGN UP」ボタンをクリックして、ユーザー登録ページにて、必要な情報を入力して、ユーザー登録をします。
   
   
2. ユーザー登録後にログインすると、ポータル画面にて、サンプルプロジェクトを選択することができます。
   「Sample Project - Office Building」プロジェクトを選択すると、事前にアップロードされているシートや関連データを確認できます。
   
   
3. 次に、こちらのサイトから Revit アドインの ZIP パッケージをダウンロードし、インストーラを起動して、Revit アドインをインストールします。
   Revit を起動して、ZIP パッケージに同梱されている「Sample Project - PlanGrid Office - Revit 2019.rvt」を開きます。
   
   
4. [アドイン]タブの[Export to PlanGrid]ボタンをクリックすると、ダイアログが表示されます。
5. PlanGrid のユーザーでログインします。
   
   
   
6. Revit プロジェクトのデータに「PlanGrid BIM」がアクセスするための権限を許可します。
   
   
   
7. エクスポート先のプロジェクトを選択します。今回は、「Sample Project - Office Building」プロジェクトを選択します。
   
   
8. エクスポート時の Version set name を入力します。この名称によって、PlanGrid 上でアップロードしたシートを識別することができます。※[Include BIM data/model]チェックボックスにチェックが入っていることを確認してください。
   
   
   
9. [Publish]ボタンをクリックすると、シートのアップロードが始まります。
   
   
10. アップロードが完了したら、PlanGrid を開いて、「Sample Project - Office Building」プロジェクトのサイドバーのメニューから[Sheets]を選択します。
    
    
11. 右の [Filter by] 機能で、先ほど入力した「Version set name」を選択します。
    
    
    
12. 「A-101」のシートを選択すると、シートが表示されます。左メニューの「BIM」ボタンをクリックすると、BIM モデルの要素が、青色でハイライト表示されます。
    
    
    
13. ハイライト表示されている要素の一つを選択すると、コンテキストダイアログが表示され、さらに要素を選択すると、要素の詳細が右サイドに表示されます。
    
    
    
14. 要素の詳細では、Revit の要素が保持しているプロパティの情報を確認することができます。また、[View in 3D]ボタンをクリックすると、その要素にフォーカスされた状態で Forge Viewer が開きます。
    
    
    
15. Forge Viewer では、マウスドラッグで視点の移動、マウスホイールのスクロールでウォークスルーを行うことができます。
    
    
    
16. また計測の機能を利用することができます。計測モードにすると、マウスカーソルが端点にスナップします。
    
    
17. 要素を選択して、プロパティを表示することもできます。

 

今回は、PlanGrid と Revit を繋げる新機能「PlanGrid BIM」についてご紹介しました。

Forge を活用すれば、既存のソフトウェアやクラウドサービスとオートデスク製品を補完的に「接続する」仕組みを構築することができます。

 7 月 16 日（火）～19 日（金）にオートデスク・東京オフィスで開催する Autodesk Cloud Accelerator は、Autodesk Cloud Engineering チームのサポートを受けながら、PoC（Proof Of Concept）/コンセプト アプリの開発に集中的に取り組むことができるデベロッパー向けのイベントです。

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

• Autodesk Cloud Accelerator 2019 東京 開催のお知らせ

 

By Ryuji Ogasawara

スクリプト可能なテキストファイルの OSS アップロードとダウンロード

6 月 12 日以降、コンテンツ配置のインライン、および、コンテンツ タイプ（Content-Type）が次のいずれかの場合、OSS アップロード PUT endpoint は HTTP 400 ステータス コードを返します。

text/html

text/javascript

text/x-javascript

application/javascript

application/x-javascript

アプリケーションがこれらのファイルをすでにアップロードしている場合は、ダウンロード時に HTTP 400 ス テータス コードを返します。

この変更は他のコンテンツ処理フォーマットには影響しません。ご質問等ございましたら、https://forge.autodesk.com/en/support/get-help

をご利用ください。

 

By Toshiaki Isezaki

Autodesk Cloud Accelerator 2019 東京 開催のお知らせ

Autodesk Forge を使った PoC（Proof Of Concept）/コンセプト アプリ開発のお手伝いをする Autodesk Cloud Accelerator を 7 月 16 日（火）～19 日（金）にオートデスク・東京オフィスで開催いたします。

イベント詳細、および、参加要項、および、参加お申込みは次のリンクをご確認ください。

https://www.eventbrite.com/e/autodesk-forge-accelerator-tokyo-july-16-19-registration-57470376443

[ Register ] ボタンをクリックすると数量（Quantity）の入力後、英語のフォームが表示されますので、日本語で必要項目を入力の上、[ Complete Registeration ] ボタンをクリックお申込みください。

Autodesk Cloud Accelerator の概要については、Cloud Accelerator よくある質問 もご用意していますのでお申込み前にご確認ください。

By Toshiaki Isezaki

Revit 2020 の新機能 その3

前回に引き続き、Revit 2020 の新機能についてご紹介させて頂きます。

今回は、「接続機能」をテーマとした新機能と更新内容についてご案内いたします。

「接続機能」は、プロジェクトチームの連携を強化し、マルチプロダクト間のワークフローをより良くするための重要なテーマです。
ユーザーが円滑にコラボレーションでき、他者と情報交換するプロセスを改善することが、一つのゴールとなっています。

つまり、この分野では、オートデスクのソフトウェアやサービス間でデータを共有したり、IFCやPDFなどの業界標準をサポートしたり、プロジェクトチームが互いに連携して作業できるようにするツールを提供します。

 

PDF のアンダーレイ

Revit Ideas で最も投票数の多かったリクエストが Revit 2020 でサポートされました。
1 ページまたは複数ページの PDF ファイルを Revit の 2D ビューに読み込んで、モデルの参照として使用できるようになりました。
これにより、2D データを BIM と接続して、建設のワークフローを改善します。

• ラスター イメージと同じ方法で、PDF ファイルを操作する
• ベクトル データを含む PDF にスナップする
• [イメージを管理]ダイアログに、イメージおよび PDF ファイルの相対パスおよび BIM 360 クラウドのパスが表示されます。

例えば、下記のように地図データをプロジェクトに重ね合わせることも簡単です。

PDF のベクトルデータにスナップできるため、平面図のデータをベースにモデルに起こすこともできます。

 

SketchUp モデルを読み込む

最新バージョンの SketchUp モデルを Revit にロードできます。Revit 2020 では、Sketchup 2018 のインポートに対応しました。
SketchUp による早期の設計フェーズが完了したら、そのまま Revit にインポートして、ワークフローを繋げることができます。

 

Revit Extension for Fabrication

Revit から製造用ジョブに製造用部品レイアウトを書き出すには、Revit Extension for Fabrication を使用します。

拡張機能を使用すると、Autodesk Fabrication 製品(CADmep、ESTmep、CAMduct)で作成した製造用ジョブを読み込んで、Revit でモデリングを続行することができます。

Revit 2020 では、製造データの新しいエクスポートのオプションが追加され、Excel などのスプレッドシートのアプリケーションにインポート可能な CSV または TXT データファイルを生成できるようになりました。

これらの詳細データを、プレコンストラクションフェーズや、集計や調達などの製造のワークフローでご活用いただけます。

 

クラウドモデルアップグレード

BIM 360 プロジェクトに保存されているクラウドモデルの Revit バージョンを、ボタンの 1 クリックだけでアップグレードできるようになりました。

これまでは、Revit を起動してプロジェクトを選択し、長時間を要して最新バージョンに移行する必要があった作業が、クラウド上でバックグラウンドで実行できるようになったことで、待機時間を飛躍的に節約できます。

詳細は下記のページに記載されております。

• Revit のクラウド モデルをアップグレードするには

実はこの機能は、バックエンドでは、Forge の Design Automation API for Revit が利用されています。

現在、BIM 360 のクラウドサービス（BIM 360 Design, BIM 360 Glue, BIM 360 Build など）は、既存の BIM 360 を一新する 次世代 BIM 360（別名、NextGen BIM 360、Next Generation BIM 360）として、Forge を基盤として作り替えられています。

もちろん、BIM 360 でも Revit が最も重要なデータとして位置付けられておりますので、BIM 360 上で Revit モデルを活用するための様々な機能が今後も追加されていくはずです。

Revit プロジェクトのバージョンアップグレードは、従来は、Revit アプリケーションを起動して、プロジェクトを開く段階で、そのプロジェクトが作成された Revit バージョンを識別し、起動中の Revit よりも低いバージョンであれば、アップグレードをするというフローが必要でした。

クラウドモデルアップグレードは、Revit のコアエンジンをクラウド上で起動し、クラウドストレージに保存されている Revit プロジェクトを開いて、クラウド上でバージョンアップグレードします。

このように、Revit のコアエンジンをクラウド上で起動し、Revit アドインを実行する仕組みが、Forge の API としてデベロッパー向けにも公開されております。

それが、Design Automation API for Revit です。

ただし、サードパーティーのデベロッパーは、BIM 360 の各サービスに直接、カスタム機能を追加することはできません。

Design Automation API for Revit の概要については、下記のブログ記事をご参照ください。

• Design Automation API for Revit パブリックベータ版の公開
  
• Design Automation API for Revit 開発手順の理解

Design Automation API for Revit にご興味がある方は、5月28日（火）東京、5月31日（金） 大阪にてワークショップを開催いたしますので、ぜひご参加ください。

• Forge 1 Day Workshop - Design Automation API for Revit - 開催 - 2019年5月
  
  

By Ryuji Ogasawara

Autodesk University Japan 2019 開催決定

今年の Autodesk University Japan の開催日と場所が決定しました。もちろん、Forge Developer Conference も併設予定です。

開催日はここ数年の開催時期より若干遅くなり、 10月9日（水）の予定です。また、開催場所は昨年と同じく グランドニッコー東京台場 （https://www.tokyo.grand-nikko.com/）です。現時点では、これ以上の情報がありませんが、詳細が決まりましたら、またご案内していく予定です。

今年も両イベントにご期待ください。

By Toshiaki Isezaki