メイン コンテンツにスキップする

CSV ファイルからアクティビティをインポートする

外部ソースから複数のアクティビティを、アクティビティ データを含む CSV 形式のテキスト ファイルをアップロードして Maintain にインポートし、アクティビティに取り込みます。インポートされたアクティビティは、Maintain で作成されたアクティビティとして可視化および変更できます。

CSV ファイル テンプレートをダウンロードする​

インポートする CSV ファイルは、プロジェクト固有のテンプレートに準拠している必要があります。maintain-import-template.csvのダウンロードは以下の手順で行います。

  1. アクティビティに移動してアクティビティの追加を選択します。
  2. アクティビティのインポートを選択します。
  3. テンプレートのダウンロードを選択します。

CSV ファイル テンプレートに値を入力する​

CSV テンプレートには、インポートされるアクティビティに提供できる値を表す単一の行のみが含まれます。この行はヘッダー行と呼ばれ、テンプレートに入力する際に削除しないようにしてください。

ヒント

ヘッダー行は削除してはいけませんが、ヘッダーから特定の値を削除したり、値の順序を変更したりすることはできます。たとえば、特定のシナリオでインポートが不要なフィールドがある場合、そのフィールドをヘッダーおよびその後の行から削除することができます。これにより、インポートされたすべてのアクティビティでそのフィールドが空白のままになります。

1 つのアクティビティをインポートするには、テンプレートに新しい行を追加し、カンマで区切られた適切な値を入力します。新しい行の各値には、テンプレートで指定されたそれぞれのヘッダー行に入力したい値を含める必要があります。

たとえば、テンプレートに次のヘッダー行が含まれている場合: title,status,department、追加の行を含む CSV ファイルを作成します。

title,status,department
Erect scaffolding,Done,Rigging

インポートすると、「Erect scaffolding」というタイトル、「完了」というステータス、「Rigging」という部門のアクティビティが作成されます。

日付フィールドをフォーマットする​

Maintain の一部のアクティビティ フィールドは日付を表しており、正しくインポートするためには特定のフォーマットが必要です。日付フィールドは CSV テンプレート内で、startTime (DD/MM/YYYY) という形式の特別なヘッダー値によって識別されます。この例では、startTime がフィールド名で、DD/MM/YYYY が CSV ファイルのその後の行で使用する日付フォーマットです。

たとえば、次のファイルをインポートすると、startTime を 2023 年 12 月 10 日に設定したアクティビティが作成されます。

title,startTime (DD/MM/YYYY)
Erect scaffolding,10/12/2023

ブール値フィールドのフォーマット​

Maintain のアクティビティ フィールドの中には、true や false などのブール値を表すものがあります。日付フィールドは CSV テンプレート内で、isActive (true/false) という形式の特別なヘッダー値によって識別されます。これらのフィールドには、有効な値が true または false の 2 つのしかありません。

たとえば、次のファイルをインポートすると、isActive を false に設定したアクティビティが作成されます。

title,isActive (true/false)
Erect scaffolding,false

カンマを含む値のフォーマット​

CSV フォーマットでは値をカンマで区切るため、アクティビティ フィールドにカンマを含める必要がある場合は注意が必要です。Maintain はRFC 4180 標準に従って CSV ファイルを処理します。そのため、カンマを含む値を二重引用符で囲む必要があります。

たとえば、次のファイルをインポートすると、city を Boston, MA に設定したアクティビティが作成されます。

title,city
Erect scaffolding,"Boston, MA"

未設定の値​

必須でないアクティビティ フィールドでは、その特定のアクティビティに対して欠落しているか関連性のない値を表すためにフィールドを空白のままにしておくことができます。

たとえば、次のファイルをインポートすると、state を New York に設定したアクティビティが作成されますが、city フィールドには値がありません。

title,city,state
Erect scaffolding,New York

アクティビティをアセットに接続する​

Maintain はアクティビティを CDF アセットにリンクさせる処理に対応しており、これによりアクティビティを 3D モデル、ドキュメント、PSN などでコンテキスト化することができます。Maintain が CDF 内のアセットへの適切なリンクを作成するには、インポート テンプレートに CDF アセットの外部 ID を指定する必要があります。

プロジェクトにアセットのコンテキスト化がある場合、テンプレートにはアクティビティのアセットの外部 ID を入力するための特別な assetExternalId フィールドがあります。

たとえば、以下のファイルをインポートし、外部 ID が NY_BUILDING_23 の CDF アセットが存在する場合、アクティビティは Maintain に取り込まれる際にこのアセットにコンテキスト化されます。

title,assetExternalId
Erect scaffolding,NY_BUILDING_23

提供された外部 ID がエクスポートされない場合は、インポート中にユーザーの画面にエラーが表示されます。

ヒント

エンドユーザーは、アクティビティがリンクされたアセットの外部 ID を知らない場合があります。エンドユーザーに可能なアセットとその外部 ID のリストを提供する必要がある場合は、CDF のアセット API や他のデータ抽出ツールを使用してこのデータを取得することをお勧めします。

データが入力された CSV ファイルをインポートする​

CSV テンプレートにデータを入力したら、Maintain にインポートできます。

  1. アクティビティ > アクティビティの追加に移動します。
  2. アクティビティのインポートを選択します。
  3. インポートする CSV ファイルをクリックして選択しますフィールドを選択します。
  4. データが入力された CSV ファイルをコンピューターから選択してアップロードします。
  5. ファイル インスペクターセクションで、ファイルがインポートされたことを確認します。緑色のメッセージが表示され、インポートされる行数と、警告やエラーがあるかどうかが示されます。
  6. エラーがなければ、インポートを選択してインポート処理を開始します。
  7. インポートが成功すると、アクティビティを表示ボタンとともに緑色の成功メッセージが表示されます。
  8. オプション。アクティビティを表示を選択して、インポートされたアクティビティに移動し、それらが CSV ファイルに基づいて正しく表示されているか確認してください。
最後の更新: