[SAP ABAP] REUSE_ALV_FIELDCATALOG_MERGE 함수란?

1. REUSE_ALV_FIELDCATALOG_MERGE 란?

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

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

 

2. 코드 분석

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 = P_TABLE`	필드 카탈로그를 생성할 내부 테이블 이름
`I_INCLNAME = SY-REPID`	현재 프로그램 내에서 필드 정의를 찾도록 설정
`CT_FIELDCAT = G_FIELDCAT_H[]`	필드 카탈로그 테이블 (출력 결과)

 

2) 실행 과정 (작동 원리)

1. 인터널 테이블(P_TABLE)의 필드 정보(이름, 타입, 길이 등)를 자동 추출
2. ALV에 맞게 필드 목록(`G_FIELDCAT_H[]`)을 생성
3. 이후 `REUSE_ALV_GRID_DISPLAY`에서 `CT_FIELDCAT`을 사용하여 ALV 화면을 출력

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

 

 

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

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

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

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