백엔드에서 ABAP CDS 주석 구성

리스트 리포트 생성

Objective

After completing this lesson, you will be able to 메타데이터 확장 생성, 리스트 리포트의 UI 주석 추가

프로젝션 뷰를 위한 ABAP CDS 메타데이터 확장 생성

이 연습문제에서는 출장 엔티티의 프로젝션 뷰에 대한 ABAP CDS 메타데이터 확장을 추가합니다. 모든 UI 관련 주석을 여기에 넣을 수 있습니다.

선행조건

ABAP RESTful 어플리케이션 프로그래밍 모델의 개요 가져오기 단원(소단원: ODataV4 서비스 생성)에서 OData V4 서비스 게시 연습문제를 완료했습니다.

시뮬레이션 보기 및 단계 수행

이 연습문제에는 세부 단계를 안내하는 시뮬레이션이 포함되어 있습니다. 시뮬레이션 후 모든 단계를 찾을 수 있습니다. 시뮬레이션을 수행하고 자체 평가판 계정을 사용하여 단계를 수행할 수 있습니다.

단계

  1. 이전에 생성한 OData 서비스 패키지가 ADT에서 열려 있어야 합니다.

  2. ZFE_TRAVEL_###### 내에서 Core Data Services 를 확장합니다. 여기서 ZFE_TRAVEL_###### 은 패키지의 고유 ID입니다.

  3. 데이터 정의 를 선택하고 펼칩니다. UI 주석을 생성할 수 있는 세 가지 프로젝션 뷰를 볼 수 있습니다.

  4. 데이터 정의 에서 ZC_FE_TRAVEL_###### 을 더블 클릭합니다. Travel 엔티티에 대한 프로젝션 뷰가 열립니다.

  5. travel 엔티티에 대한 메타데이터 확장을 생성합니다.

    1. 을 선택하고 ZC_FE_TRAVEL_###### 을 마우스 오른쪽 버튼으로 클릭합니다.

    2. 신규 메타데이터 확장 을 선택합니다. 신규 메타데이터 확장 대화 상자가 열립니다.

    3. 메타데이터 확장의 이름이 ZC_FE_TRAVEL_###### 으로 입력되었는지 확인합니다.

    4. 출장 엔티티에 대한 UI 주석으로 내역을 입력합니다.

    5. 다음 을 선택합니다. 전송 요청 선택 이 열립니다.

    6. 다음 을 다시 선택합니다. 템플릿 이 표시됩니다.

    7. 종료 를 선택합니다. 메타데이터 확장이 생성된 것을 확인할 수 있습니다. 주석 ZC_FE_TRAVEL_######은 프로젝션 뷰입니다. travel 엔티티에 대한 모든 UI 관련 주석을 이 파일에 추가할 수 있습니다.

  6. CONTROL + SPACE 를 누릅니다. 다음 드롭다운에서 #CORE(annotation)을 선택합니다. @Metadata.layer값으로 #CORE 을(를) 선택했습니다.

  7. 메타데이터 확장 을 펼칩니다. 메타데이터 확장 폴더에 새로 생성된 메타데이터 ZC_FE_TRAVEL_###### 확장이 표시됩니다.

결과

ZC_FE_TRAVEL_###### ABAP CDS 프로젝션 뷰의 ABAP CDS 메타데이터 확장이 생성되었습니다. 다음 연습문제에서는 출장 엔티티에 대한 모든 UI 관련 주석을 이 파일에 추가합니다.

리스트 리포트 테이블에 열 추가

이 연습에서는 출장을 표시하는 테이블에 열을 추가하는 방법을 학습합니다. 이를 위해서는 해당 필드에 ABAP CDS @UI.lineItem 주석으로 주석을 작성해야 합니다.

선행조건

이 소단원에서 프로젝션 뷰의 ABAP CDS 메타데이터 확장 생성 연습문제를 완료했습니다.

시뮬레이션 보기 및 단계 수행

이 연습문제에는 세부 단계를 안내하는 시뮬레이션이 포함되어 있습니다. 시뮬레이션 후 모든 단계를 찾을 수 있습니다. 시뮬레이션을 수행하고 자체 평가판 계정을 사용하여 단계를 수행할 수 있습니다.

단계

  1. 브라우저에서 앱 미리보기를 엽니다. 테이블에 열이 표시되지 않습니다.

  2. ADT에서 Travel 엔티티 프로젝션 뷰를 엽니다.

    1. 이전 연습문제에서 생성한 OData 서비스 패키지가 ADT에서 열렸습니다.

    2. 데이터 정의 에서 사용할 수 있는 ZC_FE_TRAVEL_###### 을 선택하고 더블 클릭합니다. Travel 엔티티에 대한 프로젝션 뷰가 열립니다.

    3. 주석을 추가하는 데 사용할 다음 필드를 복사합니다.

      • TravelID
      • AgencyID
      • CustomerID
      • BeginDate
      • EndDate
      • BookingFee
      • TotalPrice
      • OverallStatus
      • LastChangedAt
  3. 프로젝션 뷰에서 선택한 모든 필드를 메타데이터 확장으로 붙여넣습니다.

    1. 메타데이터 확장 내에서 ZC_FE_TRAVEL_###### 을 더블 클릭합니다.

    2. 다음 샘플 코드에 표시된 대로 @UI.lineItem 주석을 추가할 Travel 엔티티의 프로젝션 뷰에서 모든 필드를 붙여넣습니다.

      Code Snippet
      1234567891011
      { TravelID; AgencyID; CustomerID; BeginDate; EndDate; BookingFee; TotalPrice; OverallStatus; LastChangedAt; }
  4. abap CDS @UI.lineItem 필드 위에 한 라인을 추가합니다.

    1. 필드 위에 한 줄 @UI.lineItem 입력하기 시작합니다.

    2. 키보드의 CTRL + SPACE 를 눌러 주석 제안을 확인합니다.

    3. @lineItem: [{}] (annotation)을 선택하고 더블 클릭합니다.

  5. @UI.lineItem주석의 position 속성을 추가합니다.

    1. 키보드에서 CTRL + SPACE 를 누릅니다.

    2. @position: (annotation)을 선택하고 더블 클릭합니다.

    3. 포지션 값으로 10 을 입력합니다. TravelID필드가 테이블의 첫 번째 열로 표시됩니다.

    4. 각 필드에 대해 다음 단계를 따르십시오. 나머지 필드에는 포지션 값을 연속된 순서로 입력해야 합니다. 이 경우 두 번째 필드의 위치 값은 20, 세 번째 필드의 위치 값은 30 등입니다.

  6. 메뉴 바에서 활성화 를 클릭하여 변경사항을 저장하고 활성화합니다.

  7. 브라우저에서 앱 미리보기를 열면 주석 처리된 필드가 모두 표시됩니다.

    1. 프로젝트 탐색기에서비즈니스 서비스 폴더를 펼칩니다.

    2. 비즈니스 서비스 내에서 서비스 바인딩 옵션을 펼칩니다.

    3. ZUI_FE_TRAVEL_######_O4를 더블 클릭합니다.

    4. 열린 서비스 바인딩에서 서비스 버전 세부사항 탭의 엔티티 세트에서출장 및 연관 관계 를 선택합니다.

    5. 미리보기 를 선택합니다. 앱 미리보기에는 테이블 열로 @UI.lineItem 주석이 지정된 모든 필드가 표시됩니다.

  8. 실행 을 선택합니다. 테이블 데이터가 표시됩니다.

  9. 테이블에서 첫 번째 엔트리를 선택하고 클릭합니다. 선택한 테이블 엔트리의 오브젝트 페이지가 표시됩니다. 해당 주석이 아직 설정되지 않았으므로 이 오브젝트 페이지는 비어 있습니다.

결과

테이블에 열을 추가했습니다. 여기서 주석이 지정된 필드가 모두 표시됩니다. 테이블 내의 데이터를 확인하고 오브젝트 페이지로 이동했습니다.

리스트 리포트에 필터 필드 추가

이 연습문제에서는 리스트 리포트의 필터 바에TravelID, AgencyID및 CustomerID 필드를 추가합니다.

선행조건

이 소단원에서 '리스트 리포트 테이블에 열 추가' 연습문제를 완료했습니다.

시뮬레이션 보기 및 단계 수행

이 연습문제에는 세부 단계를 안내하는 시뮬레이션이 포함되어 있습니다. 시뮬레이션 후 모든 단계를 찾을 수 있습니다. 시뮬레이션을 수행하고 자체 평가판 계정을 사용하여 단계를 수행할 수 있습니다.

단계

  1. ADT의 Travel 프로젝션 뷰에 대한 메타데이터 확장이 열려 있어야 합니다.

  2. TravelID@UI.selectionField주석을 추가합니다.

    1. TravelID필드 앞에 @UI.selection 입력을 시작합니다.

    2. 다음 리스트에서 @selectionField: [{}] (annotation) 선택하고 더블 클릭합니다.

  3. UI에서 첫 번째 필터 필드에 TravelID 만듭니다.

    1. @UI. selectionField: [{}]중괄호 안에 커서를 놓습니다.

    2. 옵션을 선택하고 @position: (annotation) 을 더블 클릭합니다.

    3. 10주석의 position 속성으로 @UI.selectionField 를 입력합니다. 이렇게 하면 TravelID 이(가) UI에서 첫 번째 필터 필드가 됩니다.

  4. AgencyID및 CustomerID 에 TravelID에 설명된 것과 같은 방식으로 @UI.selectionField 주석을 추가합니다. 나머지 필드에는 포지션 값을 연속된 순서로 입력해야 합니다. 이 경우 두 번째 필드의 위치 값은 20, 세 번째 필드의 위치 값은 30 등입니다.

  5. 메뉴 바에서 활성화 를 클릭하여 변경사항을 저장하고 활성화합니다.

  6. 브라우저에서 앱 미리보기를 열면 주석이 지정된 필터 필드가 모두 표시됩니다.

    1. ZUI_FE_TRAVEL_######_O4를 더블 클릭합니다.

    2. 열린 서비스 바인딩의 서비스 버전 세부사항 탭에 있는 엔티티 세트 및 연관 관계 에서 출장 을 선택합니다.

    3. 미리보기 를 선택합니다. 이제 앱 미리보기에 출장 ID, 여행사 ID 및 고객 ID 가 필터 바 필드로 표시됩니다. 검색 필드와 편집 상태 는 기본적으로 필터 바에 추가됩니다.

  7. 실행 을 선택합니다. 테이블 데이터가 표시됩니다.

  8. 대행사 ID 필드에서 테이블 데이터를 필터링합니다.

    1. 대행사 ID 의 값 도움말 옵션을 선택합니다.

    2. 검색 및 선택 탭의 생성된 리스트에서 첫 번째 항목을 선택합니다.

    3. OK를 선택합니다.

    4. 리스트 리포트에서 실행 을 선택합니다. 이전에 선택한 필터 기준에 따라 테이블 데이터가 필터링되는 것을 확인할 수 있습니다.

결과

리스트 리포트의 필터 바에 출장 ID, 여행사 ID 및 고객 ID 를 추가했습니다. 선택한 필터 기준에 따라 데이터를 필터링했습니다.

출장 상태 열에 중요도 추가

이 연습문제에서는 전체 상태 값에 중요도 색을 추가합니다. 전체 상태 열에는 출장의 전체 상태가 표시됩니다(o: 미결, A, X: 취소됨). 중요도 색상에 따라 수락됨 상태가 녹색으로 표시되고 미결 상태(주황색, 취소됨 상태)가 빨간색으로 표시됩니다. 이러한 값에 해당 아이콘도 추가합니다.

선행조건

이 소단원에서 '리스트 리포트에 필터 필드 추가' 연습문제를 완료했습니다.

시뮬레이션 보기 및 단계 수행

이 연습문제에는 세부 단계를 안내하는 시뮬레이션이 포함되어 있습니다. 시뮬레이션 후 모든 단계를 찾을 수 있습니다. 시뮬레이션을 수행하고 자체 평가판 계정을 사용하여 단계를 수행할 수 있습니다.

단계

  1. SAP Fiori 요소의 중요도 문서에 따라 개별 항목 강조표시 가 열립니다. 가능한 중요도 값을 확인할 수 있습니다.

  2. ADT의 Travel 프로젝션 뷰에 대한 메타데이터 확장이 열려 있어야 합니다.

  3. 데이터 정의 내에서 ZI_FE_TRAVEL_###### 을 더블 클릭합니다. 출장 엔티티에 대한 ABAP CDS 뷰가 열립니다. OVERALL_STATUS 필드는 생성된 뷰에서 사용할 수 있습니다.

  4. 다음 샘플 코드에 표시된 것처럼 OVERALL_STATUS의 매핑된 값이 포함된 OverallStatusCriticality 라는 가상 요소를 추가합니다.

    Code Snippet
    123456
    case OVERALL_STATUS when 'O' then 2 when 'A' then 3 when 'X' then 1 else 0 end as OverallStatusCriticality,
  5. 메뉴 바에서 활성화 를 클릭하여 변경사항을 저장하고 활성화합니다.

  6. 새로 생성된 필드를 출장 엔티티의 드래프트 테이블에 추가합니다.

    1. 프로젝트 탐색기에서동작 정의 를 펼칩니다.

    2. ZI_FE_TRAVEL_######. 을 더블 클릭합니다. 메뉴 바에서 활성화 를 클릭합니다.

    3. 드래프트 테이블에 대한 오류 아이콘을 볼 수 있습니다.

    4. 오류 아이콘을 선택합니다. 오류 메시지가 펼쳐집니다.

    5. 메시지를 더블 클릭합니다. overallstatuscriticality필드가 Travel 엔티티의 드래프트 테이블에 추가됩니다.

  7. 메뉴 바에서 다시 활성화 를 클릭하여 변경사항을 저장하고 활성화합니다.

  8. 새로 생성된 필드를 프로젝션 뷰에 추가합니다.

    1. 프로젝트 탐색기에서ZC_FE_TRAVEL_######을 더블 클릭합니다.

    2. OverallStatus아래로 스크롤하고 프로젝션 뷰에 OverallStatusCriticality 필드를 추가합니다.

    3. 메뉴 바에서 활성화 를 클릭하여 변경사항을 저장하고 활성화합니다.

  9. 중요도 속성을 OverallStatusCriticality 필드의 @UI.lineItem 주석에 OverallStatus 추가합니다.

    1. 프로젝트 탐색기의Metadata Extensions 폴더에서 ZC_FE_TRAVEL_######을 더블 클릭합니다. travel 엔티티에 대한 메타데이터 확장이 열립니다.

    2. @UI.lineItem주석의 criticality: 'OverallStatusCriticality' 속성을 OverallStatus에 추가합니다. 이 속성은 position 속성 바로 뒤에 추가됩니다. 다음 샘플 코드에 표시된 대로 주석을 작성할 수 있습니다.

      Code Snippet
      12
      @UI.lineItem: [{position: ##, criticality: 'OverallStatusCriticality'}] OverallStatus;
    3. 메뉴 바에서 활성화 를 클릭하여 변경사항을 저장하고 활성화합니다.

  10. ADT의 변경이 완료되었습니다. 브라우저에서 앱 미리보기로 전환합니다.

  11. 실행 을 선택합니다. 전체 상태 열에는 중요도 색과 전체 상태 값이 표시됩니다.

결과

출장 엔티티의 전체 상태 열에 중요도 아이콘과 중요도 색을 추가했습니다. 앱 미리보기에서 변경사항을 확인했습니다.

전체 상태에 대한 코드 대신 내역 텍스트 추가

이 연습문제에서는 리스트 리포트의 전체 상태 열에 있는 코드를 의미 있는 텍스트로 대체합니다.

선행조건

이 소단원에서 출장 상태 열에 중요도 추가 연습문제를 완료했습니다.

시뮬레이션 보기 및 단계 수행

이 연습문제에는 세부 단계를 안내하는 시뮬레이션이 포함되어 있습니다. 시뮬레이션 후 모든 단계를 찾을 수 있습니다. 시뮬레이션을 수행하고 자체 평가판 계정을 사용하여 단계를 수행할 수 있습니다.

단계

  1. ADT의 Project Explorer에서데이터 정의 를 열었습니다.

  2. 텍스트 프로바이더 뷰를 확인합니다.

    1. 데이터 정의 내에서 ZI_FE_TRAVEL_###### 을 더블 클릭합니다.

    2. TravelStatus에 대한 텍스트 프로바이더 뷰에 대한 연관 관계가 이미 정의된 것을 확인할 수 있습니다.

    3. 아래로 스크롤합니다. _TravelStatus연관 관계 가 Travel CDS 뷰에 표시되는 것을 확인할 수 있습니다.

  3. 텍스트 제공자 뷰의 텍스트 필드를 travel 엔티티의 프로젝션 뷰에 추가합니다.

    1. ZI_FE_STAT_######. 을 더블 클릭하여 출장 상태에 대한 텍스트 프로바이더 뷰가 열려 있는지 확인합니다.

    2. F8 기능 키를 눌러 뷰의 텍스트 값을 표시합니다.

    3. ZC_FE_TRAVEL_######. 을 더블 클릭합니다.Travel 엔티티의 프로젝션 뷰가 열립니다.

    4. 프로젝션 뷰에 출장 상태 텍스트가 포함된 신규 필드 _TravelStatus.TravelStatusText as TravelStatusText 추가합니다.

  4. 프로젝트 뷰에서 OverallStatus@ObjectModel.text.element 주석을 추가합니다.

    1. Travel 엔티티의 프로젝션 뷰가 열려 있습니다.

    2. @ObjectModel.text.element: ['TravelStatusText']필드에 OverallStatus 주석을 추가합니다. @ObjectModel주석은 CDS 런타임에 필요하므로 메타데이터 확장이 아니라 프로젝션 뷰에 직접 추가됩니다.

  5. 메뉴 바에서 활성화 를 클릭하여 변경사항을 저장하고 활성화합니다.

  6. 브라우저에서 앱 미리보기로 전환합니다. 전체 상태 열의 코드 외에 텍스트를 볼 수 있습니다. 이제 필수 텍스트만 표시되도록 코드를 숨겨야 합니다.

  7. @UI.textArrangement주석을 추가하여 코드 없이 텍스트만 표시합니다.

    1. ADT의 Project Explorer에서메타데이터 확장 을 펼칩니다.

    2. ZC_FE_TRAVEL_######. 을 더블 클릭합니다.Travel 프로젝션 뷰의 메타데이터 확장이 열립니다.

    3. OverallStatus개별 항목을 중점적으로 살펴봅니다.

    4. @UI.textArrangement: #TEXT_ONLYOverallStatus주석을 추가합니다. 이 값을 지정하면 UI에는 텍스트만 표시되고 괄호 안에 나타나는 코드는 숨겨집니다.

  8. 메뉴 바에서 다시 활성화 를 클릭하여 변경사항을 저장하고 활성화합니다.

  9. 브라우저에서 앱 미리보기로 전환합니다. 이제 코드가 숨겨지는 것을 확인할 수 있습니다.

결과

출장 엔티티의 전체 상태 열에 텍스트를 추가했습니다. 괄호 안에 표시되는 상태 코드도 숨겼습니다.