Appearance
변환 기준
개발 → 컨버전 메뉴의 변환 기준에서 ECC → S/4HANA 코드 전환에 사용할 기준집을 관리합니다. 기준집은 특정 프로그램이나 패키지와 별도로 저장하며, 여러 전환 작업에서 같은 발행 버전을 참조할 수 있도록 구성했습니다.
이 화면은 기준 작성·JSON 교환·샘플 검증·버전 발행을 담당합니다. 발행한 기준은 ABAP 컨버전에서 ZIP의 패키지 경로·개별 소스를 선정하여 적용합니다. SAP 직접 연결과 시스템 반영은 아직 제공하지 않습니다.
기준집 작성
- 기준집 만들기를 선택합니다. 제공된 예제는 가상의 커스텀 함수 변경 사례로, SAP 표준 전환 기준이 아닙니다.
- 상단 기준집 설정에서 이름·설명·ABAP 구문 버전을 입력합니다. 구문 버전은 로컬 파서의 검사 기준이며 S/4HANA 릴리즈와 별도로 지정합니다. 설정 패널을 닫아도 입력한 내용은 유지되며, 저장하려면 초안 저장을 누릅니다.
- 왼쪽 기준 목록에서 편집할 기준을 선택합니다. 이름·ID로 검색하고
+버튼으로 기준을 추가할 수 있습니다. 모바일에서는 상단 적용 기준 선택 상자를 사용합니다. - 기준 정의에서 무엇을 바꿀까요? → 어디에 적용할까요? → 어떻게 실행할까요? 순서로 작성합니다. 이름·고유 ID·설명·근거 문서를 입력하고, 오브젝트 유형은 선택 버튼으로 지정합니다. 대상 S/4HANA 릴리즈는 쉼표로 구분하며 실행 문맥과 정확히 일치해야 적용됩니다.
- 실행 방식을 선택하고 설정을 입력합니다. 기존 샘플이 있는 기준의 실행 방식을 바꾸면 초기화 확인창이 표시됩니다. 변경을 확정하면 기존 설정과 샘플이 초기화됩니다.
- 초안 저장으로 보관합니다. 상단에서 저장 여부를 확인할 수 있습니다. 다른 사용자가 수정한 초안을 덮어쓰려 하면 충돌 안내가 표시됩니다. 작성한 내용은 JSON으로 내보낸 뒤 목록에서 다시 열어 최신 내용을 확인합니다.
기준은 자연어 설명만으로 자동 실행되지 않습니다. 룰 기반 기준은 등록된 실행기와 구조화한 설정을 함께 지정하고, AI 기준은 지시·제약·검증 절차를 작성합니다.
새 기준집에는 한글 이름·설명·호환성 근거와 두 개의 샘플이 기본으로 들어갑니다. 정적 함수 호출 변경은 Z_LEGACY_LOOKUP을 Z_S4_LOOKUP으로 바꾸고, 주석과 문자열은 원본 유지는 같은 함수명이 주석·문자열에 있을 때 변경하지 않는지 확인합니다. 함수명과 실행기 ID는 코드 식별자이므로 번역하지 않습니다. 기존에 저장하거나 발행한 기준 내용은 기본 예제 변경의 영향을 받지 않습니다.
| 실행 방식 | 입력 | 현재 동작 |
|---|---|---|
| 정적 함수 호출 변경 | 기존 함수명·대체 함수명·인터페이스 호환 확인 근거 | 구문으로 확인한 CALL FUNCTION '함수명'의 이름만 변경 제안 |
| 구문 검토 탐지 | 구문 시작 키워드·검토 안내 | 일치하는 구문의 위치를 검토 항목으로 반환 |
| AI 작업 지시 생성 | 자연어 지시·변경 제약·필수 검증 | 작업 지시 생성. 모델 호출과 코드 변경은 수행하지 않음 |
함수 변경은 주석·문자열·동적 호출·인자를 변경하지 않습니다. 원격 호출 등 실행 문맥과 함수 인자 호환성은 담당자가 확인해야 합니다. 호환 확인 근거를 입력해도 서버가 실제 SAP 인터페이스를 검증한 것은 아닙니다.
가져오기와 내보내기
상단 더 보기(⋯) 메뉴의 JSON 내보내기는 현재 화면의 기준 정의와 샘플을 저장합니다. 발행 이력이나 사용자 정보는 포함하지 않습니다. 다른 환경에서는 기준집을 만든 뒤 같은 메뉴의 JSON 가져오기로 해당 파일을 불러올 수 있습니다.
가져올 때 계약 버전·실행기 ID와 버전·필수 설정을 검증합니다. 등록되지 않은 실행기나 임의 스크립트는 실행하지 않습니다. 가져온 기준은 저장 전까지 로컬 초안이며, 실패한 샘플이 있으면 수정 후 검증해야 발행할 수 있습니다. 파일은 최대 2MB입니다.
샘플 검증
각 샘플에 변환 전 소스, 기대 소스, 오브젝트 유형, 대상 릴리즈와 검토 항목 발생 여부를 입력합니다. 전체 샘플 검증은 기준별 기대 결과와 전체 기준을 함께 적용했을 때의 충돌·반복 적용 여부를 검사합니다.
데스크톱에서는 변환 전 소스와 기대 소스를 Monaco Editor로 나란히 편집합니다. ABAP 구문 강조, 행 번호, 검색과 자동 줄바꿈을 제공하며 앱의 밝은 테마·어두운 테마를 따릅니다. 전체 기준 적용 미리보기를 실행하면 아래의 적용 결과 비교에서 원본과 결과를 읽기 전용 Monaco Editor로 비교할 수 있습니다. 조회 권한만 있거나 발행 버전을 보고 있을 때는 입력 코드도 읽기 전용입니다. AI 기준은 지시·제약·검증 절차를 항목별로 표시합니다. 좁은 화면에서는 코드 영역을 위아래로 배치합니다.
세 탭은 같은 콘텐츠 폭과 좌우 여백을 사용합니다. 기준·샘플 삭제, 샘플이 있는 실행 방식의 초기화, 저장하지 않은 상태에서 목록으로 이동하거나 조회 버전을 바꾸는 작업은 앱 내 확인 대화상자를 거칩니다. 취소 또는 Esc를 누르면 현재 내용을 유지하고, 확인을 누르면 안내된 작업을 진행합니다.
- 변경 실행기는 실제로 바뀌는 사례와 바뀌지 않아야 하는 사례가 모두 필요합니다.
- 검토·AI 실행기는 검토 항목이 발생하는 사례가 필요합니다.
- 전체 기준 적용 미리보기는 선택한 샘플에 모든 해당 기준을 적용한 결과를 보여줍니다.
- 문법 오류나 변경 위치 충돌이 있으면 결과 소스를 원본으로 유지합니다.
샘플당 소스는 100,000자, 기준집당 기준은 50개, 기준별 샘플은 20개까지입니다. 로컬 검증은 SAP의 타입·DDIC·API 존재 여부나 업무 의미를 검증하지 않습니다. 실제 전환 시 대상 시스템의 ATC·활성화·회귀 테스트가 필요합니다.
발행 버전
초안을 저장하고 버전 관리 → 버전 발행을 선택합니다. 서버가 샘플 검증을 다시 수행하고 통과한 정의·해시·검증 보고서·발행자를 버전으로 저장합니다. 같은 내용은 중복 발행하지 않습니다.
발행 버전은 조회 전용입니다. 이 버전을 초안으로 복사한 후 수정·저장·발행하면 새 버전이 생깁니다. 실행기 ID와 버전도 정의 안에 고정됩니다. 기준 내용이 변경되어도 기존 발행 버전을 덮어쓰지 않습니다.
권한과 MCP 조회
기준집은 같은 테넌트 안에서 공유합니다. Agent 리소스의 READ 권한으로 목록·상세·검증을 조회하고, CREATE로 기준집을 만들며, UPDATE로 초안을 수정하거나 발행합니다. 별도의 소유자 제한이나 발행 승인 역할은 아직 없습니다.
MCP list_conversion_criteria는 기준집을 검색합니다. get_conversion_criteria는 rule_set_id와 선택적인 정수 version으로 조회합니다. version을 생략하면 초안이며, 실제 전환 계획에는 명시한 발행 버전을 사용해야 합니다. 최대 20개 기준 요약을 반환하고 offset으로 다음 범위를 조회합니다. rule_id를 지정하면 해당 기준 설정을 조회합니다. 샘플은 MCP 응답에서 제외하므로 전체 정의는 앱에서 JSON으로 내보냅니다.
다른 기준과 전환 경로의 연결
동일 실행 방식의 새 기준은 화면이나 JSON으로 추가할 수 있습니다. 새로운 실행 방식은 서버에 설정 검증과 변경 제안 함수를 가진 실행기를 등록합니다. 새로운 실행기 버전은 기존 버전을 유지한 채 추가합니다.
ABAP 컨버전 작업은 기준을 복제하는 대신 기준집 ID·발행 버전·해시를 참조하고 소스별 오브젝트 유형·대상 릴리즈를 전달합니다. ZIP은 소스 입출력 계층에서 처리하므로 기준 정의에 ZIP 경로나 연결 자격 증명을 넣지 않습니다. AI 기준은 기존 Codex 작업 공간으로 전달하고 사용자가 실행한 결과를 다시 가져와 검토할 수 있습니다.
