소개
Oracle Integration을 설정하고 CupixWorks에 등록하면 Oracle Primavera Cloud(OPC) 일정과 SiteInsights 진행률 데이터를 동기화할 수 있습니다. 이 워크플로는 세 부분으로 구성됩니다.
- OPC 일정을 SiteInsights로 가져오기 — SiteInsights Schedule 편집기의 Load and Update by OPC Schedule 옵션을 사용합니다. OPC에서 가져온 액티비티는 미리 구성해 둔 CupixWorks 태스크에 자동으로 매핑됩니다.
- SiteInsights 진행률 결과를 OPC로 내보내기 — OPC 액티비티 뷰에 Cupix Capture Date, Cupix Reported Progress, Link to Cupix 세 개의 열이 새로 기록됩니다.
- 일정 다시 동기화 — OPC 쪽에서 액티비티나 날짜가 변경되면 동일한 Load and Update by OPC Schedule 작업을 사용합니다.
참고: 이 문서는 Oracle Integration이 CupixWorks에 이미 등록되어 있다고 가정합니다. 연동을 설정하려면 Oracle Integration 문서를 참조하세요.
사전 요구 사항
OPC 일정 동기화를 사용하기 전에 다음을 확인합니다.
- CupixWorks Project Admin Center의 Project Setup → Integrations에서 Oracle Integration이 등록되어 있고 활성화되어 있습니다.
- CupixWorks 프로젝트가 올바른 Oracle Primavera Cloud 프로젝트와 연결되어 있습니다.
- 프로젝트에 SiteInsights가 활성화되어 있고 BIM, 레벨, 작업 구역, 카테고리, 태스크가 구성되어 있습니다. OPC 액티비티는 미리 구성된 이 태스크에 매핑되므로 태스크가 먼저 존재해야 합니다. SiteInsights 설정 방법은 SiteInsights Setup Guide를 참조하세요.
- Schedule Setup을 편집하고 SiteInsights 대시보드에서 Export를 실행할 수 있는 Project Admin 권한이 있습니다.
OPC 일정 가져오기
OPC 일정 가져오기는 Schedule 편집기의 Update 메뉴에서 ScheduleSyncer, WBS Schedule, CSV 가져오기와 함께 제공되는 옵션 중 하나입니다. 이 옵션을 선택하면 연결된 Oracle Primavera Cloud 프로젝트에서 액티비티를 바로 가져와 미리 구성한 CupixWorks 태스크에 자동으로 매핑합니다.
OPC 일정을 가져오는 방법은 다음과 같습니다.
- Project Setup → SiteInsights → Schedule로 이동한 후 오른쪽 위의 Edit를 클릭합니다.
- 편집 모드에서 일정 표 위쪽의 Update를 클릭합니다. 메뉴에는 ScheduleSyncer (BETA), Load and Update by OPC Schedule, Load and Update by WBS Schedule, Import CSV, Import Simple CSV의 다섯 가지 옵션이 표시됩니다.
- Load and Update by OPC Schedule을 선택합니다.
- 일정 표가 OPC에서 가져온 액티비티로 채워집니다. Activity ID, Activity Name, Level, Work Area, Vendor, Start Date, End Date 열은 OPC 액티비티와 CupixWorks 태스크 간의 매핑에 따라 자동으로 입력됩니다.
- 가져온 일정을 검토합니다. 시작일이나 종료일이 없는 태스크가 있으면 CupixWorks가 표 위쪽에 경고 배너를 표시합니다(예: "Start dates are missing for 2026 tasks. End dates are missing for 2026 tasks.").
- Save를 클릭하여 확정합니다.
사용자 지정 지시문으로 AI 매핑 다듬기
OPC와 CupixWorks 간의 액티비티 매핑은 AI의 지원을 받습니다. 명명 규칙이 크게 다른 프로젝트(예: "L2"와 "Level 2", "T1-N"과 "Tower 1 North")에서는 ScheduleSyncer를 통해 사용자 지정 지시문을 추가하여 AI의 동작을 다듬을 수 있습니다.
사용자 지정 지시문은 선택 사항입니다. 지시문이 없어도 AI는 사전 학습된 명명 규칙 지식을 바탕으로 대부분의 액티비티를 올바르게 매핑합니다. 다음과 같은 경우에 지시문 추가가 유용합니다.
- OPC 액티비티가 CupixWorks의 Level, Work Area, Category 이름과 바로 일치하지 않는 약어나 코드를 사용하는 경우.
- 동일한 OPC 프로젝트를 반복해서 다시 동기화하며 AI가 실행 간에 매핑 규칙을 기억하도록 하려는 경우.
- 첫 번째 가져오기에서 Areas 또는 BIM Categories and Trades 탭의 매칭 신뢰도가 낮게 나온 경우.
사용자 지정 지시문을 설정하거나 다듬으려면 ScheduleSyncer 흐름을 실행합니다. Pre-Process 단계에서는 Naming Convention Match 패널에 AI의 현재 이름 매칭 결과가 표시되며, 그 옆의 선택 항목인 Custom Instructions for AI 패널에 "L1 in schedule = Level 1 in CupixWorks"와 같은 규칙을 입력할 수 있습니다.
참고: 사용자 지정 지시문은 실행 간에 유지됩니다. 한 번 저장하면 ScheduleSyncer가 OPC 재동기화를 포함한 이후 가져오기에서 이를 재사용하므로 명명 규칙은 한 번만 정의하면 됩니다.
참고: Load and Update by OPC Schedule은 연결된 OPC 프로젝트에서 최신 액티비티를 가져와 일정 표를 업데이트하는 기능입니다. 사용자 지정 지시문이 필요한 경우 ScheduleSyncer에서 별도로 구성하며 이후 가져오기에서 재사용됩니다. ScheduleSyncer의 전체 동작은 SiteInsights Setup Guide를 참조하세요.
SiteInsights 결과를 OPC로 내보내기
SiteInsights가 캡처로부터 진행률 데이터를 생성한 후에는 SiteInsights Schedule 편집기에서 결과를 Oracle Primavera Cloud로 바로 전송할 수 있습니다. 내보내기는 OPC 액티비티 뷰에 세 개의 열을 기록하여 Primavera 일정에 현장에서 측정한 진행률이 반영되도록 합니다.
OPC로 내보내는 방법은 다음과 같습니다.
- Project Setup → SiteInsights → Schedule을 엽니다.
- SiteInsights 상단 내비게이션 바의 오른쪽 위에서 다운로드(내보내기) 아이콘을 클릭한 다음 Export Progress to OPC를 선택합니다.
- 내보내기가 완료되면 Cupix가 관리하는 세 개의 열이 연결된 OPC 프로젝트의 Activities 뷰에 기록됩니다. 이 열은 내보내기 과정에서 자동으로 생성되지만 OPC에서 바로 보이지 않을 수 있습니다. 열을 보려면 OPC의 간트 차트 열 표시 설정에서 표시를 켭니다. 열을 새로 만들 필요는 없으며 표시만 활성화하면 됩니다.
참고: Export Progress to OPC를 다시 실행하면 OPC의 기존 Cupix 열이 최신 값으로 업데이트되며 중복 열이 생성되지 않습니다.
OPC에 기록되는 내용
OPC로 내보낼 때마다 다음 세 개의 열이 OPC의 Activities 뷰에 기록됩니다.
- Cupix Capture Date — 진행률 계산의 기준이 된 CupixWorks의 캡처 날짜입니다. 내보내기를 실행한 날짜가 아니라 현장을 실제로 캡처하고 진행률을 추적한 날짜입니다. 한 번의 내보내기로 전송된 모든 행은 보통 동일한 Cupix Capture Date를 갖습니다.
- Cupix Reported Progress — 해당 액티비티의 전체 태스크 중 완료된 태스크의 비율로 계산한 진행률(백분율)입니다. 각 행의 값은 0%에서 100% 사이입니다.
- Link to Cupix — 해당 액티비티가 속한 작업 구역을 여는 SiteView 딥 링크입니다. 이는 개략적인 이동으로, 링크는 작업 구역까지만 안내하며 그 안의 정확한 액티비티 위치로는 이동하지 않습니다. 동일한 작업 구역에 속한 액티비티는 같은 Link to Cupix URL을 공유합니다.
참고: Link to Cupix는 정확한 액티비티 위치가 아니라 작업 구역으로 이동하므로, 보는 사람이 SiteView에서 스크롤하거나 화면을 이동하여 원하는 구역을 찾아야 할 수 있습니다.
Oracle Primavera Cloud에서 전송된 데이터 확인
데이터가 전달되었는지 확인하려면 다음과 같이 합니다.
- Oracle Primavera Cloud에서 연결된 프로젝트를 열고 Activities 뷰로 이동합니다.
- 레이아웃이 Current Schedule로 설정되어 있는지 확인합니다(Activities 뷰 상단에 표시됩니다).
- Cupix Capture Date, Cupix Reported Progress, Link to Cupix 열을 찾습니다. 내보내기가 이 열을 자동으로 생성하지만 숨겨져 있을 수 있습니다. 열이 보이지 않으면 OPC의 간트 차트 열 표시 설정에서 표시를 켭니다.
- Link to Cupix 값을 클릭하면 해당 작업 구역에서 SiteView가 열립니다.
OPC가 변경되었을 때 일정 다시 동기화
OPC 쪽에서 액티비티, 날짜 또는 범위가 변경되면(예: 기획자가 Primavera에서 날짜를 직접 수정한 경우) CupixWorks에서 OPC 일정 가져오기를 다시 실행하여 일정 표를 갱신합니다.
다시 동기화하는 방법은 다음과 같습니다.
- Project Setup → SiteInsights → Schedule로 이동한 후 Edit를 클릭합니다.
- Update를 클릭하고 Load and Update by OPC Schedule을 다시 선택합니다.
- 일정 표가 OPC의 최신 액티비티 데이터로 갱신됩니다. 액티비티 ID, 이름, 레벨, 작업 구역, 협력업체, 날짜가 연결된 Primavera 프로젝트의 현재 상태에 맞게 업데이트됩니다.
- 업데이트된 일정을 검토한 후 Save를 클릭합니다.
참고: 가져오기를 다시 실행하면 기존 일정이 OPC의 최신 데이터로 업데이트됩니다. 마찬가지로 Export Progress to OPC로 진행률을 다시 전송하면 OPC의 기존 Cupix 열이 중복 생성되지 않고 업데이트됩니다.
문제 해결
OPC 일정 가져오기나 Export Progress to OPC에서 연결 오류, 누락된 액티비티, 예상과 다른 결과 등의 문제가 발생하면 Cupix 팀에 문의하세요.