ガイドブック
付録
建築シーン — デバイスと空間の関係 Excel テンプレート
本 Excel テンプレートは、デバイスおよび空間のデジタルツインを一括で作成・管理し、デバイス間の業務関係、空間の階層構造、さらに空間とシーンの関連情報を設定するためのものです。
テンプレートには デバイス と 空間 の 2 つのシートが含まれており、用途に応じてそれぞれ入力してください。
A.1 記入上の注意
- 表内の各行は、それぞれ1つのデジタルツイン（設備または空間）を表しています。
- デジタルツインの名称は重複して設定することはできません。
- 入力したIDがすでに存在する場合、新しくインポートされたデータによって過去のデータが上書きされます。インポートを行う前に、あらかじめバックアップをエクスポートしておくことを推奨します。
- インポートを行う前に、必要なデジタルツインのテンプレートおよび空間シーンを事前に作成しておくことを推奨します。
- 表内の黄色くハイライトされた行はサンプル（例）です。指定された行から入力を開始してください。
- 1つのデジタルツインシーンにバインドできる建築シーンは、1つのみとなります。
- 該当のテナント内に同名のテンプレートが存在する場合は、FactVerse プラットフォームのテンプレート詳細ページから該当テンプレートの完全なパス（ルート）をコピーして記入する必要があります。完全なパスが記入されていない場合、エラーが発生します。
A.2 デバイスシート（デバイスツイン）
デバイスツインを作成し、デバイス間またはデバイスと空間間の業務関係を設定します。
主な項目
項目名 | 必須入力 | 説明 |
ID |
| 建築データディレクトリ内のツインモデルと照合し、新規追加、更新、或者は削除の操作を実行するために使用します。 • ID が空の場合：新しいツインモデルが自動的に作成されます（同名のツインモデルがある場合を除く）。 • ID が空ではないの場合：システムはまず該当する ID がすでに存在するかどうかを検証します。存在する場合は該当するツインモデルの更新または削除を行い、存在しない場合は新しいツインモデルを作成します。 |
ツインモデル | ✅ | 設備名。作成後、建築シーン内の非表示フォルダに保存されます。。 |
所属システム |
| 設備が所属するシステム（例：空調、電力）。1 デバイスにつき 1 システムのみ指定可能です。 |
目標デジタルツイン |
| 当該デバイスと業務関係を持つツイン（デバイスまたは空間） |
目標デジタルツイン |
| 当該デバイスと業務関係を持つツイン（デバイスまたは空間） |
関係の説明 |
| 関係の簡単な説明（例：「給水関係」「制御関係」） ⚠️ 注意：「ターゲットツイン」を入力する場合は「関係タイプ」の入力が必須となります。「ターゲットツイン」が未入力の場合、「関係タイプ」は入力できません。 |
ツインテンプレート | ✅ | 設備が使用するツインテンプレートの名称です。 入力形式：[ディレクトリ/]*ファイル名 • ディレクトリ：任意入力。ファイルが保存されているディレクトリを指定します。 • ファイル名：必須入力。引用または検索するファイルの名前を指定します。 完全なディレクトリを入力することで、同名のツインテンプレートを識別できます。 • ディレクトリ未入力時：システムはグローバル（全域）でテンプレートを検索します。 • ディレクトリ入力時：システムは指定されたディレクトリ内でのみ該当テンプレートを検索します。 |
姿勢属性 |
| 3D シーン内でのデバイスの位置・向き |
BIM 構成要素属性名／値 |
| デバイスツインを BIM 構成要素に紐付けるための項目（1 構成要素につき 1 デバイスのみ紐付可） |
ツインモデルの削除 |
| ツインモデルを物理削除するかどうかをマークするために使用します。「1」を入力すると、該当のツインモデルがディレクトリから完全に削除されます。 ※注意：削除を実行する場合、ID を空にすることはできません（必須入力）。 |
サポートされる業務関係タイプ（Brick Schema）
- feeds：サービス／リソース／データを提供
- hasPart：構成要素として含む
- hasPoint：監視点または制御点を持つ
- hasLocation：デバイスが所属する空間
注意事項
- 「目標デジタルツイン」を入力する場合は、必ず対応する「関係タイプ」を選択してください。
- 目標デジタルツインが未入力の場合、「関係タイプ」は入力できません。
A.3 空間シート（空間ツイン）
空間ツインを作成し、園区、建物、階層、部屋などの空間階層構造を構築します。
主な項目
項目名 | 必须入力 | 説明 |
ID |
| 建築データディレクトリ内のデジタルツインと照合し、新規追加、更新、または削除の操作を実行するために使用します。 • ID が空の場合：新しいデジタルツインが自動的に作成されます（同名のデジタルツインがある場合を除く）。 • ID が空ではないの場合：システムはまず該当する ID がすでに存在するかどうかを検証します。存在する場合は該当するデジタルツインの更新または削除を行い、存在しない場合は新しいデジタルツインを作成します。 |
ツインモデル | ✅ | スペース名です。重複して設定することはできません。 |
シーン名 |
| 該当スペースにバインドするツインシーンの名称です。事前に作成しておく必要があります。 |
ルートノード判定 |
| 空間構造における開始ノード（最上位ノード）であるかどうかをマークします。 |
スペースタイプ |
| 空間の階層タイプです（例：パーク / 建築 / フロア / ルーム）。 |
ターゲットツイン |
| 現在のスペースと組織関係（親子・所属関係など）を持つスペースツインモデルです。 |
関係タイプ |
| 空間の組織関係のタイプです。 |
組織関係の説明 |
| 空間の階層関係に関する説明です。 |
ツインテンプレート | ✅ | スペースツインモデルが使用するテンプレートです。 入力形式：[ディレクトリ/]*ファイル名 • ディレクトリ：任意入力。ファイルが保存されているディレクトリを指定します。 • ファイル名：必須入力。引用または検索するファイルの名前を指定します。 完全なディレクトリを入力することで、同名のツインテンプレートを識別できます。 • ディレクトリ未入力時：システムはグローバル（全域）でテンプレートを検索します。 • ディレクトリ入力時：システムは指定されたディレクトリ内でのみ該当テンプレートを検索します。 |
ポーズ属性 |
| 3Dシーン内における空間の位置（Position）および向き（Rotation）です。 |
削除判定 |
| ツインモデルを物理削除するかどうかをマークするために使用します。「1」を入力すると、該当のツインモデルがディレクトリから完全に削除されます。 ※注意：削除を実行する場合、ID を空にすることはできません（必須入力）。 |
A.4 重要項目の説明
1. 根ノードか
空間構造の開始点（例：園区）を指定します。Inspector での空間読み込みに影響します。
- 各空間構造には必ず 1 つの根ノードが必要です。
- 設定が不適切な場合、Inspector で空間構造が正しく表示されません。
例：
園区（根ノード）
├── 建物 A
│ ├── 階 1
│ └── 階 2
└── 建物 B
2. シーン名
空間ツインを特定のツインシーンに紐付け、Inspector でのシーン遷移やオンデマンド読み込みを可能にします。
- 指定したシーンは Inspector で表示される 3D コンテンツです。
- 入力すると、Inspector で該当空間をクリックした際、指定したシーンへ遷移できます。
- 未入力の場合は自動で紐付けされません。インポート後、「建築シーン詳細ページ → デバイス空間関係」から手動設定が可能です。
⚠️ 遷移が必要な空間のみ入力してください。
3. 姿勢属性
ツインの 3D シーン内での位置および向きを定義します。正確な表示のため必須です。
例フォーマット：
{“[PresetPart]PhysicsInfo|pos”: “0.0,1.5,0.0”, “[PresetPart]PhysicsInfo|rot”: “0.0,0.0,0.0”}
- [PresetPart]PhysicsInfo|pos：位置（単位：メートル）
- [PresetPart]PhysicsInfo|rot：回転角（単位：度）
未入力の場合、システムはデフォルト値を使用するため、ツインの位置や向きが期待通りにならない可能性があります。