Oracle Analytics 콘텐츠를 임베딩하려면 HTML 페이지를 생성 또는 업데이트하여 필요한 DOCTYPE 선언과 dir 전역 속성을 포함하고, embedding.js JavaScript 소스 및 임베딩된 워크북의 URL을 참조해야 합니다. 또한 임베딩 모드(JET 또는 독립형), 인증 방법을 지정하고 모든 속성을 추가해야 합니다.
doctype 선언
doctype 선언을 <!DOCTYPE html>
에 설정합니다. <!DOCTYPE html>
이 아닌 doctype 선언을 사용하거나 doctype 선언을 포함하는 것을 잊어버리면 페이지가 올바르게 렌더링되지 않는 것 같은 예측할 수 없는 동작이 발생합니다.
dir 전역 속성
웹 페이지의 로케일에 필요한 대로 dir
전역 속성을 설정합니다. dir
전역 속성은 임베딩된 분석 콘텐츠의 레이아웃 방향을 나타냅니다.
주:
여러 로케일 지원이 필요한 경우 JavaScript를 사용하여 속성을 설정하십시오.
속성값 옵션은 다음과 같습니다.
rtl
- 오른쪽에서 왼쪽 레이아웃 방향에 사용합니다.ltr
- 왼쪽에서 오른쪽 레이아웃 방향에 사용합니다.auto
- 사용 안함. 이 값은 Oracle Analytics에서 지원되지 않습니다.<script> 태그 및 JavaScript 소스 참조
주:
Oracle Analytics는 포함해야 할 JavaScript 소스의 URL과<script>
태그를 생성합니다.embedding.js를 참조하는 <script>
태그를 HTML 페이지에 추가합니다.
”https://<instance>.analytics.ocp.oraclecloud.com/public/dv/v1/embedding/<embeddingMode>/embedding.js”
. 본 문서의 예에서는 이 URL을 사용합니다."http://<instance>.analytics.ocp.oraclecloud.com/ui/dv/v1/embedding/<embeddingMode>/embedding.js"
를 사용합니다.여기서 <embeddingMode>
는 jet
또는 standalone
이어야 합니다.
기존 Oracle JET 애플리케이션 내에 분석 콘텐츠를 임베딩할 경우 jet
를 사용합니다. jet
를 사용할 경우 애플리케이션에서 사용되는 Oracle JET 버전이 Oracle Analytics에서 사용되는 Oracle JET 주 버전과 일치해야 합니다. 예를 들어, Oracle Analytics가 JET 11.0.0을 사용하는 경우 사용자정의 애플리케이션은 JET 11.0.0 또는 11.1.0을 사용해야 합니다. Oracle Analytics는 Oracle JET 버전 11.1.10을 사용합니다.
requirejs('ojs/ojcore').version
임베딩 애플리케이션이 Oracle JET를 사용하는 경우, Oracle Analytics는 필요한 구성요소로 애플리케이션을 확장합니다. Oracle JET를 사용하는 사용자정의 애플리케이션에 Oracle Analytics 콘텐츠 임베딩을(를) 참조하십시오.
Oracle JET는 Oracle Analytics 사용자 인터페이스에 사용되는 Javascript 기반의 라이브러리 집합입니다.
Oracle JET를 사용하지 않는 일반 애플리케이션에 시각화 콘텐츠를 포함할 경우 standalone
을 사용합니다.
임베딩 애플리케이션이 Oracle JET를 사용하지 않는 경우 Oracle Analytics는 추가 구성요소와 함께 JET 배포판을 페이지로 가져옵니다. Oracle JET를 사용하지 않는 사용자정의 애플리케이션에 Oracle Analytics 콘텐츠 임베딩을(를) 참조하십시오.
인증
임베딩된 분석 콘텐츠를 보려면 인증된 세션이 필요합니다. 로그온 프롬프트 또는 3단계 OAuth 인증을 사용할 수 있습니다. 인증 추가을(를) 참조하십시오.
<oracle-dv> 요소
워크북을 포함하려면 적절하게 크기가 조정된 요소 내에 속성값이 있는 다음 HTML 코드 조각을 추가해야 합니다. Oracle Analytics는 포함해야 할 HTML을 생성합니다.
<oracle-dv project-path="" active-page="" active-tab-id="" filters=""></oracle—dv>
주:
이 속성을 Knockout 모델에 바인딩하는 예제는 Oracle JET를 사용하지 않는 사용자정의 애플리케이션에 Oracle Analytics 콘텐츠 임베딩을(를) 참조하십시오.
project-path
: 렌더링할 워크북의 경로를 지정합니다.
active-page
: (선택사항) 기본값이 아닌 인사이트를 렌더링할지 여부를 지정합니다. active-page
를 지정할 때 active-tab-id
를 사용하여 현재 표시되는 정확한 [표현] 캔버스도 지정합니다. 적합한 값은 insight
입니다.
주:
active-page
값 canvas
는 더 이상 사용되지 않습니다. canvas
를 사용하는 임베딩 코드를 insight
로 수정하는 것이 좋습니다. canvas
를 사용하는 기존 임베딩된 분석 콘텐츠는 계속 작동하며 브라우저 콘솔에 경고가 표시됩니다.active-tab-id
: (선택사항) 현재 표시되는 [시각화] 캔버스 또는 [표현] 캔버스의 ID를 지정합니다.
filters
: (선택사항) 포함된 워크북에 필터 값을 프로그래밍 방식으로 전달할 수 있습니다.
project-options
: (선택사항) 이 속성에서 project는 워크북을 가리킵니다. 다음 옵션을 전달할 수 있습니다.
bDisableMobileLayout
: 모바일 레이아웃을 사용 안함 또는 사용으로 설정합니다. 모바일 레이아웃은 전화 장치에만 제공되는 요약 카드 레이아웃을 가리킵니다. 값은 true
또는 false
여야 합니다.bShowFilterBar
: 필터 모음을 표시하거나 숨깁니다. 값은 true
또는 false
여야 합니다.showCanvasNavigation
: 워크북의 [표현] 탭에 있는 캔버스 탐색 설정에 따라 워크북의 캔버스를 표시하거나 숨깁니다. 값은 true
또는 false
여야 합니다.예: <oracle-dv project-path="{{projectPath}}" active-page="canvas" active-tab-id="1" filters="{{filters}}" project-options='{"bDisableMobileLayout":true, "bShowFilterBar":false}'></oracle-dv>
brushing-type
: 브러싱 작동 방식을 제어합니다. 사용자가 지정한 값은 저장된 워크북의 설정과 시스템 기본값을 포함하여 다른 모든 설정을 무효화합니다. 값은 문자열 on
, off
또는 auto
여야 합니다.
on
: 보통 우선순위로 브러싱 질의를 실행하는 데 사용됩니다. 브러싱 질의와 시각화 질의가 혼합되어 동시에 실행됩니다.auto
: 기본값. 낮은 우선순위로 브러싱 질의를 실행하는 데 사용됩니다. 사용자가 시각화와 상호작용할 때 브러싱 질의가 완료될 때까지 다른 시각화에서 표시가 지연될 수 있습니다.compatibility-mode
: Oracle JET의 다양한 주 버전이 있을 때 사용합니다. 그러면 런타임 시 iFrame이 생성되어 임베딩된 분석 콘텐츠가 샌드박싱됩니다. 값은 문자열 yes
, no
또는 auto
여야 합니다.
주:
이 속성을 설정할 때 다음 두 가지 항목에 유의하십시오.
호환성 모드를 사용하는 경우 관리자가 안전한 도메인으로 등록한 애플리케이션에 대해 프레임 허용이 선택되었는지 확인합니다. 안전한 도메인으로 애플리케이션 등록을(를) 참조하십시오.
requirejs('ojs/ojcore').version
yes
: 임베딩된 분석 콘텐츠를 항상 샌드박싱하려는 경우 사용합니다. 이는 Oracle APEX 애플리케이션에 임베딩할 때 유용합니다.no
: 기본값입니다. iFrame을 생성하지 않으려는 경우 사용합니다.auto
: 호스트 임베딩 애플리케이션과 Oracle Analytics 간 Oracle JET 버전의 주요 차이점을 자동으로 감지하는 데 사용됩니다. Oracle APEX에 임베딩할 때 사용할 수 있습니다.예
이 예에서 project의 모든 인스턴스는 워크북을 가리킵니다.
<!DOCTYPE html> <html dir="ltr"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title>Embedded Oracle Analytics Workbook Example</title> <script src="https://<instance>.analytics.ocp.oraclecloud.com/public/dv/v1/embedding/<embedding mode>/embedding.js" type="application/javascript"> </script> </head> <body> <h1>Embedded Oracle Analytics Workbook</h1> <div style="border:1px solid black;position: absolute; width: calc(100% - 40px); height: calc(100% - 120px)" > <!-- The following <oracle-dv> tag is the tag that will embed the specified workbook. --> <oracle-dv project-path="<project path>" active-page="insight" active-tab-id="snapshot!canvas!1"> </oracle-dv> </div> <!-- Apply Knockout bindings after DV workbook is fully loaded. This should be executed in a body onload handler or in a <script> tag after the <oracle-dv> tag. --> <script> requirejs(['knockout', 'ojs/ojcore', 'ojs/ojknockout', 'ojs/ojcomposite', 'jet-composites/oracle-dv/loader'], function(ko) { ko.applyBindings(); }); </script> </body> </html>