[SAP ABAP] CREATE OBJECT G_DOCKING_CONTAINER1 도킹 컨테이너 사용 방법

1. Docking Container란?

Docking Container (`CL_GUI_DOCKING_CONTANINER`)는 SAP GUI 화면(Dynpro) 내에서 특정 영역을 차지하도록 컨테이너를 생성하는 클래스입니다.

Docking Container 안에는 ALV(Grid) 같은 UI 요소를 삽입할 수 있습니다.

 

1) Docking Container의 특징

• SAP 화면의 왼쪽, 오른쪽, 위, 아래에 고정된 UI 영역을 만들 수 있음
• ALV 같은 그리드나 다른 UI 요소를 SAP 화면 안에 자연스럽게 포함 가능
• 사용자가 크기를 조정할 수도 있음

2) Docking Container 없으면?

• ALV를 팝업으로만 띄울 수 있음
• SAP 화면 내에서 고정된 위치에 표시할 수 없음
• `CL_GUI_ALV_GRID` 같은 UI 요소를 적용할 위치가 없음

 

2. G_DOCKING_CONTAINER1 코드 분석

 

CREATE OBJECT G_DOCKING_CONTAINER1
  EXPORTING
    STYLE     = CL_GUI_CONTROL=>WS_CHILD
    REPID     = SY-CPROG
    DYNNR     = SY-DYNNR
    SIDE      = G_DOCKING_CONTAINER1->DOCK_AT_LEFT
    LIFETIME  = CL_GUI_CONTROL=>LIFETIME_IMODE
    EXTENSION = 3000
  EXCEPTIONS
    OTHERS    = 1.

 

1) `CREATE OBJECT G_DOCKING_CONTAINER1`

• ` G_DOCKING_CONTAINER1` 이라는 도킹 컨테이너 객체를 생성
• SAP GUI 화면의 특정 영역에 UI 요소(ALV 등)를 배치할 수 있도록 설정
• ` CL_GUI_DOCKING_CONTAINER` 클래스를 기반으로 작동

✅ 만약 이 코드를 실행하지 않으면?

• SAP 화면에 ALV 같은 UI를 고정된 위치에 표시할 수 없음
• SAP 화면 안이 아닌, 팝업(ALV Grid Display)으로만 ALV를 띄울 수 있음

 

2) EXPORTING 파라미터 상세 설명

파라미터	설명	예제 값
STYLE	컨테이너 스타일 설정	CL_GUI_CONTROL=>WS_CHILD (자식 컨트롤)
REPID	프로그램 이름	SY-CPROG (현재 프로그램)
DYNNR	화면 번호 (Dynpro)	SY-DYNNR (현재 Dynpro 화면)
SIDE	도킹 위치 설정	G_DOCKING_CONTAINER1->DOCK_AT_LEFT
LIFETIME	컨테이너의 수명	CL_GUI_CONTROL=>LIFETIME_IMODE
EXTENSION	컨테이너 크기 (픽셀)	3000

 

1. `STYLE = CL_GUI_CONTROL=>WS_CHILD`
   • 도킹 컨테이너의 스타일을 자식 컨트롤(WS_CHILD)로 설정
   • 컨테이너가 독립적인 개체가 아닌, SAP GUI 화면 내에서 동작하도록 지정
   • 이 코드가 없으면, 컨테이너가 제대로 보이지 않을 수 있음.
2. ` REPID = SY-CPROG`, ` DYNNR = SY-DYNNR`
   • ` REPID = SY-CPROG`: 현재 프로그램을 컨테이너의 부모로 설정
   • ` DYNNR = SY-DYNNR`: 현재 Dynpro(화면 번호)를 컨테이너가 속할 화면으로 설정
   • 이 코드가 없으면, 컨테이너를 어느 화면에 배치할지 시스템이 모름 → 오류 발생 가능!
3. ` SIDE = G_DOCKING_CONTAINER1->DOCK_AT_LEFT`
   • 컨테이너를 화면의 왼쪽에 도킹
   • 가능한 값:
     • `DOCK_AT_LEFT `→ 왼쪽
     • `DOCK_AT_RIGHT` → 오른쪽
     • `DOCK_AT_TOP `→ 위쪽
     • `DOCK_AT_BOTTOM `→ 아래쪽
   • 이 코드가 없으면, 기본값으로 설정됨 → 특정 위치를 지정하지 않으면 컨테이너가 화면에서 안 보일 수도 있음.
4. ` LIFETIME = CL_GUI_CONTROL=>LIFETIME_IMODE`
   • 컨테이너가 SAP 세션이 종료될 때 자동 삭제되도록 설정
   • `LIFETIME_IMODE` → 세션이 끝나면 컨테이너도 삭제됨
   • 이코드가 없으면, SAP 세션이 종료된 후에도 객체가 메모리에 남아있을 가능성이 있음.
5. `EXTENSION = 3000`
   • 컨테이너의 크기(가로 너비)를 3000 픽셀로 설정
   • 값이 클수록 컨테이너의 크기가 커짐.
   • 이코드가 없으면,기본값으로 작은 크기로 생성됨 → UI가 제대로 보이지 않을 수도 있음.

 

3. EXCEPTIONS 처리

EXCEPTIONS
  OTHERS = 1.

 

• 예외(Exception)가 발생하면 OTHERS = 1. → 무조건 1로 설정