[SAP ABAP] Docking Container란? 도킹 컨테이너 사용 방법

1️⃣ Docking Container란?

📦 클래스명: CL_GUI_DOCKING_CONTAINER

• Docking Container 는 SAP GUI 화면(Dynpro) 내에서 특정 영역을 차지하도록 컨테이너를 생성하는 클래스입니다.
• Docking Container 안에는 ALV(Grid) 같은 UI 요소를 삽입할 수 있습니다.

 

🔹 주요 특징

• SAP 화면의 좌/우/상/하 원하는 위치에 도킹 가능
• 사용자가 크기를 직접 조절할 수 있음 (Resizable)
• SAP GUI 화면 내에서 ALV를 고정형으로 출력할 수 있음
• 같은 화면 내 여러 개 Docking Container도 생성 가능

 

2️⃣ 왜 Docking Container를 사용하는가?

• 한 화면에서 여러 데이터 비교를 해야 할 때
• ALV를 SAP GUI 화면 안에 고정형 레이아웃으로 보고 싶을 때
• 사용자가 ALV 크기를 직접 조절하도록 만들고 싶을 때
• 메인 화면 내에 데이터 영역과 컨트롤 영역을 구분하고 싶을 때

 

3️⃣ Docking Container의 작동 원리

Docking Container는 화면에 빈 컨테이너 공간을 만듭니다.

이 공간 안에 ALV Grid, Text Editor, Custom Control 등을 심어주면 됩니다.

SAP는 Docking Container의 부모를 현재 프로그램/화면으로 인식하기 때문에

어떤 Dynpro에서 실행될지 반드시 알려줘야 합니다.

 

4️⃣ 코드 상세 설명

📌 Docking Container 생성

DATA: G_DOCKING_CONTAINER1      TYPE REF TO CL_GUI_DOCKING_CONTAINER.

항목	설명
TYPE REF TO	참조 변수로 선언한다는 의미 (클래스 인스턴스를 가리킴)
CL_GUI_DOCKING_CONTAINER	SAP GUI의 도킹 컨테이너를 관리하는 표준 클래스

 

*&---------------------------------------------------------------------*
*&      Form  CREATE_DOCKING_CONTAINER
*&---------------------------------------------------------------------*
*       text : ALV를 띄울 Docking Container 생성
*----------------------------------------------------------------------*
FORM CREATE_DOCKING_CONTAINER .

  " Create ALV
  CREATE OBJECT G_DOCKING_CONTAINER1
    EXPORTING
      REPID                       = SY-REPID                            " 컨테이너가 속할 프로그램명
      DYNNR                       = '0100'                              " 컨테이너가 속할 스크린 번호.
      SIDE                        = G_DOCKING_CONTAINER1->DOCK_AT_LEFT  " 화면의 왼쪽에 붙이겠다
      EXTENSION                   = 3000
    EXCEPTIONS
      CNTL_ERROR                  = 1
      CNTL_SYSTEM_ERROR           = 2
      CREATE_ERROR                = 3
      LIFETIME_ERROR              = 4
      LIFETIME_DYNPRO_DYNPRO_LINK = 5
      OTHERS                      = 6.

  IF SY-SUBRC <> 0.
    MESSAGE 'Docking Container 생성 실패' TYPE 'E'.
  ENDIF.

ENDFORM.                    " CREATE_DOCKING_CONTAINER

파라미터	설명
STYLE	자식 컨트롤(WS_CHILD), SAP GUI 안에서 동작
REPID	현재 프로그램 이름
DYNNR	화면 번호(Dynpro)
SIDE	도킹 위치 (좌측, 우측, 상단, 하단)
LIFETIME	세션이 종료될 때 객체도 함께 삭제
EXTENSION	컨테이너 크기 (픽셀 단위)

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가 제대로 보이지 않을 수도 있음.
6. EXCEPTIONS 처리

EXCEPTIONS
  OTHERS = 1.

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

 

5️⃣ Docking Container의 라이프 사이클

컨트롤 생성 시 LIFETIME 값	의미
`CL_GUI_CONTROL=>LIFETIME_IMODE`	SAP 세션 종료 시 자동 삭제
`CL_GUI_CONTROL=>LIFETIME_DEFAULT`	명시적으로 삭제하거나 Dynpro 종료 시 삭제

• 도킹 컨테이너는 보통 SAP 세션과 함께 움직이기 때문에 `LIFETIME_IMODE`를 가장 많이 사용한다.