백엔드에서 ABAP CDS 주석 구성

오브젝트 페이지 생성

Objective

After completing this lesson, you will be able to 오브젝트 페이지의 헤더 영역 구성, 오브젝트 페이지 본문에 섹션 추가

오브젝트 페이지의 헤더 영역에 제목 및 내역 추가

이 연습문제에서는 오브젝트 페이지에 제목과 내역을 추가합니다. 리스트 리포트 테이블에 제목도 추가합니다.

선행조건

동일한 단원(소단원: 리스트 리포트 생성)에서 전체 상태에 대한 코드 대신 내역 텍스트 추가 연습문제를 완료했습니다.

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

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

단계

  1. 이전 연습문제의 리스트 리포트가 브라우저에서 열려 있습니다.

  2. 리스트에서 출장을 선택합니다. 오브젝트 페이지가 열리지만 오브젝트 페이지가 여전히 비어 있으므로 출장의 기술 ID만 표시됩니다.

  3. ADT를 열고 Project Explorer 에서 Metadata Extensions 폴더를 펼칩니다.

  4. 목록 보고서 테이블에 제목을 추가하고 개체 페이지에 제목과 설명을 추가합니다.

    1. 메타데이터 확장 ZC_FE_TRAVEL_######. 을 더블 클릭합니다.Travel 엔티티의 메타데이터 확장이 열립니다.

    2. 다음 샘플 코드와 같이 파일 맨 위에 @UI.headerInfo 주석을 추가합니다.

      Code Snippet
      123456
      @UI.headerInfo: { typeNamePlural: 'Travels', typeName: 'Travel', title: { type: #STANDARD, value: 'Description'}, description: { type: #STANDARD, value: 'TravelID'} }
    3. typeNamePlural속성은 목록 보고서의 제목을 정의합니다. 이 주석의 값은 문자열입니다.

    4. 오브젝트 페이지 제목의 typeName 속성은 오브젝트 페이지의 가운데 위 위치에 표시됩니다. 이 주석의 값은 문자열입니다.

    5. title속성은 오브젝트 페이지의 왼쪽 상단 모서리에 표시되는 내용을 정의합니다. 이 속성의 값은 출장 엔티티의 설명 필드입니다.

    6. @UI.headerInfo주석의 description 속성은 오브젝트 페이지의 왼쪽 상단 모서리에 있는 제목 아래에 표시되는 항목을 정의합니다.

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

  6. 브라우저에서 앱 미리보기로 전환합니다. 리스트 리포트 테이블의 제목이 추가된 것을 확인할 수 있습니다.

  7. 테이블에서 실행 을 선택합니다. 리스트 리포트 테이블이 표시됩니다.

  8. 이전과 같이 출장을 선택합니다. 이제 출장 내역과 출장 ID가 포함된 제목이 있는 오브젝트 페이지가 열립니다.

결과

리스트 리포트 테이블의 제목이 추가되었습니다. 오브젝트 페이지 헤더에 대한 출장 ID와 출장 내역을 조회했습니다. ADT 앱 미리보기의 특정 제한으로 인해 Travel이 오브젝트 페이지 제목으로 표시되지 않습니다. 다음 연습문제 중 하나에서 SAP Business Application Studio에서 실제 앱을 생성하면 이 내용을 볼 수 있습니다.

특정 출장의 가격 및 상태 정보로 헤더 확장

이 연습문제에서는 오브젝트 페이지의 헤더에 총 가격 과 전체 상태 를 추가해 보겠습니다.

선행조건

이 소단원에서 오브젝트 페이지의 헤더 영역에 제목과 내역 추가 연습문제를 완료했습니다.

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

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

단계

  1. 이전 연습문제의 리스트 리포트가 브라우저에서 열려 있습니다.

  2. 출장을 선택하십시오. 출장에 대한 오브젝트 페이지가 열립니다. 총 가격 및 전체 상태 를 오브젝트 페이지 헤더에 데이터 포인트로 추가하려고 합니다.

  3. 이제 ADT로 전환할 수 있습니다.

  4. TotalPrice@UI.dataPoint주석을 추가합니다.

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

    2. 다음 샘플 코드에 표시된 대로 TotalPrice에 대한 @UI.dataPoint 주석을 추가합니다.

      Code Snippet
      1
      @UI.dataPoint: { qualifier: 'PriceData', title: 'Total Price' }
  5. @UI.facet주석을 추가하고 그 안에 @UI.dataPointTotalPrice 주석을 참조합니다.

    1. 동일한 메타데이터 확장에서 다음 샘플 코드에 표시된 대로 @UI.facet 주석을 추가하여 오브젝트 페이지에서 섹션을 정의합니다. @UI.facet주석은 annotate view ZC_FE_Travel_###### with {바로 다음에 있습니다.

      Code Snippet
      1234567
      @UI.facet: [{ purpose: #HEADER, position: 10, type: #DATAPOINT_REFERENCE, targetQualifier: 'PriceData' }]
    2. 섹션이 오브젝트 페이지 헤더에 배치될 수 있도록 이 주석의 purpose#HEADER 로 추가됩니다.

    3. position은(는) 10 로 설정되어 오브젝트 페이지 헤더의 첫 번째 섹션이 된다.

    4. type은(는) #DATAPOINT_REFERENCE(으)로 정의되며, 이는 @UI.dataPoint 주석을 참조함을 의미한다.

    5. targetQualifier은(는) 참조된 @UI.dataPoint 주석을 식별합니다.

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

  7. 브라우저에서 앱 미리보기로 전환하여 UI의 변경사항을 확인합니다. 이제 총 가격이 오브젝트 페이지 헤더에 표시되는 것을 확인할 수 있습니다.

  8. ADT로 전환합니다.

  9. 다음 @UI.dataPoint 샘플 코드에 표시된 것처럼 열려 있는 메타데이터 확장에서 OverallStatus 주석을 추가합니다.

    Code Snippet
    1
    @UI.dataPoint: { qualifier: 'StatusData', title: 'Status', criticality: 'OverallStatusCriticality' }
  10. @UI.facet주석을 추가하고 그 안에 @UI.dataPointOverallStatus 주석을 참조합니다.

    1. @UI.facet주석의 다른 레코드를 추가하여 다음 샘플 코드와 같이 오브젝트 페이지 헤더에 두 번째 섹션을 표시합니다.

      Code Snippet
      1234567
      , { purpose: #HEADER, position: 20, type: #DATAPOINT_REFERENCE, targetQualifier: 'StatusData' }
    2. #HEADERpurpose로 입력되었는지 확인합니다.

    3. 오브젝트 페이지 헤더의 두 번째 위치에 있도록 position20 로 설정합니다.

    4. type#DATAPOINT_REFERENCE로 정의합니다. 즉, @UI.dataPoint 주석을 참조합니다.

    5. targetQualifier은(는) 참조된 @UI.dataPoint 주석을 식별합니다.

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

  12. 브라우저에서 앱 미리보기로 전환하여 UI의 변경사항을 확인합니다. 이제 총 가격 옆의 오브젝트 페이지 헤더에 상태 가 표시되는 것을 확인할 수 있습니다.

결과

총 가격 과 전체 상태 라는 두 개의 필드를 데이터 포인트로 오브젝트 페이지 헤더에 추가했습니다.

오브젝트 페이지 본문에 ID 섹션 추가

이 연습문제에서는 오브젝트 페이지 본문에 섹션과 ID 하위 섹션을 추가합니다.

선행조건

이 소단원에서 특정 출장의 가격 및 상태 정보를 사용하여 헤더 확장 연습문제를 완료했습니다.

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

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

단계

  1. 이전 연습문제의 리스트 리포트가 브라우저에서 열려 있습니다.

  2. 출장을 선택하십시오. 출장을 위한 오브젝트 페이지가 열립니다. 오브젝트 페이지 본문에 첫 번째 섹션을 추가하고 여기에 ID 하위 섹션을 추가해야 합니다.

  3. 이제 ADT로 전환하고 프로젝트 탐색기에서ZC_FE_TRAVEL_######메타데이터 확장 을 열 수 있습니다.

  4. 다음 샘플 코드와 같이 AgencyID@UI.identification 주석을 추가합니다.

    Code Snippet
    1
    @UI.identification: [{position: 10}]
  5. 다음 샘플 코드와 같이 CustomerID@UI.identification 주석을 추가합니다.

    Code Snippet
    1
    @UI.identification: [{position: 20}]
  6. 다음 샘플 코드에 표시된 대로 @UI.facet 주석에 신규 레코드를 추가하여 오브젝트 페이지 본문에 섹션을 생성합니다. 빈 컨테이너이므로 여기에 하위 섹션을 추가할 수 있습니다.

    Code Snippet
    1234567
    , { label: 'General Information', type: #COLLECTION, id: 'GeneralInfo', position: 10 }
  7. id 하위 섹션에 대해 다음 샘플 코드에 표시된 대로 @UI.facet 주석에 다른 레코드를 추가합니다.

    Code Snippet
    123456
    , { label: 'General', type: #IDENTIFICATION_REFERENCE, parentId: 'GeneralInfo' /*The section id*/ }
  8. parentId를 GeneralInfo로 설정하여 앞에서 생성한 섹션을 이 하위 섹션의 상위 섹션으로 참조합니다. 이제 신규 섹션이 일반 정보 섹션의 하위 섹션이 됩니다.

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

  10. 브라우저에서 앱 미리보기로 전환하여 UI에 대한 변경사항을 확인합니다. 일반 정보 가 새로운 섹션이고 id 하위 섹션이 신규 섹션 내에서 일반 으로 표시되는 것을 확인할 수 있습니다.

결과

오브젝트 페이지 본문에 섹션과 ID 하위 섹션이 생성되었습니다.

오브젝트 페이지 본문의 섹션에 두 개의 하위 섹션 추가

이 연습문제에서는 오브젝트 페이지의 일반 정보 섹션에 두 개의 하위 섹션을 추가합니다.

선행조건

이 소단원의 오브젝트 페이지 본문에 ID 섹션 추가 연습문제를 완료했습니다.

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

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

단계

  1. 이전 연습문제의 리스트 리포트가 브라우저에서 열려 있습니다.

  2. 리스트에서 출장을 선택합니다. 출장에 대한 오브젝트 페이지가 열립니다. 가격이 있는 하위 섹션과 일자 정보가 있는 하위 섹션을 추가해야 합니다. 이 두 하위 섹션을 모두일반 정보 섹션 옆에 배치해야 합니다.

  3. 이제 ADT로 전환하고 프로젝트 탐색기에서ZC_FE_TRAVEL_######메타데이터 확장 을 열 수 있습니다.

  4. 다음 샘플 코드와 같이 TotalPrice@UI.fieldGroup 주석을 추가합니다.

    Code Snippet
    1
    @UI.fieldGroup: [{qualifier: 'PricesGroup', position: 10}]
  5. 다음 샘플 코드와 같이 BookingFee@UI.fieldGroup 주석을 추가합니다.

    Code Snippet
    1
    @UI.fieldGroup: [{qualifier: 'PricesGroup', position: 20}]
  6. 다음 샘플 코드와 같이 가격 하위 섹션에 대한 #FIELDGROUP_REFERENCE 유형의 @UI.facet 주석에 다른 레코드를 추가합니다.

    Code Snippet
    123456789
    , { label: 'Prices', purpose: #STANDARD, position: 20, type: #FIELDGROUP_REFERENCE, parentId: 'GeneralInfo', targetQualifier: 'PricesGroup' }
    1. labelPrices.

    2. 이 하위 섹션의 parentIdGeneralInfo 있으므로 일반 정보 섹션에 하위 섹션이 표시됩니다.

    3. targetQualifierPricesGroup.

  7. 다음 샘플 코드와 같이 BeginDate@UI.fieldGroup 주석을 추가합니다.

    Code Snippet
    1
    @UI.fieldGroup: [{qualifier: 'DatesGroup', position: 10}]
  8. 다음 샘플 코드와 같이 EndDate@UI.fieldGroup 주석을 추가합니다.

    Code Snippet
    1
    @UI.fieldGroup: [{qualifier: 'DatesGroup', position: 20}]
  9. 다음 샘플 코드와 같이 Dates 하위 섹션에 대한 #FIELDGROUP_REFERENCE 유형의 @UI.facet 주석에 다른 레코드를 추가합니다.

    Code Snippet
    123456789
    , { label: 'Dates', purpose: #STANDARD, position: 30, type: #FIELDGROUP_REFERENCE, parentId: 'GeneralInfo', targetQualifier: 'DatesGroup' }
    1. labelDates.

    2. 이 하위 섹션의 parentIdGeneralInfo 있으므로 일반 정보 섹션에 하위 섹션이 표시됩니다.

    3. 필드 그룹의 qualifierDatesGroup .

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

  11. 브라우저에서 앱 미리보기로 전환하여 UI에 대한 변경사항을 확인합니다. 일반 정보 섹션에 추가된 하위 섹션으로 가격 및 일자 를 볼 수 있습니다.

결과

오브젝트 페이지의 기존 일반 정보 섹션에 두 개의 하위 섹션인 가격 과 일자 를 추가했습니다.

XML 형식에 ABAP CDS 주석 매핑

지금까지 ADT에서 프로젝션 뷰의 해당 메타데이터 확장에 ABAP CDS 주석을 추가했습니다. ADT에 서비스를 게시하면 런타임에 의해 OData 서비스가 생성됩니다. 이 시점부터 서비스 URL을 사용할 수 있으며 sap Fiori 요소 앱 등을 생성하는 데 사용할 수 있습니다. 서비스의 데이터 모델(노출된 엔티티, 속성 및 연관 관계 포함)의 모든 메타 내역은 시스템이 읽을 수 있는 서비스 $metadata 문서에서 사용할 수 있습니다. 모든 ABAP CDS 주석은 런타임에 의해 자동으로 XML 형식으로 변환되고 동일한 $metadata 문서에도 추가됩니다. 브라우저에서 $metadata 문서를 보기 위해 OData 서비스의 루트 URL을 가져와서 끝에 $metadata 를 추가할 수 있습니다. OData V2 서비스의 경우 주석이 별도의 주석 파일에 추가됩니다.

서비스가 게시된 후에도 메타데이터 확장에 UI 주석을 추가할 수 있습니다. ADT에서 변경사항을 활성화하면 $metadata 문서에 자동으로 추가됩니다.

서비스의 CDS 뷰 및 해당 OData 주석에 대한 활성 주석 점검

이 연습문제에서는 프로젝션 뷰의 활성 ABAP CDS 주석을 조회하는 방법을 살펴봅니다. 서비스 URL을 확인하고 서비스의 데이터 모델이 $metadata 문서에 어떻게 표시되는지 살펴봅니다. 그런 다음 해당 ABAP CDS 주석에서 런타임에 의해 변환된 해당 OData 주석을 확인합니다.

선행조건

이 소단원에서 오브젝트 페이지의 섹션에 두 개의 하위 섹션 추가 연습문제를 완료했습니다.

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

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

단계

  1. ADT의 Project Explorer에서Core Data Services 폴더 내의 Data Definitions 폴더를 엽니다.

  2. ZC_FE_TRAVEL_######. 을 마우스 오른쪽 버튼으로 클릭합니다.

  3. 다음 메뉴에서 open with 를 선택합니다.

  4. Active Annotations 옵션을 선택합니다.

  5. 선택한 프로젝션 뷰의 모든 활성 주석이 표시됩니다. @AccessControl, @ObjectModel등의 다른 주석과 함께 @UI.annotations 을(를) 볼 수 있다.

  6. 엔티티 레벨에서 정의된 @UI.headerinfo 주석의 정의를 볼 수 있습니다.

  7. 아래로 스크롤하여 기타 UI 관련 주석(예: @UI.facet 주석)을 확인합니다.

  8. 프로젝트 탐색기 의 비즈니스 서비스 폴더에서 ZUI_FE_TRAVEL_######_O4 를 더블 클릭합니다.

  9. 서비스 바인딩 문서에서 서비스버전 세부사항 에 있는 서비스 URL 을 선택합니다. 브라우저에서 서비스 URL이 열립니다.

  10. 서비스의 모든 엔티티를 볼 수 있습니다. 각 엔티티는 해당 프로젝션 뷰를 나타냅니다. 서비스가 드래프트가 활성화되어 있기 때문에 런타임에 I_DraftAdministrativeData 이(가) 서비스에 자동으로 추가됩니다.

  11. 을(를) 제거하시겠습니까?sap-client=100 을 URL에서 $metadata 로 대체합니다. 서비스 메타데이터가 표시됩니다.

  12. 아래로 스크롤하여 Travel 엔티티 정의로 이동합니다. 해당하는 프로젝션 뷰를 나타냅니다. 각 속성은 ZC_FE_TRAVEL_###### 프로젝션 뷰의 필드입니다. _BookingFee, _CustomerID등의 탐색 속성도 볼 수 있습니다. 서비스가 드래프트가 활성화되어 있기 때문에 런타임에 의해 자동으로 추가되는 HasDraftEntity등의 특정 기술적 속성도 볼 수 있습니다.

  13. @UI.LineItem주석의 정의까지 아래로 스크롤합니다. 각 레코드가 테이블 열을 나타내는 레코드 컬렉션을 볼 수 있습니다.

결과

ADT에서 활성 ABAP CDS 주석을 표시했습니다. 서비스의 $metadata 문서에서 OData 엔티티와 주석에 대한 데이터 모델과 주석의 매핑도 관찰했습니다.