Data Exchange サンプル：事前準備 の内容に沿って、GitHub – autodesk-platform-services/aps-dx-samples-nodejs リポジトリが Windows ローカル環境にクローン・セットアップ済で実行出来ることを前提に、Retrieve Exchange Item Information（Exchange Item 情報の取得）の内容を処理していきます。なお、Data Exchange API は、現時点（2023 年 8 月）で Beta 版の API になっています。今後、手順や内容が変更される可能性があります。
はじめに
Data Exchange API を使って粒状データでデータ交換する際には、Autodesk Construction Cloud に作成した Exchange Item の ID を取得する必要があります。このタスクでは、Hub、Project、Folder をナビゲートし、Exchange Item を識別するために必要な Data Exchange GraphQL API の処理に焦点を当てています。
- Hub、Project、Folder、Item、Version は、Autodesk Construction Cloud のドキュメント層である Autodesk Docs が持つ論理構造を識別するオブジェクト単位です。各オブジェクトは一意な ID を持ち、Data Management API を使ってアクセスの際にも使用します。ただし、Hub を除いて使用される ID は Data Exchange API と Data Management API では形式が異なります。
- 後述の Step 1 ～ Step 5（5a、5b）の手順を実行するには、Data Exchange サンプル：事前準備 でご紹介した手順でセットアップしたサンプルを起動して、「Get exchange item information Sample Workflow」の [Go to sample] をクリックしてください。
Step 1：すべての Hub を取得する
ページ右上の [Login] ボタンをクリックして、Autodesk Construction Cloud のアクセス権を持つオートデスク アカウント（Autodesk ID）でログイン（サインイン）後、[List Hubs] をクリックします。画面に Hub ID が表示されるのでデータ交換（Data Exchange）を作成したプロジェクトがある Hub ID（”id” の値）を書き留めておきます。
Hub 一覧には、A360 や Fusion Team の Hub に加え、他者から招待されたプロジェクトの Hub が含まれます。Autodesk Construction Cloud の Hub は、ID の先頭文字が “b.” で始まります。もし、判別が難しい場合には、Autodesk Construction Cloud と APS 統合で必要なカスタム統合 でカスタム統合した際に、9. の「BIM 360 のアカウント ID」が、”b.” を除いた値を目安に判断をしてください。
- 本サンプルの実行で使用している Client Id をカスタム統合していない場合には、Autodesk Construction Cloud の Hub は表示されません。ご注意ください。
使用した GraphQL クエリ：
{
hubs {
results {
name
id
}
}
}Step 2：すべての Project を取得する
Step 1 で の Hub ID を「Step 2: List project for a hub」下のテキストボックスに入力して、Hub 配下にある全 Project を取得します。[List Projects] をクリックして、Revit から Data Connector でデータ交換（Data Exchange）を作成したプロジェクト フォルダがある Project ID（”id” の値）を書き留めておきます。（下図では Toshiaki-ACC-Project-0 プロジェクト）
- このクエリで返されるのは、プロジェクト管理者が「割り当てられた製品と権限」に Docs が割り当てられている場合です。また、アーカイブされたプロジェクトは返されません。
使用した GraphQL クエリ：
{
projects (hubId: "${hubId}") {
results {
name
id
}
}
}Step 3：Project フォルダ（Folder）一覧を取得する
Step 2 で 書き留めた Project ID を「Step 3: List Project Folders」下のテキストボックスに入力して、Project 直下の Folder を取得します。[List Project Folders ] をクリックして、Revit から Data Connector でデータ交換（Data Exchange）を作成したプロジェクト フォルダ（下図では Test フォルダ）の ID（”id” の値）を書き留めます。
使用した GraphQL クエリ：
{
project(projectId: "${projectId}") {
id
name
folders {
results {
id
name
__typename
folders {
results {
id
name
__typename
}
}
exchanges {
results {
id
name
__typename
}
}
}
}
}
}注：このリクエストのレスポンスには、Project 内の Folder と Exchange が含まれています。
Step 4：Folder 内のコンテンツ一覧を取得する
Step 3 で 書き留めた Folder ID を「Step 4: List Folder content」下のテキストボックスに入力して、[List Folder Content] をクリックし、表示されるレスポンスからデータ交換（Data Exchange）の Exchange ID（”id” の値）と fileUrn の値を書き留めます。
使用した GraphQL クエリ：
{
folder(folderId: "${folderId}") {
id
name
folders {
results {
id
name
__typename
}
}
exchanges {
results {
id
name
alternativeRepresentations {
fileUrn
fileVersionUrn
}
__typename
}
}
}
}Step 5a：Exchange ID から Exchange 情報を取得する
Step 4 で取得した Exchange ID を「Step 5a: Get Exchange info by ID」下のテキストボックスに入力して、Data Exchange のプロパティを取得します。[Get Exchange Information] をクリックしてください。
使用した GraphQL クエリ：
{
exchange(exchangeId: "${exchangeId}") {
id
name
version {
versionNumber
}
alternativeRepresentations {
fileUrn
fileVersionUrn
}
lineage {
versions {
results {
id
versionNumber
createdOn
}
}
tipVersion {
versionNumber
}
}
propertyDefinitions {
results {
id
name
specification
}
}
}
}Step 5b：Exchange FileUrn から Exchange 情報を取得する
データ交換（Data Exchange）の Exchange 情報は、Exchange FileUrn からも取得することが出来ます。手順 4 で取得した fileUrn の値を「Step 5b: Get Exchange info by exchangeFileUrn」下のテキストボックス入力して、[Get Exchange Information] をクリックし、Exchange のプロパティを一覧表示します。
使用した GraphQL クエリ：
{
exchangeByFileId(exchangeFileId: "${exchangeFileUrn}") {
id
name
version {
versionNumber
}
lineage {
versions {
results {
id
versionNumber
createdOn
}
}
tipVersion {
versionNumber
}
}
propertyDefinitions {
results {
id
name
specification
}
}
}
}サンプルで使用される実際の GparhQL は、https://github.com/autodesk-platform-services/aps-dx-samples-nodejs/blob/main/services/aps/dx.js で参照することが出来ます。なお、Code Sample の内容の公開後、一部仕様が変更されたため、Step 5a と Step 5b に記載された GraphQL 内のフィールド名が異なっています。（リポジトリ内の GraphQL 記述が更新されています。）
By Toshiaki Isezaki
You must be logged in to post a comment.