QAD Adaptive ERP 연동 가이드 SkyPlanner APS로 생산 스케줄링하기

QAD는 외부 스케줄러에 세 가지 연동 방식을 제공합니다.

1. QAD QXtend Inbound (QXI). QAD는 이를 “a Web services-based, SOAP-compliant, XML framework, enabling complete platform-independent access to QAD Enterprise Applications business functionality.”(플랫폼에 종속되지 않고 QAD Enterprise Applications의 업무 기능에 완전히 접근할 수 있는 웹 서비스 기반의 SOAP 호환 XML 프레임워크)라고 설명합니다. 각 요청은 QDoc으로, QAD 프로그램을 실행할 때 해당 화면과 동일한 유효성 검사를 거칩니다. 각 요청에는 응답 QDoc이 반환됩니다. 기본 제공되는 QDoc에는 maintainItemMaster, maintainRouting, maintainPurchaseOrder가 있습니다. 기본 제공 QDoc이 없는 프로그램은 QAD의 QGen 도구로 메뉴 프로그램을 매핑합니다. “QGen is used to map custom programs or QAD Enterprise Applications programs that do not have released QDoc schemas and events files.”(QGen은 기본 제공 QDoc 스키마와 이벤트 파일이 없는 사용자 정의 프로그램 또는 QAD Enterprise Applications 프로그램을 매핑하는 데 사용됩니다.) QAD도 이 방식을 사용합니다. “QAD Production Scheduler uses QAD QXtend to update work orders.”(QAD Production Scheduler는 QAD QXtend를 사용해 작업지시를 갱신합니다.) (QXtend 가이드)
2. QAD QXtend Outbound (QXO). QXO의 기능은 “exports user-configurable business objects as XML QDocs out of QAD products.”(사용자가 구성할 수 있는 비즈니스 객체를 QAD 제품에서 XML QDoc으로 내보냅니다.)라고 설명되어 있습니다. 표준 비즈니스 객체에는 Item, Product Structure, Routing, Work Center, Department, Inventory Transaction, Inventory Status가 있습니다.
3. 업무 문서용 REST API. Adaptive ERP 2022.1부터 제공되는 기능은 “Query REST APIs are now available for business documents,”(이제 업무 문서용 조회 REST API를 사용할 수 있습니다.)라고 안내되어 있습니다. 이 API는 필터링, 정렬, 페이징 및 부분 데이터 조회를 지원하며, 해당 인스턴스의 Swagger에 문서화되어 있습니다(릴리스 노트).

데이터 쓰기는 QXtend가 담당합니다. 데이터 읽기는 QXO와 REST 조회 API가 담당합니다.

QXtend Outbound는 QAD에서 데이터 변경을 처리하는 메커니즘입니다. “A change occurs to watched data in QAD Enterprise Applications. Change notifications are written out to the qxevents database.”(QAD Enterprise Applications에서 감시 대상 데이터가 변경되면 변경 알림이 qxevents 데이터베이스에 기록됩니다.) 이후 QXO는 QDoc을 생성해 “to a directory location where the subscriber polls for and picks up new QDocs,”(구독자가 폴링하여 새 QDoc을 가져가는 디렉터리로) 전달하거나, 특정 URL에서 수신 대기 중인 웹 서비스로 전달합니다.

SkyPlanner는 웹 서비스로서 QXO가 발행하는 데이터를 구독하고, QXO가 지원하지 않는 데이터는 REST 조회 API를 폴링해 가져옵니다. Work Order는 QXO의 표준 비즈니스 객체가 아닙니다. 따라서 작업지시 테이블(wo_mstr, wr_route)에 QXO 비즈니스 객체를 추가하거나, REST 조회 API로 몇 분마다 작업지시를 폴링하도록 연동을 구성합니다.

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

1. 기준정보 최초 적재. QXO 또는 REST 조회 API로 품목, 제품 구조, 공정 순서, 작업 센터 및 캘린더를 읽어옵니다. 작업 센터는 신중하게 매핑하세요. 기계 네 대로 구성된 작업 센터는 작업장 그룹 하나 또는 작업장 네 개로 매핑합니다. Production Line Maintenance의 반복 생산 라인도 작업장으로 매핑할 수 있습니다.

2. 작업지시 동기화. 확정 계획 및 발행된 작업지시와 해당 공정 순서, 구성품을 미결 구매 발주와 함께 읽어옵니다. SkyPlanner는 발주한 자재를 구매 발주의 납품일에 사용 가능한 것으로 간주하고, 구매 발주 상태가 Delivered로 표시되면 재고를 갱신합니다.

스케줄링 대상은 MRP 계획 오더가 아니라 작업지시입니다. 계획 오더는 먼저 QAD에서 확정 계획 또는 발행된 작업지시로 전환되어야 합니다.

3. QAD에 일정 반영. 엔진이 오더를 배치하거나 이동하면 SkyPlanner 웹훅이 Work Order Maintenance (16.1)에 대한 QXtend Inbound QDoc을 트리거합니다. 착수일은 스케줄링된 첫 공정에, 완료 예정일은 마지막 공정에 맞춰 설정합니다. QXtend는 QAD 자체 유효성 검사를 거쳐 프로그램을 실행하고 응답 QDoc을 반환하며, 연동 로직은 이 응답을 확인합니다.

기계별 공정 실행 순서는 SkyPlanner에서 유지하며 Mobile Confirmations를 통해 작업자에게 전달합니다. 따라서 발행된 작업지시의 공정 순서를 동결하는 QAD의 제약에 영향을 받지 않고 연동할 수 있습니다.

4. 생산 현장 실적 등록. 작업자는 SkyPlanner Mobile Confirmations 또는 Production Timer로 작업을 기록하며, 이 시간 기록을 바탕으로 일정이 최신 상태로 유지됩니다. 실제 작업 시간을 QAD로 다시 전송할지는 선택할 수 있습니다. 전송하는 경우 공정별 준비 및 가동 시간은 Labor Feedback by Work Order로, 완료 수량은 Work Order Receipt로 전달됩니다. 전송하지 않는 경우에는 기존과 같이 QAD에 노무 실적을 입력합니다.

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

작업지시 날짜를 기록하는 시스템은 하나로 정하세요. SkyPlanner에는 QAD 스케줄링 모듈이 필요하지 않습니다. 따라서 SkyPlanner가 스케줄링하는 오더의 날짜는 기존 스케줄링 워크벤치나 다른 스케줄러를 대신해 SkyPlanner가 기록합니다.

• CRP 재실행. CRP는 선택한 작업지시에서 아직 완료되지 않은 모든 공정의 일정을 다시 잡습니다. QAD는 “you also adjusted the work order release and due date to match,”(작업지시의 릴리스일과 납기일도 그에 맞게 조정한 경우)에만 수동으로 지정한 날짜를 유지합니다. SkyPlanner가 기록하는 내용이 바로 이 날짜들입니다. 날짜를 QAD에 반영한 후 CRP를 실행하거나, SkyPlanner가 일정을 잡는 작업지시를 CRP 대상에서 제외하세요.
• 릴리스된 작업지시의 공정 순서는 고정됩니다. “Once the work order status is Exploded, Allocated, or Released, no more changes can be made to the routing.”(작업지시 상태가 Exploded, Allocated 또는 Released가 되면 공정 순서를 더 이상 변경할 수 없습니다.) 릴리스 시점에 공정 순서를 읽어 오고, 공정 순서 변경은 계획 또는 확정 계획 상태의 작업지시에서만 수행하세요.
• 공정 순서의 시간 단위. 준비 시간과 가동 시간은 부하에 포함되지만, “queue, wait, and move times are excluded from load calculations.”(공정 전 대기 시간, 공정 후 대기 시간, 이동 시간은 부하 계산에서 제외됩니다.) SkyPlanner에서는 공정 전 대기, 공정 후 대기, 이동을 시간만 반영하는 단계로 모델링하세요. 가동 시간이 제품 단위 기준인지 작업지시 기준인지도 확인하세요.
• QXtend 처리량. QAD는 “UI API adapter performance may be unacceptable when processing high volumes of data or real-time transactions.”(대량의 데이터나 실시간 트랜잭션을 처리할 때 UI API 어댑터의 성능이 허용 수준에 미치지 못할 수 있습니다.)라고 경고합니다. 변경된 작업지시만 일괄 전송하고, 기본 제공 QDocs가 있으면 이를 사용하세요.
• 도메인과 사업장. 여러 도메인을 사용하는 QAD 환경에서는 도메인과 사업장별로 작업 센터와 작업지시를 관리합니다. 연동 범위에 포함된 각 사업장을 별도의 작업장 그룹에 매핑하세요.
• 반복 생산과 개별 생산의 혼용. Advanced Repetitive 라인은 작업지시가 아닌 반복 생산 일정을 사용합니다. 범위 산정 단계에서 SkyPlanner가 일정을 잡을 라인을 결정하세요.