[SAP ABAP] Function Group UXX Include 구조 — TOP · UXX파일 역할 정리

1. Function Group이란 무엇인가?

SAP ABAP 개발하다 보면 Function Module(FM)을 자주 사용하게 됩니다. FM은 외부에서 호출할 수 있는 독립적인 함수인데, 이 FM들을 논리적으로 묶어서 관리하는 컨테이너가 바로 Function Group(함수 그룹)입니다.

 

예를 들어, 생산관리(PP)관련 FM들을 하나의 Function Group `ZPP`에 모아두고, 영업(SD)관련 FM들은 `ZSD`에 따로 모아두는 식입니다.

💡 Function Group의 메인 프로그램 이름 규칙
Function Group 이름이 `ZPP`이면, SAP가 자동 생성하는 메인 프로그램 이름은 `SAPLZPP`입니다. (SAPL+함수그룹명)

 

2. 구조에 대한 핵심 비유 ㅡ 책장, 책 제목, 본문 파일

Function Group과 Include 구조가 처음에는 헷갈릴 수 있어서 책장을 비유하면 쉽게 이해됩니다.

📚

Function Group

책장

관련 기능(FM)들을 한 곳에 모아두는 컨테이너. 같은 업무 영역끼리 묶어 관리합니다.

 

📖

Function Module

책 제목

외부에서 호출하는 기능의 이름·인터페이스. "어떤 기능인지"를 나타냅니다.

 

📄

UXX Include

책의 본문 파일

FM의 실제 ABAP 소스코드가 들어있는 파일. "내용"이 실제로 저장된 곳입니다.

 

 

책 제목만 봐서는 내용이 어디 있는지 모르고, 본문 파일을 열어야 비로소 코드를 볼 수 있습니다.

마찬가지로 Function Module 이름은 호출을 위한 인터페이스일 뿐이고, 실제 ABAP코드는 UXX Include파일 안에 들어 있습니다.

 

3. 파일 구조 예시

Function Group `ZPP`를 예시로 들어, SAP가 실제로 어떤 파일들을 만드는지 살펴보겠습니다.

SAPLZPP  ← 메인 프로그램 (SAP 자동 생성, 직접 수정 ✗)
│
├── LZPPTOP   ← TOP Include : 전역 변수·테이블 선언
│                  (같은 FG의 모든 FM이 공유)
│
└── LZPPUXX   ← 마스터 UXX Include : FM 파일 목록(인덱스)
    │              (실제 코드 없음, SAP가 자동 관리)
    │
    ├── LZPPU01   ← FM 소스 : Z_PP_BDC_CO10H
    ├── LZPPU02   ← FM 소스 : Z_PP_XXX_002
    ├── LZPPU03   ← FM 소스 : Z_PP_XXX_003
    └── ...       ← U04 ~ U99까지 FM 추가 시 자동 생성

 

파일 이름 규칙도 패턴이 있습니다. 모든 Include 이름은 L + 함수그룹명으로 시작합니다.

그 뒤에 `TOP, `UXX`, `U01` 과 같은 접미사가 붙ㄹ어 역할을 구합니다.

 

4. UXX Include의 두 가지 역할

처음 공부할 때 가장 헷갈리는 부분이 바로 "UXX가 하나야, 여러 개야?"입니다. 답은 둘 다입니다. 역할이 다른 두 종류가 있습니다.

 

4-1) 마스터 UXX ㅡ 인덱스 역할

`LZPPUXX`는 실제 코드가 없고, 개별 FM Include 파일들의 목록만 담고 있는 인덱스입니다. FM을 추가하거나 삭제할 때마다 SAP가 자동으로 이 목록을 갱신합니다. 

* Include LZPPUXX — FM Include 인덱스 (SAP 자동 관리)
INCLUDE LZPPU01.   " Z_PP_BDC_CO10H
INCLUDE LZPPU02.   " Z_PP_XXX_002
INCLUDE LZPPU03.   " Z_PP_XXX_003

 

4-2) 개별 UXX (U01, U02, ---) ㅡ 실제 소스 저장소

`LZPPU01`, `LZPPU02`… 처럼 번호가 붙은 파일들이 각 FM의 실제 ABAP 소스코드를 보관합니다. `FUNCTION ... ENDFUNCTION.` 블록이 바로 여기에 저장됩니다. FM을 새로 생성하면 SAP가 자동으로 다음 번호의 파일을 만들어줍니다.

* Include LZPPU01
FUNCTION Z_PP_BDC_CO10H.
*"-----------------------------------------------------------
*"*"Local Interface:
*"  IMPORTING
*"     VALUE(IV_ORDER_NO) TYPE  AUFNR
*"  EXPORTING
*"     VALUE(EV_RESULT)   TYPE  CHAR1
*"  EXCEPTIONS
*"     NOT_FOUND          = 1
*"-----------------------------------------------------------

  " 생산오더 BDC 처리 로직
  DATA: lv_subrc TYPE sy-subrc.

  " ... 실제 업무 로직 ...

  EV_RESULT = 'S'.

ENDFUNCTION.

 

📌 번호 자동 부여 규칙
FM을 SE37에서 처음 만들면 → `U01`, 두 번째 FM → `U02`, … 최대 `U99`까지 자동으로 번호가 부여됩니다. 개발자가 직접 번호를 지정할 필요가 없습니다.

 

5. 주의할 점

1. UXX는 SAP가 자동 관리 ㅡ 직접 편집하지 말 것

• `LZPPUXX`를 SE38에서 직접 열어 수정하면 FM인식 불가, 활성화 오류 등 심각한 문제가 생깁니다. FM의 생성, 삭제는 반드시 SE37 또는 SE80에서 Function Module 단위로 작업하세요. 그러면 SAP가 UXX 목록을 자동으로 갱신해줍니다.

2. 같은 FG 내 FM들은 메모리와 전역 변수를 공유

• `LZPPTOP`에 선언된 변수와 테이블은 같은 Function Group 안의 모든 FM이 공유합니다. 즉 `Z_PP_FM_A`에서 `gv_plant`에 값을 넣으면, 같은 FG안의 `Z_PP_FM_B`에서도 그 값이 그대로 보입니다. 이 특성을 의도적으로 활용하여 FM 간 데이터를 공유하거나, 반대로 의도치 않은 공유로 버그가 생기지 않도록 주의해야 합니다.

3. FM 이름 ≠ Include 파일 이름

• `Z_PP_BDC_CO10H`라는 FM과 `LZ_PPU51`이라는 Include 파일은 완전히 다른 이름입니다. FM 이름으로 Include 파일을 찾으려 하면 찾을 수 없습니다. Include 파일은 L + 함수그룹명 + U + 번호 패턴으로 생성되므로, SE80에서 Function Group의 Includes 항목을 펼쳐서 확인하는 것이 가장 확실합니다.