이 글은 아이리스인포테크 SAP ERP 컨설팅팀(개발팀)이 2026년 8월17일(월)부터 20일(목)까지 중국 상하이 SAP Business One Web Client Extensibility Workshop에 참석하여 확인한 확장 기술을, 실무 적용 관점에서 정리한 기술노트입니다.
1. SAP Business One Web Client 확장 기술 정리 — UI API, UDQ, Webhook, B1 MCP Server
SAP Business One이 Desktop Client(C/S버전)에서 Web Client로 무게중심을 옮기면서, 실제 프로젝트에서 다뤄야 할 확장 기술 목록도 같이 바뀌고 있습니다. 이 글에서는 상하이 워크숍에서 확인한 UI API·UDV·UDQ·Webhook·B1 MCP Server를 기능별로 정리하고, 저희가 실제 구축 프로젝트에서 어떤 기준으로 판단하는지를 공유합니다.
워크숍 참가 배경과 전체 일정은 아래 원문에 정리해두었으니, 이 글은 기술 요소 위주로 짧게 짚고 넘어가겠습니다.
👉 SAP 파트너 아이리스인포테크, SAP Business One Web Client 상하이 워크숍 참가
2. Desktop Client(C/S)와 Web Client, 뭐가 다른가
먼저 표로 정리하면 이렇습니다.
지원 환경 · 배포 방식 비교
| 실행 방식 | PC마다 클라이언트 설치 필요 | 브라우저 접속, 설치 불필요 |
| 지원 OS | Windows 전용 | Windows · macOS · Linux (브라우저 지원 환경) |
| 통신 방식 | DI API / UI API (로컬 SDK) | Service Layer (OData REST API) |
| 업데이트/패치 | PC별 개별 업데이트 | 서버에서 일괄 배포 |
| 이동성 | 설치된 PC에서만 사용 | 브라우저만 있으면 어디서나 접속 |
| 오프라인 사용 | 로컬 네트워크 환경에서 안정적 | 네트워크 연결 필수 |
정확한 DB·버전별 지원 범위는 고객사의 SAP Business One 버전에 따라 달라질 수 있어, 도입 전 별도 확인이 필요합니다.
표로 보면 단순 비교 같지만, 실제 마이그레이션 프로젝트에서는 "기존 Add-On을 어떻게 다시 개발할것 인가?"라는 문제로 이어집니다. 저희가 프로젝트를 검토할 때 Web Client 전환을 화면 교체가 아니라 재설계 과제로 보는 이유가 여기 있습니다.
3. 기술별로 뜯어보기: UI API·UDV·UDQ·Webhook
1) UI API·UDV(User-Defined Value)
Web Client 화면 위에 사용자 정의 필드나 컨트롤을 얹는 방식입니다. Desktop Client의 Screen Painter/UDF 조합과 목적은 비슷하지만, 개발 방식과 배포 구조가 다릅니다. 기존 Desktop Client용으로 짜둔 화면 커스터마이징 로직은 그대로 옮겨 쓸 수 없고, Web Client API 기준으로 다시 설계해야 합니다.
2) UDQ(User-Defined Query)
정형화된 조회 쿼리를 Web Client 메뉴/위젯에 바로 연결할 수 있는 구조입니다. 보고서성 화면을 Add-On 없이 UDQ만으로 처리할 수 있는 범위가 넓어지고 있어서, 저희는 신규 프로젝트에서 "이 요구사항이 Add-On 개발까지 필요한가, UDQ로 충분한가"를 먼저 구분하는 편입니다.
3) Webhook
이벤트 기반으로 외부 시스템에 데이터를 전달하는 방식입니다. 기존에는 배치성 인터페이스(주기적 폴링)로 처리하던 MES·WMS·OMS 연동 중 일부를, 이벤트 발생 시점에 바로 전달하는 구조로 바꿀 수 있는 여지가 생겼습니다. 다만 이벤트 유실·재시도 처리 같은 운영 안정성 이슈는 별도로 설계해야 합니다.
4. AI 연계: B1 MCP Server와 UIAPI Copilot PoC
이번 워크숍에서 가장 새로웠던 부분은 B1 MCP Server입니다. SAP Business One이 오픈소스로 공개한 MCP(Model Context Protocol) 기반 서버로, 생성형 AI가 ERP의 마스터 데이터·트랜잭션에 접근할 수 있는 표준화된 경로를 제공합니다. 실무적으로 의미 있는 부분은, AI가 텍스트 답변만 생성하는 게 아니라 실제 ERP 기능 호출까지 이어질 수 있는 구조라는 점입니다.
같이 소개된 UIAPI Copilot PoC는 조금 다른 방향인데요, SAP Business One 자체를 AI가 사용하는 게 아니라 Web Client UI API 개발 과정을 AI가 보조하는 개념입니다. 개발자가 UI API 코드를 짤 때 AI가 코드 생성이나 디버깅을 도와주는 구조로 이해하시면 됩니다.
다만 저희 입장에서는 "AI를 붙일 수 있다"와 "지금 고객사 프로젝트에 적용해야 한다"는 별개 문제로 봅니다. 데이터 구조와 권한 설계가 먼저이고, AI 적용은 그다음입니다. 이 부분은 아이리스인포테크가 계속 검토 중인 영역입니다.
"UI API와 B1 MCP Server처럼 새로운 확장 기술이 계속 나오는 상황에서, 저희 개발팀은 기능을 익히는 데서 끝내지 않고 기존 Add-On과 고객사 시스템에 실제로 어떻게 적용할 수 있을지를 하나씩 검증하는 걸 원칙으로 삼고 있습니다. 이번 상하이 워크숍에서 본 내용도 같은 기준으로 검토해 나가겠습니다."
— 명묘식, 아이리스인포테크 SAP ERP 사업부장(전무)
5. 기존 Add-On, 그대로 사용하지 못합니다. — IRIS-Add-On 전환 체크포인트
저희가 자체 개발·운영해온 IRIS-Add-On 솔루션팩도 Web Client 환경으로 옮기려면 아래 항목부터 점검해야 한다고 보고 있습니다.
- 화면 커스터마이징 로직 중 Desktop Client 전용 API에 의존하는 부분 식별
- 정형 보고서/조회 기능 중 UDQ로 대체 가능한 범위 구분
- 배치 연동 중 Webhook 이벤트 기반으로 전환할 대상 선별
- 기존 사용자 권한·프로세스와 새 확장 구조의 정합성 확인
새 기능을 배우는 것보다, 기존에 만들어둔 것 중 무엇을 그대로 못 쓰는지 파악하는 작업이 실제로는 더 오래 걸립니다. 이번 워크숍의 UI API·UDV Hands-On, Q&A 세션도 저희에게는 이 판단 기준을 세우는 시간이었습니다.
6. SAP 파트너를 고를 때 봐야 할 것
ERP 프로젝트는 구축 이후가 더 깁니다. 데이터 이관, 시스템 연동, 안정화, 추가 개발, 운영 지원까지 이어지는데, Web Client처럼 기술 환경이 빠르게 바뀌는 시기에는 파트너의 로드맵 대응력이 그대로 프로젝트 리스크로 연결됩니다. 아이리스인포테크는 2003년 설립 이후 다법인·해외법인 통합, MES·WMS·OMS 연동, SAP Business One 재구축 프로젝트를 수행하며 아래 기준을 유지해왔습니다.
- 제안 컨설턴트 = 구축 컨설턴트 — 제안과 구현 사이 괴리를 최소화
- 자체 개발 IRIS-Add-On 솔루션팩 — Web Client 환경까지 지속 고도화
- 스마트팩토리 정부 지원사업 연계 — 재구축과 지원사업을 연결한 컨설팅
👉 SAP 파트너 - 아이리스인포테크의 10대 핵심 강점
7. 기술노트 FAQ
Q1. 기존 Desktop Client용 Add-On, Web Client에서 그대로 돌아가나요?
아닙니다. Desktop Client 전용 API에 의존하는 로직은 UI API 기준으로 재개발이 필요합니다. 전환 전에 기존 Add-On의 API 의존도부터 진단해야 합니다.
Q2. UDQ만으로 커스텀 리포트를 대체할 수 있나요?
단순 조회·집계성 리포트는 UDQ로 충분한 경우가 많습니다. 다만 복잡한 계산 로직이나 다른 시스템 데이터와의 결합이 필요하면 별도 개발이 필요합니다.
Q3. B1 MCP Server를 지금 바로 도입해야 하나요?
기술적으로는 가능하지만, 저희는 데이터 구조·권한 설계가 먼저라고 봅니다. 적용 우선순위는 업무별로 따로 판단해야 합니다.
8. 우리 회사도 Web Client 전환을 검토해야 할까요
다법인·해외법인 운영, MES·WMS·OMS 연동, 기존 Add-On 의존도가 높은 조직이라면 Web Client 전환 전에 영향 범위를 먼저 진단해보는 것을 권합니다.
👉 우리 회사에 SAP Business One이 적합할까요? — 적합성 체크하기
📰 전자신문 관련 보도: 아이리스인포테크, SAP Business One Web Client 기술력 강화 · 전자신문
아이리스인포테크 SAP ERP 컨설팅팀 · 개발팀