지원되는 리포트 쿼리 선택하기
관리형 앱 리포트 지원 범위와 Core의 확장 분석 기능을 구분합니다.
지원되는 리포트 쿼리 선택하기
관리형 샌드박스 앱은 생성된 건수 리포트부터 사용하세요. 대시보드에 App 리포트 추가하기에 선언·배치·확인 절차가 있습니다. 리포트 정의 자체가 원본 데이터 조회 권한을 주지는 않습니다.
| 필요한 쿼리 | 관리형 격리 앱 경로 |
|---|---|
| 조회 가능한 레코드 건수 | 생성된 ReportDefinition::count(); 첫 페이지 길이가 아닌 provider 전체 건수 |
| 공개 필드 선택 | 단일 리소스·명시적으로 선택 가능한 필드·최대 100행 |
| 필터 | 공개 eq·in 조건을 AND로 결합 |
| 그룹·join·기간 비교·정렬·서로 다른 measure 조건 | 현재 격리 읽기 계약 범위 밖이므로 거절 |
| 업무 전용 대화형 차트 | 인가되고 범위가 제한된 자체 API와 App React 화면 구현 |
Core는 지원되는 소스에 더 넓은 Composition 기능을 제공합니다. 편집기·SDK에 타입이 있다는 이유로 모든 격리 앱에서 실행되는 것은 아닙니다. Core SQL provider import·다른 앱 테이블 join·잘린 결과의 가짜 전체 집계로 우회하지 마세요.
안전한 필드만 선언
생성된 리소스는 검토된 UUID·이름·시간 필드를 기본으로 게시합니다. 선택·집계 가능 여부는 Resource descriptor의 composition metadata가 정하며 목록 필터가 분석 접근을 자동 허용하지는 않습니다. 실제 존재하고 번역 라벨과 행 권한이 유지되는 필드만 공개하세요. CompositionSpec은 schema_version: 1을 사용하고 표현 컴포넌트는 Table·MetricCard·Chart·PivotTable입니다. channel은 선언된 출력 alias를 참조합니다.
ReportContribution::reports()는 ReportDefinition을 반환합니다. 생성된 건수 선언을 유지하고 같은 키를 중복 등록하지 마세요. 사용자 정의 리포트는 SDK schema와 환경의 실행 범위를 모두 충족해야 합니다. 사용자에게 허용된 catalog와 편집기 선택지를 사용하고 관계 키·필드를 임의로 만들어 넣지 않습니다.
조직 참조 필드 표시
Laravel SDK 0.10.23의 OrganizationReferenceProjection은 현재 사용자와 조직 범위로 행을 제한한 Composition provider에서 사용합니다. Eloquent 쿼리, 앱 소유 테이블의 조직 키 컬럼, provider context의 조직 대상을 legalEntity() 또는 operatingUnit()에 전달하면 대응하는 공개 ID를 선택할 수 있습니다. legalEntityLabel()과 operatingUnitLabel()은 표시 이름을 선택합니다. 이 메서드들은 출력 컬럼을 추가하며 행을 제한하거나 접근 권한을 부여하지 않습니다. provider의 권한 조건을 유지하고 descriptor에서 허용한 필드만 등록하세요. SDK 구현을 참고하세요.
사용자별 결과 확인
저장한 리포트 revision과 대시보드 배치는 쿼리 정의를 참조합니다. 공유한다고 원본 권한까지 전달되지 않습니다. 전체 허용·일부 허용·거절 사용자의 결과를 비교하고 조직 변경·권한 회수도 확인하세요. 소스 사용 불가 시 다른 사용자 캐시 대신 사용 불가 상태를 표시해야 합니다. 지원되지 않는 실행 계획은 기능 범위 문제이며 Policy를 완화할 이유가 아닙니다.