임베딩된 Oracle Analytics 콘텐츠를 위한 HTML 페이지 준비

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에서 지원되지 않습니다.

주:

Oracle Analytics는 포함해야 할 JavaScript 소스의 URL과 <script> 태그를 생성합니다.

embedding.js를 참조하는 <script> 태그를 HTML 페이지에 추가합니다.

JavaScript 소스의 URL 구조는 다음과 같습니다.

”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을 사용합니다.
Oracle Analytics가 사용하는 JET 버전을 찾으려면 Oracle Analytics에 로그인하여 브라우저 콘솔을 열고 이 명령을 실행하십시오.
```
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 모델 내에 정의된 정적 문자열 및 속성을 지원합니다. Knockout은 Oracle JET에서 사용되는 기술입니다.

주:

이 속성을 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여야 합니다.
주:

이 속성을 설정할 때 다음 두 가지 항목에 유의하십시오.

호환성 모드를 사용하는 경우 관리자가 안전한 도메인으로 등록한 애플리케이션에 대해 프레임 허용이 선택되었는지 확인합니다. 안전한 도메인으로 애플리케이션 등록을(를) 참조하십시오.
Oracle Analytics가 사용하는 JET 버전을 찾으려면 Oracle Analytics에 로그인하여 브라우저 콘솔을 열고 이 명령을 실행하십시오.
```
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>