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

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

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

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

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

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

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

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

**Maintain**の一部の活動フィールドは日付を表しており、適切にインポートするには特定の形式である必要があります。日付フィールドは CSV テンプレート内で、startTime (DD/MM/YYYY) という形式の特別なヘッダー値によって識別されます。この例では、startTime がフィールド名で、DD/MM/YYYY が CSV ファイルのその後の行で使用する日付フォーマットです。 例えば、以下のファイルをインポートすると、startTimeが2023年12月10日に設定されたアクティビティが作成されます。

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

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

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

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

​
未設定の値

必須でないアクティビティ フィールドでは、その特定のアクティビティに対して欠落しているか関連性のない値を表すためにフィールドを空白のままにしておくことができます。 たとえば、次のファイルをインポートすると、state を New York に設定したアクティビティが作成されますが、city フィールドには値がありません。

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

**Maintainは、アクティビティをCDFアセットにリンクすることをサポートしており、これは3Dモデル、ドキュメント、PSNなどでアクティビティをコンテキスト化するために使用されます。Maintain**がCDF内のアセットへの適切なリンクを作成するには、インポートテンプレートにCDFアセットの外部IDを提供する必要があります。 プロジェクトにアセットのコンテキスト化がある場合、テンプレートにはアクティビティのアセットの外部 ID を入力するための特別な assetExternalId フィールドがあります。 例えば、以下のファイルをインポートする際、外部ID NY_BUILDING_23を持つCDFアセットが存在すると仮定すると、Maintainに取り込まれたときにアクティビティはこのアセットに関連付けられます。
提供された外部 ID がエクスポートされない場合は、インポート中にユーザーの画面にエラーが表示されます。
エンドユーザーは、アクティビティがリンクされている資産の外部IDを知らない場合があります。エンドユーザーに可能なアセットとその外部IDのリストを提供する必要がある場合は、CDFのアセットAPIまたはその他のデータ抽出ツールを使用してこのデータを取得することをお勧めします。
3

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

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

​
Cognite Toolkit経由でインポートします

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

​
前提条件

Cognite Toolkit経由でアクティビティをインポートする前に、以下が準備されていることを確認してください：
  • データモデルスペースで構成されたカスタムアクティビティビュー（またはcdf_idmの標準CogniteMaintenanceOrderビューを使用）
  • viewMappingsの下のMaintain構成でマッピングされたアクティビティビュー
  • Cognite Toolkitへのアクセス権

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

Maintain構成で、viewMappingsセクションがアクティビティビューを指していることを確認します：
カスタムアクティビティビュー（例：APM_ActivityまたはExtendedActivity）を作成した場合は、マッピングを更新してカスタムビューを指すようにします：
データモデルの拡張およびビューマッピングの構成の詳細をご覧ください。

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

IDMモードでアクティビティを取り込むには、推奨されるアプローチであるCognite Toolkitを使用してください。
1

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

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

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

アクティビティノードにMaintainに必要なフィールドが含まれていることを確認してください：
Maintainのフィールド設定設定に基づいて、追加フィールドを含めます。
3

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

Cognite Toolkitを使用してアクティビティデータをデプロイします：
既存のアクティビティを置き換える必要がある場合は、--drop-dataフラグを使用してください：
詳細はこちら Cognite Toolkitのデプロイメントフラグ.
4

メンテナンスで確認する

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

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

モードの可用性:APMおよびIDM/CDMモード。これはバルクデータに推奨されるアプローチです。
または、CDF Transformationsを使用して、RAWテーブルやその他のソースからアクティビティノードにデータを変換することもできます。

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

取り込み後に活動に問題が発生した場合は、原因と修正の表を参照してください。
最終更新日 2026年9月8日