メインコンテンツへスキップ
メンテインは、アクティビティをインポートするための3つの方法をサポートしています：
  • CSVアップロード：ユーザーインターフェース（APMモードのみ）を使用してアクティビティをインポートします。
  • Cognite Toolkit：Cognite Toolkitデータモデリング（APMおよびIDM/CDMモード）を使用してアクティビティを取り込みます。
  • Transformations：RAWテーブルまたは他のソースからデータを変換するには、CDF Transformations（APMおよびIDM/CDMモード）を使用します。

​
CSVアップロードを介してインポート（APMモード）

モードの利用可能性：APMモードのみ。IDM/CDMモードは、ユーザーインターフェースでのCSVインポートをサポートしていません。
CSV経由でインポートされたアクティビティは、メンテインで作成されたアクティビティとして視覚化および修正できます。
1

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

インポートされたCSVファイルは、プロジェクト固有のテンプレートに準拠する必要があります。maintain-import-template.csvのダウンロードは以下の手順で行います。
  1. アクティビティに移動してアクティビティの追加を選択します。
  2. アクティビティのインポートを選択します。
  3. テンプレートをダウンロードを選択します。
2

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

CSV テンプレートには、インポートされるアクティビティに提供できる値を表す単一の行のみが含まれます。この行はヘッダー行と呼ばれ、テンプレートに入力する際に削除しないようにしてください。
ヘッダー行は削除してはいけませんが、ヘッダーから特定の値を削除したり、値の順序を変更したりすることはできます。たとえば、特定のシナリオでインポートが不要なフィールドがある場合、そのフィールドをヘッダーおよびその後の行から削除することができます。これにより、インポートされたすべてのアクティビティでそのフィールドが空白のままになります。
1 つのアクティビティをインポートするには、テンプレートに新しい行を追加し、カンマで区切られた適切な値を入力します。新しい行の各値には、テンプレートで指定されたそれぞれのヘッダー行に入力したい値を含める必要があります。 例えば、テンプレートに次のヘッダー行が含まれている場合：タイトル、ステータス、部門、追加の行を持つCSVファイルを作成します：
タイトル、ステータス、部門
足場を設置、完了、リギング
インポートすると、「Erect scaffolding」というタイトル、「完了」というステータス、「Rigging」という部門のアクティビティが作成されます。

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

メンテインの一部のアクティビティフィールドは日付を表し、正しくインポートするためには特定の形式を持つ必要があります。CSVテンプレートの日時フィールドは、startTime (DD/MM/YYYY)という特別なヘッダー値によって識別できます。この例では、startTimeがフィールドの名前であり、DD/MM/YYYYがCSVファイルの後続の行で使用する必要がある日付形式です。 例えば、次のファイルをインポートすると、活動がstartTimeを2023年12月10日に設定して作成されます。
title,startTime (DD/MM/YYYY)
足場を設置する,10/12/2023

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

Maintainの一部の活動フィールドは、trueやfalseのようなブール値を表します。ブールフィールドは、CSVテンプレートのisActive (true/false)という特別なヘッダー値によって識別できます。これらのフィールドには、trueまたはfalseの2つの有効な値しかありません。 例えば、次のファイルをインポートすると、活動がisActiveをfalseに設定して作成されます。
title,isActive (true/false)
足場を設置する,false

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

CSV形式は値をカンマで区切るため、活動フィールドにもカンマが含まれる必要がある場合は注意してください。Maintainは、RFC 4180標準に従ってCSVファイルを処理し、カンマを含む値は二重引用符で囲む必要があります。 例えば、次のファイルをインポートすると、活動がcityをBoston, MAに設定して作成されます。
title,city
足場を設置する,"Boston, MA"

​
未設定の値

必須でないアクティビティ フィールドでは、その特定のアクティビティに対して欠落しているか関連性のない値を表すためにフィールドを空白のままにしておくことができます。 例えば、次のファイルをインポートすると、活動がstateをNew Yorkに設定して作成されますが、cityフィールドには値がありません。
title,city,state
足場を設置する,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または他のデータ抽出ツールを使用してこのデータを取得することをお勧めします。
3

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

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

​
Cognite Toolkitを介してインポート

モードの利用可能性：APMおよびIDM/CDMモード。これは、プログラムによるアクティビティの取り込みに推奨されるアプローチです。
Cognite Toolkitを使用して、CDFのデータモデリング機能を通じてアクティビティを取り込みます。この方法は、両方のデプロイメントモードで機能し、バージョン管理と再現可能なデプロイメントを提供します。

​
前提条件

Cognite Toolkitを介してアクティビティをインポートする前に、次のことを確認してください：
  • データモデルスペースにカスタムアクティビティビューが設定されていること（またはCogniteMaintenanceOrderの標準ビューを使用すること）。
  • アクティビティビューがviewMappingsのメンテナンス設定にマッピングされていること。
  • Cognite Toolkitへのアクセス

​
アクティビティビューのマッピングを設定する

メンテナンス設定で、viewMappingsセクションがアクティビティビューを指していることを確認します： 
{
  "viewMappings": {
    "activity": {
      "type": "view",
      "space": "cdf_idm",
      "version": "v1",
      "externalId": "CogniteMaintenanceOrder"
    }
  }
}
カスタムアクティビティビュー（例えば、APM_ActivityまたはExtendedActivity）を作成した場合は、マッピングを更新してカスタムビューを指すようにします： 
{
  "viewMappings": {
    "activity": {
      "type": "view",
      "space": "maintain_schema_extention",
      "version": "v1",
      "externalId": "APM_Activity"
    }
  }
}
データモデルの拡張とビューマッピングの設定について詳しく学びましょう。

​
Cognite Toolkitを使用してアクティビティを取り込みます。

IDMモードでアクティビティを取り込むための推奨アプローチとして、Cognite Toolkitを使用してください。
1

アクティビティデータ構造を作成する

まだ作成していない場合は、アクティビティ用のコンテナ、ビュー、およびノードのYAMLファイルを作成してください。標準のデータモデリング構造に従ってください：
  • APM_Activity.Container.yaml - コンテナスキーマを定義します。
  • APM_Activity.View.yaml - ビューのプロパティと関係を定義します。
  • apmActivities.Node.yaml - アクティビティインスタンスを含みます。 詳細な例とテンプレートについては、Cognite Toolkitのドキュメントを参照してください。
2

フィールドマッピングを設定する

アクティビティノードにMaintainの必須フィールドが含まれていることを確認してください：
フィールド説明必須
externalIdアクティビティの一意の識別子はい
titleアクティビティのタイトルはい
statusアクティビティのステータス（例：“オープン”、“進行中”、“完了”）推奨
startTime開始日/時刻推奨
endTime終了日/時刻推奨
rootLocationルートロケーション識別子推奨
assetExternalIdリンクされた資産の外部ID任意
mainAsset資産との直接的な関係任意
Maintainのフィールド設定に基づいて追加のフィールドを含めてください。
3

アクティビティを展開する

Cognite Toolkitを使用してアクティビティデータをデプロイします： bash cdf deploy --env dev 既存のアクティビティを置き換える必要がある場合は、--drop-dataフラグを使用してください： bash cdf deploy --env dev --drop-data Cognite Toolkitのデプロイフラグについて詳しく学びましょう。
4

メンテナンスで確認する

1.Maintainにサインインします。2.アクティビティに移動します。3.インポートしたアクティビティが正しいデータで表示されることを確認してください。

​
変換を伴う取り込み活動

モードの利用可能性：APMおよびIDM/CDMモード。これはバルクデータに推奨されるアプローチです。
代わりに、CDF Transformationsを使用して、RAWテーブルや他のソースからデータを活動ノードに変換できます。

​
トラブルシューティング

取り込み後に活動に問題が発生した場合は、原因と修正の表を参照してください。
問題解決策
活動が表示されないviewMappingsの設定が正しいスペース、ビュー、およびバージョンを指していることを確認してください
欠落しているフィールド取り込んでいるすべてのフィールドがフィールド設定に含まれていることを確認してください
アセットリンクが壊れているassetExternalIdまたはmainAssetの関係が既存のアセットを指していることを確認してください
誤ったルート位置rootLocationがあなたの位置設定と一致していることを確認してください
Last modified on June 1, 2026