SAP Integration Suite에서 ODATA API 활용 방법 정리

SAP Integration Suite에서 ODATA API를 사용한 연동 방식은 데이터 통합을 위한 필수 스킬입니다. 이 글에서는 ODATA Adapter의 개념부터 ODATA API 개발 및 테스트 방법까지 친절하게 설명드릴게요.

---

📘 목차 (Table of Contents)

1. ODATA란 무엇인가요?
2. ODATA Adapter의 주요 기능
3. ODATA V2 vs V4 차이점
4. SAP Integration Suite에서 ODATA API 만들기
5. .edmx 파일과 데이터 모델링
6. Integration Flow 설정과 메시지 매핑
7. ODATA 서비스 배포와 관리
8. Apache Olingo란?
9. Postman/SOAP UI로 API 테스트하는 법
10. 마무리 정리 및 실무 팁

---

1. ODATA란 무엇인가요?

ODATA (Open Data Protocol)는 REST 기반의 웹 프로토콜로, XML 또는 JSON 포맷을 사용해 데이터를 주고받습니다.
SAP에서는 이를 활용해 다양한 시스템 간의 데이터 통신을 쉽게 구현할 수 있죠.

ODATA는 HTTP 기반으로 작동하며, GET, POST, PUT, DELETE와 같은 명령어를 지원합니다. 데이터를 웹 API 형태로 외부에 노출하거나 연동할 때 자주 사용됩니다.

---

2. ODATA Adapter의 주요 기능

SAP Integration Suite의 ODATA Adapter는 다음 기능을 제공합니다:

• HTTP, ATOM/XML, JSON 포맷 지원
• REST API 기반 통신
• ODATA 메시지 프로토콜 V2/V4 지원
• Cross-Site Request Forgery(CSRF) 보호 기능 내장

이 어댑터는 송·수신자 간 안정적인 메시지 처리를 가능하게 해줍니다.

---

3. ODATA V2 vs V4 차이점

기능 V2 (구버전) V4 (신버전, OASIS 표준 포함)

지원 작업	GET, POST, PUT, DELETE, PATCH, 함수 호출	BATCH, Create, Query, Update, Delete 등
표준화	SAP 내부 위주	OASIS 국제 표준 포함
보안	CSRF 기본 지원	동일하게 지원

TIP: 신규 프로젝트에는 V4 사용을 권장합니다.

---

4. SAP Integration Suite에서 ODATA API 만들기

ODATA API는 다음 방식으로 생성됩니다:

1. Import from Data Source
   • 지원 타입: SOAP, ODATA, ODC
   • 파일 포맷: .edmx, .wsdl
2. Edit OData Model
   • 데이터 구조를 시각화하고 .edmx 직접 수정 가능
3. Bind to Data Source
   • Query, Create, Read, Update, Delete 동작 구성
4. Edit Integration Flow (I-Flow)
   • 송·수신 구조 매핑 및 메시지 전환 설정
5. Deploy OData Service
   • 완료 후 Manage Integration Content에서 주소 확인

---

5. .edmx 파일과 데이터 모델링

.edmx는 ODATA 모델을 정의하는 XML 기반 파일입니다.
ODATA API를 만들 때 이 파일을 활용해 구조를 정의하고 수정할 수 있습니다.

여러 개의 파일을 하나의 모델로 통합하는 것도 가능하니, 복잡한 프로젝트에 유용합니다.

---

6. Integration Flow 설정과 메시지 매핑

ODATA API는 Integration Flow(I-Flow) 안에서 송·수신 데이터를 매핑해야 작동합니다.
수신 구조에 따라 JSON, XML 포맷으로 매핑 규칙을 적용하고, 필드 간 정렬도 이 단계에서 설정합니다.

---

7. ODATA 서비스 배포와 관리

배포된 ODATA API는 SAP Integration Suite > Manage Integration Content 메뉴에서 관리됩니다.
여기서 **Endpoint 주소(URL)**를 확인하고, 실제 연동 테스트도 가능합니다.

---

8. Apache Olingo란?

Apache Olingo는 Java 기반의 ODATA 구현 라이브러리입니다.
ODATA 2.0은 안정적으로 지원되며, 4.0도 점차 지원이 확대되고 있습니다.

서버 및 클라이언트 측 ODATA 처리에 모두 사용할 수 있어, 자체 개발한 Java 앱과도 연동 가능합니다.

---

9. Postman/SOAP UI로 API 테스트하는 법

API 테스트 툴인 Postman이나 SOAP UI를 사용하면 다음 절차로 인증 및 호출이 가능합니다:

1. BTP Console > Subscriptions > Service Key에서 client_id, client_secret 확인
2. Authorization 방식은 OAuth2.0 Client Credentials 또는 Basic Auth 설정
3. 호출 URL은 배포된 ODATA 서비스 주소 사용

이 과정은 보안과 직결되므로, 인증정보는 절대 외부에 노출되지 않게 주의하세요!

---

10. 마무리 정리 및 실무 팁

• ODATA는 SAP API 통신의 핵심입니다
• V2보다 V4 사용을 점점 더 권장하는 추세
• .edmx 모델링과 I-Flow 매핑은 핵심
• Apache Olingo나 Postman 등 툴로 테스트 연동도 가능
• BTP에서 인증정보는 Service Key에서 확인