建設管理ソフト Autodesk Construction Cloud のデータをTableau Desktop で分析・可視化:CData ODBC Driver

by 杉本和也 | 2023年10月29日

CDataの様々なAPIコネクターの紹介ページ

こんにちは。CData Software Japan リードエンジニアの杉本です。

本記事では建設管理ソフトのAutodesk Construction Cloud のデータをTableau Desktop で分析・可視化する方法を紹介したいと思います。

Autodesk Construction Cloud とは?

AutoCADに代表される図面作成 ソフトウェアを主に開発しているAutodesk が提供する建設業界向けの建設プロジェクト管理のSaaS です。

https://construction.autodesk.co.jp/

以下のような画面で建設プロジェクトにおける指摘事項や提出物、アセットの管理などが行えるサービスになっています。

またAutodesk Construction Cloud では各種データへのアクセス、操作を行うAPI が提供されており、本記事ではこのAPI を利用してTableau との連携を実現します。

https://aps.autodesk.com/en/docs/acc/v1/overview/introduction/

実現イメージ

今回はAPIの連係対象BIツールとして、Tableauを使用しますが、Tableau から簡単にそれぞれのAPI に接続することはできません。 Tableau がどのようにWeb API側へリクエストを投げるべきか、認証の処理はどうすればいいか? などの判断材料やメタデータの情報が無いためです。

そこで、CData ODBC API Driverを用いて、このボトルネックを解決します。

https://www.cdata.com/jp/apidriver/

f:id:sugimomoto:20200520214240p:plain

CData API Driver は様々なAPI をデータベースに仮想化し、ODBCやJDBCといった汎用インターフェースから接続できるようにするコネクターです。

このコネクタとTableau が標準で持つODBC・JDBC 連携機能を組み合わせて、様々なAPI との連携を実現します。

今回の記事では最終的に以下のようにAutodesk Construcion Cloud の持つデータをCData API Driver 経由でTableau に取り込み、可視化できる状態にするまでの手順を解説していきます。

前提条件

本記事では以下のサービスや製品を使用しています。

・Tableau Desktop
・CData ODBC API Driver
・CData API Profile for Autodesk Construcion Cloud

Autodesk Construcion Cloud Web API の利用準備

Autodesk Construcion Cloud Web API を利用するためには接続用のアプリケーションを予め作成しておく必要があります。

まず、以下のURLにアクセスし「Create application」をクリックします。

https://aps.autodesk.com/myapps/

任意のアプリケーション名を入力し、Application Type から「Traditional Web App」を選択し、「Create」をクリックします。

作成完了後、接続のために必要になる「ClientId」「ClientSecret」という値が表示されるので、これらの値を控えておきます。

また、Callback URLを空いているローカルホストの番号に変更しておくと良いでしょう。私のマシンでは8080ポートを使っていたため、空いているポートを使って「http://localhost:33333/」を指定しておきました。

API Profile の準備

CData API Driver で任意のAPI に接続するためには予めAPI Profile と呼ばれる設定ファイルを作成する必要があります。

今回は私が予めサンプルとなるAPI Profile を作成しているため、以下のURLから入手してください。

https://cdatajbuilds.s3.ap-northeast-1.amazonaws.com/APIProfiles/AutodeskConstructionCloud.apip

なお、本API Profile で対応しているAutodesk Construction Cloud API の対応状況は以下の通りとなります。

No

Categories

Functions

CData Table Name

URL

1

Assets (beta)

Assets

Assets

https://aps.autodesk.com/en/docs/acc/v1/reference/http/assets-assets-v2-GET/

2

Assets (beta)

Categories

AssetCategories

https://aps.autodesk.com/en/docs/acc/v1/reference/http/assets-categories-GET/

3

Assets (beta)

Status-Sets

AssetStatusStepSets

https://aps.autodesk.com/en/docs/acc/v1/reference/http/assets-status-step-sets-GET/

4

Assets (beta)

Statuses

AssetStatuses

 

5

Assets (beta)

Custom-Attributes

AssetCustomAttributes

https://aps.autodesk.com/en/docs/acc/v1/reference/http/assets-custom-attributes-GET/

6

Forms

Templates

FormTemplates

https://aps.autodesk.com/en/docs/acc/v1/reference/http/forms-form-templates-GET/

7

Forms

Forms

FormCustomValues

FormEquipmentEntries

FormMaterialsEntries

FormPdfValues

Forms

FormWorklogEntries

https://aps.autodesk.com/en/docs/acc/v1/reference/http/forms-forms-GET/

8

Issues

Issue Types

IssueTypes

https://aps.autodesk.com/en/docs/acc/v1/reference/http/issues-issue-types-GET/

9

Issues

Issue Root Cause Categories

IssueRootCauseCategories

https://aps.autodesk.com/en/docs/acc/v1/reference/http/issues-issue-root-cause-categories-GET/

10

Issues

Issues

Issues

https://aps.autodesk.com/en/docs/acc/v1/reference/http/issues-issues-GET/

11

Issues

Issue Comments

IssueComments

https://aps.autodesk.com/en/docs/acc/v1/reference/http/issues-comments-GET/

12

Sheets

Version Sets

SheetVersionSets

https://aps.autodesk.com/en/docs/acc/v1/reference/http/sheets-version-sets-GET/

13

Sheets

Sheets

Sheets

https://aps.autodesk.com/en/docs/acc/v1/reference/http/sheets-sheets-GET/

CData ODBC API Driverのインストール

続いて、Tableau とAutodesk Construction Cloud API を繋ぐために必要となるCData ODBC API Driverをインストールします。以下のURLからフル機能のトライアル版がダウンロード可能です。

https://www.cdata.com/apidriver/download/

なお、Tableau の各製品によってCData 製品の組み合わせが異なります。以下に各Tableau のエディション毎の連携パターンの解説記事がありますので、参考にしてみてください。よくわからない場合はお問い合わせフォームまでお気軽にどうぞ。

https://www.cdata.com/jp/blog/tableaupattern

ダウンロードしたsetup.exeファイルをTableau がインストールされているマシンにインストールします。インストールウィザードに従い、EULA を確認した上でインストールを完了します。

 

※途中、ライセンスサーバーへのオンラインアクティベーションが行われるためネットワーク環境に接続されている必要があります。

インストールが完了すると、ODBCのDSN設定のウィンドウが立ち上がります。

以下の項目をセットし、保存します。

Property

Value

 

Profile

C:\APIProfiles\AutodeskConstructionCloud.apip

API Profileのファイルパス

Profile Settings

ProjectId=your_project_id

対象のProjectIdを指定

Auth Scheme

OAuth

 

Initiate OAuth

GETANDREFRESH

 

OAuth Version

2.0

 

OAuth Client Id

例)kCAbJOXX49vpPYxQGf9z1qcFmqa7QNnu

作成したアプリケーションのClient Idを指定します。

OAuth Client Secret

例)F72b5EGBP9n2M7yG

作成したアプリケーションのClient Secret を指定します。

Callback URL

http://localhost:33333/

 

入力後、「接続テスト」をクリックすると、ブラウザが立ち上がり、アクセス許可の画面が表示されるので、内容を確認し「許可」をクリックしましょう。

アクセス許可が正常に完了すると、以下のようなメッセージがブラウザとメッセージウィンドウで表示されます。

接続の完了後、「Data Model」のタブから利用できるアプリ・フォームのデータモデルが確認できます。

また、「Preview」をクリックすることで、実際のAutodesk Construction Cloudデータも確認できます。

Tableau Desktop で接続

それでは、実際にTableauと接続して、データの取得処理を実施してみましょう。

Tableau Desktopを起動して、データ接続より「サーバーへ」>「詳細」>「その他データベース(ODBC)」を選択します。

「その他のデータベース(ODBC)」設定ウィンドウが開いたら、接続手段内のDSN から先程作成したコネクションを選択して「接続」→「サインイン」します。

サインイン完了後「データソース」画面が開くので、左側のペインで、「データベース:CData」「スキーマ:AutodeskConstructionCloud」を選択することで、利用できるテーブルの一覧が表示されます。

表示後、利用したいテーブルをドラッグアンドドロップで配置し、項目やデータのプレビューを確認してみましょう。正常にAutodeskConstructionCloud のデータが参照できていればOK です。

あとは、Tableauのシートに移動して、各種項目を組み合わせてグラフを作成できます。 

おわりに

このようにAPI の専門的な知識がなくても、CData Driver を利用することで様々なAPI にTabelau から接続することが可能です。

今回紹介したAutodeskConstructionCloud API以外にも様々なAPI コネクターを公開していますので、ぜひ自社で使っているサービスに合わせて活用してみてください。

https://www.cdata.com/jp/drivers/

実際に試していく中で、「このAPI にもつなぎたい」「こういう時はどうすればいいの?」といった気になる部分があれば、お気軽にテクニカルサポートフォームまでお問い合わせください。

https://www.cdata.com/jp/support/submit.aspx

関連コンテンツ

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。