[SAP] 글로벌 모듈 Function Modules (1) Function Modules이란? / CALL FUNCTION 사용하여 호출하기

ABAP에서 Function Module은 모듈화된 기능을 제공하여 코드의 재사용성과 유지보수성을 향상시킵니다. 이번 포스팅에서는 Function Group과 Function Modules의 관계, SE37을 활용한 함수 검색 및 테스트 방법, 그리고 CALL FUNCTION을 사용한 함수 호출 예제(BC400_MOS_POWER)를 다루겠습니다.

 

 

로컬 모듈과 글로벌 모듈의 차이점에 대한 포스팅 보러가기 ⬇️

[ABAP] 로컬 모듈 - 서브루틴(Subroutine)

 

 

---

 

🎯 Function Group과 Function Modules의 관계

Function Group (1) : Function Module (N) 관계 

1. Function Group

• Function Module의 상위 개념으로 여러 개의 Function Module을 포함하는 그룹입니다.
• 트랜잭션 코드 SE80을 통해 생성하고 관리할 수 있습니다.

2. Function Module

• Function Group 내에 속하는 개별 함수입니다.
• Function Module은 특정 기능을 수행하는 함수입니다.
• 글로벌 모듈이므로, 누구나 접근할 수 있습니다.
• 인터페이스(Interface)를 가지고 있으며, 주고받는 파라미터를 정의합니다.
• CALL FUNCTION을 사용하여 호출합니다.

 

📌 Function Module 

1. SE37에서 Function Module의 파라미터 의미

유형	의미
IMPORT	함수가 실행되기 전에 입력해야 하는 값 (외부에서 값 전달)
EXPORT	함수 실행 후 반환되는 값 (결과값)
CHANGING	외부에서 전달한 값이 함수 내부에서 변경되며 원본에도 반영됨
EXCEPTIONS	함수 실행 중 오류가 발생할 경우 처리할 예외 처리

 

2. Function Module 함수 호출 및 예외 값 처리 방법

 * Function Module 함수 호출

CALL FUNCTION 'BC400_MOS_POWER'
  EXPORTING
    iv_base                     = 입력 받을 값
    iv_power                    = 입력 받을 값
  IMPORTING
    ev_result                   = 함수 실행 후 출력하는 값
  EXCEPTIONS
    power_value_too_high        = 1
    result_value_too_high       = 2
    others                      = 3.
    
 * 호출한 결과 출력하기
CASE sy-subrc.
  WHEN 0. "성공
    WRITE: 'POWER값: ', 함수 실행 후 출력하는 값.
  WHEN 1. "POWER_VALUE_TOO_HIGH 발생
    WRITE: '값 초과:', iv_power에 입력 받은 값.
  WHEN 2. "RESULT_VALUE_TOO_HIGH 발생
    WRITE: '결과값 초과.'.
  WHEN 3. "OTHERS - 알 수 없는 예외
    WRITE: '알 수 없는 예외 발생.'.
ENDCASE.

 

📌 SE37을 활용한 함수 검색 및 테스트 방법

SAP에서는 SE37 트랜잭션을 사용하여 Function Module을 검색하고 테스트할 수 있습니다.

1. SE37을 사용하여 함수 검색하기

1. 트랜잭션 코드 SE37 실행
2. 검색창에 함수 이름 입력 (예: BC400_MOS_POWER)
3. "Display" 버튼 클릭하여 함수 인터페이스 및 코드 확인

2. SE37에서 함수 테스트하기

1. SE37 실행 후 함수명을 입력
2. "Test/Execute (F8)" 버튼 클릭
3. IMPORT, EXPORT, CHANGING, EXCEPTIONS 필드에 값 입력 후 실행
4. 결과 및 예외 확인

 

Import : 입력 받는 값

• IV_BASE와 IV_POWER 모두 PASS BY VALUE 선택 안되어 있기에 Call By Reference 입니다.
• IV_BASE는 필수 값이며 디폴트 값은 없고, IV_POWER는 옵션 값이며 디폴트 값은 2 입니다.

Export: 출력하는 값

Exceptions: 예외 처리

 

 

✅ CALL FUNCTION을 사용한 함수 호출 예제 (BC400_MOS_POWER)

아래 예제는 사용자가 입력한 base 값과 power 값을 사용하여 제곱 연산을 수행하는 계산기 프로그램입니다.

PARAMETERS gv_base TYPE BC400_COMPUTE_BASE.
PARAMETERS gv_power TYPE C400_COMPUTE_POWE.

DATA gv_result TYPE BC400_COMPUTE_RESULT.


CALL FUNCTION 'BC400_MOS_POWER'
  EXPORTING
    iv_base                     = gv_base
   IV_POWER                    = gv_power
 IMPORTING
   EV_RESULT                   = gv_result
 EXCEPTIONS
   POWER_VALUE_TOO_HIGH        = 1
   RESULT_VALUE_TOO_HIGH       = 2
   OTHERS                      = 3
          .

CASE sy-subrc.
  WHEN 0.
    WRITE: '성공', gv_result.
  WHEN 1.
    WRITE: '값 초과', gv_power.
  WHEN 2.
    WRITE: '결과 값 초과'.
  WHEN 3. 
    WRITE: '알 수 없는 오류'.
ENDCASE.