활동을 Maintain로 가져오기

Maintain은 활동을 가져오는 세 가지 방법을 지원합니다:

CSV 업로드: 사용자 인터페이스(APM 모드 전용)를 사용하여 활동을 가져옵니다.
Cognite Toolkit: Cognite Toolkit 데이터 모델링(APM 및 IDM/CDM 모드)을 사용하여 활동을 수집합니다.
변환: CDF 변환(APM 및 IDM/CDM 모드)을 사용하여 RAW 테이블 또는 기타 소스에서 데이터를 변환합니다.

CSV 업로드(APM 모드)를 통해 가져오기

모드 가용성: APM 모드 전용입니다. IDM/CDM 모드는 사용자 인터페이스에서 CSV 가져오기를 지원하지 않습니다.

CSV를 통해 가져온 활동은 Maintain에서 생성된 활동으로 시각화하고 수정할 수 있습니다.

CSV 파일 템플릿을 다운로드하십시오

가져온 CSV 파일은 프로젝트별 템플릿에 맞춰야 합니다. maintain-import-template.csv를 다운로드하려면:

활동로 이동하여 활동 추가를 선택합니다.
활동 가져오기를 선택합니다.
템플릿 다운로드를 선택합니다.

CSV 파일 템플릿을 작성하십시오

CSV 템플릿은 가져온 활동에 제공할 수 있는 가능한 값을 나타내는 단일 행의 값만 포함됩니다. 이 행은 헤더 행이라고 하며 템플릿을 채울 때 제거해서는 안 됩니다.

헤더 행은 제거하면 안 되지만, 헤더에서 특정 값을 제거하거나 값의 순서를 변경할 수 있습니다. 예를 들어, 특정 필드가 특정 시나리오에서 가져오는 데 관련이 없다면, 헤더와 후속 행에서 해당 필드를 제거할 수 있습니다. 이로 인해 모든 가져온 활동에서 필드가 비어 있게 됩니다.

단일 활동을 가져오려면 템플릿에 새 행을 추가하고 적절한 값을 쉼표로 구분하여 입력하십시오. 새 행의 각 값은 템플릿에서 제공된 해당 헤더 행에 채우고자 하는 값을 포함해야 합니다. 예를 들어, 템플릿에 다음 헤더 행이 포함된 경우: title,status,department, 추가 행이 있는 CSV 파일을 만듭니다:

title,status,department
Erect scaffolding,Done,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라는 두 가지 유효한 값만 있습니다. 예를 들어, 다음 파일을 가져오면 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**로 가져올 수 있습니다:

활동 > 활동 추가로 이동합니다.
활동 가져오기를 선택합니다.
클릭하여 가져올 CSV 파일 선택 필드를 선택합니다.
컴퓨터에서 채워진 CSV 파일을 선택하고 업로드하십시오.
파일 검사기 섹션을 확인하여 파일을 가져왔는지 확인합니다. 가져올 행 수와 경고 또는 오류가 있는 경우 초록색 메시지가 표시되어야 합니다.
오류가 없으면 가져오기를 선택하여 가져오기 프로세스를 시작합니다.
가져오기가 성공하면 활동 보기 버튼이 포함된 녹색 성공 메시지가 표시됩니다.
선택 사항입니다. 활동 보기를 선택하여 가져온 활동으로 이동하고 CSV 파일에 따라 올바르게 표시되는지 확인합니다.

Cognite Toolkit을 통한 가져오기

모드 가용성: APM 및 IDM/CDM 모드. 이것은 프로그래밍 방식의 활동 수집을 위한 권장 접근 방식입니다.

Cognite Toolkit을 사용하여 CDF의 데이터 모델링 기능을 통해 활동을 수집합니다. 이 방법은 두 배포 모드 모두에서 작동하며 버전 관리 및 재현 가능한 배포를 제공합니다.

전제 조건

Cognite Toolkit을 통해 활동을 가져오기 전에 다음 사항을 확인하십시오:

데이터 모델 공간에 구성된 사용자 지정 활동 보기(또는 cdf_idm의 표준 CogniteMaintenanceOrder 보기 사용)
viewMappings 아래의 Maintain 구성에 매핑된 활동 보기
Cognite Toolkit에 대한 액세스

활동 뷰 매핑 구성

Maintain 구성에서 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을 사용하십시오.

활동 데이터 구조를 생성하십시오

아직 하지 않았다면, 활동을 위한 컨테이너, 뷰 및 노드 YAML 파일을 생성하십시오. 표준 데이터 모델링 구조를 따르십시오:

APM_Activity.Container.yaml - 컨테이너 스키마를 정의합니다
APM_Activity.View.yaml - 뷰 속성 및 관계를 정의합니다
apmActivities.Node.yaml - 활동 인스턴스를 포함합니다 자세한 예제 및 템플릿은 Cognite Toolkit 설명서를 참조하십시오.

필드 매핑을 구성하십시오

활동 노드에 Maintain에 필요한 필드가 포함되어 있는지 확인하십시오:

필드	설명	필수
`externalId`	활동에 대한 고유 식별자	예
`title`	활동 제목	예
`status`	활동 상태(예: “Open”, “In Progress”, “Done”)	권장
`startTime`	시작 날짜/시간	권장
`endTime`	종료 날짜/시간	권장
`rootLocation`	루트 위치 식별자	권장
`assetExternalId`	연결된 자산의 외부 ID	선택 사항
`mainAsset`	자산과의 직접적인 관계	선택 사항

Maintain의 필드 구성 설정에 따라 추가 필드를 포함하십시오.

활동을 배포하십시오

Cognite Toolkit을 사용하여 활동 데이터를 배포하십시오:

cdf deploy --env dev

기존 활동을 대체해야 하는 경우 --drop-data 플래그를 사용하십시오:

cdf deploy --env dev --drop-data

Cognite Toolkit 배포 플래그에 대해 자세히 알아보십시오.

Maintain에서 확인하기

Maintain에 로그인하십시오.
활동으로 이동하십시오.
가져온 활동이 올바른 데이터와 함께 나타나는지 확인하십시오.

변환을 통해 활동 수집

모드 가용성: APM 및 IDM/CDM 모드. 이는 대량 데이터에 권장되는 접근 방식입니다.

또는 CDF 변환을 사용하여 RAW 테이블이나 다른 소스의 데이터를 활동 노드로 변환할 수 있습니다.

문제 해결

가져온 후 활동에 문제가 발생하면 원인 및 수정 사항에 대한 표를 참조하십시오.

문제	해결 방법
활동이 표시되지 않음	`viewMappings` 구성이 올바른 공간, 뷰 및 버전을 가리키는지 확인하십시오
누락된 필드	필드 구성에 수집 중인 모든 필드가 포함되어 있는지 확인하십시오
자산 링크 끊김	`assetExternalId` 또는 `mainAsset` 관계가 기존 자산을 가리키는지 확인하십시오
잘못된 루트 위치	`rootLocation`이 위치 구성과 일치하는지 확인하십시오

Flows

InField

Maintain

외부 리소스

활동을 Maintain로 가져오기

CSV 업로드(APM 모드)를 통해 가져오기

날짜 필드 형식 지정

부울 필드 형식 지정

쉼표가 포함된 값 형식화

값 해제

활동을 자산에 연결

Cognite Toolkit을 통한 가져오기

전제 조건

활동 뷰 매핑 구성

Cognite Toolkit을 사용하여 활동 수집

변환을 통해 활동 수집

문제 해결

​CSV 업로드(APM 모드)를 통해 가져오기

​날짜 필드 형식 지정

​부울 필드 형식 지정

​쉼표가 포함된 값 형식화

​값 해제

​활동을 자산에 연결

​Cognite Toolkit을 통한 가져오기

​전제 조건

​활동 뷰 매핑 구성

​Cognite Toolkit을 사용하여 활동 수집

​변환을 통해 활동 수집

​문제 해결

CSV 업로드(APM 모드)를 통해 가져오기

날짜 필드 형식 지정

부울 필드 형식 지정

쉼표가 포함된 값 형식화

값 해제

활동을 자산에 연결

Cognite Toolkit을 통한 가져오기

전제 조건

활동 뷰 매핑 구성

Cognite Toolkit을 사용하여 활동 수집

변환을 통해 활동 수집

문제 해결