HELIOS 연동 가이드 SkyPlanner APS를 활용한 생산 스케줄링

Helios Inuvio Server (Inuvio REST API). Asseco는 이를 HELIOS iNuvio의 업무 영역에 REST API로 접근할 수 있게 하는 별도 구성 요소로 설명합니다(Helios Inuvio Server 도움말). iNuvio 배포본에 포함되어 있으며, OpenAPI 명세는 Rapidoc 및 Redoc 형식으로 제공됩니다. 이 API는 각각 고유한 ID와 권한을 가진 HELIOS 조회 화면(browse)을 대상으로 동작합니다.

• GET /browses/list와 GET /browses/meta는 사용 가능한 조회 화면과 각 화면의 열 목록을 반환합니다.
• /browses/data는 조회 화면의 행을 읽습니다. 해당 화면에서 생성, 수정, 삭제가 허용된 경우에는 행을 쓸 수도 있습니다.
• /api/v1/actions/meta와 /api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent}는 조회 화면에서 외부 액션을 실행합니다. 현재 지원되는 외부 액션 유형은 Procedure, Browse, Plugin입니다.

스케줄링 담당자가 사용하는 생산 조회 화면에는 생산 계획(výrobní plán), 생산 지시(výrobní příkazy), 생산 지시별 부품, 생산용 자재 및 반제품, 직종, 인력 자원, 공정 순서별 공정 사전 설정, 공정 실적이 포함됩니다. 재고, 입고, 출고 및 발행된 구매 발주(vydané objednávky)도 같은 방식으로 조회할 수 있습니다.

HELIOS Nephrite REST API. Nephrite 로드맵에는 REST API 개발이 명시되어 있습니다(HELIOS Nephrite 로드맵). SkyPlanner 팀은 범위 산정 단계에서 고객 및 HELIOS 파트너와 함께 설치 환경에 맞는 Nephrite 엔드포인트를 확인합니다. 아래의 데이터 흐름은 그대로 적용됩니다.

Excel 및 CSV. 모든 HELIOS 조회 화면은 Microsoft Office로 내보낼 수 있으며, 이 방식만으로도 체험에 필요한 데이터를 불러올 수 있습니다.

SkyPlanner는 정해진 주기로 HELIOS 데이터를 읽습니다. 미완료 생산 지시와 최근 변경 사항을 필터링해 /browses/data를 호출하여 새 작업을 가져옵니다. 주기는 공장별로 설정하며, 생산 지시는 몇 분 간격, 재고는 한 시간 간격으로 가져오는 식입니다.

SkyPlanner는 상태나 일정이 변경되면 웹훅을 전송하므로, HELIOS에 결과를 다시 반영하는 처리는 이벤트 기반으로 이루어집니다.

1. 기준정보 최초 적재. TPV 조회 화면에서 제조 부품, BOM, 공정 순서, 작업장, 설비, 직종, 인력 자원 및 캘린더를 읽어옵니다. 각 HELIOS 자원에는 생산 능력 계획에 포함할지를 지정하는 플래그가 있으므로, SkyPlanner에서 스케줄링할 대상을 자원별로 결정해야 합니다. 설비 네 대가 있는 작업장은 하나의 작업장 그룹 또는 네 개의 작업장으로 구성합니다.

2. 지시 동기화. 생산 지시와 관련 부품, 공정, 자재를 발행된 구매 발주와 함께 읽어옵니다. SkyPlanner는 발주한 자재를 구매 발주서의 납품일부터 사용 가능한 것으로 처리하고, 구매 발주가 Delivered 상태로 표시되면 재고를 갱신합니다. 생산 승인된 지시를 스케줄링합니다. 생산 계획의 계획 수량은 생산 지시로 전환될 때까지 HELIOS에 남습니다.

3. 일정 결과 반영. 엔진이 작업을 배치하거나 이동하면 SkyPlanner 웹훅이 /api/v1/actions/execute를 통해 생산 지시 조회 화면의 외부 액션을 실행합니다. 이 액션은 범위 산정 단계에서 합의한 HELIOS 프로시저로, 지시 공정의 계획 시작 및 완료 시점을 설정합니다. HELIOS는 자체 로직으로 변경 사항을 검증합니다.

4. 생산 현장 실적 등록. 작업자는 SkyPlanner Mobile Confirmations 또는 Production Timer로 작업을 기록하며, 이 시간 기록이 일정에 반영되어 최신 상태를 유지합니다. 실제 작업 시간을 HELIOS로 다시 전송할지는 선택할 수 있습니다. 전송하는 경우 외부 액션이 지시 공정별로 공정 실적을 기록합니다. 전송하지 않는 경우 작업자는 계속 HELIOS 단말기에서 실적을 등록하고, SkyPlanner가 그 기록을 읽어옵니다.

5. 데이터 관리 주체 및 충돌 처리 규칙. 운영 시작 전에 다음 사항을 문서로 정리하세요.

지시의 날짜를 기록하는 시스템은 하나만 지정하세요. HELIOS 생산 능력 계획이나 Nephrite APS가 여전히 날짜를 기록한다면, SkyPlanner에서 스케줄링하는 지시에 대해서는 해당 기능을 끄거나 HELIOS 계획을 테스트용으로만 유지하세요.

• 계획 플래그. 생산 능력 계획 대상으로 표시된 자원만 신뢰할 수 있는 생산 능력 데이터를 갖습니다. 최초 적재 전에 작업장, 설비, 직종, 외주 작업의 플래그를 확인하세요.
• 시간 단위. 준비 시간, 단위당 시간, 마무리 시간은 시간, 분 또는 초 단위로 입력할 수 있습니다. 가져올 때 단위를 변환하지 않으면 모든 소요 시간이 잘못됩니다.
• 공정 간 대기 시간. 고정된 공정 간 시간은 설비 가동 시간이 아니라 공정 사이의 대기 시간입니다. 생산 능력을 차지하는 시간이 아닌 대기 시간으로 모델링하세요.
• 외주 공정(kooperace). 반출과 반입 양쪽 모두에 운송 시간이 적용됩니다. 외주 공정은 시간만 반영하는 단계로 모델링하세요.
• 쓰기가 가능한 조회 화면. 모든 조회 화면은 읽기를 지원하지만 생성, 수정, 삭제는 일부에서만 가능합니다. browseCreateImplemented=1 필터를 적용해 GET /browses/list를 호출하면 해당 화면을 확인할 수 있습니다. 생산 오더 조회 화면은 읽기 전용이므로, 계획 일자는 합의된 외부 액션을 통해 다시 전달합니다.