機械翻訳について

Oracle Analytics AIアシスタントを埋め込むためのHTMLページの準備

Oracle Analytics AIアシスタントを埋め込むには、埋込みV2メソッドを使用するようにHTMLページを作成または更新し、必要な<oracle-analytics-assistant>埋込みタグを含める必要があります。

このトピックでは、以下について説明します。

DOCTYPE宣言

doctype宣言を<!DOCTYPE html>に設定します。 <!DOCTYPE html>以外のdoctype宣言を使用した場合、またはdoctype宣言を含めることを忘れた場合、ページが正しくレンダリングされないなどの予期しない動作が発生します。

Dirグローバル属性

webページのロケールに応じて、dirグローバル属性を設定します。 dirグローバル属性は、埋込みアナリティクス・コンテンツのレイアウト方向を示します。

ノート:

複数のロケールをサポートする必要がある場合は、JavaScriptを使用して属性を設定します。

属性値のオプションは次のとおりです:

  • rtl - 右から左のレイアウト方向に使用します。
  • ltr - 左から右のレイアウト方向に使用します。
  • auto - 使用しません。 この値はOracle Analyticsではサポートされていません。

<script>タグおよびJavaScriptソース・リファレンス

embedding.jsを参照する<script>タグをHTMLページに追加します。

JavaScriptソースのURL構造は次のとおりです:

  • "https://<instance>.analytics.ocp.oraclecloud.com/public/dv/v2/embedding/auto/embedding.js"

<oracle-analytics-assistant>要素

アシスタントを埋め込むには、属性値を含む次のHTMLスニペットを適切なサイズの要素に追加する必要があります。 Oracle Analyticsによって、含める必要があるHTMLが生成されます。 src-dataパラメータは、AIアシスタントが使用するデータセットです。 

<oracle-analytics-assistant 
    src-data="[&quot;XSA('<user-name>'.'<data source name>')&quot;]">
</oracle-analytics-assistant>

基本的な例

<!DOCTYPE html>
<html dir="ltr">
<head>
  <meta charset="utf-8">
  <script src="https://<your-OAC-instance>.analytics.ocp.oraclecloud.com/public/dv/v2/embedding/auto/embedding.js"></script>
  <style>
    html, body {
      margin: 0;
      height: 100%;
    }
    oracle-analytics-assistant {
      width: 100%;
      height: 100%;
      display: block;
    }
  </style>
</head>

<body>
  <oracle-analytics-assistant
    id="oaAssistant"
    src-data="[&quot;XSA('<user-name>'.'<data source name>')&quot;]">
  </oracle-analytics-assistant>

  <script>
    oracle.oa.embedding.ready().then(oApp => oApp.applyBindings());
  </script>
</body>
</html>

トークンを含む例

<!DOCTYPE html>
<html dir="ltr">
<head>
  <meta charset="utf-8">
  <script src="https://<your-OAC-Instance>.analytics.ocp.oraclecloud.com/public/dv/v2/embedding/auto/embedding.js"></script>
  <style>
    html, body {
      margin: 0;
      height: 100%;
    }
    oracle-analytics-assistant {
      width: 100%;
      height: 100%;
      display: block;
    }
  </style>
</head>
<body>
  <oracle-analytics-assistant
    id="oaAssistant"
    <!-- Reference to datasource to use with AI Assistant with " escaped to &quot; -->
    src-data="[&quot;XSA('<user-name>'.'<data source name>')&quot;]">
  </oracle-analytics-assistant>

  <script>
    const token = '<access token>';

    oracle.oa.embedding.ready().then((oApp) => {
      oApp.setEmbeddingConfig({
        oSecurityConfig: {
          eSecurityType: "token",
          oOptions: {
            credentials: "",
            tokenAuthFunction: new Function("return '" + token + "'")
          }
        }
      });
      oApp.applyBindings();
    });
  </script>
</body>
</html>