DataBase Table

1. Annotation

• @EndUserText.label : ‘Project PMS Task Table’
• SE11 등에서 조회 시 화면에 나타나는 테이블의 한글/영문 설명(Short Text)
• @AbapCatalog.enhancement.category : #NOT_EXTENSIBLE

옵션값	의미 및 설명
#NOT_EXTENSIBLE	확장 불가. 테이블 구조를 절대 변경하지 못하도록 잠급니다. (현재 설정값)
#EXTENSIBLE_CHARACTER	문자형 필드만 확장 허용. 단, 추가되는 필드는 반드시 문자형(Char, Numc 등) 데이터 타입이어야 합니다.
#EXTENSIBLE_CHARACTER_NUMERIC	문자형 및 숫자형 필드 확장 허용. 문자형뿐만 아니라 정수형(Int), 금액/수량 필드까지 추가할 수 있습니다.
#ANY_STRUCTURE_CHARACTER_NUMERIC	제한 없이 확장 허용. 딥 구조(Deep Structure)를 제외한 모든 타입의 구조 확장을 허용합니다. (가장 유연함)

• @AbapCatalog.tableCategory : #TRANSPARENT

옵션값	의미 및 설명
#TRANSPARENT	투명 테이블. SAP ABAP Dictionary의 정의와 실제 DB(HANA DB 등)의 테이블 구조가 1:1로 정확히 일치합니다. CBO 마스터/트랜잭션 테이블을 만들 때 99% 이 옵션을 사용 합니다.
#GLOBAL_TEMPORARY	글로벌 임시 테이블 (GTT). 프로그램 실행 중에만 임시로 데이터를 적재하고, 세션이 끝나거나 COMMIT WORK / ROLLBACK WORK가 수행되면 데이터가 자동으로 지워지는 휘발성 테이블입니다.

• @AbapCatalog.deliveryClass : #A

옵션값	의미 및 설명
#A	Application 테이블. 현업이 사용하는 일반적인 데이터(마스터, 전표 등)가 쌓이는 곳입니다. 클라이언트 카피 시 데이터가 함께 복사될 수 있지만, 시스템 이관(TR) 시 데이터 자체는 자동으로 넘어가지 않습니다.
#C	Customizing 테이블. 개발자나 BC가 설정하는 구성 데이터용 테이블입니다. 이 테이블에 데이터를 입력하면 자동으로 TR(이관 요청서) 생성이 유도 되며, 운영 서버로 데이터가 함께 배포됩니다.
#L	Local 테이블. 주로 임시 데이터나 로그성 데이터를 저장하는 보관소 역할을 합니다. 클라이언트 카피를 하더라도 데이터가 복사되지 않고 비어있는 상태로 유지됩니다.

• @AbapCatalog.dataMaintenance : #RESTRICTED

옵션값	의미 및 설명
#RESTRICTED	제한적 유지보수. 기본적으로 직접 수정이 제한되지만, 별도의 데이터 브라우저 권한이 있는 관리자는 수정할 수 있는 상태입니다.
#ALLOWED	유지보수 허용.SE16N 등에서 편집 모드로 데이터를 직접 자유롭게 수정할 수 있도록 완전히 허용합니다. 개발 단계나 관리가 필요한 CBO 셋팅 테이블에 자주 씁니다.
#NOT_ALLOWED	유지보수 금지. 어떠한 표준 툴로도 테이블 데이터를 직접 수정할 수 없게 철저히 막습니다. 오직 프로그램 로직(RAP, ABAP 소스코드)을 통해서만 데이터가 입력/수정되어야 하는 중요 트랜잭션 테이블에 적용합니다.

2. 테이블 정의

define table ztwbs_task2 {

  key client      : abap.clnt not null;
  key prog_key    : sysuuid_x16 not null;
  prog_no         : abap.char(10);
  prog_name       : abap.char(100);
  screen_name     : abap.char(100);
  biz_type        : abap.char(100);
  category        : abap.char(100);
  deploy_yn       : abap.char(1);
  dev_type        : abap.char(100);
  developer       : abap.char(10);
  complete_yn     : abap.char(1);
  ui_type         : abap.char(100);
  git_url         : abap.string(0);
  iam_id          : abap.char(30);
  is_relevant     : abap.char(1);
  obj_type        : abap.char(100);
  package_name    : abap.char(100);
  srv_obj         : abap.char(100);
  srv_uri         : abap.string(0);
  start_date      : abap.dats;
  end_date        : abap.dats;
  progress        : abap.int1;
  created_by      : abp_creation_user;
  created_at      : abp_creation_tstmpl;
  last_changed_by : abp_locinst_lastchange_user;
  last_changed_at : abp_locinst_lastchange_tstmpl;

}

3. 데이터 타입

분류	데이터 타입 (ABAP Type)	길이 (Length)	소수점 (Decimals)	주요 용도 및 설명
문자형	abap.char( n )	1 - 13333	-	일반 텍스트, 고정 길이 코드, ID 필드 등
문자형	abap.string	가변 길이	-	대용량 텍스트, 주소 명세, 가변 길이 문자열
숫자형	abap.int4	10	-	일반 정수, 일련번호, 카운터 ($4\text{ Byte}$ 정수)
숫자형	abap.dec( len, dec )	1 -31	0 - 1	진척도(%), 수량, 금액 연산 등 고정소수점 팩트 데이터
숫자형	abap.fltp	16	-	매우 정밀한 과학적 계산용 부동소수점 데이터
날짜/시간	abap.dats	8	-	날짜 데이터 (포맷: YYYYMMDD)
날짜/시간	abap.tims	6	-	시간 데이터 (포맷: HHMMSS)
특수 규격	abap.unit( n )	1 - 3	-	수량 참조 필드용 단위 코드 (예: EA, KG, %)
특수 규격	abap.cuky( n )	1 - 5	-	금액 참조 필드용 통화 코드 (예: KRW, USD)

4. 테이블 생성 시 필수 값

...
define table ztbpprod {

  // 1. 시스템 기본 키 및 복합 키 (Composite Keys)
  key client      : abap.clnt not null;
  key plan_id     : abap.char(20) not null; // 사업계획ID
  key version     : abap.char(2) not null;  // 버전ID
  key gjahr       : gjahr not null;         // 회계연도
  key poper       : poper not null;         // 월
  key werks       : werks_d not null;       // 플랜트
  key matnr       : matnr not null;         // 제품 (자재번호)

  // 2. 일반 데이터 및 수량 필드 (Data & Quantity Fields)
  sales_qty       : meng13;                 // 판매수량
  open_qty        : meng13;                 // 기초수량
  close_qty       : meng13;                 // 기말수량
  prod_qty        : meng13;                 // 생산수량

  @Semantics.unitOfMeasure: true
  meins           : meins;                  // 단위 (EA 등)

  // 3. Generate ABAP Object 필수 관리 필드 (Audit Fields)
  created_by      : abp_creation_user;
  created_at      : abp_creation_tstmpl;
  last_changed_by : abp_locinst_lastchange_user;
  last_changed_at : abp_locinst_lastchange_tstmpl;

}