CSV 파일에서 활동 가져오기
활동 데이터가 포함된 CSV 형식의 텍스트 파일을 업로드하여 외부 소스에서 여러 활동을 Maintain으로 가져오고 파일을 활동으로 수집할 수 있습니다. 이러한 활동은 Maintain에서 생성된 활동과 마찬가지로 시각화하고 수정할 수 있습니다.
CSV 파일 템플릿 다운로드
가져온 CSV 파일은 프로젝트별 템플릿을 준수해야 합니다. maintain-import-template.csv를 다운로드하려면 다음과 같이 하십시오.
- 활동으로 이동하고 활동 추가를 선택합니다.
- 활동 가져오기를 선택합니다.
- 템플릿 다운로드를 선택합니다.
CSV 파일 템플릿 채우기
CSV 템플릿에는 가져온 활동에 제공할 수 있는 값을 나타내는 단일 행만 있습니다. 이 행은 머리글 행이라고 하며 템플릿을 채울 때 제거해서는 안 됩니다.
머리글 행을 제거해서는 안 되지만 머리글에서 특정 값을 제거하거나 값의 순서를 변경할 수는 있습니다. 예를 들어 특정 시나리오에서 가져오기와 관련이 없는 특정 필드를 머리글 행과 이후의 행에서 제거할 수 있습니다. 이렇게 하면 가져온 모든 활동에서 해당 필드가 비어 있게 됩니다.
단일 활동을 가져오려면 템플릿에 새 행을 추가하고 쉼표로 구분된 적절한 값을 입력합니다. 새 행의 각 값에는 템플릿에 제공된 각 머리글 행에 채우려는 값이 포함되어야 합니다.
예를 들어 템플릿에 머리글 행 title,status,department가 포함된 경우 다음과 같은 추가 행이 있는 CSV 파일을 생성합니다.
title,status,department
Erect scaffolding,Done,Rigging
가져올 때 title 필드는 "Erect scaffolding", status 필드는 "Done," department 필드는 "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에서는 3D 모델, 문서, PSN 등에서 활동을 컨텍스트화하는 데 사용되는 CDF 자산에 활동을 연결할 수 있도록 지원합니다. 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 파일과 일치하도록 올바르게 보이는지 확인합니다.