소개

이 사용지침서에서는 데이터 그리드 및 데이터 그리드 반복기로 작업하도록 Groovy 스크립트를 구현하는 방법을 보여줍니다. 조건부 논리를 사용하면 데이터 그리드에서 배경색을 설정하고, 성능 벤치마킹을 구현하고, 그리드에서 기본 데이터 값을 설정할 수 있습니다. 섹션을 순서대로 완료합니다.

배경

데이터 그리드 인터페이스는 POV/행/열 헤더 셀에 대한 액세스를 제공하며 데이터 셀을 반복할 수 있는 다양한 이터레이터를 제공합니다.

필요 조건

Cloud EPM 실습 자습서에서는 스냅샷을 Cloud EPM Enterprise Service 인스턴스로 임포트해야 할 수 있습니다. 스냅샷은 기존 애플리케이션 또는 비즈니스 프로세스를 통해 임포트할 수 없습니다. 스냅샷을 임포트하기 전에 별도의 Cloud EPM Enterprise Service 인스턴스를 사용하거나 사용하려는 인스턴스에서 기존 애플리케이션 또는 비즈니스 프로세스를 제거하십시오. 스냅샷 가져오기는 기존 콘텐츠를 자동으로 바꾸거나 복원하지 않습니다.

이 자습서를 시작하기 전에 다음을 수행해야 합니다.

  • Cloud EPM Enterprise Service 인스턴스에 대한 서비스 관리자에게 접근 권한을 부여합니다. 인스턴스에는 비즈니스 프로세스가 생성되지 않아야 합니다.
  • 이 스냅샷을 업로드하여 인스턴스로 임포트합니다. 이 스냅샷에는 계획 비즈니스 프로세스가 필요합니다. 다른 Groovy 자습서의 스냅샷을 이미 가져온 경우 스냅샷을 다시 가져오지 않고 해당 응용 프로그램을 계속 사용할 수 있습니다.

주:

스냅샷을 임포트하는 마이그레이션 오류가 발생하는 경우 HSS-Shared Services 구성요소는 물론 코어 구성요소의 보안 및 사용자 환경설정 아티팩트를 제외한 마이그레이션을 다시 실행합니다. 스냅샷 업로드 및 임포트에 대한 자세한 내용은 Oracle Enterprise Performance Management Cloud용 마이그레이션 관리 설명서를 참조하십시오.

참고:

이 자습서에 필요한 스크립트는 각 섹션의 텍스트 파일로 링크됩니다.

조건부 논리를 사용하여 배경색 설정

이 섹션에서는 데이터 값이 #MISSING인 셀의 배경색을 █(0x00BFFF), 데이터 값이 50000보다 작거나 같은 셀을 █(0xFF8C00) 색상으로 설정하고 데이터 값이 50000보다 큰 셀을 █(0x00FA9A) 색상으로 설정하기 위해 Groovy 스크립트를 구현합니다.

주:

Groovy 스크립트를 정의한 후 각 양식의 컨텍스트에서 정의해야 하는 데이터 검증 규칙과 달리 모든 양식과 연계할 수 있습니다.

Groovy 스크립트 생성

  1. 계획 홈 페이지에서 네비게이터(네비게이터)을 누른 다음 생성 및 관리에서 규칙을 눌러 Calculation Manager를 엽니다.
    생성 및 관리 아래에 있는 규칙이 있는 네비게이터
  2. 시스템 뷰 탭에서 EPM Cloud, HP4, Plan1 순으로 확장합니다. 규칙을 마우스 오른쪽 버튼로 누르고 새로 작성을 선택합니다.
    Rules 컨텍스트 메뉴와 New가 선택된 System View
  3. [이름]에 Groovy Set Background Color을 입력한 다음 확인을 누릅니다.
    규칙 이름, 애플리케이션 및 큐브가 있는 [새 규칙] 대화상자
  4. 규칙 편집기에서 디자이너 옵션을 스크립트 편집으로 변경하고 스크립트 유형을 Groovy 스크립트로 설정합니다.
    스크립트 편집 및 Groovy 스크립트가 선택된 규칙 편집기
  5. 이 스크립트를 복사하여 편집기에 붙여넣습니다.
    Code reference 1operation.grid.dataCellIterator.each {
    Code reference 2    if(it.missing) {
    Code reference 3        it.bgColor = 0x00BFFF
    Code reference 4    } else if(it.data <= 50000)
    Code reference 5        it.bgColor = 0xFF8C00
        else if(it.data > 50000)
    Code reference 6        it.bgColor = 0x00FA9A
    }
    

    코드 참조 1 스크립트는 dataCellIterator에서 반환된 현재 데이터 그리드 operation.grid의 각 데이터 셀을 반복합니다.

    암시적 it 변수는 반복되는 현재 항목을 참조합니다. 이 경우 it 변수는 dataCellIterator에서 반환된 현재 데이터 셀을 참조합니다.

    참고:

    아래 예제와 같이 명시적으로 이름이 지정된 변수(예: cell)를 사용할 수도 있습니다.
     operation.grid.dataCellIterator.each { cell ->
        if(cell.missing) {
          cell.bgColor = 0x00BFFF
        }
    }

    코드 참조 2 현재 데이터 셀의 경우 스크립트에서 누락된 값을 확인합니다.

    주:

    cell.data는 #MISSING 또는 0인 셀에 대해 0(영)을 반환합니다. 0이 아닌 #MISSING에 대한 셀을 확인하려면 cell.missing 속성을 사용할 수 있습니다. 셀에서 #MISSING가 아닌 0 값을 검사하려면 cell.data == 0 && !cell.missing과 같은 조건을 사용할 수 있습니다.

    코드 참조 3 TRUE인 경우 스크립트는 셀의 배경색을 0x00BFFF( █ )로 설정합니다.

    코드 참조 4 이 스크립트는 데이터 값이 50000보다 작거나 같은지 확인합니다.

    코드 참조 5 TRUE인 경우 스크립트는 셀의 배경색을 0xFF8C00 ( █ )로 설정합니다.

    코드 참조 6 셀의 데이터 값이 50000보다 크면 스크립트는 셀의 배경색을 0x00FA9A ( █ )로 설정합니다.

  6. 도구모음에서 저장(저장)을 눌러 스크립트를 저장합니다. 확인을 눌러 정보 메시지를 닫습니다.
    규칙이 저장되었음을 확인하는 정보 메시지
  7. 검증 및 배포(검증 및 배포)을 누릅니다. 확인을 눌러 정보 메시지를 닫습니다.
    성공적으로 배치되었음을 확인하는 메시지 배치
  8. Calculation Manager를 연 상태로 두고 Planning 브라우저 창으로 돌아갑니다.

데이터 양식에 규칙 추가

  1. Planning 홈 페이지에서 데이터를 누릅니다. 데이터 양식을 열려면 EmployeeDriverForm을 누릅니다.
    EmployeeDriverForm 초기 데이터로 열기
  2. 작업, 편집 순으로 선택합니다.
    편집이 선택된 작업 메뉴
  3. 비즈니스 규칙 탭을 선택합니다.
  4. 선택한 비즈니스 규칙에 Groovy 배경색 설정을 추가합니다.
    선택한 업무 규칙의 Groovy 규칙이 있는 업무 규칙 탭
  5. [비즈니스 규칙 속성]에서 로드 후 실행을 선택합니다.
    로드 후 실행이 선택된 비즈니스 규칙 속성
  6. 저장을 눌러 양식 정의를 저장합니다. 확인을 눌러 정보 메시지를 닫습니다.
    양식이 저장되었음을 확인하는 정보 메시지
  7. 페이지 하단에서 EmployeeDriverForm 편집 탭을 닫아 데이터 양식으로 돌아갑니다.
  8. 양식이 다시 로드되면 누락된 셀이 파란색이고 50000보다 작거나 같은 값이 주황색이며 50000보다 큰 값이 녹색인지 확인합니다.
    파란색 누락 셀, 주황색 값이 임계값 이하, 녹색 값이 임계값을 초과하는 재로드된 양식

스크립트 프로파일링 및 디버깅

이 섹션에서는 DataGrid 인터페이스에서 제공하는 이터레이터를 사용하고, 코드를 프로파일링하고, 작업 콘솔에 디버깅 문을 추가하는 방법을 배웁니다.

Groovy 스크립트 생성

  1. Calculation Manager 창으로 돌아갑니다.
  2. 시스템 뷰 탭을 선택합니다. Plan1에서 규칙을 마우스 오른쪽 버튼로 누르고 새로 작성을 선택합니다.
    규칙 컨텍스트 메뉴에서 신규가 선택된 시스템 뷰
  3. [이름]에 Groovy Iterator Performance을 입력한 다음 확인을 누릅니다.
    Groovy 반복기 성능이 입력된 새 규칙 대화상자
  4. 규칙 편집기에서 디자이너 옵션을 스크립트 편집으로 변경하고 스크립트 유형을 Groovy 스크립트로 설정합니다.
    스크립트 편집 및 Groovy 스크립트가 선택된 규칙 편집기
  5. 이 스크립트를 복사하여 편집기에 붙여넣습니다.
    Code reference 1def benchmark(GridIterator itr) {
    Code reference 2    def start = currentTimeMillis()
    Code reference 3    itr.each { println "$it.memberNames, cell data: $it.data, $it.formattedValue" }
        def elapsed = currentTimeMillis() - start
    Code reference 4    println "\nTime taken by iterator: $elapsed"
    }
    
    Code reference 5println "Iterate over all data cells in this data grid...\n"
    Code reference 6benchmark operation.grid.dataCellIterator()
    
    println "Iterate over edited data cells in this data grid...\n"
    Code reference 7benchmark operation.grid.dataCellIterator({DataCell cell -> cell.edited})
    
    println "Iterate over Min Salary and Min Bonus data cells in this data grid...\n"
    Code reference 8benchmark operation.grid.dataCellIterator('Min Salary', 'Min Bonus')
    

    코드 참조 1 지정된 GridIterator를 사용하여 해당 셀을 반복하고 셀이 해당 데이터와 함께 나타내는 모든 차원에서 멤버 이름 목록을 인쇄하는 benchmark()이라는 유틸리티 메소드를 정의합니다. 이터레이터에 걸린 시간도 인쇄됩니다.

    코드 참조 2 타이머를 시작합니다.

    코드 참조 3 지정된 GridIterator를 사용하여 각 셀을 반복하고 셀이 나타내는 모든 차원에서 해당 데이터 값 및 형식 지정된 값과 함께 멤버 이름 목록을 인쇄합니다. $it.data는 셀에 대한 숫자 값을 반환하고 $it.formattedValue는 사용자가 입력한 텍스트, 스마트 목록 또는 날짜와 같은 숫자가 아닌 값을 반환합니다.

    코드 참조 4 반복기에 걸린 시간을 작업 콘솔에 인쇄합니다.

    코드 참조 5 작업 콘솔에 디버깅 메시지를 기록합니다.

    코드 참조 6 반복기가 있는 benchmark() 메소드를 호출하여 현재 데이터 그리드의 각 셀을 반복합니다.

    코드 참조 7 이터레이터와 함께 benchmark() 메소드를 호출하여 현재 데이터 그리드에서 편집된 셀을 반복합니다.

    참고:

    이 이터레이터는 잠김, 누락, 유효, readOnly, validIntersection 등과 같은 부울을 반환하는 DataCell 객체의 모든 속성과 함께 사용할 수 있습니다.

    코드 참조 8 반복기가 있는 benchmark() 메소드를 호출하여 현재 데이터 그리드의 최소 임금 및 최소 상여 데이터 셀을 반복합니다.

  6. 도구모음에서 저장(저장)을 눌러 스크립트를 저장합니다. 확인을 눌러 정보 메시지를 닫습니다.
    Groovy 반복기 성능이 저장되었음을 확인하는 정보 메시지
  7. 검증 및 배포(검증 및 배포)을 누릅니다. 확인을 눌러 정보 메시지를 닫습니다.
    성공적인 배치를 확인하는 메시지
  8. Calculation Manager를 연 상태로 두고 Planning 브라우저 창으로 돌아갑니다.

데이터 양식에 규칙 추가

  1. EmployeeDriverForm 양식에서 작업을 누른 다음 편집을 선택합니다.
    편집이 선택된 작업 메뉴
  2. 비즈니스 규칙 탭을 선택한 다음 선택한 비즈니스 규칙에 Groovy 반복기 성능을 추가합니다.
    선택한 업무 규칙에 Groovy 반복자 성과가 추가된 업무 규칙 탭
  3. 비즈니스 규칙 등록정보에서 Groovy 이터레이터 성능 규칙에 대해 저장 후 실행을 선택합니다.
    Groovy 이터레이터 성능이 저장 후 실행되도록 구성됨
  4. 저장을 눌러 양식 정의를 저장합니다. 확인을 눌러 정보 메시지를 닫습니다.
    양식이 저장되었음을 확인하는 정보 메시지
  5. 페이지 하단에서 EmployeeDriverForm 편집 탭을 닫아 데이터 양식으로 돌아갑니다.

Groovy 스크립트 테스트

  1. EmployeeDriverForm에서 등급 1에 대한 최소 임금을 35000로 변경하고 등급 2에 대한 최소 상여를 2000로 변경합니다.
    FY26에 대해 두 개의 편집된 셀이 있는 EmployeeDriverForm
  2. Save를 누릅니다. Groovy 반복기 성능 규칙은 데이터가 저장된 후에 실행됩니다. 확인을 눌러 정보 메시지를 닫습니다.
    데이터가 저장되었고 규칙이 성공적으로 실행되었음을 확인하는 정보 메시지
  3. 네비게이터(네비게이터)을 누른 다음 [애플리케이션]에서 작업을 눌러 작업 콘솔을 엽니다.
    완료된 Groovy Iterator 성능 작업이 있는 작업 콘솔
  4. Groovy 반복기 성능을 눌러 작업 세부정보를 표시합니다. 실행 상태에서 완료됨을 확장하여 Groovy 스크립트로 인쇄된 로그 메시지를 봅니다.
    이터레이터 로그 메시지를 보여주는 완료된 작업 세부정보

    첫 번째 이터레이터는 모든 셀과 데이터 값을 인쇄하고, 두 번째 이터레이터는 편집된 두 개의 셀만 인쇄하며, 세 번째 이터레이터는 최소 임금 및 최소 상여 열의 셀만 인쇄합니다.

  5. Job Details를 닫습니다.
  6. 네비게이터(네비게이터)을 누른 다음 데이터를 선택하여 EmployeeDriverForm로 돌아갑니다.

기본 데이터 값 설정

이 섹션에서는 DataGridBuilder 인터페이스를 사용하여 그리드에서 기본 데이터 값을 설정하는 방법에 대해 알아봅니다.

Groovy 스크립트 생성

  1. Calculation Manager 창으로 돌아갑니다.
  2. 시스템 뷰 탭을 선택합니다. Plan1에서 규칙을 마우스 오른쪽 버튼로 누르고 새로 작성을 선택합니다.
    규칙 컨텍스트 메뉴에서 신규가 선택된 시스템 뷰
  3. [이름]에 Groovy Reset Grade Data을 입력한 다음 확인을 누릅니다.
    Groovy 등급 데이터 재설정이 입력된 새 규칙 대화상자
  4. 규칙 편집기에서 디자이너 옵션을 스크립트 편집으로 변경하고 스크립트 유형을 Groovy 스크립트로 설정합니다.
    스크립트 편집 및 Groovy 스크립트가 선택된 규칙 편집기
  5. 이 스크립트를 복사하여 편집기에 붙여넣습니다.
    Code reference 1Cube cube = operation.application.getCube("Plan1")
    String currentYear = operation.application.getSubstitutionVariableValue("OEP_CurYr")
    
    Code reference 2DataGridBuilder builder = cube.dataGridBuilder("MM/DD/YYYY")
    Code reference 3builder.addPov(currentYear, 'Current', 'USD', 'BegBalance', 'BU Version_1', 'No Entity')
    builder.addColumn('Min Salary', 'Max Salary', 'Min Bonus', 'Max Bonus')
    builder.addRow(['Grade 1'], [30000, 50000, '#missing', '#missing'])
    builder.addRow(['Grade 2'], [40000, 60000, '#missing', 5000])
    builder.addRow(['Grade 3'], [70000, 90000, '#missing', 10000])
    
    Code reference 4DataGridBuilder.Status status = new DataGridBuilder.Status()
    Code reference 5builder.build(status).withCloseable { DataGrid grid ->
    Code reference 6    println("Total number of cells accepted: $status.numAcceptedCells")
        println("Total number of cells rejected: $status.numRejectedCells")
        println("First 100 rejected cells: $status.cellsRejected")
    Code reference 7    cube.saveGrid(grid)
    Code reference 8}
    

    코드 참조 1 Plan1 큐브에 대한 큐브 객체를 빌드하고 애플리케이션 레벨 대체 변수에서 현재 연도를 읽습니다. getSubstitutionVariableValue("OEP_CurYr")는 앰퍼샌드 없이 애플리케이션 레벨 대체 변수를 읽습니다. 제공된 스냅샷에서 값은 FY26입니다.

    코드 참조 2 큐브에 대한 DataGridBuilder을 가져오고 스크립트에서 날짜 값을 제공하는 형식을 정의합니다.

    주:

    또한 DataGridBuilder는 ExecuteAsUser를 두번째 매개변수로 수락하여 시스템 사용자 대신 데이터 저장을 지원합니다. 데이터를 시스템 사용자로 저장하면 현재 사용자의 보안을 적용하지 않고도 데이터를 저장할 수 있습니다. ExecuteAsUser에 적합한 값은 다음 예와 같이 CURRENT_USER(기본값) 및 SYSTEM_USER입니다.

    DataGridBuilder builder = cube.dataGridBuilder("MM/DD/YYYY", SYSTEM_USER)

    코드 참조 3 POV 멤버, 열 멤버 및 데이터 값이 있는 행을 추가하여 데이터 그리드를 구성합니다. currentYear를 addPov에 전달하면 재설정 규칙이 1년에 하드 코딩하지 않고 양식과 정렬됩니다.

    코드 참조 4 다음 단계에서 생성한 DataGrid 객체에 대한 status 객체를 작성합니다.

    코드 참조 5 withCloseable 생성자로 DataGrid 객체를 작성합니다. 블록이 완료되면 그리드가 닫히므로 규칙은 그리드를 메모리에 열어 두지 않습니다.

    코드 참조 6 빌더가 수락하거나 거부한 셀 수를 작업 콘솔에 인쇄합니다. 읽기 전용 셀은 거부됩니다.

    코드 참조 7 데이터 그리드를 저장합니다.

    코드 참조 8 그리드가 자동으로 닫힙니다.

  6. 도구모음에서 저장(저장)을 눌러 스크립트를 저장합니다. 확인을 눌러 정보 메시지를 닫습니다.
    Groovy 등급 데이터 재설정이 저장되었음을 확인하는 정보 메시지
  7. 검증 및 배포(검증 및 배포)을 누릅니다. 확인을 눌러 정보 메시지를 닫습니다.
    성공적인 배치를 확인하는 메시지
  8. Calculation Manager를 닫고 Planning 브라우저 창으로 돌아갑니다.

데이터 양식에 규칙 추가

  1. EmployeeDriverForm에서 작업, 편집 순으로 선택합니다.
    편집이 선택된 작업 메뉴
  2. 비즈니스 규칙 탭을 선택합니다.
  3. 선택한 비즈니스 규칙에 Groovy 등급 데이터 재설정을 추가합니다.
    선택한 업무 규칙에 Groovy 등급 데이터 재설정이 있는 업무 규칙 탭
  4. 업무 규칙 속성에서 Groovy 등급 재설정 데이터 규칙에 대해 수동으로 실행할 수 있도록 로드 전 실행, 로드 후 실행, 저장 전 실행 및 저장 후 실행을 지운 상태로 둡니다.
    모든 자동 로드 및 저장 옵션이 지워진 Groovy 등급 데이터 재설정
  5. 저장을 눌러 양식 정의를 저장한 다음 확인을 눌러 정보 메시지를 닫습니다.
    양식이 저장되었음을 확인하는 정보 메시지
  6. 페이지 하단에서 EmployeeDriverForm 편집 탭을 닫아 데이터 양식으로 돌아갑니다.

Groovy 스크립트 테스트

  1. 작업을 누른 다음 규칙 및 스마트 푸시를 선택합니다.
    규칙 및 스마트 푸시가 선택된 작업 메뉴
  2. 규칙에서 Groovy 등급 데이터 재설정을 선택하여 규칙을 실행합니다.
    Groovy 등급 데이터 재설정이 선택된 규칙 목록
  3. 규칙이 성공적으로 완료되면 확인을 눌러 정보 메시지를 닫습니다.
    Groovy 등급 데이터 재설정이 성공적으로 실행되었음을 확인하는 정보 메시지
  4. 그리드 데이터가 다음 값으로 재설정되었는지 확인합니다.
    FY26 기본 급여 및 상여금 값이 복원된 EmployeeDriverForm
    직급최소 급여최대 급여최소 상여최대 보너스
    1등급3000050000누락됨누락됨
    2등급4000060000누락됨5000
    3등급7000090000누락됨10000
  5. 네비게이터(네비게이터)을 누른 다음 [애플리케이션]에서 작업을 눌러 작업 콘솔을 엽니다.
    완료된 Groovy 등급 데이터 재설정 작업이 있는 작업 콘솔
  6. 작업 세부정보를 표시하려면 Groovy 등급 데이터 재설정을 누릅니다. 실행 상태에서 완료됨을 확장하여 수락 및 거부된 셀 수를 확인합니다.
    수락 및 거부된 셀 수가 있는 완료된 Groovy 등급 데이터 재설정 작업 세부정보

추가 학습 자원

docs.oracle.com/learn에서 다른 랩을 탐색하거나 Oracle Learning YouTube 채널에서 더 많은 무료 학습 콘텐츠에 액세스하세요. 또한 제공되는 교육 리소스를 보려면 Oracle University를 방문하십시오.

제품 설명서는 Oracle Help Center를 참조하십시오.