[SAP ABAP] REUSE_ALV_FIELDCATALOG_MERGE 함수란?

1️⃣ REUSE_ALV_FIELDCATALOG_MERGE 란?

• ALV Grid에서 사용할 필드 목록을 자동 생성하는 함수
• 인터널 테이블의 필드 정보(이름, 길이, 타입)를 자동으로 ALV에 맞게 구성
• SAP 표준 ALV 함수 (`REUSE_ALV_GRID_DISPLAY`)와 함꼐 사용됨

💡필드 카탈로그(Field Catalog)란?
ALV에서 어떤 컬럼을 표시할지, 어떤 속성을 가질지(길이, 정렬, 색상, 편집 가능 여부 등)를 정의하는 정보

 

2️⃣ 코드 분석

  CLEAR : G_FIELDCAT_H[], G_FIELDCAT_H.

• `G_FIRELDCAT_H` : ALV 필드카탈로그를 저장하는 글로벌 인터널 테이블.
• `CLEAR G_FIELDCAT_H[]` : 기존 필드카탈로그를 비워주는 초기화 작업.

 

CALL FUNCTION 'REUSE_ALV_FIELDCATALOG_MERGE'
  EXPORTING
    I_PROGRAM_NAME         = SY-REPID
    I_INTERNAL_TABNAME     = P_TABLE
    I_INCLNAME             = SY-REPID
  CHANGING
    CT_FIELDCAT            = G_FIELDCAT_H[]
  EXCEPTIONS
    INCONSISTENT_INTERFACE = 1
    PROGRAM_ERROR          = 2.

 

1) 주요 파라미터

파라미터	설명
`I_PROGRAM_NAME`	현재 프로그램 이름 (SY-REPID). 기본값.
`I_INTERNAL_TABNAME`	ALV로 출력할 인터널 테이블의 이름(구조)
`I_INCLNAME`	필드 구조가 선언된 Include 이름. 보통 SY-REPID와 같게 설정.
`CT_FIELDCAT`	필드카탈로그가 저장될 테이블. ALV 필드 정의들이 담김.
` INCONSISTENT_INTERFACE`	인터널 테이블 구조와 실제 선언이 일치하지 않을 경우.
` PROGRAM_ERROR`	프로그램 내부 문제.

 

2) 작동 원리

1. `REUSE_ALV_FIELDCATALOG_MERGE` 를 호출하면
2. SAP `P_TABLE` 이름의 인터널 테이블 구조를 조회해서
3. 테이블의 필드명, 데이터 타입, 길이 등을 읽고
4. ALV에서 사용할 수 있는 필드카탈로그를 `G_FIELDCAT_H[]`에 자동 생성해줌.

✅ 즉, 이 함수는 인터널 테이블을 보고 자동으로 ALV에 필요한 컬럼을 구성해 주는 역할

 

3️⃣ 언제 쓰는가?

• 기본 ALV 표준 화면을 빨리 띄워야 할 때.
• 필드카탈로그를 일일이 작성하기 귀찮을 때.
• 인터널 테이블이 잘 정의되어 있고, 필드명-도메인-데이터요소가 SAP 표준대로 잘 연동되어 있을 때.

 

4️⃣ 필드 카탈로그 없이 실행하면?

만약 `REUSE_ALV_FIELDCATALOG_MERGE`를 사용하지 않고 `REUSE_ALV_GRID_DISPLAY`를 실행하면 오류가 발생합니다.

ALV는 필드 목록을 몰라서 어떤 컬럼을 출력할지 결정하지 못합니다.

✅ 즉, 이 함수는 필드 카탈로그를 자동으로 설정하여 ALV가 올바르게 실행되도록 돕는 역할을 합니다.