diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 00000000..c1965c21 --- /dev/null +++ b/.gitattributes @@ -0,0 +1 @@ +.github/workflows/*.lock.yml linguist-generated=true merge=ours \ No newline at end of file diff --git a/.github/agents/agentic-workflows.agent.md b/.github/agents/agentic-workflows.agent.md new file mode 100644 index 00000000..b6e648cb --- /dev/null +++ b/.github/agents/agentic-workflows.agent.md @@ -0,0 +1,196 @@ +--- +description: GitHub Agentic Workflows (gh-aw) - Create, debug, and upgrade AI-powered workflows with intelligent prompt routing +disable-model-invocation: true +--- + +# GitHub Agentic Workflows Agent + +This agent helps you work with **GitHub Agentic Workflows (gh-aw)**, a CLI extension for creating AI-powered workflows in natural language using markdown files. + +## What This Agent Does + +This is a **dispatcher agent** that routes your request to the appropriate specialized prompt based on your task: + +- **Creating new workflows**: Routes to `create` prompt +- **Updating existing workflows**: Routes to `update` prompt +- **Debugging workflows**: Routes to `debug` prompt +- **Upgrading workflows**: Routes to `upgrade-agentic-workflows` prompt +- **Creating report-generating workflows**: Routes to `report` prompt — consult this whenever the workflow posts status updates, audits, analyses, or any structured output as issues, discussions, or comments +- **Creating shared components**: Routes to `create-shared-agentic-workflow` prompt +- **Fixing Dependabot PRs**: Routes to `dependabot` prompt — use this when Dependabot opens PRs that modify generated manifest files (`.github/workflows/package.json`, `.github/workflows/requirements.txt`, `.github/workflows/go.mod`). Never merge those PRs directly; instead update the source `.md` files and rerun `gh aw compile --dependabot` to bundle all fixes +- **Analyzing test coverage**: Routes to `test-coverage` prompt — consult this whenever the workflow reads, analyzes, or reports on test coverage data from PRs or CI runs +- **CLI commands and triggering workflows**: Routes to `cli-commands` guide — consult this whenever the user asks how to run, compile, debug, or manage workflows from the command line, or when they need the MCP tool equivalent of a `gh aw` command + +Workflows may optionally include: + +- **Project tracking / monitoring** (GitHub Projects updates, status reporting) +- **Orchestration / coordination** (one workflow assigning agents or dispatching and coordinating other workflows) + +## Files This Applies To + +- Workflow files: `.github/workflows/*.md` and `.github/workflows/**/*.md` +- Workflow lock files: `.github/workflows/*.lock.yml` +- Shared components: `.github/workflows/shared/*.md` +- Configuration: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/github-agentic-workflows.md + +## Problems This Solves + +- **Workflow Creation**: Design secure, validated agentic workflows with proper triggers, tools, and permissions +- **Workflow Debugging**: Analyze logs, identify missing tools, investigate failures, and fix configuration issues +- **Version Upgrades**: Migrate workflows to new gh-aw versions, apply codemods, fix breaking changes +- **Component Design**: Create reusable shared workflow components that wrap MCP servers + +## How to Use + +When you interact with this agent, it will: + +1. **Understand your intent** - Determine what kind of task you're trying to accomplish +2. **Route to the right prompt** - Load the specialized prompt file for your task +3. **Execute the task** - Follow the detailed instructions in the loaded prompt + +## Available Prompts + +### Create New Workflow +**Load when**: User wants to create a new workflow from scratch, add automation, or design a workflow that doesn't exist yet + +**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/create-agentic-workflow.md + +**Use cases**: +- "Create a workflow that triages issues" +- "I need a workflow to label pull requests" +- "Design a weekly research automation" + +### Update Existing Workflow +**Load when**: User wants to modify, improve, or refactor an existing workflow + +**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/update-agentic-workflow.md + +**Use cases**: +- "Add web-fetch tool to the issue-classifier workflow" +- "Update the PR reviewer to use discussions instead of issues" +- "Improve the prompt for the weekly-research workflow" + +### Debug Workflow +**Load when**: User needs to investigate, audit, debug, or understand a workflow, troubleshoot issues, analyze logs, or fix errors + +**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/debug-agentic-workflow.md + +**Use cases**: +- "Why is this workflow failing?" +- "Analyze the logs for workflow X" +- "Investigate missing tool calls in run #12345" + +### Upgrade Agentic Workflows +**Load when**: User wants to upgrade workflows to a new gh-aw version or fix deprecations + +**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/upgrade-agentic-workflows.md + +**Use cases**: +- "Upgrade all workflows to the latest version" +- "Fix deprecated fields in workflows" +- "Apply breaking changes from the new release" + +### Create a Report-Generating Workflow +**Load when**: The workflow being created or updated produces reports — recurring status updates, audit summaries, analyses, or any structured output posted as a GitHub issue, discussion, or comment + +**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/report.md + +**Use cases**: +- "Create a weekly CI health report" +- "Post a daily security audit to Discussions" +- "Add a status update comment to open PRs" + +### Create Shared Agentic Workflow +**Load when**: User wants to create a reusable workflow component or wrap an MCP server + +**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/create-shared-agentic-workflow.md + +**Use cases**: +- "Create a shared component for Notion integration" +- "Wrap the Slack MCP server as a reusable component" +- "Design a shared workflow for database queries" + +### Fix Dependabot PRs +**Load when**: User needs to close or fix open Dependabot PRs that update dependencies in generated manifest files (`.github/workflows/package.json`, `.github/workflows/requirements.txt`, `.github/workflows/go.mod`) + +**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/dependabot.md + +**Use cases**: +- "Fix the open Dependabot PRs for npm dependencies" +- "Bundle and close the Dependabot PRs for workflow dependencies" +- "Update @playwright/test to fix the Dependabot PR" + +### Analyze Test Coverage +**Load when**: The workflow reads, analyzes, or reports test coverage — whether triggered by a PR, a schedule, or a slash command. Always consult this prompt before designing the coverage data strategy. + +**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/test-coverage.md + +**Use cases**: +- "Create a workflow that comments coverage on PRs" +- "Analyze coverage trends over time" +- "Add a coverage gate that blocks PRs below a threshold" + +### CLI Commands Reference +**Load when**: The user asks how to run, compile, debug, or manage workflows from the command line; needs the MCP tool equivalent of a `gh aw` command; or is in a restricted environment (e.g., Copilot Cloud) without direct CLI access. + +**Reference file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/cli-commands.md + +**Use cases**: +- "How do I trigger workflow X on the main branch?" +- "What's the MCP equivalent of `gh aw logs`?" +- "I'm in Copilot Cloud — how do I compile a workflow?" +- "Show me all available gh aw commands" + +## Instructions + +When a user interacts with you: + +1. **Identify the task type** from the user's request +2. **Load the appropriate prompt** from the GitHub repository URLs listed above +3. **Follow the loaded prompt's instructions** exactly +4. **If uncertain**, ask clarifying questions to determine the right prompt + +## Quick Reference + +```bash +# Initialize repository for agentic workflows +gh aw init + +# Generate the lock file for a workflow +gh aw compile [workflow-name] + +# Trigger a workflow on demand (preferred over gh workflow run) +gh aw run # interactive input collection +gh aw run --ref main # run on a specific branch + +# Debug workflow runs +gh aw logs [workflow-name] +gh aw audit + +# Upgrade workflows +gh aw fix --write +gh aw compile --validate +``` + +## Key Features of gh-aw + +- **Natural Language Workflows**: Write workflows in markdown with YAML frontmatter +- **AI Engine Support**: Copilot, Claude, Codex, or custom engines +- **MCP Server Integration**: Connect to Model Context Protocol servers for tools +- **Safe Outputs**: Structured communication between AI and GitHub API +- **Strict Mode**: Security-first validation and sandboxing +- **Shared Components**: Reusable workflow building blocks +- **Repo Memory**: Persistent git-backed storage for agents +- **Sandboxed Execution**: All workflows run in the Agent Workflow Firewall (AWF) sandbox, enabling full `bash` and `edit` tools by default + +## Important Notes + +- Always reference the instructions file at https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/github-agentic-workflows.md for complete documentation +- Use the MCP tool `agentic-workflows` when running in GitHub Copilot Cloud +- Workflows must be compiled to `.lock.yml` files before running in GitHub Actions +- **Bash tools are enabled by default** - Don't restrict bash commands unnecessarily since workflows are sandboxed by the AWF +- Follow security best practices: minimal permissions, explicit network access, no template injection +- **Network configuration**: Use ecosystem identifiers (`node`, `python`, `go`, etc.) or explicit FQDNs in `network.allowed`. Bare shorthands like `npm` or `pypi` are **not** valid. See https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/network.md for the full list of valid ecosystem identifiers and domain patterns. +- **Single-file output**: When creating a workflow, produce exactly **one** workflow `.md` file. Do not create separate documentation files (architecture docs, runbooks, usage guides, etc.). If documentation is needed, add a brief `## Usage` section inside the workflow file itself. +- **Triggering runs**: Always use `gh aw run ` to trigger a workflow on demand — not `gh workflow run .lock.yml`. `gh aw run` handles workflow resolution by short name, input parsing and validation, and correct run-tracking for agentic workflows. Use `--ref ` to run on a specific branch. +- **CLI commands reference**: For a complete guide on all `gh aw` commands and their MCP tool equivalents (for restricted environments), see https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/cli-commands.md diff --git a/.github/aw/actions-lock.json b/.github/aw/actions-lock.json new file mode 100644 index 00000000..cda73548 --- /dev/null +++ b/.github/aw/actions-lock.json @@ -0,0 +1,34 @@ +{ + "entries": { + "actions/checkout@v6.0.2": { + "repo": "actions/checkout", + "version": "v6.0.2", + "sha": "de0fac2e4500dabe0009e67214ff5f5447ce83dd" + }, + "actions/download-artifact@v8.0.1": { + "repo": "actions/download-artifact", + "version": "v8.0.1", + "sha": "3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c" + }, + "actions/github-script@v9.0.0": { + "repo": "actions/github-script", + "version": "v9.0.0", + "sha": "3a2844b7e9c422d3c10d287c895573f7108da1b3" + }, + "actions/setup-node@v6.4.0": { + "repo": "actions/setup-node", + "version": "v6.4.0", + "sha": "48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e" + }, + "actions/upload-artifact@v7.0.1": { + "repo": "actions/upload-artifact", + "version": "v7.0.1", + "sha": "043fb46d1a93c77aae656e7c1c64a875d1fc6a0a" + }, + "github/gh-aw-actions/setup@v0.71.5": { + "repo": "github/gh-aw-actions/setup", + "version": "v0.71.5", + "sha": "b8068426813005612b960b5ab0b8bd2c27142323" + } + } +} diff --git a/.github/mcp.json b/.github/mcp.json new file mode 100644 index 00000000..b953af26 --- /dev/null +++ b/.github/mcp.json @@ -0,0 +1,11 @@ +{ + "mcpServers": { + "github-agentic-workflows": { + "command": "gh", + "args": [ + "aw", + "mcp-server" + ] + } + } +} \ No newline at end of file diff --git a/.github/workflows/copilot-setup-steps.yml b/.github/workflows/copilot-setup-steps.yml new file mode 100644 index 00000000..f5f09b80 --- /dev/null +++ b/.github/workflows/copilot-setup-steps.yml @@ -0,0 +1,26 @@ +name: "Copilot Setup Steps" + +# This workflow configures the environment for GitHub Copilot Agent with gh-aw MCP server +on: + workflow_dispatch: + push: + paths: + - .github/workflows/copilot-setup-steps.yml + +jobs: + # The job MUST be called 'copilot-setup-steps' to be recognized by GitHub Copilot Agent + copilot-setup-steps: + runs-on: ubuntu-latest + + # Set minimal permissions for setup steps + # Copilot Agent receives its own token with appropriate permissions + permissions: + contents: read + + steps: + - name: Checkout repository + uses: actions/checkout@v6 + - name: Install gh-aw extension + uses: github/gh-aw-actions/setup-cli@b8068426813005612b960b5ab0b8bd2c27142323 # v0.71.5 + with: + version: v0.71.5 diff --git a/.github/workflows/translate-docs-ja.lock.yml b/.github/workflows/translate-docs-ja.lock.yml new file mode 100644 index 00000000..ef694245 --- /dev/null +++ b/.github/workflows/translate-docs-ja.lock.yml @@ -0,0 +1,1433 @@ +# gh-aw-metadata: {"schema_version":"v3","frontmatter_hash":"f03d9b501b97bb7769ab99bc8744a06cdb0b14d6dd219f5eb85e731caa5209a7","compiler_version":"v0.71.5","strict":true,"agent_id":"copilot"} +# gh-aw-manifest: {"version":1,"secrets":["COPILOT_GITHUB_TOKEN","GH_AW_CI_TRIGGER_TOKEN","GH_AW_GITHUB_MCP_SERVER_TOKEN","GH_AW_GITHUB_TOKEN","GITHUB_TOKEN"],"actions":[{"repo":"actions/checkout","sha":"de0fac2e4500dabe0009e67214ff5f5447ce83dd","version":"v6.0.2"},{"repo":"actions/download-artifact","sha":"3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c","version":"v8.0.1"},{"repo":"actions/github-script","sha":"3a2844b7e9c422d3c10d287c895573f7108da1b3","version":"v9"},{"repo":"actions/setup-node","sha":"48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e","version":"v6.4.0"},{"repo":"actions/upload-artifact","sha":"043fb46d1a93c77aae656e7c1c64a875d1fc6a0a","version":"v7.0.1"},{"repo":"github/gh-aw-actions/setup","sha":"b8068426813005612b960b5ab0b8bd2c27142323","version":"v0.71.5"}],"containers":[{"image":"ghcr.io/github/gh-aw-firewall/agent:0.25.40","digest":"sha256:14ff567e8d9d4c2fbc5e55c973488381c71d7e0fdbe72d30ee7b8a738fd86504","pinned_image":"ghcr.io/github/gh-aw-firewall/agent:0.25.40@sha256:14ff567e8d9d4c2fbc5e55c973488381c71d7e0fdbe72d30ee7b8a738fd86504"},{"image":"ghcr.io/github/gh-aw-firewall/api-proxy:0.25.40","digest":"sha256:2883ca3e5ae9f330cafdd9345bfd4ae17fc8da36c96d4c9a1f76e922b4c45280","pinned_image":"ghcr.io/github/gh-aw-firewall/api-proxy:0.25.40@sha256:2883ca3e5ae9f330cafdd9345bfd4ae17fc8da36c96d4c9a1f76e922b4c45280"},{"image":"ghcr.io/github/gh-aw-firewall/squid:0.25.40","digest":"sha256:b084f4a2c771f584ee68084ced52fa6b3245197a1889645d817462d307d3ac51","pinned_image":"ghcr.io/github/gh-aw-firewall/squid:0.25.40@sha256:b084f4a2c771f584ee68084ced52fa6b3245197a1889645d817462d307d3ac51"},{"image":"ghcr.io/github/gh-aw-mcpg:v0.3.6","digest":"sha256:2bb8eef86006a4c5963c55616a9c51c32f27bfdecb023b8aa6f91f6718d9171c","pinned_image":"ghcr.io/github/gh-aw-mcpg:v0.3.6@sha256:2bb8eef86006a4c5963c55616a9c51c32f27bfdecb023b8aa6f91f6718d9171c"},{"image":"ghcr.io/github/github-mcp-server:v1.0.3","digest":"sha256:2ac27ef03461ef2b877031b838a7d1fd7f12b12d4ace7796d8cad91446d55959","pinned_image":"ghcr.io/github/github-mcp-server:v1.0.3@sha256:2ac27ef03461ef2b877031b838a7d1fd7f12b12d4ace7796d8cad91446d55959"},{"image":"node:lts-alpine","digest":"sha256:d1b3b4da11eefd5941e7f0b9cf17783fc99d9c6fc34884a665f40a06dbdfc94f","pinned_image":"node:lts-alpine@sha256:d1b3b4da11eefd5941e7f0b9cf17783fc99d9c6fc34884a665f40a06dbdfc94f"}]} +# ___ _ _ +# / _ \ | | (_) +# | |_| | __ _ ___ _ __ | |_ _ ___ +# | _ |/ _` |/ _ \ '_ \| __| |/ __| +# | | | | (_| | __/ | | | |_| | (__ +# \_| |_/\__, |\___|_| |_|\__|_|\___| +# __/ | +# _ _ |___/ +# | | | | / _| | +# | | | | ___ _ __ _ __| |_| | _____ ____ +# | |/\| |/ _ \ '__| |/ /| _| |/ _ \ \ /\ / / ___| +# \ /\ / (_) | | | | ( | | | | (_) \ V V /\__ \ +# \/ \/ \___/|_| |_|\_\|_| |_|\___/ \_/\_/ |___/ +# +# This file was automatically generated by gh-aw (v0.71.5). DO NOT EDIT. +# +# To update this file, edit the corresponding .md file and run: +# gh aw compile +# Not all edits will cause changes to this file. +# +# For more information: https://github.github.com/gh-aw/introduction/overview/ +# +# +# Secrets used: +# - COPILOT_GITHUB_TOKEN +# - GH_AW_CI_TRIGGER_TOKEN +# - GH_AW_GITHUB_MCP_SERVER_TOKEN +# - GH_AW_GITHUB_TOKEN +# - GITHUB_TOKEN +# +# Custom actions used: +# - actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2 +# - actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1 +# - actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9 +# - actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 +# - actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0 +# - actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1 +# - github/gh-aw-actions/setup@b8068426813005612b960b5ab0b8bd2c27142323 # v0.71.5 +# +# Container images used: +# - ghcr.io/github/gh-aw-firewall/agent:0.25.40@sha256:14ff567e8d9d4c2fbc5e55c973488381c71d7e0fdbe72d30ee7b8a738fd86504 +# - ghcr.io/github/gh-aw-firewall/api-proxy:0.25.40@sha256:2883ca3e5ae9f330cafdd9345bfd4ae17fc8da36c96d4c9a1f76e922b4c45280 +# - ghcr.io/github/gh-aw-firewall/squid:0.25.40@sha256:b084f4a2c771f584ee68084ced52fa6b3245197a1889645d817462d307d3ac51 +# - ghcr.io/github/gh-aw-mcpg:v0.3.6@sha256:2bb8eef86006a4c5963c55616a9c51c32f27bfdecb023b8aa6f91f6718d9171c +# - ghcr.io/github/github-mcp-server:v1.0.3@sha256:2ac27ef03461ef2b877031b838a7d1fd7f12b12d4ace7796d8cad91446d55959 +# - node:lts-alpine@sha256:d1b3b4da11eefd5941e7f0b9cf17783fc99d9c6fc34884a665f40a06dbdfc94f + +name: "Translate Docs to Japanese" +"on": + push: + branches: + - master + paths: + - docs/**/*.md + - docs/**/*.mdx + - versioned_docs/**/*.md + - versioned_docs/**/*.mdx + workflow_dispatch: + inputs: + aw_context: + default: "" + description: Agent caller context (used internally by Agentic Workflows). + required: false + type: string + full_resync: + default: false + description: Re-translate every source file, ignoring diff. Use sparingly. + type: boolean + +permissions: {} + +concurrency: + cancel-in-progress: true + group: i18n-ja-${{ github.ref }} + +run-name: "Translate Docs to Japanese" + +jobs: + activation: + needs: pre_activation + if: needs.pre_activation.outputs.activated == 'true' + runs-on: ubuntu-slim + permissions: + actions: read + contents: read + outputs: + comment_id: "" + comment_repo: "" + engine_id: ${{ steps.generate_aw_info.outputs.engine_id }} + lockdown_check_failed: ${{ steps.generate_aw_info.outputs.lockdown_check_failed == 'true' }} + model: ${{ steps.generate_aw_info.outputs.model }} + secret_verification_result: ${{ steps.validate-secret.outputs.verification_result }} + setup-trace-id: ${{ steps.setup.outputs.trace-id }} + stale_lock_file_failed: ${{ steps.check-lock-file.outputs.stale_lock_file_failed == 'true' }} + steps: + - name: Setup Scripts + id: setup + uses: github/gh-aw-actions/setup@b8068426813005612b960b5ab0b8bd2c27142323 # v0.71.5 + with: + destination: ${{ runner.temp }}/gh-aw/actions + job-name: ${{ github.job }} + trace-id: ${{ needs.pre_activation.outputs.setup-trace-id }} + env: + GH_AW_SETUP_WORKFLOW_NAME: "Translate Docs to Japanese" + GH_AW_CURRENT_WORKFLOW_REF: ${{ github.repository }}/.github/workflows/translate-docs-ja.lock.yml@${{ github.ref }} + GH_AW_INFO_VERSION: "1.0.40" + - name: Generate agentic run info + id: generate_aw_info + env: + GH_AW_INFO_ENGINE_ID: "copilot" + GH_AW_INFO_ENGINE_NAME: "GitHub Copilot CLI" + GH_AW_INFO_MODEL: ${{ vars.GH_AW_MODEL_AGENT_COPILOT || 'claude-sonnet-4.6' }} + GH_AW_INFO_VERSION: "1.0.40" + GH_AW_INFO_AGENT_VERSION: "1.0.40" + GH_AW_INFO_CLI_VERSION: "v0.71.5" + GH_AW_INFO_WORKFLOW_NAME: "Translate Docs to Japanese" + GH_AW_INFO_EXPERIMENTAL: "false" + GH_AW_INFO_SUPPORTS_TOOLS_ALLOWLIST: "true" + GH_AW_INFO_STAGED: "false" + GH_AW_INFO_ALLOWED_DOMAINS: '["threat-detection","github"]' + GH_AW_INFO_FIREWALL_ENABLED: "true" + GH_AW_INFO_AWF_VERSION: "v0.25.40" + GH_AW_INFO_AWMG_VERSION: "" + GH_AW_INFO_FIREWALL_TYPE: "squid" + GH_AW_COMPILED_STRICT: "true" + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + with: + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/generate_aw_info.cjs'); + await main(core, context); + - name: Validate COPILOT_GITHUB_TOKEN secret + id: validate-secret + run: bash "${RUNNER_TEMP}/gh-aw/actions/validate_multi_secret.sh" COPILOT_GITHUB_TOKEN 'GitHub Copilot CLI' https://github.github.com/gh-aw/reference/engines/#github-copilot-default + env: + COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }} + - name: Checkout .github and .agents folders + uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2 + with: + persist-credentials: false + sparse-checkout: | + .github + .agents + .claude + .codex + .crush + .gemini + .opencode + .pi + sparse-checkout-cone-mode: true + fetch-depth: 1 + - name: Save agent config folders for base branch restoration + env: + GH_AW_AGENT_FOLDERS: ".agents .claude .codex .crush .gemini .github .opencode .pi" + GH_AW_AGENT_FILES: ".crush.json AGENTS.md CLAUDE.md GEMINI.md PI.md opencode.jsonc" + # poutine:ignore untrusted_checkout_exec + run: bash "${RUNNER_TEMP}/gh-aw/actions/save_base_github_folders.sh" + - name: Check workflow lock file + id: check-lock-file + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + env: + GH_AW_WORKFLOW_FILE: "translate-docs-ja.lock.yml" + GH_AW_CONTEXT_WORKFLOW_REF: "${{ github.workflow_ref }}" + with: + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/check_workflow_timestamp_api.cjs'); + await main(); + - name: Check compile-agentic version + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + env: + GH_AW_COMPILED_VERSION: "v0.71.5" + with: + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/check_version_updates.cjs'); + await main(); + - name: Create prompt with built-in context + env: + GH_AW_PROMPT: /tmp/gh-aw/aw-prompts/prompt.txt + GH_AW_SAFE_OUTPUTS: ${{ runner.temp }}/gh-aw/safeoutputs/outputs.jsonl + GH_AW_GITHUB_ACTOR: ${{ github.actor }} + GH_AW_GITHUB_EVENT_AFTER: ${{ github.event.after }} + GH_AW_GITHUB_EVENT_BEFORE: ${{ github.event.before }} + GH_AW_GITHUB_EVENT_COMMENT_ID: ${{ github.event.comment.id }} + GH_AW_GITHUB_EVENT_DISCUSSION_NUMBER: ${{ github.event.discussion.number }} + GH_AW_GITHUB_EVENT_ISSUE_NUMBER: ${{ github.event.issue.number }} + GH_AW_GITHUB_EVENT_PULL_REQUEST_NUMBER: ${{ github.event.pull_request.number }} + GH_AW_GITHUB_REPOSITORY: ${{ github.repository }} + GH_AW_GITHUB_RUN_ID: ${{ github.run_id }} + GH_AW_GITHUB_WORKSPACE: ${{ github.workspace }} + # poutine:ignore untrusted_checkout_exec + run: | + bash "${RUNNER_TEMP}/gh-aw/actions/create_prompt_first.sh" + { + cat << 'GH_AW_PROMPT_12a84ca7cb4e4256_EOF' + + GH_AW_PROMPT_12a84ca7cb4e4256_EOF + cat "${RUNNER_TEMP}/gh-aw/prompts/xpia.md" + cat "${RUNNER_TEMP}/gh-aw/prompts/temp_folder_prompt.md" + cat "${RUNNER_TEMP}/gh-aw/prompts/markdown.md" + cat "${RUNNER_TEMP}/gh-aw/prompts/safe_outputs_prompt.md" + cat << 'GH_AW_PROMPT_12a84ca7cb4e4256_EOF' + + Tools: create_pull_request, missing_tool, missing_data, noop + GH_AW_PROMPT_12a84ca7cb4e4256_EOF + cat "${RUNNER_TEMP}/gh-aw/prompts/safe_outputs_create_pull_request.md" + cat << 'GH_AW_PROMPT_12a84ca7cb4e4256_EOF' + + GH_AW_PROMPT_12a84ca7cb4e4256_EOF + cat "${RUNNER_TEMP}/gh-aw/prompts/mcp_cli_tools_prompt.md" + cat << 'GH_AW_PROMPT_12a84ca7cb4e4256_EOF' + + The following GitHub context information is available for this workflow: + {{#if __GH_AW_GITHUB_ACTOR__ }} + - **actor**: __GH_AW_GITHUB_ACTOR__ + {{/if}} + {{#if __GH_AW_GITHUB_REPOSITORY__ }} + - **repository**: __GH_AW_GITHUB_REPOSITORY__ + {{/if}} + {{#if __GH_AW_GITHUB_WORKSPACE__ }} + - **workspace**: __GH_AW_GITHUB_WORKSPACE__ + {{/if}} + {{#if __GH_AW_GITHUB_EVENT_ISSUE_NUMBER__ }} + - **issue-number**: #__GH_AW_GITHUB_EVENT_ISSUE_NUMBER__ + {{/if}} + {{#if __GH_AW_GITHUB_EVENT_DISCUSSION_NUMBER__ }} + - **discussion-number**: #__GH_AW_GITHUB_EVENT_DISCUSSION_NUMBER__ + {{/if}} + {{#if __GH_AW_GITHUB_EVENT_PULL_REQUEST_NUMBER__ }} + - **pull-request-number**: #__GH_AW_GITHUB_EVENT_PULL_REQUEST_NUMBER__ + {{/if}} + {{#if __GH_AW_GITHUB_EVENT_COMMENT_ID__ }} + - **comment-id**: __GH_AW_GITHUB_EVENT_COMMENT_ID__ + {{/if}} + {{#if __GH_AW_GITHUB_RUN_ID__ }} + - **workflow-run-id**: __GH_AW_GITHUB_RUN_ID__ + {{/if}} + + + GH_AW_PROMPT_12a84ca7cb4e4256_EOF + cat "${RUNNER_TEMP}/gh-aw/prompts/github_mcp_tools_with_safeoutputs_prompt.md" + cat << 'GH_AW_PROMPT_12a84ca7cb4e4256_EOF' + + {{#runtime-import .github/workflows/translate-docs-ja.md}} + GH_AW_PROMPT_12a84ca7cb4e4256_EOF + } > "$GH_AW_PROMPT" + - name: Interpolate variables and render templates + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + env: + GH_AW_PROMPT: /tmp/gh-aw/aw-prompts/prompt.txt + GH_AW_ENGINE_ID: "copilot" + GH_AW_GITHUB_EVENT_AFTER: ${{ github.event.after }} + GH_AW_GITHUB_EVENT_BEFORE: ${{ github.event.before }} + with: + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/interpolate_prompt.cjs'); + await main(); + - name: Substitute placeholders + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + env: + GH_AW_PROMPT: /tmp/gh-aw/aw-prompts/prompt.txt + GH_AW_GITHUB_ACTOR: ${{ github.actor }} + GH_AW_GITHUB_EVENT_AFTER: ${{ github.event.after }} + GH_AW_GITHUB_EVENT_BEFORE: ${{ github.event.before }} + GH_AW_GITHUB_EVENT_COMMENT_ID: ${{ github.event.comment.id }} + GH_AW_GITHUB_EVENT_DISCUSSION_NUMBER: ${{ github.event.discussion.number }} + GH_AW_GITHUB_EVENT_ISSUE_NUMBER: ${{ github.event.issue.number }} + GH_AW_GITHUB_EVENT_PULL_REQUEST_NUMBER: ${{ github.event.pull_request.number }} + GH_AW_GITHUB_REPOSITORY: ${{ github.repository }} + GH_AW_GITHUB_RUN_ID: ${{ github.run_id }} + GH_AW_GITHUB_WORKSPACE: ${{ github.workspace }} + GH_AW_MCP_CLI_SERVERS_LIST: '- `safeoutputs` — run `safeoutputs --help` to see available tools' + GH_AW_NEEDS_PRE_ACTIVATION_OUTPUTS_ACTIVATED: ${{ needs.pre_activation.outputs.activated }} + with: + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + + const substitutePlaceholders = require('${{ runner.temp }}/gh-aw/actions/substitute_placeholders.cjs'); + + // Call the substitution function + return await substitutePlaceholders({ + file: process.env.GH_AW_PROMPT, + substitutions: { + GH_AW_GITHUB_ACTOR: process.env.GH_AW_GITHUB_ACTOR, + GH_AW_GITHUB_EVENT_AFTER: process.env.GH_AW_GITHUB_EVENT_AFTER, + GH_AW_GITHUB_EVENT_BEFORE: process.env.GH_AW_GITHUB_EVENT_BEFORE, + GH_AW_GITHUB_EVENT_COMMENT_ID: process.env.GH_AW_GITHUB_EVENT_COMMENT_ID, + GH_AW_GITHUB_EVENT_DISCUSSION_NUMBER: process.env.GH_AW_GITHUB_EVENT_DISCUSSION_NUMBER, + GH_AW_GITHUB_EVENT_ISSUE_NUMBER: process.env.GH_AW_GITHUB_EVENT_ISSUE_NUMBER, + GH_AW_GITHUB_EVENT_PULL_REQUEST_NUMBER: process.env.GH_AW_GITHUB_EVENT_PULL_REQUEST_NUMBER, + GH_AW_GITHUB_REPOSITORY: process.env.GH_AW_GITHUB_REPOSITORY, + GH_AW_GITHUB_RUN_ID: process.env.GH_AW_GITHUB_RUN_ID, + GH_AW_GITHUB_WORKSPACE: process.env.GH_AW_GITHUB_WORKSPACE, + GH_AW_MCP_CLI_SERVERS_LIST: process.env.GH_AW_MCP_CLI_SERVERS_LIST, + GH_AW_NEEDS_PRE_ACTIVATION_OUTPUTS_ACTIVATED: process.env.GH_AW_NEEDS_PRE_ACTIVATION_OUTPUTS_ACTIVATED + } + }); + - name: Validate prompt placeholders + env: + GH_AW_PROMPT: /tmp/gh-aw/aw-prompts/prompt.txt + # poutine:ignore untrusted_checkout_exec + run: bash "${RUNNER_TEMP}/gh-aw/actions/validate_prompt_placeholders.sh" + - name: Print prompt + env: + GH_AW_PROMPT: /tmp/gh-aw/aw-prompts/prompt.txt + # poutine:ignore untrusted_checkout_exec + run: bash "${RUNNER_TEMP}/gh-aw/actions/print_prompt_summary.sh" + - name: Upload activation artifact + if: success() + uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1 + with: + name: activation + include-hidden-files: true + path: | + /tmp/gh-aw/aw_info.json + /tmp/gh-aw/aw-prompts/prompt.txt + /tmp/gh-aw/github_rate_limits.jsonl + /tmp/gh-aw/base + if-no-files-found: ignore + retention-days: 1 + + agent: + needs: activation + runs-on: ubuntu-latest + permissions: + contents: read + env: + DEFAULT_BRANCH: ${{ github.event.repository.default_branch }} + GH_AW_ASSETS_ALLOWED_EXTS: "" + GH_AW_ASSETS_BRANCH: "" + GH_AW_ASSETS_MAX_SIZE_KB: 0 + GH_AW_MCP_LOG_DIR: /tmp/gh-aw/mcp-logs/safeoutputs + GH_AW_WORKFLOW_ID_SANITIZED: translatedocsja + outputs: + agentic_engine_timeout: ${{ steps.detect-copilot-errors.outputs.agentic_engine_timeout || 'false' }} + checkout_pr_success: ${{ steps.checkout-pr.outputs.checkout_pr_success || 'true' }} + effective_tokens: ${{ steps.parse-mcp-gateway.outputs.effective_tokens }} + has_patch: ${{ steps.collect_output.outputs.has_patch }} + inference_access_error: ${{ steps.detect-copilot-errors.outputs.inference_access_error || 'false' }} + mcp_policy_error: ${{ steps.detect-copilot-errors.outputs.mcp_policy_error || 'false' }} + model: ${{ needs.activation.outputs.model }} + model_not_supported_error: ${{ steps.detect-copilot-errors.outputs.model_not_supported_error || 'false' }} + output: ${{ steps.collect_output.outputs.output }} + output_types: ${{ steps.collect_output.outputs.output_types }} + setup-trace-id: ${{ steps.setup.outputs.trace-id }} + steps: + - name: Setup Scripts + id: setup + uses: github/gh-aw-actions/setup@b8068426813005612b960b5ab0b8bd2c27142323 # v0.71.5 + with: + destination: ${{ runner.temp }}/gh-aw/actions + job-name: ${{ github.job }} + trace-id: ${{ needs.activation.outputs.setup-trace-id }} + env: + GH_AW_SETUP_WORKFLOW_NAME: "Translate Docs to Japanese" + GH_AW_CURRENT_WORKFLOW_REF: ${{ github.repository }}/.github/workflows/translate-docs-ja.lock.yml@${{ github.ref }} + GH_AW_INFO_VERSION: "1.0.40" + - name: Set runtime paths + id: set-runtime-paths + run: | + { + echo "GH_AW_SAFE_OUTPUTS=${RUNNER_TEMP}/gh-aw/safeoutputs/outputs.jsonl" + echo "GH_AW_SAFE_OUTPUTS_CONFIG_PATH=${RUNNER_TEMP}/gh-aw/safeoutputs/config.json" + echo "GH_AW_SAFE_OUTPUTS_TOOLS_PATH=${RUNNER_TEMP}/gh-aw/safeoutputs/tools.json" + } >> "$GITHUB_OUTPUT" + - name: Checkout repository + uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2 + with: + persist-credentials: false + - name: Create gh-aw temp directory + run: bash "${RUNNER_TEMP}/gh-aw/actions/create_gh_aw_tmp_dir.sh" + - name: Configure gh CLI for GitHub Enterprise + run: bash "${RUNNER_TEMP}/gh-aw/actions/configure_gh_for_ghe.sh" + env: + GH_TOKEN: ${{ github.token }} + - name: Configure Git credentials + env: + REPO_NAME: ${{ github.repository }} + SERVER_URL: ${{ github.server_url }} + GITHUB_TOKEN: ${{ github.token }} + run: | + git config --global user.email "github-actions[bot]@users.noreply.github.com" + git config --global user.name "github-actions[bot]" + git config --global am.keepcr true + # Re-authenticate git with GitHub token + SERVER_URL_STRIPPED="${SERVER_URL#https://}" + git remote set-url origin "https://x-access-token:${GITHUB_TOKEN}@${SERVER_URL_STRIPPED}/${REPO_NAME}.git" + echo "Git configured with standard GitHub Actions identity" + - name: Checkout PR branch + id: checkout-pr + if: | + github.event.pull_request || github.event.issue.pull_request + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + env: + GH_TOKEN: ${{ secrets.GH_AW_GITHUB_MCP_SERVER_TOKEN || secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} + with: + github-token: ${{ secrets.GH_AW_GITHUB_MCP_SERVER_TOKEN || secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/checkout_pr_branch.cjs'); + await main(); + - name: Install GitHub Copilot CLI + run: bash "${RUNNER_TEMP}/gh-aw/actions/install_copilot_cli.sh" 1.0.40 + env: + GH_HOST: github.com + - name: Install AWF binary + run: bash "${RUNNER_TEMP}/gh-aw/actions/install_awf_binary.sh" v0.25.40 + - name: Determine automatic lockdown mode for GitHub MCP Server + id: determine-automatic-lockdown + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9 + env: + GH_AW_GITHUB_TOKEN: ${{ secrets.GH_AW_GITHUB_TOKEN }} + GH_AW_GITHUB_MCP_SERVER_TOKEN: ${{ secrets.GH_AW_GITHUB_MCP_SERVER_TOKEN }} + with: + script: | + const determineAutomaticLockdown = require('${{ runner.temp }}/gh-aw/actions/determine_automatic_lockdown.cjs'); + await determineAutomaticLockdown(github, context, core); + - name: Download activation artifact + uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1 + with: + name: activation + path: /tmp/gh-aw + - name: Restore agent config folders from base branch + if: steps.checkout-pr.outcome == 'success' + env: + GH_AW_AGENT_FOLDERS: ".agents .claude .codex .crush .gemini .github .opencode .pi" + GH_AW_AGENT_FILES: ".crush.json AGENTS.md CLAUDE.md GEMINI.md PI.md opencode.jsonc" + run: bash "${RUNNER_TEMP}/gh-aw/actions/restore_base_github_folders.sh" + - name: Download container images + run: bash "${RUNNER_TEMP}/gh-aw/actions/download_docker_images.sh" ghcr.io/github/gh-aw-firewall/agent:0.25.40@sha256:14ff567e8d9d4c2fbc5e55c973488381c71d7e0fdbe72d30ee7b8a738fd86504 ghcr.io/github/gh-aw-firewall/api-proxy:0.25.40@sha256:2883ca3e5ae9f330cafdd9345bfd4ae17fc8da36c96d4c9a1f76e922b4c45280 ghcr.io/github/gh-aw-firewall/squid:0.25.40@sha256:b084f4a2c771f584ee68084ced52fa6b3245197a1889645d817462d307d3ac51 ghcr.io/github/gh-aw-mcpg:v0.3.6@sha256:2bb8eef86006a4c5963c55616a9c51c32f27bfdecb023b8aa6f91f6718d9171c ghcr.io/github/github-mcp-server:v1.0.3@sha256:2ac27ef03461ef2b877031b838a7d1fd7f12b12d4ace7796d8cad91446d55959 node:lts-alpine@sha256:d1b3b4da11eefd5941e7f0b9cf17783fc99d9c6fc34884a665f40a06dbdfc94f + - name: Generate Safe Outputs Config + run: | + mkdir -p "${RUNNER_TEMP}/gh-aw/safeoutputs" + mkdir -p /tmp/gh-aw/safeoutputs + mkdir -p /tmp/gh-aw/mcp-logs/safeoutputs + cat > "${RUNNER_TEMP}/gh-aw/safeoutputs/config.json" << 'GH_AW_SAFE_OUTPUTS_CONFIG_dcc19a425831fd08_EOF' + {"create_pull_request":{"draft":false,"labels":["i18n","ja","automated"],"max":1,"max_patch_files":100,"max_patch_size":1024,"protect_top_level_dot_folders":true,"protected_files":["package.json","bun.lockb","bunfig.toml","deno.json","deno.jsonc","deno.lock","global.json","NuGet.Config","Directory.Packages.props","mix.exs","mix.lock","go.mod","go.sum","stack.yaml","stack.yaml.lock","pom.xml","build.gradle","build.gradle.kts","settings.gradle","settings.gradle.kts","gradle.properties","package-lock.json","yarn.lock","pnpm-lock.yaml","npm-shrinkwrap.json","requirements.txt","Pipfile","Pipfile.lock","pyproject.toml","setup.py","setup.cfg","Gemfile","Gemfile.lock","uv.lock","CODEOWNERS","DESIGN.md","README.md","CONTRIBUTING.md","CHANGELOG.md","SECURITY.md","CODE_OF_CONDUCT.md","AGENTS.md","CLAUDE.md","GEMINI.md"],"title_prefix":"[i18n-ja] "},"create_report_incomplete_issue":{},"missing_data":{},"missing_tool":{},"noop":{"max":1,"report-as-issue":"true"},"report_incomplete":{}} + GH_AW_SAFE_OUTPUTS_CONFIG_dcc19a425831fd08_EOF + - name: Generate Safe Outputs Tools + env: + GH_AW_TOOLS_META_JSON: | + { + "description_suffixes": { + "create_pull_request": " CONSTRAINTS: Maximum 1 pull request(s) can be created. Title will be prefixed with \"[i18n-ja] \". Labels [\"i18n\" \"ja\" \"automated\"] will be automatically added." + }, + "repo_params": {}, + "dynamic_tools": [] + } + GH_AW_VALIDATION_JSON: | + { + "create_pull_request": { + "defaultMax": 1, + "fields": { + "base": { + "type": "string", + "sanitize": true, + "maxLength": 128 + }, + "body": { + "required": true, + "type": "string", + "sanitize": true, + "maxLength": 65000 + }, + "branch": { + "required": true, + "type": "string", + "sanitize": true, + "maxLength": 256 + }, + "draft": { + "type": "boolean" + }, + "labels": { + "type": "array", + "itemType": "string", + "itemSanitize": true, + "itemMaxLength": 128 + }, + "repo": { + "type": "string", + "maxLength": 256 + }, + "title": { + "required": true, + "type": "string", + "sanitize": true, + "maxLength": 128 + } + } + }, + "missing_data": { + "defaultMax": 20, + "fields": { + "alternatives": { + "type": "string", + "sanitize": true, + "maxLength": 256 + }, + "context": { + "type": "string", + "sanitize": true, + "maxLength": 256 + }, + "data_type": { + "type": "string", + "sanitize": true, + "maxLength": 128 + }, + "reason": { + "type": "string", + "sanitize": true, + "maxLength": 256 + } + } + }, + "missing_tool": { + "defaultMax": 20, + "fields": { + "alternatives": { + "type": "string", + "sanitize": true, + "maxLength": 512 + }, + "reason": { + "required": true, + "type": "string", + "sanitize": true, + "maxLength": 256 + }, + "tool": { + "type": "string", + "sanitize": true, + "maxLength": 128 + } + } + }, + "noop": { + "defaultMax": 1, + "fields": { + "message": { + "required": true, + "type": "string", + "sanitize": true, + "maxLength": 65000 + } + } + }, + "report_incomplete": { + "defaultMax": 5, + "fields": { + "details": { + "type": "string", + "sanitize": true, + "maxLength": 65000 + }, + "reason": { + "required": true, + "type": "string", + "sanitize": true, + "maxLength": 1024 + } + } + } + } + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + with: + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/generate_safe_outputs_tools.cjs'); + await main(); + - name: Generate Safe Outputs MCP Server Config + id: safe-outputs-config + run: | + # Generate a secure random API key (360 bits of entropy, 40+ chars) + # Mask immediately to prevent timing vulnerabilities + API_KEY=$(openssl rand -base64 45 | tr -d '/+=') + echo "::add-mask::${API_KEY}" + + PORT=3001 + + # Set outputs for next steps + { + echo "safe_outputs_api_key=${API_KEY}" + echo "safe_outputs_port=${PORT}" + } >> "$GITHUB_OUTPUT" + + echo "Safe Outputs MCP server will run on port ${PORT}" + + - name: Start Safe Outputs MCP HTTP Server + id: safe-outputs-start + env: + DEBUG: '*' + GH_AW_SAFE_OUTPUTS: ${{ steps.set-runtime-paths.outputs.GH_AW_SAFE_OUTPUTS }} + GH_AW_SAFE_OUTPUTS_PORT: ${{ steps.safe-outputs-config.outputs.safe_outputs_port }} + GH_AW_SAFE_OUTPUTS_API_KEY: ${{ steps.safe-outputs-config.outputs.safe_outputs_api_key }} + GH_AW_SAFE_OUTPUTS_TOOLS_PATH: ${{ runner.temp }}/gh-aw/safeoutputs/tools.json + GH_AW_SAFE_OUTPUTS_CONFIG_PATH: ${{ runner.temp }}/gh-aw/safeoutputs/config.json + GH_AW_MCP_LOG_DIR: /tmp/gh-aw/mcp-logs/safeoutputs + run: | + # Environment variables are set above to prevent template injection + export DEBUG + export GH_AW_SAFE_OUTPUTS + export GH_AW_SAFE_OUTPUTS_PORT + export GH_AW_SAFE_OUTPUTS_API_KEY + export GH_AW_SAFE_OUTPUTS_TOOLS_PATH + export GH_AW_SAFE_OUTPUTS_CONFIG_PATH + export GH_AW_MCP_LOG_DIR + + bash "${RUNNER_TEMP}/gh-aw/actions/start_safe_outputs_server.sh" + + - name: Start MCP Gateway + id: start-mcp-gateway + env: + GH_AW_SAFE_OUTPUTS: ${{ steps.set-runtime-paths.outputs.GH_AW_SAFE_OUTPUTS }} + GH_AW_SAFE_OUTPUTS_API_KEY: ${{ steps.safe-outputs-start.outputs.api_key }} + GH_AW_SAFE_OUTPUTS_PORT: ${{ steps.safe-outputs-start.outputs.port }} + GITHUB_MCP_GUARD_MIN_INTEGRITY: ${{ steps.determine-automatic-lockdown.outputs.min_integrity }} + GITHUB_MCP_GUARD_REPOS: ${{ steps.determine-automatic-lockdown.outputs.repos }} + GITHUB_MCP_SERVER_TOKEN: ${{ secrets.GH_AW_GITHUB_MCP_SERVER_TOKEN || secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} + run: | + set -eo pipefail + mkdir -p "${RUNNER_TEMP}/gh-aw/mcp-config" + + # Export gateway environment variables for MCP config and gateway script + export MCP_GATEWAY_PORT="8080" + export MCP_GATEWAY_DOMAIN="host.docker.internal" + export MCP_GATEWAY_HOST_DOMAIN="localhost" + MCP_GATEWAY_API_KEY=$(openssl rand -base64 45 | tr -d '/+=') + echo "::add-mask::${MCP_GATEWAY_API_KEY}" + export MCP_GATEWAY_API_KEY + export MCP_GATEWAY_PAYLOAD_DIR="/tmp/gh-aw/mcp-payloads" + mkdir -p "${MCP_GATEWAY_PAYLOAD_DIR}" + export MCP_GATEWAY_PAYLOAD_SIZE_THRESHOLD="524288" + export DEBUG="*" + + export GH_AW_ENGINE="copilot" + MCP_GATEWAY_UID=$(id -u 2>/dev/null || echo '0') + MCP_GATEWAY_GID=$(id -g 2>/dev/null || echo '0') + DOCKER_SOCK_GID=$(stat -c '%g' /var/run/docker.sock 2>/dev/null || echo '0') + export MCP_GATEWAY_DOCKER_COMMAND='docker run -i --rm --network host --add-host host.docker.internal:127.0.0.1 --user '"${MCP_GATEWAY_UID}"':'"${MCP_GATEWAY_GID}"' --group-add '"${DOCKER_SOCK_GID}"' -v /var/run/docker.sock:/var/run/docker.sock -e MCP_GATEWAY_PORT -e MCP_GATEWAY_DOMAIN -e MCP_GATEWAY_API_KEY -e MCP_GATEWAY_PAYLOAD_DIR -e MCP_GATEWAY_PAYLOAD_SIZE_THRESHOLD -e DEBUG -e MCP_GATEWAY_LOG_DIR -e GH_AW_MCP_LOG_DIR -e GH_AW_SAFE_OUTPUTS -e GH_AW_SAFE_OUTPUTS_CONFIG_PATH -e GH_AW_SAFE_OUTPUTS_TOOLS_PATH -e GH_AW_ASSETS_BRANCH -e GH_AW_ASSETS_MAX_SIZE_KB -e GH_AW_ASSETS_ALLOWED_EXTS -e DEFAULT_BRANCH -e GITHUB_MCP_SERVER_TOKEN -e GITHUB_MCP_GUARD_MIN_INTEGRITY -e GITHUB_MCP_GUARD_REPOS -e GITHUB_REPOSITORY -e GITHUB_SERVER_URL -e GITHUB_SHA -e GITHUB_WORKSPACE -e GITHUB_TOKEN -e GITHUB_RUN_ID -e GITHUB_RUN_NUMBER -e GITHUB_RUN_ATTEMPT -e GITHUB_JOB -e GITHUB_ACTION -e GITHUB_EVENT_NAME -e GITHUB_EVENT_PATH -e GITHUB_ACTOR -e GITHUB_ACTOR_ID -e GITHUB_TRIGGERING_ACTOR -e GITHUB_WORKFLOW -e GITHUB_WORKFLOW_REF -e GITHUB_WORKFLOW_SHA -e GITHUB_REF -e GITHUB_REF_NAME -e GITHUB_REF_TYPE -e GITHUB_HEAD_REF -e GITHUB_BASE_REF -e GH_AW_SAFE_OUTPUTS_PORT -e GH_AW_SAFE_OUTPUTS_API_KEY -v /tmp/gh-aw/mcp-payloads:/tmp/gh-aw/mcp-payloads:rw -v /opt:/opt:ro -v /tmp:/tmp:rw -v '"${GITHUB_WORKSPACE}"':'"${GITHUB_WORKSPACE}"':rw ghcr.io/github/gh-aw-mcpg:v0.3.6' + + mkdir -p /home/runner/.copilot + GH_AW_NODE=$(which node 2>/dev/null || command -v node 2>/dev/null || echo node) + cat << GH_AW_MCP_CONFIG_6dcd57344ed7f845_EOF | "$GH_AW_NODE" "${RUNNER_TEMP}/gh-aw/actions/start_mcp_gateway.cjs" + { + "mcpServers": { + "github": { + "type": "stdio", + "container": "ghcr.io/github/github-mcp-server:v1.0.3", + "env": { + "GITHUB_HOST": "\${GITHUB_SERVER_URL}", + "GITHUB_PERSONAL_ACCESS_TOKEN": "\${GITHUB_MCP_SERVER_TOKEN}", + "GITHUB_READ_ONLY": "1", + "GITHUB_TOOLSETS": "context,repos,issues,pull_requests" + }, + "guard-policies": { + "allow-only": { + "min-integrity": "$GITHUB_MCP_GUARD_MIN_INTEGRITY", + "repos": "$GITHUB_MCP_GUARD_REPOS" + } + } + }, + "safeoutputs": { + "type": "http", + "url": "http://host.docker.internal:$GH_AW_SAFE_OUTPUTS_PORT", + "headers": { + "Authorization": "\${GH_AW_SAFE_OUTPUTS_API_KEY}" + }, + "guard-policies": { + "write-sink": { + "accept": [ + "*" + ] + } + } + } + }, + "gateway": { + "port": $MCP_GATEWAY_PORT, + "domain": "${MCP_GATEWAY_DOMAIN}", + "apiKey": "${MCP_GATEWAY_API_KEY}", + "payloadDir": "${MCP_GATEWAY_PAYLOAD_DIR}" + } + } + GH_AW_MCP_CONFIG_6dcd57344ed7f845_EOF + - name: Mount MCP servers as CLIs + id: mount-mcp-clis + continue-on-error: true + env: + MCP_GATEWAY_API_KEY: ${{ steps.start-mcp-gateway.outputs.gateway-api-key }} + MCP_GATEWAY_DOMAIN: ${{ steps.start-mcp-gateway.outputs.gateway-domain }} + MCP_GATEWAY_PORT: ${{ steps.start-mcp-gateway.outputs.gateway-port }} + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + with: + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io); + const { main } = require('${{ runner.temp }}/gh-aw/actions/mount_mcp_as_cli.cjs'); + await main(); + - name: Clean credentials + continue-on-error: true + run: bash "${RUNNER_TEMP}/gh-aw/actions/clean_git_credentials.sh" + - name: Audit pre-agent workspace + id: pre_agent_audit + continue-on-error: true + run: bash "${RUNNER_TEMP}/gh-aw/actions/audit_pre_agent_workspace.sh" + - name: Execute GitHub Copilot CLI + id: agentic_execution + # Copilot CLI tool arguments (sorted): + # --allow-tool github + # --allow-tool safeoutputs + # --allow-tool shell(cat) + # --allow-tool shell(date) + # --allow-tool shell(echo) + # --allow-tool shell(git add:*) + # --allow-tool shell(git branch:*) + # --allow-tool shell(git checkout:*) + # --allow-tool shell(git commit:*) + # --allow-tool shell(git diff *) + # --allow-tool shell(git diff-tree *) + # --allow-tool shell(git log *) + # --allow-tool shell(git ls-files *) + # --allow-tool shell(git merge:*) + # --allow-tool shell(git rm:*) + # --allow-tool shell(git show *) + # --allow-tool shell(git status) + # --allow-tool shell(git switch:*) + # --allow-tool shell(grep) + # --allow-tool shell(head) + # --allow-tool shell(ls *) + # --allow-tool shell(ls) + # --allow-tool shell(mkdir *) + # --allow-tool shell(pwd) + # --allow-tool shell(rm *) + # --allow-tool shell(safeoutputs:*) + # --allow-tool shell(sort) + # --allow-tool shell(tail) + # --allow-tool shell(uniq) + # --allow-tool shell(wc *) + # --allow-tool shell(wc) + # --allow-tool shell(yq) + # --allow-tool write + timeout-minutes: 20 + run: | + set -o pipefail + touch /tmp/gh-aw/agent-step-summary.md + GH_AW_NODE_BIN=$(command -v node 2>/dev/null || true) + export GH_AW_NODE_BIN + (umask 177 && touch /tmp/gh-aw/agent-stdio.log) + printf '%s\n' '{"$schema":"https://github.com/github/gh-aw-firewall/releases/download/v0.25.40/awf-config.schema.json","network":{"allowDomains":["*.githubusercontent.com","api.business.githubcopilot.com","api.enterprise.githubcopilot.com","api.github.com","api.githubcopilot.com","api.individual.githubcopilot.com","codeload.github.com","docs.github.com","github-cloud.githubusercontent.com","github-cloud.s3.amazonaws.com","github.blog","github.com","github.githubassets.com","host.docker.internal","lfs.github.com","objects.githubusercontent.com","raw.githubusercontent.com","registry.npmjs.org","telemetry.enterprise.githubcopilot.com"]},"apiProxy":{"enabled":true,"models":{"auto":["large"],"deep-research":["copilot/deep-research*","google/deep-research*"],"gemini-flash":["copilot/gemini-*flash*","google/gemini-*flash*"],"gemini-pro":["copilot/gemini-*pro*","google/gemini-*pro*"],"gpt-4.1":["copilot/gpt-4.1*","openai/gpt-4.1*"],"gpt-5":["copilot/gpt-5*","openai/gpt-5*"],"gpt-5-codex":["copilot/gpt-5*codex*","openai/gpt-5*codex*"],"gpt-5-mini":["copilot/gpt-5*mini*","openai/gpt-5*mini*"],"gpt-5-nano":["copilot/gpt-5*nano*","openai/gpt-5*nano*"],"gpt-5-pro":["copilot/gpt-5*pro*","openai/gpt-5*pro*"],"haiku":["copilot/*haiku*","anthropic/*haiku*"],"large":["sonnet","gpt-5-pro","gpt-5","gemini-pro"],"mini":["haiku","gpt-5-mini","gpt-5-nano","gemini-flash"],"opus":["copilot/*opus*","anthropic/*opus*"],"reasoning":["copilot/o1*","copilot/o3*","copilot/o4*","openai/o1*","openai/o3*","openai/o4*"],"small":["mini"],"sonnet":["copilot/*sonnet*","anthropic/*sonnet*"]}},"container":{"imageTag":"0.25.40,squid=sha256:b084f4a2c771f584ee68084ced52fa6b3245197a1889645d817462d307d3ac51,agent=sha256:14ff567e8d9d4c2fbc5e55c973488381c71d7e0fdbe72d30ee7b8a738fd86504,api-proxy=sha256:2883ca3e5ae9f330cafdd9345bfd4ae17fc8da36c96d4c9a1f76e922b4c45280,cli-proxy=sha256:3e7152911d4b4b7b97beef9d3d7d924ff7902227e86001ef3838fb728d5d514c"}}' > "${RUNNER_TEMP}/gh-aw/awf-config.json" && cp "${RUNNER_TEMP}/gh-aw/awf-config.json" /tmp/gh-aw/awf-config.json + # shellcheck disable=SC1003 + sudo -E awf --config "${RUNNER_TEMP}/gh-aw/awf-config.json" --container-workdir "${GITHUB_WORKSPACE}" --mount "${RUNNER_TEMP}/gh-aw:${RUNNER_TEMP}/gh-aw:ro" --mount "${RUNNER_TEMP}/gh-aw:/host${RUNNER_TEMP}/gh-aw:ro" --env-all --exclude-env COPILOT_GITHUB_TOKEN --exclude-env GITHUB_MCP_SERVER_TOKEN --exclude-env MCP_GATEWAY_API_KEY --log-level info --proxy-logs-dir /tmp/gh-aw/sandbox/firewall/logs --audit-dir /tmp/gh-aw/sandbox/firewall/audit --enable-host-access --allow-host-ports 80,443,8080 --skip-pull \ + -- /bin/bash -c 'export PATH="${RUNNER_TEMP}/gh-aw/mcp-cli/bin:$PATH" && export PATH="$(find /opt/hostedtoolcache /home/runner/work/_tool -maxdepth 4 -type d -name bin 2>/dev/null | tr '\''\n'\'' '\'':'\'')$PATH"; [ -n "$GOROOT" ] && export PATH="$GOROOT/bin:$PATH" || true && GH_AW_NODE_EXEC="${GH_AW_NODE_BIN:-}"; if [ -z "$GH_AW_NODE_EXEC" ] || [ ! -x "$GH_AW_NODE_EXEC" ]; then GH_AW_NODE_EXEC="$(command -v node 2>/dev/null || echo node)"; fi; "$GH_AW_NODE_EXEC" ${RUNNER_TEMP}/gh-aw/actions/copilot_harness.cjs /usr/local/bin/copilot --add-dir /tmp/gh-aw/ --log-level all --log-dir /tmp/gh-aw/sandbox/agent/logs/ --disable-builtin-mcps --no-ask-user --allow-tool github --allow-tool safeoutputs --allow-tool '\''shell(cat)'\'' --allow-tool '\''shell(date)'\'' --allow-tool '\''shell(echo)'\'' --allow-tool '\''shell(git add:*)'\'' --allow-tool '\''shell(git branch:*)'\'' --allow-tool '\''shell(git checkout:*)'\'' --allow-tool '\''shell(git commit:*)'\'' --allow-tool '\''shell(git diff *)'\'' --allow-tool '\''shell(git diff-tree *)'\'' --allow-tool '\''shell(git log *)'\'' --allow-tool '\''shell(git ls-files *)'\'' --allow-tool '\''shell(git merge:*)'\'' --allow-tool '\''shell(git rm:*)'\'' --allow-tool '\''shell(git show *)'\'' --allow-tool '\''shell(git status)'\'' --allow-tool '\''shell(git switch:*)'\'' --allow-tool '\''shell(grep)'\'' --allow-tool '\''shell(head)'\'' --allow-tool '\''shell(ls *)'\'' --allow-tool '\''shell(ls)'\'' --allow-tool '\''shell(mkdir *)'\'' --allow-tool '\''shell(pwd)'\'' --allow-tool '\''shell(rm *)'\'' --allow-tool '\''shell(safeoutputs:*)'\'' --allow-tool '\''shell(sort)'\'' --allow-tool '\''shell(tail)'\'' --allow-tool '\''shell(uniq)'\'' --allow-tool '\''shell(wc *)'\'' --allow-tool '\''shell(wc)'\'' --allow-tool '\''shell(yq)'\'' --allow-tool write --allow-all-paths --add-dir "${GITHUB_WORKSPACE}" --prompt-file /tmp/gh-aw/aw-prompts/prompt.txt' 2>&1 | tee -a /tmp/gh-aw/agent-stdio.log + env: + COPILOT_AGENT_RUNNER_TYPE: STANDALONE + COPILOT_API_KEY: dummy-byok-key-for-offline-mode + COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }} + COPILOT_MODEL: ${{ vars.GH_AW_MODEL_AGENT_COPILOT || 'claude-sonnet-4.6' }} + GH_AW_MCP_CONFIG: /home/runner/.copilot/mcp-config.json + GH_AW_PHASE: agent + GH_AW_PROMPT: /tmp/gh-aw/aw-prompts/prompt.txt + GH_AW_SAFE_OUTPUTS: ${{ steps.set-runtime-paths.outputs.GH_AW_SAFE_OUTPUTS }} + GH_AW_VERSION: v0.71.5 + GITHUB_API_URL: ${{ github.api_url }} + GITHUB_AW: true + GITHUB_COPILOT_INTEGRATION_ID: agentic-workflows + GITHUB_HEAD_REF: ${{ github.head_ref }} + GITHUB_MCP_SERVER_TOKEN: ${{ secrets.GH_AW_GITHUB_MCP_SERVER_TOKEN || secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} + GITHUB_REF_NAME: ${{ github.ref_name }} + GITHUB_SERVER_URL: ${{ github.server_url }} + GITHUB_STEP_SUMMARY: /tmp/gh-aw/agent-step-summary.md + GITHUB_WORKSPACE: ${{ github.workspace }} + GIT_AUTHOR_EMAIL: github-actions[bot]@users.noreply.github.com + GIT_AUTHOR_NAME: github-actions[bot] + GIT_COMMITTER_EMAIL: github-actions[bot]@users.noreply.github.com + GIT_COMMITTER_NAME: github-actions[bot] + XDG_CONFIG_HOME: /home/runner + - name: Detect Copilot errors + id: detect-copilot-errors + if: always() + continue-on-error: true + run: node "${RUNNER_TEMP}/gh-aw/actions/detect_copilot_errors.cjs" + - name: Configure Git credentials + env: + REPO_NAME: ${{ github.repository }} + SERVER_URL: ${{ github.server_url }} + GITHUB_TOKEN: ${{ github.token }} + run: | + git config --global user.email "github-actions[bot]@users.noreply.github.com" + git config --global user.name "github-actions[bot]" + git config --global am.keepcr true + # Re-authenticate git with GitHub token + SERVER_URL_STRIPPED="${SERVER_URL#https://}" + git remote set-url origin "https://x-access-token:${GITHUB_TOKEN}@${SERVER_URL_STRIPPED}/${REPO_NAME}.git" + echo "Git configured with standard GitHub Actions identity" + - name: Copy Copilot session state files to logs + if: always() + continue-on-error: true + run: bash "${RUNNER_TEMP}/gh-aw/actions/copy_copilot_session_state.sh" + - name: Stop MCP Gateway + if: always() + continue-on-error: true + env: + MCP_GATEWAY_PORT: ${{ steps.start-mcp-gateway.outputs.gateway-port }} + MCP_GATEWAY_API_KEY: ${{ steps.start-mcp-gateway.outputs.gateway-api-key }} + GATEWAY_PID: ${{ steps.start-mcp-gateway.outputs.gateway-pid }} + run: | + bash "${RUNNER_TEMP}/gh-aw/actions/stop_mcp_gateway.sh" "$GATEWAY_PID" + - name: Redact secrets in logs + if: always() + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + with: + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/redact_secrets.cjs'); + await main(); + env: + GH_AW_SECRET_NAMES: 'COPILOT_GITHUB_TOKEN,GH_AW_GITHUB_MCP_SERVER_TOKEN,GH_AW_GITHUB_TOKEN,GITHUB_TOKEN' + SECRET_COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }} + SECRET_GH_AW_GITHUB_MCP_SERVER_TOKEN: ${{ secrets.GH_AW_GITHUB_MCP_SERVER_TOKEN }} + SECRET_GH_AW_GITHUB_TOKEN: ${{ secrets.GH_AW_GITHUB_TOKEN }} + SECRET_GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + - name: Append agent step summary + if: always() + run: bash "${RUNNER_TEMP}/gh-aw/actions/append_agent_step_summary.sh" + - name: Copy Safe Outputs + if: always() + env: + GH_AW_SAFE_OUTPUTS: ${{ steps.set-runtime-paths.outputs.GH_AW_SAFE_OUTPUTS }} + run: | + mkdir -p /tmp/gh-aw + cp "$GH_AW_SAFE_OUTPUTS" /tmp/gh-aw/safeoutputs.jsonl 2>/dev/null || true + - name: Ingest agent output + id: collect_output + if: always() + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + env: + GH_AW_SAFE_OUTPUTS: ${{ steps.set-runtime-paths.outputs.GH_AW_SAFE_OUTPUTS }} + GH_AW_ALLOWED_DOMAINS: "*.githubusercontent.com,api.business.githubcopilot.com,api.enterprise.githubcopilot.com,api.github.com,api.githubcopilot.com,api.individual.githubcopilot.com,codeload.github.com,docs.github.com,github-cloud.githubusercontent.com,github-cloud.s3.amazonaws.com,github.blog,github.com,github.githubassets.com,host.docker.internal,lfs.github.com,objects.githubusercontent.com,raw.githubusercontent.com,registry.npmjs.org,telemetry.enterprise.githubcopilot.com" + GITHUB_SERVER_URL: ${{ github.server_url }} + GITHUB_API_URL: ${{ github.api_url }} + with: + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/collect_ndjson_output.cjs'); + await main(); + - name: Parse agent logs for step summary + if: always() + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + env: + GH_AW_AGENT_OUTPUT: /tmp/gh-aw/sandbox/agent/logs/ + with: + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/parse_copilot_log.cjs'); + await main(); + - name: Parse MCP Gateway logs for step summary + if: always() + id: parse-mcp-gateway + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + with: + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/parse_mcp_gateway_log.cjs'); + await main(); + - name: Print firewall logs + if: always() + continue-on-error: true + env: + AWF_LOGS_DIR: /tmp/gh-aw/sandbox/firewall/logs + run: | + # Fix permissions on firewall logs/audit dirs so they can be uploaded as artifacts + # AWF runs with sudo, creating files owned by root + sudo chmod -R a+r /tmp/gh-aw/sandbox/firewall 2>/dev/null || true + # Only run awf logs summary if awf command exists (it may not be installed if workflow failed before install step) + if command -v awf &> /dev/null; then + awf logs summary | tee -a "$GITHUB_STEP_SUMMARY" + else + echo 'AWF binary not installed, skipping firewall log summary' + fi + - name: Parse token usage for step summary + if: always() + continue-on-error: true + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + with: + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/parse_token_usage.cjs'); + await main(); + - name: Print AWF reflect summary + if: always() + continue-on-error: true + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + with: + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/awf_reflect_summary.cjs'); + await main(); + - name: Write agent output placeholder if missing + if: always() + run: | + if [ ! -f /tmp/gh-aw/agent_output.json ]; then + echo '{"items":[]}' > /tmp/gh-aw/agent_output.json + fi + - name: Upload agent artifacts + if: always() + continue-on-error: true + uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1 + with: + name: agent + path: | + /tmp/gh-aw/aw-prompts/prompt.txt + /tmp/gh-aw/sandbox/agent/logs/ + /tmp/gh-aw/redacted-urls.log + /tmp/gh-aw/mcp-logs/ + /tmp/gh-aw/agent_usage.json + /tmp/gh-aw/agent-stdio.log + /tmp/gh-aw/pre-agent-audit.txt + /tmp/gh-aw/agent/ + /tmp/gh-aw/github_rate_limits.jsonl + /tmp/gh-aw/safeoutputs.jsonl + /tmp/gh-aw/agent_output.json + /tmp/gh-aw/aw-*.patch + /tmp/gh-aw/aw-*.bundle + /tmp/gh-aw/awf-config.json + /tmp/gh-aw/sandbox/firewall/logs/ + /tmp/gh-aw/sandbox/firewall/audit/ + /tmp/gh-aw/sandbox/firewall/awf-reflect.json + if-no-files-found: ignore + + conclusion: + needs: + - activation + - agent + - detection + - safe_outputs + if: > + always() && (needs.agent.result != 'skipped' || needs.activation.outputs.lockdown_check_failed == 'true' || + needs.activation.outputs.stale_lock_file_failed == 'true') + runs-on: ubuntu-slim + permissions: + contents: write + issues: write + pull-requests: write + concurrency: + group: "gh-aw-conclusion-translate-docs-ja" + cancel-in-progress: false + outputs: + incomplete_count: ${{ steps.report_incomplete.outputs.incomplete_count }} + noop_message: ${{ steps.noop.outputs.noop_message }} + tools_reported: ${{ steps.missing_tool.outputs.tools_reported }} + total_count: ${{ steps.missing_tool.outputs.total_count }} + steps: + - name: Setup Scripts + id: setup + uses: github/gh-aw-actions/setup@b8068426813005612b960b5ab0b8bd2c27142323 # v0.71.5 + with: + destination: ${{ runner.temp }}/gh-aw/actions + job-name: ${{ github.job }} + trace-id: ${{ needs.activation.outputs.setup-trace-id }} + env: + GH_AW_SETUP_WORKFLOW_NAME: "Translate Docs to Japanese" + GH_AW_CURRENT_WORKFLOW_REF: ${{ github.repository }}/.github/workflows/translate-docs-ja.lock.yml@${{ github.ref }} + GH_AW_INFO_VERSION: "1.0.40" + - name: Download agent output artifact + id: download-agent-output + continue-on-error: true + uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1 + with: + name: agent + path: /tmp/gh-aw/ + - name: Setup agent output environment variable + id: setup-agent-output-env + if: steps.download-agent-output.outcome == 'success' + run: | + mkdir -p /tmp/gh-aw/ + find "/tmp/gh-aw/" -type f -print + echo "GH_AW_AGENT_OUTPUT=/tmp/gh-aw/agent_output.json" >> "$GITHUB_OUTPUT" + - name: Process no-op messages + id: noop + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + env: + GH_AW_AGENT_OUTPUT: ${{ steps.setup-agent-output-env.outputs.GH_AW_AGENT_OUTPUT }} + GH_AW_NOOP_MAX: "1" + GH_AW_WORKFLOW_NAME: "Translate Docs to Japanese" + GH_AW_RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }} + GH_AW_AGENT_CONCLUSION: ${{ needs.agent.result }} + GH_AW_NOOP_REPORT_AS_ISSUE: "true" + with: + github-token: ${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/handle_noop_message.cjs'); + await main(); + - name: Log detection run + id: detection_runs + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + env: + GH_AW_AGENT_OUTPUT: ${{ steps.setup-agent-output-env.outputs.GH_AW_AGENT_OUTPUT }} + GH_AW_WORKFLOW_NAME: "Translate Docs to Japanese" + GH_AW_RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }} + GH_AW_DETECTION_CONCLUSION: ${{ needs.detection.outputs.detection_conclusion }} + GH_AW_DETECTION_REASON: ${{ needs.detection.outputs.detection_reason }} + with: + github-token: ${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/handle_detection_runs.cjs'); + await main(); + - name: Record missing tool + id: missing_tool + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + env: + GH_AW_AGENT_OUTPUT: ${{ steps.setup-agent-output-env.outputs.GH_AW_AGENT_OUTPUT }} + GH_AW_MISSING_TOOL_CREATE_ISSUE: "true" + GH_AW_WORKFLOW_NAME: "Translate Docs to Japanese" + with: + github-token: ${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/missing_tool.cjs'); + await main(); + - name: Record incomplete + id: report_incomplete + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + env: + GH_AW_AGENT_OUTPUT: ${{ steps.setup-agent-output-env.outputs.GH_AW_AGENT_OUTPUT }} + GH_AW_REPORT_INCOMPLETE_CREATE_ISSUE: "true" + GH_AW_WORKFLOW_NAME: "Translate Docs to Japanese" + with: + github-token: ${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/report_incomplete_handler.cjs'); + await main(); + - name: Handle agent failure + id: handle_agent_failure + if: always() + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + env: + GH_AW_AGENT_OUTPUT: ${{ steps.setup-agent-output-env.outputs.GH_AW_AGENT_OUTPUT }} + GH_AW_WORKFLOW_NAME: "Translate Docs to Japanese" + GH_AW_RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }} + GH_AW_AGENT_CONCLUSION: ${{ needs.agent.result }} + GH_AW_WORKFLOW_ID: "translate-docs-ja" + GH_AW_ACTION_FAILURE_ISSUE_EXPIRES_HOURS: "168" + GH_AW_ENGINE_ID: "copilot" + GH_AW_SECRET_VERIFICATION_RESULT: ${{ needs.activation.outputs.secret_verification_result }} + GH_AW_CHECKOUT_PR_SUCCESS: ${{ needs.agent.outputs.checkout_pr_success }} + GH_AW_INFERENCE_ACCESS_ERROR: ${{ needs.agent.outputs.inference_access_error }} + GH_AW_MCP_POLICY_ERROR: ${{ needs.agent.outputs.mcp_policy_error }} + GH_AW_AGENTIC_ENGINE_TIMEOUT: ${{ needs.agent.outputs.agentic_engine_timeout }} + GH_AW_MODEL_NOT_SUPPORTED_ERROR: ${{ needs.agent.outputs.model_not_supported_error }} + GH_AW_ENGINE_API_HOSTS: "api.enterprise.githubcopilot.com,api.githubcopilot.com,api.business.githubcopilot.com,api.individual.githubcopilot.com" + GH_AW_CODE_PUSH_FAILURE_ERRORS: ${{ needs.safe_outputs.outputs.code_push_failure_errors }} + GH_AW_CODE_PUSH_FAILURE_COUNT: ${{ needs.safe_outputs.outputs.code_push_failure_count }} + GH_AW_LOCKDOWN_CHECK_FAILED: ${{ needs.activation.outputs.lockdown_check_failed }} + GH_AW_STALE_LOCK_FILE_FAILED: ${{ needs.activation.outputs.stale_lock_file_failed }} + GH_AW_GROUP_REPORTS: "false" + GH_AW_FAILURE_REPORT_AS_ISSUE: "true" + GH_AW_MISSING_TOOL_REPORT_AS_FAILURE: "true" + GH_AW_MISSING_DATA_REPORT_AS_FAILURE: "true" + GH_AW_TIMEOUT_MINUTES: "20" + with: + github-token: ${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/handle_agent_failure.cjs'); + await main(); + + detection: + needs: + - activation + - agent + if: > + always() && needs.agent.result != 'skipped' && (needs.agent.outputs.output_types != '' || needs.agent.outputs.has_patch == 'true') + runs-on: ubuntu-latest + permissions: + contents: read + outputs: + detection_conclusion: ${{ steps.detection_conclusion.outputs.conclusion }} + detection_reason: ${{ steps.detection_conclusion.outputs.reason }} + detection_success: ${{ steps.detection_conclusion.outputs.success }} + steps: + - name: Setup Scripts + id: setup + uses: github/gh-aw-actions/setup@b8068426813005612b960b5ab0b8bd2c27142323 # v0.71.5 + with: + destination: ${{ runner.temp }}/gh-aw/actions + job-name: ${{ github.job }} + trace-id: ${{ needs.activation.outputs.setup-trace-id }} + env: + GH_AW_SETUP_WORKFLOW_NAME: "Translate Docs to Japanese" + GH_AW_CURRENT_WORKFLOW_REF: ${{ github.repository }}/.github/workflows/translate-docs-ja.lock.yml@${{ github.ref }} + GH_AW_INFO_VERSION: "1.0.40" + - name: Download agent output artifact + id: download-agent-output + continue-on-error: true + uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1 + with: + name: agent + path: /tmp/gh-aw/ + - name: Setup agent output environment variable + id: setup-agent-output-env + if: steps.download-agent-output.outcome == 'success' + run: | + mkdir -p /tmp/gh-aw/ + find "/tmp/gh-aw/" -type f -print + echo "GH_AW_AGENT_OUTPUT=/tmp/gh-aw/agent_output.json" >> "$GITHUB_OUTPUT" + - name: Checkout repository for patch context + if: needs.agent.outputs.has_patch == 'true' + uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2 + with: + persist-credentials: false + # --- Threat Detection --- + - name: Clean stale firewall files from agent artifact + run: | + rm -rf /tmp/gh-aw/sandbox/firewall/logs + rm -rf /tmp/gh-aw/sandbox/firewall/audit + - name: Download container images + run: bash "${RUNNER_TEMP}/gh-aw/actions/download_docker_images.sh" ghcr.io/github/gh-aw-firewall/agent:0.25.40@sha256:14ff567e8d9d4c2fbc5e55c973488381c71d7e0fdbe72d30ee7b8a738fd86504 ghcr.io/github/gh-aw-firewall/api-proxy:0.25.40@sha256:2883ca3e5ae9f330cafdd9345bfd4ae17fc8da36c96d4c9a1f76e922b4c45280 ghcr.io/github/gh-aw-firewall/squid:0.25.40@sha256:b084f4a2c771f584ee68084ced52fa6b3245197a1889645d817462d307d3ac51 + - name: Check if detection needed + id: detection_guard + if: always() + env: + OUTPUT_TYPES: ${{ needs.agent.outputs.output_types }} + HAS_PATCH: ${{ needs.agent.outputs.has_patch }} + run: | + if [[ -n "$OUTPUT_TYPES" || "$HAS_PATCH" == "true" ]]; then + echo "run_detection=true" >> "$GITHUB_OUTPUT" + echo "Detection will run: output_types=$OUTPUT_TYPES, has_patch=$HAS_PATCH" + else + echo "run_detection=false" >> "$GITHUB_OUTPUT" + echo "Detection skipped: no agent outputs or patches to analyze" + fi + - name: Clear MCP Config for detection + if: always() && steps.detection_guard.outputs.run_detection == 'true' + run: | + rm -f "${RUNNER_TEMP}/gh-aw/mcp-config/mcp-servers.json" + rm -f /home/runner/.copilot/mcp-config.json + rm -f "$GITHUB_WORKSPACE/.gemini/settings.json" + - name: Prepare threat detection files + if: always() && steps.detection_guard.outputs.run_detection == 'true' + run: | + mkdir -p /tmp/gh-aw/threat-detection/aw-prompts + cp /tmp/gh-aw/aw-prompts/prompt.txt /tmp/gh-aw/threat-detection/aw-prompts/prompt.txt 2>/dev/null || true + cp /tmp/gh-aw/agent_output.json /tmp/gh-aw/threat-detection/agent_output.json 2>/dev/null || true + for f in /tmp/gh-aw/aw-*.patch; do + [ -f "$f" ] && cp "$f" /tmp/gh-aw/threat-detection/ 2>/dev/null || true + done + for f in /tmp/gh-aw/aw-*.bundle; do + [ -f "$f" ] && cp "$f" /tmp/gh-aw/threat-detection/ 2>/dev/null || true + done + echo "Prepared threat detection files:" + ls -la /tmp/gh-aw/threat-detection/ 2>/dev/null || true + - name: Setup threat detection + if: always() && steps.detection_guard.outputs.run_detection == 'true' + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + env: + WORKFLOW_NAME: "Translate Docs to Japanese" + WORKFLOW_DESCRIPTION: "No description provided" + HAS_PATCH: ${{ needs.agent.outputs.has_patch }} + with: + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/setup_threat_detection.cjs'); + await main(); + - name: Ensure threat-detection directory and log + if: always() && steps.detection_guard.outputs.run_detection == 'true' + run: | + mkdir -p /tmp/gh-aw/threat-detection + touch /tmp/gh-aw/threat-detection/detection.log + - name: Setup Node.js + uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0 + with: + node-version: '24' + package-manager-cache: false + - name: Install GitHub Copilot CLI + run: bash "${RUNNER_TEMP}/gh-aw/actions/install_copilot_cli.sh" 1.0.40 + env: + GH_HOST: github.com + - name: Install AWF binary + run: bash "${RUNNER_TEMP}/gh-aw/actions/install_awf_binary.sh" v0.25.40 + - name: Execute GitHub Copilot CLI + if: always() && steps.detection_guard.outputs.run_detection == 'true' + continue-on-error: true + id: detection_agentic_execution + # Copilot CLI tool arguments (sorted): + timeout-minutes: 20 + run: | + set -o pipefail + touch /tmp/gh-aw/agent-step-summary.md + GH_AW_NODE_BIN=$(command -v node 2>/dev/null || true) + export GH_AW_NODE_BIN + (umask 177 && touch /tmp/gh-aw/threat-detection/detection.log) + printf '%s\n' '{"$schema":"https://github.com/github/gh-aw-firewall/releases/download/v0.25.40/awf-config.schema.json","network":{"allowDomains":["api.business.githubcopilot.com","api.enterprise.githubcopilot.com","api.github.com","api.githubcopilot.com","api.individual.githubcopilot.com","github.com","host.docker.internal","telemetry.enterprise.githubcopilot.com"]},"apiProxy":{"enabled":true},"container":{"imageTag":"0.25.40,squid=sha256:b084f4a2c771f584ee68084ced52fa6b3245197a1889645d817462d307d3ac51,agent=sha256:14ff567e8d9d4c2fbc5e55c973488381c71d7e0fdbe72d30ee7b8a738fd86504,api-proxy=sha256:2883ca3e5ae9f330cafdd9345bfd4ae17fc8da36c96d4c9a1f76e922b4c45280,cli-proxy=sha256:3e7152911d4b4b7b97beef9d3d7d924ff7902227e86001ef3838fb728d5d514c"}}' > "${RUNNER_TEMP}/gh-aw/awf-config.json" && cp "${RUNNER_TEMP}/gh-aw/awf-config.json" /tmp/gh-aw/awf-config.json + # shellcheck disable=SC1003 + sudo -E awf --config "${RUNNER_TEMP}/gh-aw/awf-config.json" --container-workdir "${GITHUB_WORKSPACE}" --mount "${RUNNER_TEMP}/gh-aw:${RUNNER_TEMP}/gh-aw:ro" --mount "${RUNNER_TEMP}/gh-aw:/host${RUNNER_TEMP}/gh-aw:ro" --env-all --exclude-env COPILOT_GITHUB_TOKEN --log-level info --proxy-logs-dir /tmp/gh-aw/sandbox/firewall/logs --audit-dir /tmp/gh-aw/sandbox/firewall/audit --enable-host-access --allow-host-ports 80,443,8080 --skip-pull \ + -- /bin/bash -c 'export PATH="$(find /opt/hostedtoolcache /home/runner/work/_tool -maxdepth 4 -type d -name bin 2>/dev/null | tr '\''\n'\'' '\'':'\'')$PATH"; [ -n "$GOROOT" ] && export PATH="$GOROOT/bin:$PATH" || true && GH_AW_NODE_EXEC="${GH_AW_NODE_BIN:-}"; if [ -z "$GH_AW_NODE_EXEC" ] || [ ! -x "$GH_AW_NODE_EXEC" ]; then GH_AW_NODE_EXEC="$(command -v node 2>/dev/null || echo node)"; fi; "$GH_AW_NODE_EXEC" ${RUNNER_TEMP}/gh-aw/actions/copilot_harness.cjs /usr/local/bin/copilot --add-dir /tmp/gh-aw/ --log-level all --log-dir /tmp/gh-aw/sandbox/agent/logs/ --disable-builtin-mcps --no-ask-user --allow-all-tools --add-dir "${GITHUB_WORKSPACE}" --prompt-file /tmp/gh-aw/aw-prompts/prompt.txt' 2>&1 | tee -a /tmp/gh-aw/threat-detection/detection.log + env: + COPILOT_AGENT_RUNNER_TYPE: STANDALONE + COPILOT_API_KEY: dummy-byok-key-for-offline-mode + COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }} + COPILOT_MODEL: ${{ vars.GH_AW_MODEL_DETECTION_COPILOT || 'claude-sonnet-4.6' }} + GH_AW_PHASE: detection + GH_AW_PROMPT: /tmp/gh-aw/aw-prompts/prompt.txt + GH_AW_VERSION: v0.71.5 + GITHUB_API_URL: ${{ github.api_url }} + GITHUB_AW: true + GITHUB_COPILOT_INTEGRATION_ID: agentic-workflows + GITHUB_HEAD_REF: ${{ github.head_ref }} + GITHUB_REF_NAME: ${{ github.ref_name }} + GITHUB_SERVER_URL: ${{ github.server_url }} + GITHUB_STEP_SUMMARY: /tmp/gh-aw/agent-step-summary.md + GITHUB_WORKSPACE: ${{ github.workspace }} + GIT_AUTHOR_EMAIL: github-actions[bot]@users.noreply.github.com + GIT_AUTHOR_NAME: github-actions[bot] + GIT_COMMITTER_EMAIL: github-actions[bot]@users.noreply.github.com + GIT_COMMITTER_NAME: github-actions[bot] + XDG_CONFIG_HOME: /home/runner + - name: Upload threat detection log + if: always() && steps.detection_guard.outputs.run_detection == 'true' + uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1 + with: + name: detection + path: /tmp/gh-aw/threat-detection/detection.log + if-no-files-found: ignore + - name: Parse and conclude threat detection + id: detection_conclusion + if: always() + continue-on-error: true + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + env: + RUN_DETECTION: ${{ steps.detection_guard.outputs.run_detection }} + GH_AW_DETECTION_CONTINUE_ON_ERROR: "true" + with: + script: | + try { + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/parse_threat_detection_results.cjs'); + await main(); + } catch (loadErr) { + const continueOnError = process.env.GH_AW_DETECTION_CONTINUE_ON_ERROR !== 'false'; + const msg = 'ERR_SYSTEM: \u274C Unexpected error loading threat detection module: ' + (loadErr && loadErr.message ? loadErr.message : String(loadErr)); + core.error(msg); + core.setOutput('reason', 'parse_error'); + if (continueOnError) { + core.warning('\u26A0\uFE0F ' + msg); + core.setOutput('conclusion', 'warning'); + core.setOutput('success', 'false'); + } else { + core.setOutput('conclusion', 'failure'); + core.setOutput('success', 'false'); + core.setFailed(msg); + } + } + + pre_activation: + runs-on: ubuntu-slim + outputs: + activated: ${{ steps.check_membership.outputs.is_team_member == 'true' }} + matched_command: '' + setup-trace-id: ${{ steps.setup.outputs.trace-id }} + steps: + - name: Setup Scripts + id: setup + uses: github/gh-aw-actions/setup@b8068426813005612b960b5ab0b8bd2c27142323 # v0.71.5 + with: + destination: ${{ runner.temp }}/gh-aw/actions + job-name: ${{ github.job }} + env: + GH_AW_SETUP_WORKFLOW_NAME: "Translate Docs to Japanese" + GH_AW_CURRENT_WORKFLOW_REF: ${{ github.repository }}/.github/workflows/translate-docs-ja.lock.yml@${{ github.ref }} + GH_AW_INFO_VERSION: "1.0.40" + - name: Check team membership for workflow + id: check_membership + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + env: + GH_AW_REQUIRED_ROLES: "admin,maintainer,write" + with: + github-token: ${{ secrets.GITHUB_TOKEN }} + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/check_membership.cjs'); + await main(); + + safe_outputs: + needs: + - activation + - agent + - detection + if: (!cancelled()) && needs.agent.result != 'skipped' && needs.detection.result == 'success' + runs-on: ubuntu-slim + permissions: + contents: write + issues: write + pull-requests: write + timeout-minutes: 15 + env: + GH_AW_CALLER_WORKFLOW_ID: "${{ github.repository }}/translate-docs-ja" + GH_AW_DETECTION_CONCLUSION: ${{ needs.detection.outputs.detection_conclusion }} + GH_AW_DETECTION_REASON: ${{ needs.detection.outputs.detection_reason }} + GH_AW_EFFECTIVE_TOKENS: ${{ needs.agent.outputs.effective_tokens }} + GH_AW_ENGINE_ID: "copilot" + GH_AW_ENGINE_MODEL: ${{ needs.agent.outputs.model }} + GH_AW_ENGINE_VERSION: "1.0.40" + GH_AW_WORKFLOW_ID: "translate-docs-ja" + GH_AW_WORKFLOW_NAME: "Translate Docs to Japanese" + outputs: + code_push_failure_count: ${{ steps.process_safe_outputs.outputs.code_push_failure_count }} + code_push_failure_errors: ${{ steps.process_safe_outputs.outputs.code_push_failure_errors }} + create_discussion_error_count: ${{ steps.process_safe_outputs.outputs.create_discussion_error_count }} + create_discussion_errors: ${{ steps.process_safe_outputs.outputs.create_discussion_errors }} + created_pr_number: ${{ steps.process_safe_outputs.outputs.created_pr_number }} + created_pr_url: ${{ steps.process_safe_outputs.outputs.created_pr_url }} + process_safe_outputs_processed_count: ${{ steps.process_safe_outputs.outputs.processed_count }} + process_safe_outputs_temporary_id_map: ${{ steps.process_safe_outputs.outputs.temporary_id_map }} + steps: + - name: Setup Scripts + id: setup + uses: github/gh-aw-actions/setup@b8068426813005612b960b5ab0b8bd2c27142323 # v0.71.5 + with: + destination: ${{ runner.temp }}/gh-aw/actions + job-name: ${{ github.job }} + trace-id: ${{ needs.activation.outputs.setup-trace-id }} + env: + GH_AW_SETUP_WORKFLOW_NAME: "Translate Docs to Japanese" + GH_AW_CURRENT_WORKFLOW_REF: ${{ github.repository }}/.github/workflows/translate-docs-ja.lock.yml@${{ github.ref }} + GH_AW_INFO_VERSION: "1.0.40" + - name: Download agent output artifact + id: download-agent-output + continue-on-error: true + uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1 + with: + name: agent + path: /tmp/gh-aw/ + - name: Setup agent output environment variable + id: setup-agent-output-env + if: steps.download-agent-output.outcome == 'success' + run: | + mkdir -p /tmp/gh-aw/ + find "/tmp/gh-aw/" -type f -print + echo "GH_AW_AGENT_OUTPUT=/tmp/gh-aw/agent_output.json" >> "$GITHUB_OUTPUT" + - name: Download patch artifact + continue-on-error: true + uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1 + with: + name: agent + path: /tmp/gh-aw/ + - name: Checkout repository + if: (!cancelled()) && needs.agent.result != 'skipped' && contains(needs.agent.outputs.output_types, 'create_pull_request') + uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2 + with: + ref: ${{ github.base_ref || github.event.pull_request.base.ref || github.ref_name || github.event.repository.default_branch }} + token: ${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} + persist-credentials: false + fetch-depth: 1 + - name: Configure Git credentials + if: (!cancelled()) && needs.agent.result != 'skipped' && contains(needs.agent.outputs.output_types, 'create_pull_request') + env: + REPO_NAME: ${{ github.repository }} + SERVER_URL: ${{ github.server_url }} + GIT_TOKEN: ${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} + run: | + git config --global user.email "github-actions[bot]@users.noreply.github.com" + git config --global user.name "github-actions[bot]" + git config --global am.keepcr true + # Re-authenticate git with GitHub token + SERVER_URL_STRIPPED="${SERVER_URL#https://}" + git remote set-url origin "https://x-access-token:${GIT_TOKEN}@${SERVER_URL_STRIPPED}/${REPO_NAME}.git" + echo "Git configured with standard GitHub Actions identity" + - name: Configure GH_HOST for enterprise compatibility + id: ghes-host-config + shell: bash + run: | + # Derive GH_HOST from GITHUB_SERVER_URL so the gh CLI targets the correct + # GitHub instance (GHES/GHEC). On github.com this is a harmless no-op. + GH_HOST="${GITHUB_SERVER_URL#https://}" + GH_HOST="${GH_HOST#http://}" + echo "GH_HOST=${GH_HOST}" >> "$GITHUB_ENV" + - name: Process Safe Outputs + id: process_safe_outputs + uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0 + env: + GH_AW_AGENT_OUTPUT: ${{ steps.setup-agent-output-env.outputs.GH_AW_AGENT_OUTPUT }} + GH_AW_ALLOWED_DOMAINS: "*.githubusercontent.com,api.business.githubcopilot.com,api.enterprise.githubcopilot.com,api.github.com,api.githubcopilot.com,api.individual.githubcopilot.com,codeload.github.com,docs.github.com,github-cloud.githubusercontent.com,github-cloud.s3.amazonaws.com,github.blog,github.com,github.githubassets.com,host.docker.internal,lfs.github.com,objects.githubusercontent.com,raw.githubusercontent.com,registry.npmjs.org,telemetry.enterprise.githubcopilot.com" + GITHUB_SERVER_URL: ${{ github.server_url }} + GITHUB_API_URL: ${{ github.api_url }} + GH_AW_SAFE_OUTPUTS_HANDLER_CONFIG: "{\"create_pull_request\":{\"draft\":false,\"labels\":[\"i18n\",\"ja\",\"automated\"],\"max\":1,\"max_patch_files\":100,\"max_patch_size\":1024,\"protect_top_level_dot_folders\":true,\"protected_files\":[\"package.json\",\"bun.lockb\",\"bunfig.toml\",\"deno.json\",\"deno.jsonc\",\"deno.lock\",\"global.json\",\"NuGet.Config\",\"Directory.Packages.props\",\"mix.exs\",\"mix.lock\",\"go.mod\",\"go.sum\",\"stack.yaml\",\"stack.yaml.lock\",\"pom.xml\",\"build.gradle\",\"build.gradle.kts\",\"settings.gradle\",\"settings.gradle.kts\",\"gradle.properties\",\"package-lock.json\",\"yarn.lock\",\"pnpm-lock.yaml\",\"npm-shrinkwrap.json\",\"requirements.txt\",\"Pipfile\",\"Pipfile.lock\",\"pyproject.toml\",\"setup.py\",\"setup.cfg\",\"Gemfile\",\"Gemfile.lock\",\"uv.lock\",\"CODEOWNERS\",\"DESIGN.md\",\"README.md\",\"CONTRIBUTING.md\",\"CHANGELOG.md\",\"SECURITY.md\",\"CODE_OF_CONDUCT.md\",\"AGENTS.md\",\"CLAUDE.md\",\"GEMINI.md\"],\"title_prefix\":\"[i18n-ja] \"},\"create_report_incomplete_issue\":{},\"missing_data\":{},\"missing_tool\":{},\"noop\":{\"max\":1,\"report-as-issue\":\"true\"},\"report_incomplete\":{}}" + GH_AW_CI_TRIGGER_TOKEN: ${{ secrets.GH_AW_CI_TRIGGER_TOKEN }} + with: + github-token: ${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }} + script: | + const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs'); + setupGlobals(core, github, context, exec, io, getOctokit); + const { main } = require('${{ runner.temp }}/gh-aw/actions/safe_output_handler_manager.cjs'); + await main(); + - name: Upload Safe Outputs Items + if: always() + uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1 + with: + name: safe-outputs-items + path: | + /tmp/gh-aw/safe-output-items.jsonl + /tmp/gh-aw/temporary-id-map.json + if-no-files-found: ignore + diff --git a/.github/workflows/translate-docs-ja.md b/.github/workflows/translate-docs-ja.md new file mode 100644 index 00000000..41a230d7 --- /dev/null +++ b/.github/workflows/translate-docs-ja.md @@ -0,0 +1,140 @@ +--- +on: + push: + branches: [master] + paths: + - "docs/**/*.md" + - "docs/**/*.mdx" + - "versioned_docs/**/*.md" + - "versioned_docs/**/*.mdx" + workflow_dispatch: + inputs: + full_resync: + description: "Re-translate every source file, ignoring diff. Use sparingly." + type: boolean + default: false + +permissions: + contents: read + +engine: copilot + +concurrency: + group: "i18n-ja-${{ github.ref }}" + cancel-in-progress: true + +network: + allowed: + - threat-detection + - github + +safe-outputs: + create-pull-request: + title-prefix: "[i18n-ja] " + labels: [i18n, ja, automated] + draft: false + +tools: + bash: + - "git diff *" + - "git diff-tree *" + - "git log *" + - "git show *" + - "git ls-files *" + - "ls *" + - "wc *" + - "mkdir *" + - "rm *" + edit: +--- + +# Translate Docs to Japanese + +Translate changed English documentation into Japanese under the Docusaurus +`i18n/ja/docusaurus-plugin-content-docs/` tree, then open a pull request with +the result. The English markdown is the only editable source — the Japanese +files in `i18n/ja/**` are generated output and must only be modified by this +workflow (or a follow-up PR review). + +## Path mapping (must be exact) + +| English source (editable) | Japanese output (generated) | +| -------------------------------------------------- | --------------------------------------------------------------------------------- | +| `docs/.md(x)` | `i18n/ja/docusaurus-plugin-content-docs/current/.md(x)` | +| `versioned_docs/version-/.md(x)` | `i18n/ja/docusaurus-plugin-content-docs/version-/.md(x)` | + +The set of versions is authoritative in [`versions.json`](../../versions.json) +(currently `1.8.4`). Mirror the directory structure exactly — never flatten, +rename, or reorganize files. + +## What to do on each run + +1. **Determine the change set** + - If `inputs.full_resync` is `true`, treat every file under `docs/**` and + `versioned_docs/**` as the change set. + - Otherwise, diff `${{ github.event.before }}..${{ github.event.after }}` (fall back + to `HEAD~1..HEAD` when `before` is the zero SHA, i.e. first push to a + branch) and collect all added, modified, renamed, and deleted `.md` / + `.mdx` files inside `docs/**` or `versioned_docs/**`. + - If the change set is empty after filtering, exit cleanly without opening + a PR. + +2. **For each added or modified source file** + - Compute the target path using the mapping table above. + - Read the English file. If its YAML front-matter contains + `translate: false`, skip it. + - Translate the body prose into natural, technical Japanese suitable for + end-user product documentation. Preserve **byte-for-byte**: + + - YAML front-matter keys and values for `id`, `slug`, `sidebar_position`, + `sidebar_label` keys whose values look like identifiers, and any + `custom_*` keys. Translate only human-readable values such as `title` + and `description`. + - Fenced code blocks (```` ``` ````), inline code (`` ` ``), and HTML/MDX + component tags and their attribute names. + - Relative links, anchor IDs, image paths, and admonition syntax + (`:::note`, `:::tip`, etc.). + - Heading levels and list structure. + - Write the translated content to the target path, creating parent + directories as needed. + +3. **For each deleted or renamed source file** + - Remove the corresponding Japanese mirror file. For renames, also create + the new translated file at the new target path. + +4. **Idempotency check** — after writing all files, run + `git status --porcelain i18n/ja` and `git diff --stat i18n/ja`. If there + are no changes, exit without opening a PR. + +5. **Open the pull request** via the `create-pull-request` safe output: + - Title: `Translate docs to Japanese ()` where `N` is the + number of files written. + - Body: a short summary table listing each changed source file and its + Japanese target, plus a "Do not edit generated files directly" note that + points reviewers at this workflow. + - Base: `master`. + +## Hard rules + +- **Never edit anything outside `i18n/ja/docusaurus-plugin-content-docs/`.** + Source markdown under `docs/` and `versioned_docs/` is read-only for this + workflow. +- **Never edit `i18n/ja/code.json`** or any file under + `i18n/ja/docusaurus-theme-classic/` — those are theme strings managed + separately. +- **Never hand-edit `.lock.yml`** or any other generated YAML. +- **One source file → one Japanese file.** Do not split or merge files. +- **Re-running on the same commit must produce no diff.** If the model + produces gratuitously reworded output for an unchanged English source, + prefer the existing Japanese file. +- **Skip binary, non-doc, and non-`.md(x)` files** even if they appear in the + diff. + +## Usage + +- Triggers automatically on every push to `master` that touches markdown + under `docs/**` or `versioned_docs/**`. +- Manual run for a full re-translation: + `gh aw run translate-docs-ja --ref master -F full_resync=true` +- Inspect a run: `gh aw logs translate-docs-ja` +- Audit a specific run: `gh aw audit ` diff --git a/.vscode/settings.json b/.vscode/settings.json new file mode 100644 index 00000000..dbd4bd79 --- /dev/null +++ b/.vscode/settings.json @@ -0,0 +1,5 @@ +{ + "github.copilot.enable": { + "markdown": true + } +} \ No newline at end of file diff --git a/docs/web/accessibility.md b/docs/web/accessibility.md new file mode 100644 index 00000000..7076d438 --- /dev/null +++ b/docs/web/accessibility.md @@ -0,0 +1,38 @@ +# Accessibility + +## Keyboard Accessibility + +The Reveal SDK supports keyboard navigation in View Mode, allowing users to interact with dashboards without a mouse. All interactive elements have visible focus indicators and follow a logical tab order. + +### Navigating the Dashboard + +Use the following keyboard shortcuts to navigate and interact with a dashboard: + +| Key | Action | +|-----|--------| +| **Tab** | Move focus to the next interactive element | +| **Shift + Tab** | Move focus to the previous interactive element | +| **Arrow Keys** | Navigate between visualizations on the dashboard, and within lists, grids, and menus | +| **Enter** | Activate the focused control (e.g., maximize a visualization, confirm a selection, open a menu) | +| **Space** | Toggle the checkbox of the focused element | +| **Escape** | Close an open dialog, menu, or popup | + +### Dashboard View Navigation + +When a dashboard is in View Mode: + +- Use **Arrow Keys** to move focus between visualizations on the dashboard. +- Press **Enter** on a focused visualization to move focus to the maximize button + +### Lists and Grid Components + +When focus is inside a list, dropdown, or grid-based component, use the **Arrow Keys** to navigate between items. Press **Enter** to select the focused item. + +### Focus Behavior + +- Focus is always visibly indicated as it moves through the interface. +- The keyboard navigation order follows a logical, intuitive sequence. + +### Limitations + +Keyboard navigation within visualization components is only supported for Scatter Maps, Grid, and Sparkline. For all other visualization types, only the visualization header is reachable via keyboard. Support for Pivot is planned for a future release. diff --git a/docs/web/release-notes.md b/docs/web/release-notes.md index 06d90fec..7aa54515 100644 --- a/docs/web/release-notes.md +++ b/docs/web/release-notes.md @@ -3,1632 +3,5 @@ import TabItem from '@theme/TabItem'; # Release Notes -## 1.8.4 (Mar 5th, 2026) - -### New Features - -#### All Platforms - -- New data source: MariaDB. -- Redshift now supports stored procedures. -- KPI visualizations now support conditional formatting. -- Added "Between" and "Not Between" number comparison operators for conditional formatting. -- Keyboard accessibility improvements in View Mode for grid and pivot visualizations. -- Localization now uses the user's language preference instead of the server locale. This affects labels such as "Grand Total" in Excel export, and "Previous" and "Current" in KPI visualizations. -- Elasticsearch now supports parameterized queries. -- MySQL now supports timezone conversion. -- Added a "Remove" button to the visualization editor fields list. -- Added a search box to the visualization type selection dialog. -- Added an `onFilterValueChanged` event to the RevealView. The event fires when the user uses the filtering UI or API to modify the selection of a filter. - -```javascript -revealView.onFilterValueChanged = (args) => { - console.log("Filter:", args.filter); - console.log("Source:", args.source.title); - console.log("Old value:", args.oldValue); - console.log("New value:", args.newValue); -}; -``` - -### Bugs - -#### All Platforms - -- The "Null or empty" filter option text is now localized. -- Switching visualizations quickly when using statistical functions could lose the original baseline. -- MongoDB blending regression. -- Cache not working in some scenarios for NodeJS and Java SDKs. -- Pivot Excel export headers missing when grand totals are visible. -- Dashboard filter refresh rate ignoring the metadata screen expiration setting. -- Stacked chart y-axis range only using first value field's range. -- Combination chart: changing the display order alters the y-axis range. -- Local evaluation of "not equals" operators incorrect. -- ScatterMap null reference exception when reloading data. -- Date range generation for quarter-based rules incorrect on web. -- SSAS hierarchical filters not working correctly. -- MySQL error when the database name includes a hyphen. -- Field search box not showing up in the visualization editor. -- Dashboard filter binding issues. -- Auto connect filters issues. -- Headless export inconsistencies with deferred rendering. -- Maximized visualization sizing and loading incorrect when dashboard has global filters. -- Multiple visualization editors could appear simultaneously in the dashboard layout. -- Show data labels setting not applied in Excel export. -- Data source icon not displaying for some data sources. -- Maximized visualization state incorrectly reported after minimizing. -- Headless export null pointer when the server returns 4xx or 5xx errors. -- Exporting a dashboard containing text widget could fail. -- Null values not treated as the smallest value when sorting. -- Azure Analysis Services could cause a null reference when global filters are present. - -#### Java - -- Headless export crash when exporting a grid visualization. - -## 1.8.3 (Jan 9th, 2026) - -### New Features - -#### All Platforms - -- Conditional formatting shape selection popup has been improved, and now includes a clear option. -- The new pie and donut chart is now generally available. This updated pie and donut replaces the previous pie and donut visualization. -- Headless export has been optimized to be more reliable and slightly faster. -- SQL Server now supports `ISEMPTY` function when creating a calculated field. -- The event onUrlLinkRequested now cancels navigation when null is returned. -- Large number formats are now localized. -- Improved UX to use a field for dashboard filter's label that is different than the field for the dashboard field filter value. -- Elasticsearch now has several improvements: added support for the `FORMATDATE` function, fixed issues with the `LOG` function (single parameter calls), fixed issue with the `FYEAR` (fiscal year) function, and made improvements to prevent SQL injection attacks. -- Data source icons can now be hidden or changed. - -```js -revealView.onAssetRequested = (args) => { - // Use default - return null; - - // Hide icon - return { visible: false }; - - // Custom icon - return { imageUrl: "./images/custom.jpg" }; - - // Conditional - if (args.dataSource instanceof RVSqlServerDataSource) { - return { imageUrl: "./images/sqlserver.jpg" }; - } -}; -``` - -- Added support for predefined calculated fields. - -```csharp -//Registration -mvcBuilder.AddReveal(builder => -{ - builder.AddDataModelProvider(); -}); - -//Implementation example - -internal class MyDataModelProvider : IRVDataModelProvider -{ - private static readonly List calculatedFields; - - static MyDataModelProvider() - { - calculatedFields = new List { - new RVDataModelCalculatedField("GrossAmount", "Gross Amount", RVDashboardDataType.Numeric, "[UnitPrice] * [Quantity]"), - new RVDataModelCalculatedField("DiscountAmount", "Discount Amount", RVDashboardDataType.Numeric, "[GrossAmount] * [Discount]"), - new RVDataModelCalculatedField("NetAmount", "Net Amount", RVDashboardDataType.Numeric, "[GrossAmount] * [Discount]") - }; - } - - public Task> GetCalculatedFieldsAsync(RVDataSourceItem dsItem, IRequestContext userContext) - { - if (dsItem.Title == "Order Details") - return Task.FromResult(calculatedFields); - else - return Task.FromResult>(null); - } - - public Task> GetMeasuresAsync(RVDataSourceItem dsItem, IRequestContext userContext) - { - if (dsItem.Title == "Order Details") - return Task.FromResult(new List { - new RVDataModelMeasure("Total Revenue", "sum([NetAmount])", "Total Revenue (net)"), - new RVDataModelMeasure("ASP", "sum([NetAmount]) / SUM([Quantity])", "Revenue-weighted price per unit") - }); - else - return Task.FromResult>(null); - } - - public Task> EditSchemaAsync(RVDataSourceItem dsItem, List baseSchema, IRequestContext requestContext) - { - if (dsItem.Title == "Order Details") - { - baseSchema.FirstOrDefault(f => f.Name == "Discount").DefaultAggregation = RVDashboardAggregationType.CountDistinct; - return Task.FromResult(baseSchema); - } - else - { - return Task.FromResult>(null); - } - } -} -``` - -- MongoDB now supports the `ENDOFMONTH` function. - -### Bugs - -#### All Platforms - -- RedisCacheOptions missing for TypeScript. -- Large number formatting applied incorrectly to percentage-based charts. -- Elasticsearch error on index preview. -- MySQL stored procedure parameters not being shown as filter binding options. -- The onFiltersChanged event is fired for interactive filtering, but the selectedValues property is not updated. -- KPI visualizations can overlap its labels in minimized mode. -- Google Analytics summarization of some measures incorrect. -- Google Analytics shows wrong metric values when using a date hierarchy. -- Unchecking "Show Data Labels" doesn't hide the labels. -- Headless export that includes a map visualization fails. -- Large number formatting does not work properly if `RevealSdkSettings.FormattingProvider` is defined. -- Custom date range not working for Analysis Services. -- Pie and donut chart disappears when legend is set to bottom. -- Analysis Services crashes when accessed on MacOS ARM. -- Custom font from theme not being used. -- Custom theme is getting replaced with Reveal's default. -- MySQL error when a null date is read from the query result. -- Custom visualization doesn't include field's label. -- Scatter map visualization showing incorrect text in tooltip for interactive filtering. - -#### Java - -- Numeric filter sends decimal instead of integer. - -## 1.8.2 (Nov 11th, 2025) - -This is a critical patch release that fixes a major issue with Redis cache support and adds TypeScript support for Node.js. **If you are using Redis cache (introduced in 1.8.1), you must upgrade to this version.** - -### Bug Fixes - -#### All Platforms - -- Fixed a critical bug preventing Redis cache from functioning correctly when configured. - -#### Node - -- Added TypeScript type definitions for improved development experience and type safety. - -## 1.8.1 (Nov 5th, 2025) - -### New Features - -#### All Platforms - -- Conditional formatting has been enhanced to allow for configurable rules and styling. These visualizations are currently supported; Grid, Pivot, Text View, Bar & Column chart. -- New data source: Elasticsearch. -- New cache provider: Redis. - -Java: - -```java -initializeParameterBuilder.enableRedisCache((options) -> { - options.setConnectionString("localhost:6379"); -}); -``` - -ASP.NET: -```csharp -builder.AddRedisCache((options) => { - options.ConnectionString = "localhost:6379"; -}); -``` - -Node: - -```ts -const revealOptions = { - ... - redisOptions: { connectionString: "localhost:6379" } -} -``` - -- Multiple date dashboard filters are now generally available. -- The cancel button can be programmatically hidden when editing a dashboard by setting the `showCancel` property on the RevealView. -- The RevealView will now automatically refresh its appearance when the `theme` property has been set on RevealSdkSettings. -- MongoDB provider now supports grid paging. -- Snowflake provider now supports grid paging. -- The `exitEditMode` on the RevealView will now return a boolean indicating whether or not we exited edit mode. -- Added support for the EMPTY function in SQL Server. -- Added support for grid paging when using data blending on data sources that support paging. -- Added support for exporting to CSV. -- Added support for read-only filters. -- Added support to hide a dashboard filter. -- Added support to customize the radial line axis range through the Settings tab in the visualization editor. -- "Select a Field" popup on the filter dialog now has the stored procedures listed above the fields. - - -#### Java - -- JTDS driver has been replaced with mssql-jdbc (v12.10.1.jre11). -- RVJDBCPropertiesCredentials is no longer used and has been removed. - -### Bugs - -#### All Platforms - -- Sorting a pivot table numeric field causes crash. -- Issue with column headers containing dashes in their title when exporting to Excel. -- When editing a dashboard, there is a `PRE` element added directly to the HTML body. -- Duplicate axis labels appearing in bar and column charts. -- The `onDateFilterChanged` event on RVDashboard always reports the first date filter. -- Adding a blended column causes grid paging to disable. -- Data truncation indicator is missing from visualization editor. -- Chart visualizations can disappear when browser is in the background. -- Unable to scroll through dashboard with custom visualization. -- "Invalid DateTime" error expanding data filter with REST data source. -- The `onVisualizationEditorClosing` event of RevealView throws exception if the event is cancelled. -- The `onUrlLinkRequested` event on RevealView is not called for dashboard linking trigger "Visualization Maximized". -- When filters have over 3000+ values, filtering then unselecting a filter value does not work. -- Time series axis label not following configured date formatting. -- Linking a visualization to another dashboard and connecting with a date filter does not open the linked dashboard. -- Refreshed data doesn't update filter values. -- Analysis Server provider not showing date as a date type dimension. -- Currency symbol dropdown is not displayed when the formatting type of a field is changed to currency. -- Zoom for the Scatter Map visualization is lost when saved or refreshed. -- Setting dashboard date filter rule to All Time via API produces no data. - -#### Java - -- Headless export using OS locale instead of the browser client locale. - -## 1.8.0 (Sept 3rd, 2025) - -### Breaking Changes - -- Support for .NET 6 has been removed. - -### New Features - -#### All Platforms - -- Snowflake now supports key-pair authentication. -- Snowflake now supports stored procedures. -- The `Snowflake.Data` dependency was updated to v4.8.0. -- SQL Server is now using command parameters instead of manual statement construction when calling stored procedures. -- The native binary used with Node has been updated to use .NET 8. -- Redshift now supports grid row paging. - -### Bugs - -#### All Platforms - -- Selecting a field to "sort by" a label when there is no data to display causes a "Index was outside the bounds of the array" error. -- The export button doesn't display a loading spinner after the first click and can be clicked multiple times. -- Scrolling causes RevealView to become unresponsive when using the Chrome device toolbar. -- Pivot expansion while sorting by values with multiple fields, is broken. -- Issue with `VisualizationOptions.ShowFilters`, from headless export. -- Visualization descriptions don’t appear if there are new lines or breaks in the content. -- Grid paging is not working for Amazon Athena. -- Dashboard filters do not cascade when using a REST datasource. -- MongoDB calculated fields using subtracting/adding numbers to dates give wrong results. -- Line chart does not display data after filter selection. -- MySQL duplicates stored procedures and their parameters. -- Headless export displays a console error if a dashboard includes a visualization date filter. -- Exporting a dashboard to Excel may generate a partially invalid .xslx file that can be opened but needs to be repaired first. -- Setting "Multiple" & "Required" on global filters with "All" only selects the first option. -- Stacked column has ghosting effect when zooming in and out. -- Headless export doesn't use the configured export language. -- Inconsistency in the drill down or drill up navigation path label when working with fiscal years and semesters or quarters. -- Dashboard descriptions don’t appear if there are new lines or breaks in the content. - -#### ASP.NET - -- `ImageExportOptions` constructor does not include `InitScript`. -- `ExportOptions` constructor does not include `IncludeFiltersSummaryPage`. - -#### Node - -- Package installation downloads the x64 native binary on MacOS ARM64. - -## 1.7.6 (July 22nd, 2025) - -Emergency patch release with critical bug fixes. - -### Bugs -- Selecting a field to "sort by" a label when there is no data to display causes a "Index was outside the bounds of the array." -- Thumbnails broken with `ERROR TypeError: $.ig.SdkDashboardDocument.fromJson is not a function` - -## 1.7.5 (July 8th, 2025) - -### New Features - -#### All Platforms - -- Databricks now supports the following authentication types; personal access token, OAuth token pass-through, OAuth client credentials, and Microsoft Entra ID client credentials. -- Reveal no longer extends native JS prototypes (e.g. Array). -- Date filters are now included in the dashboard's `filters` collection. -- An opt-in week date aggregation added to fields through `onFieldsInitializing` by setting the `weekLevelEnabled` to `true`. - -```js -revealView.onFieldsInitializing = function (args) { - args.fields.forEach(f => { - if (f.type == $.ig.RVDashboardDataType.Date || f.type == $.ig.RVDashboardDataType.DateTime) { - f.weekLevelEnabled = true; - }}); -}; -``` -- Highlighting filters are now removed when entering edit mode. -- The ANTLR dependency was updated to v4.13.1. -- Redshift connector now supports cross database blending for databases contained in the same AWS cluster. -- Rule and range properties can now be set via API for existing date dashboard filters. - -```js -revealView.dashboard.filters[0].rule = new $.ig.RVDateRule($.ig.RVPeriodRelation.Last, 2, $.ig.RVPeriodType.Day); -//-or- -revealView.dashboard.filters[0].range = new $.ig.RVDateRange(new Date(2023, 0, 1), new Date(2023, 11, 31)); -``` -- Support for multiple date dashboard filters included as a beta feature. -- `RVDashboard.dateFilter` is deprecated. It's being kept for compatibility for the time being, and is a reference to the first `DateDashboardFilter`, if there is one. - -#### Java - -- The ANTLR dependency was updated to v4.13.2. -- The okhttp dependency was updated to v4.12.0. - -#### Node - -- Filters and date filters are now support for headless Excel export. -- Puppeteer extracts Chrome to a different location, users making use of nodemon should update the configuration ignore the directory. - -```json -"nodemonConfig": { - "ignore": ["chrome-headless*/*"] -} -``` - -### Bugs - -#### All Platforms - -- Headless export console error from missing JS. -- Description in duplicated Text Box disappears. -- Headless export fails if a dashboard contains a Text Box visualization. -- Highlighting lost after drill-down removal, despite filter still applied. -- Highlighting adds an extra day to other charts due to filter settings. -- Highlighting export is not displayed correctly for visualization. -- Highlighting filters are being shown in the visualization editor. -- DateRules with a "Next" period relation did not display the correct number of days when the amount was greater than one. -- Bar and column visualizations don't make appropriate use of the plot area on first load. -- Duplicate menu item shown if AllTime is added as a custom item in a date filter's menu. -- Scatter map visualization shifted the centering of the map. -- Duplicate dialogs during Excel export with multiple grid visualizations. -- Choropleth handles states wrong when using the "USA States" map. -- Unhandled null reference exception after applying Tooltip filter in a pivot visualization. -- Switching visualization type on a grid visualization results in the visualization disappearing and producing an error in the console. -- Dashboard link parameters broken for category field. -- Null reference error opening dashboard with CustomRange filter with range not set. -- Drill down is available even when there is a single date field with no hierarchy defined. -- Date format lost on drill up/down. -- Tooltip field items not using field labels. -- Japanese characters in filter labels are garbled in a pdf file created via headless export. -- New pie is not being exporting correctly to PDF. -- Grid paging loads data twice. -- Long graph legends are not correctly shown. -- Wrong data shown when expanding a pivot using '... to Date' filter. -- Date Range filter "Trailing 12 months" is including current month data. -- Filter opacity is darker on mobile than regular screen sizes. -- Expansion not working when another pivot row is present. -- Ad-hoc pivot expansion misbehaves when items are duplicated. -- Drill down on empty element causes crash. -- Drill down on a expanded pivot row doesn't work well. -- UI not refreshing when Range is set for date global filter when using API. -- Refresh needed to update the visualization after changing date filter. -- Excel datasource detecting date column as numeric. -- Export of raw data image results in crash. -- UI doesn't update when using API to modify date global filter that has just been created. - -## 1.7.4 (May 6th, 2025) - -### New Features - -#### All Platforms - -- New data source: Databricks. -- The field editor has been improved and contains tabs for different option categories. -- Added a beta features API. - -```js -// Enable beta feature -$.ig.RevealSdkSettings.betaFeatures.enable("newDonutChart", "newPieChart"); - -// Disable beta feature -$.ig.RevealSdkSettings.betaFeatures.disable("newDonutChart", "newPieChart"); -``` - -- The chart toolbar is now generally available. It can be enabled or disabled through the `showToolbar` property on the RevealView. The default value of this property `false`. -- Interactive filtering is now generally available. To enable this feature set `interactiveFilteringEnabled` to `true` on the RevealView. By clicking "Filter By" in the tooltip, this feature will highlight the data in the rest of the charts. -- A new property was added in the visualization editor for slice charts to configure fraction digits of the shown percentages. -- In data sources that contain a `database` property, data source items derived from it no longer have the `database` property set by default. While this makes setting the RVDataSourceItem's `database` property not a requirement, it is strongly recommended to do so even to set it to null, for security reasons. -- Support for an optional `sessionToken` parameter was added to the RVAmazonWebServicesCredentials. - -#### Node - -- The `dashboardProvider` & `dashboardStorageProvider` now use a `Readable` type definition for the stream. This allows for support for more locations than files. - -### Bugs - -#### All Platforms - -- Using single visualization mode showed misaligned UI elements. -- Visualization filters are not working when changed in the editor. -- Some number conversions resulted in crash. -- Setting `PREVIOUS_YEAR` filter is not working with headless export. -- Excel export fails when dashboard has visualization with error. -- Wrong date range calculated in dashboard linking for year and quarter hierarchy. -- Wrong data when expanding or drilling down and a filter on a date field with fiscal year is applied. -- KPI vs Time % increase incorrect sign when previous number is negative. -- Headless export missing global & visualization filters on each visualization when targeting PDF. -- SSAS performance degraded for some visualizations. -- `NotEquals` and `NotContains` filters do not work in SSAS. -- The date filter is showing as "Unnamed" in headless export. -- Interface `IRVDateFilterMenuItem` isn't part of the RevealApi namespace in the "infragistics.reveal.d.ts" file. -- PowerPoint Exports Showing Token and Luis' Name. -- Highlighting not working for Dates using Google Analytics and similar data sources. -- Show totals on tooltip flag ignored. -- Google Analytics datasource selection crashes if required props are not set. -- "value.toFixed is not a function" error when placing a calculated field where some result is "Infinity" as a value in a Bar visualization or any of the slice chart visualizations. -- Visualization description is overlapped by the title. -- Excel exports with cells with a numeric value of 0 show as empty. - -#### Java - -- Yellow "configure" banner showing when exporting a visualization using a map visualization. - -## 1.7.3 (Mar 4th, 2025) - -### New Features - -#### All Platforms - -- Axis titles are now generally available and can be customized through a dedicated text box by clicking on the visualization field in the editor. -- Fixed lines are now generally available. -- Chart visualizations containing a numeric axis have been enhanced to reduce any potential label repetition. -- A chart's legend can now be positioned at the top or bottom of the visualization, and the alignment can be customized to left, right, or center. These options exist in the Settings tab in the visualization editor. -- Grid paging now supports sorting through the sort icon found on the column header. -- Column visualizations will now favor their labels to appear above the column, and bar visualizations will favor their labels to appear to the right of the bar. -- Further enhancements were made to the hiding and showing of labels on visualizations. -- The `args.items` property on the `revealView.onDateFilterMenuOpening` is now using and array of `IRVDateFilterMenuItem` objects. - -```js -revealView.onDateFilterMenuOpening = function(args) -{ - var list = args.items; //List of IRVDateFilterMenuItem objects - var pos, newItem; - - //Add "Last 2 months" to the months section - pos = list.findIndex(obj => obj.title === "Month to date"); //Last item in the months section - var lastTwoMonthsRule = new $.ig.RVDateRule($.ig.RVPeriodRelation.Last, 2, $.ig.RVPeriodType.Month); - newItem = new $.ig.RVDateFilterMenuOption(lastTwoMonthsRule); - list.splice(pos + 1, 0, newItem); - - //Remove the "Today" option - pos = list.findIndex(obj => obj.title === "Today"); - list.splice(pos, 1); - - //Add "First week of 2024" to a new section at the end of the menu - list.push(new $.ig.RVDateFilterMenuSeparator()); //Add section separator - var firstWeek24Range = new $.ig.RVDateRange(new Date("2024-01-01"), new Date("2024-01-31")); - newItem = new $.ig.RVDateFilterMenuOption(firstWeek24Range, "First week of 2024") - list.push(newItem); -}; -``` - -#### Node - -- The `puppeteer-core` dependency was updated from `14.1.2` to `24.1.1`. - -### Bugs - -#### All Platforms - -- The property `serialize` on the `RevealView` actually returns a byte array. -- Blank space above chart in single visualization mode when hiding header, title, and filters. -- Using `RVIntegratedAuthenticationCredential` results in an error. -- Visualization filters are hidden after maximizing when `showHeaders` is set to `false`. -- Analysis Services returns wrong values with some locales/cultures. -- Crash when selecting "Select values" for a dashboard filter. -- Conditional formatting with percentage and columns is not working. -- Incorrect data source ID in `ChangeDataSourceItemAsync`. -- Japanese characters are garbled in a PDF file created via headless export. -- Japanese date format is not correct in an exported PDF file. -- Unwanted numbering "(1)" appears in a dashboard title in a PDF file created via headless export. -- Date format of the dashboard/visualization filters are not correct in Japanese. -- Dashboard filters appear on all visualizations when maximized, even if they are not connected. -- Filters disappears after maximizing visualization. -- Category labels are in reverse order for stacked bar chart. -- Error when setting a `DateRule` to a dashboard date filter via API. -- Error when setting a `DateRule` to a visualization filter via menu in a XMLA visualization. -- Crash when creating or loading a combo visualization. -- Dashboard linking from grid to dashboard date filter not working. -- Missing content-type response header for export-related endpoints. -- Exceptions in interactive export are not being notified to the user. -- Data truncation indicator alignment is wrong. -- Export to Excel fails for Analysis Services with dashboard filter. -- (Beta) Toolbar icons are misaligned. -- (Beta) Toolbar buttons require double click to perform an action. - -#### Java - -- When querying a Date field from a REST datasource during PM hours, the time component will show noon. - -## 1.7.2 (Jan 20th, 2025) - -### New Features - -#### All Platforms - -- (Beta) Added support for custom menu items in toolbar using `onMenuOpening`. -- (Beta) Compare filtered data within the same visualization. Interactive filtering was enhanced to support XMLA data sources. Now, the showing "Filter By" option appears when there are multiple visualizations. Additionally, the choropleth map will highlight the selected country. When a filter is added, it is now read-only to prevent changes. Filtering is also now allowed by date, with the restriction that only one date value can be selected. -- (Beta) Axis titles can now be controlled in the visualization editor settings pane, with the following options; none, x-axis, y-axis, or both. To enable this functionality set `$.ig.RevealSdkSettings.enableBetaFeatures` to `true`. -- The PostgreSQL data provider now supports materialized views. -- The BigQuery data provider now supports data blending. -- The donut chart visualization now support different center label modes; none, label only, value only, or both label and value. -- The Snowflake data source dependency Snowflake.Data was updated to v2.0.18. -- The date filter presets dropdown now supports editing the available date filters and including your own filters through the `onDateFilterMenuOpening` event. Support was also added for semester-based date rules. - -```js -revealView.onDateFilterMenuOpening = customizeDateFilterMenu; -//revealView.ShowDateFilterDropdown = false; //Hides the button that shows the dropdown altogether - -function customizeDateFilterMenu(args) -{ - //if(![my_access_check]) { //Perform access check to the filter menu - // args.Cancel = true; //Cancel opening of filter items list - // return; - //} - - var list = args.Items; //List of RVDateFilterMenuItem objects - var pos; - - //Add "Last 2 months" to the "months" section - pos = list.getItemIndex("Month to date"); //Obtain the beginning of the "years" section - var lastTwoMonthsRule = new $.ig.RVDateRule($.ig.RVPeriodRelation.Last, 2, $.ig.RVPeriodType.Month); - list.insert(pos + 1, lastTwoMonthsRule); //Insert using helper - - //Add "Last 2 weeks" to a new section after the "days" section - pos = list.getItemIndex("Last 7 days"); - list.insertSeparator(pos + 3); - var lastTwoWeeksOpt = new $.ig.RVDateFilterMenuOption(new $.ig.RVDateRule($.ig.RVPeriodRelation.Last, 2, $.ig.RVPeriodType.Week)); //Instantiate RVDateFilterMenuOption directly - list.insert(pos + 4, lastTwoWeeksOpt); - - //Remove "Today" option - var todayItem = list.getByTitle("Today"); - list.remove(todayItem); - - //Add "First week of 2024" to a new section at the end of the menu - list.addSeparator(); - var firstWeekOf2024Range = new $.ig.RVDateRange(new Date("2024-01-01"), new Date("2024-01-07")); //Customized description - list.add(firstWeekOf2024Range, "First week of 2024"); -} - -//The new rules also integrate with the existing filters API -revealView.dashboard.dateFilter = new $.ig.RVDateDashboardFilter(new $.ig.RVDateRule($.ig.RVPeriodRelation.Last, 3, $.ig.RVPeriodType.Day)); -``` - -- Dashboard filters now try to automatically connect to the visualization, in cases where not possible, the manual connection can be used as before. -- The `RevealView` now has a `showTitle` property that toggles the visibility of the dashboard title independently of the dashboard header. The default value is `true`. -- The property `ShowSave` has been added to the `RevealView`. This property determines whether or not the save button is shown. The default value is `true`. -- Axis grid lines can now be controlled in the visualization editor settings pane, with the following options; none, horizontal, vertical, or both. -- The `RevealView` now has a `showVisualizationFilters` property that toggles the visibility of the visualization filters when maximized. The default value is `true`. - -#### ASP.NET & Node - -- Added support for Microsoft’s SQLite implementation on Web, introducing optional encryption. To enable encryption, developers must call `RevealEmbedSettings.EnableEncryption("yourpassword")` with a secure, non-empty password. By default, the legacy SQLite implementation without encryption remains enabled (`RevealEmbedSettings.IsLegacyCacheEnabled = true`). Switching to Microsoft’s implementation without encryption is possible by setting this flag to `false`. Note: `EnableEncryption` automatically disables the legacy implementation. This change marks the start of a transition to deprecate the original SQLite library; feedback during this period is encouraged. - -ASP.NET: -```csharp -builder.Services.AddControllers().AddReveal(revealSetupBuilder => -{ - revealSetupBuilder.AddSettings( - settings => - { - settings.IsLegacyCacheEnabled = true; - //settings.EnableEncryption("optional-password"); //this method isn't called by default - }); -}); -``` - -Node: -```js -const revealOptions = { - //... - isLegacyCacheEnabled: true, - //enableCacheEncryption: true, - //cacheEncryptionPassword: "optional-password", -} -app.use('/', reveal(revealOptions)); -``` - -### Bugs - -#### All Platforms - -- `onVisualizationDataPointClicked` not invoked on slice-based (pie, donut, and funnel) and scatter map visualizations. -- Data may be wrong when using `TODAY`/`NOW` calculated field functions. -- Error setting maximum axis value. -- Error in highlighting a widget from an XMLA data source when other widgets are from different XMLA data sources. -- Filters from XMLA data sources allow auto-connection to widgets using other data sources, which then breaks the visualization. -- XMLA global filters are not working at all. -- In some loading scenarios the dashboard's identifier was being set to null. -- Google Analytics 4 error loading filters and global filter values. -- The last fixed chart line field can't be removed. -- SSAS 'FillTotalsInRow' error for a visualization with grand totals. -- SSAS no data displayed while using some of the chart types. -- Uncaught TypeError: String.isNullOrEmpty is not a function when adding a filter. -- Labels sometimes don't hide when there's not enough space. -- Exception occurs after switching to another chart type after viewing raw data. - -## 1.7.1 (Nov 5th, 2024) - -### Breaking Changes - -#### All Platforms - -- `ChartInteractionEventArgs` has been renamed to `TooltipShowingEventArgs`. - -### New Features - -#### All Platforms - -- Chart visualizations will automatically hide 0 value data labels. -- Custom menu items can now be added to visualization tooltips by adding an `RVTooltipItem` to the `customItems` property on the args pass to the `onTooltipShowing` function. - -```js -revealView.onTooltipShowing = function (args) { - //A string pointing to the image may be used or an RVImage, such as: - //var caseIcon = new $.ig.RVImage("https://svgsilh.com/png-512/306879.png", "Case Icon"); - var caseIcon = "https://svgsilh.com/png-512/306879.png"; - var openIcon = "https://svgsilh.com/png-512/41335.png"; - - if (args.cell.formattedValue == "Digital Security Center") - { - args.customItems.push(new $.ig.RVTooltipItem("Critical", "Escalate Incident", caseIcon, (sender, clickArgs) => { console.log("Clicked"); })); - args.customItems.push(new $.ig.RVTooltipItem("Critical", "Open Incident Report", openIcon, (sender, clickArgs) => { console.log("Clicked"); })); - - args.customItems.push(new $.ig.RVTooltipItem("High", "Send Reminder", null, (sender, clickArgs) => { console.log("Clicked"); })); - args.customItems.push(new $.ig.RVTooltipItem("High", "Assign Lead Investigator", null, (sender, clickArgs) => { console.log("Clicked"); })); - } -} -``` - -- Positioning improvements made for tooltips showing actions on hover. -- URL linking now works out of the box without needing to implement `onDashboardSelectorRequested`. -- Target setting added to the linking dialog for URLs. The target may be specified through `onUrlLinkRequested` by using the `target` property off of the args parameter. - -```js -revealView.onUrlLinkRequested = (args) => { - args.target = "_blank"; - return "https://www.google.com/"; -}; -``` - -- Grid paging is now enabled by default for supported data sources when a new visualization is created or an existing visualization is edited and switched to grid. -- Improvements made to mouse wheel events to better support web component frameworks that make use of the Shadow DOM. -- Performance improvements for request execution and credential resolution under high load. -- Simplified the MongoDb match stage to improve the performance of query execution. - -#### ASP.NET - -- Added support for .NET 8.0. -- The dependency Npgsql v6.0.9 was updated to v7.0.7. -- The dependency Snowflake.Data v1.1.4 was updated to v2.0.18. -- For the Sybase connector, the dependency System.Data.SqlClient v4.7.0 was updated to v4.8.6. - -#### Java - -- A new method `public InitializeParameterBuilder setCachePath(String path)` was added to `InitializeParameterBuilder` to allow customization of the cache files location. - -### Bugs - -#### All Platforms - -- Treemap tooltip showing incorrect information. -- The message "There's no data to display" is displayed while data is being loaded for a preview. -- InMemory data source opens editor directly when there is more than one data source available. -- Date range calendar is not responsive. -- Assigning a calculated field as a data filter doesn't work correctly for Postgres. -- Unable to do 'sort by' with calculated fields. -- Error sorting by a calculated field on sql based providers with "Process Data on Server" setting. -- `trunc` function is not working fine inside concatenate. -- Large number formatting wasn't being applied when configured to a field using the Grid visualization. -- Wrong date formatting shown in UI when setting selected value for date visualization filter. -- Date values reporting incorrectly on click/hover events. -- Combo visualization doesn't calculate lowest axis minimum per axis. -- Stacked Bar visualization displays duplicate y-axis markers when the decimal is set to 0. -- Analysis Services dimension structure is not updated from server with Refresh. -- Interactive filtering is not working for Label Gauge. -- Switching to raw data and then to another visualization causes crash. -- Scrolling a paged row grid into view produces a crash. -- Text visualization shows "There is no data to display". -- Large numbers in Donut Chart are overflowing rather than shrinking. -- The `showFilters` property on the RevealView, when set to `false`, does not function as intended. -- Dragging field from hierarchy to Category crashes application. - -#### ASP.NET - -- When using Serilog as logger, message parameters are not properly replaced - -## 1.7.0 (Sept 10th, 2024) - -### Breaking Changes - -#### Java - -- Spring Boot 2.x is no longer supported. You'll need to use Spring Boot 3.x with JDK 17+ and Jakarta EE 9 complaint server to host your application. - -### New Features - -#### All Platforms - -- (Beta) Fixed lines can now be added to category charts. This beta functionality can be accessed by enabling the `enableBetaFeatures` property on `$.ig.RevealSdkSettings`. The fixed lines section in the editor can use data fields, or one of the highest, lower, average, or fixed value aggregate specialty fields. -- Added support for dates in visualization filter API. For example, when you have a date-based visualization filter, such as "Last 7 days", you can use the following code to check the date range that the filter evaluated to by checking the `from` and `to` properties of the returning `RVDateRange` object. - -```js -var dateRange = revealView.dashboard.visualizations[0].filters[0].dateRange; -``` - -- Server side grid paging is now available without requiring the `enableBetaFeatures` flag in `$.ig.RevealSdkSettings`. Paging is supported in the following providers: SQL Server, MySQL, BigQuery, PostgreSQL, SyBase, Athena, and Oracle. The providers that support stored procedures will have grid paging disabled when a stored procedure is selected as these can't be queried like tables to return a range of rows. Additionally, paging is not available when processing data on server is false, as well as when using blended data. -- Added visualization-level descriptions. When editing a visualization, you can now enter a description if desired. -- Visualizations now automatically support dashboard linking. The default functionality can still be overridden using the instructions from the [Linking Dashboards](https://help.revealbi.io/web/linking-dashboards/) topic. -- Visualizations can now individually be exported to PDF through their overflow menu when maximized. -- The filter summary page can now be hidden in exports by setting the `includeFiltersSummaryPage` property on the `ExportOptions` object. The exception to this is NodeJS, on that platform the filters summary page is not included regardless of the setting. -- The background overlay when clicking overflow menus or filter search boxes is now lighter. -- Added the ability to define hidden fields in Grid visualization, which can be used to define a URL or dashboard link. -- (Beta) Compare filtered data within the same visualization. The series tooltip includes an option to filter by the selected value. The rest of the visualization will display both the filtered values and the original ones for easy comparison. In this release support was added for funnel, treemap, and gauges. This functionality is currently supported in the following chart types: Column, Bar, Line, Time Series, Area, Step Area, Spline, Stacked Column, Stacked Area, Stacked Bar, Funnel, Treemap, and Gauges. To enable this functionality, set `interactiveFilteringEnabled` to `true` on the RevealView. -- Image export is now supported in headless export. -- Sql Server Analysis Services data sources now support the `EffectiveUserName` property, which makes it possible to impersonate the given user. The property can be leveraged to achieve single sign on, e.g. by setting the property in the `IRVDataSourceProvider` implementation with the value of the current user, as set in the userContext. - -#### ASP.NET & Node - -- Windows Integrated Authentication is now supported in the Sql Server Analysis Services data source. To enable it, return a new instance of `RVIntegratedAuthenticationCredential` in your 'IRVAuthenticationProvider' implementation. - -#### Java - -- Added support for Spring Boot v3. With this support comes the news that Spring Boot v2.x isn't supported anymore. To use Spring Boot v3 you'll need to use JDK 17+ and will need a Jakarta EE 9 compliant server to host your application. -- Added ARM64 support for ExportTool - -### Bugs - -#### All Platforms - -- Cached files were not removing .tmp file after adding an entry to the Reveal cache. -- Misaligned placeholder on textarea fields after changing font-size. -- Configured sorting in the value or label field not reflected in Pie visualization. -- Editing a dashboard that includes only a TextBox may lead to a crash. -- The date filters for "Today" and "Yesterday" show incorrect values in different time zones. -- Wrong background color on clickable elements when the mouse is down. -- Excel export generates wrong chart when there are null values for date fields. -- Stacked column chart colors disappear when using a category. -- Choropleth charts show some states green. -- Changing labels using `onFieldsInitializing` is not reflected in the field selection of the dashboard filter. -- Field formatting loss when changing visualization types and exporting to Excel. -- Headless export `InitScript` not working for Visualizations. -- Map shapes loaded from http not https. -- Dashboard description is added as child of body tag. -- Dashboard linking doesn't work for null or empty string values. -- Changing the title or description of a dashboard when using web components causes those fields to revert to defaults. -- Snowflake metadata browser showing tables from all schemas. - -## 1.6.7 (June 26th, 2024) - -### New Features - -#### All Platforms - -- Added API to programmatically access visualization filters (aka Quick Filters) and modify their selected values. - -```js -//Add a selected value, specified by index from the list of available values, to a field given its name. -function addSelValueToFilter(fieldName, valueIdx) { - var flt = revealView.dashboard.visualizations[0].filters.getByFieldName(fieldName); - var valuesPromise = flt.getFilterValues(); //Retrieve the selectable values for the filter - valuesPromise.then(function (values) { - var selValues = flt.selectedValues; - selValues.push(values[valueIdx]); //Add the specified value to the selection - flt.selectedValues = selValues; - }); -} -``` -- (Beta) Compare filtered data within the same visualization. The series tooltip includes an option to filter by the selected value. The rest of the visualization will display both the filtered values and the original ones for easy comparison. Currently supported in the following chart types: Column, Bar, Line, Time Series, Area, Step Area, Spline, Stacked Column, Stacked Area, Stacked Bar. To enable this functionality, set `highlightedFilteringEnabled` to `true` on the RevealView. -- (Beta) Visualization toolbar was added to quickly access trend-lines, labels, zooming, etc. To enable this functionality, set `enableNewToolbar` to `true` on `$.ig.RevealSdkSettings`. -- Removed the ability to provide a custom query client-side on SQL-based data sources. -- Removed RVGoogleAnalyticsDataSource and RVGoogleAnalyticsDataSourceItem as Google will sunset the API for that connector on July 1st, 2024. -- Added `onDashboardChanged` event to RevealView. - -```js -revealView.onDashboardChanged = function (args: DashboardChangedEventArgs) { - console.log('Dashboard has changed.'); - console.log('Old Dashboard:', args.oldValue); - console.log('New Dashboard:', args.newValue); - - // Accessing filters for the old and new dashboard - if(args.oldValue) { - console.log('Old Dashboard Filters:', args.oldValue.filters); - } - if(args.newValue) { - console.log('New Dashboard Filters:', args.newValue.filters); - } -}; -``` -- Tables in the data source dialog are now sorted alphabetically. This change applies to connectors for: SQL Server, MySql, Postgres, Redshift, Oracle, and Snowflake. -- Headless export now includes grid data. -- RVGoogleAnalytics4DataSource now includes `accountId` & `propertyId` properties, and deprecating the corresponding properties in RVGoogleAnalytics4DataSourceItem. - -#### Java - -- Added a default RVDashboardProvider to enable the saving of dashboards to the server without needing to implement a provider. - -### Bug Fixes - -#### All Platforms - -- Excel export crash when exporting a XMLA-based visualization that has no field set in the Label section. -- Incorrect DataSource ID in ChangeDataSourceItemAsync. -- Exception caused when a Sparkline visualization was loaded with the dashboard. -- Exception caused by invalid cast in the Grid visualization. -- Stored procedures are shown as a valid additional data source in the blending UI. -- Error reading DateTime.MaxValue from database. -- Exporting an Excel file with a widget with no title crashes. -- Excel export containing expanded rows in the Pivot visualization mixes up columns. -- Null row header when exporting Line chart visualization. -- Reserved characters aren't filtered correctly when exporting to Excel. -- Date formatting is not applied on Excel export. -- Filter editor fields list affects the expression editor fields list. -- SharePoint O365 datasource doesn't work. -- Calculated expression `datediff` works with double quotes not single quotes. -- Wrong BigQuery date precision handling. -- Editor search bar rendered multiple times. -- Filtered field list is incorrect after adding a calculated field. - -#### ASP.NET & Java - -- RDASH properties take precedence over what is set on the server. - -#### Java - -- ExportTool is created in wrong path. - -## 1.6.6 (April 19th, 2024) - -### New Features - -#### All Platforms - -- Added an optional description text box, controlled by the property `showDescription`, to the RevealView. -- Exporting a grid or pivot to PDF will now generate "overflow" tables containing the columns that would otherwise not fit the width of the page. -- Grid column width is now respected on PDF export. -- Improved pivot grid visualization appearance in exports to Excel. -- (Beta) Added server side paging support to the grid visualization. To enable this functionality and have it appear in the visualization editor Settings pane, set `$.ig.RevealSdkSettings.enableBetaFeatures` to `true`. Paging is supported in the following providers: SQL Server, MySQL, BigQuery, PostgreSQL, SyBase, Athena, and Oracle. The providers that support stored procedures will have grid paging disabled when a stored procedure is selected as these can't be queried like tables to return a range of rows. Additionally, paging is not available when processing data on server is false, as well as when using blended data. -- `SkiaSharp`, `SkiaSharp.HarfBuzz`, and `SkiaSharp.NativeAssets.Linux` v2.88.3 dependency updated to v2.88.7. -- A flag was added to the RevealView to control whether or not data tooltip previews in the visualization editor. They are turned off by default to prevent a query getting the first 5 rows. To enable this tooltip, set `isPreviewDataInVisualizationEditorEnabled` to `true`. -- Blending is now supported in MySql when using process data on server. -- Radial charts have a new look & feel. The old L&F are deprecated but if needed, they can be restored by setting `RevealSdkSettings.EnableNewCharts = false`. -- Bar and column charts now include an overlap and gap setting in the visualization editor Settings pane. This allows you to control the amount of overlap between the bars and the amount of space between the groups. -- The Treemap visualization now shows a tooltip on hover and highlights the node. -- `Playwright` v1.27.2 dependency updated to v1.42.0. - -#### Node -- Added `dataSourceItemFilter` property to the RevealOptions that allows the filtering of data sources items in the data source dialog -```ts -dataSourceItemFilter?: (userContext: IRVUserContext | null, dataSourceItem: RVDataSourceItem) => Promise -``` - -### Bug Fixes - -#### All Platforms - -- Pie & Doughnut charts are not displayed when exporting from UI. -- Deleting a data blend while a calculated field depends on it won't delete the calculated field. -- Calling a function in Redshift produces an error. -- Postgres functions not working. -- RevealView positioning and sizing when using transform:scale style on the container or any ancestor element. -- Setting `canAddDateFilter` causes exception. -- Save event `args.isNew` is `false` if dashboard property is set to null or undefined. -- Stored procedures parameter screen will sometimes pull previous data or nothing at all. -- Scroll stops working on pop-up element when using search bar. -- Scatter Map indicators hover region shifts with zoom. -- Fraction digits are not shown in Choropleth Map tooltip. -- Filter value above 3000+ is not preserved. -- Errors with renamed pivot fields in post-calculated field UI. -- Preview data cell is not being reused causing it to be rendered multiple times. -- Grids crash on MacOS ARM64. -- Pie chart legend disappears when there is enough space to show it. -- MySql blending with Process Data on Server off produces error. -- Hover event not behaving as intended on slice charts. -- Grand Totals are not shown in the Pivot Grid visualizations. -- Incorrect grand totals values shown when using Analysis Services data provider. -- Dashboard and visualization filters with wrong grand totals when using Analysis Services data provider. -- Field name modifications lost after reordering values on Pivot Grid. -- Error "...hierarchy already appears in the Axis1 axis." in Analysis Services. -- Wrong results when applying 'Top N' filter in Analysis Services. -- Resource based visualization fetches wrong cache entry. -- Wrong cache entry is hit when using blending. -- Can't set focus to search box after the browser goes to background. - -## 1.6.4 (February 14th, 2024) - -### Breaking Changes - -- Property name `showExportToPowerpoint` changed to `showExportToPowerPoint` -- Scatter and Bubble Charts have a new look & feel. The old look & feel are deprecated, if needed they can be restored by doing `RevealSdkSettings.enableNewCharts = false` - -### New Features - -#### All Platforms - -- Exposed `description` property on `RVDashboard` -- Added dashboard title to individual Excel sheets -- Include dashboard filters when exporting to Excel and PDF -- Removed PostgreSQL stored procedures from tab as they're not currently supported - -### Bug Fixes - -#### All Platforms - -- Athena error message not helpful when missing data source item setting -- S3 DS "Region has not been set" error when source item provider is not implemented -- Redshift DS "Host can't be null" error when source item provider is not implemented -- MySql "unable to connect" error when source item provider is not implemented -- Postgres error selecting table when data source item provider is not implemented -- Wrong case-insensitive grid sorting in some scenarios -- FilterChanged event does not fire when changes are made to selected items -- Wrong initialization of "Process Data On Server" flag -- Error on formatting uncaught "TypeError: t.mkFormat is not a function" -- SQLite exceptions cause crash on M1 Mac/ARM64 -- Incorrect `CURRENTTIMEZONE()` when adding fields from another data source -- KPI vs Time Now Showing Empty Values in Current Month -- Malfunction of date type column sorting in grid or pivot type visualizations -- Multiple popups displayed when exporting while visualizations are being loaded -- When exporting an 413 error is thrown -- Multiple instances of RevealView not supported -- Map location name comparison is case sensitive - -#### Java - -- Number rounding is not working for SSRS or CSV data -- MySql setting custom query doesn't work -- Export timing out and producing error - -#### Node - -- Current Chromium version not working in Node + MAC M1 - -## 1.6.3 (January 15th, 2024) - -- Patch release to fix dependency conflict for projects targeting **ASP.NET 7.0**. Updated `System.Security.Cryptography.Pkcs` 6.0.3 => 7.0.0 - -## 1.6.2 (January 5th, 2024) - -### New Features - -#### All Platforms - -- The visualization background color picker was updated to use [Coloris](https://github.com/mdbassit/Coloris). With this enhancement the property `canChangeVisualizationBackgroundColor` has been marked as obsolete because we are now enabling the visibility of background color setting by default. Additionally, the [Spectrum](https://bgrins.github.io/spectrum/) dependency is no longer required. -- The sqlite storage for cache file `tabulardata.sqlite` is now disabled by default to prevent growing without limit -- When `$.ig.RevealSdkSettings.enableActionsOnHoverTooltip` is enabled, the actions tooltip is now available on the Pivot visualization. Hovering on a chart visualization will now show the tooltip when within a certain number of pixels from the data point. -- Support for calculated fields using the following functions on a SQL Server data source with "Process Data on Server" enabled; `fyear`, `and`, `or`, `concatenate`, `replace`, `date`, `time`, `hour`, `minute`, `second`, `formatdate`, and `datevalue`. -- New client event named `onUrlLinkRequested` added to allow for intercepting and modifying URL links in dashboards at runtime - -```javascript -revealView.onUrlLinkRequested = (args) => { - return args.url + "&webUpdated=true&cellValue=" + args.cell.value(); -}; -``` - -- Added ability to export a single visualization using server export. - - - - -```cs -var pdfOptions = new PdfExportOptions(); - -pdfOptions.Visualizations.Add(new VisualizationExport() {Title = "Sales by Product" }); -pdfOptions.Visualizations.Add(new VisualizationExport("9ea0b74d-8944-474c-5e8c-78ce2b30d16c")); - -//or -pdfOptions.Visualizations.AddByTitle("Sales by Product"); -pdfOptions.Visualizations.AddById("9ea0b74d-8944-474c-5e8c-78ce2b30d16c"); - - -await _exporter.ExportToPdf(dashboardId, path + ".pdf", pdfOptions); -``` - - - - - -```java -ArrayList viz = new ArrayList(); - -viz.add(new VisualizationExport("9ea0b74d-8944-474c-5e8c-78ce2b30d16c")); - -VisualizationExport ve = new VisualizationExport(); -ve.setTitle("Sales by Product"); -viz.add(ve); - -PdfExportOptions options = new PdfExportOptions(); -options.setVisualizations(viz); - -RevealEngineLocator.dashboardExporter.exportToPdf(dashboardId, null, options ,new ExportStreamCallback() { - @Override - public void onSuccess(InputStream stream) { - try { - Files.copy(stream, Paths.get(filePath), StandardCopyOption.REPLACE_EXISTING); - asyncResponse.resume(filePath); - } - catch(Exception e) { - asyncResponse.resume(e); - } - } - - @Override - public void onFailure(Exception e) { - asyncResponse.resume(e); - } -}); -``` - - - - - -```javascript -import reveal, { ExportFormat, IDashboardExporter, PdfExportOptions, VisualizationExport } from 'reveal-sdk-node'; - -var options = new PdfExportOptions(); -var ve = new VisualizationExport(); -ve.title = "Spend vs Budget"; - -options.visualizations.push(ve); - -revealServer.exporter.exportPdf("Marketing", fileName, options, null); -``` - - - - - -- Support added for custom colors on client & server export - - - - -```cs -PdfExportOptions options = new PdfExportOptions(); - -options.InitScript = @" - function init(revealView){ - $.ig.RevealSdkSettings.theme = new $.ig.MountainDarkTheme(); - - revealView.refreshTheme(); - - revealView.onVisualizationSeriesColorAssigning = function (visualization, defaultColor, fieldName, categoryName) { - if (categoryName === ""Critical"") { - return ""rgb(0,0,0)""; - } - return defaultColor; - } - }"; - -await _exporter.ExportToPdf(dashboardId, path, options); -``` - - - - - -```java -PdfExportOptions options = new PdfExportOptions(); - -options.setInitScript("function init(revealView){\r\n" - + " $.ig.RevealSdkSettings.theme = new $.ig.MountainDarkTheme(); \r\n" - + "\r\n" - + " revealView.refreshTheme(); \r\n" - + "\r\n" - + " revealView.onVisualizationSeriesColorAssigning = function (visualization, defaultColor, fieldName, categoryName) {\r\n" - + " if (categoryName === \"Critical\") {\r\n" - + " return \"rgb(0,0,0)\";\r\n" - + " }\r\n" - + " return defaultColor;\r\n" - + " }\r\n" - + " }"); - -String filePath = rootFileName + dashboardId + "_stream.pdf"; - -RevealEngineLocator.dashboardExporter.exportToPdf(dashboardId, null, options ,new ExportStreamCallback() { - - @Override - public void onSuccess(InputStream stream) { - //Do something - } - - @Override - public void onFailure(Exception e) { - asyncResponse.resume(e); - } - -}); -``` - - - - - -```javascript -var options = new PdfExportOptions(); -options.initScript = ` -function init(revealView){ - $.ig.RevealSdkSettings.theme = new $.ig.MountainDarkTheme(); - - revealView.refreshTheme(); - - revealView.onVisualizationSeriesColorAssigning = function (visualization, defaultColor, fieldName, categoryName) { - if (categoryName === "Critical") { - return "rgb(0,0,0)"; - } - return defaultColor; - } -}`; - -revealServer.exporter.exportPdf("Cybersecurity_Sample_ManyFilters_Values", "c:\\Temp\\Exports\\export_node.pdf", options, new RVUserContext("someone")); -``` - - - - - -- Added the ability to control edit mode - - `enterEditMode()` - - `exitEditMode(applyChanges: boolean)` - - `onEditModeEntered` - - `onEditModeExited` - -```javascript - - - - -
- - - - - -``` -- Added a `role` property to `RVSnowflakeDataSoure` to allow for accessing different databases for different connections -- Added support for stored procedures in the MySQL connector -- Added a `maxFilterSize` property to `RevealSdkSettings` for controlling the maximum number of values displayed in a dashboard filter - -#### ASP.NET - -- Added support for setting global filters for headless exports - -```cs -PdfExportOptions options = new PdfExportOptions(); -options.DateFilter = new RVDateDashboardFilter(RVDateFilterType.CustomRange, - new RVDateRange(new DateTime(2022,4,1), DateTime.Now) - ); - -options.Filters.Add(new RVDashboardFilter("incident_severity", new List { "Medium", "Critical" })); -options.Filters.Add(new RVDashboardFilter("team", new List { "Digital Security Center"})); - -await _exporter.ExportToPdf(dashboardId, path, options); -``` - -#### ASP.NET & Node - -- Added custom query support for the MongoDB connector -- Added support for data blending (joining) on server for the MongoDB connector -- Added support for ARM64 for ASP.NET and Node on MacOS and Linux - -#### Java - -- JavaScript SDK distributions will no longer be available at https://maven.revealbi.io/repository/public/com/infragistics/reveal/sdk/reveal-sdk-distribution/x.y.z/reveal-sdk-distribution-x.y.z-js.zip. Instead, the location will be https://dl.infragistics.com/reveal/libs/x.y.z/reveal-sdk-distribution-js.zip. -- Added support for setting global filters for headless exports - -```java -PdfExportOptions options = new PdfExportOptions(); - -RVDateDashboardFilter dateFilter = new RVDateDashboardFilter(RVDateFilterType.CUSTOM_RANGE, - new RVDateRange( new GregorianCalendar(2022,4,1), new GregorianCalendar()) - ); - -options.setDateFilter(dateFilter); - -options.getFilters().add(new RVDashboardFilter("incident_severity", new ArrayList(Arrays.asList("Medium", "Critical")))); -``` - -### Bug Fixes - -#### All Platforms - -- Setting `canAddDateFilter` caused an exception -- Redshift filters don't show values besides the 3k limit when using search on select values -- The text "Show Data Labels" is not translated when viewing field settings in the visualization editor -- Pivot grid when using the SSAS connector mixed up rows when sorting -- KPI vs Time - overlapping text when state changes from having data to having no data to display -- Pointer cursor shows when hovering over "add your first visualization" when there is no click event -- Localization issue on server side when client is using another language -- REST connector crashes when no url is provided in client -- Tooltip showing blank hint in the New Calculated Field window -- Data source items should not copy over the data source subtitle -- Grid visualization takes forever to load when there's a lot of data -- Spanish translation for Snowflake host shows "Anfitrion" and it shouldn't -- When configuring `chartTypes` the `AreaChart` doesn't seem to respond to any changes -- Server-side dashboard export problem due to build number appending to version - -#### ASP.NET & Node - -- The MongoDB connector wasn't filtering documents without a field set when filtering by empty fields. - -## 1.6.1 (October 25th, 2023) - -### Breaking Changes - -#### All Platforms - -- Enabling single visualization mode now automatically sets these properties to `false` on the `RevealView`: `showChangeVisualization`, `canEdit`, `showMenu`, `showStatisticalFunctions`, `showFilters`. -- The `window.revealDisableKeyboardManagement` property is now set to `true` by default. When set to `true` tab focus does not stop on the RevealView. -- Slice Charts (pie, funnel, and donut) have a new look & feel. The old L&F is deprecated but if needed, they can be restored by doing `RevealSdkSettings.enableNewCharts = false`. - -### New Features - -#### All Platforms - -- Headless export of a individual visualization -- The `noopener` attribute added to external dashboard links -- The property `VisualizationMargin` was added to `RevealTheme` for changing the margin between visualizations -- Improvements to the single visualization; 1) Dashboard title, and breadcrumb control using the properties `showBreadcrumb` & `showBreadcrumbDashboardTitle`, 2) the property `showTitle` was added to `RVVisualization`, and 3) the properties `RevealView`: `showChangeVisualization`, `canEdit`, `showMenu`, `showStatisticalFunctions`, `showFilters` are automatically set to `false` when enabling single visualization mode -- SQL-based stored procedure output their query to the log and inform of data type mismatches - -#### ASP.NET & Node - -- New Data Source: MongoDB - -### Bug Fixes - -#### All Platforms - -- Postgres extremely slow when loading list of tables when having hundreds of schemas. Schemas are now filtered on the server to improve performance -- The `window.revealDisableKeyboardManagement` property is now set to `true` by default. When set to `true` tab focus does not stop on the RevealView. -- Repeated uses of the chart chooser would cause the app to become non-responsive -- Scatter map not correctly showing values that use decimal places -- Can't filter null values -- RevealView not supporting backup fonts specified in font-family -- Tables and views tabs not visible when using a dark theme -- Choropleth chart displays green color on areas with no data when language is not set to English -- Exception when exiting editor after changing calculated field used with the KPI visualization -- Treemap not visible in PowerPoint and PDF export -- Error dialog when using an image or PDF with an `RVWebResourceDataItem` -- Export options popover doesn't close once an option is selected -- `RVODataDataSource`'s `url` property was being copied over to the `RVODataDataSourceItem` -- Assigning color to series offset colors when "Others" category was visible - -#### Java - -- Headless export not working on Linux - -## 1.6.0 (August 28th, 2023) - -### Breaking Changes - -#### All Platforms -* Changes in license keys: License key is now required, even for trial mode. The SDK will fail to initialize if the license key is missing or invalid. In addition, the license format has changed and the new format is the only one supported. Request your new license key to your sales rep. Trial license keys are available by registering [here](https://www.revealbi.io/download-sdk). -* `availableChartTypes` property has been removed. It's replacement is the 'chartTypes' property described in the 'New Features' section below. -* The dependency to 'libgdiplus' has been removed to enhance our cross-platform performance. -* The SDK no longer depends on Quill.js. - -#### ASP.NET -* Most data sources have been removed from the core package. They're now available as separate packages. Data Source packages are **REQUIRED** to be [registered](/web/datasources#installing-data-sources). The information about the supported data sources and the corresponding add-in nuget packages can be found [here](/web/datasources#supported-data-sources). -* Reveal now requires .net 6.0 or newer. -* Data related objects have been moved into the `Reveal.Sdk.Data` namespace -* Data Source objects (ex: RVSqlServerDataSource) have been moved into their respective namespaces (ex: `Reveal.Sdk.Data.Microsoft.SqlServer`) - -### New Features - -#### All Platforms - -* Ability to add custom visualization as Chart Types in the visualization editor. The new `chartTypes' property allows this, as well as modifying the icon, title and grouping of existing chart types, or making them unavailable: - -``` -//Update existing configuration -var barConfig = revealView.chartTypes.find(x => x.chartType == 'BarChart'); -barConfig.icon = 'https://host:port/images/bar-chart.png'; -barConfig.groups = ["Enterprise Visualizations", "HR", "Category"]; - -//Add pre-configured custom visualization -revealView.chartTypes.push({ - title: "Custom Visualization", - url: "https://host:port/customViz.html", - icon: "https://host:port/icon.png", - groups: ["HR"] - }); - -//Delete Grid configuration -var gridConfig = revealView.chartTypes.find(x => x.chartType == 'Grid'); -revealView.chartTypes.splice(revealView.chartTypes.indexOf(gridConfig), 1); -``` - -* (Beta) Chart actions available while hovering the mouse. Turn on using `$.ig.RevealSdkSettings.enableActionsOnHoverTooltip = true`. -* Calculated fields expression language now support decimals specified without a leading '0' (e.g. '.5' meaning '0.5'). -* Added support in BigQuery data source for the following calculated-fields functions: YEAR, QUARTER, MONTH, DAY, HOUR, MINUTE, SECOND, REPLACE, WEEKDAY, MONTHNAME, MONTHSHORTNAME, EMPTY, RANDBETWEEN. -* Improved Copy & Paste. Now it works across browser tabs / pages refreshes. -* Make the RevealView resize itself when its container is resized. -* Add Stored procedure support to Oracle data source (not yet available in Java). -* Allow joining Athena datasources. - -### Bug Fixes - -#### All Platforms -* Pushing multiple menu items with menuItem action functions calls the last action function. -* Donut chart doesn't show legend for `` values but shows a section for them. -* Export for Pdf is not taking the assigned Theme. -* Unable to click text "X Selected"/"Show All" on a filter. -* Cell background is not full wide on filters for text "X Selected"/"Show All". -* Using custom theme font doesn't affect the KPI visualization. -* "No providerid specified..." error in Oracle data source defined on javascript client. -* The position of the search bar in the data selection view is not reset, in a certain scenario. -* Search table on data source dialog causes error/crash after scrolling tables. -* DefaultRefreshRate of 0 prevents image/pdf web resource from loading. -* Number formatting is not applied in Sparkline. -* Tooltip for gauge does not display number formatting. -* The "NUMERIC" data type in BigQuery isn't properly supported and causes Error. -* BigQuery is missing Quarter aggregation. -* The "MOD" function in BigQuery does not allow you to use two different types of numeric data (e.g. float64 and int64). -* 'Function does not exist' error in postgres when schema is not set in the datasourceItem. -* Statistical functions are not displayed when viewing data as grid. -* Export xlsx for charts visualization is not correct when changing them in reveal sdk. -* Inconsistent checkbox state in when scrolling a large list of data sets in BigQuery add data source screen. -* BigQuery DataSourceItem doesn't work if the project id is set only on the DS. -* When data is obtained from an excel cell that has a custom format that includes any of the letters 'y', 'm', 'd' or 'h' it is always interpreted as date type. -* Treemap does not respect number formatting. -* Number formatting is not displayed in Financial chart tooltip. -* Number formatting is not displayed in the tooltip of the Radial chart. -* Athena and BigQuery don't show the 100k cell limit warning. -* Math function Log stopped working for Athena. - -#### ASP.NET -* Export -both headless and interactive- doesn't work on linux. -* Fix issue when Microsoft.Data.SqlClient >= 5.0.0 is used by a Asp.net project. -* Verify Credentials error on Oracle data source. - -#### Node -* Request headers do not work for RVRESTDataSource when using the NodeSDK. - -#### Java -* Encoding issues in data read from BigQuery if the system's default charset is not UTF-8. -* Getting null IRVUserContext in IRVDataSourceProvider.changeDataSourceItem in createwidget API. - -## 1.5.0 (May 4th, 2023) - -### Breaking Changes -* In some scenarios, the information set in IRVDataSourceProvider was visible to the client and also stored in the dashboard file. That was not a desirable behavior, but it also produced some hard to reproduce issues when editing dashboards. Starting on 1.5.0, the datasource information set in IRVDataSourceProvider does not leave the server. Depending on the specific implementation of IRVDataSourceProvider, this might have a big impact. To make sure your implementation is right, generally speaking, make sure that if you have a non-trivial implementation of ChangeDataSource, then you also implement ChangeDataSourceItem, and that this ChangeDataSourceItem invokes ChangeDataSource on the dataSourceItem.dataSource object. In addition, when working with CSV, Json, Excel files coming from datasources like S3, Rest, etc., please take into account that you might receive a call to ChangeDataSourceItem with the csv/json/excel datasource item, and in that case you must make sure that the dataSourceItem.resourceItem is properly 'changed', which also means invoking ChangeDataSource for dataSourceItem.resourceItem.dataSource. -* IRVDataSourceProvider now requires the implementation of ChangeDataSourceAsync. -* We're no longer releasing an installer for the asp.net SDK. To get started, check the documentation at https://help.revealbi.io/web/getting-started-server/ - -### Bug Fixes - -#### All Platforms -* Headless export: landscape is now the default orientation. -* Fixes and performance improvements for the new category charts -* Setting the Host property in MsSql provider in the IRVDataSourceProvider but not in the client causes error -* Redshift queries fail if the Schema property is not set in the dataSourceItem (should use the default, 'public', schema) -* Financial charts were not working properly -* host property had always a value of null in IRVAuthenticationProvider for RVSqlServerDataSource. -* All database datasources required the Database property to be set in the DataSourceItem (even if it was set in the DataSource). Now the property has been deprecated in the DataSourceItem, and setting it in the Database just works. -* Opening a linked dashboard caused a crash -* Treemap showing Redshift/Postgres data failed -* Error using Standard Deviation aggregation with Redshift or Postgres -* Setting a different Sheet for an Excel datasource using IRVDataSourceProvider didn't work -* Error if clicking in blank space between the title and statistics icon while in Visualization Editor mode. -* Cannot change the title of a new visualization (when it is initialized as a blank title) -* If a JSON attribute name begins with a number the extracted value is always empty -* Data Blending field panels don't scroll with mouse wheel or trackpad -* Unable to move filter when there are 10+ of them in edit mode -* Sybase ds item wrapper with configured custom query property still returns all data -* Replacing Analysis Services data source doesn't work -* Dynamics CRM - NRE is thrown when you try to get data using a data source item -* An exception is thrown when no image is set in DashboardEmptyState -* RVReportingServicesDataSourceItem seems to be missing properties for configuring parameters -* It is not possible to render a pdf report using RVReportingServicesDataSourceItem -* "No Url specified for web resource" error replacing DataSource WebResource URL -* Calls to `IRVDataSourceProvider.ChangeDataSourceItemAsync` always has null for dashboardId argument -* KPI Indicators - "There's no data to display" has wrong style -* Some global filters are being reset when start selecting their options -* Null Reference Exception thrown when using a specific Excel sheet with custom styles. -* MySQL timestamp columns are read as UTC datetimes when they're actually in the session timezone. -* The nuget files contains more dependencies than it should -* Very bad performance on Redshift blending when using a RVRedshiftDataSourceItem -* Error when using InMemory datasource in SDK -* Error in Salesforce visualization when using Lead's ConvertedDate as a filter -* S3 Excel resource item not working after replace DS/DSI scenario (app kept in loading after sheet selection when creating widget) -* The Rest API URL should not be shown in errors -* Change RVDashboard.visualizations type in d.ts to VisualizationsArray - -#### Node -* Several improvements on headless export for the Node.js SDK. Now it is available for Linux/MacOS. - -#### Java -* 'Schema' property for the Snowflake DataSource was being ignored. -* Asset visualization not working when using the java SDK. -* Redshift queries for tables using column of type 'timestamptz' failed if it contained null values. -* MaxDownloadSize limit is being ignored in Java SDK - -## 1.4.0 (Feb-2023) - -### Breaking Changes -* Category Charts have a new look & feel. The old L&F is deprecated but if needed for whatever reason, they're can be restored by doing `revealSdkSettings.enableNewCharts = false`. -* Subtitles for Data Source Items are no longer autogenerated. Only the Subtitle property is considered. - -### New Features - -#### All Platforms -* New API `onFieldsInitializing` that makes it possible to customize the list of fields shown in the visualization editor, by removing, renaming or reordering fields. Usage example: -``` -revealView.onFieldsInitializing = function (args) { - args.fields = args.fields.filter(f => !["Avg.CPC", "Avg. CPC"].some(e => e == f.name)); -}; -``` -* BigQuery, Snowflake and Athena now support the `CustomQuery` property -* Snowflake - Allow setting `Warehouse` property from sdk - -#### Node -* (Beta) Headless Export for node.js SDK. Currently, it only works on the Windows platform. -* `RVHeadersDataSourceCredentials` now available for Node.js SDK. - -### Bug Fixes - -#### All Platforms -* When trying to join a third dataset the app freezes -* Using a RVDashboardDataSource causes a crash when the Id property is not set (Web only) -* Inconsistent time part for dates sent in the range parameter of onDateFilterChanged -* Inconsistent day shown in the global filter range selector, when using 'Today' or 'Yesterday' two different days were displayed. -* Data blending editor doesn't show the field used for joining when that field comes from a previous data blending. -* The Athena DataSourceItem errors out unless you specify the Database property on the Client (Web only) -* RVSnowflakeDataSourceItem Does Not Work - -#### ASP.NET -* Headless export fails if DocumentExportOptions is used. - -#### Java -* "Fail to retrieve row count for first arrow chunk" error in Snowflake (Java only) - -## 1.3.1 (Jan-2023) - -### BREAKING CHANGES - -#### ASP.NET -- The `Reveal.Sdk.Web.AspNetCore.Trial` nuget package has been **deprecated** and is **no longer updated**. -- The new `Reveal.Sdk.AspNetCore` nuget package is now available on [nuget.org](https://www.nuget.org/packages/Reveal.Sdk.AspNetCore), and will work as both a Trial and Licensed version. To unlock the Trial, set the license key in the SDK. -- The license key is now set in the initialization parameters of the Reveal SDK (previously, this was done in the installer). Here's how to set it: - -```cs -services - .AddMvc() - .AddReveal(builder => - { - builder - .AddSettings(settings => - { - settings.License = "XYZ123"; - }); - }); -``` - -#### Node -- Renamed `RVUserNamePasswordDataSourceCredential` to `RVUsernamePasswordDataSourceCredential`. Changed the uppercase "N" to lowercase "n". - -### Bug Fixes - -#### All Platforms -- Several improvements to headless export: - - Improved API. - - Visualization using Maps now show correctly. - - Decreased memory footprint when running. - - Fixed issue where a missing title in the dashboard would make the export fail. -- Fixed issue: when creating a REST datasource using parameters. If the back button was pressed, values were already populated but they were not really applied. -- Fixed issue: Dashboard filter list of available values was always refreshed when opening a dashboard, no matter what expiration setting was set. -- Fixed issue: Dashboard filter expiration value was not saved. -- Fixed issue: Dashboard horizontal filter lost when maximizing and then restoring. -- Fixed issue: the kebab menu in the dashboard view was not reachable using the keyboard (tab). -- Fixed issue: Dashboard linking stops working after selecting a dashboard filter in the linked visualization. -- Fixed issue: Wrong value shown for Scatter Map mouseover tooltip. -- Fixed issue: Cancelling the MenuOpening event didn't really cancel. -- Fixed issue: In ChangeDataSourceItemAsync method, the userContext parameter was coming with null value. - -#### Java -- Fixed issue: "Login failed due to client TLS version..." error when connecting to mssql in Azure. -- Fixed issue: Could not add Google Analytics 4 interactively. - -## 1.3.0 (Nov-2022) - -### New Features -- Export dashboards from the backend: - - - - -```cs -var pdfStream = await dashboardExporter.ExportToPdf(dashboardId); -``` - - - - - -```java -RevealEngineLocator.dashboardExporter.exportToPdf(dashboardId, new ExportStreamCallback() { - @Override - public void onSuccess(InputStream stream) { - // result PDF to be read from the stream parameter - } - @Override - public void onFailure(Exception e) { - // the export failed :( - } -}); -``` - - - - - - -- New Data Source: Google Analytics 4. -- Interactive Dashboard Filtering: Filter all visualizations using the same data source by clicking on a chart or pivot table data point. Enable with: `revealView.interactiveFilteringEnabled = true`. -- Methods containing a callback now include an additional signature allowing for promise method handling: - -```javascript -$.ig.RevealUtility.loadDashboard(dashboardId).then(dashboard => { - revealView.dashboard = dashboard; -}); -``` - -If using async/await: - -```javascript -let dashboard = await $.ig.RevealUtility.loadDashboard(dashboardId); -revealView.dashboard = dashboard; -``` - -- Manually loading of default fonts using the `ensureFontsLoadedAsync` method from `$.ig.revealSdkSettings` is no longer required. -- New function 'DateDiff' for calculated fields. - -### Bug Fixes - -#### All Platforms -- Fix error when filtering boolean values in Postgres & Redshift ("operator does not exist") -- Fix localization not working when the locale contains an hyphen -- Fix for `IRVDataSourceProvider.ChangeDataSourceItem` not invoked when creating a new visualization from a REST data source. -- Removed new http header 'XRID' that was accidentally added in v1.2.3 and was causing issues with CORS. - -#### Java -- sdk-ext: updated commons-text library. -- Fix for very slow response times when processing some Excel files. - - +## 2.0.0 (May 6th, 2026) diff --git a/docs/web/upgrade-guide-v2.0.0.md b/docs/web/upgrade-guide-v2.0.0.md new file mode 100644 index 00000000..b482a9c1 --- /dev/null +++ b/docs/web/upgrade-guide-v2.0.0.md @@ -0,0 +1,49 @@ +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# Upgrading to 2.0.0 + +This guide covers the breaking changes introduced in Reveal SDK 2.0 and the steps required to upgrade an existing 1.x application to 2.0. + +:::note Coming from a version older than 1.8.4? +First follow the [1.x upgrade guides in the 1.8.4 documentation](/1.8.4/web/upgrade-guide-v1.6.0/) to bring your project up to 1.8.4, then return to this page to complete the move to 2.0. +::: + +## Overview of Breaking Changes + + + +## Step-by-Step Upgrade + +### 1. Update package versions + + + +### 2. Update API usage + + + + + + ```csharp + // before + ``` + + + ```csharp + // after + ``` + + + +### 3. Update configuration + + + +## Removed APIs + + + +## Need help? + +If you run into issues during the upgrade, [open an issue](https://github.com/RevealBi/Reveal.Sdk/issues) or reach out via the in-app chat. diff --git a/docusaurus.config.ts b/docusaurus.config.ts index c28c2a22..1aee97eb 100644 --- a/docusaurus.config.ts +++ b/docusaurus.config.ts @@ -6,7 +6,14 @@ import replace from './plugins/remark/replace-variables'; import apiDocs from './plugins/remark/api-docs'; import { chatButtonSettings, searchBarSettings } from './inkeep.config'; -const sdkVersion = "1.8.4"; +// SDK version: exact build referenced by CodePreview's CDN URL — must match a real release. +const sdkVersion = "2.0.0"; +const sdkVersion_v1 = "1.8.4"; + +// Docs version: human-readable label shown in the page version badge ("Version: X"). +// Bump this as the 2.x docs evolve — no need to archive the version. +const docsVersion = "2.0"; +const docsVersion_v1 = "1.8.4"; const config: Config = { title: 'Reveal', @@ -18,9 +25,18 @@ const config: Config = { favicon: 'img/favicon.ico', trailingSlash: true, - // this is used in places like the CodePreview component to load the correct SDK version + // Per-version values exposed to client components. Keyed by docs version id ("current" or the snapshot label). customFields: { sdkVersion: sdkVersion, + sdkVersions: { + current: sdkVersion, + "1.8.4": sdkVersion_v1, + }, + // Used by the swizzled DocVersionBadge to show "Version: " on each page. + docsVersions: { + current: docsVersion, + "1.8.4": docsVersion_v1, + }, }, // GitHub pages deployment config. @@ -59,15 +75,31 @@ const config: Config = { breadcrumbs: false, sidebarPath: './sidebars.ts', editUrl: 'https://github.com/RevealBi/documentation/tree/master/', + lastVersion: 'current', + versions: { + current: { + label: 'Current', + path: '', + }, + '1.8.4': { + label: '1.8.4', + path: '1.8.4', + }, + }, beforeDefaultRemarkPlugins: [ [apiDocs, {}] ], remarkPlugins: [ [npm2yarn, { sync: true }], [replace, { - variables: [ - { name: "sdkVersion", value: sdkVersion } - ] + variablesByVersion: { + current: [ + { name: "sdkVersion", value: sdkVersion } + ], + "1.8.4": [ + { name: "sdkVersion", value: sdkVersion_v1 } + ], + }, }], ], }, @@ -120,6 +152,10 @@ const config: Config = { { label: "Videos", to: "https://www.youtube.com/@RevealBI" } ] }, + { + type: "docsVersionDropdown", + position: "right", + }, { type: "localeDropdown", position: "right" diff --git a/i18n/en/docusaurus-plugin-content-docs/current.json b/i18n/en/docusaurus-plugin-content-docs/current.json index bd5ed2d7..ce73ac0f 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current.json +++ b/i18n/en/docusaurus-plugin-content-docs/current.json @@ -1,6 +1,6 @@ { "version.label": { - "message": "Next", + "message": "Current", "description": "The label for version current" }, "sidebar.webSidebar.doc.Overview": { @@ -223,10 +223,6 @@ "message": "Release Notes", "description": "The label for category 'Release Notes' in sidebar 'webSidebar'" }, - "sidebar.webSidebar.doc.1.6.0 Upgrade Guide": { - "message": "1.6.0 Upgrade Guide", - "description": "The label for the doc item '1.6.0 Upgrade Guide' in sidebar 'webSidebar', linking to the doc web/upgrade-guide-v1.6.0" - }, "sidebar.webSidebar.doc.PostgreSQL": { "message": "PostgreSQL", "description": "The label for the doc item 'PostgreSQL' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/postgres" diff --git a/i18n/ja/docusaurus-plugin-content-docs/current.json b/i18n/ja/docusaurus-plugin-content-docs/current.json index 42ed7b2a..fb4b4f24 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current.json +++ b/i18n/ja/docusaurus-plugin-content-docs/current.json @@ -1,6 +1,6 @@ { "version.label": { - "message": "Next", + "message": "Current", "description": "The label for version current" }, "sidebar.webSidebar.doc.Overview": { @@ -223,10 +223,6 @@ "message": "リリース ノート", "description": "The label for category 'Release Notes' in sidebar 'webSidebar'" }, - "sidebar.webSidebar.doc.1.6.0 Upgrade Guide": { - "message": "1.6.0 アップグレード ガイド", - "description": "The label for the doc item '1.6.0 Upgrade Guide' in sidebar 'webSidebar', linking to the doc web/upgrade-guide-v1.6.0" - }, "sidebar.webSidebar.doc.PostgreSQL": { "message": "PostgreSQL", "description": "The label for the doc item 'PostgreSQL' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/postgres" @@ -539,6 +535,10 @@ "message": "ダッシュボードの読み込み", "description": "The label for the doc item 'Loading Dashboards' in sidebar 'webSidebar', linking to the doc web/web-component-wrappers/reveal-view/loading-dashboards" }, + "sidebar.webSidebar.doc.Accessibility": { + "message": "アクセシビリティ", + "description": "The label for the doc item 'Accessibility' in sidebar 'webSidebar', linking to the doc web/accessibility" + }, "sidebar.webSidebar.doc.Beta Features": { "message": "ベータ機能", "description": "The label for the doc item 'Beta Features' in sidebar 'webSidebar', linking to the doc web/beta-features" diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/web/accessibility.md b/i18n/ja/docusaurus-plugin-content-docs/current/web/accessibility.md new file mode 100644 index 00000000..04104920 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/web/accessibility.md @@ -0,0 +1,38 @@ +# アクセシビリティ + +## キーボード アクセシビリティ + +Reveal SDK は表示モードでキーボード ナビゲーションをサポートしており、マウスを使用せずにダッシュボードを操作できます。すべてのインタラクティブ要素には、フォーカス インジケーターが表示され、論理的なタブ順序に従います。 + +### ダッシュボードのナビゲーション + +ダッシュボードのナビゲーションと操作には、以下のキーボード ショートカットを使用します: + +| キー | 操作 | +|-----|--------| +| **Tab** | 次のインタラクティブ要素にフォーカスを移動する | +| **Shift + Tab** | 前のインタラクティブ要素にフォーカスを移動する | +| **矢印キー** | ダッシュボード上の視覚化間、またはリスト、グリッド、メニュー内を移動する | +| **Enter** | フォーカスされたコントロールをアクティブにする (例: 視覚化を最大化する、選択を確認する、メニューを開く) | +| **Space** | フォーカスされた要素のチェックボックスを切り替える | +| **Escape** | 開いているダイアログ、メニュー、またはポップアップを閉じる | + +### ダッシュボード表示のナビゲーション + +ダッシュボードが表示モードのとき: + +- **矢印キー**を使用して、ダッシュボード上の視覚化間でフォーカスを移動できます。 +- フォーカスされた視覚化で **Enter** を押すと、最大化ボタンにフォーカスが移動します。 + +### リストおよびグリッド コンポーネント + +リスト、ドロップダウン、またはグリッドベースのコンポーネント内にフォーカスがある場合は、**矢印キー**を使用してアイテム間を移動します。**Enter** を押してフォーカスされたアイテムを選択します。 + +### フォーカスの動作 + +- フォーカスがインターフェースを移動する際、常に視覚的に表示されます。 +- キーボード ナビゲーションの順序は、論理的で直感的なシーケンスに従います。 + +### 制限事項 + +視覚化コンポーネント内でのキーボード ナビゲーションは、散布マップ、グリッド、およびスパークラインでのみサポートされています。その他のすべての視覚化タイプでは、キーボードからアクセス可能なのは視覚化ヘッダーのみです。ピボットのサポートは今後のリリースで予定されています。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4.json b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4.json new file mode 100644 index 00000000..a6ed705c --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4.json @@ -0,0 +1,714 @@ +{ + "version.label": { + "message": "1.8.4", + "description": "The label for version 1.8.4" + }, + "sidebar.webSidebar.doc.Overview": { + "message": "概要", + "description": "The label for the doc item 'Overview' in sidebar 'webSidebar', linking to the doc web/overview" + }, + "sidebar.webSidebar.doc.ASP.NET Web API": { + "message": "ASP.NET Web API", + "description": "The label for the doc item 'ASP.NET Web API' in sidebar 'webSidebar', linking to the doc web/getting-started-server" + }, + "sidebar.webSidebar.doc.Node.js": { + "message": "Node.js", + "description": "The label for the doc item 'Node.js' in sidebar 'webSidebar', linking to the doc web/getting-started-server-node" + }, + "sidebar.webSidebar.doc.Node.js - TypeScript": { + "message": "Node.js - TypeScript", + "description": "The label for the doc item 'Node.js - TypeScript' in sidebar 'webSidebar', linking to the doc web/getting-started-server-node-typescript" + }, + "sidebar.webSidebar.doc.Spring Boot - Jersey": { + "message": "Spring Boot - Jersey", + "description": "The label for the doc item 'Spring Boot - Jersey' in sidebar 'webSidebar', linking to the doc web/getting-started-spring-boot-jersey" + }, + "sidebar.webSidebar.doc.Angular": { + "message": "Angular", + "description": "The label for the doc item 'Angular' in sidebar 'webSidebar', linking to the doc web/getting-started-angular" + }, + "sidebar.webSidebar.doc.ASP.NET Core Web App": { + "message": "ASP.NET Core Web App", + "description": "The label for the doc item 'ASP.NET Core Web App' in sidebar 'webSidebar', linking to the doc web/getting-started-aspnet" + }, + "sidebar.webSidebar.doc.HTML/JavaScript": { + "message": "HTML/JavaScript", + "description": "The label for the doc item 'HTML/JavaScript' in sidebar 'webSidebar', linking to the doc web/getting-started-javascript" + }, + "sidebar.webSidebar.doc.React": { + "message": "React", + "description": "The label for the doc item 'React' in sidebar 'webSidebar', linking to the doc web/getting-started-react" + }, + "sidebar.webSidebar.doc.Creating": { + "message": "作成", + "description": "The label for the doc item 'Creating' in sidebar 'webSidebar', linking to the doc web/creating-dashboards" + }, + "sidebar.webSidebar.doc.Loading": { + "message": "読み込み", + "description": "The label for the doc item 'Loading' in sidebar 'webSidebar', linking to the doc web/loading-dashboards" + }, + "sidebar.webSidebar.doc.Filtering": { + "message": "フィルタリング", + "description": "The label for the doc item 'Filtering' in sidebar 'webSidebar', linking to the doc web/filtering-dashboards" + }, + "sidebar.webSidebar.doc.Editing": { + "message": "編集", + "description": "The label for the doc item 'Editing' in sidebar 'webSidebar', linking to the doc web/editing-dashboards" + }, + "sidebar.webSidebar.doc.Saving": { + "message": "保存", + "description": "The label for the doc item 'Saving' in sidebar 'webSidebar', linking to the doc web/saving-dashboards" + }, + "sidebar.webSidebar.doc.Linking": { + "message": "リンク", + "description": "The label for the doc item 'Linking' in sidebar 'webSidebar', linking to the doc web/linking-dashboards" + }, + "sidebar.webSidebar.doc.Exporting": { + "message": "エクスポート", + "description": "The label for the doc item 'Exporting' in sidebar 'webSidebar', linking to the doc web/exporting-dashboards" + }, + "sidebar.webSidebar.doc.Theming": { + "message": "テーマ設定", + "description": "The label for the doc item 'Theming' in sidebar 'webSidebar', linking to the doc web/theming-dashboards" + }, + "sidebar.webSidebar.doc.Excel File": { + "message": "Excel ファイル", + "description": "The label for the doc item 'Excel File' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/excel-file" + }, + "sidebar.webSidebar.doc.In Memory Data": { + "message": "インメモリ データ", + "description": "The label for the doc item 'In Memory Data' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/in-memory-data" + }, + "sidebar.webSidebar.doc.MS SQL Server": { + "message": "MS SQL Server", + "description": "The label for the doc item 'MS SQL Server' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/ms-sql-server" + }, + "sidebar.webSidebar.doc.Authentication": { + "message": "認証", + "description": "The label for the doc item 'Authentication' in sidebar 'webSidebar', linking to the doc web/authentication" + }, + "sidebar.webSidebar.doc.User Context": { + "message": "ユーザー コンテキスト", + "description": "The label for the doc item 'User Context' in sidebar 'webSidebar', linking to the doc web/user-context" + }, + "sidebar.webSidebar.doc.Obfuscate Connection Data": { + "message": "接続データの難読化", + "description": "The label for the doc item 'Obfuscate Connection Data' in sidebar 'webSidebar', linking to the doc web/obfuscate-connection-data" + }, + "sidebar.webSidebar.doc.Maximizing Visualizations": { + "message": "表示形式の最大化", + "description": "The label for the doc item 'Maximizing Visualizations' in sidebar 'webSidebar', linking to the doc web/maximizing-visualizations" + }, + "sidebar.webSidebar.doc.Responding to Click Events": { + "message": "クリック イベントへの応答", + "description": "The label for the doc item 'Responding to Click Events' in sidebar 'webSidebar', linking to the doc web/click-events" + }, + "sidebar.webSidebar.doc.Tooltips": { + "message": "ツールチップ", + "description": "The label for the doc item 'Tooltips' in sidebar 'webSidebar', linking to the doc web/tooltips" + }, + "sidebar.webSidebar.doc.Known Issues": { + "message": "既知の問題", + "description": "The label for the doc item 'Known Issues' in sidebar 'webSidebar', linking to the doc web/known-issues" + }, + "sidebar.webSidebar.doc.Third-Party Software": { + "message": "サードパーティ ソフトウェア", + "description": "The label for the doc item 'Third-Party Software' in sidebar 'webSidebar', linking to the doc web/third-party-software" + }, + "sidebar.webSidebar.doc.Data Limits": { + "message": "データ サイズの制限", + "description": "The label for the doc item 'Data Limits' in sidebar 'webSidebar', linking to the doc web/data-size-limits" + }, + "sidebar.webSidebar.category.General": { + "message": "一般", + "description": "The label for category 'General' in sidebar 'webSidebar'" + }, + "sidebar.webSidebar.category.Working with Data Sources": { + "message": "データ ソースの使用", + "description": "The label for category 'Working with Data Sources' in sidebar 'webSidebar'" + }, + "sidebar.webSidebar.category.Release Information": { + "message": "リリース情報", + "description": "The label for category 'Release Information' in sidebar 'webSidebar'" + }, + "sidebar.webSidebar.category.Getting Started - Server": { + "message": "作業の開始 - サーバー", + "description": "The label for category 'Getting Started - Server' in sidebar 'webSidebar'" + }, + "sidebar.webSidebar.category.Getting Started - Client": { + "message": "作業の開始 - クライアント", + "description": "The label for category 'Getting Started - Client' in sidebar 'webSidebar'" + }, + "sidebar.webSidebar.category.Data Sources": { + "message": "データ ソース", + "description": "The label for category 'Data Sources' in sidebar 'webSidebar'" + }, + "sidebar.webSidebar.category.Using the Reveal View": { + "message": "Reveal ビューの使用", + "description": "The label for category 'Using the Reveal View' in sidebar 'webSidebar'" + }, + "sidebar.webSidebar.category.Visualizations": { + "message": "表示形式", + "description": "The label for category 'Visualizations' in sidebar 'webSidebar'" + }, + "sidebar.webSidebar.category.Installation": { + "message": "インストール", + "description": "The label for category 'Installation' in sidebar 'webSidebar'" + }, + "sidebar.webSidebar.doc.System Requirements": { + "message": "システム要件", + "description": "The label for the doc item 'System Requirements' in sidebar 'webSidebar', linking to the doc web/system-requirements" + }, + "sidebar.webSidebar.doc.Adding a License Key": { + "message": "ライセンス キーの追加", + "description": "The label for the doc item 'Adding a License Key' in sidebar 'webSidebar', linking to the doc web/adding-license-key" + }, + "sidebar.webSidebar.doc.Install Server SDK": { + "message": "Server SDK のインストール", + "description": "The label for the doc item 'Install Server SDK' in sidebar 'webSidebar', linking to the doc web/install-server-sdk" + }, + "sidebar.webSidebar.doc.Install Client SDK": { + "message": "Client SDK のインストール", + "description": "The label for the doc item 'Install Client SDK' in sidebar 'webSidebar', linking to the doc web/install-client-sdk" + }, + "sidebar.webSidebar.category.Getting Started": { + "message": "作業の開始", + "description": "The label for category 'Getting Started' in sidebar 'webSidebar'" + }, + "sidebar.webSidebar.category.Server Export": { + "message": "サーバーのエクスポート", + "description": "The label for category 'Server Export' in sidebar 'webSidebar'" + }, + "sidebar.webSidebar.doc.Logging": { + "message": "ログ", + "description": "The label for the doc item 'Logging' in sidebar 'webSidebar', linking to the doc web/logging" + }, + "sidebar.webSidebar.doc.Configure Export": { + "message": "エクスポートの構成", + "description": "The label for the doc item 'Configure Export' in sidebar 'webSidebar', linking to the doc web/configure-export" + }, + "sidebar.webSidebar.doc.Google Sheets": { + "message": "Google スプレッドシート", + "description": "The label for the doc item 'Google Sheets' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/google-sheets" + }, + "sidebar.webSidebar.doc.Google Big Query": { + "message": "Google Big Query", + "description": "The label for the doc item 'Google Big Query' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/google-big-query" + }, + "sidebar.webSidebar.doc.Amazon S3": { + "message": "Amazon S3", + "description": "The label for the doc item 'Amazon S3' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/amazon-s3" + }, + "sidebar.webSidebar.doc.CSV": { + "message": "CSV", + "description": "The label for the doc item 'CSV' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/csv" + }, + "sidebar.webSidebar.doc.JSON": { + "message": "JSON", + "description": "The label for the doc item 'JSON' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/json" + }, + "sidebar.webSidebar.doc.REST": { + "message": "REST", + "description": "The label for the doc item 'REST' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/rest" + }, + "sidebar.webSidebar.doc.Amazon Athena": { + "message": "Amazon Athena", + "description": "The label for the doc item 'Amazon Athena' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/amazon-athena" + }, + "sidebar.webSidebar.doc.Chart Types": { + "message": "チャート タイプ", + "description": "The label for the doc item 'Chart Types' in sidebar 'webSidebar', linking to the doc web/chart-types" + }, + "sidebar.webSidebar.category.Release Notes": { + "message": "リリース ノート", + "description": "The label for category 'Release Notes' in sidebar 'webSidebar'" + }, + "sidebar.webSidebar.doc.1.6.0 Upgrade Guide": { + "message": "1.6.0 アップグレード ガイド", + "description": "The label for the doc item '1.6.0 Upgrade Guide' in sidebar 'webSidebar', linking to the doc web/upgrade-guide-v1.6.0" + }, + "sidebar.webSidebar.doc.PostgreSQL": { + "message": "PostgreSQL", + "description": "The label for the doc item 'PostgreSQL' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/postgres" + }, + "sidebar.webSidebar.doc.MongoDB": { + "message": "MongoDB", + "description": "The label for the doc item 'MongoDB' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/mongodb" + }, + "sidebar.webSidebar.doc.Snowflake": { + "message": "Snowflake", + "description": "The label for the doc item 'Snowflake' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/snowflake" + }, + "sidebar.webSidebar.doc.MySQL": { + "message": "MySQL", + "description": "The label for the doc item 'MySQL' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/mysql" + }, + "sidebar.webSidebar.doc.MariaDB": { + "message": "MariaDB", + "description": "The label for the doc item 'MariaDB' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/mariadb" + }, + "sidebar.webSidebar.doc.Custom Queries": { + "message": "カスタム クエリ", + "description": "The label for the doc item 'Custom Queries' in sidebar 'webSidebar', linking to the doc web/custom-queries" + }, + "sidebar.webSidebar.doc.Oracle": { + "message": "Oracle", + "description": "The label for the doc item 'Oracle' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/oracle" + }, + "sidebar.webSidebar.doc.Caching": { + "message": "キャッシュ", + "description": "The label for the doc item 'Caching' in sidebar 'webSidebar', linking to the doc web/caching" + }, + "sidebar.webSidebar.doc.Custom Menu Items": { + "message": "カスタム メニュー項目", + "description": "The label for the doc item 'Custom Menu Items' in sidebar 'webSidebar', linking to the doc web/custom-menu-items" + }, + "sidebar.webSidebar.doc.Localizing": { + "message": "ローカライズ", + "description": "The label for the doc item 'Localizing' in sidebar 'webSidebar', linking to the doc web/localizing" + }, + "sidebar.webSidebar.doc.Customizing Map Tiles": { + "message": "マップ タイルのカスタマイズ", + "description": "The label for the doc item 'Customizing Map Tiles' in sidebar 'webSidebar', linking to the doc web/customizing-map-tiles" + }, + "sidebar.webSidebar.doc.Custom Visualizations": { + "message": "カスタム表示形式", + "description": "The label for the doc item 'Custom Visualizations' in sidebar 'webSidebar', linking to the doc web/custom-visualizations" + }, + "sidebar.userSideBar.category.Dashboards": { + "message": "ダッシュボード", + "description": "The label for category 'Dashboards' in sidebar 'userSideBar'" + }, + "sidebar.userSideBar.category.Exporting": { + "message": "エクスポート", + "description": "The label for category 'Exporting' in sidebar 'userSideBar'" + }, + "sidebar.userSideBar.category.Visualizations": { + "message": "表示形式", + "description": "The label for category 'Visualizations' in sidebar 'userSideBar'" + }, + "sidebar.userSideBar.category.Chart Types": { + "message": "チャート タイプ", + "description": "The label for category 'Chart Types' in sidebar 'userSideBar'" + }, + "sidebar.userSideBar.category.Choropleth ": { + "message": "階級区分図", + "description": "The label for category 'Choropleth ' in sidebar 'userSideBar'" + }, + "sidebar.userSideBar.category.Fields ": { + "message": "フィールド", + "description": "The label for category 'Fields ' in sidebar 'userSideBar'" + }, + "sidebar.userSideBar.category.Calculated Fields ": { + "message": "計算フィールド", + "description": "The label for category 'Calculated Fields ' in sidebar 'userSideBar'" + }, + "sidebar.userSideBar.category.Filters": { + "message": "フィルター", + "description": "The label for category 'Filters' in sidebar 'userSideBar'" + }, + "sidebar.userSideBar.category.Tutorials": { + "message": "チュートリアル", + "description": "The label for category 'Tutorials' in sidebar 'userSideBar'" + }, + "sidebar.userSideBar.doc.Exporting to PDF": { + "message": "PDF へのエクスポート", + "description": "The label for the doc item 'Exporting to PDF' in sidebar 'userSideBar', linking to the doc user/dashboard-export-pdf" + }, + "sidebar.userSideBar.doc.Exporting to Excel": { + "message": "Excel へのエクスポート", + "description": "The label for the doc item 'Exporting to Excel' in sidebar 'userSideBar', linking to the doc user/dashboard-export-excel" + }, + "sidebar.userSideBar.doc.Exporting to Image": { + "message": "画像へのエクスポート", + "description": "The label for the doc item 'Exporting to Image' in sidebar 'userSideBar', linking to the doc user/dashboard-export-image" + }, + "sidebar.userSideBar.doc.Exporting to PowerPoint": { + "message": "PowerPoint へのエクスポート", + "description": "The label for the doc item 'Exporting to PowerPoint' in sidebar 'userSideBar', linking to the doc user/dashboard-export-powerpoint" + }, + "sidebar.userSideBar.doc.Linking": { + "message": "リンク", + "description": "The label for the doc item 'Linking' in sidebar 'userSideBar', linking to the doc user/dashboard-linking" + }, + "sidebar.userSideBar.doc.Visualization Editor": { + "message": "表示形式エディター", + "description": "The label for the doc item 'Visualization Editor' in sidebar 'userSideBar', linking to the doc user/visualization-editor" + }, + "sidebar.userSideBar.doc.Category": { + "message": "カテゴリ", + "description": "The label for the doc item 'Category' in sidebar 'userSideBar', linking to the doc user/chart-types/category-charts" + }, + "sidebar.userSideBar.doc.Location Data": { + "message": "場所データ", + "description": "The label for the doc item 'Location Data' in sidebar 'userSideBar', linking to the doc user/chart-types/location-data-requirements" + }, + "sidebar.userSideBar.doc.Settings": { + "message": "設定", + "description": "The label for the doc item 'Settings' in sidebar 'userSideBar', linking to the doc user/chart-types/settings-choropleth-map" + }, + "sidebar.userSideBar.doc.Combo": { + "message": "複合", + "description": "The label for the doc item 'Combo' in sidebar 'userSideBar', linking to the doc user/chart-types/combo-charts" + }, + "sidebar.userSideBar.doc.Financial": { + "message": "財務", + "description": "The label for the doc item 'Financial' in sidebar 'userSideBar', linking to the doc user/chart-types/financial-charts" + }, + "sidebar.userSideBar.doc.Gauges": { + "message": "ゲージ", + "description": "The label for the doc item 'Gauges' in sidebar 'userSideBar', linking to the doc user/chart-types/gauge-charts" + }, + "sidebar.userSideBar.doc.Grid": { + "message": "グリッド", + "description": "The label for the doc item 'Grid' in sidebar 'userSideBar', linking to the doc user/chart-types/grid-chart" + }, + "sidebar.userSideBar.doc.Image": { + "message": "画像", + "description": "The label for the doc item 'Image' in sidebar 'userSideBar', linking to the doc user/chart-types/image-chart" + }, + "sidebar.userSideBar.doc.KPI": { + "message": "KPI", + "description": "The label for the doc item 'KPI' in sidebar 'userSideBar', linking to the doc user/chart-types/kpi-gauge" + }, + "sidebar.userSideBar.doc.Pivot": { + "message": "ピボット", + "description": "The label for the doc item 'Pivot' in sidebar 'userSideBar', linking to the doc user/chart-types/pivot-table" + }, + "sidebar.userSideBar.doc.Radial": { + "message": "ラジアル", + "description": "The label for the doc item 'Radial' in sidebar 'userSideBar', linking to the doc user/chart-types/radial-charts" + }, + "sidebar.userSideBar.doc.Scatter and Bubble": { + "message": "散布図・バブル", + "description": "The label for the doc item 'Scatter and Bubble' in sidebar 'userSideBar', linking to the doc user/chart-types/scatter-bubble-charts" + }, + "sidebar.userSideBar.doc.Scatter Map": { + "message": "散布マップ", + "description": "The label for the doc item 'Scatter Map' in sidebar 'userSideBar', linking to the doc user/chart-types/scatter-map" + }, + "sidebar.userSideBar.doc.Sparkline": { + "message": "スパークライン", + "description": "The label for the doc item 'Sparkline' in sidebar 'userSideBar', linking to the doc user/chart-types/sparkline-charts" + }, + "sidebar.userSideBar.doc.Text Box": { + "message": "テキスト ボックス", + "description": "The label for the doc item 'Text Box' in sidebar 'userSideBar', linking to the doc user/chart-types/text-box" + }, + "sidebar.userSideBar.doc.Text View": { + "message": "テキスト ビュー", + "description": "The label for the doc item 'Text View' in sidebar 'userSideBar', linking to the doc user/chart-types/text-view" + }, + "sidebar.userSideBar.doc.Time Series": { + "message": "時系列", + "description": "The label for the doc item 'Time Series' in sidebar 'userSideBar', linking to the doc user/chart-types/time-series-charts" + }, + "sidebar.userSideBar.doc.Tree Map": { + "message": "ツリー マップ", + "description": "The label for the doc item 'Tree Map' in sidebar 'userSideBar', linking to the doc user/chart-types/treemap-charts" + }, + "sidebar.userSideBar.doc.Field Settings": { + "message": "フィールド設定", + "description": "The label for the doc item 'Field Settings' in sidebar 'userSideBar', linking to the doc user/fields/field-settings" + }, + "sidebar.userSideBar.doc.Sort by Field": { + "message": "並べ替えフィールド", + "description": "The label for the doc item 'Sort by Field' in sidebar 'userSideBar', linking to the doc user/fields/sort-by-field" + }, + "sidebar.userSideBar.doc.Ad-Hoc Hierarchies": { + "message": "アドホック階層", + "description": "The label for the doc item 'Ad-Hoc Hierarchies' in sidebar 'userSideBar', linking to the doc user/fields/adhoc-hierarchies" + }, + "sidebar.userSideBar.doc.Conditional Formatting": { + "message": "条件付き書式", + "description": "The label for the doc item 'Conditional Formatting' in sidebar 'userSideBar', linking to the doc user/fields/conditional-formatting" + }, + "sidebar.userSideBar.doc.Field Filters and Rules": { + "message": "フィールド フィルターとルール", + "description": "The label for the doc item 'Field Filters and Rules' in sidebar 'userSideBar', linking to the doc user/fields/field-filters-rules" + }, + "sidebar.userSideBar.doc.Aggregation": { + "message": "集計", + "description": "The label for the doc item 'Aggregation' in sidebar 'userSideBar', linking to the doc user/fields/calculated/aggregation" + }, + "sidebar.userSideBar.doc.Date": { + "message": "日付", + "description": "The label for the doc item 'Date' in sidebar 'userSideBar', linking to the doc user/fields/calculated/date" + }, + "sidebar.userSideBar.doc.Information": { + "message": "情報", + "description": "The label for the doc item 'Information' in sidebar 'userSideBar', linking to the doc user/fields/calculated/information" + }, + "sidebar.userSideBar.doc.Logic": { + "message": "論理", + "description": "The label for the doc item 'Logic' in sidebar 'userSideBar', linking to the doc user/fields/calculated/logic" + }, + "sidebar.userSideBar.doc.Lookup & Reference": { + "message": "検索/行列", + "description": "The label for the doc item 'Lookup & Reference' in sidebar 'userSideBar', linking to the doc user/fields/calculated/lookup-reference" + }, + "sidebar.userSideBar.doc.Math": { + "message": "数学", + "description": "The label for the doc item 'Math' in sidebar 'userSideBar', linking to the doc user/fields/calculated/math" + }, + "sidebar.userSideBar.doc.String": { + "message": "文字列", + "description": "The label for the doc item 'String' in sidebar 'userSideBar', linking to the doc user/fields/calculated/string" + }, + "sidebar.userSideBar.doc.Samples and Tips": { + "message": "サンプルとヒント", + "description": "The label for the doc item 'Samples and Tips' in sidebar 'userSideBar', linking to the doc user/fields/calculated/samples" + }, + "sidebar.userSideBar.doc.Reusing Visualizations": { + "message": "表示形式の再利用", + "description": "The label for the doc item 'Reusing Visualizations' in sidebar 'userSideBar', linking to the doc user/reusing-visualizations" + }, + "sidebar.userSideBar.doc.Statistical Functions": { + "message": "統計関数", + "description": "The label for the doc item 'Statistical Functions' in sidebar 'userSideBar', linking to the doc user/statistical-functions" + }, + "sidebar.userSideBar.doc.Dashboard Filters": { + "message": "ダッシュボード フィルター", + "description": "The label for the doc item 'Dashboard Filters' in sidebar 'userSideBar', linking to the doc user/filters-dashboard" + }, + "sidebar.userSideBar.doc.Dashboard Filter Properties": { + "message": "ダッシュボード フィルターのプロパティ", + "description": "The label for the doc item 'Dashboard Filter Properties' in sidebar 'userSideBar', linking to the doc user/filters-dashboard-properties" + }, + "sidebar.userSideBar.doc.Connecting Filters": { + "message": "フィルターの接続", + "description": "The label for the doc item 'Connecting Filters' in sidebar 'userSideBar', linking to the doc user/filters-connecting" + }, + "sidebar.userSideBar.doc.Date Range Filter": { + "message": "日付範囲フィルター", + "description": "The label for the doc item 'Date Range Filter' in sidebar 'userSideBar', linking to the doc user/filters-date-range" + }, + "sidebar.userSideBar.doc.Visualization Filters": { + "message": "表示形式のフィルター", + "description": "The label for the doc item 'Visualization Filters' in sidebar 'userSideBar', linking to the doc user/filters-visualization" + }, + "sidebar.userSideBar.doc.Candlestick Charts": { + "message": "ローソク足表示形式", + "description": "The label for the doc item 'Candlestick Charts' in sidebar 'userSideBar', linking to the doc user/tutorials-candlestick" + }, + "sidebar.userSideBar.doc.Gauge Charts": { + "message": "ゲージ チャート", + "description": "The label for the doc item 'Gauge Charts' in sidebar 'userSideBar', linking to the doc user/tutorials-gauge" + }, + "sidebar.userSideBar.doc.Image Charts": { + "message": "画像チャート", + "description": "The label for the doc item 'Image Charts' in sidebar 'userSideBar', linking to the doc user/tutorials-image" + }, + "sidebar.userSideBar.doc.KPI Gauges": { + "message": "KPI チャート", + "description": "The label for the doc item 'KPI Gauges' in sidebar 'userSideBar', linking to the doc user/tutorials-kpi-gauge" + }, + "sidebar.userSideBar.doc.OHLC Charts": { + "message": "OHLC チャート", + "description": "The label for the doc item 'OHLC Charts' in sidebar 'userSideBar', linking to the doc user/tutorials-ohlc" + }, + "sidebar.userSideBar.doc.Simple-Series Charts": { + "message": "シンプル シリーズ チャート", + "description": "The label for the doc item 'Simple-Series Charts' in sidebar 'userSideBar', linking to the doc user/tutorials-simple-charts" + }, + "sidebar.userSideBar.doc.Sparkline Charts": { + "message": "スパークライン チャート", + "description": "The label for the doc item 'Sparkline Charts' in sidebar 'userSideBar', linking to the doc user/tutorials-sparkline-charts" + }, + "sidebar.userSideBar.doc.Stacked Charts": { + "message": "積層型チャート", + "description": "The label for the doc item 'Stacked Charts' in sidebar 'userSideBar', linking to the doc user/tutorials-stacked-charts" + }, + "sidebar.webSidebar.category.Web Component Wrappers": { + "message": "Web Component ラッパー", + "description": "The label for category 'Web Component Wrappers' in sidebar 'webSidebar'" + }, + "sidebar.webSidebar.category.Reveal View": { + "message": "Reveal ビュー", + "description": "The label for category 'Reveal View' in sidebar 'webSidebar'" + }, + "sidebar.webSidebar.category.Vizualization Viewer": { + "message": "表示形式ビューアー", + "description": "The label for category 'Vizualization Viewer' in sidebar 'webSidebar'" + }, + "sidebar.webSidebar.doc.NestJS": { + "message": "NestJS", + "description": "The label for the doc item 'NestJS' in sidebar 'webSidebar', linking to the doc web/getting-started-server-nest" + }, + "sidebar.webSidebar.doc.Loading Dashboards": { + "message": "ダッシュボードの読み込み", + "description": "The label for the doc item 'Loading Dashboards' in sidebar 'webSidebar', linking to the doc web/web-component-wrappers/reveal-view/loading-dashboards" + }, + "sidebar.webSidebar.doc.Beta Features": { + "message": "ベータ機能", + "description": "The label for the doc item 'Beta Features' in sidebar 'webSidebar', linking to the doc web/beta-features" + }, + "sidebar.webSidebar.doc.Databricks": { + "message": "Databricks", + "description": "The label for the doc item 'Databricks' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/databricks" + }, + "sidebar.webSidebar.doc.Elasticsearch": { + "message": "Elasticsearch", + "description": "The label for the doc item 'Elasticsearch' in sidebar 'webSidebar', linking to the doc web/adding-data-sources/elasticsearch" + }, + "sidebar.webSidebar.category.web-component-wrappers-installation": { + "message": "Installation", + "description": "The label for category 'Installation' in sidebar 'webSidebar'" + }, + "sidebar.webSidebar.doc.web-component-wrappers-overview": { + "message": "Overview", + "description": "The label for the doc item 'Overview' in sidebar 'webSidebar', linking to the doc web/web-component-wrappers/index" + }, + "sidebar.webSidebar.doc.web-component-wrappers-installation-angular": { + "message": "Angular", + "description": "The label for the doc item 'Angular' in sidebar 'webSidebar', linking to the doc web/web-component-wrappers/installation-angular" + }, + "sidebar.webSidebar.doc.web-component-wrappers-installation-react": { + "message": "React", + "description": "The label for the doc item 'React' in sidebar 'webSidebar', linking to the doc web/web-component-wrappers/installation-react" + }, + "sidebar.webSidebar.doc.web-component-wrappers-reveal-view-options": { + "message": "Options", + "description": "The label for the doc item 'Options' in sidebar 'webSidebar', linking to the doc web/web-component-wrappers/reveal-view/options" + }, + "sidebar.webSidebar.doc.web-component-wrappers-visualization-viewer-options": { + "message": "Options", + "description": "The label for the doc item 'Options' in sidebar 'webSidebar', linking to the doc web/web-component-wrappers/visualization-viewer/options" + }, + "sidebar.userSideBar.doc.user-visualizations-overview": { + "message": "Overview", + "description": "The label for the doc item 'Overview' in sidebar 'userSideBar', linking to the doc user/visualizations-overview" + }, + "sidebar.userSideBar.doc.user-filters-overview": { + "message": "Overview", + "description": "The label for the doc item 'Overview' in sidebar 'userSideBar', linking to the doc user/filters-overview" + }, + "sidebar.userSideBar.doc.user-tutorials-overview": { + "message": "Overview", + "description": "The label for the doc item 'Overview' in sidebar 'userSideBar', linking to the doc user/tutorials-overview" + }, + "sidebar.userSideBar.doc.user-tutorials-text-view": { + "message": "Text View", + "description": "The label for the doc item 'Text View' in sidebar 'userSideBar', linking to the doc user/tutorials-text-view" + }, + "sidebar.aiSidebar.category.ai-getting-started-header": { + "message": "はじめに", + "description": "The label for category 'Getting Started' in sidebar 'aiSidebar'" + }, + "sidebar.aiSidebar.category.Installation": { + "message": "インストール", + "description": "The label for category 'Installation' in sidebar 'aiSidebar'" + }, + "sidebar.aiSidebar.category.Metadata": { + "message": "メタデータ", + "description": "The label for category 'Metadata' in sidebar 'aiSidebar'" + }, + "sidebar.aiSidebar.category.Using the SDK": { + "message": "SDK の使い方", + "description": "The label for category 'Using the SDK' in sidebar 'aiSidebar'" + }, + "sidebar.aiSidebar.category.API Reference": { + "message": "API リファレンス", + "description": "The label for category 'API Reference' in sidebar 'aiSidebar'" + }, + "sidebar.aiSidebar.category.Guides": { + "message": "ガイド", + "description": "The label for category 'Guides' in sidebar 'aiSidebar'" + }, + "sidebar.aiSidebar.doc.Overview": { + "message": "概要", + "description": "The label for the doc item 'Overview' in sidebar 'aiSidebar', linking to the doc ai/overview" + }, + "sidebar.aiSidebar.doc.System Requirements": { + "message": "システム要件", + "description": "The label for the doc item 'System Requirements' in sidebar 'aiSidebar', linking to the doc ai/system-requirements" + }, + "sidebar.aiSidebar.doc.Install Server SDK": { + "message": "サーバー SDK のインストール", + "description": "The label for the doc item 'Install Server SDK' in sidebar 'aiSidebar', linking to the doc ai/install-server-sdk" + }, + "sidebar.aiSidebar.doc.Install Client SDK": { + "message": "クライアント SDK のインストール", + "description": "The label for the doc item 'Install Client SDK' in sidebar 'aiSidebar', linking to the doc ai/install-client-sdk" + }, + "sidebar.aiSidebar.doc.Getting Started - HTML/JS": { + "message": "はじめに - HTML/JS", + "description": "The label for the doc item 'Getting Started - HTML/JS' in sidebar 'aiSidebar', linking to the doc ai/getting-started-html" + }, + "sidebar.aiSidebar.doc.Metadata Catalog": { + "message": "メタデータカタログ", + "description": "The label for the doc item 'Metadata Catalog' in sidebar 'aiSidebar', linking to the doc ai/metadata-catalog" + }, + "sidebar.aiSidebar.doc.ai-sdk-overview": { + "message": "概要", + "description": "The label for the doc item 'Overview' in sidebar 'aiSidebar', linking to the doc ai/sdk-overview" + }, + "sidebar.aiSidebar.doc.Insights": { + "message": "インサイト", + "description": "The label for the doc item 'Insights' in sidebar 'aiSidebar', linking to the doc ai/sdk-insights" + }, + "sidebar.aiSidebar.doc.Chat": { + "message": "チャット", + "description": "The label for the doc item 'Chat' in sidebar 'aiSidebar', linking to the doc ai/sdk-chat" + }, + "sidebar.aiSidebar.doc.Streaming Responses": { + "message": "ストリーミングレスポンス", + "description": "The label for the doc item 'Streaming Responses' in sidebar 'aiSidebar', linking to the doc ai/sdk-streaming" + }, + "sidebar.aiSidebar.doc.Error Handling": { + "message": "エラーハンドリング", + "description": "The label for the doc item 'Error Handling' in sidebar 'aiSidebar', linking to the doc ai/sdk-error-handling" + }, + "sidebar.aiSidebar.doc.Insights Endpoint": { + "message": "インサイトエンドポイント", + "description": "The label for the doc item 'Insights Endpoint' in sidebar 'aiSidebar', linking to the doc ai/insights" + }, + "sidebar.aiSidebar.doc.Chat Endpoint": { + "message": "チャットエンドポイント", + "description": "The label for the doc item 'Chat Endpoint' in sidebar 'aiSidebar', linking to the doc ai/chat" + }, + "sidebar.aiSidebar.doc.Insights with Context Menus": { + "message": "コンテキストメニューによるインサイト", + "description": "The label for the doc item 'Insights with Context Menus' in sidebar 'aiSidebar', linking to the doc ai/guide-insights-context-menus" + }, + "sidebar.aiSidebar.doc.Building a Chat Interface": { + "message": "チャットインターフェースの構築", + "description": "The label for the doc item 'Building a Chat Interface' in sidebar 'aiSidebar', linking to the doc ai/guide-chat-interface" + }, + "sidebar.aiSidebar.doc.Streaming Markdown Display": { + "message": "ストリーミング Markdown 表示", + "description": "The label for the doc item 'Streaming Markdown Display' in sidebar 'aiSidebar', linking to the doc ai/guide-streaming-display" + }, + "sidebar.aiSidebar.category.Providers": { + "message": "Providers", + "description": "The label for category 'Providers' in sidebar 'aiSidebar'" + }, + "sidebar.aiSidebar.doc.ai-providers-overview": { + "message": "Overview", + "description": "The label for the doc item 'Overview' in sidebar 'aiSidebar', linking to the doc ai/providers-overview" + }, + "sidebar.aiSidebar.doc.OpenAI": { + "message": "OpenAI", + "description": "The label for the doc item 'OpenAI' in sidebar 'aiSidebar', linking to the doc ai/providers-openai" + }, + "sidebar.aiSidebar.doc.Azure OpenAI": { + "message": "Azure OpenAI", + "description": "The label for the doc item 'Azure OpenAI' in sidebar 'aiSidebar', linking to the doc ai/providers-azure-openai" + }, + "sidebar.aiSidebar.doc.Anthropic": { + "message": "Anthropic", + "description": "The label for the doc item 'Anthropic' in sidebar 'aiSidebar', linking to the doc ai/providers-anthropic" + }, + "sidebar.aiSidebar.doc.Google Gemini": { + "message": "Google Gemini", + "description": "The label for the doc item 'Google Gemini' in sidebar 'aiSidebar', linking to the doc ai/providers-google-gemini" + }, + "sidebar.aiSidebar.doc.Custom Endpoints": { + "message": "Custom Endpoints", + "description": "The label for the doc item 'Custom Endpoints' in sidebar 'aiSidebar', linking to the doc ai/providers-custom-endpoints" + }, + "sidebar.aiSidebar.doc.Building a Custom Provider": { + "message": "Building a Custom Provider", + "description": "The label for the doc item 'Building a Custom Provider' in sidebar 'aiSidebar', linking to the doc ai/providers-building-custom" + } +} diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/chat.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/chat.md new file mode 100644 index 00000000..b0bcf435 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/chat.md @@ -0,0 +1,213 @@ +--- +sidebar_label: チャットエンドポイント +--- + + +# チャットエンドポイント + +AI チャットはデータ分析を会話に変換します。ダッシュボードを手動で作成したりクエリを記述したりする代わりに、ユーザーは見たいものや理解したいことを説明するだけです。AI がリクエストを解釈し、データを処理し、インサイトや説明を返したり、ダッシュボードを自動的に生成・修正したりします（現在のユーザーメッセージと会話履歴の両方に基づきます）。 + +### 主な機能 + +**自然言語によるダッシュボード生成** +必要なものを説明してダッシュボードを作成します：「Q4の地域別売上を表示して」や「カテゴリ別の収益を比較するチャートを作成して」など。 + +**ダッシュボードの編集** +既存のダッシュボードを会話形式で修正します：「日付範囲のフィルターを追加して」や「円グラフを棒グラフに変更して」など。 + +**データ分析** +データについて質問します：「収益上位5社の顧客は？」や「顧客満足度スコアのトレンドを表示して」など。 + +**会話コンテキスト** +AI は会話履歴を保持し、フォローアップの質問や改善を可能にします：「それを月別に分解して」や「テクノロジーカテゴリだけにフィルターして」など。 + +--- + +## エンドポイント + +**メッセージ送信** +``` +POST /api/reveal/ai/chat +``` + +**セッションクリア** +``` +DELETE /api/reveal/ai/chat/session +``` + +## リクエスト形式 + +```typescript +{ + // Required + datasourceId: string, // Datasource identifier for context + + // Message (one required) + message?: string, // Natural language message/request + + // Optional context + dashboard?: string, // Dashboard JSON for editing/analysis + visualizationId?: string, // Visualization ID for visualization-specific operations + + // Optional configuration + model?: string, // LLM model override + stream?: boolean // Return SSE stream instead of JSON (default: false) +} +``` + +### リクエストパラメーター + +| パラメーター | 型 | 必須 | 説明 | +|-----------|------|----------|-------------| +| `datasourceId` | string | はい | クエリ対象のデータソースの識別子 | +| `message` | string | 条件付き* | ユーザーの自然言語メッセージまたはリクエスト | +| `dashboard` | string | いいえ | 編集または分析コンテキスト用のダッシュボード JSON（RDash 形式） | +| `visualizationId` | string | いいえ | ビジュアライゼーション固有の操作のためのビジュアライゼーション識別子 | +| `model` | string | いいえ | このリクエストに使用する特定の LLM モデル名 | +| `stream` | boolean | いいえ | `true` の場合、プログレスイベント、テキストチャンク、最終完了イベントを含む `text/event-stream`（SSE）レスポンスを返します。`false`（デフォルト）の場合、プレーンな `application/json` レスポンスを返します。 | + +\* `message` または `intent` のいずれかを指定する必要があります + +**パラメーターの詳細:** + +- **`datasourceId`**: すべてのリクエストで必須です。利用可能なデータ構造に関するコンテキストを提供します。 +- **`dashboard`**: 既存のダッシュボードを編集する場合やダッシュボードの内容を分析する場合に指定します。 + +## レスポンス形式 + +### 非ストリーミング（デフォルト） + +`stream` が `false` または省略された場合、エンドポイントはプレーンな JSON レスポンスを返します： + +```json +{ + "explanation": "Based on your data, I've created a dashboard showing sales by region...", + "dashboard": "{...rdash JSON...}" +} +``` + +エラー時は、適切な HTTP ステータスコード（400 または 500）とともにエラーメッセージを含むレスポンスが返されます： + +```json +{ + "error": "Error message" +} +``` + +### ストリーミング + +`stream` が `true` の場合、エンドポイントは以下のイベントタイプを持つ Server-Sent Events（SSE）を返します： + +#### progress イベント +処理中に現在のステータスを示すために送信されます。 + +```json +event: progress +data: {"message": "Creating a new dashboard"} +``` + +一般的なプログレスメッセージ： +- "Creating a new dashboard" +- "Analyzing the current dashboard" +- "Adding filters to visualizations" +- "Modifying visualization" + +#### text イベント +生成された説明テキストのフラグメントを含みます。 + +```json +event: text +data: {"content": "Based on your data, I've created"} +``` + +テキストチャンクは約8語のセグメントで、20ms の遅延で配信され、ChatGPT のような自然なストリーミングを実現します。 + +#### complete イベント +処理が正常に完了したときに送信されます。常に完全な結果を含みます。 + +```json +event: complete +data: { + "message": "Chat processed successfully", + "result": { + "explanation": "Based on your data, I've created a dashboard showing sales by region...", + "dashboard": "{...rdash JSON...}" + } +} +``` + +**結果の構造:** +- `explanation`: 実行された内容の自然言語による説明 +- `dashboard`: 生成または修正されたダッシュボード JSON（該当する場合） + +#### error イベント +処理が失敗した場合に送信されます。 + +```json +event: error +data: {"error": "Datasource not found"} +``` + +## 会話履歴 + +チャットはユーザーおよびデータソースごとにサーバー側の会話履歴を保持します。これにより、コンテキストに基づいたフォローアップの質問や反復的な改善が可能になります。 + +**履歴の仕組み:** + +1. **ユーザーごとのセッション**: 各ユーザーはデータソースごとに個別の会話セッションを取得します +2. **自動コンテキスト**: 以前の質問と回答は、新しいリクエストのコンテキストとして自動的に含まれます +3. **永続的な状態**: 履歴は明示的にクリアされるまで複数のリクエストにわたって保持されます +4. **プロンプト内のコンテキスト**: 完全な会話履歴が LLM に提供されます： + ``` + Conversation history: + - User: Show me sales by region + - Agent: I've created a dashboard with a map visualization... + - User: Now filter to Q4 only + ``` + +**履歴の管理:** + +- **履歴のクリア**: `DELETE /api/reveal/ai/chat/session` を送信してセッションをリセットします + +## サーバー側の実装 + +チャットエンドポイントは、ASP.NET Core アプリケーションで Reveal AI を構成すると自動的に登録されます： + +```csharp title="Program.cs" +using Reveal.Sdk; +using Reveal.Sdk.AI; + +var builder = WebApplication.CreateBuilder(args); + +// Add Reveal SDK +builder.Services.AddControllers().AddReveal(revealBuilder => +{ + // Configure datasource provider + revealBuilder.AddDataSourceProvider(); +}); + +// Add Reveal AI - automatically registers chat endpoints +builder.Services.AddRevealAI() + .AddOpenAI(options => + { + options.ApiKey = builder.Configuration["OpenAI:ApiKey"]; + options.ModelId = "gpt-4.1"; + }); + +var app = builder.Build(); + +app.MapControllers(); +app.Run(); +``` + +追加のコントローラーやルーティング構成は不要です。`AddRevealAI()` を呼び出すだけで、POST と DELETE の両方のエンドポイントが使用可能になります。 + +## メタデータ構成 + +チャットにはデータソースの構造を理解するための**メタデータカタログ**が必要です。チャットリクエストの `datasourceId` パラメーターは、カタログで定義された `Id` と一致する必要があります。 + +:::info + +完全なカタログスキーマ、構成オプション、および例については、[メタデータカタログ](./metadata-catalog.md) トピックを参照してください。 + +::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/getting-started-html.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/getting-started-html.md new file mode 100644 index 00000000..3cdf559a --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/getting-started-html.md @@ -0,0 +1,298 @@ +--- +sidebar_label: はじめに - HTML/JavaScript +--- + + +# Reveal SDK AI をはじめよう - HTML/JavaScript + +このガイドでは、バニラ HTML と JavaScript を使用して、初めての AI 搭載アナリティクスアプリケーションを作成する手順を説明します。ダッシュボードデータから AI インサイトを生成するシンプルなアプリケーションを構築します。 + +**所要時間**: 15〜20分 + +## 構築するもの + +以下の機能を備えた Web アプリケーションを構築します: +- Reveal ダッシュボードの表示 +- ダッシュボードへの AI 搭載コンテキストメニュー項目の追加 +- AI インサイト（サマリー、分析、予測）の生成 + +## 前提条件 + +始める前に、[システム要件](system-requirements.md)を満たしていることを確認し、以下を準備してください: + +1. [Reveal SDK サーバー](/web/install-server-sdk)のインストールと設定が完了していること +2. [Reveal SDK AI サーバー](install-server-sdk.md)がインストールされていること +3. **LLM プロバイダー API キー** - [OpenAI](https://platform.openai.com/api-keys)、[Anthropic](https://platform.anthropic.com/account/keys)、または [Google Cloud](https://cloud.google.com/vertex-ai) から取得 + +## ステップ 1: ASP.NET Core サーバーの作成 + +### 1.1 新しい ASP.NET Core Web API プロジェクトの作成 + +ターミナルを開き、以下を実行します: + +```bash +dotnet new webapi -n RevealAiServer +cd RevealAiServer +``` + +### 1.2 AI NuGet パッケージのインストール + +Reveal AI パッケージをインストールします（Reveal.Sdk.AspNetCore が自動的に含まれます）: + +```bash +dotnet add package Reveal.Sdk.AI.AspNetCore +``` + +### 1.3 サーバーの設定 + +`Program.cs` を開き、内容を以下に置き換えます: + +```csharp title="Program.cs" +using Reveal.Sdk; +using Reveal.Sdk.AI; +using RevealAiServer.Reveal; + +var builder = WebApplication.CreateBuilder(args); + +// Add CORS for local development +builder.Services.AddCors(options => +{ + options.AddPolicy("AllowAll", + policy => policy.AllowAnyOrigin() + .AllowAnyHeader() + .AllowAnyMethod()); +}); + +// Add Reveal SDK with data source provider +builder.Services.AddControllers().AddReveal(builder => +{ + builder.AddDataSourceProvider(); +}); + +// Add Reveal AI with OpenAI provider +builder.Services.AddRevealAI() + .AddOpenAI(options => + { + options.ApiKey = builder.Configuration["RevealAI:OpenAI:ApiKey"]; + options.ModelId = "gpt-4.1"; + }); + +var app = builder.Build(); + +app.UseCors("AllowAll"); +app.MapControllers(); + +app.Run(); +``` + +### 1.4 API キーの設定 + +**オプション A: appsettings.json を使用する方法**（本番環境には非推奨） + +`appsettings.json` を作成または変更します: + +```json title="appsettings.json" +{ + "Logging": { + "LogLevel": { + "Default": "Information", + "Microsoft.AspNetCore": "Warning" + } + }, + "AllowedHosts": "*", + "RevealAI": { + "OpenAI": { + "ApiKey": "sk-your-openai-api-key-here" + } + } +} +``` + +**オプション B: User Secrets を使用する方法**（開発時に推奨） + +```bash +dotnet user-secrets init +dotnet user-secrets set "RevealAI:OpenAI:ApiKey" "sk-your-openai-api-key-here" +``` + +:::danger API キーをコミットしないでください + +API キーをソース管理にコミットしないでください。常に User Secrets、環境変数、またはセキュアなキー管理サービスを使用してください。 + +::: + +### 1.5 DataSource プロバイダーの作成 + +Reveal SDK にはデータソースプロバイダーが必要です。このサンプルでは、データソースをそのまま返すだけの最小限のプロバイダーを作成します。 + +新しいフォルダ `Reveal` を作成し、`DataSourceProvider.cs` を追加します: + +```csharp title="Reveal/DataSourceProvider.cs" +using Reveal.Sdk.Data; + +namespace RevealAiServer.Reveal; + +public class DataSourceProvider : IRVDataSourceProvider +{ + public Task ChangeDataSourceItemAsync( + IRVUserContext userContext, + string dashboardId, + RVDataSourceItem dataSourceItem) + { + return Task.FromResult(dataSourceItem); + } + + public Task ChangeDataSourceAsync( + IRVUserContext userContext, + RVDashboardDataSource dataSource) + { + return Task.FromResult(dataSource); + } +} +``` + +### 1.6 サンプルダッシュボードとデータの追加 + +プロジェクトルートに必要なフォルダを作成します: + +```bash +mkdir Dashboards +mkdir Data +``` + +必要なファイルをダウンロードし、正しいフォルダに配置します: + +**1. ダッシュボードファイル** → `Dashboards/` フォルダに保存: +- ダウンロード: [Accounts.rdash](https://github.com/RevealBi/sdk-samples-ai/raw/ad93b8eae04f32778e4eaf2b0168cf26dda10888/insights/server/aspnet/RevealSdkServer/Dashboards/Accounts.rdash) +- 配置場所: `Dashboards/Accounts.rdash` + +**2. データファイル** → `Data/` フォルダに保存: +- ダウンロード: [NorthwindInvoices.xlsx](https://github.com/RevealBi/sdk-samples-ai/raw/refs/heads/main/insights/server/aspnet/RevealSdkServer/Data/NorthwindInvoices.xlsx) +- 配置場所: `Data/NorthwindInvoices.xlsx` + +プロジェクト構成は以下のようになります: +``` +RevealAiServer/ +├── Dashboards/ +│ └── Accounts.rdash +├── Data/ +│ └── NorthwindInvoices.xlsx +├── Reveal/ +│ └── DataSourceProvider.cs +└── Program.cs +``` + +### 1.7 サーバーの起動 + +```bash +dotnet run +``` + +サーバーが `https://localhost:5111`（または類似の URL）で起動します。この URL はクライアントで使用するため、メモしておいてください。 + +## ステップ 2: HTML クライアントの作成 + +### 2.1 index.html の作成 + +プロジェクトルート（または別の `client` フォルダ）に新しいファイル `index.html` を作成します: + +```html title="index.html" + + + + + + Reveal AI - Insights Demo + + + +
+
+
Use the dashboard overflow menu and select an AI insight option.
+
+ + + + + + + + +``` + +## ステップ 3: アプリケーションの実行 + +### 3.1 サーバーの起動 + +まだ起動していない場合: + +```bash +dotnet run +``` + +### 3.2 クライアントを開く + +`index.html` を Web ブラウザで開きます。以下の方法があります: + +- VS Code の Live Server 拡張機能を使用する +- ファイルをダブルクリックする + +### 3.3 AI インサイトのテスト + +1. ダッシュボードが読み込まれるまで待ちます +2. ダッシュボードのオーバーフローメニュー（ケバブアイコン）をクリックします +3. **Summary**、**Analysis**、または **Forecast** を選択します +4. AI が生成したインサイトが右パネルに表示されます + +ここから、[SDK の使い方](./sdk-overview.md)セクションを参照して、ストリーミングレスポンス、ビジュアライゼーションレベルのインサイト、チャットなどについて学びましょう。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/guide-chat-interface.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/guide-chat-interface.md new file mode 100644 index 00000000..47b11272 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/guide-chat-interface.md @@ -0,0 +1,99 @@ +--- +sidebar_label: チャットインターフェースの構築 +--- + + +# チャットインターフェースの構築 + +このガイドでは、Reveal SDK AI Chat API を使用して、メッセージ履歴とストリーミングレスポンスを備えた完全なチャット UI を構築する方法を説明します。 + +## 完全なチャット実装 + +```typescript +const client = RevealSdkClient.getInstance(); +const messages: Array<{role: 'user' | 'assistant', content: string}> = []; + +async function sendChatMessage(userInput: string) { + // Add user message to UI + messages.push({ role: 'user', content: userInput }); + renderMessages(); + + let currentMessage = ''; + + const stream = await client.ai.chat.sendMessage({ + message: userInput, + datasourceId: 'my-datasource', + stream: true, + }); + + stream.on('progress', (message) => { + showProgressIndicator(message); + }); + + stream.on('text', (content) => { + currentMessage += content; + // Update streaming message in UI + updateStreamingMessage(currentMessage); + scrollToBottom(); + }); + + stream.on('error', (error) => { + showError(error); + }); + + const result = await stream.finalResponse(); + + // Finalize message + messages.push({ role: 'assistant', content: currentMessage }); + renderMessages(); + + if (result.dashboard) { + loadDashboard(result.dashboard); + } + + hideProgressIndicator(); +} + +// Clear conversation +async function resetConversation() { + await client.ai.chat.resetContext(); + messages.length = 0; + renderMessages(); +} +``` + +## 主要コンセプト + +### メッセージ履歴 + +`messages` 配列はローカルの UI 状態を追跡します。サーバーは独自の会話履歴を自動的に保持するため、各リクエストで以前のメッセージを送信する必要はありません。 + +### ダッシュボードの処理 + +チャットレスポンスには、生成または修正されたダッシュボード JSON を含む `dashboard` フィールドが含まれる場合があります。各レスポンスの後にこのフィールドを確認し、RevealView に読み込みます： + +```typescript +const result = await stream.finalResponse(); + +if (result.dashboard) { + // Load the new or modified dashboard + revealView.dashboard = await RVDashboard.loadFromJson(result.dashboard); +} +``` + +### 既存ダッシュボードの編集 + +チャットを通じてユーザーが既存のダッシュボードを編集できるようにするには、リクエストにダッシュボードを含めます： + +```typescript +const stream = await client.ai.chat.sendMessage({ + message: 'Add a date filter to this dashboard', + datasourceId: 'my-datasource', + dashboard: revealView.dashboard, // Pass the current dashboard + stream: true, +}); +``` + +### コンテキストのリセット + +新しいトピックを開始する場合やデータソースを切り替える場合は、`resetContext()` を呼び出します。これにより、サーバー側の会話履歴がクリアされ、以前のメッセージが新しいレスポンスに影響を与えなくなります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/guide-insights-context-menus.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/guide-insights-context-menus.md new file mode 100644 index 00000000..9fbe6e36 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/guide-insights-context-menus.md @@ -0,0 +1,110 @@ +--- +sidebar_label: コンテキストメニューによるインサイト +--- + + +# コンテキストメニューによるインサイト + +このガイドでは、RevealView ダッシュボードのコンテキストメニューに AI を活用したインサイトオプションを追加する方法を説明します。ユーザーはダッシュボードや個々のビジュアライゼーションを右クリックして、要約、分析、予測を生成できるようになります。 + +## インサイトメニュー項目の追加 + +`onMenuOpening` イベントを使用して、AI インサイトをトリガーするカスタムメニュー項目を追加します： + +```typescript +const client = RevealSdkClient.getInstance(); + +revealView.onMenuOpening = function (visualization, args) { + // Dashboard-level insights (right-click on dashboard background) + if (args.menuLocation === $.ig.RVMenuLocation.Dashboard) { + args.menuItems.push(new $.ig.RVMenuItem("Summary", null, async () => { + const insight = await client.ai.insights.get({ + dashboard: revealView.dashboard, + type: 'summary', + }); + displayInsight(insight.explanation); + })); + + args.menuItems.push(new $.ig.RVMenuItem("Analysis", null, async () => { + const insight = await client.ai.insights.get({ + dashboard: revealView.dashboard, + type: 'analysis', + }); + displayInsight(insight.explanation); + })); + + args.menuItems.push(new $.ig.RVMenuItem("Forecast", null, async () => { + const insight = await client.ai.insights.get({ + dashboard: revealView.dashboard, + type: 'forecast', + }); + displayInsight(insight.explanation); + })); + } + + // Visualization-level insights (right-click on a specific visualization) + if (args.menuLocation === $.ig.RVMenuLocation.Visualization) { + args.menuItems.push(new $.ig.RVMenuItem("Analyze This", null, async () => { + const insight = await client.ai.insights.get({ + dashboard: revealView.dashboard, + visualizationId: visualization.id, + type: 'analysis', + }); + displayInsight(insight.explanation); + })); + } +}; +``` + +## ストリーミングサポートの追加 + +よりインタラクティブな体験のために、ストリーミングを使用してインサイトを生成しながら表示します： + +```typescript +function createInsightMenuItem(label, dashboard, insightType, visualizationId = null) { + return new $.ig.RVMenuItem(label, null, async () => { + const options = { + dashboard: dashboard, + type: insightType, + stream: true, + }; + + if (visualizationId) { + options.visualizationId = visualizationId; + } + + let buffer = ''; + const stream = await client.ai.insights.get(options); + + stream.on('progress', (message) => { + showProgressIndicator(message); + }); + + stream.on('text', (content) => { + buffer += content; + displayInsight(buffer); + }); + + stream.on('error', (error) => { + showError(error); + }); + + await stream.finalResponse(); + hideProgressIndicator(); + }); +} + +// Use the helper in onMenuOpening +revealView.onMenuOpening = function (visualization, args) { + if (args.menuLocation === $.ig.RVMenuLocation.Dashboard) { + args.menuItems.push(createInsightMenuItem("Summary", revealView.dashboard, 'summary')); + args.menuItems.push(createInsightMenuItem("Analysis", revealView.dashboard, 'analysis')); + args.menuItems.push(createInsightMenuItem("Forecast", revealView.dashboard, 'forecast')); + } + + if (args.menuLocation === $.ig.RVMenuLocation.Visualization) { + args.menuItems.push(createInsightMenuItem("Summary", revealView.dashboard, 'summary', visualization.id)); + args.menuItems.push(createInsightMenuItem("Analysis", revealView.dashboard, 'analysis', visualization.id)); + } +}; +``` diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/guide-streaming-display.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/guide-streaming-display.md new file mode 100644 index 00000000..a168f5db --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/guide-streaming-display.md @@ -0,0 +1,67 @@ +--- +sidebar_label: ストリーミング Markdown 表示 +--- + + +# ストリーミング Markdown 表示 + +このガイドでは、リアルタイムの Markdown レンダリングを使用してストリーミング AI レスポンスを表示する方法を説明します。ストリームからテキストチャンクが到着すると、それらが蓄積され、Markdown ライブラリを使用してフォーマットされた HTML としてレンダリングされます。 + +## marked.js の使用 + +[marked](https://www.npmjs.com/package/marked) ライブラリは Markdown を HTML に変換し、ストリーミングテキストとの相性が良好です： + +```typescript +import { marked } from 'marked'; + +let buffer = ''; + +const stream = await client.ai.insights.get({ + dashboardId: 'sales-dashboard', + type: 'summary', + stream: true, +}); + +stream.on('text', (content) => { + buffer += content; + // Re-render the full buffer as markdown on each chunk + document.getElementById('output').innerHTML = marked.parse(buffer); +}); + +const result = await stream.finalResponse(); +console.log('Streaming complete:', result.explanation); +``` + +## プログレスメッセージとの組み合わせ + +メインコンテンツのストリーミングが開始される前に、プログレスステータスを表示します： + +```typescript +let buffer = ''; +const output = document.getElementById('output'); + +const stream = await client.ai.insights.get({ + dashboardId: 'sales-dashboard', + type: 'analysis', + stream: true, +}); + +stream.on('progress', (message) => { + buffer += `*${message}*\n\n`; + output.innerHTML = marked.parse(buffer); +}); + +stream.on('text', (content) => { + buffer += content; + output.innerHTML = marked.parse(buffer); + output.scrollTop = output.scrollHeight; // Auto-scroll +}); + +await stream.finalResponse(); +``` + +## ヒント + +- 各チャンクで HTML フラグメントを追加するのではなく、**バッファー全体を再レンダリング**してください。部分的な Markdown（例：閉じられていない `**bold**`）は、さらにテキストが到着するまで正しくレンダリングされません。 +- ストリーミング中に最新のテキストが表示されるように、コンテナを**自動スクロール**してください。 +- 以前のレスポンスのコンテンツが混在しないように、新しいリクエストを開始する前に**バッファーをクリア**してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/insights.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/insights.md new file mode 100644 index 00000000..afe298c4 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/insights.md @@ -0,0 +1,125 @@ +--- +sidebar_label: インサイトエンドポイント +--- + + +# インサイトエンドポイント + +AI インサイトは、ダッシュボードやビジュアライゼーションを自動的に分析し、自然言語による説明の生成、トレンドやパターンの特定、将来の値の予測を行います。Reveal SDK AI は、高度なアナリティクスの専門知識がなくてもユーザーがデータを理解できるよう、3 種類のインサイトを生成します。 + +**サマリー** - 主要な指標、トップパフォーマー、全体的なトレンドを強調した簡潔な概要です。 + +> *"Sales revenue reached $2.4M in Q4 2024, up 18% from Q3. The Technology category led growth with $890K in sales, while the West region showed the strongest performance at $1.1M."* + +**分析** - データ内のパターン、異常値、トレンド、相関関係を特定する詳細な解釈です。 + +> *"Analysis reveals a strong seasonal pattern with peaks in Q4 driven by holiday shopping. The Technology category shows consistent month-over-month growth averaging 12%, while Office Supplies demonstrate more volatility. A notable spike in October coincides with the new product launch campaign."* + +**予測** - 過去のデータのトレンドに基づく将来の値の予測です。何期間先まで予測するかを指定できます。 + +> *"Based on historical trends, Q1 2025 sales are forecasted at $2.1M, with continued growth expected through mid-year. The model predicts Technology category sales will reach $950K by March 2025, representing 15% growth from the current period."* + +インサイトは 2 つのレベルで生成できます: + +- **ダッシュボードレベル**: ダッシュボード全体を分析し、すべてのビジュアライゼーションを総合的に考慮して包括的なインサイトを提供します +- **ビジュアライゼーションレベル**: 単一のビジュアライゼーションに焦点を当て、そのビジュアライゼーションのデータに特化した詳細な分析を提供します + +--- + +## エンドポイント + +``` +POST /api/reveal/ai/insights +``` + +## リクエストフォーマット + +```typescript +{ + // Dashboard source (use ONE of these) + dashboardJson?: string, // Dashboard as JSON string (RDash format) + dashboardId?: string, // Dashboard ID (when using IRVDashboardProvider) + + // Optional parameters + visualizationId?: string, // Visualization ID for visualization-level insights + insightType?: string, // "Summary" | "Analysis" | "Forecast" (default: "Summary") + forecastPeriods?: number, // Number of periods to forecast (default: 6, only for Forecast type) + stream?: boolean, // Return SSE stream instead of JSON (default: false) + model?: string // Optional LLM model override +} +``` + +### リクエストパラメーター + +| パラメーター | 型 | 必須 | 説明 | +|-----------|------|----------|-------------| +| `dashboardJson` | string | * | ダッシュボードの JSON 文字列。これまたは `dashboardId` を使用します | +| `dashboardId` | string | * | ダッシュボード識別子。これまたは `dashboardJson` を使用します | +| `visualizationId` | string | いいえ | 分析するビジュアライゼーション ID。省略した場合、ダッシュボード全体を分析します | +| `insightType` | string | いいえ | インサイトの種類: `"Summary"`、`"Analysis"`、または `"Forecast"`（デフォルト: `"Summary"`） | +| `forecastPeriods` | number | いいえ | 予測する期間数（デフォルト: 6）。`insightType` が `"Forecast"` の場合のみ使用されます | +| `stream` | boolean | いいえ | `true` の場合、プログレスイベント、テキストチャンク、および最終 complete イベントを含む `text/event-stream`（SSE）レスポンスを返します。`false`（デフォルト）の場合、プレーンな `application/json` レスポンスを返します。 | +| `model` | string | いいえ | このリクエストで使用する特定の LLM モデルの名前 | + +\* `dashboardJson` または `dashboardId` のいずれかを指定する必要があります + +## レスポンスフォーマット + +### 非ストリーミング（デフォルト） + +`stream` が `false` または省略された場合、エンドポイントはプレーンな JSON レスポンスを返します。 + +```json +{ + "explanation": "Sales revenue reached $2.4M in Q4 2024, up 18% from Q3..." +} +``` + +エラーの場合、レスポンスには適切な HTTP ステータスコード（400 または 500）とともにエラーメッセージが含まれます。 + +```json +{ + "error": "Error message" +} +``` + +### ストリーミング + +`stream` が `true` の場合、エンドポイントは以下のイベントタイプを含む Server-Sent Events（SSE）を返します。 + +#### progress イベント +インサイト生成中に現在のステータスを示すために送信されます。 + +```json +event: progress +data: {"message": "Analyzing dashboard data..."} +``` + +#### text イベント +生成された説明テキストのフラグメントを含みます。 + +```json +event: text +data: {"content": "Sales revenue reached $2.4M in Q4 2024"} +``` + +#### complete イベント +インサイトの生成が正常に完了したときに送信されます。常に完全な説明を含みます。 + +```json +event: complete +data: { + "message": "Insights generated successfully", + "result": { + "explanation": "Sales revenue reached $2.4M in Q4 2024, up 18% from Q3..." + } +} +``` + +#### error イベント +インサイトの生成が失敗した場合に送信されます。 + +```json +event: error +data: {"error": "Error message"} +``` diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/install-client-sdk.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/install-client-sdk.md new file mode 100644 index 00000000..632eaced --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/install-client-sdk.md @@ -0,0 +1,146 @@ +--- +sidebar_label: クライアント SDK のインストール +--- + + +# AI クライアント SDK のインストール + +Reveal SDK AI クライアントは、ウェブアプリケーションに AI 機能を提供する TypeScript/JavaScript ライブラリです。ベースの Reveal SDK と連携して、インサイト、ダッシュボード生成、会話型 AI などのインテリジェントな機能を追加します。 + +## 前提条件 + +AI クライアント SDK をインストールする前に、以下を確認してください： + +1. ベースの [Reveal SDK サーバー](/web/install-server-sdk) がインストールおよび設定済みであること +2. [Reveal SDK AI サーバー](install-server-sdk.md) がインストールおよび設定済みであること +3. Node.js 18+ および npm 9+ がインストール済みであること（パッケージベースのインストールの場合） + +## インストール方法 + +### npm を使用したインストール（推奨） + +AI クライアント SDK のインストールには npm の使用を推奨します： + +```bash npm2yarn +npm install @revealbi/api +``` + +### CDN を使用したインストール + +クイックプロトタイピングやデモ用には、unpkg CDN を使用できます： + +```html + +``` + +または jsDelivr を使用する場合： + +```html + +``` + +## TypeScript サポート + +AI クライアント SDK は TypeScript で記述されており、完全な型定義を含んでいます。追加の `@types` パッケージは必要ありません。 + +## フレームワーク別のセットアップ + +### バニラ JavaScript + +#### ES Modules を使用する場合 + +```html + + + + Reveal AI + + +
+ + + + +``` + +#### UMD バンドルを使用する場合 + +```html + + + + Reveal AI + + + +
+ + + + +``` + +### Angular + +`main.ts` ファイルで、アプリケーションのブートストラップ前に初期化します： + +```typescript +import { platformBrowserDynamic } from '@angular/platform-browser-dynamic'; +import { RevealSdkClient } from '@revealbi/api'; +import { AppModule } from './app/app.module'; + +RevealSdkClient.initialize({ + hostUrl: 'https://your-server.com' +}); + +platformBrowserDynamic() + .bootstrapModule(AppModule) + .catch(err => console.error(err)); +``` + +### React + +`index.tsx` または `main.tsx` ファイルで、レンダリング前に初期化します： + +```typescript +import React from 'react'; +import ReactDOM from 'react-dom/client'; +import { RevealSdkClient } from '@revealbi/api'; +import App from './App'; + +RevealSdkClient.initialize({ + hostUrl: 'https://your-server.com' +}); + +ReactDOM.createRoot(document.getElementById('root')!).render( + + + +); +``` + +### Vue + +`main.ts` ファイルで、アプリケーションのマウント前に初期化します： + +```typescript +import { createApp } from 'vue'; +import { RevealSdkClient } from '@revealbi/api'; +import App from './App.vue'; + +RevealSdkClient.initialize({ + hostUrl: 'https://your-server.com' +}); + +createApp(App).mount('#app'); +``` diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/install-server-sdk.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/install-server-sdk.md new file mode 100644 index 00000000..c6efb19a --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/install-server-sdk.md @@ -0,0 +1,183 @@ +--- +sidebar_label: サーバー SDK のインストール +--- + + +# AI サーバー SDK のインストール + +Reveal SDK AI サーバーは、アプリケーションで AI 機能を動作させるために必要なバックエンドサービスを提供します。LLM プロバイダーと統合し、インサイト生成、ダッシュボード作成、会話型アナリティクスなどの AI 操作を管理します。 + +## 前提条件 + +AI サーバー SDK をインストールする前に、以下を確認してください： + +1. ベースの [Reveal SDK サーバー](/web/install-server-sdk) がインストールおよび設定済みであること +2. .NET 8.0 以上 +3. 少なくとも1つの LLM プロバイダー（OpenAI、Anthropic、Google など）へのアクセス +4. LLM プロバイダーの API キーが設定済みであること + +## インストール方法 + +### ASP.NET Core + +ASP.NET Core 用の AI サーバー SDK は NuGet パッケージとして配布されています。 + +#### ステップ 1: NuGet パッケージのインストール + +ソリューションまたはプロジェクトを右クリックし、**Manage NuGet Packages** for Solution を選択します。 + +![](../web/images/getting-started-nuget-packages-manage.jpg) + +パッケージマネージャーダイアログで **Browse** タブを開き、**Reveal.Sdk.AI.AspNetCore** NuGet パッケージをプロジェクトにインストールします。 + +**パッケージ名:** `Reveal.Sdk.AI.AspNetCore` + +または Package Manager Console を使用する場合： + +```bash +Install-Package Reveal.Sdk.AI.AspNetCore +``` + +または .NET CLI を使用する場合： + +```bash +dotnet add package Reveal.Sdk.AI.AspNetCore +``` + +#### ステップ 2: サービスの設定 + +`Program.cs` ファイルを開いて変更し、AI サービスを追加します。AI SDK はベースの Reveal SDK を拡張するため、両方の設定が必要です： + +```csharp +using Reveal.Sdk; +using Reveal.Sdk.AI; + +var builder = WebApplication.CreateBuilder(args); + +// Add Reveal SDK (required) +builder.Services.AddControllers().AddReveal(); + +// Add Reveal AI services +builder.Services.AddRevealAI(); + +var app = builder.Build(); +app.Run(); +``` + +#### ステップ 3: LLM プロバイダーのインストールと設定 + +各 LLM プロバイダーは個別の NuGet パッケージとして配布されています。選択したプロバイダーのパッケージをインストールし、`AddRevealAI()` の後に登録します。 + +例えば、OpenAI を使用する場合： + +```bash +dotnet add package Reveal.Sdk.AI.OpenAI +``` + +```csharp +builder.Services.AddRevealAI() + .AddOpenAI(options => + { + options.ApiKey = builder.Configuration["RevealAI:OpenAI:ApiKey"]; + }); +``` + +各プロバイダーの詳細なセットアップ手順については、[プロバイダー](/ai/providers-overview) セクションを参照してください： + +| プロバイダー | NuGet パッケージ | ガイド | +|----------|--------------|-------| +| OpenAI | `Reveal.Sdk.AI.OpenAI` | [セットアップガイド](/ai/providers-openai) | +| Azure OpenAI | `Reveal.Sdk.AI.AzureOpenAI` | [セットアップガイド](/ai/providers-azure-openai) | +| Anthropic | `Reveal.Sdk.AI.Anthropic` | [セットアップガイド](/ai/providers-anthropic) | +| Google Gemini | `Reveal.Sdk.AI.Google` | [セットアップガイド](/ai/providers-google-gemini) | + +:::danger API キーをコミットしないでください + +API キーをソースコントロールにコミットしないでください。常に環境変数、User Secrets、または安全なキー管理サービスを使用してください。 + +::: + +#### 完全な例 + +AI 機能が設定された完全な `Program.cs` の例を以下に示します： + +```csharp title="Program.cs" +using Reveal.Sdk; +using Reveal.Sdk.AI; + +var builder = WebApplication.CreateBuilder(args); + +// Add CORS for cross-origin requests +builder.Services.AddCors(options => +{ + options.AddDefaultPolicy(policy => + { + policy.WithOrigins("http://localhost:4200") + .AllowAnyMethod() + .AllowAnyHeader(); + }); +}); + +// Add base Reveal SDK +builder.Services.AddControllers().AddReveal(revealBuilder => +{ + revealBuilder.AddSettings(settings => + { + settings.LocalFileStoragePath = "Data"; + }); +}); + +// Add Reveal AI with OpenAI provider +builder.Services.AddRevealAI() + .AddOpenAI(options => + { + options.ApiKey = builder.Configuration["RevealAI:OpenAI:ApiKey"]; + options.Model = "gpt-4.1"; + }); + +var app = builder.Build(); + +app.UseCors(); +app.MapControllers(); + +app.Run(); +``` + +### Node.js（近日公開） + +AI サーバー SDK の Node.js サポートは現在開発中であり、将来のリリースで提供される予定です。 + +現時点では、AI 機能には ASP.NET Core が推奨サーバープラットフォームです。 + +### Java（近日公開） + +AI サーバー SDK の Java サポートは現在開発中であり、将来のリリースで提供される予定です。 + +現時点では、AI 機能には ASP.NET Core が推奨サーバープラットフォームです。 + +## インストールの確認 + +インストール後、AI SDK が正しく設定されていることを確認します： + +### ステップ 1: アプリケーションの実行 + +```bash +dotnet run +``` + +### ステップ 2: AI エンドポイントの確認 + +AI SDK は `/api/reveal/ai/` 配下にいくつかのエンドポイントを追加します： + +プロバイダーエンドポイントをテストします： + +```bash +curl http://localhost:5000/api/reveal/ai/providers +``` + +期待されるレスポンス： +```json +{ + "providers": ["openai", "anthropic"] +} +``` diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/metadata-catalog.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/metadata-catalog.md new file mode 100644 index 00000000..af84c7a7 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/metadata-catalog.md @@ -0,0 +1,321 @@ +--- +sidebar_label: メタデータカタログ +--- + + +# メタデータカタログ + +**メタデータカタログ**は、Reveal SDK AI で利用可能なデータソースの中心的な定義です。AI に対して、どのようなデータ接続が存在し、各接続がどのプロバイダーを使用し、オプションでそのデータベース、テーブル、フィールドを記述します。**チャット**と**メタデータサービス**の両機能は、データの全体像を理解するためにカタログに依存しています。 + +## 仕組み + +メタデータシステムには、3つの異なる責務があります: + +| 関心事 | 目的 | +|---------|---------| +| **メタデータカタログ** | どのデータソースが存在し、どのような構造になっているか | +| **メタデータマネージャー** | 生成されたメタデータファイルがディスク上のどこに書き込まれるか | +| **メタデータサービス** | メタデータ生成がいつ実行されるか（起動時、スケジュール） | + +設定が必要なのは**カタログ**のみです。マネージャーとサービスには適切なデフォルト値があり、設定は任意です。 + +--- + +## カタログスキーマ + +カタログは `Datasources` 配列を持つ JSON オブジェクトです。各エントリは、プロバイダーとオプションのスキーマ詳細を含むデータソースを定義します。 + +### 最小限の例 + +最低限、各データソースには `Id` と `Provider` が必要です: + +```json +{ + "Datasources": [ + { + "Id": "MyDatabase", + "Provider": "SQLServer" + } + ] +} +``` + +### 完全なスキーマ + +```json +{ + "Datasources": [ + { + "Id": "MyDatabase", + "Provider": "SQLServer", + "Databases": [ + { + "Name": "Northwind", + "DiscoveryMode": "Default", + "Tables": [ + { + "Name": "dbo.Orders", + "Description": "Customer purchase orders", + "Fields": [ + { + "Name": "OrderDate", + "Alias": "Order Date", + "Description": "Date the order was placed" + } + ] + } + ] + } + ] + } + ] +} +``` + +### スキーマリファレンス + +#### データソース + +| プロパティ | 型 | 必須 | 説明 | +|----------|------|----------|-------------| +| `Id` | string | はい | データソースの一意の識別子。API リクエストで `datasourceId` として使用されます。 | +| `Provider` | string | はい | データプロバイダーの種類（以下の[プロバイダータイプ](#provider-types)を参照） | +| `Databases` | array | いいえ | このデータソースで利用可能なデータベーススキーマのリスト | + +#### データベース + +| プロパティ | 型 | 必須 | 説明 | +|----------|------|----------|-------------| +| `Name` | string | はい | データベースの名前 | +| `DiscoveryMode` | string | いいえ | `"Default"`（すべてのテーブルを検出）または `"Restricted"`（リストされたテーブルのみ）。デフォルトは `"Default"` です。 | +| `Tables` | array | いいえ | このデータベース内のテーブルスキーマのリスト | + +#### テーブル + +| プロパティ | 型 | 必須 | 説明 | +|----------|------|----------|-------------| +| `Name` | string | はい | 完全修飾テーブル名（例: `"dbo.Orders"`） | +| `Description` | string | いいえ | 人間が読める説明。テーブルの内容を AI が理解するのに役立ちます。 | +| `Fields` | array | いいえ | このテーブル内のフィールドスキーマのリスト | + +#### フィールド + +| プロパティ | 型 | 必須 | 説明 | +|----------|------|----------|-------------| +| `Name` | string | はい | データベース内の実際のカラム名 | +| `Alias` | string | いいえ | フィールドの表示エイリアス（例: `"OrderDate"` に対して `"Order Date"`） | +| `Description` | string | いいえ | 人間が読める説明。フィールドが何を表しているかを AI が理解するのに役立ちます。 | + +### プロバイダータイプ {#provider-types} + +一般的なプロバイダー値: + +| プロバイダー | 説明 | +|----------|-------------| +| `SQLServer` | Microsoft SQL Server | +| `PostgreSQL` | PostgreSQL | +| `MySQL` | MySQL | +| `Oracle` | Oracle（サービス名） | +| `OracleSID` | Oracle（SID） | +| `SSAS` | SQL Server Analysis Services | +| `SSASHTTP` | SQL Server Analysis Services（HTTP） | +| `Snowflake` | Snowflake | +| `BigQuery` | Google BigQuery | +| `AmazonAthena` | Amazon Athena | +| `AmazonRedshift` | Amazon Redshift | +| `MongoDB` | MongoDB | +| `WebService` | Web サービス / REST API / Excel ファイル | + +--- + +## カタログソース + +カタログは、ディスク上の JSON ファイルから読み込むか、完全なカスタムプロバイダー（例: データベースバックエンド）から読み込むことができます。 + +### オプション 1: ディスク上の JSON ファイル + +カタログを独立した JSON ファイルに保存します。これは最もシンプルなアプローチで、データソース定義をアプリケーション設定とは別に管理したい場合、環境間で共有したい場合、または CI/CD パイプラインから生成したい場合に便利です。 + +**1. カタログファイルの作成:** + +```json title="config/catalog.json" +{ + "Datasources": [ + { + "Id": "NorthwindDB", + "Provider": "SQLServer", + "Databases": [ + { + "Name": "Northwind", + "DiscoveryMode": "Restricted", + "Tables": [ + { "Name": "dbo.Orders", "Description": "Customer purchase orders" }, + { "Name": "dbo.Customers", "Description": "Customer contact information" }, + { "Name": "dbo.Products", "Description": "Product catalog" } + ] + } + ] + } + ] +} +``` + +**2. ビルダーでファイルを指定:** + +```csharp title="Program.cs" +builder.Services.AddRevealAI() + .UseMetadataCatalogFile("config/catalog.json") + .AddOpenAI(); +``` + +絶対パスと相対パスの両方がサポートされています。相対パスはアプリケーションの現在の作業ディレクトリを基準に解決されます。 + +### オプション 2: カスタムプロバイダー + +`IMetadataCatalogProvider` を実装して、任意のソース（データベース、API、キー保管庫など）からデータソース定義を読み込みます。 + +**1. インターフェースの実装:** + +```csharp title="DatabaseCatalogProvider.cs" +using Reveal.Sdk.AI.Metadata.Catalog; + +public class DatabaseCatalogProvider : IMetadataCatalogProvider +{ + private readonly IMyDatasourceRepository _repository; + + public DatabaseCatalogProvider(IMyDatasourceRepository repository) + { + _repository = repository; + } + + public async Task GetCatalogAsync() + { + var datasources = await _repository.GetAllDatasourcesAsync(); + + return new MetadataCatalog + { + Datasources = datasources.Select(ds => new DatasourceSchema + { + Id = ds.Id, + Provider = Enum.Parse(ds.ProviderType) + }).ToList() + }; + } +} +``` + +**2. プロバイダーの登録:** + +```csharp title="Program.cs" +builder.Services.AddRevealAI() + .UseMetadataCatalogProvider() + .AddOpenAI(); +``` + +プロバイダークラスは依存性注入を通じて解決されるため、コンストラクタで必要なサービスを注入できます。 + +--- + +## メタデータマネージャーオプション + +**メタデータマネージャー**は、生成されたメタデータファイルがディスク上のどこに書き込まれるかを制御します。これらのファイルは一時的なものであり、自動的に生成され、いつでも再生成できます。 + +```json title="appsettings.json" +{ + "RevealAI": { + "MetadataManager": { + "OutputPath": "D:\\metadata\\output" + } + } +} +``` + +| プロパティ | 型 | 必須 | 説明 | +|----------|------|----------|-------------| +| `OutputPath` | string | いいえ | 生成されたメタデータファイルが保存されるディレクトリ。デフォルトは `{user-home}/reveal/ai/metadata` です。 | + +--- + +## メタデータサービスオプション + +**メタデータサービス**は、メタデータがいつ生成されるかを制御します。アプリケーション起動時、定期的なスケジュール、またはその両方で生成をトリガーできます。 + +```json title="appsettings.json" +{ + "RevealAI": { + "MetadataService": { + "GenerateOnStartup": true, + "CronSchedule": "0 0 * * *" + } + } +} +``` + +| プロパティ | 型 | 必須 | 説明 | +|----------|------|----------|-------------| +| `GenerateOnStartup` | boolean | いいえ | `true` の場合、アプリケーション起動時にメタデータを生成します。デフォルトは `false` です。 | +| `CronSchedule` | string | いいえ | 定期的なメタデータ生成のための Cron 式（例: 毎日深夜に実行する場合は `"0 0 * * *"`）。 | + +--- + +## 完全な設定例 + +カタログファイル、マネージャーとサービスオプション用の `appsettings.json`、および `Program.cs` のセットアップを示す完全な例を以下に示します: + +```json title="config/catalog.json" +{ + "Datasources": [ + { + "Id": "NorthwindDB", + "Provider": "SQLServer", + "Databases": [ + { + "Name": "Northwind", + "DiscoveryMode": "Restricted", + "Tables": [ + { + "Name": "dbo.Orders", + "Description": "Customer purchase orders", + "Fields": [ + { "Name": "OrderDate", "Alias": "Order Date", "Description": "Date the order was placed" }, + { "Name": "ShipCountry", "Alias": "Ship Country" } + ] + }, + { + "Name": "dbo.Customers", + "Description": "Customer contact information" + } + ] + } + ] + }, + { + "Id": "SalesExcel", + "Provider": "WebService" + } + ] +} +``` + +```json title="appsettings.json" +{ + "RevealAI": { + "OpenAI": { + "ApiKey": "sk-your-api-key-here" + }, + "MetadataManager": { + "OutputPath": "D:\\metadata\\output" + }, + "MetadataService": { + "GenerateOnStartup": true, + "CronSchedule": "0 0 * * *" + } + } +} +``` + +```csharp title="Program.cs" +builder.Services.AddRevealAI() + .UseMetadataCatalogFile("config/catalog.json") + .AddOpenAI(); +``` diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/overview.md new file mode 100644 index 00000000..eab65079 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/overview.md @@ -0,0 +1,95 @@ +--- +sidebar_label: 概要 +--- + + +# Reveal SDK AI の概要 + +Reveal SDK AI は、Reveal BI アプリケーションに強力な人工知能機能を追加し、ユーザーが自然言語を通じてインサイトを取得しデータと対話できるようにします。 + +## Reveal SDK AI とは？ + +Reveal SDK AI は、大規模言語モデル（LLM）を統合して以下の機能を提供する Reveal SDK の拡張機能です： + +- **AI 生成インサイト**: ダッシュボードやビジュアライゼーションのサマリー、分析、予測を自動的に生成します +- **会話型アナリティクス**: データとチャットして、情報の探索、分析、可視化を行います + +## 主な機能 + +### AI インサイト + +3種類の分析により、データからインテリジェントなインサイトを生成します： + +- **サマリー**: データが示す内容の簡潔な説明を取得します +- **分析**: トレンド、パターン、異常値の詳細な解釈を受け取ります +- **予測**: 過去のデータに基づいて将来の値を予測します + +すべてのインサイトは、ChatGPT のようなユーザーエクスペリエンスを実現するために、リアルタイムでストリーミングできます。 + +### 会話型 AI チャット + +ユーザーが以下のことを行えるチャットインターフェースを構築します： + +- 自然言語でデータに関する質問をする +- 会話を通じてダッシュボードを生成・変更する +- フォローアップの質問のために会話コンテキストを維持する +- レスポンスをリアルタイムでストリーミングする + +### 柔軟な API パターン + +ユースケースに合ったパターンを選択できます： + +**Await パターン** - シンプルで直感的： +```typescript +const result = await client.ai.insights.get({ + dashboardId: 'sales-dashboard', + insightType: InsightType.Summary +}); +console.log(result.explanation); +``` + +**ストリーミングパターン** - リアルタイム更新： +```typescript +const stream = await client.ai.insights.get({ + dashboardId: 'sales-dashboard', + insightType: InsightType.Summary, + stream: true, +}); + +stream.on('text', (content) => { + // Display text as it arrives + console.log(content); +}); + +const result = await stream.finalResponse(); +console.log('Complete!'); +``` + +## アーキテクチャ + +Reveal SDK AI は2つの主要コンポーネントで構成されています： + +### クライアント SDK (TypeScript/JavaScript) + +クライアント SDK はウェブアプリケーション内で動作し、以下を提供します： + +- シンプルな初期化と設定 +- すべての AI 操作に対する型安全な API +- Server-Sent Events (SSE) による組み込みストリーミングサポート +- リクエストのキャンセルとエラーハンドリング + +### サーバー SDK (ASP.NET Core) + +サーバー SDK は以下を処理します： + +- LLM プロバイダーの統合 (OpenAI、Anthropic、Google など) +- データソースメタデータの生成とキャッシング +- インテントベースの LLM ルーティング +- 会話型 AI のコンテキスト管理 +- セキュリティと認証 + +## ベータ版について + +Reveal SDK AI は現在ベータ版です。コア機能は安定しており開発に使用できますが、ユーザーのフィードバックに基づいて API が変更される可能性があります。ぜひお試しいただき、ご感想をお聞かせください。 + +一緒にインテリジェントなアナリティクス体験を構築しましょう！ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-anthropic.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-anthropic.md new file mode 100644 index 00000000..5ed830e3 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-anthropic.md @@ -0,0 +1,105 @@ +--- +sidebar_label: Anthropic +--- + + +# Anthropic プロバイダー + +Anthropic プロバイダーは、Reveal SDK AI を Anthropic の Claude モデルと統合し、Claude ファミリーの AI アシスタントへのアクセスを提供します。 + +## インストール + +Anthropic プロバイダーの NuGet パッケージをインストールします： + +```bash +dotnet add package Reveal.Sdk.AI.Anthropic +``` + +## 設定 + +### 基本セットアップ + +`Program.cs` で Anthropic プロバイダーを追加します： + +```csharp +using Reveal.Sdk; +using Reveal.Sdk.AI; + +var builder = WebApplication.CreateBuilder(args); + +builder.Services.AddControllers().AddReveal(); + +builder.Services.AddRevealAI() + .AddAnthropic(options => + { + options.ApiKey = builder.Configuration["RevealAI:Anthropic:ApiKey"]; + }); + +var app = builder.Build(); +app.MapControllers(); +app.Run(); +``` + +### appsettings.json の使用 + +プロバイダーは `RevealAI:Anthropic` 設定セクションに自動的にバインドされます： + +```json title="appsettings.json" +{ + "RevealAI": { + "Anthropic": { + "ApiKey": "sk-ant-your-api-key-here", + "Model": "claude-opus-4-1", + "MaxTokens": 4096 + } + } +} +``` + +設定バインディングを使用する場合、コードでのオプション設定は不要です： + +```csharp +builder.Services.AddRevealAI() + .AddAnthropic(); +``` + +## オプション + +| プロパティ | 型 | デフォルト | 説明 | +|----------|------|---------|-------------| +| `ApiKey` | `string` | `""` | **必須。** Anthropic API キー。 | +| `Model` | `string` | `"claude-opus-4-1"` | 使用する Claude モデル。 | +| `MaxTokens` | `int` | `4096` | レスポンスで生成するトークンの最大数。 | + +## 利用可能なモデル + +Anthropic はいくつかの Claude モデルを提供しています。一般的に使用されるモデルは以下の通りです： + +| モデル | 説明 | +|-------|-------------| +| `claude-opus-4-1` | 複雑なタスクに最も高い能力を持つモデル（デフォルト） | +| `claude-sonnet-4-5` | パフォーマンスと速度のバランスが取れたモデル | +| `claude-haiku-3-5` | 最も高速でコスト効率の良いモデル | + +```csharp +builder.Services.AddRevealAI() + .AddAnthropic(options => + { + options.ApiKey = builder.Configuration["RevealAI:Anthropic:ApiKey"]; + options.Model = "claude-sonnet-4-5"; + options.MaxTokens = 8192; + }); +``` + +## API キーの取得 + +1. [console.anthropic.com](https://console.anthropic.com) でアカウントを作成します +2. コンソールで **API Keys** に移動します +3. 新しい API キーを作成します +4. User Secrets または環境変数を使用して安全に保管します + +:::danger API キーをコミットしないでください + +API キーをソースコントロールにコミットしないでください。常に環境変数、User Secrets、または安全なキー管理サービスを使用してください。 + +::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-azure-openai.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-azure-openai.md new file mode 100644 index 00000000..04d4cfa0 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-azure-openai.md @@ -0,0 +1,115 @@ +--- +sidebar_label: Azure OpenAI +--- + + +# Azure OpenAI プロバイダー + +Azure OpenAI プロバイダーは、Reveal SDK AI を Azure の OpenAI Service と統合し、エンタープライズグレードのセキュリティとコンプライアンスを備えた独自の Azure サブスクリプションにデプロイされた OpenAI モデルを使用できます。 + +## インストール + +Azure OpenAI プロバイダーの NuGet パッケージをインストールします： + +```bash +dotnet add package Reveal.Sdk.AI.AzureOpenAI +``` + +## 設定 + +### 基本セットアップ + +`Program.cs` で Azure OpenAI プロバイダーを追加します： + +```csharp +using Reveal.Sdk; +using Reveal.Sdk.AI; + +var builder = WebApplication.CreateBuilder(args); + +builder.Services.AddControllers().AddReveal(); + +builder.Services.AddRevealAI() + .AddAzureOpenAI(options => + { + options.ApiKey = builder.Configuration["RevealAI:AzureOpenAI:ApiKey"]; + options.Endpoint = "https://your-resource-name.openai.azure.com/"; + options.DeploymentName = "gpt-4o"; + }); + +var app = builder.Build(); +app.MapControllers(); +app.Run(); +``` + +### appsettings.json の使用 + +プロバイダーは `RevealAI:AzureOpenAI` 設定セクションに自動的にバインドされます： + +```json title="appsettings.json" +{ + "RevealAI": { + "AzureOpenAI": { + "ApiKey": "your-azure-api-key", + "Endpoint": "https://your-resource-name.openai.azure.com/", + "DeploymentName": "gpt-4o", + "Temperature": 0.0, + "MaxTokens": 4096 + } + } +} +``` + +設定バインディングを使用する場合、コードでのオプション設定は不要です： + +```csharp +builder.Services.AddRevealAI() + .AddAzureOpenAI(); +``` + +## オプション + +| プロパティ | 型 | デフォルト | 説明 | +|----------|------|---------|-------------| +| `ApiKey` | `string` | `""` | **必須。** Azure OpenAI API キー。 | +| `Endpoint` | `string` | `""` | **必須。** Azure OpenAI エンドポイント URL（例: `https://your-resource-name.openai.azure.com/`）。 | +| `DeploymentName` | `string` | `""` | **必須。** Azure でのモデルデプロイメント名。 | +| `Temperature` | `float?` | `0.0` | ランダム性を制御（0.0 〜 2.0）。低い値ほど決定論的です。 | +| `MaxTokens` | `int?` | `4096` | レスポンスで生成するトークンの最大数。 | +| `TopP` | `float?` | `1.0` | Nucleus サンプリングパラメータ。 | +| `ReasoningEffort` | `string?` | `null` | 推論モデル（o3、o4 など）の推論努力レベル。 | + +## Azure セットアップの前提条件 + +Azure OpenAI プロバイダーを使用する前に、以下が必要です： + +1. Azure OpenAI Service にアクセスできる **Azure サブスクリプション** +2. Azure ポータルで作成された **Azure OpenAI リソース** +3. そのリソース内の **モデルデプロイメント**（例: GPT-4o、GPT-4.1） +4. Azure ポータルからの **API キー** と **エンドポイント** + +API キーとエンドポイントは、Azure ポータルの Azure OpenAI リソースの **Keys and Endpoint** セクションで確認できます。 + +## 推論モデル + +OpenAI プロバイダーと同様に、Azure OpenAI プロバイダーも推論モデルのデプロイメント（o1、o3、o4、gpt-5）を自動的に検出し、動作を調整します： + +- 推論モデルでは Temperature が無効化されます +- 推論努力を設定できます + +```csharp +builder.Services.AddRevealAI() + .AddAzureOpenAI(options => + { + options.ApiKey = builder.Configuration["RevealAI:AzureOpenAI:ApiKey"]; + options.Endpoint = "https://your-resource.openai.azure.com/"; + options.DeploymentName = "o3"; + options.ReasoningEffort = "Medium"; + }); +``` + +:::danger API キーをコミットしないでください + +API キーをソースコントロールにコミットしないでください。常に環境変数、User Secrets、または安全なキー管理サービスを使用してください。 + +::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-building-custom.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-building-custom.md new file mode 100644 index 00000000..12ba4fa7 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-building-custom.md @@ -0,0 +1,209 @@ +--- +sidebar_label: カスタムプロバイダーの構築 +--- + + +# カスタムプロバイダーの構築 + +標準でサポートされていない LLM サービスと統合する必要がある場合、`IAIProvider` インターフェースを実装し、SDK に登録することでカスタムプロバイダーを作成できます。 + +## ステップ 1: プロバイダークラスの作成 + +`IAIProvider` インターフェースを実装します： + +```csharp +using Reveal.Sdk.AI; + +public class MyCustomProvider : IAIProvider +{ + private readonly string _apiKey; + private readonly string _model; + + public MyCustomProvider(string apiKey, string model) + { + _apiKey = apiKey; + _model = model; + } + + public async Task SendPromptAsync( + ProviderRequest request, + CancellationToken cancellationToken = default) + { + var model = request.Model ?? _model; + + // ここで LLM サービスを呼び出します + var result = await CallMyLLMService(request.Prompt, model, cancellationToken); + + return new ProviderResponse + { + Content = result.Text, + FinishReason = FinishReason.Stop, + Usage = new TokenUsage + { + InputTokens = result.InputTokens, + OutputTokens = result.OutputTokens + }, + Model = model + }; + } + + private async Task CallMyLLMService( + string prompt, string model, CancellationToken cancellationToken) + { + // LLM 統合ロジックをここに実装します + throw new NotImplementedException(); + } +} +``` + +### IAIProvider インターフェース + +`IAIProvider` インターフェースは単一のメソッドを定義します： + +```csharp +public interface IAIProvider +{ + Task SendPromptAsync( + ProviderRequest request, + CancellationToken cancellationToken = default); +} +``` + +### ProviderRequest + +リクエストオブジェクトには以下が含まれます： + +| プロパティ | 型 | 説明 | +|----------|------|-------------| +| `Prompt` | `string` | LLM に送信するプロンプト。 | +| `Intent` | `string` | リクエストのインテント（例: `"default"`）。 | +| `Model` | `string?` | オプションのモデルオーバーライド。`null` の場合、プロバイダーのデフォルトモデルを使用します。 | + +### ProviderResponse + +プロバイダーは `ProviderResponse` を返す必要があります： + +| プロパティ | 型 | 説明 | +|----------|------|-------------| +| `Content` | `string` | 生成されたテキストコンテンツ。 | +| `FinishReason` | `FinishReason` | 生成が停止した理由: `Stop`、`Length`、または `ContentFilter`。 | +| `Usage` | `TokenUsage?` | オプションのトークン使用量情報。 | +| `Model` | `string?` | 実際に使用されたモデル。 | + +## ステップ 2: プロバイダーの登録 + +`IRevealAIBuilder` の `AddProvider` メソッドを使用してカスタムプロバイダーを登録します： + +```csharp +builder.Services.AddRevealAI() + .AddProvider("my-custom", sp => + { + var config = sp.GetRequiredService(); + return new MyCustomProvider( + apiKey: config["RevealAI:MyCustom:ApiKey"], + model: config["RevealAI:MyCustom:Model"] ?? "default-model" + ); + }); +``` + +最初のパラメータは **プロバイダーキー** — プロバイダーを解決するために使用される一意の文字列識別子です。2番目のパラメータは、依存性注入用の `IServiceProvider` を受け取るファクトリ関数です。 + +## ステップ 3: デフォルトとして設定（オプション） + +カスタムプロバイダーをデフォルトにするには： + +```json title="appsettings.json" +{ + "RevealAI": { + "DefaultProvider": "my-custom" + } +} +``` + +## 完全な例 + +設定バインディングを使用した完全な例を以下に示します： + +```csharp title="MyCustomProvider.cs" +using Reveal.Sdk.AI; + +public class MyCustomOptions +{ + public string ApiKey { get; set; } = string.Empty; + public string Model { get; set; } = "default-model"; + public int MaxTokens { get; set; } = 4096; +} + +public class MyCustomProvider : IAIProvider +{ + private readonly MyCustomOptions _options; + + public MyCustomProvider(MyCustomOptions options) + { + _options = options ?? throw new ArgumentNullException(nameof(options)); + } + + public async Task SendPromptAsync( + ProviderRequest request, + CancellationToken cancellationToken = default) + { + var model = request.Model ?? _options.Model; + + // LLM 統合ロジック + var responseText = await CallYourService(request.Prompt, model, cancellationToken); + + return new ProviderResponse + { + Content = responseText, + FinishReason = FinishReason.Stop, + Model = model + }; + } + + private Task CallYourService( + string prompt, string model, CancellationToken cancellationToken) + { + // LLM サービス呼び出しを実装します + throw new NotImplementedException(); + } +} +``` + +```csharp title="Program.cs" +using Reveal.Sdk; +using Reveal.Sdk.AI; + +var builder = WebApplication.CreateBuilder(args); + +builder.Services.AddControllers().AddReveal(); + +builder.Services.AddRevealAI() + .AddProvider("my-custom", sp => + { + var config = sp.GetRequiredService(); + var options = new MyCustomOptions + { + ApiKey = config["RevealAI:MyCustom:ApiKey"] ?? "", + Model = config["RevealAI:MyCustom:Model"] ?? "default-model", + MaxTokens = int.Parse(config["RevealAI:MyCustom:MaxTokens"] ?? "4096") + }; + return new MyCustomProvider(options); + }); + +var app = builder.Build(); +app.MapControllers(); +app.Run(); +``` + +## ビルトインプロバイダーとの併用 + +カスタムプロバイダーはビルトインプロバイダーと一緒に登録できます： + +```csharp +builder.Services.AddRevealAI() + .AddOpenAI() + .AddProvider("my-custom", sp => + { + return new MyCustomProvider(/* ... */); + }); +``` diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-custom-endpoints.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-custom-endpoints.md new file mode 100644 index 00000000..124f9e35 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-custom-endpoints.md @@ -0,0 +1,80 @@ +--- +sidebar_label: カスタムエンドポイント +--- + + +# カスタムエンドポイント + +OpenAI プロバイダーを使用して、任意の OpenAI 互換 API エンドポイントに接続できます。これは、ローカルモデルサーバー、サードパーティプロバイダー、または OpenAI 互換のチャット補完 API を公開するセルフホスト型モデルに接続する場合に便利です。 + +## 設定 + +OpenAI プロバイダーの `Endpoint` オプションを設定して、カスタム API を指定します： + +```csharp +builder.Services.AddRevealAI() + .AddOpenAI(options => + { + options.ApiKey = "your-api-key"; + options.Endpoint = "https://your-custom-endpoint.com/v1"; + options.Model = "your-model-name"; + }); +``` + +または `appsettings.json` を使用する場合： + +```json title="appsettings.json" +{ + "RevealAI": { + "OpenAI": { + "ApiKey": "your-api-key", + "Endpoint": "https://your-custom-endpoint.com/v1", + "Model": "your-model-name" + } + } +} +``` + +## 一般的なユースケース + +### ローカルモデルサーバー + +[Ollama](https://ollama.ai)、[LM Studio](https://lmstudio.ai)、[vLLM](https://github.com/vllm-project/vllm) などのツールは、直接使用できる OpenAI 互換 API を提供しています： + +```csharp +// Ollama の例 +builder.Services.AddRevealAI() + .AddOpenAI(options => + { + options.ApiKey = "ollama"; // Ollama は実際のキーを必要としません + options.Endpoint = "http://localhost:11434/v1"; + options.Model = "llama3"; + }); +``` + +### サードパーティプロバイダー + +多くの AI プロバイダーが OpenAI 互換エンドポイントを提供しています： + +```csharp +builder.Services.AddRevealAI() + .AddOpenAI(options => + { + options.ApiKey = "your-provider-api-key"; + options.Endpoint = "https://api.provider.com/v1"; + options.Model = "provider-model-name"; + }); +``` + +## 制限事項 + +カスタムエンドポイントを使用する場合、以下の点にご注意ください： + +- エンドポイントは OpenAI Chat Completions API 形式をサポートしている必要があります +- トークン使用量の報告はエンドポイントの互換性に依存します +- 推論モデルの検出はモデル名のパターン（o1、o3、o4、gpt-5）に基づいており、カスタムモデルには適用されない場合があります +- 一部の高度な機能はすべてのカスタムエンドポイントでサポートされるとは限りません + +## カスタムプロバイダー + +エンドポイントが OpenAI 互換 API 形式に従っていない場合は、代わりに[カスタムプロバイダーの構築](providers-building-custom.md)を検討してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-google-gemini.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-google-gemini.md new file mode 100644 index 00000000..cdb811e2 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-google-gemini.md @@ -0,0 +1,137 @@ +--- +sidebar_label: Google Gemini +--- + + +# Google Gemini プロバイダー + +Google Gemini プロバイダーは、Reveal SDK AI を Google Cloud の Vertex AI プラットフォームと統合し、Google の Gemini ファミリーのモデルへのアクセスを可能にします。 + +## インストール + +Google プロバイダーの NuGet パッケージをインストールします： + +```bash +dotnet add package Reveal.Sdk.AI.Google +``` + +## 設定 + +### 基本セットアップ + +`Program.cs` で Google Gemini プロバイダーを追加します： + +```csharp +using Reveal.Sdk; +using Reveal.Sdk.AI; + +var builder = WebApplication.CreateBuilder(args); + +builder.Services.AddControllers().AddReveal(); + +builder.Services.AddRevealAI() + .AddGoogle(options => + { + options.ProjectId = "your-gcp-project-id"; + options.CredentialsPath = "/path/to/credentials.json"; + }); + +var app = builder.Build(); +app.MapControllers(); +app.Run(); +``` + +### appsettings.json の使用 + +プロバイダーは `RevealAI:Google` 設定セクションに自動的にバインドされます： + +```json title="appsettings.json" +{ + "RevealAI": { + "Google": { + "ProjectId": "your-gcp-project-id", + "CredentialsPath": "/path/to/credentials.json", + "Location": "us-central1", + "Model": "gemini-2.5-pro" + } + } +} +``` + +設定バインディングを使用する場合、コードでのオプション設定は不要です： + +```csharp +builder.Services.AddRevealAI() + .AddGoogle(); +``` + +## オプション + +| プロパティ | 型 | デフォルト | 説明 | +|----------|------|---------|-------------| +| `ProjectId` | `string` | `""` | **必須。** Google Cloud プロジェクト ID。 | +| `CredentialsPath` | `string` | `""` | Google Cloud 認証情報 JSON ファイルのパス。 | +| `Location` | `string` | `"us-central1"` | モデルの Google Cloud リージョン。 | +| `Publisher` | `string` | `"google"` | モデルのパブリッシャー。 | +| `Model` | `string` | `"gemini-2.5-pro"` | 使用する Gemini モデル。 | +| `Temperature` | `float` | `0` | ランダム性を制御（0.0 〜 2.0）。低い値ほど決定論的です。 | +| `MaxTokens` | `int` | `32768` | レスポンスで生成するトークンの最大数。 | +| `TopP` | `float` | `1` | Nucleus サンプリングパラメータ（0.0 〜 1.0）。 | +| `TopK` | `float` | `32` | Top-K サンプリングパラメータ。考慮するトップトークン数を制御します。 | + +## Google Cloud の前提条件 + +Google Gemini プロバイダーを使用する前に、以下が必要です： + +1. 課金が有効な **Google Cloud プロジェクト** +2. プロジェクトで **Vertex AI API** が有効化されていること +3. Vertex AI ユーザーロールを持つ **サービスアカウント** +4. サービスアカウントの **認証情報 JSON ファイル** + +### 認証情報のセットアップ + +1. [Google Cloud Console](https://console.cloud.google.com) にアクセスします +2. **IAM と管理** > **サービスアカウント** に移動します +3. 新しいサービスアカウントを作成するか、既存のものを選択します +4. **Vertex AI ユーザー** ロールを付与します +5. JSON 形式でキーを作成し、ダウンロードします +6. `CredentialsPath` オプションをダウンロードした JSON ファイルのパスに設定します + +プロバイダーは `CredentialsPath` オプションに基づいて、`GOOGLE_APPLICATION_CREDENTIALS` 環境変数を自動的に設定します。 + +## 利用可能なモデル + +| モデル | 説明 | +|-------|-------------| +| `gemini-2.5-pro` | 最も高性能な Gemini モデル（デフォルト） | +| `gemini-2.5-flash` | ほとんどのタスクに高速で効率的 | +| `gemini-2.0-flash` | 前世代の高速モデル | + +```csharp +builder.Services.AddRevealAI() + .AddGoogle(options => + { + options.ProjectId = "your-project-id"; + options.CredentialsPath = "/path/to/credentials.json"; + options.Model = "gemini-2.5-flash"; + options.Location = "us-east1"; + }); +``` + +## リージョン + +`Location` オプションは、リクエストを処理する Google Cloud リージョンを決定します。一般的なオプションは以下の通りです： + +- `us-central1`（デフォルト） +- `us-east1` +- `europe-west1` +- `asia-northeast1` +- `global` + +レイテンシーを低減するために、アプリケーションに近いリージョンを選択してください。 + +:::danger 認証情報をコミットしないでください + +Google Cloud 認証情報 JSON ファイルをソースコントロールにコミットしないでください。安全に保管し、環境変数または User Secrets を通じてパスを参照してください。 + +::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-openai.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-openai.md new file mode 100644 index 00000000..92728b89 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-openai.md @@ -0,0 +1,114 @@ +--- +sidebar_label: OpenAI +--- + + +# OpenAI プロバイダー + +OpenAI プロバイダーは、Reveal SDK AI を OpenAI のチャット補完 API と統合し、GPT-4.1、GPT-4o、および o3 や o4 などの推論モデルへのアクセスを可能にします。 + +## インストール + +OpenAI プロバイダーの NuGet パッケージをインストールします： + +```bash +dotnet add package Reveal.Sdk.AI.OpenAI +``` + +## 設定 + +### 基本セットアップ + +`Program.cs` で OpenAI プロバイダーを追加します： + +```csharp +using Reveal.Sdk; +using Reveal.Sdk.AI; + +var builder = WebApplication.CreateBuilder(args); + +builder.Services.AddControllers().AddReveal(); + +builder.Services.AddRevealAI() + .AddOpenAI(options => + { + options.ApiKey = builder.Configuration["RevealAI:OpenAI:ApiKey"]; + }); + +var app = builder.Build(); +app.MapControllers(); +app.Run(); +``` + +### appsettings.json の使用 + +プロバイダーは `RevealAI:OpenAI` 設定セクションに自動的にバインドされます： + +```json title="appsettings.json" +{ + "RevealAI": { + "OpenAI": { + "ApiKey": "sk-your-api-key-here", + "Model": "gpt-4.1", + "Temperature": 0.0, + "MaxTokens": 4096 + } + } +} +``` + +設定バインディングを使用する場合、コードでのオプション設定は不要です： + +```csharp +builder.Services.AddRevealAI() + .AddOpenAI(); +``` + +## オプション + +| プロパティ | 型 | デフォルト | 説明 | +|----------|------|---------|-------------| +| `ApiKey` | `string` | `""` | **必須。** OpenAI API キー。 | +| `Model` | `string` | `"gpt-4.1"` | チャット補完に使用するモデル。 | +| `Temperature` | `float?` | `0.0` | ランダム性を制御（0.0 〜 2.0）。低い値ほど決定論的です。 | +| `MaxTokens` | `int?` | `4096` | レスポンスで生成するトークンの最大数。 | +| `TopP` | `float?` | `1.0` | Nucleus サンプリングパラメータ。 | +| `Endpoint` | `string` | `""` | カスタムエンドポイント URL。OpenAI 互換 API に使用します。 | +| `ReasoningEffort` | `string?` | `null` | 推論モデル（o3、o4 など）の推論努力レベル。 | + +## 推論モデル + +プロバイダーは推論モデル（o1、o3、o4、gpt-5）を自動的に検出し、動作を調整します： + +- 推論モデルでは Temperature が無効化されます +- `ReasoningEffort` オプションで推論努力を設定できます + +```csharp +builder.Services.AddRevealAI() + .AddOpenAI(options => + { + options.ApiKey = builder.Configuration["RevealAI:OpenAI:ApiKey"]; + options.Model = "o3"; + options.ReasoningEffort = "Medium"; + }); +``` + +## カスタムエンドポイント + +OpenAI 互換 API（ローカルモデルサーバーなど）を使用している場合、カスタムエンドポイントを指定できます： + +```csharp +builder.Services.AddRevealAI() + .AddOpenAI(options => + { + options.ApiKey = "your-api-key"; + options.Endpoint = "https://your-custom-endpoint.com/v1"; + options.Model = "your-model-name"; + }); +``` + +:::danger API キーをコミットしないでください + +API キーをソースコントロールにコミットしないでください。常に環境変数、User Secrets、または安全なキー管理サービスを使用してください。 + +::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-overview.md new file mode 100644 index 00000000..ee3980d7 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/providers-overview.md @@ -0,0 +1,89 @@ +--- +sidebar_label: 概要 +--- + + +# AI プロバイダーの概要 + +Reveal SDK AI は、さまざまな大規模言語モデル（LLM）サービスと統合できるプロバイダーベースのアーキテクチャを採用しています。各プロバイダーは個別の NuGet パッケージとして配布されるため、必要なものだけをインストールできます。 + +## 利用可能なプロバイダー + +| プロバイダー | NuGet パッケージ | 拡張メソッド | +|----------|--------------|-----------------| +| [OpenAI](providers-openai.md) | `Reveal.Sdk.AI.OpenAI` | `.AddOpenAI()` | +| [Azure OpenAI](providers-azure-openai.md) | `Reveal.Sdk.AI.AzureOpenAI` | `.AddAzureOpenAI()` | +| [Anthropic](providers-anthropic.md) | `Reveal.Sdk.AI.Anthropic` | `.AddAnthropic()` | +| [Google Gemini](providers-google-gemini.md) | `Reveal.Sdk.AI.Google` | `.AddGoogle()` | + +## プロバイダーの仕組み + +すべてのプロバイダーは `IAIProvider` インターフェースを実装し、`IRevealAIBuilder` のフルーエント API を通じて登録されます。SDK はキー付きサービスを使用した依存性注入を採用しており、複数のプロバイダーを同時に登録できます。 + +### プロバイダーの登録 + +プロバイダーは `AddRevealAI()` の後に拡張メソッドをチェーンして追加します： + +```csharp +builder.Services.AddRevealAI() + .AddOpenAI(options => + { + options.ApiKey = "your-api-key"; + }) + .AddAnthropic(options => + { + options.ApiKey = "your-api-key"; + }); +``` + +### デフォルトプロバイダー + +特定のプロバイダーが指定されていない場合、SDK はデフォルトプロバイダーを使用します。`appsettings.json` で設定できます： + +```json title="appsettings.json" +{ + "RevealAI": { + "DefaultProvider": "openai" + } +} +``` + +利用可能なプロバイダーキー: `openai`、`azure-openai`、`anthropic`、`google`。 + +### 設定のバインディング + +すべてのプロバイダーは `appsettings.json` の `RevealAI` セクションからの設定バインディングをサポートしています。コードで設定したオプションは設定ファイルの値よりも優先されます： + +```json title="appsettings.json" +{ + "RevealAI": { + "DefaultProvider": "openai", + "OpenAI": { + "ApiKey": "sk-...", + "Model": "gpt-4.1" + }, + "Anthropic": { + "ApiKey": "sk-ant-..." + } + } +} +``` + +### 複数プロバイダーの使用 + +複数のプロバイダーを登録でき、SDK はリクエストに基づいて適切なプロバイダーを解決します。以下のようなシナリオで便利です： + +- 異なる種類の分析に異なるモデルを使用する +- フォールバックオプションを提供する +- 簡単なタスクをより安価なモデルにルーティングしてコストを最適化する + +```csharp +builder.Services.AddRevealAI() + .AddOpenAI() // "openai" として登録 + .AddAnthropic() // "anthropic" として登録 + .AddGoogle(); // "google" として登録 +``` + +## カスタムプロバイダー + +標準でサポートされていない LLM サービスと統合する必要がある場合は、[カスタムプロバイダーを構築](providers-building-custom.md)できます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/sdk-chat.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/sdk-chat.md new file mode 100644 index 00000000..cf344d02 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/sdk-chat.md @@ -0,0 +1,113 @@ +--- +sidebar_label: チャット +--- + + +# チャット + +`client.ai.chat.sendMessage()` メソッドは、会話型アナリティクスを実現します。ユーザーが見たいものや理解したいことを自然言語で記述すると、AI がインサイト、説明、またはダッシュボードの生成・変更で応答します。 + +## 基本的な使い方 + +```typescript +import { RevealSdkClient } from '@revealbi/api'; + +const client = RevealSdkClient.getInstance(); + +// Send a message and get the complete response +const response = await client.ai.chat.sendMessage({ + message: 'Show me sales trends for the last quarter', + datasourceId: 'my-datasource', +}); + +console.log(response.explanation); +// "I've analyzed your sales data for Q4 2024..." + +if (response.dashboard) { + // Load the generated dashboard + loadDashboard(response.dashboard); +} +``` + +## 会話の管理 + +AI はサーバー側で会話履歴を保持しており、文脈に沿ったフォローアップの質問が可能です。履歴をクリアして最初からやり直すことができます。 + +```typescript +// Reset the conversation context +await client.ai.chat.resetContext(); + +console.log('Conversation history cleared'); +``` + +以下の場合に使用します: +- 新しいトピックを開始するとき +- データソースを切り替えるとき +- ユーザーが明示的に「最初からやり直す」ことをリクエストしたとき + +## ダッシュボードコンテキスト + +編集や分析のために既存のダッシュボードを提供します。 + +```typescript +// Edit an existing dashboard +const response = await client.ai.chat.sendMessage({ + message: 'Add a date filter to this dashboard', + datasourceId: 'my-datasource', + dashboard: existingDashboardJson, // Provide current dashboard JSON +}); + +if (response.dashboard) { + // Load the modified dashboard + loadDashboard(response.dashboard); +} +``` + +**RVDashboard オブジェクトの使用:** + +```typescript +// From RevealView +const currentDashboard = revealView.dashboard; + +const response = await client.ai.chat.sendMessage({ + message: 'Explain what this dashboard shows', + datasourceId: 'my-datasource', + dashboard: currentDashboard, // Accepts RVDashboard object +}); + +console.log(response.explanation); +``` + +## ストリーミング + +任意のリクエストに `stream: true` を追加すると、レスポンスをリアルタイムで受信できます。利用パターンと例については、[ストリーミングレスポンス](./sdk-streaming.md) を参照してください。 + +--- + +## リクエストパラメーター + +すべてのパラメーターは単一のリクエストオブジェクトで渡します。 + +| パラメーター | 型 | 必須 | 説明 | +|-----------|------|----------|-------------| +| `message` | `string` | はい | ユーザーの自然言語メッセージまたはリクエスト | +| `datasourceId` | `string` | いいえ | コンテキスト用のデータソース識別子 | +| `dashboard` | `string \| RVDashboard` | いいえ | 編集・分析用のダッシュボード JSON または RVDashboard オブジェクト | +| `visualizationId` | `string` | いいえ | ビジュアライゼーション固有のコンテキスト用のビジュアライゼーション ID | +| `intent` | `string` | いいえ | 自由形式の LLM クエリ用のインテント | +| `updateChatState` | `boolean` | いいえ | このクエリの後にチャットの状態を更新するかどうか | +| `model` | `string` | いいえ | 使用する特定の LLM モデルの名前 | +| `signal` | `AbortSignal` | いいえ | リクエストをキャンセルするための AbortSignal | +| `stream` | `boolean` | いいえ | ストリーミングモードを有効にする（デフォルト: `false`） | + +## レスポンスの型 + +```typescript +interface ChatResponse { + explanation?: string; // AI-generated explanation + dashboard?: string; // Generated/modified dashboard JSON + error?: string; // Error message if request failed +} +``` + +`explanation` フィールドには AI の自然言語レスポンスが含まれます。`dashboard` フィールドはダッシュボードが生成または変更された場合に値が設定されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/sdk-error-handling.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/sdk-error-handling.md new file mode 100644 index 00000000..31c31133 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/sdk-error-handling.md @@ -0,0 +1,83 @@ +--- +sidebar_label: エラーハンドリング +--- + + +# エラーハンドリング + +このトピックでは、Reveal SDK AI クライアントを使用する際のエラー処理方法について説明します。 + +## エラーハンドリング + +### 非ストリーミング + +リクエストを try/catch ブロックで囲みます。 + +```typescript +try { + const insight = await client.ai.insights.get({ + dashboardId: 'sales-dashboard', + type: 'summary', + }); + displayInsight(insight.explanation); +} catch (error) { + console.error('Request failed:', error); + showErrorMessage(error.message); +} +``` + +チャットにも同じパターンが適用されます。 + +```typescript +try { + const response = await client.ai.chat.sendMessage({ + message: 'Show me sales trends', + datasourceId: 'my-datasource', + }); + displayResponse(response.explanation); + + if (response.dashboard) { + loadDashboard(response.dashboard); + } +} catch (error) { + console.error('Chat request failed:', error); + showErrorMessage(error.message); +} +``` + +### ストリーミング + +ストリームの `error` イベントをリッスンします。 + +```typescript +const stream = await client.ai.insights.get({ + dashboardId: 'sales-dashboard', + type: 'summary', + stream: true, +}); + +stream.on('text', (content) => appendToUI(content)); +stream.on('error', (error, details) => { + console.error('Stream error:', error); + showErrorMessage(error); +}); + +await stream.finalResponse(); +``` + +`for-await` パターンでもエラーを処理できます。 + +```typescript +const stream = await client.ai.insights.get({ + dashboardId: 'sales-dashboard', + type: 'summary', + stream: true, +}); + +for await (const event of stream) { + switch (event.type) { + case 'text': appendToUI(event.content); break; + case 'error': showErrorMessage(event.error); break; + } +} +``` diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/sdk-insights.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/sdk-insights.md new file mode 100644 index 00000000..1926b099 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/sdk-insights.md @@ -0,0 +1,107 @@ +--- +sidebar_label: インサイト +--- + + +# インサイト + +`client.ai.insights.get()` メソッドは、ダッシュボードやビジュアライゼーションから AI を活用したサマリー、分析、予測を生成します。 + +## 基本的な使い方 + +```typescript +import { RevealSdkClient } from '@revealbi/api'; + +const client = RevealSdkClient.getInstance(); + +// Get a summary for an entire dashboard +const insight = await client.ai.insights.get({ + dashboardId: 'sales-dashboard', + type: 'summary', +}); + +console.log(insight.explanation); +// "Sales revenue reached $2.4M in Q4 2024..." +``` + +## インサイトタイプ + +`type` パラメーターを指定して、分析の種類を制御します: + +```typescript +// Summary - concise overview of key metrics +const summary = await client.ai.insights.get({ + dashboardId: 'sales-dashboard', + type: 'summary', +}); + +// Analysis - detailed interpretation of trends and patterns +const analysis = await client.ai.insights.get({ + dashboardId: 'sales-dashboard', + type: 'analysis', +}); + +// Forecast - predictions based on historical data +const forecast = await client.ai.insights.get({ + dashboardId: 'sales-dashboard', + type: 'forecast', + forecastPeriods: 12, // Forecast 12 periods ahead (default: 6) +}); +``` + +## ダッシュボードオブジェクトの使用 + +ダッシュボード ID の代わりに、ダッシュボードオブジェクトを直接渡すこともできます: + +```typescript +// Using RVDashboard object from RevealView +const insight = await client.ai.insights.get({ + dashboard: revealView.dashboard, // RVDashboard object + type: 'analysis', +}); +``` + +## ビジュアライゼーションレベルのインサイト + +ビジュアライゼーション ID を指定して、特定のビジュアライゼーションを分析します: + +```typescript +const insight = await client.ai.insights.get({ + dashboardId: 'sales-dashboard', + visualizationId: 'sales-by-region-chart', // Specific visualization + type: 'summary', +}); +``` + +## ストリーミング + +任意のリクエストに `stream: true` を追加すると、リアルタイムでレスポンスを受信できます。利用パターンと例については、[ストリーミングレスポンス](./sdk-streaming.md)を参照してください。 + +--- + +## リクエストパラメーター + +すべてのパラメーターは単一のリクエストオブジェクトで渡します: + +| パラメーター | 型 | 必須 | 説明 | +|-----------|------|----------|-------------| +| `dashboard` | `string \| RVDashboard` | * | RevealView からのダッシュボードオブジェクトまたは JSON 文字列 | +| `dashboardId` | `string` | * | ダッシュボード識別子 | +| `visualizationId` | `string` | いいえ | 分析対象のビジュアライゼーション ID | +| `type` | `InsightType` | はい | タイプ: `'summary'`、`'analysis'`、`'forecast'` | +| `forecastPeriods` | `number` | いいえ | 予測する期間数（デフォルト: 6） | +| `model` | `string` | いいえ | 使用する特定の LLM モデルの名前 | +| `signal` | `AbortSignal` | いいえ | リクエストをキャンセルするための AbortSignal | +| `stream` | `boolean` | いいえ | ストリーミングモードを有効にする（デフォルト: `false`） | + +\* `dashboard` または `dashboardId` のいずれかを指定する必要があります + +## レスポンスタイプ + +```typescript +interface InsightResponse { + explanation: string; // Complete AI-generated explanation +} +``` + +`explanation` フィールドには、非ストリーミングモードでもストリーミングモードでも、完全なインサイトテキストが含まれます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/sdk-overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/sdk-overview.md new file mode 100644 index 00000000..a9eea992 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/sdk-overview.md @@ -0,0 +1,101 @@ +--- +sidebar_label: 概要 +--- + + +# SDK の使い方 + +Reveal SDK AI クライアントは、Web アプリケーションに AI 機能を提供する TypeScript/JavaScript ライブラリです。**インサイト**（データ分析の生成）と**チャット**（対話型アナリティクス）の2つの主要な API を公開しており、どちらも単一のクライアントインスタンスからアクセスできます。 + +## 初期化 + +AI 機能を使用する前に、サーバー URL を指定してクライアントを初期化します: + +```typescript +import { RevealSdkClient } from '@revealbi/api'; + +RevealSdkClient.initialize({ + hostUrl: 'https://your-server.com' +}); +``` + +UMD/CDN を使用する場合: + +```typescript +rv.RevealSdkClient.initialize({ + hostUrl: 'https://your-server.com' +}); +``` + +:::info + +クライアント SDK を使用するには、[AI サーバー SDK](/ai/install-server-sdk) がインストールされ、実行されている必要があります。すべての AI リクエストは、設定された LLM プロバイダーによってサーバーサイドで処理されます。 + +::: + +## クライアントインスタンスの取得 + +初期化後、アプリケーション内のどこからでも共有クライアントインスタンスを取得できます: + +```typescript +const client = RevealSdkClient.getInstance(); +``` + +## API サーフェス + +クライアントは `client.ai` 名前空間を通じて AI 機能を公開します: + +### インサイト + +ダッシュボードやビジュアライゼーションからサマリー、分析、予測を生成します: + +```typescript +const insight = await client.ai.insights.get({ + dashboardId: 'sales-dashboard', + type: 'summary', +}); + +console.log(insight.explanation); +``` + +詳しくは[インサイト](./sdk-insights.md)をご覧ください。 + +### チャット + +ユーザーが自然言語でデータと対話できる会話型インターフェースを構築します: + +```typescript +const response = await client.ai.chat.sendMessage({ + message: 'Show me sales by region for Q4', + datasourceId: 'my-datasource', +}); + +console.log(response.explanation); +``` + +詳しくは[チャット](./sdk-chat.md)をご覧ください。 + +## ストリーミングと非ストリーミング + +両方の API で2つのレスポンスモードがサポートされています: + +- **非ストリーミング**（デフォルト）: 完全なレスポンスを待ちます。シンプルで分かりやすい方式です。 +- **ストリーミング**: テキストが生成されるとリアルタイムで受信し、ChatGPT のような体験を提供します。 + +ストリーミングを有効にするには、任意のリクエストに `stream: true` を追加します: + +```typescript +const stream = await client.ai.insights.get({ + dashboardId: 'sales-dashboard', + type: 'summary', + stream: true, +}); + +stream.on('text', (content) => { + console.log(content); // Text arrives in chunks +}); + +const result = await stream.finalResponse(); +``` + +詳しくは[ストリーミングレスポンス](./sdk-streaming.md)をご覧ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/sdk-streaming.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/sdk-streaming.md new file mode 100644 index 00000000..ae9e2ebc --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/sdk-streaming.md @@ -0,0 +1,101 @@ +--- +sidebar_label: ストリーミングレスポンス +--- + + +# ストリーミングレスポンス + +[インサイト](./sdk-insights.md) と [チャット](./sdk-chat.md) の両方の API はストリーミングモードをサポートしており、生成されたレスポンスをリアルタイムで配信します。これにより、ユーザーは完全なレスポンスを待つのではなく、テキストが徐々に表示される ChatGPT のような体験が得られます。 + +任意のリクエストに `stream: true` を追加することでストリーミングを有効にできます。ストリーミングが有効な場合、メソッドは直接のレスポンスの代わりに `AIStream` オブジェクトを返します。 + +## 利用パターン + +`AIStream` はイベントを利用する 3 つの方法をサポートしています。ユースケースに合ったパターンを選択してください。 + +### パターン 1: for-await（フルコントロール） + +すべてのイベントを反復処理して、各イベントタイプを最大限に制御します。 + +```typescript +const stream = await client.ai.insights.get({ + dashboardId: 'sales-dashboard', + type: 'summary', + stream: true, +}); + +for await (const event of stream) { + switch (event.type) { + case 'progress': console.log('Status:', event.message); break; + case 'text': document.getElementById('output').textContent += event.content; break; + case 'error': console.error('Error:', event.error); break; + } +} +``` + +### パターン 2: イベントリスナー（シンプルな UI 連携） + +特定のイベントタイプのハンドラーを登録します。 + +```typescript +const stream = await client.ai.chat.sendMessage({ + message: 'Show me sales by region', + datasourceId: 'my-datasource', + stream: true, +}); + +stream.on('progress', (message) => console.log('Status:', message)); +stream.on('text', (content) => { + document.getElementById('output').textContent += content; +}); +stream.on('error', (error) => console.error('Error:', error)); + +const result = await stream.finalResponse(); +console.log('Complete:', result.explanation); +``` + +### パターン 3: ストリームからの集約結果 + +通信上はストリーミングを使用しつつ、完全なレスポンスを待ちます。 + +```typescript +const stream = await client.ai.insights.get({ + dashboardId: 'sales-dashboard', + type: 'summary', + stream: true, +}); + +// Wait for completion, returns InsightResponse +const result = await stream.finalResponse(); +console.log(result.explanation); +``` + +これは、個々のイベントを処理せずに、サーバー側のストリーミングのメリット（長時間実行リクエストのタイムアウト回避など）を活用したい場合に便利です。 + +--- + +## AIStream リファレンス + +`stream: true` の場合、戻り値の型は `AIStream` になります。ここで `T` はレスポンスの型（`InsightResponse` または `ChatResponse`）です。 + +| メソッド / パターン | 説明 | +|---------|-------------| +| `for await (const event of stream)` | イベントが到着するたびに反復処理する | +| `.on(event, handler)` | イベント固有のリスナーを登録する | +| `.finalResponse()` | 完全なレスポンスで解決される Promise を返す | +| `.abort()` | ストリームをキャンセルする | + +## ストリームイベント + +```typescript +type AIStreamEvent = + | { type: 'progress'; message: string } + | { type: 'text'; content: string } + | { type: 'error'; error: string; details?: unknown }; +``` + +| イベントタイプ | 説明 | +|------------|-------------| +| `progress` | 生成中のステータスメッセージ（例: "Analyzing dashboard data..."、"Creating a new dashboard"） | +| `text` | 生成されたレスポンスのテキストフラグメント | +| `error` | 生成が失敗した場合のエラー情報 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/system-requirements.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/system-requirements.md new file mode 100644 index 00000000..c4f951d8 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/ai/system-requirements.md @@ -0,0 +1,59 @@ +--- +sidebar_label: システム要件 +--- + + +# システム要件 + +Reveal SDK AI 機能を使用するには、以下の前提条件が必要です： + +## クライアント SDK の要件 + +### ウェブブラウザー + +Reveal SDK AI クライアントは、以下をサポートするモダンなウェブブラウザーで動作します： + +- ES2020 JavaScript 機能 +- Async/Await +- Fetch API +- Server-Sent Events (SSE) + +**サポートされているブラウザー：** +- Chrome/Edge 90+ +- Firefox 88+ +- Safari 14+ + +### JavaScript フレームワーク（オプション） + +クライアント SDK はバニラ JavaScript でも動作しますが、以下のフレームワークとシームレスに統合できます： + +- Angular 15+ +- React 18+ +- Vue 3+ +- またはその他のモダンな JavaScript フレームワーク + +## サーバー SDK の要件 + +### ASP.NET Core + +- ASP.NET 8.0 以上 + +## Reveal SDK の基本要件 + +Reveal SDK AI はベースの Reveal SDK を拡張するものであるため、標準的な Reveal SDK の要件も満たす必要があります： + +- 有効な Reveal SDK ライセンス +- Reveal SDK Web (JavaScript) パッケージ +- Reveal.Sdk.AspNetCore パッケージ（互換性のあるバージョン） + +### TypeScript サポート + +- TypeScript 5.0+（完全な型安全性を実現するため） +- SDK は TypeScript で記述されており、完全な型定義を提供します + +## 次のステップ + +お使いの環境がこれらの要件を満たしていることを確認したら： + +1. [サーバー SDK のインストール](install-server-sdk.md) - バックエンドコンポーネントをセットアップします +2. [クライアント SDK のインストール](install-client-sdk.md) - JavaScript パッケージをアプリケーションに追加します diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/category-charts.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/category-charts.md new file mode 100644 index 00000000..f395bc0a --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/category-charts.md @@ -0,0 +1,48 @@ +--- +title: 表示形式にカテゴリ チャートを使用する方法 +_description: カテゴリ チャートを使用して表示形式を向上させる方法を説明します。 +_language: ja +--- + +# カテゴリ チャート + +これらのチャートを使用して、カテゴリを定量的情報に関連付けます。 + +![Category charts variations](images/category-charts-list.png) + +データに適している限り、表示形式オプション メニューに表示されたチャート アイコンをどれでも選択できます。Reveal はデータセットの最初の数字の列を選択し、選択したチャート タイプのデータ系列の要件と一致させようと試みます。 + +![Various charts visualizations in a dashboard](../images/various-charts-example.png) + +たとえば、柱状チャートでは、すべての数値列がチャートに追加されます。Reveal の列の自動選択は、チャートの設定の構成で変更できます。 + +## チャートの近似曲線 + +チャートの設定で近似曲線の表示を有効にできます。このラインはアルゴリズムに基づいてチャートにラインを表示します。近似曲線でデータセットの傾向を把握し、意思決定のためのしきい値を定義できます。サポートされるトレンド ラインは、二次フィット、キュービック フィット、四次フィット、対数フィット、指数フィト、べき乗フィット、単純平均、指数平均、修正平均、累加平均、加重平均です。 + +![Chart trendline options](images/chart-trendline-option.png) + +## パーセンテージの配分 + +積層型シリーズ チャートにもこの機能を構成できます。0-100 のデフォルト スケールを上書きして、チャートで値のパーセンテージ配分を表示形式できます。 + +![Pivot editor view stacked percentage distribution setting](images/percentage-distribution-option-stacked-series-charts.png) + +## 開始位置とスライス ラベル + +**円チャート**および**ドーナツ型チャート**でチャートのスライスを回転する開始位置を構成し、データの表示順序を変更できます。 + +![Start position setting while using a doughnut chart](images/start-position-setting-doughnut-chart-example.png) + +**ファンネル**、**円チャート**、および**ドーナツ型**チャート、値やパーセンテージ、またはその両方を同時に表示するスライス ラベルを構成できます。 + +![Pivot editor slice labels setting](images/slice-label-setting-doughnut-chart-example.png) + +## 値 0 の要素を表示するために円チャートおよびドーナツ チャートの凡例を有効化 + +円およびドーナツ チャートの表示形式の凡例には、**[ラベル]** に選択されたフィールドのすべてのデータ (値 0 の要素を含む) を表示するオプションがあります。 + +この設定を有効にするには、以下の画像のように、表示形式エディターの **[設定]** に移動し、**[0 (ゼロ) 値を凡例に表示]** を選択します。 + +![Enabling the legend setting in the visualization editor](images/pie-chart-example-legends-value-zero-setting.png) + diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/choropleth-map.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/choropleth-map.md new file mode 100644 index 00000000..dec67d74 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/choropleth-map.md @@ -0,0 +1,104 @@ +--- +title: 表示形式に階級区分図を使用する方法 +_description: 階級区分図を使用して地理的データを表示する方法を説明します。 +_language: ja +--- + +# 階級区分図 + +階級区分図は、分割された地理的領域または地域の統計データを表すことを目的とした広範なテーマ別のマップです。マップの各領域は、データ変数に関連して均一な色で塗りつぶされます。 +このトピックでは、マップの領域を「図形」とも呼びます。 + +![A choropleth map showing 2016 general elections in the US](images/presidential-election-2016-map-example.png) +Reveal では、階級区分図に表示されるマップ タイプは一般的な政治マップです。つまり、マップ内の個々の図形は大陸、国、州、郡、政治組合などです。 + +マップは以下の 3 つの異なる配色をサポートします。 + + * **単色**は、データを含むすべての図形を同じ色でスタイル設定します。データのない図形はグレーアウトされます。 + + * **値範囲**は、7 色のいずれかを使用して図形をスタイル設定します。明るい色から暗い色は、低から高へのデータ値を表します。 + + * **マップ カラー**は、[マップ カラー] フィールドの一意の識別子にテーマの色を割り当てます。この配色では、図形はその図形の最高値/最低値を持つ識別子に基づいてスタイル設定されます。[この例](#マップ-カラーを使用したマルチカラー階級区分図の作成)を参照してください。 + +マップ カラーを設定する方法については、[階級区分図の設定](settings-choropleth-map.md)トピックを参照してください。 + +Reveal の階級区分図では、階層データを[ドリル ダウン](#階層レベルのドリル-アップとドリル-ダウン)することもできます。 + +## 階級区分図の表示形式の使用 + +通常、階級区分図は、公開レポート、統計分析、および境界が重要なその他の情報をわかりやすく表示するために使用されます。階級区分図は、数量の密度 (比率) の表示、領域の比較、トレンドの確認、パターンおよび異常の検出に最適です。たとえば、階級区分図を使用して米国のマップで肥満率の高い地域を検索したり、ヨーロッパ全体での殺人率を表示したりできます。 + +階級区分図でのデータの使用方法に注意してください。大きさであまりにも異なる領域を比較したい場合があります。データをデータ点数 (数値) ではなく、**レート/比率** (パーセンテージ) で表示することをお勧めします。 + +たとえば、異なる国の交通死を生の数のみで比較した場合、人口により誤解を与える結果が得られます。データ点数が大きいため、中国など人口密度の高い国は常に暗い色で表示されます。 + +以下は、東アジアの人口 10 万人あたりの交通死を示すマップです。ここでは、大国の人口に惑わされることなく、アジア諸国の運転文化について現実的な結論を出すことができます。 + +![A choropleth map of Eastern Asia showing traffic deaths per 100 000](images/road-traffic-deaths-eastern-asia-example.png) + +階級区分図の表示形式のためのデータ選択は、提供したい情報に依存します。地域全体で伝染病の広がりを示したい場合、データ点数を使用することが適切です。 + + +## 場所データのデータ要件 + +Reveal には、階級区分図の表示形式に使用できるさまざまな定義済みマップがあります。データセットで提供するために必要な最低限の情報は以下のとおりです。 + + - 特定の場所の定量データ (値)。 + + - 場所名。 + +データセットの**場所名**列は、選択したマップの実際の地理単位と一致する必要があります。たとえば、米国マップを選択した場合、データセットに州の名前を含む列を提供する必要があります。 + +Reveal に場所の列を認識させるには、場所の完全名または公式の 2 文字または 3 文字の略語を入力します。完全名と略語を混在させないでください。 + +場所の形式および要件の詳細については、[階級区分図のデータを準備する方。法場所のデータ要件](location-data-requirements.md)を参照してください。 + +## 階級区分図の作成 + +以下の例では、階級区分図を使用して、米国での最後の大統領選挙 (2016 年) の結果を分析します。 + +このチュートリアルを実行するには、2016 November General Election スプレッドシートをダウンロードし、クラウド プロバイダーにアップロードして以下の手順を実行します。 + +1. スプレッドシートをアップロードしたクラウド プロバイダーに接続します。 + +2. 表示形式エディターで、**階級区分図**の表示形式を選択します。 +![Select choropleth map visualization from the list of chart types](images/chart-types-choropleth.png) +3. **[階級区分図データ]** セクションで、**[マップ]** ドロップダウン メニューから [アメリカ合衆国の州] マップを選択します。米国のマップのアウトラインが画面に表示されます。 +![List of available maps](images/list-available-maps.png) +4. **[場所]** プレースホルダーに **State** または **State Abv** フィールドをドロップします。両方とも米国の州のリストを含みます。 + +5. **[値]** で、マップする定量データを含むフィールドを選択します。この例では、すべての州の投票率を含む **Total Votes (%)** を使用します。 + +6. **[値]** フィールドを書式設定してパーセンテージを表示します。**[値]** ⇒ **[書式設定]** ⇒ **[タイプ]** ⇒ **[パーセント]** で **Total Votes (%)** を選択します。 + +7. **[データ フィルタ]ー** プレースホルダーでフィールドを選択すると、フィルターを追加できます **(オプション)**。 + +その結果、州ごとに分割された USA マップが表示されます。州の有権者の割合が大きいほど、その州の青色が強くなります。 + +![Choropleth map visualization](images/choropleth-visualization-example.png) + +## マップ カラーを使用したマルチカラー階級区分図の作成 + +代わりに、**[マップ カラー]** プロパティを設定して、マップの各領域の色を制御できます。これは、領域内でどの候補者または政党が上位/下位票を獲得したかなどを反映するのに役立ちます。 + +![A choropleth map using the color category](images/color-choropleth-map-example.png) + +上記の例では、Donald Trump、Hillary Clinton、および Other が 2016 年の投票で比較されています。州の色は、選挙で誰が最も多く投票されたかによって異なります。 + +色付け条件を変更するには: + +**[設定]** ⇒ **[カラーの基準値]** ⇒ **[最高値]**。 + + +## 階層レベルのドリル アップとドリル ダウン + +階級区分図領域をドリル アップおよびドリル ダウンして、場所データの階層レベルを動的に検出できます。 + +ドリル ダウン オプションを有効にするには、**[場所]** プレースホルダーで複数のデータ フィールドを追加して下位レベルを作成する必要があります。たとえば、新しい階層レベルとして米国の州の下に郡を追加すると、州レベルで全体像を表示し、郡レベルで詳細を調査することもできます。 + +マップ上の図形をホバーすると強調表示され、ツールチップが表示されます (以下を参照)。[ドリル ダウン] オプションをクリックして、次の場所階層レベルのマップを表示します。 +![Drill down to tooltip shown for a state](images/drill-down-option-choropleth-map.png) + +:::note +**利用可能なマップ:** 下位レベルのマップが使用可能な場合のみ、マップにドリル ダウンできます。**[階級区分図データ]** セクションの **[マップ]** で使用可能なマップを検索します。 +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/combo-charts.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/combo-charts.md new file mode 100644 index 00000000..3f416cbc --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/combo-charts.md @@ -0,0 +1,55 @@ +--- +title: 複合チャートを作成して使用する方法 +_description: Reveal で表示形式に複合チャートを使用する方法を説明します。 +_language: ja +--- + +# 複合チャート + +1 つのチャートに複数の種類のチャートを組み合わせたチャートです。 + +通常のチャートには、X 軸と Y 軸が 1 つづつ必要です。複合チャートには 2 つの Y 軸があり、同じチャートに 2 種類のデータ ポイントを表示できます。 + +![Combo chart sample within Reveal](images/combo-chart-example.png) + +たとえば、上記のように、複合チャートは国の総人口および若い人口を表示して、それらの間の関係を示すことができます。 + +![Selecting the Combo Chart visualization in Reveal](images/combo-chart-selection.png) + +データ ソースと**複合**の表示形式を選択した後、デフォルトでは、柱状チャートと折れ線チャートを組み合わせて開始します。最初の画像のように、両方のチャートの [ラベル] と [値] を構成する必要があります。 + +## 複合チャートの設定 + +![Combo Charts configuration settings in Reveal](images/combo-chart-settings.png) + +[設定] では: + + - **スタイルを選択できます。** + + タイトルまたは凡例を有効にするか、開始色を選択できます。 + + - **自動的なラベル回転を有効にできます。** + + - **ズーム レベルを調整できます。** + + - **一方または両方のチャートの表示形式タイプを変更できます**。 + + 7 つの使用可能なタイプ (柱状、積層型柱状、エリア、折れ線、ステップ エリア、ステップ折れ線、スプライン エリア) から選択できます。 + + - **リニア スケールまたは対数を選択できます**。 + + 対数の場合、値のスケールは通常のリニア スケールを使用する代わりに大きさを使用するリニア スケール以外で計算されます。 + + - **チャートの最小値および最大値を設定できます。** + + デフォルトで最小は 0 に設定され、最大値は使用されるデータによって設定されます。 + + - **両方のチャートの左軸を共有することを選択できます**。 + + デフォルトでは、左軸と右軸が使用されます。 + + - **上のチャートを切り替えることができます**。 + + Reveal は、背面に表示されるチャートに不透明度を適用し、より透明にします。 + +- **[この表示形式を別のダッシュボードまたは URL に接続できます](../dashboard-linking.md)。** diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/financial-charts.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/financial-charts.md new file mode 100644 index 00000000..dc7b8df1 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/financial-charts.md @@ -0,0 +1,16 @@ +--- +title: 財務チャートを作成して使用する方法 +_description: Reveal で表示形式に財務チャートを使用する方法を説明します。 +_language: ja +--- + +# 財務チャート + +財務チャートは、終日の株価の動き (始値と終値、最高値と最低値) を表すために使用されます。 + +![Using financial chart in a dashboard](images/financial-chart-types.png) + +各ロウソクまたは OHLC セクションの色は、終値が開始値を下回っているか上回っているかを表すためのものです。 + +![Financial Charts Sample visualization](images/financial-charts-example.png) + diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/gauge-charts.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/gauge-charts.md new file mode 100644 index 00000000..9591cb64 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/gauge-charts.md @@ -0,0 +1,53 @@ +--- +title: ゲージ チャートを作成して使用する方法 +_description: Reveal で表示形式にゲージ チャートを使用する方法を説明します。 +_language: ja +--- + +# ゲージ チャート + +ゲージ チャートは単一値を表示します。または、それらを範囲しきい値と比較した値のリストを表示します。ゲージはまた、他の範囲の条件付き書式設定を可能にします。Reveal では、次のゲージ チャートを使用できます: [リニア](#リニア-ゲージ)、[円形](#円形ゲージ)、[テキスト](#テキスト-ゲージ)、[KPI](kpi-gauge.md)、[ブレット グラフ](#ブレット-グラフ)。 + + +## リニア ゲージ + +リニア ゲージは、ラベル、**[ラベル]** のプレースホルダーの設定から取得された値、および設定 **[値]** のプレースホルダーの値が表示されます。値は、四角形としてチャート化され、バンド内または隣りに数値形式で表示されます。このゲージ タイプは、行の値を並べて比較することに適しています。 + +![Linear gauge chart example in the Visualization editor](images/linear-gauge-example.png) + + +## 円形ゲージ + +円形ゲージは、バンドの最大および最小のしきい値、および現在の値を表示します。現在の範囲の色で背景も塗りつぶします。 + +![Circular gauge chart example in the Visualization editor](images/circular-gauge-view-example.png) + + +## テキスト ゲージ + +テキスト ゲージは、大きなフォントで Value 列データを表示します。このタイプは、非常に優先度の高いメトリックに適しています。デフォルトでは、いずれかのフィルターが適用されていない限り、選択データ行が異なるようにゲージは最初のデータ行の値列のデータを表示します。 + +![Text gauge chart example in the Visualization editor](images/text-view-gauge.png) + + +## ブレット グラフ + +ブレット グラフ ゲージは、リニア ゲージに似ていて、**[ラベル]** のプレースホルダーからラベルを表示し、**[値]** のプレースホルダーから値を表示します。値は水平線でチャート化され、数字形式で右側にも表示されます。 + +ブレット グラフは新しいビジュアル インジケーターをリニア ゲージに追加します。**[ターゲット]** プレースホルダーの目標値をベースにした垂直マークです。これは新しいインジケーターで数値列から取得されます。**このチャートを構成するには 2 つの数値列とテキスト列が必要です**。 + +![Bullet graph gauge chart example in the Visualization editor](images/bullet-graph-example.png) + +このブレット は、値を左右に並べて比較する際に便利です。また、目標値 (垂直マーク) に対する値 (水平線) からパフォーマンスを評価できます。 + + +## バンドの構成 + +すべてのゲージ タイプには共通のバンド範囲構成があり、これは表示形式エディターの **[設定]** セクションにあります。構成ダイアログでは、**制限**を設定できます: これらの値は自動的に指定された値の列のデータセット内の最大値/最小値として設定されますが、定数値を使用して手動でオーバーライドすることができます。 + + +バンド構成を設定する際、範囲を 3 つのスペースに分割するために 2 つのしきい値を設定する必要があります。しきい値は、パーセンテージとして定義または定数値として定義することができます。また、ここに各バンドに関連付ける色を定義する必要があります。デフォルトでは上部のバンドは緑、中央は黄、下部は赤です。 + +![Gauge band configurations in the Settings section](images/gauge-band-settings.png) + +バンド構成は、Reveal を通じて適用された書式ではなく、**元のデータに基づいています**。上の円型ゲージでは、表示形式が数値を表示するように書式設定されていても、元のデータはパーセンテージで表されています。したがって、選択された **[値比較タイプ]** は **[パーセンテージ]** であり、範囲は数値ではなくパーセンテージとして定義されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/grid-chart.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/grid-chart.md new file mode 100644 index 00000000..a6ee8ea3 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/grid-chart.md @@ -0,0 +1,37 @@ +--- +title: 表示形式エディターでグリッド チャートを作成して使用する方法 +_description: Reveal で表示形式にグリッド チャートを使用する方法を説明します。 +_language: ja +--- + +# グリッド チャート + +## 表示形式エディターでグリッド チャートを操作する + +グリッド チャートは、データを表示するための １つの表示形式オプションであり、情報を行列で表示します。グリッド ヘッダーを選択すると列全体が強調表示され、**列の幅を変更できます**。列幅を変更するには右または左へスライドさせます。 + +![Resizing a column's width in a grid chart](images/grid-chart-example.png) + +**[設定]** で [フォント サイズ] を変更できます。デフォルト サイズは **[小]** です。**[中]** サイズでは 2px 大きくなり、**[大]** サイズは 4px 大きくなります。 + +![Different options for the font size](images/grid-chart-font-sizes.png) + +先頭列を固定配置に設定するには、**[設定]** の下の **[最初の固定列]** オプションをチェックします。これは、特に多くの列を処理する場合に便利です。 + +:::note +行数および列が 10 より小さい場合、グリッド チャートはダッシュボードに適しています。少量のデータを扱っている場合、数字だけを表示するのが適切な方法となる場合があります。 +::: + +## ダッシュボード ビュー モードで列を並べ替える + +**ダッシュボード ビュー モード**でグリッド チャートの列の並べ替え (昇順や降順) を変更できます。列名の横にある矢印ボタンを選択して変更できます。 + +![Grid Chart Sorting Columns Options](images/grid-chart-sorting.png) + +複数の並べ替え条件を適用できます。次に、既存の列ヘッダーの横に小さな番号が表示されます。矢印の方向は、昇順または降順のどちらの並べ替えを適用したかを判断するのに役立ちます。 + +![Sorting View All Numbers](images/grid-chart-sorting-number-options.png) + +並べ替えオプションは、**[すべてクリア]** または **[なし]** で削除できます。他に削除されていない並べ替えオプションがある場合、順序は列ヘッダーの横の番号によって決定されます。 + +![Sorting View Mode Remove](images/grid-chart-none-sorting-option.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/image-chart.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/image-chart.md new file mode 100644 index 00000000..7b551d08 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/image-chart.md @@ -0,0 +1,7 @@ +# 画像チャート + +画像チャートは URL へリクエストして、埋め込みブラウザーに情報と結果を表示します。**データセットの最初の行でのみ**動作し、データ エディター上で **URL として列のコンテンツを表示します**。 + +![Image Chart in the Visualization editor](images/image-chart.png) + +このチャートは、画像、HTML ページ、あるいはテキスト コンテンツを表示するために使用できる、非常に汎用な表示形式オプションです。[URL] フィールドの設定がテキスト列に設定されている場合、テキストを表示します。その URL が有効である場合、その URL のコンテンツを取得しページを表示します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/BrazilStatePopulation_all.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/BrazilStatePopulation_all.png new file mode 100644 index 00000000..681efccd Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/BrazilStatePopulation_all.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/HRDashboardEmployeesDIY_All.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/HRDashboardEmployeesDIY_All.png new file mode 100644 index 00000000..cf1eb822 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/HRDashboardEmployeesDIY_All.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/SampleVisualization_Desktop.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/SampleVisualization_Desktop.png new file mode 100644 index 00000000..6462f18c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/SampleVisualization_Desktop.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/StatePopulation_all.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/StatePopulation_all.png new file mode 100644 index 00000000..198221ab Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/StatePopulation_all.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/WorldPopulationGDP_All.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/WorldPopulationGDP_All.png new file mode 100644 index 00000000..e7d98b0b Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/WorldPopulationGDP_All.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/add-text-box-to-dashboard.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/add-text-box-to-dashboard.png new file mode 100644 index 00000000..d74f39d9 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/add-text-box-to-dashboard.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/advanced-settings-kpi-gauge.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/advanced-settings-kpi-gauge.png new file mode 100644 index 00000000..0c12f9a0 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/advanced-settings-kpi-gauge.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/area-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/area-chart.png new file mode 100644 index 00000000..0b128033 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/area-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/bar-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/bar-chart.png new file mode 100644 index 00000000..6a34c958 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/bar-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/bubble-chart-visualization-editor.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/bubble-chart-visualization-editor.png new file mode 100644 index 00000000..1b02019d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/bubble-chart-visualization-editor.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/bubble-chart-with-colors.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/bubble-chart-with-colors.png new file mode 100644 index 00000000..8e7b41a0 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/bubble-chart-with-colors.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/bubble-map-density-population-europe-bad-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/bubble-map-density-population-europe-bad-example.png new file mode 100644 index 00000000..79d6b7c9 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/bubble-map-density-population-europe-bad-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/bullet-graph-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/bullet-graph-example.png new file mode 100644 index 00000000..87123990 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/bullet-graph-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/bullet-graph-gauge.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/bullet-graph-gauge.png new file mode 100644 index 00000000..8f38a8aa Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/bullet-graph-gauge.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/candlestick-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/candlestick-chart.png new file mode 100644 index 00000000..ae6a0142 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/candlestick-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/category-charts-list.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/category-charts-list.png new file mode 100644 index 00000000..adce8520 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/category-charts-list.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/category-charts.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/category-charts.png new file mode 100644 index 00000000..9650c281 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/category-charts.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/chart-trendline-option.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/chart-trendline-option.png new file mode 100644 index 00000000..fc341bae Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/chart-trendline-option.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/chart-types-choropleth.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/chart-types-choropleth.png new file mode 100644 index 00000000..6a0891b4 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/chart-types-choropleth.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/chart-types-scatter.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/chart-types-scatter.png new file mode 100644 index 00000000..fda0ea2f Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/chart-types-scatter.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/choropleth-map-intro-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/choropleth-map-intro-example.png new file mode 100644 index 00000000..4d370ab7 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/choropleth-map-intro-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/choropleth-map-visualization-settings.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/choropleth-map-visualization-settings.png new file mode 100644 index 00000000..f972f48c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/choropleth-map-visualization-settings.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/choropleth-visualization-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/choropleth-visualization-example.png new file mode 100644 index 00000000..a281c02c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/choropleth-visualization-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/circular-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/circular-chart.png new file mode 100644 index 00000000..0467c404 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/circular-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/circular-gauge-view-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/circular-gauge-view-example.png new file mode 100644 index 00000000..e47cd2e3 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/circular-gauge-view-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/circular-gauge.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/circular-gauge.png new file mode 100644 index 00000000..752e4af4 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/circular-gauge.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/color-as-scheme-options.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/color-as-scheme-options.png new file mode 100644 index 00000000..579e6f5a Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/color-as-scheme-options.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/color-choropleth-map-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/color-choropleth-map-example.png new file mode 100644 index 00000000..85934baa Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/color-choropleth-map-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/column-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/column-chart.png new file mode 100644 index 00000000..1c2788e9 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/column-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/combo-chart-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/combo-chart-example.png new file mode 100644 index 00000000..00c37992 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/combo-chart-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/combo-chart-selection.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/combo-chart-selection.png new file mode 100644 index 00000000..71e504bc Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/combo-chart-selection.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/combo-chart-settings.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/combo-chart-settings.png new file mode 100644 index 00000000..f05d0e7b Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/combo-chart-settings.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/combo-charts-sample.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/combo-charts-sample.png new file mode 100644 index 00000000..cd83c0b1 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/combo-charts-sample.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/combo-charts-settings.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/combo-charts-settings.png new file mode 100644 index 00000000..24ac9a40 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/combo-charts-settings.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/custom-visualization-access.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/custom-visualization-access.png new file mode 100644 index 00000000..c0b9986c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/custom-visualization-access.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/custom-visualization-config.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/custom-visualization-config.png new file mode 100644 index 00000000..e24c80f9 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/custom-visualization-config.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/data-is-written-in-option.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/data-is-written-in-option.png new file mode 100644 index 00000000..8fcdff86 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/data-is-written-in-option.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/data-source-reveal-sample.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/data-source-reveal-sample.png new file mode 100644 index 00000000..aa344ef3 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/data-source-reveal-sample.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/data-sources-list.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/data-sources-list.png new file mode 100644 index 00000000..07f262bc Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/data-sources-list.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/doughnut-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/doughnut-chart.png new file mode 100644 index 00000000..6dce046d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/doughnut-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/drill-down-hierarchy-level.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/drill-down-hierarchy-level.png new file mode 100644 index 00000000..fde6ef30 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/drill-down-hierarchy-level.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/drill-down-option-choropleth-map.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/drill-down-option-choropleth-map.png new file mode 100644 index 00000000..cc5de086 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/drill-down-option-choropleth-map.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/drilling-option-hierarchy-level.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/drilling-option-hierarchy-level.png new file mode 100644 index 00000000..2a2878da Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/drilling-option-hierarchy-level.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/duplicate-visualization.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/duplicate-visualization.png new file mode 100644 index 00000000..ee94f1ad Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/duplicate-visualization.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/financial-chart-types.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/financial-chart-types.png new file mode 100644 index 00000000..042f7a33 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/financial-chart-types.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/financial-charts-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/financial-charts-example.png new file mode 100644 index 00000000..64d42c52 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/financial-charts-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/financial-charts-sample.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/financial-charts-sample.png new file mode 100644 index 00000000..d7162984 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/financial-charts-sample.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/financial-charts.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/financial-charts.png new file mode 100644 index 00000000..785f9abc Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/financial-charts.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/funnel-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/funnel-chart.png new file mode 100644 index 00000000..4a55bde8 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/funnel-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/gauge-band-settings.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/gauge-band-settings.png new file mode 100644 index 00000000..3d85d454 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/gauge-band-settings.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/grid-chart-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/grid-chart-example.png new file mode 100644 index 00000000..2bf32749 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/grid-chart-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/grid-chart-font-sizes.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/grid-chart-font-sizes.png new file mode 100644 index 00000000..92cf826f Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/grid-chart-font-sizes.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/grid-chart-none-sorting-option.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/grid-chart-none-sorting-option.png new file mode 100644 index 00000000..fa744daa Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/grid-chart-none-sorting-option.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/grid-chart-sorting-number-options.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/grid-chart-sorting-number-options.png new file mode 100644 index 00000000..149d5b77 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/grid-chart-sorting-number-options.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/grid-chart-sorting.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/grid-chart-sorting.png new file mode 100644 index 00000000..38de7bc5 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/grid-chart-sorting.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/image-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/image-chart.png new file mode 100644 index 00000000..5ac7d47b Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/image-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/japanese-data-language.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/japanese-data-language.png new file mode 100644 index 00000000..a0f413f8 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/japanese-data-language.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/kpi.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/kpi.png new file mode 100644 index 00000000..f8517ef2 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/kpi.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/line-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/line-chart.png new file mode 100644 index 00000000..0be311f2 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/line-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/linear-gauge-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/linear-gauge-example.png new file mode 100644 index 00000000..12b7bfe9 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/linear-gauge-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/linear-gauge.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/linear-gauge.png new file mode 100644 index 00000000..b661b34e Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/linear-gauge.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/linear-regression-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/linear-regression-dialog.png new file mode 100644 index 00000000..67d215d7 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/linear-regression-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/linear-regression-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/linear-regression-example.png new file mode 100644 index 00000000..b0b8a132 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/linear-regression-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/linear-regression-forecast-settings.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/linear-regression-forecast-settings.png new file mode 100644 index 00000000..133b0256 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/linear-regression-forecast-settings.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/list-available-maps.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/list-available-maps.png new file mode 100644 index 00000000..2d823ce3 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/list-available-maps.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/lstatistical-functions-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/lstatistical-functions-icon.png new file mode 100644 index 00000000..a3f45a73 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/lstatistical-functions-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/multiple-kpi-gauges.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/multiple-kpi-gauges.png new file mode 100644 index 00000000..c21a91d5 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/multiple-kpi-gauges.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/new-dashboard-text-box.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/new-dashboard-text-box.png new file mode 100644 index 00000000..443eb2f0 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/new-dashboard-text-box.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/new-text-box-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/new-text-box-dialog.png new file mode 100644 index 00000000..0c90e798 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/new-text-box-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/new-visualization-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/new-visualization-dialog.png new file mode 100644 index 00000000..a14e0080 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/new-visualization-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/not-specified-tile-provider-all-levels.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/not-specified-tile-provider-all-levels.png new file mode 100644 index 00000000..5bc8aedf Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/not-specified-tile-provider-all-levels.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/notification-center-options.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/notification-center-options.png new file mode 100644 index 00000000..ba3d77a1 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/notification-center-options.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/ohlc-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/ohlc-chart.png new file mode 100644 index 00000000..1a8e29fa Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/ohlc-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/outlier-detection.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/outlier-detection.png new file mode 100644 index 00000000..f8f31684 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/outlier-detection.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/percentage-distribution-option-stacked-series-charts.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/percentage-distribution-option-stacked-series-charts.png new file mode 100644 index 00000000..1d1a6bf0 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/percentage-distribution-option-stacked-series-charts.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pie-chart-example-legends-value-zero-setting.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pie-chart-example-legends-value-zero-setting.png new file mode 100644 index 00000000..dba2ccde Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pie-chart-example-legends-value-zero-setting.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pie-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pie-chart.png new file mode 100644 index 00000000..1f5412ca Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pie-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pie-doughnut-start-position.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pie-doughnut-start-position.png new file mode 100644 index 00000000..1af34c9f Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pie-doughnut-start-position.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-editor-view-kpi-gauge.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-editor-view-kpi-gauge.png new file mode 100644 index 00000000..7f66b4a4 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-editor-view-kpi-gauge.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-editor-view-linear-gauge-view.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-editor-view-linear-gauge-view.png new file mode 100644 index 00000000..2946458d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-editor-view-linear-gauge-view.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-editor-view-slice-labels.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-editor-view-slice-labels.png new file mode 100644 index 00000000..95f9be39 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-editor-view-slice-labels.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-editor-view-text-gauge-view.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-editor-view-text-gauge-view.png new file mode 100644 index 00000000..72b3c448 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-editor-view-text-gauge-view.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-editor-view=web-view.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-editor-view=web-view.png new file mode 100644 index 00000000..cd436b51 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-editor-view=web-view.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-table-visualization.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-table-visualization.png new file mode 100644 index 00000000..5a270db7 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-table-visualization.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-table.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-table.png new file mode 100644 index 00000000..c78ba504 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/pivot-table.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/presidential-election-2016-map-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/presidential-election-2016-map-example.png new file mode 100644 index 00000000..fe1b859d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/presidential-election-2016-map-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/presidential-election-2016-map.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/presidential-election-2016-map.png new file mode 100644 index 00000000..a04e3084 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/presidential-election-2016-map.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/radial-chart-trendline-settings.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/radial-chart-trendline-settings.png new file mode 100644 index 00000000..b28b76f2 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/radial-chart-trendline-settings.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/radial-chart-visualization-editor.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/radial-chart-visualization-editor.png new file mode 100644 index 00000000..ae037628 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/radial-chart-visualization-editor.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/reusing-visualization.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/reusing-visualization.png new file mode 100644 index 00000000..29d34f97 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/reusing-visualization.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/reveal-uploading-dashboards-menu.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/reveal-uploading-dashboards-menu.png new file mode 100644 index 00000000..0a89f210 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/reveal-uploading-dashboards-menu.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/road-traffic-deaths-eastern-asia-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/road-traffic-deaths-eastern-asia-example.png new file mode 100644 index 00000000..89d21567 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/road-traffic-deaths-eastern-asia-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sample-data-new-visualization-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sample-data-new-visualization-dialog.png new file mode 100644 index 00000000..4560759e Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sample-data-new-visualization-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sample-data.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sample-data.png new file mode 100644 index 00000000..8893f325 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sample-data.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-bubble-map-electoral-college.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-bubble-map-electoral-college.png new file mode 100644 index 00000000..d3f7aa08 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-bubble-map-electoral-college.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-chart-visualization-editor.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-chart-visualization-editor.png new file mode 100644 index 00000000..a9198d42 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-chart-visualization-editor.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-color-average-age-euro-population.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-color-average-age-euro-population.png new file mode 100644 index 00000000..3773094b Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-color-average-age-euro-population.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-dot-different-colors.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-dot-different-colors.png new file mode 100644 index 00000000..4ec27317 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-dot-different-colors.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-dot-map-airports.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-dot-map-airports.png new file mode 100644 index 00000000..62d66f4c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-dot-map-airports.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-dot-map-colored-by-value.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-dot-map-colored-by-value.png new file mode 100644 index 00000000..aed241ed Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-dot-map-colored-by-value.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-map-image-tiles-enabled.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-map-image-tiles-enabled.png new file mode 100644 index 00000000..f5c00557 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-map-image-tiles-enabled.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-map-zoom-control.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-map-zoom-control.png new file mode 100644 index 00000000..a7d2df94 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-map-zoom-control.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-maps-dashboard.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-maps-dashboard.png new file mode 100644 index 00000000..a80f1537 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/scatter-maps-dashboard.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/select-chart-type-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/select-chart-type-dialog.png new file mode 100644 index 00000000..9584f15d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/select-chart-type-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/select-visualization-choropleth-map.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/select-visualization-choropleth-map.png new file mode 100644 index 00000000..bd10cce0 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/select-visualization-choropleth-map.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/settings-combo-charts.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/settings-combo-charts.png new file mode 100644 index 00000000..24ac9a40 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/settings-combo-charts.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/settings-scatter-bubble-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/settings-scatter-bubble-chart.png new file mode 100644 index 00000000..571aacee Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/settings-scatter-bubble-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/slice-label-setting-doughnut-chart-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/slice-label-setting-doughnut-chart-example.png new file mode 100644 index 00000000..32a9fa1e Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/slice-label-setting-doughnut-chart-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sparkline-chart-dashboard-view.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sparkline-chart-dashboard-view.png new file mode 100644 index 00000000..605bcd14 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sparkline-chart-dashboard-view.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sparkline-chart-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sparkline-chart-example.png new file mode 100644 index 00000000..0b9c3294 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sparkline-chart-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sparkline-chart-settings.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sparkline-chart-settings.png new file mode 100644 index 00000000..0c677d36 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sparkline-chart-settings.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sparkline-chart-visualization-editor.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sparkline-chart-visualization-editor.png new file mode 100644 index 00000000..e543b03e Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sparkline-chart-visualization-editor.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sparkline-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sparkline-chart.png new file mode 100644 index 00000000..4b5dcabd Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/sparkline-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/spline-area-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/spline-area-chart.png new file mode 100644 index 00000000..c370f9be Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/spline-area-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/spline-area.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/spline-area.png new file mode 100644 index 00000000..007ac06d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/spline-area.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/spline-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/spline-chart.png new file mode 100644 index 00000000..231952f2 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/spline-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/stacked-area-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/stacked-area-chart.png new file mode 100644 index 00000000..84d0efd6 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/stacked-area-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/stacked-bar-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/stacked-bar-chart.png new file mode 100644 index 00000000..91066034 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/stacked-bar-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/stacked-column-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/stacked-column-chart.png new file mode 100644 index 00000000..66587046 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/stacked-column-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/start-position-setting-doughnut-chart-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/start-position-setting-doughnut-chart-example.png new file mode 100644 index 00000000..0dcd4eea Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/start-position-setting-doughnut-chart-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/step-area-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/step-area-chart.png new file mode 100644 index 00000000..7e02e45a Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/step-area-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/step-line-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/step-line-chart.png new file mode 100644 index 00000000..46b1a319 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/step-line-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/text-box-dashboard-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/text-box-dashboard-example.png new file mode 100644 index 00000000..aae59300 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/text-box-dashboard-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/text-gauge.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/text-gauge.png new file mode 100644 index 00000000..5651fc33 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/text-gauge.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/text-view-conditional-formatting.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/text-view-conditional-formatting.png new file mode 100644 index 00000000..9453001d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/text-view-conditional-formatting.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/text-view-gauge.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/text-view-gauge.png new file mode 100644 index 00000000..2bd95bdc Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/text-view-gauge.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/text-view-visualization-editor.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/text-view-visualization-editor.png new file mode 100644 index 00000000..7a9a5efb Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/text-view-visualization-editor.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/text-view.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/text-view.png new file mode 100644 index 00000000..3eb173dc Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/text-view.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/time-series-chart-compact-labels.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/time-series-chart-compact-labels.png new file mode 100644 index 00000000..65d29291 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/time-series-chart-compact-labels.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/time-series-chart-dashboard-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/time-series-chart-dashboard-example.png new file mode 100644 index 00000000..53b5f6e6 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/time-series-chart-dashboard-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/time-series-charts-chart-trendlines-result.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/time-series-charts-chart-trendlines-result.png new file mode 100644 index 00000000..fb8ca85e Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/time-series-charts-chart-trendlines-result.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/time-series-charts-chart-trendlines.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/time-series-charts-chart-trendlines.png new file mode 100644 index 00000000..59a59b0d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/time-series-charts-chart-trendlines.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/tooltips-scatter-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/tooltips-scatter-chart.png new file mode 100644 index 00000000..b83d73e8 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/tooltips-scatter-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/total-tooltips-treemap-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/total-tooltips-treemap-example.png new file mode 100644 index 00000000..a260badd Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/total-tooltips-treemap-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-chart-types.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-chart-types.png new file mode 100644 index 00000000..a5a6bceb Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-chart-types.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-hierarchy-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-hierarchy-example.png new file mode 100644 index 00000000..c173fc57 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-hierarchy-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-settings-visualization-editor.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-settings-visualization-editor.png new file mode 100644 index 00000000..1286f398 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-settings-visualization-editor.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-tooltip-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-tooltip-example.png new file mode 100644 index 00000000..db1b3ca6 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-tooltip-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-tooltip.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-tooltip.png new file mode 100644 index 00000000..f8380437 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-tooltip.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-totals-label.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-totals-label.png new file mode 100644 index 00000000..17a13784 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-totals-label.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-visualization-hierarchical-data-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-visualization-hierarchical-data-example.png new file mode 100644 index 00000000..10f70d06 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-visualization-hierarchical-data-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-visualization-without-hierarchical-data-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-visualization-without-hierarchical-data-example.png new file mode 100644 index 00000000..83689c17 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/treemap-visualization-without-hierarchical-data-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/underlying-data-time-series-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/underlying-data-time-series-example.png new file mode 100644 index 00000000..01002b21 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/underlying-data-time-series-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/visualization-editor-text-view.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/visualization-editor-text-view.png new file mode 100644 index 00000000..741a204a Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/images/visualization-editor-text-view.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/kpi-gauge.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/kpi-gauge.md new file mode 100644 index 00000000..47a935a6 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/kpi-gauge.md @@ -0,0 +1,27 @@ +--- +title: 表示形式エディターで KPI ゲージを作成する方法 +_description: Reveal で表示形式に KPI ゲージを使用する方法を説明します。 +_language: ja +--- + +# KPI ゲージ + +KPI (Key Performance Indicator: キー パフォーマンス インジケーター) は、企業が主要なビジネス目標をどれだけ効果的に達成しているかを示す測定可能な値です。KPI は個別のニーズによって変化し、目標に対する進捗や時間軸での傾向など、組織の重要なメトリックスに関する情報を提供します。 + +[テキスト ゲージ](gauge-charts.md#テキスト-ゲージ) と同様に、KPI ゲージは [値] 列を大きなフォントで表示します。ただし、KPI の値は、前の期間の同じ値に対しても評価されます。 + +![KPI Gauge view in the Visualization editor](images/pivot-editor-view-kpi-gauge.png) + +カテゴリを追加すると、1 つの表示形式に複数の KPI を含めることもできます。 + +![Multiple KPI Gauges](images/multiple-kpi-gauges.png) + +## インジケーター設定 + +KPI ゲージには[スパークライン](sparkline-charts.md)表示形式と同様の設定があり、それを使用して構成できます: + + - **[期間]**: 両方の値を比較するために使用する期間。 + - **[差異の表示]**: 差異を [値]、[パーセンテージ]、または [値とパーセンテージ] の両方として表示するかどうか。 + - **[値の増加を表す色]**: 差異インジケータの色。 + +![Advanced Settings KPI Gauge](images/advanced-settings-kpi-gauge.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/location-data-requirements.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/location-data-requirements.md new file mode 100644 index 00000000..e5356847 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/location-data-requirements.md @@ -0,0 +1,97 @@ +--- +title: 場所データ要件のためのデータを準備する方法 +_description: 階級区分図を表示形式に使用する場合、場所データの要件に従う方法を説明します。 +_language: ja +--- + +# 階級区分図のデータを準備する方法場所のデータ要件 + +データセットの**場所名**列は、選択したマップの実際の地理単位と一致する必要があります。たとえば、列に国の名前が含まれているが、アメリカ合衆国の州のマップを使用する場合、[表示するデータはありません。] というエラーが画面に表示されます。このエラーの詳細については、以下の[エラーのトラブルシューティング](#エラーのトラブルシューティング)を参照してください。 + + +## 場所の形式 +場所列を Reveal に認識させるには、以下のいずれかの形式を指定します。 + + - 国の**名前**およびその下位区分 (省、州、部、地域など) - 英語またはサポートされる他の言語の公式スペルに準拠します。サポートされる言語の詳細については、以下の[データ ソースが英語ではありません](#データ-ソースが英語にならない)を参照してください。 + + - [ISO 3166-1 alpha-3 (英語)](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3) 規格で定義される **3 文字の国コード**。 + + - USPS によって確立された [**2 文字の米国州の略語 (英語)**](https://pe.usps.com/text/pub28/28apb.htm)。 + + - 「郡名、州名」の形式 (*Seneca、New York* など)。この形式は、郡を含む米国のマップに使用できます。 + + - 「郡名、州の略語」の形式 (*Seneca、NY* など)。これは、郡を含む米国のマップで認識されるもう 1 つの形式です。 + +指定した形式と一致している必要があります。同じ列に完全名とコードを使用しないでください。ただし、**一般的に使用される国の略語**には例外があります。以下は、場所の列で国の完全名と組み合わせることができ、それらを Analytics で認識できるようにする省略された国名のリストです。 + +| 国の完全名 | 略語 | +|--------------------------|-----------------------| +| United States | USA | +| United Kingdom | UK | +| United Arab Emirates | UAE | +| South Korea | S. Korea | +| South Africa | S. Africa | +| North Korea | N. Korea | +| North Macedonia | N. Macedonia | +| Northern Cyprus | N. Cyprus | +| Central African Republic | Central African Rep. | +| N. Mariana Island | N. Mariana Is. | +| U.S. Virgin Island | U.S. Virgin Is. | +| South Sandwich Islands | South Sandwich Is. | +| British Indian Teritory | British Indian Ter. | +| Falkland Island | Falkland Is. | +| British Virgin Island | BVI | +| Trinidad and Tobago | Trin./Tob | +| Solomon Islands | Solomon Is. | +| St. Pierre and Miquelon | St. Pierre | +| Fr. S. Antarctic Lands | Fr. S. Antarctic | +| Equatorial Guinea | Eq. Guinea | + + +## エラーのトラブルシューティング + +階級区分図は、使用可能な一致を検索するように設計されています。このように、部分的な結果のマップが正しく表示されませんが、動作します。 +たとえば、米国の州のマップを使用する場合、Reveal はマップに一致する州を表示し、その他の州はグレーアウトされます。 + +### 階級区分図のトラブルシューティング + +**[表示するデータはありません]** というエラーが表示される場合、定義済みのマップが提供された情報と一致していません。この問題をトラブルシューティングするには、以下の手順をお試しください。 + +1. **表示形式エディターの確認** + + - **[場所]** プレースホルダーで誤ったフィールドを割り当てた可能性があります。**[場所]** フィールドに大陸、国、州などの地理単位が含まれているかどうかを確認します。 + + - **[値]** プレースホルダーのフィールドに、選択した場所の情報が含まれていない場合があります。[マップ カラー] プレースホルダーでカテゴリを追加した場合 ([この例](choropleth-map.md#マップ-カラーを使用したマルチカラー階級区分図の作成)を参照)、[値] フィールドにこのカテゴリの情報を含める必要があります。たとえば、州ごとに候補者の投票を比較する場合、各候補者の投票に関する情報が必要です。 + + - また、**[マップ]** セレクターで正しいマップを選択したことを確認してください。 + + - ドリル ダウン時にエラーが発生した場合は、**[マップ]** セレクターにドリル ダウンするレベルのマップが含まれていることを確認してください。たとえば、現在スイスの州は [マップ] セレクターで使用できないため、データ ソースに必要な情報がある場合でもスイスにドリル ダウンできません。 + +2. **データ ソースの確認**。データ ソースが空であるか、あるいは場所のデータがない場合があります。空でない場合は、つづりの間違いや奇妙な句読点を検索してみてください。正しい[場所の形式](#場所の形式)を使用しているかどうかを確認します。データ ソースの内容が英語で記載されていない場合は、[データ ソースが英語ではありません](#データ-ソースが英語にならない)セクションに移動してください。 + +期待どおりの結果が得られなかった場合は、このトピックを含む、[「階級区分図」](choropleth-map.md)および[「階級区分図設定の操作」](settings-choropleth-map.md)トピック全体を参照してください。 + +### 一般的なトラブルシューティングのヒント + +- **問題の特定**できる限り問題を特定します。たとえば、特定の場所を使用できない場合は、別の場所または別のデータ ソースを使用してみてください。問題を特定するには、一度に多くの設定を変更するのではなく、特定の設定を変更して結果を観察します。 + +- **実行した手順を記録**トラブルシューティングを開始したら、実際に行った手順を記録しておきます。実行した手順を記録し、再現できることにより、問題の特定を効率的に行うことができます。 + + +## データ ソースが英語にならない + +Reveal はデータ ソースの言語を自動的に認識しません。 +データ ソース情報が他の言語で記述されている場合、以下のように指定する必要があります。 + +1. **[設定]** を開き、**[データの言語]** をクリックまたはタップします。 +2. ドロップダウン メニューから言語を選択します。 + +:::note +現在、Reveal の階級区分図は英語と日本語をサポートします。 +::: +データ ソースの場所情報が異なる言語で記述されている場合、Reveal 以外で翻訳する必要があります。 + +### 日本のマップで日本語のデータ ソースを使用 + +日本語のデータ ソースを使用して日本のマップを表示し、すべての日本の都道府県をマップしたい場合は、[この表](https://ja.wikipedia.org/wiki/%E9%83%BD%E9%81%93%E5%BA%9C%E7%9C%8C#%E4%BA%94%E5%8D%81%E9%9F%B3%E9%A0%86%E3%83%BB%E5%9F%BA%E7%A4%8E%E3%83%87%E3%83%BC%E3%82%BF)の形式とおりに位場所のデータを提供する必要があります。 + diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/pivot-table.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/pivot-table.md new file mode 100644 index 00000000..dca786ad --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/pivot-table.md @@ -0,0 +1,45 @@ +--- +title: ピボット テーブルの表示形式を作成する方法 +_description: Reveal でピボット テーブルの表示形式を作成して使用する方法を説明します。 +_language: ja +--- + +# ピボット テーブル + + +ピボット テーブルの表示形式により、ユーザーは、**データ** セクションの対応するプレースホルダーにフィールドをドロップすることで情報を集約できます。 + +![Pivot Table Visualization](images/pivot-table.png) + +行、列、または値のデータ エディターのプレースホルダーにフィールドが追加されているときに、フィールドを選択すると、そのフィールドの要約された設定が表示されます。 + + - **[値]** プレースホルダー内のフィールドでは、使用される要約関数 (average、count、sum など) を構成できます。 + + - **[行]** のプレースホルダーに日付フィールドをドロップすると、要約の詳細レベル (年、月、日) を選択できます。 + +## ピボット テーブルの概要 + +ピボット テーブルは、データ集計ツールです。このツールは、通常値によってグループ化された、表のような形式で保存されたデータを自動的に集計し、平均し、合計することを可能にします。たとえば、以下のテーブルがあるとします。 + + +| Salesman | Region | Product | OrderID | OrderTotal | +| -------- | --------- | -------- | ------- | ---------- | +| JOHN A. | Americas | ProductX | 1001 | 10 | +| ERICK B. | Americas | ProductY | 1002 | 20 | +| PETE C. | EMEA | ProductX | 1003 | 30 | +| DAVID D. | China | ProductZ | 1004 | 10 | +| JORGE E. | Australia | ProductY | 1005 | 5 | + +以下の解析のタイプを実行します。 + +| | Americas | EMEA | China | Australia | Total | +| -------- | -------- | ---- | ----- | --------- | ----- | +| PRODUCTX | 10 | 30 | | | 40 | +| PRODUCTY | 20 | | | 5 | 25 | +| PRODUCTZ | | | 10 | | 10 | + +ピボット テーブルを使用して実行できます。 + + - *Product* フィールドを **[行]** プレースホルダーにドラッグアンドドロップし、すべての製品を行として表示します。 + + - *Region* フィールドを **[列]** プレースホルダーにドラッグアンドドロップし、*Region* フィールドの各値に動的なテーブルの列を作成します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/radial-charts.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/radial-charts.md new file mode 100644 index 00000000..0e5252a1 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/radial-charts.md @@ -0,0 +1,17 @@ +--- +title: ラジアル チャートの表示形式を作成する方法 +_description: Reveal でラジアル チャートの表示形式を作成して使用する方法を説明します。 +_language: ja +--- + +# ラジアル チャート + +[カテゴリ](../chart-types/category-charts.md) チャートと同様に、ラジアル チャートは情報を座標上に表現したものです。 + +![Using a radial chart to create a visualization](images/radial-chart-visualization-editor.png) + +## ラジアル チャートのチャート 近似曲線 + +チャートの [設定] で [チャートの近似曲線] の表示を有効にできます。これは、アルゴリズムに基づいてチャートに表示されるラインです。近似曲線でデータセットの傾向を把握し、意思決定のためのしきい値を定義できます。サポートされる近似曲線は、[線形]、[二次多項式]、[三次多項式]、[四次多項式]、[対数]、[指数]、[べき乗]、[単純平均]、[指数平均]、[修正平均]、[累加平均]、[加重平均] です。 + +![A list consistng of all the chart trendlines available for the radial chart](images/radial-chart-trendline-settings.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/scatter-bubble-charts.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/scatter-bubble-charts.md new file mode 100644 index 00000000..1e81cc9d --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/scatter-bubble-charts.md @@ -0,0 +1,89 @@ +--- +title: 散布図・バブル チャートの表示形式を作成する方法 +_description: Reveal で散布図・バブル チャートの表示形式を作成して使用する方法を説明します。 +_language: ja +--- + +# 散布図・バブル チャート + +## 散布図とは? + +散布図は、X (水平) 軸と Y (垂直) 軸に沿ってデータ ポイントをプロットすることにより、2 つの定量的計測間の関係を表すために使用されます。データに大量の値のセットが含まれている場合に、パターンを示すのに特に役立ちます。 + +## バブル チャートとは? + +バブル チャートは散布図のバリエーションで、データ ポイントがバブルに置き換えられます。散布図と同様に、バブル チャートは、2 つの定量的計測と、バブルのサイズで表される 3 番目の定量的計測間の関係を表します。 + +## 散布図チャートを作成する方法 + +![Example for a scatter chart visualization](images/scatter-chart-visualization-editor.png) + +上記の例では、散布図の表示形式は、特定の各**従業員**によって産み出された**新規販売**の数量と**収益**の関係を示しています。 + +散布図を作成するには: + +1. **[チャート タイプ]** メニューで **[散布図]** の表示形式を選択します。 + +![Location of the scatter visualization in the change visualization menu](images/chart-types-scatter.png) + +2. **[X 軸]** と **[Y 軸]** の数値フィールドを選択して、データ ポイントの位置を決定します。 + +3. **[ラベル]** のカテゴリ値を選択します。 + +すべてのデータ ポイントには独自の**ツールチップ**があり、クリックすると表示されます。 + +![Tooltip shown for a particular data point in the scatter chart](images/tooltips-scatter-chart.png) + +この例では、ツールチップは、データ ポイントが表す特定の従業員に関する情報と、チャートに含まれるそれらの量的なデータを提供します。 + +## バブル チャートを作成する方法 + +![An Example of a bubble chart using one color](images/bubble-chart-visualization-editor.png) + +1 つの色だけを使用して基本的なバブル チャートを作成するには、次の操作が必要です。 + +1. **[チャート タイプ]** のリストから **[バブル]** チャートを選択します。 + +2. **[X 軸]** と **[Y 軸]** の数値フィールドを選択します。 + + 上記の例では、バブルの位置は、*Number of Inpatients* と *Length of Stay* の長さとの相関関係によって決定されます。 + +3. **[ラベル]** のカテゴリ値を選択します。 + + 示されているチャートの各バブルは、神経科、心臓科、外科などの**部門**を表しています。 + +4. **バブル半径**の数値フィールドを選択します。 + + 例から、各バブルのサイズは各 *Division* の *Treatment Costs* の合計に依存することがわかります。チャート上部の凡例は、チャートの**バブル半径**フィールドの最小値と最大値を示しています。 + +バブルをクリックすると、各バブルの特定のデータを示す**ツールチップ**も表示されます。チャートで要素が重複している場合は、小さいバブルをクリックまたはタップしてツールチップを表示します。 + +## 散布図とバブル チャートへの色分類の追加 + +[カテゴリ] フィールドを散布図またはバブル チャートに追加できます。このフィールドの値に応じて、バブルまたは散布ポイントに異なる色が付けられます。 + +![Example of adding colors to the basic bubble chart](images/bubble-chart-with-colors.png) + +上記の例では、*Date* フィールドがカラーボックスに適用されています。色分類を追加すると、部門の数値情報が *2017*、*2018*、*2019* のいずれを参照しているかに応じて、バブルに異なる色が割り当てられます。 + +これにより、バブル チャートの表示形式でより多くのバブルが表示されるようになりました。 + +## 散布図とバブル チャートの設定 + +![Settings for scatter and bubble charts](images/settings-scatter-bubble-chart.png) + +**[設定]**: + + - **表示形式のスタイルを変更する**。 + + 表示形式の **[タイトル]** または **[凡例]** を表示するかどうかを選択できます。**[開始色]** を選択すると、データ ポイント/バブルの色が定義されます。色分類を使用するために複数の色が必要な場合、**[開始色]** から順番に適用されます。 + + - **[X 軸] と [Y 軸] の [リニア] スケールまたは [対数] スケールのいずれかを選択する**。 + + 対数の場合、値のスケールは通常のリニア スケールを使用する代わりに大きさを使用するリニア スケール以外で計算されます。 + + X 軸に対数スケールを使用する場合、散布図の水平軸は常に値軸であるため、一般的に、散布図は折れ線チャートよりも適切な選択です。 + + - **チャートの [最小値] および [最大値] を設定できる**。 + + デフォルトで [最小値] は 0 に設定され、[最大値] は使用されるデータによって設定されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/scatter-map.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/scatter-map.md new file mode 100644 index 00000000..9226ed56 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/scatter-map.md @@ -0,0 +1,151 @@ +--- +title: 散布マップの表示形式を作成する方法 +_description: Reveal で散布マップの表示形式を作成して使用する方法を説明します。 +_language: ja +--- + +# 散布マップ + +このマップは、地理座標を使用して地理領域に散布マーカーを表示します。マーカーの視覚的な分布は、データ内の密度および空間パターンを識別するのに役立ちます。サイズや色を追加すると、他のポイントと比較してデータに関する詳細情報を表示できます。 + +散布マップを使用すると、複数のマップ サービスに接続して、マップの背景をよりリアルにするだけでなく、詳細を調べることもできます。不動産市場分析を表示する場合など、一部のシナリオでは、マップに近所や通りを表示する機能が追加されます。 + +![Different scatter maps visualizations in a dashboard](images/scatter-maps-dashboard.png) + +## 散布マップの使用 + +以下の情報は、必要に応じて最適な散布マップの構成を選択する際に役立ちます。 + +### 基本ドット マップとは? + +Reveal の最も基本的な散布マップは、選択した領域に均一な色のドットをプロットしたものです。 + +ドット マップは、エンティティの地理的分布を表示する優れた方法で、ドットがマップ上でクラスター化するときにパターンを明らかにできます。1 つのドットは 1 つのエンティティを表すため、各オブジェクトはデータセットの地理位置情報を使用してマップに表示されます。 + +1 対多のドット マップは Reveal ではサポートされません。つまり、1 つのドットが複数のオブジェクトを表すことはできないため (1 ドット = 1000 人)、散布ドット マップを使用して人口密度マップなどを作成することはできません。 + +### バブル マップとは? + +基本散布マップにサイズ カテゴリを追加すると、バブル マップが作成されます。異なる場所の定量データの比較に最適です。 + +バブルのサイズは、比較される特定の変数の値を示します。比較効果を得るには、データセットに比較変数のさまざまな値が含まれていることが最適です。それ以外の場合、マップのバブルはサイズが同じように表示されます (以下の例を参照)。 + +![Bubble map showing similar density of population in European countries except for Monaco](images/bubble-map-density-population-europe-bad-example.png) + +上記のスクリーンショットのように**外れ値**を特定してフォーカスしない限り、表示形式の選択を再検討する必要があります。 + +バブルは、緯度と経度のデータで定義された正確な場所にバインドされていません。それらの場所は概算ですが、バブルは情報を伝達する領域に表示される必要があります。たとえば、米国全土で最も危険な領域に関するレポートを作成する場合、ほとんどの場合、報告された各犯罪の正確な場所は必要ありません。集計された犯罪データに基づいてサイズ設定されたバブルを正しい領域にプロットする必要があります。 + +:::note +考慮する必要がある潜在的な問題は、過度に大きいバブルが複数の領域に広がる可能性があることです。この場合、[バブル ツールチップ](#バブル-マップ)のテキストに場所データを追加すると、オーバーサイズのバブルが属する領域をユーザーが識別しやすくなります。 +::: + +### 色付き散布マップとは? + +色を使用すると、マップがわかりやすくなり、分析に変数を追加できます。 + +カテゴリ別に色分けされたシンプルなドット マップは、オブジェクトの分布が多いクラスターや領域に注意を引くのに適しています。たとえば、異なる州の空港の色が異なる場合、最も多くの空港がある州をすばやく識別できます (以下を参照)。 + +![A scatter map showing the distribution of US airports with dots colored by state](images/scatter-dot-different-colors.png) + +値で色分けされたドット マップは、大きなバブルが重なり合うリスクを回避しながらインサイトを提供します。たとえば、ヨーロッパの高齢人口の傾向を一目で確認したい場合は、人口の中年の色でドット マップを作成し、低、中、高の平均年齢を示す色を設定します。 + +![A scatter map showing the average age of Euro Population with dots colored by using conditional formatting for medium age](images/scatter-dot-map-colored-by-value.png) + +ただし、個々の場所の 2 つの値の相関関係を表示する場合は、一方の値をサイズで、もう一方の値を色で表示します。前の例を使用すると、人口の年齢別にドットに色を付け、国の国内総生産に基づいてサイズを設定して、国の豊かさと平均余命の相関関係を示すことができます。 + +## 散布マップのズーム + +散布マップを使用すると、マーカーがより密にプロットされている領域、または [マップ] ドロップダウンの一部ではない領域 (バルカン半島など) にズームインしてフォーカスできます。ズーム領域を保存し、このビューをダッシュボードに保持することもできます。 + +マップが最大化される場合、**ダッシュボード ビュー モード**または**表示形式エディター**でもズームインおよびズームアウトできます。 + +散布マップを最大化すると、ズーム コントロールが表示され、ズーム レベルをより適切に調整し、必要に応じてリセットできます。 + +![A scatter map displaying the zoom control](images/scatter-map-zoom-control.png) + +上記のように、マップの右下にいくつかのボタンが表示されます。[ズームのリセット] ボタンをクリックすると、マップのズームが最後に保存されたときのズーム レベルにリセットされます。 + +ズームを使用すると、Reveal がマップの背景として使用するクリアな図形を変更することもできます。選択したズーム レベルで、グレーの領域を、以下のいずれかのマップ サービスで提供される**画像タイル**と呼ばれる詳細な実際のマップで置き換えることができます。 + +* *Bing* +* *Esri* +* *Mapbox* + +![A scatter map showing the average age of Population in East Asia zoomed in and using image tiles](images/scatter-map-image-tiles-enabled.png) + + +## 散布マップの作成 + +Reveal の散布マップは、表示するデータに基づいて地理分析のさまざまな機会を提供します。 + +### 場所のデータ要件 + +散布マップの表示形式は、地理座標を使用してデータをプロットします。各データ ポイントには、緯度と経度の値を表示する必要があります。Reveal で受け入れられる形式は次のとおりです: + +* 緯度と経度にそれぞれ **2 つの異なる列**。 +* **緯度/経度** (10 進角形式)、例: -46.896388、168.126111 + +:::note +**受け入れられない形式**: *46° 53.783333'* などの分と秒の記号を含む緯度/経度形式、およびサフィックスを含む形式 (*- 46° 53' 47'' South, 168° 7' 34'' E*) は受け入れられません。 +::: + +**[表示するデータはありません。]** メッセージは、緯度と経度のデータが正しく、受け入れられた形式であっても、表示形式エディターに表示される場合があります。これは、地理座標が選択したマップの境界の外側にプロットされている場合に発生する可能性があります。 + +### 基本的なドット マップ + +![A dot map showing the distribution of airports across the US](images/scatter-dot-map-airports.png) + +データセットの**緯度**と**経度**のデータのみを使用して、ドット マップを作成できます。データ ソースにこれらのフィールドが含まれていない場合は、別のデータ ソースから追加できます。 + +また、[散布マップデータ] セクションの [マップ] ドロップダウンから事前定義されたマップの 1 つを選択する必要があります。 + +さらに、オプションのラベル プレースホルダーにデータを入力して、緯度と経度のデフォルトのツールチップ テキストをデータ内の関連するラベル フィールド値に置き換えることができます。上のスクリーンショットでは、ドットは空港の住所に基づいて地図上に配置されていますが、ツールチップ テキストに空港の名前を使用することもできます。 + +このマップの概念は単純であるため、タイトルを表示するかどうかを選択し、[設定] セクションでドットの色を設定することしかできません。 + + +### バブル マップ + +可変サイズのマーカーまたはバブルを使用して散布マップを作成することもできます。 + +![A bubble map showing the electoral college votes distribution across US states](images/scatter-bubble-map-electoral-college.png) + +バブル マップは、基本的なドット マップと同じデータを使用して作成されます。さらに、[バブル半径] プレースホルダーに数値フィールドをドロップする必要があります。 + +バブルのツールチップには、次の 2 つの部分があります: + +* 太字のタイトル - [ラベル] のフィールドからのデータを使用します。 +* コンテンツ - [バブル半径] のフィールドの名前と値で構成されます。 + +**バブル ツールチップ**は、対象ユーザーが地図を読むのに役立ちます。これにより、バブル サイズが何を表しているのかがわかり、正確な値が得られます。バブルがマップ上の実際の領域であるという誤解を避けるのに役立ちます。 + +### 散布マップに色を追加 + +散布マップを使用すると、色で示される追加の 3 番目の変数を表示できます。色の追加は、ドット マップとバブル マップの両方のオプションです。 + +![A scatter map showing the average age of Euro Population sized by number and colored using conditional formatting for medium age](images/scatter-color-average-age-euro-population.png) + +マップ上の色は、次の方法で決定できます: + +* **値** - 数値データ フィールドを使用するのが最適です。テキスト フィールドをドロップすると、データが自動的に集計され、Reveal は**行数**を使用して色を決定します。 + +* **カテゴリ** - テキスト フィールドが必要です。ただし、数値フィールドを指定すると、その値はテキストとして処理されます。つまり、集計は適用されず、個々の値ごとに個別の色が作成されます。 + +### スタイル設定の構成 + +**散布マップ**のスタイル設定には、表示形式の**タイトル**と**凡例**の表示/非表示、およびマップ上のマーカーの色とタイプの構成が含まれます。 + +色の設定は、散布マップの種類によって異なります。 + +均一な色のマーカーを使用する**基本的なドットおよびバブル マップ**の場合、**[開始色]** の 10 色パレットから色を選択できます。 + +**カテゴリ別の色の散布マップ**の場合、**[別のマーカーの使用]** を選択できます。この機能を有効にすると、Reveal は、正方形、三角形、ドット、星、八角形などの色と記号の組み合わせを使用して、カテゴリごとに一意のマーカーを自動的に作成します。 + +**値別の色の散布マップ**の場合、カラー スキームを構成できます。**[カラー バリエーション]** ドロップダウンに 3 つのオプションが表示されます。 + +![Color as options in the Style Settings section](images/color-as-scheme-options.png) + +* **[単色]** - マップ上のすべてのマーカーを同じ色でスタイルを設定します。 +* **[値範囲]** - 7 色のいずれかを使用してマーカーのスタイルを設定します。明るい色から暗い色に進む色は、データ値を低いものから高いものへと表します。**[開始色]** を選択することもできます。これにより、7 つの色合いの中央の色が決まります。 +* **[条件付き書式]** - このスキームを使用すると、最大 3 つの範囲 (上、中、下) までのデータ範囲ごとにスタイリング ルールを確立できます。低い値が適しているかどうかは情報の性質によります。Reveal には状況に応じて最も理にかなった方法でスタイルを設定できる柔軟性があります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/settings-choropleth-map.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/settings-choropleth-map.md new file mode 100644 index 00000000..4af004e6 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/settings-choropleth-map.md @@ -0,0 +1,47 @@ +--- +title: 階級区分図設定を使用する方法 +_description: このページで提供されるヒントで階級区分図を最大限に活用します。 +_language: ja +--- + +# 階級区分図設定の操作 + +![Settings in the Visualization editor of the choropleth map](images/choropleth-map-visualization-settings.png) + +階級区分図表示形式の [設定] セクションでは、以下を設定できます: + + - **[タイトルの表示]** - 表示形式のタイトルを表示するかどうかを選択します。 + + - **[凡例の表示]** - マップの上にカラー スケール範囲を表示するかどうかを選択します。 + + - **[カラー]** - 配色のベースとして選択する色を選択します。平均データ値の領域はこの色で塗りつぶされます。対照的に、データ値が低いマップ領域は明るい色で表示され、高いデータ領域は暗い色で表示されます。 + + - **[カラー バリエーション]** - 以下から選択できます: + + * **[値範囲]** - 7 色の範囲を配色として使用し、データ値に基づいて領域を塗りつぶします。 + * **[単色]** - 単一の色を使用して、データを含むすべての領域を表示します。情報のない領域は灰色です。 + +:::note +**[マップ カラー]** プレースホルダーにフィールドを追加した場合、[カラー バリエーション] の設定は **[次に基づいた色]** 設定に変更されます。マップ カラーを使用した階級区分図の作成の詳細については、[こちら](choropleth-map.md#マップ-カラーを使用したマルチカラー階級区分図の作成)を参照してください。 +::: + - **[ラベルの表示]** - 選択したマップがラベルをサポートする場合、ラベルを **[すべて]** の領域に配置するか、情報を含む領域のみに配置するか **[値がある場合のみ]**、オフにするか **[なし]** を選択できます。 + + - **[現在のラベル]** - **[場所の略語]** を選択して、ラベルを使用して地域の地名 (省略) を示すことができます。または、ラベルに各領域の **[値]** を表示できます。値ラベルは、**[値]** フィールドに選択した書式設定に基づいて、数値、パーセント、または通貨としてマップに表示できます。 + + - **[この表示形式を別のダッシュボードまたは URL に接続](../dashboard-linking.md)** - 表示形式に表示される情報についてさらに詳細を提供したい場合は、ダッシュボードの表示形式を他のダッシュボードまたは URL に接続できます。 + +## ローカライズ設定 + +現在、データセットは英語と日本語で提供できます。 + +場所データが日本語の場合、Reveal はそれを英語に翻訳して目的のマップに接続します。 + +Reveal で日本語のデータセットを使用し、言語および地域設定が日本語に設定されていない場合、Reveal が日本語 (*ja*) に切り替えてデータセットの言語を認識するために **[データの言語]** 設定を使用する必要があります。 + +![Choosing Japanese from the dropdown menu of the Data is written in option](images/data-is-written-in-option.png) + +### ラベルの言語 + +階級区分図のラベルの言語は、OS またはブラウザーで構成された言語と地域の設定によって定義されます。ロケール/言語を Reveal がサポートする言語に設定したマシンで Reveal を実行している場合、アプリはラベルをその言語にローカライズしようとします。これは **[データの言語]** 設定とは関係ありません。 + +たとえば、日本人の従業員のマシンが母国語 (日本語) を使用するように設定されていて、そのデータが英語の場合、Reveal はラベルを日本語で表示します。ダッシュボードをドイツの投稿者と共有した場合、ドイツ語のラベルはマシンで使用する言語で表示されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/sparkline-charts.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/sparkline-charts.md new file mode 100644 index 00000000..993104c7 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/sparkline-charts.md @@ -0,0 +1,33 @@ +--- +title: スパークライン チャートの表示形式を作成する方法 +_description: Reveal でスパークライン チャートの表示形式を作成して使用する方法を説明します。 +_language: ja +--- + +# スパークライン チャート + +スパークライン チャートは、軸、ラベル、またはその他のチャート要素なしでグリッド チャート内にプロットされる小さなチャートで、指定された日付範囲のトレンドとその進行を表します。 + +![Sparkline Chart sample](images/sparkline-chart-example.png) + +最初の列は表示形式エディターで固定されたままで、情報内の別の列をスクロールできます。 + +![Using the sparkline chart in the visualization editor](images/sparkline-chart-visualization-editor.png) + +## スパークラインの詳細設定 + +表示形式エディターの **[設定]** セクションにアクセスすると、以下のいくつかの設定を変更できます。 + +![Settings for the sparkline chart](images/sparkline-chart-settings.png) + + - テキスト、数値、および日付の**配置**。 + + - グリッド要素の**フォント サイズ**。 + + - スパークラインの**チャート タイプ**: 折れ線チャートまたはエリア チャート。 + + - 日付の**集計**。 + + - グリッド内のスパークライン チャートに含める**値の数**。 + + - **スパークライン列に含める情報** (最後の 2 つの値やその差など)。さらに、**正の差異を緑または赤で表す**かどうかも選択できます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/text-box.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/text-box.md new file mode 100644 index 00000000..3c19f96a --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/text-box.md @@ -0,0 +1,49 @@ +# テキスト ボックス表示形式 + +テキスト ボックスの表示形式は、その名前が示すように、テキスト本文とオプションのタイトルで構成されます。データ ソースに接続されていません。テキスト ボックスを使用する一般的なシナリオは、レポートにテキストの概要を追加することです。 + +![An example of a summary text box added to a dashboard](images/text-box-dashboard-example.png) + +## ダッシュボードにテキスト ボックスを追加 + +テキスト ボックスを既存のダッシュボードに追加する方法: + +1. ダッシュボードを**編集モード**で開きます。 + +2. **[+ 表示形式]** の分割ボタンの右にある矢印をクリックまたはタップして、**[テキスト ボックス]** を選択します。 + +![Adding a text box in dashboard edit mode](images/add-text-box-to-dashboard.png) + +:::note +テキスト ボックス表示形式を既存のダッシュボードに追加すると、**ダッシュボードの下部**に表示されます。ドラッグすると移動できます。 +::: +## ダッシュボードで最初の表示形式としてテキスト ボックスを作成する方法 + +概要または簡単な紹介を表示するテキスト ボックス表示形式を作成してダッシュボードを開始することもできます。テキスト ボックスの作成メニューにアクセスするには、以下の手順を実行します。 + +1. 初期画面の右上にある **[+ ダッシュボード]** ボタンをクリックまたはタップします。 + +2. **[新しい表示形式]** ダイアログが開き、データ ソースを選択するように求められます。**[X]** をクリックまたはタップして、ダイアログを閉じます。 + + ![New visualization dialog](../images/new-visualization-screen.png) + +3. **[+ 表示形式]** の分割ボタンにある**矢印**をクリックまたはタップして、**[テキスト ボックス]** を選択します。 + + ![New visualization dialog](./images/new-dashboard-text-box.png) + +## テキスト ボックス表示形式の作業 + +新しいテキスト ボックス表示形式を追加すると、以下の空のフォームが表示されます。 + +![New text box dialog showing an empty text box form](images/new-text-box-dialog.png) + +このダイアログでは: + + - **小**、**中**、**大**のテキスト サイズを選択できます。 + + - テキストの配置 (**[テキスト サイズ]** の隣) を選択できます。 + + - テキスト本文 (**[テキストの入力]** ボックス) に独自のテキストを記述できます。 + + - **タイトル**を追加できます。(オプション) + diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/text-view.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/text-view.md new file mode 100644 index 00000000..6284fcc8 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/text-view.md @@ -0,0 +1,15 @@ +--- +title: テキスト ビューの表示形式を作成する方法 +_description: Reveal でテキスト ビューの表示形式を作成して使用する方法を説明します。 +_language: ja +--- + +# テキスト ビュー + +テキスト ビューは、以下に表示する従業員のレコード情報などのキー値のパターンに従った情報が表示されます。これは、列ラベルとペアになったデータの最初の行のみを表示します。特定の行を表示するためには、フィルターを適用することが可能でテキスト ビューによって選択されます。閲覧者が簡単に単一エンティティの属性を簡単に理解したい場合に適しています。例として、製品の仕様や個人の連絡先情報などがあります。 + +![Text View in the Visualization editor](images/visualization-editor-text-view.png) + +**テキスト ビュー**は**条件付き書式**をサポートします。 + +![Using conditional formatting for a text view visualization](images/text-view-conditional-formatting.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/time-series-charts.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/time-series-charts.md new file mode 100644 index 00000000..58d73b63 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/time-series-charts.md @@ -0,0 +1,56 @@ +--- +title: 時系列チャートの表示形式を作成する方法 +_description: Reveal で時系列チャートの表示形式を作成して使用する方法を説明します。 +_language: ja +--- + +# 時系列チャート + +時系列チャートは、時系列でインデックス付けされたデータ ポイントを表示するために使用されます。傾向を一目で検出するために一般的に使用され、時間の経過に伴う開発を簡単に観察できます。 + +![Time Series chart within Reveal](images/time-series-chart-dashboard-example.png) + +従来の折れ線チャートと非常によく似ていますが、時系列チャートには常に時間ベースの水平軸 (x 軸) があります。 + +## チャートの近似曲線 + +チャートの設定で近似曲線の表示を有効にできます。このラインはアルゴリズムに基づいてチャートにラインを表示します。近似曲線でデータセットの傾向を把握し、意思決定のためのしきい値を定義できます。サポートされるトレンド ラインは、二次フィット、キュービック フィット、四次フィット、対数フィット、指数フィト、べき乗フィット、単純平均、指数平均、修正平均、累加平均、加重平均です。 + +![Chart trendline options in Reveal](images/time-series-charts-chart-trendlines.png) + +![Chart trendline options result in Reveal](images/time-series-charts-chart-trendlines-result.png) + +## 時系列チャートの設定 + +[設定] では: + +- **デフォルトで表示される要素を非表示にすることができます**。 + タイトル、凡例、およびツールチップの合計を非表示にすることを選択できます (カテゴリがある場合にのみ使用可能)。また、開始色を選択して、異なる**軸**を表示または非表示にすることもできます。 + +- **近似曲線を表示できます**。 + チャート設定を使用すると、前のセクションで説明したように、サポートされているさまざまなアルゴリズムから選択して、近似曲線を表示できます。 + +- **軸を表示範囲に同期できます**。 + +- **自動的なラベル回転を表示できます**。 + +- **ズーム レベルを調整できます**。 + +- **リニア スケールまたは対数を選択できます。** + 対数の場合、値のスケールは通常のリニア スケールを使用する代わりに大きさを使用するリニア スケール以外で計算されます。 + +- **チャートの最小値および最大値を設定できます。** + デフォルトで最小は 0 に設定され、最大値は使用されるデータによって設定されます。 + +- **コンパクトなラベルを選択できます**。 + この設定を使用すると、チャートをズームするときに冗長なラベル情報を回避できます。 + +- [この表示形式を別のダッシュボードまたは URL に接続します](../dashboard-linking.md) + +## ズームとパンニング + +時系列チャートが最大化されると、ズームインおよびズームアウトできます。これにより特定の時間間隔に焦点を合わせることができ、コンパクトなラベル設定を使用することが理にかなっている明確なシナリオです。 + +## 統計関数 + +Reveal は 3 種類の高度な予測分析を提供します。これらは、[時系列予測](../statistical-functions.md#時系列予測)、[線形回帰](../statistical-functions.md#線形回帰)、および[外れ値の検出](../statistical-functions.md#外れ値の検出)です。それらを使用して、データ シリーズで予測を行い、傾向を認識して評価し、外れ値を検出できます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/treemap-charts.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/treemap-charts.md new file mode 100644 index 00000000..92108c6d --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/chart-types/treemap-charts.md @@ -0,0 +1,86 @@ +--- +title: ツリーマップの表示形式を作成する方法 +_description: Reveal でツリーマップの表示形式を作成して使用する方法を説明します。 +_language: ja +--- + +# Reveal のツリーマップ + +ツリーマップ表示形式は、階層データをネストされた四角形のセットとして表示するために使用されます。各レベルの四角形は、サイズと色が異なります。 + +タイル (四角形) の各特性は、データ分析で役割を果たします。 + + * **色** - ツリーマップ表示形式で分割されるカテゴリを示します。この特性を定義するために使用されるフィールド データは、数値 (*123*)、文字列 (*ABC*)、または日付です。 + * **サイズ** - 各カテゴリの値を示します。サイズを決定するために使用されるフィールド データは、数値 (*123*) のみです。 + * **ラベル** - 表示形式の各四角形のカテゴリと値を表示します ([つまり、階層データがない場合](#階層データなしのツリーマップ表示形式))。[階層データを含むツリーマップ表示形式](#階層データのツリーマップ表示形式)がある場合、現在のレベルのカテゴリと値を示す追加のラベルがあります。 + + +## 階層データなしのツリーマップ表示形式 + +以下に示すような**階層データなしの表示形式**を作成できます: + +![An example of a treemap with no hierarchy](./images/treemap-visualization-without-hierarchical-data-example.png) + +階層のないツリーマップを使用して、パターンおよび一部と全体の関係を魅力的で明確な方法で表示できます。 + +上記の表示形式は、*Product* ごとの *New Seats* を表示します。この表示形式を構成するには、次のことを行う必要があります: + +1. **[新しい表示形式]** ダイアログで、**[サンプル データ]** を選択します。 + + ![Sample Data in the list of data sources](images/sample-data-new-visualization-dialog.png) + +2. **表示形式エディター**で、**ツリーマップ表示形式**を選択します。 + + ![Treemap visualization in the Change Visualization dialog](images/treemap-chart-types.png) + +3. ツリーマップ データ セクションで、**[ラベル]**に *Product* を、**[値]**に *New Seats* をドロップします。 + +**[ラベル]** (*Product*) にドロップされたデータは**色**を決定し、5 つの異なる四角形に表示形式を並べます。 + +最大のタイルは、最大の *New Seats* 値を示します。四角形は、**左上 (最大) から右下にサイズで配置されます**。 + +各四角形の**左下のラベル**には、各製品の概算値が丸めて表示されています。正確な値を表示するには、タイルをクリックまたはタップしてツールチップを表示します (スクリーンショットを参照)。 + + ![Tooltip in a treemap](images/treemap-tooltip.png) + +## 階層データのツリーマップ表示形式 + +階層データの処理は、ツリーマップの当初の目的です。階層に構成できる値のメトリックは 1 つだけですが、カテゴリは無制限です。 + +![Example of a hierarchical treemap visualization](images/treemap-visualization-hierarchical-data-example.png) + +上記の例では、ツリーマップは、*Product* カテゴリによって決定される 5 つの大きな四角形 (ツリーマップのブランチ) に分割されています。各ブランチには、次のカテゴリ レベル - *Territory* によって決定された**小さな四角形が含まれています**。下位レベルは表示されません。 + +上記の例では、**2 種類のラベル**があることに気づくかもしれません。 + +- 左上の大きな四角形の場合 - 各製品の合計新規販売に関する情報を示します。 +- 左下の小さな四角形の場合 - 特定の国で販売されている各製品の量を示します。 + +タイルの色とサイズの特性に関する情報は、[階層なしのツリーマップ](#階層データなしのツリーマップ表示形式)について述べたものと同様です。 + +### 階層レベルのドリル アップとドリル ダウン + +ツリーマップ表示形式をドリル アップおよびドリル ダウンして、異なる階層レベル間を移動できます。これを行うには、**大きな四角形の領域をクリックします** (含まれるタイルに関係なく)。ツールチップで、**[ドリル ダウン/アップ]** を選択します。 + +![Select drill down in tooltip](images/drilling-option-hierarchy-level.png) + +### ツリーマップ レベルの詳細 + +階層の最下部 (**ラベル**にドロップされた最後のフィールド) に到達すると、表示形式は[フラット ツリーマップ](#階層データなしのツリーマップ表示形式)のようになります。 + +![Tooltips in the bottom of a treemap](images/treemap-totals-label.png) + +ツリーマップ表示形式の上部 (左側) にある**合計ラベル**は、すべてのレベルで変化します。*Totals* は、**[ラベル]** の各階層レベルの **[値]** フィールドの変更を反映しています (前の例の合計を比較してください)。上の例の合計ラベルには、日本での製品 B のすべての新規販売が表示されます。 + +**タイトルのパンくずリスト**を使用して、表示されている現在のレベルを識別します。それらをクリックまたはタップして移動することもできます (ドリル アップの代わりに)。 + +## 表示形式エディター設定の操作 + +![Settings section in the Visualization editor](images/treemap-settings-visualization-editor.png) + +ツリーマップ表示形式の **[設定]** セクションでは、以下を設定できます: + +- **タイトルの表示** - 表示形式のタイトルを表示するかどうかを選択します。 +- **値の表示** - カテゴリに関する情報を表示する**ラベル**とさまざまなレベルの四角形の値を表示するかどうかを選択します。 +- **開始色** - 10 色のパレットから開始色を選択します。Reveal は選択に基づいて配色を調整します。 +- **リンク** - 表示形式をダッシュボードまたは URL に接続します。詳細は、[ダッシュボード リンク](../dashboard-linking.md)をご覧ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/dashboard-export-excel.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/dashboard-export-excel.md new file mode 100644 index 00000000..8cf6c940 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/dashboard-export-excel.md @@ -0,0 +1,29 @@ +# Excel エクスポート + +Reveal では、ダッシュボードに使用されるデータを **Excel 形式**にエクスポートできます。ダッシュボードの各表示形式のデータは、Excel ファイルの別のシートにあります。 + +:::note +**Excel へのエクスポートの制限**。**テーブル データ**、つまり情報を行と列に整理したデータ ソース (スプレッドシート、CSV ファイル、データベース) を使用して、Excel のみのダッシュボードにエクスポートできます。ダッシュボードが画像や HTML などを使用してデータを表示する場合、Reveal は情報を Excel 形式にエクスポートできません。 +::: +1. ダッシュボードの右上隅にあるオーバーフロー メニューに移動し、**[エクスポート]** を選択します。 + +![Export option in the overflow menu](images/export-option-excel.png) + +2. 次のダイアログが開きます。 + +![Settings for Excel spreadsheet in the Export Dashboard menu](images/export-dashboard-as-excel.png) + +この **[ダッシュボード エクスポート]** ダイアログでは、Excel ファイルに含めるデータ シートを**選択**して**名前を変更**できます。各データ シートには、エクスポートするダッシュボードの特定の表示形式のデータが含まれています。Excel ドキュメントに**表示形式を含める**こともできます。 + +**[表示形式をむ]** 設定には、次のオプションがあります: + +- **[含む]** - この表示形式のデータと同じシートにダッシュボードの表示形式を含めます。 + +- **[別のシート上]** - 別のシートに表示形式とそれに対応するデータを含めます。 + +- **[含めない]** - Excel シートに表示形式のデータのみを含めます。 + +:::note +**サポートされている表示形式**。次のチャートの表示形式は、Excel シートに**直接含める**ことができます: 柱状、折れ線、棒、エリア、積層型柱状、積層型エリア、円、ドーナツ型、ファンネル、複合、散布図、バブル、スパークライン。 +次の表示形式は、Excel シートに含まれる前に類似のタイプに**変換されます**: スプラインとステップ折れ線 ⇒ 折れ線; スプライン エリアとステップ エリア ⇒ エリア。 +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/dashboard-export-image.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/dashboard-export-image.md new file mode 100644 index 00000000..c8edb7cf --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/dashboard-export-image.md @@ -0,0 +1,46 @@ +# ダッシュボードを画像としてエクスポート + +Reveal では、ダッシュボード全体のスクリーン キャプチャまたは個別の表示形式をエクスポートすることができます。 +ローカル スペース/モバイル デバイスに配信されるファイルは **PNG 形式**です。 + +## ダッシュボード全体を画像としてエクスポート + +ダッシュボード全体の画像をエクスポートするには: + +1. ダッシュボードの右上隅にあるオーバーフロー メニューに移動し、**[エクスポート]** を選択します。 + ![Export option in the list of options in the overflow menu](images/export-option-overflow-menu.png) + +2. **[画像]** をクリックまたはタップします。 + + ![Image option in the list of formats](images/image-export-format.png) + +3. **[画像をエクスポート]** ダイアログで、**[画像をエクスポート]** の青いボタンを選択します。 + + ![Export image button in the export image dialog](images/export-image-dialog.png) + +**[クリップボードへコピー]** オプションを選択すると、ダウンロードすることなく、クリップボードに画像を取り込むことができます。 + +## 個別の表示形式を画像としてエクスポート + +ダッシュボード全体の画像をエクスポートするには: + +1. ダッシュボードの**ビュー モード**で、右上隅の矢印をクリックまたはタップして、選択した表示形式を**最大化します**。 + + ![Using the arrow from the upper-right corner to open a visualization](images/export-visualization.png) + +2. **[エクスポート]** を選択し、オーバーフロー メニューで **[画像]** を選択します。 + +3. **[画像をエクスポート]** の青いボタンを選択します。 + +## 注釈画像 + +特定の場所に異なる図形のメモやハイライトを含む必要がある場合、**[画像をエクスポート]** メニューでダッシュボードに注釈を追加できます。**注釈セクションにアクセスする**には、**[画像をエクスポート]** ダイアログで鉛筆アイコンを選択します。 +![Accessing Image Annotation Menu](images/export-images-annotation.png) + +注釈メニューの上部ツールバーには、形状の追加やフリースタイルの注釈など、多くのオプションがあります。 + +![ Toolbar with different shapes options](images/export-image-toolbar.png) + +テキストのオプションでは画像の上にテキストを追加できます。背景色、フォントの太さ、フォント サイズ、フォント カラーなど、テキストをカスタマイズするオプションを提供します。 + +![Adding text in image annotation](images/text-option-in-export-image.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/dashboard-export-pdf.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/dashboard-export-pdf.md new file mode 100644 index 00000000..45137ce5 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/dashboard-export-pdf.md @@ -0,0 +1,37 @@ +# ダッシュボードを PDF 文書としてエクスポート + +Reveal では、ダッシュボードを PDF 文書としてエクスポートできます。各表示形式は、ドキュメントの個別のページに表示されます。 + +ダッシュボードを PDF 文書としてエクスポートするには、ダッシュボード **ビュー モード**に移動して、オーバーフロー メニューから **[エクスポート]** ⇒ **PDF** を選択します。**[ダッシュボード エクスポート]** ダイアログが開き、PDF 文書をニーズに合わせるため、編集して特定のページに注釈を付けることができます。 + +## エクスポート設定 + +![Settings for PDF document in the Export Dashboard menu](images/export-pdf-options.png) + +**[ダッシュボード エクスポート]** ダイアログでは、次の設定を管理できます: + +1. PDF 文書の**主タイトル**を変更します。デフォルトのタイトルは、ダッシュボードのタイトルです。 + +2. **ページのタイトル**を変更し、**[タイトルの入力]** テキスト ボックス (2 番目のボックス) にサブタイトルを追加します。デフォルトのスライドのタイトルは、ページに表示される表示形式のタイトルです。 + +3. **[ブランディング]** 設定オプションの管理では、以下を選択できます。 + + 1. **[作成者]** とその **[会社名]** - PDF 文書のページのヘッダー パネルに表示されます。 + + 2. **[カラー]** (PDF 文書のメイン カラー) とフッターで表示される会社の **[ロゴ]** - ここでは、次のオプションのいずれかを選択できます: + + - **Reveal** + + - **ユーザーの組織/ワークスペース** - 組織とすべてのワークスペースのブランディング (ロゴと色) が設定しているオプションとして表示されます。 + + - **カスタム** - 色を選択し、選択した**ロゴ**画像をアップロードします。 + +:::note +**ロゴ画像の要件**。ロゴとしてアップロードする画像は、**5 MB** 以下で、JPG、JPEG、PNG、GIF のいずれかの形式である必要があります。 +::: + +4. **横方向**または**縦方向**の**ドキュメントの向き**を選択します。 + +5. リストからページを選択してタイトルを変更し、注釈を付け、あるいは右上角のチェック アイコンを除いてドキュメントを削除することで、**ドキュメント ページを管理できます**。 + +6. **鉛筆アイコン**をクリックまたはタップして、選択したページに**注釈**を付けます。**注釈設定**の詳細については、「ダッシュボードを画像としてエクスポート」 トピックの[注釈画像](dashboard-export-image.md#注釈画像)セクションを参照してください。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/dashboard-export-powerpoint.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/dashboard-export-powerpoint.md new file mode 100644 index 00000000..91bbe76f --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/dashboard-export-powerpoint.md @@ -0,0 +1,45 @@ +# ダッシュボードを PowerPoint 形式としてエクスポート + +Reveal では、ダッシュボードを PowerPoint 形式でエクスポートできます。各表示形式は、プレゼンテーションの個別のスライドに表示されます。 + +プレゼンテーションのすべての要素は編集可能であるため、ニーズに合わせて調整できます。 + +ダッシュボードを PowerPoint プレゼンテーションとしてエクスポートするには、次のことを行う必要があります: + +1. ダッシュボード **ビュー モード**に移動し、オーバーフロー メニューをクリックまたはタップします。 + +2. **[エクスポート]** を選択し、**[PowerPoint]** をクリックまたはタップします。 + + ![Powerpoint option in the list of export formats](images/export-as-powerpoint-option.png) + +3. **[ダッシュボード エクスポート]** ダイアログが開き、プレゼンテーションを設定して特定のスライドに注釈を付けることができます。 + +## エクスポート設定 + +![Settings for PowerPoint presentation in the Export Dashboard menu](images/export-dashboard-as-powerpoint.png) + +**[ダッシュボード エクスポート]** ダイアログでは、次の設定を管理できます: + +1. PowerPoint の**主タイトル**を変更します。デフォルトのタイトルは、ダッシュボードのタイトルです。 + +2. **スライドのタイトル**を変更します。**[説明の追加]** ボックス (2 番目) に説明を追加することもできます。デフォルトのスライドのタイトルは、スライドに表示される表示形式のタイトルです。 + +3. **[ブランディング]** 設定オプションの管理では、以下を選択できます。 + + 1. **[作成者]** とその **[会社名]** - スライドのヘッダー パネルに表示されます; + + 2. **[カラー]** (PowerPoint のメイン カラー) とフッターで表示される会社の **[ロゴ]** - ここでは、次のオプションのいずれかを選択できます: + + - **Reveal** + + - **ユーザーの組織/ワークスペース** - 組織とすべてのワークスペースのブランディング (ロゴと色) が設定しているオプションとして表示されます。 + + - **カスタム** - 色を選択し、選択した*ロゴ*画像をアップロードします。 + +:::note +**ロゴ画像の要件**。ロゴとしてアップロードする画像は、**5 MB** 以下で、JPG、JPEG、PNG、GIF のいずれかの形式である必要があります。 +::: + +4. リストからページを選択してタイトルを変更し、注釈を付け、あるいは右上角のチェック アイコンを除いてドキュメントを削除することで、**PowerPoint のスライドを管理**できます。 + +5. **鉛筆アイコン**をクリックまたはタップして、選択したスライドに**注釈**を付けます。**注釈設定**の詳細については、「ダッシュボードを画像としてエクスポート」 トピックの[注釈画像」](dashboard-export-image.md#注釈画像)セクションを参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/dashboard-export.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/dashboard-export.md new file mode 100644 index 00000000..84d51bb4 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/dashboard-export.md @@ -0,0 +1,21 @@ +# ダッシュボードのエクスポート + +ダッシュボードに表示される情報は、データ ソースの変更に伴って更新されますが、ある時点のデータのスナップショットを共有することもできます。たとえば、予期しない値を強調表示したビジネス インサイトを提供し、注意を促します。 + +**エクスポート機能にアクセスする**には、右上隅にあるオーバーフロー ボタンを選択し、**[エクスポート]** をクリックまたはタップします。 + +![Export option in the overflow menu](images/export-option.png) + +## エクスポート形式 + +ダッシュボードは、以下のオプションを使用して簡単にエクスポートできます。 + +![Export formats available](images/format-options.png) + + - [**画像のエクスポート**](dashboard-export-image.md) - ダッシュボード全体または個別の表示形式のスクリーン キャプチャをエクスポートします。 + + - [**PowerPoint のエクスポート**](dashboard-export-powerpoint.md) - ダッシュボードを PowerPoint プレゼンテーションとしてエクスポートします。 + + - [**PDF のエクスポート**](dashboard-export-pdf.md) - ダッシュボードを PDF ドキュメントとしてエクスポートします。 + + - [**Excel のエクスポート**](dashboard-export-excel.md) - ダッシュボードに使用されているデータを **Excel 形式**でエクスポートし、表示形式もスプレッドシートにエクスポートするかどうかを選択できます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/dashboard-linking.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/dashboard-linking.md new file mode 100644 index 00000000..d0327359 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/dashboard-linking.md @@ -0,0 +1,98 @@ +# ダッシュボード リンク + +Reveal はダッシュボード リンクをサポートしており、ダッシュボード内の表示形式を他のダッシュボードまたは URL に接続できます。表示形式により詳細な情報を表示したい場合、新しいダッシュボードを使用して目的を達成できます。この機能はトップダウン分析パスでとても役立ちます。ビジネスのハイレベルな概要から特定の詳細情報まで簡単にナビゲーションができます。 + +Company ダッシュボード (以下を参照) を見てみましょう。このダッシュボードは、各エリアの KPI (キー パフォーマンス インジケーター) を提供します。ダッシュボードを開くと、1 つ以上の表示形式に**リンク記号**が表示されます。 + +リンク記号をクリックまたはタップすると、以下を開くことができます: + +* **別のダッシュボード** (以下のスクリーンショットを参照)。表示形式またはその中の値に関連するより具体的な情報を提供します。 +* ダッシュボード ナビゲーションの一部としてサードパーティ ウェブ アプリケーションとのインタラクションなど拡張性を有効にする **URL**。 + +![](images/sample-linked-dashboards.png) + +![](images/sample-linked-dashboards-2.png) + +## リンクを追加 + +リンクを構成するには、表示形式エディターの **[設定]** セクションに移動し、**[リンク]** の **[+]** をクリックまたはタップします。または、**[表示形式を他のダッシュボードまたは URL に接続]** を選択することもできます。 + +![Adding a link in Settings](images/settings-linking-option.png) + +追加されたリンクは、ダッシュボードが**ビュー モード**の場合、構成されている表示形式にリンク記号として表示されます。 + +### 別のダッシュボードへのリンク + +別のダッシュボードにリンクすると、あるダッシュボードの特定のポイントから別のダッシュボードに移動することができます。このポイントは、選択したリンク トリガーに応じて、表示形式または表示形式の特定の値になります (以下を参照)。 + +ダッシュボードを別のダッシュボードにリンクするには、以下の手順を実行する必要があります。 + +1. リンク先のダッシュボードを**準備します**。2 つのダッシュボードの関係を注意深く検討してください。 + + メイン ダッシュボードと同じように、リンク先のダッシュボードに予め**フィルターの追加**をしておくと、共通のフィールドでこの 2 つのダッシュボードを接続できます。このフィールドは、2 番目のダッシュボードではフィルターとして、最初のダッシュボードでは測定されたカテゴリとしてのロールを果たします。 + +2. リンク先のダッシュボードを準備してから、リンクを追加するダッシュボードを開きます。リンク記号を表示する表示形式を選択し、**表示形式エディター**で開きます。 + +3. **[設定]** に移動し、**[リンク]** の **[+]** を選択して、**[新しいリンク]** ダイアログが開きます。 + + ![Dashboard linking sample](images/connecting-to-another-dashboard-option.png) + + ここでは、2 つのパラメーターを構成する必要があります: + + * リンク記号をクリックすると開く**ダッシュボード**。 + + * グリッド行またはチャート要素を選択した場合にユーザーに表示されるタイトルである**リンク名**。 + + ターゲット ダッシュボードにダッシュボード フィルターを追加した場合は、リンクを追加する表示形式のデータセット内の対応するフィールドにダッシュボード フィルターを接続する必要もあります (以下を参照)。**[完了]** をクリックして戻ります。 + + ![Edit connection dialog where a filter's value can be selected](images/edit-connection-dialog.png) + +4. **[リンクの作成]** 青いボタンを選択します。 + +ダッシュボードへのリンクは、**表示形式エディター**の **[リンク]** の下に表示されます。別の設定も表示されます - [トリガー]。[トリガーの選択](#トリガーの選択)の詳細については、以下を参照してください。 + +### URL の追加 + +URL の追加は、[新しいリンク] ダイアログのもう 1 つのオプションです。設定した URL をデバイスのブラウザで開くことができます。 + +2 つのパラメーターを定義する必要があります: + + - 表示形式が指す **[URL]**。リンク記号が選択されると、そこにリダイレクトされます。 + + - グリッド行またはチャート要素を選択した場合にユーザーに表示されるタイトルである **[リンク名]**。 + +URL の場合は、**変数**を含めることもできます。これにより、表示形式フィールドの値に基づいて、ユーザーにリンクされる URL が動的に作成されます。たとえば、以下の表示形式リンクを見てみましょう。 + +![Linking to URL in a new link dialog](images/linking-to-url.png) + +URL は `http://www.en.wikipedia.org/wiki` に設定されており、この場合は **CampaignID** 変数を選択しました。したがって、表示形式で **Navigate to Wiki** (Wiki へ移動) リンクを選択したユーザーは次のように表示されます: + + +`http://www.en.wikipedia.org/wiki/[CampaignID].htm` + +`[CampaignID]` は値によって異なります。 + +:::info **例のテスト** +変数の追加がどのように機能するかをテストするには、**Marketing Dashboard** を使用します。*CampaignID* データ フィールドを含む *Conversions by Campaign* 表示形式を選択し、スクリーンショットに示すように URL を追加します。表示形式を保存し、ダッシュボード編集モードで、ファネル表示形式のさまざまな部分をクリックして、リダイレクト先の URL がどのように変更されるかを確認します。 +::: + +## トリガーの選択 + +表示形式に最初のリンクを追加すると、[設定] の [リンク] の下に [トリガー] が表示されます。ここでは、トリガー オプションとして [値は選択されました] と [表示形式が最大化されました] のどちらかを選択できます。 +表示形式には必要な数のリンクを追加できますが、それらはすべて同じトリガーが有効になります。 + +### [値は選択されました] トリガー + +このオプションを選択すると、柱状、棒、円スライスなどのチャートのデータ項目がクリックまたはタップされるたびに、リンク記号の付いたツールチップが表示されます。グリッド チャートでは、リンク記号が右側の最後の列に表示されます (以下を参照)。 + +![Selected value trigger example](images/selected-value-trigger.png) + +*EmployeeName* を使用してダッシュボード フィルターをターゲット ダッシュボードに追加した場合、上のスクリーンショットに示すように、グリッド内のリンク記号をクリックすると、*Joan Baez* 値が事前に選択された *EmployeeName* フィールドでフィルターされた別のダッシュボードが開きます。このように、ターゲット ダッシュボードには、選択した値の分析のみが表示されます。 + +選択した値に URL がリンクされている場合は、リンク記号をクリックまたはタップすると、追加した URL が開きます。この機能を最大限に活用するために、フィールドを[変数](#url-の追加)として URL に追加することもできます。 + +### [表示形式が最大化されました] トリガー + +このオプションを選択すると、**ダッシュボード編集**モードで表示形式の右上隅にリンク記号が表示されます。したがって、表示形式を最大化する代わりに、右上隅のリンク記号を選択すると、別のダッシュボードまたはリンク先の URL が開きます。 + +![Linking icon in a dashboard in a dashboard view](images/maximized-visualization-trigger.png) \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/adhoc-hierarchies.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/adhoc-hierarchies.md new file mode 100644 index 00000000..043735df --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/adhoc-hierarchies.md @@ -0,0 +1,39 @@ +--- +title: Reveal アドホック階層 – 追加、作成、分析の高速化 +_description: Reveal で新しい階層を作成し、チャート、ゲージ、グリッド ビューでデータを分析します。 +_language: ja +--- + +# アドホック階層 + + +Reveal は年月日の日付フィールドの階層を自動的に作成しますが、他のタイプのフィールドでは発生しません。アドホック階層により、ユーザーはチャート、ゲージ、およびグリッドビューでデータを分析でき、データエディターの **[行]** プレースホルダーにあるフィールドを使用して新しい階層を作成できます。 + +![Ad Hoc Hierarchies example in the Visualization editor](images/ad-hoc-hierarchies-example.png) + +この機能は、Analysis Services などの多次元データ ソースではなく、プレーン データ ソース (SQLテーブル、Excelスプレッドシート、CSVファイルなど) に適用されます。これらの場合、階層はサーバー側で定義され、Reveal は**展開**および**ドリル**操作をサポートします。 + +:::note +アドホック階層は、テキスト、円形、画像、グリッド、テキスト ビュー チャートでは**サポートされていません**。 +::: +## アドホック階層の有効化 + +アドホック階層を有効にするには、データ エディターの **[行]** プレースホルダーの *[階層の追加]* にフィールドをドラッグアンドドロップします。これを設定するとデータ テーブルの構成および動作が変わります。 + +![Reveal Ad-hoc Hierarchies table](images/ad-hoc-hierarchy-pivot-chart.png) + +上記のスクリーンショットのように、単一の列が複数の列を置き換えます。スクリーンショットに示されている例では、ドリルアップおよびドリルダウンできるだけでなく、各部署を展開してオフィサーを表示することもできます。 + +## サポートされている可視化 + +アドホック階層は、**以下のものを除く**すべての表示形式に追加できます。 + + - 円形ゲージ + + - グリッド チャート + + - テキスト ゲージ + + - テキスト ビュー + + - 画像チャート diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/aggregation.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/aggregation.md new file mode 100644 index 00000000..30bd2908 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/aggregation.md @@ -0,0 +1,100 @@ +--- +title: Reveal で集計計算フィールドを使用する方法 +_description: 集計数式を使用するさまざまなヒントとコツを説明します。 +_language: ja +--- + +# 集計計算フィールド + + +集計式は、値の分析、再編成、含まれる情報の要約など、元のデータ ソースを使用して作業する場合に便利です。異なる値 (`average` など) の計算や最大 (`max`) / 最小 (`min`) の検索に使用することも可能です。そのため、**すべての数式**は**数値フィールドのみで使用します**。 + +Reveal では、集計計算フィールドに以下が含まれます。 + +- **標準関数**: 各情報は、「関数名」の下の対応するハイパーリンクをクリックします。 + +- **if 文を含む標準関数**: [このセクション](#if-文のある計算フィールド)は、if 文 ([ネスト if 文](#ネスト-if-文のサンプル)を含む) の詳細および構成方法について説明します。 + +:::note +以下の表のすべてのサンプルは HR Dataset 2016 スプレッドシートで作成されました。 +::: + +## 集計関数 + +| 関数名と説明 | 関数の構文 | サンプル | +|-------------------------------|-----------------|--------| +| **average**: `average` 集計は、選択した `expression` のすべての行の平均値で計算される数値を返します。 | `average({expression})` | `average([Wage])` | +| **averageif**: if-condition のある正則関数を使用する場合、結果が条件内で定義される特定の条件を満たす必要があります。 | `averageif({expression},{if-condition})` | `averageif([Wage],[OfficeId]=1)` | +| **count**: `count` 集計は、データ ソースの行数である数値を返します。 | `count()` | `count()` | +| **countif**: if-condition のある正則関数を使用する場合、結果が条件内で定義される特定の条件を満たす必要があります。 | `countif({if-condition})` | `countif([OfficeId]=1)` | +| **max**: `max` 集計は、選択した `expression` の最大値となる数値を返します。 | `max({expression})` | `max([Wage])` | +| **maxif**: if-condition のある正則関数を使用する場合、結果が条件内で定義される特定の条件を満たす必要があります。 | `maxif({expression},{if-condition})` | `maxif([Wage],[OfficeId]=1)` | +| **min**: `min` 集計は、選択した `expression` の最小値となる数値を返します。 | `min({expression})` | `min([Wage])` | +| **minif**: if-condition のある正則関数を使用する場合、結果が条件内で定義される特定の条件を満たす必要があります。 | `minif({expression},{if-condition})` | `minif([Wage],[OfficeId]=1)` | +| **sum**: `sum` 集計は、選択した `expression` のすべての行の合計として算出された数値を返します。 | `sum({expression})` | `sum([Wage])` | +| **sumif**: if-condition のある正則関数を使用する場合、結果が条件内で定義される特定の条件を満たす必要があります。 | `sumif({expression},{if-condition})` | `sumif([Wage],[OfficeId]=1)` | + + +## IF 文のある計算フィールド + +`if-condition` のある正則関数 (`expression` が必要) を使用する場合、結果が条件内で定義される特定の条件を満たす必要があります。 + +### 構文 + +デフォルトでは、IF サフィックスのある関数を選択した際に以下の構成が表示されます。 + +`XXXXXXIF({expression},{if-condition})` + +2 つの引数を定義する必要があります。 + +- `expression`: データ ソースのフィールドの 1 つを選択します。 + +- `if-condition`: if 条件は論理テストの実行が必要です。`if-condition` の `logical test` は、集計を計算するための式に必要な条件です。 + +### 基本サンプル + +たとえば、上記の表の例です。 + +`averageif([Wage],[OfficeId]=1)` + +より明確にするために関数を上記で定義した用語に基づいて区別します。 + +| 関数名 | 式 | IF 文 | +| :------------: | :--------: | :-----------: | +| averageif (…​) | [Wage] | [OfficeId]=1 | + +以下は数値以外の場合の例です。 + +`sumif([Wage],[Department]="Development")` + +説明: + +| 関数名 | 式 | IF 文 | +| :------------: | :--------: | :-----------: | +| sumif (…​) | [Wage] | [OfficeId]=1 | + +### ネスト IF 文のサンプル + +論理演算子 (AND、OR) を前に使用してネスト IF 文を使用できます。 + +以下は if 文が 2 つある例ですが、if 文を使用する際の上限はありません。 + +`maxif([Wage], and([OfficeId]=1, [Department]="Development"))` + +説明: + +| 関数名 | 式 | 論理演算子 | +|:----------:| :--------: | :--------------: | +| maxif (…​) | [Wage] | and | + +`if-condition` のステートメント: + +| 最初の論理テスト | true の場合の値 | false の場合の値 | +| :----------------: | :-----------: | :------------: | +| [OfficeId]=1 | 1 | 0 | + +| 2 番目の論理テスト | true の場合の値 | false の場合の値 | +| :------------------------: | :-----------: | :------------: | +| [Department]="Development" | 1 | 0 | + +論理演算子が `and` であるため、実行する `maxif` 集計の両方の条件が true である必要があります。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/date.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/date.md new file mode 100644 index 00000000..e687f67b --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/date.md @@ -0,0 +1,93 @@ +--- +title: Reveal で日付計算フィールドを使用する方法 +_description: 日付計算フィールドを使用してさまざまな日時情報を出力する方法を説明します。 +_language: ja +--- + +# 日付計算フィールド + +日付数式は、ウィジェットでさまざまな日付と時刻の情報を出力するために使用できます。 + +:::note +計算フィールドに数式に含まれる情報が表示されます。日付と時刻に設定した書式をオーバーライトします。 +::: + +## 日付関数 + +| 関数名 | 構文とサンプル | +|---------------|-------------------| +| date | **構文**: `date({year},{month},{day},{hour},{minute},{second})`
**サンプル**: `date(1971,11,08,12,59,08)` | +| datediff | **構文**: `datediff({date1}, {date2}, {lapse})`
**サンプル**: `datediff("23/05/2015", "23/05/2016", "d")` | +| datevalue | **構文**: `datevalue({date},{format},{locale})`
**サンプル**: `datevalue("23/05/2015","dd/mm/yyyy","en")` | +| day | **構文**: `day({date})`
**サンプル**: `day(date(1971,11,08,01,22,44))` | +| formatdate | **構文**: `formatdate({date},{format},{locale})`
**サンプル**: `formatdate(date(1971,11,08,01,22,44),"dd/mm/yyyy","en")` | +| fquarter | **構文**: `fquarter({date},{number})`
**サンプル**: `fquarter(date(2017,12,1,12,33,48),4)` | +| fyear | **構文**: `fyear({date},{number})`
**サンプル**: `fyear(date(2017,12,1,12,33,48),2)` | +| hour | **構文**: `hour({date})`
**サンプル**: `hour(date(2017,12,1,12,33,48))` | +| millisecond | **構文**: `millisecond({time})`
**サンプル**: `millisecond(time(11,29,48,799))` | +| minute | **構文**: `minute({date})`
**サンプル**: `minute(date(2017,12,1,12,33,48))` | +| month | **構文**: `month({date})`
**サンプル**: `month(date(2017,12,1,12,33,48))` | +| monthname | **構文**: `monthname({date},{locale})`
**サンプル**: `monthname(date(2017,12,1,12,33,48),"en")` | +| monthshortname | **構文**: `monthshortname({date},{locale})`
**サンプル**: `monthshortname(date(2017,12,1,12,33,48),"en")` | +| now | **構文**: `now()`
**サンプル**: `now()` | +| quarter | **構文**: `quarter({date})`
**サンプル**: `quarter(date(2017,12,1,12,33,48))` | +| second | **構文**: `second({date})`
**サンプル**: `second(date(2017,12,1,12,33,48))` | +| time | **構文**: `time({hour},{minute},{second},{millisecond})`
**サンプル**: `time(11,08,08,11)` | +| today | **構文**: `today()`
**サンプル**: `today()` | +| weekday | **構文**: `weekday({date})`
**サンプル**: `weekday(date(2017,12,1,12,33,48))` | +| weeknum | **構文**: `weeknum({date})`
**サンプル**: `weeknum(date(2017,12,1,12,33,48))` | +| year | **構文**: `year({date})`
**サンプル**: `year(date(2017,12,1,12,33,48))` | +| semester | **構文**: `semester({datetime})`
**サンプル**: `semester(datetime(1))` | +| fsemester | **構文**: `fsemester({date}, {number})`
**サンプル**: `fsemester(date(2015,11,1,11,33,48),1)` | +| applytimezone | **構文**: `applytimezone({date}, {timezone})`
**サンプル**: `applytimezone(date(2015,12,1,10,33,38), ([Timezone]/24))` | +| currenttimezone | **構文**: `currenttimezone()`
**サンプル**: `currenttimezone()` | +| datetimefromunixts | **構文**: `datetimefromunixts ({miliseconds})`
**サンプル**: `datetimefromunixts(0.001)` | + + + +## Date + +`date` を使用する場合、Reveal は日付セットを数式に含まれる値へ返します。 + +### 構文 + +デフォルトで、date を選択した際に以下の構成が表示されます。 + +`date({year},{month},{day},{hour},{minute},{second})` + +すべての値 (`month` を含む) は、数値で表す必要があります。 + +### サンプル + +次の構造の数式は 08-Nov-1971 12:59 を返します。 + +| 関数名 | Year | Month | Day | Hour | Minute | Second | +| :-----------: | :--: | :---: | :-: | :--: | :----: | :----: | +| date (…​) | 1971 | 11 | 08 | 12 | 59 | 08 | + +次の構造の数式は、「hour」 の値が 24 時を超えているため 「09-Nov-1971 03:59」 を返します。数式の要素の順序は変更しないでください。 + +| 関数名 | Year | Month | Day | Hour | Minute | Second | +| :-----------: | :--: | :---: | :-: | :----: | :----: | :----: | +| date (…​) | 1971 | 11 | 08 | **27** | 59 | 08 | + + +## Time + +time を使用する場合、Reveal は数式に含まれる値に設定した時刻を返します。 + +### 構文 + +デフォルトで、time を選択した際に以下の構成が表示されます。 + +`time({hour},{minute},{second},{millisecond})` + +### サンプル + +次の構造の数式は 11:08:08 を返します。 + +| 関数名 | Hour | Minute | Second | Millisecond | +| :-----------: | :--: | :----: | :----: | :---------: | +| time (…​) | 11 | 08 | 08 | 11 | + +ミリ秒パラメーターは、計算フィールドに含まれません。ただし、異なる数式 (millisecond) 内の time に含まれる、値のみを表示することができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/YoyAnalysisPercentage_All.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/YoyAnalysisPercentage_All.png new file mode 100644 index 00000000..86c149f6 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/YoyAnalysisPercentage_All.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/YoyAnalysisRevenue_All.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/YoyAnalysisRevenue_All.png new file mode 100644 index 00000000..2ee4191f Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/YoyAnalysisRevenue_All.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/calculated-field-option.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/calculated-field-option.png new file mode 100644 index 00000000..1c2a5033 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/calculated-field-option.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/new-calculated-field-bottom-list.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/new-calculated-field-bottom-list.png new file mode 100644 index 00000000..19ca25bf Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/new-calculated-field-bottom-list.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/new-calculated-field-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/new-calculated-field-dialog.png new file mode 100644 index 00000000..65105277 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/new-calculated-field-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/new-calculated-field-screen.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/new-calculated-field-screen.png new file mode 100644 index 00000000..51e42c88 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/new-calculated-field-screen.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/new-calculated-field-visualization-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/new-calculated-field-visualization-example.png new file mode 100644 index 00000000..b6b527d0 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/new-calculated-field-visualization-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/post-calculated-field-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/post-calculated-field-example.png new file mode 100644 index 00000000..033295c5 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/post-calculated-field-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/post-calculated-field-new-calculated-field-dialog-adding-fields.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/post-calculated-field-new-calculated-field-dialog-adding-fields.png new file mode 100644 index 00000000..41adfe06 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/post-calculated-field-new-calculated-field-dialog-adding-fields.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/post-calculated-field-new-calculated-field-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/post-calculated-field-new-calculated-field-dialog.png new file mode 100644 index 00000000..7e80e0ac Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/post-calculated-field-new-calculated-field-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/post-calculated-field-new-calculated-field-screen-adding-fields.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/post-calculated-field-new-calculated-field-screen-adding-fields.png new file mode 100644 index 00000000..64cdd53c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/post-calculated-field-new-calculated-field-screen-adding-fields.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/post-calculated-fields-data-editor.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/post-calculated-fields-data-editor.png new file mode 100644 index 00000000..4ef67644 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/post-calculated-fields-data-editor.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/pre-calculated-field-button.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/pre-calculated-field-button.png new file mode 100644 index 00000000..90d478a6 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/pre-calculated-field-button.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/yoy-analysis-percentage-all.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/yoy-analysis-percentage-all.png new file mode 100644 index 00000000..bc0589dd Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/yoy-analysis-percentage-all.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/yoy-analysis-revenue-all.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/yoy-analysis-revenue-all.png new file mode 100644 index 00000000..d84685e5 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/images/yoy-analysis-revenue-all.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/information.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/information.md new file mode 100644 index 00000000..efbef488 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/information.md @@ -0,0 +1,40 @@ +--- +title: Reveal で情報計算フィールドを使用する方法 +_description: 情報計算フィールドで選択したフィールドの値を使用してテストする方法を説明します。 +_language: ja +--- + +# 情報計算フィールド + +情報計算フィールドは、指定したフィールドの値のテストに使用します。サイズの大きいスプレッドシートの場合、2 回目の計算を実行する前に作業する情報のタイプを確認できるため、大変便利です。 + +## 情報関数: + +| **関数名** | **構文とサンプル** | +|--------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------| +| **empty**: `empty` は、空のセルを含む列を挿入するために使用できます。構成する引数はありません。 | **構文**: `empty()`
**サンプル**: `empty()` | +| [**isempty**](#isempty): `isempty` は指定した `expression` を評価してデータ ソースの各行の値が空かどうかをチェックします。 | **構文**: `isempty({value})`
**サンプル**:`isempty([ResignedDate])` | + + + + +## isempty + +empty とは異なり、isempty は選択したフィールドおよびデータシートの各行を確認します。 + +行に値がない場合、出力は 1 です。値がある場合、0 が出力されます。 + +### サンプル + +| 関数名 | 構文 | サンプル | +| :-----------: | :----------------: | :-----------------------: | +| isempty | `isempty({value})` | `isempty([ResignedDate])` | + +HR Dataset 2016 スプレッドシートの 4 行について確認します。 + +| EmployeeID | FullName | …​ | Resigned Date | …​ | Calculated Field | +| :--------: | :---------------: | :--: | :-------------: | :--: | :--------------: | +| 1.00 | Joan Baez | …​ | | …​ | 1.00 | +| 4.00 | Zurcher Reid | …​ | **28-Dec-2016** | …​ | 0.00 | +| 22.00 | Zornes Hall | …​ | | …​ | 1.00 | +| 35.00 | Zdiarski Campbell | …​ | **09-Apr-2016** | …​ | 0.00 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/logic.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/logic.md new file mode 100644 index 00000000..4093a826 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/logic.md @@ -0,0 +1,246 @@ +# 論理計算フィールド + + +論理計算フィールドは、データ ソースの 2 つ以上の値の比較に使用できます。値を送信した論理テストに基づいて常に 0 または 1 を返します。 + +Reveal では、論理計算フィールドは次のとおりです。 + + - **引数のない関数**: それぞれ 1 と 0 を返す `true()` および `false()`。 + + - **論理テストのある複素関数**: 各関数の詳細な情報は、以下の表にあるリンクをクリックしてください + +:::note +*以下の表のすべてのサンプルは HR Dataset 2016 スプレッドシートで作成されました。* +::: + +## 論理関数: + +| **関数名** | **構文とサンプル** | +|----------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------| +| [**and**](#and-と-or): `and` は 2 つの論理テストを実行します。論理テストは true の場合、1 を返します。1 つまた 2 つは false の場合、0 を返します。 | **構文**: `and({logical1},{logical2})`
**サンプル**: `and([BirthDate]>date(1983, 07, 15, 04, 06, 55),[Department]="CPA")` | +| [**false**](#true-と-false): `false` は論理値の false である 0 を返します。 | **構文**: `false()`
**サンプル**: `false()` | +| [**if**](#if): `if` は論理テストを実行します。論理テストは true の場合、1 を返します。論理テストは false の場合、0 を返します。 | **構文**: `if({logical test},{value if true},{value if false})`
**サンプル**: `if([BirthDate]<(1971,04,15,4,06,55),1,0)` | +| [**not**](#not): `not` は論理テストを実行します。論理テストは false の場合、1 を返します。論理テストは true の場合、0 を返します。 | **構文**: `not({logical})`
**サンプル**: `not([OfficeId]>=3)` | +| [**or**](#and-と-or): `or` は 2 つの論理テストを実行します (if ステートメント)。論理テスト の 1 つのいずれか true の場合、1 を返します。両方が false の場合、0 を返します。 | **構文**: `or({logical1},{logical2})`
**サンプル**: `or(if([Office]="London,UK",1,0),if([BirthDate]**サンプル**: `true()` | + + + +## If + +If 関数で論理テストで定義した特定の条件を満たす結果を見つけることができます。3 つの引数で構文されます。 + + - `logical test`: 平均を計算するための式に必要な条件。 + + - `value if true` 論理テストが true の場合に関数がアウトプットする値。 + + - `value if false`: 論理テストが false の場合に関数がアウトプットする値。 + +### 基本サンプル + +たとえば、上記の表の例です。 + +`if([BirthDate]date(1992,09,15,4,06,55)` + + - `[Department]="Development"` + +論理演算子が `and` であるため、実行する `maxif` 集計の両方の条件が true である必要があります。 + + +## And と Or + +`and` および `or` 関数は、適用する必要のある 2 つの論理テストを宣言してネスト if 条件を構築できます。and および or に同じ構文があります。 + +| 関数名 | 論理テスト 1 | 論理テスト 2 | 出力 | +| :-----------: | :------------: | :------------: | :-----------------------------------------------------------------------------------------------------------------------: | +| **and** (…​) | `logical1` | `logical2` | **両方の条件が満たされる場合、1 を返します**。 **条件の 1 つのみを満たす**場合、または **条件が満たされない**場合、**0 を返します**。 | +| **or** (…​) | `logical1` | `logical2` | **両方の条件、または条件の1 つのみを満たす場合、1 を返します**。**条件が満たされない**場合、**0 を返します**。 | + +### サンプル + +以下は *and* および *or* サンプルの例です。 + + - `and([BirthDate]>date(1983,07,15,04,06,55), [Department]="CPA")` + + - `or([Office]="London,UK",[BirthDate]date(1983,07,15,04,06,55)` | `[Department]="CPA"` | 行に基づいた 1 および 0。 | +| `or (…​)` | `[Office]="London,UK"` | `[BirthDate]date(1981,07,15,4,06,05) | [Department]="CPA" | [Wage]>150000 | +| | | | [Office]="Tokyo,Japan" | + +and/or 関数を [isempty](information.md#isempty) 計算フィールドと組み合わせて同じ結果を取得することも可能です。 + +| 関数名 | 論理テス 1 | 論理テス 2 | 論理テス 3 | 論理テス 4 | +| :-----------: | :------------: | :------------: | :-------------: | :-----------------------: | +| `and (…​)` | 同上 | 同上 | `[OfficeId]>=3` | `ISEMPTY([ResignedDate])` | + +構文が追加の引数によって複雑になるため、追加の条件をネストして論理テストをグループ化できます。結果に影響はありませんが、2 つ目の and を明確に定義する必要があります。 + +`and([BirthDate]>date(1981,07,15,4,06,05),[Department]="CPA",[OfficeId]>=3,ISEMPTY([ResignedDate]))` + + - 論理テス 1: `[BirthDate]>date(1983,07,15,4,06,55)` + + - 論理テス 2: `[Department]="CPA"` + + - 論理テス 3: `[OfficeId]>=3` + + - 論理テス 4: `ISEMPTY([ResignedDate])` + +### 複雑な計算フィールドの簡素化 + +複数の if 条件に基づいた結果が必要な場合は、上記のサンプルの数式などが便利ですが、構文は複雑になります。個別の計算フィールドを作成して 1 つの数式に結合することにより簡素化できます。たとえば、以下の計算フィールドがあります。 + +`and([BirthDate]>date(1981,07,15,4,06,05),[Department]="CPA",[OfficeId]>=3,ISEMPTY([ResignedDate]))` + +4 つの if 条件があります。 + + - `[BirthDate]>date(1983,07,15,4,06,55)` + + - `[Department]="CPA"` + + - `[OfficeId]>=3` + + - `ISEMPTY([ResignedDate])` + +各 IF 条件の計算フィールドをわかりやすい名前で作成できます。 + +| IF ステートメント | 新しい計算フィールド | 計算済の数式 | +| :------------: | :--------------------------------: | :------------------------------------: | +| IF ステートメント 1 | Employees Born after July 15, 1981 | `[BirthDate]>date(1981,07,15,4,06,05)` | +| IF ステートメント 2 | CPA Employees | `[Department]="CPA"` | +| IF ステートメント 3 | JP, UY and BG Employees | `[OfficeId]>=3` | +| IF ステートメント 4 | Current Employees | `ISEMPTY([ResignedDate])` | + +これらの新しいステートメントを新しい計算フィールドに結合します。 + +`and([Employees Born after 1981],[CPA Employees],[JP, UY and BG Employees],[Current Employees])` + + +## Not + +Not 関数を使用して、論理テストが true かどうかを確認できます。デフォルトでは、Not をタップすると以下の構造が表示されます。 + +`not(logical)` + +### サンプル + +| 関数名 | 論理テス | +| :-----------: | :--------------: | +| `not (…​)` | `[OfficeId]>=3)` | + +説明: + +| 式 | 演算子 1 | 演算子 2 | 条件の引数 | +| :----------: | :--------: | :--------: | :---------------: | +| `[OfficeId]` | `>` | `=` | `3` | + +### Not を and/or と組み合わせる + +Not を使用して `and`/`or` 計算フィールドで反対の結果を取得できます。 + +以下の and 計算フィールドは、両方の if 条件が同時に true の EmployeeId 66 (Zerbe Johansen) のみに 1 を返します。すべての他の行は 0 を返します。 + +| 関数名 | 論理テスト 1 | 論理テスト 2 | +| :-----------: | :------------------: | :------------------------------------: | +| `and (…​)` | `[Department]="CPA"` | `[BirthDate]>date(1992,09,15,4,06,55)` | + +`not` を計算フィールドの前に追加することにより、反対の結果を取得できます。 + +| not | and | 論理テスト 1 | 論理テスト 2 | +| :--------: | :--------: | :------------------: | :------------------------------------: | +| `not (…​)` | `and (…​)` | `[Department]="CPA"` | `[BirthDate]>date(1992,09,15,4,06,55)` | + +以前 0 を返したすべての行は 1 を返し、すべての 1 は 0 になります。 + + +## True と False + +`true` と false 関数が引数なしで使用されます。つまり論理テストが適用されていないため、**論理テストを実行する式や特定のステートメントがありません**。 + +これらを if などの他の論理計算フィールドと組み合わせて使用すると便利です。以下は一般的な if 構文の例です。 + +| 関数名 | 引数 1 | 引数 2 | 引数 3 | +| :-----------: | :------------: | :-------------: | :--------------: | +| **if** (…​) | `logical test` | `value if true` | `value if false` | + +この式を、セクションの最初にある if の例で置き換えましょう (`if([BirthDate]HR Dataset 2016 スプレッドシートで作成されました。** +::: + +## 検索/行列関数 + +| **関数名** | **構文とサンプル** | +|-------------------|-----------------------------------------------------------------------------------------| +| [**previous**](#previous): `previous` は、`expression` として選択したフィールドの値で結果を取得できます。 | **構文**: `previous({expression},{first value})`
**サンプル**: `previous([Wage],1)` | +| **row**: `row` は、データ ソース内のすべての行の現在の行の番号を返します。 | **構文**: `row()`
**サンプル**: `row()` | + + + +## Previous + +前の計算フィールドでは、`expression` で選択したフィールドの値で結果を取得できます。引数を 2 つ設定します。 + + - `expression`: データ ソースのフィールドの 1 つ。 + + - `first value`: デフォルトで空の最初の行の値。 + +### サンプル + +以下は、HR Dataset 2016 の「Employees」シートを抽出したものです。 + +| EMPLOYEEID | FULLNAME | DEPARTMENT | OFFICE | WAGE | +| ---------- | ----------------- | ----------- | ------------------------- | -------- | +| 1.00 | Joan Baez | Development | Montevideo, Uruguay | 36542.00 | +| 2.00 | Zurbuch Thompson | Development | Cranbury, New Jersey, USA | 76865.00 | +| 3.00 | Zimmermann Miller | Development | Cranbury, New Jersey, USA | 73768.00 | +| 4.00 | Zurcher Reid | Development | Sofia, Bulgaria | 36018.00 | + +以下の計算フィールドを追加します。 + +`previous([Wage],1)` + +以下は計算フィールドの結果です。 + +| EMPLOYEEID | FULLNAME | DEPARTMENT | OFFICE | WAGE | previous Field | +| ---------- | ----------------- | ----------- | ------------------------- | ------------ | -------------- | +| 1.00 | Joan Baez | Development | Montevideo, Uruguay | **36542.00** | **1.00** | +| 2.00 | Zurbuch Thompson | Development | Cranbury, New Jersey, USA | **76865.00** | **36542.00** | +| 3.00 | Zimmermann Miller | Development | Cranbury, New Jersey, USA | **73768.00** | **76865.00** | +| 4.00 | Zurcher Reid | Development | Sofia, Bulgaria | 36018.00 | **73768.00** | + +表に示すように、2 つ目の行は 2 つ目の行に `[WAGE]` 値を返します。関数で設定したとおり列の最初のセルを `1` で埋めます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/math.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/math.md new file mode 100644 index 00000000..aaf2d275 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/math.md @@ -0,0 +1,26 @@ +--- +title: 数学計算フィールドを使用する方法 +_description: 数学計算フィールドを使用してダッシュボードを完成させる方法を説明します。 +_language: ja +--- + +# 数学計算フィールド + + +Math カテゴリのすべての関数はオンザフライで計算を実行する際に大変便利です。`rand` や `randbetween` 関数などの特定の関数は、データ ソースの行の順序をランダム化する場合に便利です。 + +## 数学関数 + +| **関数名** | **構文とサンプル** | +|-------------------|-------------------------------------------------------------------------------| +| **abs**: `abs` 関数は入力した数値の絶対値 (記号なしの数値) を返します。 | **構文**: `abs({number})`
**サンプル**: `abs(-3)` | +| **exp**: `exp` 関数は e (Euler の数値) を入力した値で乗した値を返します。 | **構文**: `exp({number})`
**サンプル**: `exp(8)` | +| **log**: `log` 関数は関数で指定された数を底とする数値の対数を返します。底が入力されていない場合、分析は対数の底が 10 であると仮定します。 | **構文**: `log({number},{logbase})`
**サンプル**: `log(10,4)` | +| **log10**: `log10` 関数は数値の対数を返します。ただし、底は常に 10 に設定されます。 | **構文**: `log10({number})`
**サンプル**: `log10(1500)` | +| **mod**: `mod` 関数は 2 つの数値を除算した場合の剰余または少数部を返します。 | **構文**: `mod({number},{divisor})`
**サンプル**: `mod(5,3)` | +| **rand**: `rand` 関数は 0 より大きく 1 未満の 実数を返します。関数に引数は必要ありません。引数を設定する必要はありませんが、乱数をさらに変更するための数学演算子を含むことができます。 | **構文**: `rand()`
**サンプル**: `rand()` | +| **randbetween**: `randbetween` 関数は指定した範囲内の整数を返します。 | **構文**: `randbetween({bottom},{top})`
**サンプル**: `randbetween(0,9878654)` | +| **sign**: `sign` 関数は数値の符号を決定して返します。 | **構文**: `sign({number})`
**サンプル**: `sign(-1564)` | +| **sqrt**: `sqrt` 関数は指定した数値の平方根を返します。 | **構文**: `sqrt({number})`
**サンプル**: `sqrt(427716)` | +| **trunc**: `trunc` 関数は数値の整数部分 (小数以外) を返します。 | **構文**: `trunc({number})`
**サンプル**: `trunc(65787.24657)` | + diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/overview.md new file mode 100644 index 00000000..9d6b6544 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/overview.md @@ -0,0 +1,163 @@ +--- +title: 計算フィールドを使用する方法 +_description: 計算フィールドとそのすべてのタイプを使用して、より正確なデータ可視化を作成する方法を説明します。 +_language: ja +--- + +# 計算フィールド + +Reveal では、計算フィールドというフィールドをデータセットに定義することができます。フィールドは、式 (数式) を使用して作成されます。式は、既存のフィールド、定数値、および以下の組み合わせにすることができます。 + + - [定義済み関数](#reveal-定義済み関数の使用) + + - [単純な数学関数および定義されていない他の関数](#定義済み関数を使用せず計算フィールドを作成)。 + +以下の 2 種類の計算フィールドがあります。 + + - [事前計算](#事前計算フィールド) (計算済み) + + - [事後計算](#事後計算フィールド)。 + + +## 事前計算フィールド + +事前計算フィールドは、データ エディターの集計を実行する前に評価されます。つまり、特定の数式を適用するために、Reveal はフィールドのデータセット内のすべてのレコードを 1 回または複数回調べます。そのため、大規模なデータセットを使用する場合、事前計算のパフォーマンスが低下する可能性があります。 + +新しい計算フィールドを追加するには、**[フィールド]** パネルの **[+]** ボタンをクリックまたはタップし、**[計算フィールド]** を選択します。 + +![Pre-calculated field option](images/calculated-field-option.png) + +[計算フィールドの作成] 画面が開きます。 + +![New calculated field dialog](images/new-calculated-field-dialog.png) + +以下の手順を実行します。 + +1. 新しい計算フィールドに名前を割り当てます。 + +2. 数式 (式) を入力します。[フィールド] セクションで、すべての既存のフィールドのリストがら選択できます。1 つ以上のフィールドを使用して (選択したフィールドをクリックまたは角括弧で名前を入力) 数式を作成できます。[関数] セクションにリストされている定義済み関数のいずれかを選択して、または単純な数学計算を使用します (上記に表示)。 + +新しい計算フィールドは、フィールド リストの下部に表示されます。 + +![New calculated field shown in the column placeholder and in the visualization](images/new-calculated-field-visualization-example.png) + +上記の例では、集計がデータ フィールドに適用されていないグリッドの可視化で新しい計算フィールドが使用されます。事前計算フィールドは、**ピボット グリッド**でも使用できます。この場合、計算は事前計算フィールドで集計されたレコードに適用されます。 + + +## 事後計算フィールド + +**データ エディター**でデータ フィールドの集計を実行する**ピボット テーブル**やその他の表示形式を使用する場合、事後計算フィールドを作成できます。事後計算フィールドは、すでに集計された値に数式を適用することによって常に作成されます。 + +事後計算フィールドを作成する手順: + +1. **データ エディター**でデータ ソースからフィールドを追加して、表示形式 (または**ピボット テーブル**) を作成します。 + + ![Post calculated fields in the Data editor](images/post-calculated-field-example.png) + +2. **[値]** の横にある **[F(x)]** ボタンをクリック/タップして、**[計算フィールドの作成]** 画面を開きます。 + + ![Post calculated field new calculated field screen](images/post-calculated-field-new-calculated-field-dialog.png) + +3. 計算フィールドに名前を付け、集計値に数式を適用します。注: **値**のリストには、集計後に表示形式で使用したデータ フィールドが含まれています (*Spend*、*Budget* ではなく、*Sum of Spend*、*Sum of Budget*)。 + +**データ エディター**に含まれていないデータ ソースの他のフィールドを使用する場合は、**[値]** の横の **[+]** ボタンをクリックまたはタップして追加できます。事後計算フィールドは集計値のみで作成されるため、最初にデータ フィールドで実行する集計をドロップダウン リストから選択する必要があります。 + +![Adding fields in the calculated field screen](images/post-calculated-field-new-calculated-field-dialog-adding-fields.png) + +**手順 1** をスキップして、最初に事後計算フィールドを作成するか、表示形式で事後計算フィールドのみを使用することもできます。 + +大規模なデータセットを使用する場合、事後計算は事前計算よりパフォーマンスが向上します。 + + +## Reveal 定義済み関数の使用 + +事前計算フィールドと事後計算フィールドの両方で、Reveal で使用可能な機能のいずれかを使用できます。 + + - [**集計**](aggregation.md): + [average](aggregation.md#集計関数)、 + [averageif](aggregation.md#集計関数)、 + [count](aggregation.md#集計関数)、 + [countif](aggregation.md#集計関数)、 + [max](aggregation.md#集計関数)、 + [maxif](aggregation.md#集計関数)、 + [min](aggregation.md#集計関数)、 + [minif](aggregation.md#集計関数)。 + + - [**日付**](date.md): + [date](date.md#日付関数)、 + [datevalue](date.md#日付関数)、 + [day](date.md#日付関数)、 + [formatdate](date.md#日付関数)、 + [fquarter](date.md#日付関数)、 + [semester](date.md#日付関数)、 + [fsemester](date.md#日付関数)、 + [fyear](date.md#日付関数)、 + [hour](date.md#日付関数)、 + [millisecond](date.md#日付関数)、 + [minute](date.md#日付関数)、 + [month](date.md#日付関数)、 + [monthname](date.md#日付関数)、 + [monthshortname](date.md#日付関数)、 + [applytimezone](date.md#日付関数)、 + [currenttimezone](date.md#日付関数)、 + [datetimefromunixts](date.md#日付関数)、 + [now](date.md#日付関数)、 + [quarter](date.md#日付関数)、 + [second](date.md#日付関数)、 + [time](date.md#日付関数)、 + [today](date.md#日付関数)、 + [weekday](date.md#日付関数)、 + [weeknum](date.md#日付関数)、 + [year](date.md#日付関数)。 + + - [**情報**](information.md): + [empty](information.md#情報関数)、 + [isempty](information.md#情報関数). + + - [**論理**](logic.md): + [and](logic.md#論理関数)、 + [false](logic.md#論理関数)、 + [if](logic.md#論理関数)、 + [not](logic.md#論理関数)、 + [or](logic.md#論理関数)、 + [true](logic.md#論理関数)。 + + - [**検索/行列**](lookup-reference.md): + [previous](lookup-reference.md#検索行列関数)、 + [row](lookup-reference.md#検索行列関数). + + - [**数学**](math.md): + [abs](math.md#数学関数)、 + [exp](math.md#数学関数)、 + [log](math.md#数学関数)、 + [log10](math.md#数学関数)、 + [mod](math.md#数学関数)、 + [rand](math.md#数学関数)、 + [randbetween](math.md#数学関数)、 + [sign](math.md#数学関数)、 + [sqrt](math.md#数学関数)、 + [trunc](math.md#数学関数)。 + + - [**文字列**](string.md): + [concatenate](string.md#文字列関数)、 + [find](string.md#文字列関数)、 + [len](string.md#文字列関数)、 + [lower](string.md#文字列関数)、 + [mid](string.md#文字列関数)、 + [replace](string.md#文字列関数)、 + [sortinterval](string.md#文字列関数)、 + [trim](string.md#文字列関数)、 + [upper](string.md#文字列関数)。 + +:::note +**IF 条件の制限**。事前計算のフィールドの集計関数に含まれる場合、IF 条件には既知の制限があります。計算式内の IF 条件を確認するためにすべてのレコードを複数回調べる必要があり、パフォーマンスが低下する問題が発生するため、サポートされていません。::: + +## 定義済み関数を使用せず計算フィールドを作成 + +定義済み関数を使用せずに計算フィールドを作成することもできます。たとえば、減算、除算、加算、乗算などの単純な数学計算用。[こちらの表](samples.md)には、定義済み関数を使用しない例があります。 + +## Reveal の関数を使用する際に注意すること + + - テキスト文字列は引用符で囲む必要があります。例えば、ロケール ("en") および日付書式 ("dd/mm/yyyy")。 + + - 数式に含まれるフィールドは角括弧で囲む必要があります。たとえば、HR データセットの [Wage]、[BirthDate]、[EmployeeID] などです。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/samples.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/samples.md new file mode 100644 index 00000000..228af085 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/samples.md @@ -0,0 +1,60 @@ +--- +title: 計算フィールドのヒント、サンプル、および便利なケース +_description: Reveal のデータ可視化で役立つヒントやサンプルを紹介します。 +_language: ja +--- + +# サンプル、ヒント、および便利なケース +## ベーシックなサンプル式 + +以下は計算フィールドのサンプル式のセットです。 + + +| 関数名 | 関数をテストするためのサンプル データセット | 式 | サンプル出力 | +| -------------------------- |----------------------------------------| ----------------------------------------------------------------- | -------------------------------------- | +| **Opposite Value** | HR Dataset | \-[Wage] | \-36,542.00 (for Joan Baez) | +| **Age** | HR Dataset | (today()-[BirthDate])/365 | 50.13 (for Joan Baez) | +| **Name & Department** | HR Dataset | [Fullname]& ", " &[Department] | Joan Baez, Development (for Joan Baez) | +|**Sales Percentage** | Samples | [New Sales]*100/sum([New Sales]) | 9,26% (for Japan) | +| **Name starts with J** | HR Dataset | if(find("j",lower([Fullname]),1)=1,"Starts with J",0) | Starts with J, 0 | +| **Deviation from Avg** | HR Dataset | [Wage]-average([Wage]) | \-50476.71 (for Joan Baez) | + + +## Unix 更新日時を使用可能な日付へ変換 + +1970 年 1 月 1 日後の秒によって定義される Unix 時間 (Epoch 時間) はすべてのタイムゾーンを一度に表すために便利です。Unix 更新日時を持つデータ ソースをインポートする場合、[`date`](date.md) 数式を使用して利用可能な日付に変換できます。 + +`((([Unix Time Stamp]/60)/60)/24)+DATE(1970,1,1)+([Timezone]/24)` + +説明: + + - **オリジナルのフィールド**: [Unix Time Stamp] + + - **分に変換**: /60 + + - **時に変換**: /60 + + - **日に変換**: /24 + + - **Epoch 時間の追加**: +DATE(1970,1,1) + + - **タイムゾーンの追加**: +([Timezone]/24) + +タイムゾーンを数値として入力するか、数値を持つフィールドを使用できます。GMT 時間が必要です。 + + +## YoY 解析: 売上を 2 年期間の比較 + +計算フィールドを簡易な YOY 解析を実行するために作成できます。 + +以下のダッシュボードを参照します。会社の事業部および 2 年間の売上を表示します。 + +![YoyAnalysisRevenue\_All](images/yoy-analysis-revenue-all.png) + +以下の計算フィールドを使用して 2 つの数値を比較できます。「-1」 は年の違いを減算します。 + +`([Revenue 2017]/[Revenue 2016])-1` + +数値を使用するか、[パーセンテージとして書式](../field-settings.md#数値フィールド)設定できます。 + +![Comparing Revenue Figures in yoy analysis while using percentage](images/yoy-analysis-percentage-all.png) \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/string.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/string.md new file mode 100644 index 00000000..85e47ac8 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/calculated/string.md @@ -0,0 +1,153 @@ +--- +title: 文字列計算フィールドを使用する方法 +_description: 文字列計算フィールドを使用して、より正確なデータ可視化を作成する方法を説明します。 +_language: ja +--- + +# 文字列計算フィールド + +文字列計算フィールド (`sortinterval` 以外) はテキストを編集でき、さまざまな結果を取得することができます。 + +:::note +**文字列の間に引用符 (" ") を常に含めてください。** +::: + +## 文字列関数 + +| **関数名** | **構文とサンプル** | +|-------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| **concatenate**: `concatenate` は、複数の文字列 `text` を結合して句を構成できます。スペースは自動的には含まれません。必要な場合は、テキスト引数に含む必要があります。 | **構文**: `concatenate()`
**サンプル**: `concatenate("Getting started", " with", " the", " Reveal", " application")` | +| **find**: `find` は、引数で指定した `text` の場合、2 つ目の文字列内の `text` の 1 つ目 の文字列の開始位置 (`number`) を返します。 | **構文**: `find({find text},{within text},{start number})`
**サンプル**: `find("with","Getting Started with Reveal visualizations",3)` | +| **len**: `len` は入力した `text` 文字列のすべて大文字を小文字へ変換します。 | **構文**: `len({text})`
**サンプル**: `len("Getting Started with Reveal")` | +| **lower**: `lower` は指定した `text` 文字列のすべて大文字を小文字へ変換します。 | **構文**: `lower({text})`
**サンプル**: `lower("Getting Started with Reveal")` | +| **mid**: `mid` は引数で指定したことに基づいて指定した文字列 `text` の部分文字列 `length` を返します。 | **構文**: `mid({text},{start},{length})`
**サンプル**: `mid("Getting Started with Reveal",9,12)` | +| **replace**: `replace` は、指定した文字列 `text` を、引数で指定した別の `text` に置き換えます。 | **構文**: `replace({text},{old text},{new text})`
**サンプル**: `replace("Getting Started with Reveal","Getting Started","Creating Visualizations with")` | +| **sortinterval**: `sortinterval` は、関数で設定された間隔で値を返します。`NN [from,to]` の書式として文字列が返されます。| **構文**: `sortinterval()`
**サンプル 1**: `sortinterval(33,140)`**サンプル 2**: `sortinterval([Wage],150000)`**サンプル 3**: `sortinterval([Wage],50000,80000,110000,140000)` | +| **trim**: `trim` は、入力した `text` と同じ文字列を返しますが、先行または後続の空白を削除し、単語間の空白のみ保持します。 | **構文**: `trim({text})`
**サンプル**: `trim(" Getting Started with Reveal ")` | +| **upper**: `upper` は指定した `text` 文字列のすべて大文字を小文字へ変換します。 | **構文**: `upper({text})`
**サンプル**: `upper("Caution: Hot. Do not touch")` | + + + +## Find + +find 関数は、引数で指定した 1 つ目と 2 つ目の文字列の開始位置を返します。 + +### 構文 + +引数を 3 つ設定する必要があります。 + + - `find text`: 検索するテキスト。 + + - `within text`: 検索を実行するテキスト。 + + - `start number`: 検索を開始する文字。 + +### サンプル + +以下は上記の表のサンプルです。 + +| 関数名 | Find Text | Within Text | Start Number | 出力 | +| :-----------: | :-------: | :--------------------------------------------: | :----------: | :----: | +| find(…​) | `"with"` | `"Getting Started with Reveal visualizations"` | `3` | 15 | + +検索は `Getting` の 最初の `t` で開始します。結果の 15 は `with` の `w` が位置する文字番号です。 + +| C. 1 | C. 2 | C. 3 | C. 4 | C. 5 | C. 6 | C. 7 | C. 8 | C. 9 | C. 10 | C. 11 | C. 12 | C. 13 | C. 14 | C. 15 | +| :---: | :--: | :--: | :--: | :--: | :--: | :--: | :--: | :--: | :---: | :---: | :---: | :---: | :---: | :---: | +| **t** | t | i | n | g | | S | t | a | r | t | e | d | | **w** | + +`with` が句で複数回繰り返される場合、計算フィールドは**単語の最初の発生**の文字を返します。 + + +## Mid + +mid 計算フィールドは関数の構成に基づいて指定した文字列の一部を返します。 + +### 構文 + +3 つのパラメーターを構成します。 + + - `text`: 文字列を選択するテキスト。 + + - `start`: 新しい部分文字列を開始する文字。 + + - `length`: 部分文字列の長さ。 + +### サンプル + +以下は上記の表のサンプルです。 + +| 関数名 | Text | Start | Length | 出力 | +| :-----------: | :-----------------------------: | :---: | :----: | :----------: | +| mid(…​) | `"Getting Started with Reveal"` | `9` | `12` | Started with | + +テキスト文字列の開始が文字 9 で始まり、12 文字であるため、出力は `Started with` です。 + +| C. 9 | C. 10 | C. 11 | C. 12 | C. 13 | C. 14 | C. 15 | C. 16 | C. 17 | C. 18 | C. 19 | C. 20 | +| :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | +| **S** | **t** | **a** | **r** | **t** | **e** | **d** | | **w** | **i** | **t** | **h** | + + +## Replace + +Replace 関数は文字列を関数で指定した他の文字列と置き換えます。 + +### 構文 + +3 つの引数で構文されます。 + + - `text`: 元の完全な文字列テキスト。 + + - `old text`: 置き換えられるテキスト。 + + - `new text`: 古いテキストを置き換えるテキスト。 + +### サンプル + +以下はサンプルです。 + + + + + + + + + + + + + + + + +
関数名TextOld TextNew Text出力
replace(…​)"Using Reveal for iOS can be fast and easy. First, open the AppStore and look for Reveal. Then, install it. You're ready!""Reveal""our BI tool"Using our BI tool for iOS can be fast and easy. First, open the AppStore and look for our BI tool. Then, install it. You're ready!
+ + +古いテキストはいずれの場合も置き換えられます。**変更する前に用語が表示されるたびに変更されることを考慮してください**。 + + +## Sortinterval + +sortinterval 関数は、関数で設定された間隔で値を返します。 + +### 構文 + +返却文字列の書式は `NN [from, to]` です。 + +### サンプル + +以下は上記の表のサンプルです。 + +| 関数名 | 数値 | 間隔 | +| :--------------: | :------: | :------: | +| sortinterval(…​) | `[Wage]` | `150000` | + +この場合、`Wage` を 1 つの値に対して比較し、2 つのカテゴリ (150K より大きい、150K 未満) に分類します。 +150K. + +以下の例は、`Wage` が 4 つの異なる値に対して比較し、5 つのカテゴリ (50000 未満、50000 から 80000、80000 から 110000、110000 から 140000、140000 より大きい) に分類します。 + +| 関数名 | 数値 | 間隔 1 | 間隔 2 | 間隔 3 | 間隔 4 | +| :--------------: | :------: | :--------: | :--------: | :--------: | :--------: | +| sortinterval(…​) | `[Wage]` | `50000` | `80000` | `110000` | `140000` | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/conditional-formatting.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/conditional-formatting.md new file mode 100644 index 00000000..24860c2a --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/conditional-formatting.md @@ -0,0 +1,47 @@ +--- +title: 条件付き書式を使用する方法 +_description: Reveal で条件付き書式を使用して、データをより正確に可視化する方法を説明します。 +_language: ja +--- + +# 条件付き書式 + +条件付き書式を使用して数値列の値に応じて、セル (または[テキス トビュー](../chart-types/text-view.md)の行) に異なる書式を設定できます。たとえば、グリッドの下位 50% 範囲内の値は、非常に低い値を通知する赤色のアドナーで色を付けることができます。 + +![Pivot table view conditional formatting in the Visualization editor](images/conditional-formatting-pivot-table-view.png) + +条件付き書式の設定では、データの範囲ごとに、3 つまでの範囲に (一般的には、中央上部、下部範囲スタイル設定に使用) スタイル規則を設定することができます。低い値が適しているかどうかは情報の性質によります。状況に応じて最も理にかなった方法でスタイルを設定できる柔軟性があります。 + +![Text view conditional formatting showing Marketing Metrics Visualization](images/text-view-conditional-formatting-example.png) + +## 条件付き書式設定の有効化 + +数値列で条件付き書式を有効にするには、**[フィールドの設定]** ダイアログボックスを表示するためにデータ エディターのフィールドを選択します。条件付き書式は、設定の最後のオプションであり、デフォルトでは無効になっています。 + +![Conditional formatting configuration in Field settings menu](images/conditional-formatting-configuration-fields-settings-dialog.png) + + - **制限**: これらの値は自動的に指定された値の列のデータセット内の最高値/最低値として設定されますが、一定の値を使用して手動でオーバーライドすることができます。 + + - **データ範囲**: データのスタイル設定に使用する 3 つの範囲。すべての範囲にはドロップダウンで定義済みのインジケーターと色のいずれかを選択できます。 + + - **値比較タイプ**: 範囲をパーセンテージまたは数値にします。 + + - **値は ≥ の場合**: 入力した数値より大きい値の書式。 + + - **値は ≥ の場合および \<**: 最初と 3 番目の範囲に入力する値に依存する固定範囲です。 + + - **値は \< の場合**: 入力した数値より小さい値の書式設定。 + +## サポートされている表示形式 + +条件付き書式は、以下の表示形式に適用できます。 + + - [グリッド チャート](../chart-types/grid-chart.md) + + - [ピボット チャート](../chart-types/pivot-table.md) + + - [テキスト ビュー](../chart-types/text-view.md) + +:::note +[KPI](../chart-types/kpi-gauge.md)、[リニア](../chart-types/gauge-charts.md#リニア-ゲージ)、[円形](../chart-types/gauge-charts.md#円形ゲージ)、[テキスト](../chart-types/gauge-charts.md#テキスト-ゲージ)、および[ブレット グラフ](../chart-types/gauge-charts.md#ブレット-グラフ) ゲージは、[**表示形式バンドの範囲の構成**](../chart-types/gauge-charts.md#バンドの構成)で条件付き書式をサポートします。 +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/field-filters-rules.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/field-filters-rules.md new file mode 100644 index 00000000..6f007c0d --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/field-filters-rules.md @@ -0,0 +1,106 @@ +--- +title: フィールド フィルターとルールをデータセットに適用する方法 +_description: 表示形式の作成中に Reveal のデータセットにフィルターまたはルールを適用する方法を説明します。 +_language: ja +--- + +# フィールド フィルターとルール + +データセットのフィールドにもフィルターとルールを適用できます。そのためには、データ エディターの下部にある**データ フィルター** プレースホルダーにフィールドを追加する必要があります。次に、ドロップダウン メニューからフィールドを選択して、**データ フィルター** ウィンドウにアクセスします。 + +![Adding data filter fields list](images/data-filter-visualization-editor.png) + +## 空値をフィルター + +Reveal は特定の列で空値のフィルター構成の設定を有効にすることによって、特定の列に null、または空の値を持つデータ セット内の行をフィルタリングする機能を提供します。 + +![Filter Empty Values in the list of filter types](images/data-filter-filter-empty-values-option.png) + +## 値の選択 + +このタイプのフィルターは、特定のフィールドに表示する値セットの定義をサポートします。これを有効にするには、フィールドを **[データ フィルター]** プレースホルダーにドラッグアンドドロップします。 + +![Select Values option in the list of filter types](images/data-filter-select-values.png) + +**[フィールド設定]** ダイアログに、**[値の選択]** オプションが表示されます。列に使用可能な値のリストを表示し、データセット内に残したい項目のみを選択できます。フィルターによって除外された値を持つ行は表示形式に表示されません。 + +## ルールでフィルタリング + +**[ルールでフィルタリング]** オプションを使用すると、より複雑なルールを定義できます。使用可能なルール オプションは、フィールド タイプによって異なります。 + + +### 日付フィールドのルール + +日付フィールドには、時間ベースのシナリオ、日付範囲の変更、表示形式に表示される情報のフィルタリングをサポートするように設計されたルールが含まれています。 + +- **カスタム日付範囲** + +- **先週、先月、または去年** + +- **過去 1 か月** + +- **来月、来四半期、または来年** + +- **先月、先四半期、または去年** + +- **日付までの四半期** + +- **今月、今四半期、または今年** + +- **今日** + +- **過去 1 年間** + +- **昨日** + +デフォルトでは、ルールによるフィルターが数値フィールドで有効になっている場合、**[なし]** に設定されます。 + +### 数値フィールドのルール + +整数、小数、通貨などの数値型のフィールドは、次のルール タイプをサポートしています。 + +- **平均より上** + +- **以上** + +- **値より大きい** + +- **平均より下** + +- **以下** + +- **値より小さい** + +- **下位の項目** + +- **下位の割合** + +- **上位の項目** + +- **上位の割合** + +デフォルトでは、ルールによるフィルターが数値フィールドで有効になっている場合、**[なし]** に設定されます。 + +### 文字列フィールドのルール + +テキスト列は、次のルール タイプをサポートしています。 + +- **含む** + +- **で終わる** + +- **等しい** + +- **含まない** + +- **等しくない** + +- **～で始まる** + +同様に、これらのルールは 1 つのパラメーターである、ルールが評価で使用する**開始値**または**等しい値**を取得し、同じ位置にあるテキストボックスに入力されます。 + +## 値のフィールドのフィルタリング + +[集計](./calculated/aggregation.md)で**値**をフィルタリングできます。次に、この値は **[データ フィルター]** プレースホルダーのフィールドのリストに同じ集計で表示されます。 + +![Data Filters Filtering in the Data Editor](images/data-filters-values-list.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/field-settings.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/field-settings.md new file mode 100644 index 00000000..c94243c9 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/field-settings.md @@ -0,0 +1,78 @@ +--- +title: Reveal でフィールド設定を使用する方法 +_description: データの並べ替え、フィルタリング、集計にフィールド設定を適用する方法を説明します。 +_language: ja +--- + +# フィールド設定 + +このセクションでは、並べ替え、フィルター処理、データの集計などデータセットへの変換を適用するためのさまざまなオプションについて説明します。 + +![data-filters-currency](images/data-filters-currency-sample.png) + +データにフォーマットまたはフィルターを適用するには、対応するプレースホルダー (**カテゴリ**、**列**、**ラベル**、**行**、および**値**) で変更する特定のフィールドを選択する必要があります。フィールドには 3 つのタイプがあり、それぞれに独自のフォーマットおよびフィルター オプションがあります: + +- [日付フィールド](#日付フィールド) +- [数値フィールド](#数値フィールド) +- [文字列フィールド](#文字列フィールド) + +:::note +データ エディターの**値**プレースホルダーにドロップされたすべてのフィールドは、数値としてフォーマットされます。 +::: + +## 日付フィールド + +![Date-Field-Formatting](images/formatting-date-field.png) + + - **ラベル名の変更**: 表示のみを目的としてフィールド名を変更します。フィールドは常に計算フィールド式で元の名前によって参照されます。名前を変更すると、ラベルを完全に消去し元の値に戻ります。 + + - **年度の最初の月**: 12 か月の期間が暦年と同じでない場合は、会計年度を使用して、期間の最初の月を選択できます。 + + - **並べ替え**: 日付を昇順または降順で並べ替えます。 + + - **日付書式**: 日付と時刻書式の定義済みリストから選択して、日付/時刻の値を表示します。 + +### 日付フィールド階層 + +日付フィールドの集計は、[フィールド] セクションに階層リストとして表示されます。日付フィールドの精度に応じて、[年]、[四半期]、[月]、[日]、および [分] を見つけることができます。 + +ピボット エディターに日付フィールドをドラッグアンドドロップすると、すべての階層が自動的に表示されます (以下を参照)。 + +![Showing the date field hierarchy functionality in Reveal](images/date-fields-hierarchy.png) + +さらに、特定の階層レベルをドラッグすると、以下に示すように、そのレベルのデータのみが表示されます。 + +![Dragging part of the hierarchy of a date field in Reveal](images/date-field-hierarchy-level-example.png) + +## 数値フィールド + +![Numeric-Field-Formatting\_All.png](images/numeric-field-settings.png) + + - **ラベル名の変更**: 表示のみを目的としてフィールド名を変更します。フィールドは常に計算フィールド式で元の名前によって参照されます。名前を変更すると、ラベルを完全に消去し元の値に戻ります。 + + - **集計**: 数値を Reveal で処理する方法 (合計、カウント、平均) を構成します。 + + - **並べ替え**: 数値を昇順または降順で並べ替えます。 + + - **表示状態**: このフィールドのデータを現在の表示形式で使用するかどうかを選択します。 + + - **タイプ**: 数値の形式をパーセンテージ、通貨、または単純な数値のいずれにするかを定義します。**[通貨]** を選択すると、通貨の種類 (ドル、ユーロ、ポンド、円) を選択するオプションが表示されます。 + + - **分数桁**: 表示する小数点以下の桁数を選択します。 + + - **負の数**: 括弧内に負の数を囲む、またはマイナス (-) を頭に付けるかどうかを選択します。 + + - **大きな数値の書式設定**: 中央のペインの表示形式プレビューに 100 万 を M、千を K で表示します。 + + - **桁区切り**: 桁区切り記号を表示するかどうかを選択します。 + + - [**条件付き書式**](conditional-formatting.md): これを有効にすると、値に基づいて各セルに異なるフォーマットを提供できます。たとえば、フィールドの下位 50% 範囲内の値は、問題を通知する赤色のアドナーで色を付けることができます。3 つまでの範囲に (一般的には、上部、中央、そして下部の範囲に使用) スタイル規則を設定することができますが制限、比較のタイプ、色、およびインジケーター シンボルをカスタマイズできます。 + + +## 文字列フィールド + +![String-Field-Formatting](images/string-field-formatting-field-settings-dialog.png) + + - **ラベル名の変更**: 表示のみを目的としてフィールド名を変更します。フィールドは常に計算フィールド式で元の名前によって参照されます。名前を変更すると、ラベルを完全に消去し元の値に戻ります。 + + - **並べ替え**: 日付を昇順または降順で並べ替えます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/ad-hoc-hierarchies-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/ad-hoc-hierarchies-example.png new file mode 100644 index 00000000..29bd1977 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/ad-hoc-hierarchies-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/ad-hoc-hierarchy-pivot-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/ad-hoc-hierarchy-pivot-chart.png new file mode 100644 index 00000000..ae6aeb3a Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/ad-hoc-hierarchy-pivot-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/conditional-formatting-configuration-fields-settings-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/conditional-formatting-configuration-fields-settings-dialog.png new file mode 100644 index 00000000..8f83fe48 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/conditional-formatting-configuration-fields-settings-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/conditional-formatting-pivot-table-view.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/conditional-formatting-pivot-table-view.png new file mode 100644 index 00000000..a9084c83 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/conditional-formatting-pivot-table-view.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/data-filter-filter-empty-values-option.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/data-filter-filter-empty-values-option.png new file mode 100644 index 00000000..3dc96ee1 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/data-filter-filter-empty-values-option.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/data-filter-select-values.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/data-filter-select-values.png new file mode 100644 index 00000000..f262f482 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/data-filter-select-values.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/data-filter-visualization-editor.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/data-filter-visualization-editor.png new file mode 100644 index 00000000..882a7270 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/data-filter-visualization-editor.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/data-filters-currency-sample.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/data-filters-currency-sample.png new file mode 100644 index 00000000..f3dc5120 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/data-filters-currency-sample.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/data-filters-values-list.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/data-filters-values-list.png new file mode 100644 index 00000000..846b5e6c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/data-filters-values-list.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/date-field-hierarchy-level-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/date-field-hierarchy-level-example.png new file mode 100644 index 00000000..d457426b Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/date-field-hierarchy-level-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/date-fields-hierarchy.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/date-fields-hierarchy.png new file mode 100644 index 00000000..cf70476d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/date-fields-hierarchy.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/field-settings-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/field-settings-dialog.png new file mode 100644 index 00000000..53ef1a59 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/field-settings-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/field-settings-sort-by.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/field-settings-sort-by.png new file mode 100644 index 00000000..eaf0a8b0 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/field-settings-sort-by.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/financial-metrics-sample.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/financial-metrics-sample.png new file mode 100644 index 00000000..72802046 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/financial-metrics-sample.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/formatting-date-field.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/formatting-date-field.png new file mode 100644 index 00000000..15bfb4c3 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/formatting-date-field.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/numeric-field-settings.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/numeric-field-settings.png new file mode 100644 index 00000000..cd397cbb Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/numeric-field-settings.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/sort-by-field-sales-information-sample.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/sort-by-field-sales-information-sample.png new file mode 100644 index 00000000..f713c164 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/sort-by-field-sales-information-sample.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/sorting-by-priority-sample.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/sorting-by-priority-sample.png new file mode 100644 index 00000000..033090f5 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/sorting-by-priority-sample.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/string-field-formatting-field-settings-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/string-field-formatting-field-settings-dialog.png new file mode 100644 index 00000000..53ef1a59 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/string-field-formatting-field-settings-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/support-cases-sample.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/support-cases-sample.png new file mode 100644 index 00000000..84b5e169 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/support-cases-sample.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/text-view-conditional-formatting-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/text-view-conditional-formatting-example.png new file mode 100644 index 00000000..e98f9c2b Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/text-view-conditional-formatting-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/visualization-example-fields.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/visualization-example-fields.png new file mode 100644 index 00000000..577ce8c1 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/visualization-example-fields.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/weekly-cases-priority.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/weekly-cases-priority.png new file mode 100644 index 00000000..4067ca48 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/images/weekly-cases-priority.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/overview.md new file mode 100644 index 00000000..56d981dc --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/overview.md @@ -0,0 +1,25 @@ +--- +title: Reveal でフィールドを使用する方法 +_description: データセットのフィールドに変換を簡単に適用するオプションについて説明します。 +_language: ja +--- + +# フィールド + +このセクションでは、データセットのフィールドに変換を適用するためのさまざまなオプションについて説明します。フィルターを適用することにより、フィールドの情報をビジネス分析用に最適化できます。必要のないノイズを削除し、最も重要なアスペクトを強調表示して、さまざまな方法で情報を要約します。 + +![Visualization sample that uses different fields.png](images/visualization-example-fields.png) + +## トピックの概要 + +いくつかのフィールド設定とフィルタリング オプションがあります。 + + - ラベルの名前変更、集計、並べ替え、書式、[条件付き書式](conditional-formatting.md)を含む[日付](field-settings.md#日付フィールド)、[数値](field-settings.md#数値フィールド)および[文字列](field-settings.md#文字列フィールド)フィールドの設定。 + + - [空値](field-filters-rules.md#空値をフィルター)のフィルター。 + + - [特定の値を選択する](field-filters-rules.md#値の選択)ためのフィルター。 + + - [ルール](field-filters-rules.md#ルールでフィルタリング)でフィルター。 + +データセットがダッシュボード キャンバスに追加されると自動的に表示される[表示形式エディター](../visualization-editor.md)を介して、フィールド設定とルールにアクセスできます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/sort-by-field.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/sort-by-field.md new file mode 100644 index 00000000..e7310ccb --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/fields/sort-by-field.md @@ -0,0 +1,55 @@ +--- +title: Reveal のフィールドで並べ替える方法 +_description: 表示形式のデータの表示を変更して外観を変更する方法を説明します。 +_language: ja +--- + +# 並べ替えフィールド + +Reveal では、データを昇順または降順に並べ替えることで、表示形式のデータの表示方法を変更できます。さらに、元のデータ ソースで選択したフィールドで並べ替えることで、表示形式の外観をさらに制御することもできます。 + +![Sorting options in the field settings dialog](images/field-settings-dialog.png) +## 並べ替えフィールドを有効にする + +**[並べ替えフィールド]** オプションはフィールド設定の一部ですが、デフォルトでは非表示になっています。有効にする方法: + +1. **[ラベル]** プレースホルダーからフィールドを選択します。 +2. **[フィールド設定]**で、**[並べ替え]** に **[昇順]** または **[降順]** を選択します。 +3. **[並べ替え条件]** は、**[並べ替え]** 設定の下に表示されます。右側のドロップダウンからフィールドを選択できます (上記を参照)。 + +より実用的な情報については、この機能を示す次の例をご覧ください。 + +- [並べ替えフィールドを有効にする](#並べ替えフィールドを有効にする ) +- [サポート ケースを優先順位で順序](#サポート-ケースを優先順位で順序) +- [文字列日付を時系列で並べ替え](#文字列日付を時系列で順序) + + +## サポート ケースを優先順位で順序 + +フィールドをアルファベット順に並べ替えるのではなく、ビジネス ロジックを使用して並べ替えたいシナリオがあります。たとえば、以下は、新しいサポート ケースを昇順で表示する表示形式です。 + +![Visualization displaying data in an ascending order](images/support-cases-sample.png) + +*Priority* フィールドはテキスト フィールドであるため、デフォルトでは A-Z の順序になっています。ただし、ビジネス ロジックを使用する場合、*Priority*値は次のように並べ替える必要があります: *Low* - *Normal* - *High*。これを実現するには、データセットに優先度状態の数値表現を示す *Priority Level* 列が必要です (以下を参照)。 + +![Visualization showing weekly cases ordered by Priority level](images/weekly-cases-priority.png) + +[並べ替え条件] フィールド オプションを使用して、*Priority Level* フィールドをデータ エディタに実際にドラッグアンドドロップせずに、チャート内の情報を優先度レベル別に整理します。 + +![Sorting the information by priority in the sort by field option](images/sorting-by-priority-sample.png) + +## 文字列日付を時系列で順序 + +次の表示形式を見てみましょう。ここでは、[積層型柱状チャート](../tutorials-stacked-charts.md#積層型チャートの作成)で企業の現金と売掛金の増加をプロットしています。 + +![Sales Info visualization while using stacked column chart](images/sort-by-field-sales-information-sample.png) + +値は、**Month Name** (文字列フィールド) で並べ替えされています。ただし、月はデフォルトでアルファベット順に並べ替えされているため、結果の表示形式は分析には適しません。 + +ただし、書式を変更し、**Month of Year** の順に情報を並べ替えることで、**Month Name** の表示方法を変更できます。Y 軸 (**Month of Year**) に 1-12 の数値を表示する必要はないかもしれませんが、それでもその順序を優先する必要があります。データ エディターのラベル プレースホルダーで **Month Name** フィールドを選択し、目的の並べ替えを選択します。 + +![Sort by option with a list of different fields in the field settings dialog](images/field-settings-sort-by.png) + +この後、**[フィールドの更新]** を選択します。情報は時系列順に並べ替えられます。 + +![Visualization of data sorted by chronological order](images/financial-metrics-sample.png) \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/filters-connecting.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/filters-connecting.md new file mode 100644 index 00000000..41e29ea0 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/filters-connecting.md @@ -0,0 +1,53 @@ +--- +title: ダッシュボード フィルターを表示形式に接続する方法 +_description: 表示形式のデータを Reveal のダッシュボード フィルターに追加する方法を説明します。 +_language: ja +--- + +# ダッシュボード フィルターを表示形式に接続 + +可視化したデータをダッシュボード フィルターにバインドする 2 つの方法があります。 + +![Dashboard filters dialog](images/dashboard-filters-dialog.png) + + - ダッシュボード フィルター構成の一部として接続 (上記参照)これにより、ダッシュボード フィルターとダッシュボードのすべての表示形式間のバインド構成が可能です。 + + - **表示形式エディター**を使用して (以下を参照)、ダッシュボード フィルターが作成された後でも、個々の表示形式をバインドできます。 + +![dashboard filters in the visualization editor](images/visualization-editor-dashboard-filter.png) + +いずれの場合もダッシュボード フィルター データセットのフィールドへリンクするルールを追加してバインドが定義されます。 ([**フィールドのバインド**](#フィールドのバインド))表示形式エディターまたは [ダッシュボード フィルター] メニューで **[切断]** を選択すると、表示形式のバインドをいつでも削除できます。 + +![Option to disconnect dashboard filters from a visualization](images/disconnect-option-dashboard-filter.png) + +## フィールドのバインド + +フィールドのバインでは、ダッシュボード フィルターのデータセット スキーマ、および表示形式のスキーマ間の結合関係を構成することができます。使用するダッシュボード フィルターを選択して接続します。 + +![Field binding menu](images/editor-view-dashboard-filter.png) + +上記のダイアログで以下を構成する必要があります。 + + - **表示形式**: ダッシュボード フィルターのデータセットと結合するためのキーとして使用される表示形式データセット内の列を表します。たとえば、*Office*、*EmployeeID*、*ProductID* など + + - **演算子**: 結合演算子は、以下のいずれかを使用します。 + + - **等しい**: フィールド値とダッシュボード フィルター選択の両方が等しい必要があります。 + + - **含む**: 文字列フィールドで使用されることを意図し、フィールドの値にダッシュボード フィルター選択が含まれている場合に有効になる一致を返します。たとえば、表示形式 = `FRANCE` **含む** フィルター = `FRA`。 + + - **範囲**: 日付範囲ダッシュボード フィルターでのみ使用します。 + + - **フィルター**: 結合されるダッシュボード フィルターの特定のダッシュボード フィルター。 + +## パラメーター バインド + +パラメーター (REST、OData、および MS SQL Server ストアド プロシージャー) を使用するデータ ソースの場合、ダッシュボード フィルターをパラメーターに接続する必要があります。そのため、可視化のフィルター データを変更すると、接続されたパラメーターで選択した値で更新されます。 + +ダッシュボード フィルターをパラメーターに接続するには、フィールド バインドの手順に従います。データ ソース パラメーターは、[フィルター接続の編集] ダイアログの表示形式 ドロップダウン リストの下部にあります。 + +![Parameters binding list](images/data-source-parameters-dashboard-filter.png) + +:::note +**日付フィルター**: ダッシュボード フィルターのみをパラメーターにバインドできます。パラメーターへの日付フィルターのバインドはサポートされていません。 +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/filters-dashboard-properties.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/filters-dashboard-properties.md new file mode 100644 index 00000000..ceb6e480 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/filters-dashboard-properties.md @@ -0,0 +1,98 @@ +--- +title: ダッシュボード フィルターのプロパティを使用する方法 +_description: ダッシュボード フィルター プロパティをすばやく適用して使用し、表示形式の効果を最大限に高める方法について説明します。 +_language: ja +--- + +# ダッシュボード フィルターとそのプロパティ + +## ダッシュボード フィルター プロパティにアクセスする + +新しいダッシュボード フィルターを追加するには: + +1. ダッシュボード エディターに移動し、[フィルターの追加] ⇒ **[ダッシュボード フィルターの追加]** を選択します。 + +2. ダッシュボード フィルター メニューが開きます。デフォルトで、選択されたデータ ソースは、はじめての表示形式で使用されるデータ ソースになります。変更するには、データ ソース名の横にあるオーバーフロー ボタンを選択します。 + + ![Selecting Dashboard Filter data source menu](images/dashboard-filter-data-source-menu.png) + +3. ダッシュボード フィルターとして使用するデータセットを選択し、**[データの選択]** をクリック/タップします。 + +## フィルター設定の概要 + +フィルターの以下の設定を変更できます: + +![Dashboard Filter settings menu](images/dashboard-filter-dialog.png) + +- **タイトル:** ダッシュボードのタイトルのすぐ下に表示される、ダッシュボード ィルターのタイトル。デフォルトで、これはフィルターとして使用されるフィールド名です。 + +- [**表示されるフィールド/要素:**](#表示フィールド) ダッシュボード フィルターとして使用されるデータセット内のフィールド。 + +- **選択:** この設定では、以下を構成できます。[複数選択](#複数選択) (一度に複数の値を選択できます) および/または[必須選択](#必須選択) (少なくとも 1 つの値を常に選択する必要があります)。 + +- [**データ フィルター:**](#データ-フィルター) この設定により、ダッシュボード フィルターに使用されるデータ ソースにフィールド フィルターとルールを適用できます。 + +- [**接続された表示形式:**](filters-connecting.md) ダッシュボードを表示形式に接続するかどうか。 + +## 表示フィールド + +:::note +**Microsoft Analysis Services** および **Google アナリティクス**のデータを使用するダッシュボード フィルターの場合、この設定の名前は **[表示する要素]** です。 +::: + +**表示するフィールド/要素**設定は、ダッシュボード フィルターの値を表示するために使用されるデータセット フィールドを指定します。リスト値は、元のデータセットで複数回表示された場合も繰り返されません。 + +ダッシュボード フィルター名の隣りのオーバーフロー メニューで [編集] ボタンをクリックして、編集モードで表示列を変更できます。 + +![Accessing dashboard filter edit mode](images/edit-mode-filter.png) + +## 複数選択 + +Reveal は、複数のダッシュボード フィルター値の同時選択をサポートしています。これにより、コレクション内で要素を並べて比較できます。たとえば、[HR ダッシュボード] で複数の選択を有効にすることで、さまざまなオフィスの雇用や欠勤を比較することができます。 + +![Filters multiple selections applied to a dashboard](images/multiple-selection-dashboard-filters.png) + +**[複数選択] を有効する**には、ダッシュボードを編集モードに替える必要があります。⇒ ダッシュボード フィルターのオーバーフロー ニューから **[編集]** を選択 ⇒ **[選択]** ⇒ **[複数選択]** チェックボックスをオンにします。 + +![Enabling dashboard filters multiple selections](images/multiple-selection-option-dashboard-filter-dialog.png) + +## 必須選択 + +ダッシュボード フィルターで選択オプションを必須または無効にできます。デフォルトでは、選択は不要です。選択オプションで、ユーザーがすべてのダッシュボード フィルター値を解除することができ、実行したクエリからフィルターを削除します。クエリはデータ ソースのすべてのデータを取得し、ダッシュボード フィルター行に「選択なし」と表示されます。 + +**[必須選択] を有効する**には、ダッシュボードを編集モードに替える必要があります。⇒ ダッシュボード フィルターのオーバーフロー ニューから **[編集]** を選択 ⇒ **[選択]** ⇒ **[必須選択]** チェックボックスをオンにします。 + +![Enabling dashboard filters required selection](images/required-selection-option-filters.png) + +## データ フィルター + +ダッシュボード フィルターに表示されるデータセットのフィールドにフィルターを適用することもできます。これにより、特定のフィールドの null または空の値をフィルター アウトできます(空の値のフィルター)。特定の値を選択するか、フィールド タイプに応じてオプションを変更するためにフィールドにルールを追加することもできます。詳細は、**フィールド フィルターとルール**をご覧ください。 + +たとえば、**Fullname** フィールドを使用して **HR ダッシュボード**のデータをフィルタリングする場合、**ダッシュボード フィルター**は会社のすべてのオフィスの従業員リストを表示します。 + +![Full name dashboard filter applied to HR Dashboard](images/data-filters-dashboard-filters-hr-dashboard.png) + +フィルター リストに特定のオフィス (*London, UK* など) で働く従業員のみを含める場合は、以下に示すようにデータ フィルターを適用します。 + +### ダッシュボード フィルターにデータ フィルターを適用 + +ダッシュボード フィルターとして使用されるデータ ソースにフィールド フィルターとルールを適用し、ダッシュボード フィルターに (上記の例のように) *London, UK* オフィスの従業員のみを表示するには、次の手順に従います。 + +1. ダッシュボード フィルター設定の**データ フィルター**に移動します。 + +2. **表示フィールド**プロパティで **Employee name** を選択します。 + +3. [フィールドを選択] をクリックまたはタップして、リストから [オフィス] を選択します。 + + ![Selecting a field for a data filter in the dashboard filter settings menu](images/dashboard-filters-select-data-filter-field.png) + +4. 次のダイアログで、適用するフィルター タイプを選択します (この例では、**[値の選択]** を選択します)。 + + ![Dashboard Filters Filter type option](images/filter-types.png) + +5. リストから *London, UK* を選択し、[フィルターの作成] ボタンをクリックまたはタップします。 + +## 次の手順 + +ダッシュボード フィルターを作成したので、フィルターを適用する**表示形式に接続する**必要があります。詳細は、[ダッシュボード フィルターを表示形式に接続](filters-connecting.md)をご覧ください。 + diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/filters-dashboard.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/filters-dashboard.md new file mode 100644 index 00000000..8e887004 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/filters-dashboard.md @@ -0,0 +1,33 @@ +--- +title: ダッシュボード フィルターを追加して使用する方法 +_description: ダッシュボード編集モードを使用して Reveal に新しいダッシュボード フィルターを追加する方法について説明します。 +_language: ja +--- + +# ダッシュボード フィルター + +ダッシュボード フィルター データセットは、**ダッシュボード編集**モードを開始することによって定義されます。新しいデータセットを追加するには、**[フィルターの追加]** のボタン を選択します。 + +![List of different filter options for dashboards](images/filter-options-dashboard.png) + +これにより、適用される可能性のあるダッシュボード フィルターのリストが表示されます。以下から選択できます: + + - **ダッシュボード フィルターの追加**このオプションを使用すると、データ ソースから情報を選択できます。その後、ダッシュボードの各表示形式にフィルターをバインドできます。 + + - **日付フィルターの追加**このオプションは、固定範囲の選択や指定した日付範囲のみ表示するようカスタマイズできます。 + +ダッシュボード フィルター リストからデータセットを削除するには、ダッシュボード フィルターの横にあるオーバーフロー ボタンを選択し、**[削除]** を選択します。 + +![Removing a dashboard filter with the delete option](images/delete-filter-option.png) + +## ダッシュボード フィルターと表示形式エディター + +ダッシュボード エディターに 1 つ以上のダッシュボード フィルターまたは日付フィルターが定義されている場合、フィルター名の下部にある **[接続]** をクリックするとダッシュボード フィルターまたは日付フィルターのデータを表示形式にバインドします。 + +![Connecting to a dashboard filter in the visualization editor](images/dashboard-filter-connection-option-visualization-editor.png) + +日付フィルター ダイアログまたはダッシュボード フィルター ダイアログでデータを接続することもできます。 + +![A dashboard filter dialog](images/dashboard-filter-dialog-connect-option.png) + +バインド機能の詳細については、[「ダッシュボード フィルターを表示形式に接続」](filters-connecting.md)トピックを参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/filters-date-range.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/filters-date-range.md new file mode 100644 index 00000000..1c649439 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/filters-date-range.md @@ -0,0 +1,15 @@ +# 日付範囲グローバル フィルター + +Reveal は、データをダッシュボード フィルターにバインドする際のさまざまな日付範囲の設定をサポートしています。これにより、時間ベースの分析シナリオ、単一日付範囲の変更、ダッシュボード全体のフィルタリングが可能になります。ダッシュボード フィルター セクションで日付範囲を有効にするには、**[フィルターの追加]** メニューで **[日付フィルターを追加]** を選択します。 + +![Date filter option in the filter dropdown menu for a visualization](images/date-filter-option.png) + +日付のダッシュボード フィルターを有効にすると、[表示形式バインディング式](filters-connecting.md)で使用できるようになります。 + +![Filter Date Range dialog with different options](images/date-filter-dialog.png) + +## カスタム日付範囲の使用 + +Reveal では、さまざまな事前設定された日付範囲 (特に、過去 30 日、7 日、または 365 日を含む) を提供していますが、特定の日付範囲内のデータを表示するように範囲を定義することもできます。**[日付フィルター]** ドロップダウンで **[カスタム日付範囲]** を選択すると、パーソナライズされた日、月、および時代のオプションを含むカレンダーが表示されます。 + +![Custom Date Range calendar displayed](images/custom-date-range-date-filter.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/filters-overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/filters-overview.md new file mode 100644 index 00000000..8e87dc72 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/filters-overview.md @@ -0,0 +1,33 @@ +--- +title: Reveal のフィルター – 必要な情報 +_description: ダッシュボード フィルターのすべてを学び、データセットを追加して、各表示形式を Reveal で一意にします。 +_language: ja +--- + +# フィルター + +ダッシュボード フィルターを使用すると、ダッシュボードの全ての表示形式のコンテンツを一度にフィルター適用できます。データセットをダッシュボード フィルター コレクションに追加すると、すべてのダッシュボード表示形式にバインドされるフィルター設定が維持されます。動的なフィルターは、フィルターの選択が変更されると、接続されているすべての表示形式に適用されます。 + +たとえば、世界中の場所のリストを含むデータセットを追加して、ダッシュボードのすべての表示形式をバインドできます。このシナリオでは、各ダッシュボードの情報を参照するユーザーが場所ごとに各表示形式のコンテンツをフィルタリングできます。 + +![Dashboard filter by location added in the Dashboard editor](images/sample-dashboard-filters.png) + +Reveal は、日付範囲をダッシュボード フィルターとして有効にすることもサポートします。これにより、特定の期間ですべての表示形式をフィルタリングできます。 + +このセクションは以下のトピックを説明します: + + - **ダッシュボード**と**表示形式エディター**の両方の[ダッシュボード フィルター](filters-dashboard.md) + + - [ダッシュボード フィルターの構成可能なプロパティ](filters-dashboard-properties.md): + + - [表示フィールド](filters-dashboard-properties.md#表示フィールド) + + - [複数選択](filters-dashboard-properties.md#複数選択) + + - [必須選択](filters-dashboard-properties.md#必須選択) + + - [データ フィルター](filters-dashboard-properties.md#データ-フィルター) + + - [ダッシュボード フィルターと表示形式への接続](filters-connecting.md) (表示形式バインディングとも呼ばれます) + + - [表示形式のクイック フィルター](filters-visualization.md) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/filters-visualization.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/filters-visualization.md new file mode 100644 index 00000000..194a58be --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/filters-visualization.md @@ -0,0 +1,36 @@ +--- +title: 表示形式のクイック フィルターを適用する方法 +_description: 表示形式のクイック フィルターを適用して表示形式コンテンツを動的にフィルターする方法を説明します。 +_language: ja +--- + +# 表示形式のクイック フィルター + +表示形式レベルでは、「クイック」フィルターを適用することもできます。これにより、クイック フィルターの選択が変更されたときに表示形式コンテンツを動的にフィルターできます。これらは、ダッシュボード定義の一部となり、ダッシュボードのユーザーが変更することはできません。 + +クイック フィルターを定義するには、表示形式エディターで表示形式の上にある **[表示形式フィルターの追加]** ボタンを選択します。 + +![Visualization Quick Filter button in the Visualization Editor](images/visualization-quick-filter-example.png) + +フィルター オプションは、フィールドのデータ タイプに応じて表示形式フィルター エリアで表示されます。テキスト、数値、日付の 3 つのフィルター ダイアログがあります。作成されたクイック フィルターは、表示形式エディターの表示形式の上に表示されます。 + +![List of fields in the visualization editor](images/visualization-filter-visualization-editor.png) + +ダッシュボード ビュー モードで表示形式を最大化すると、表示形式のタイトルの下に表示されます。 + +![The location of the visualization filter in dashboard view maximized](images/location-visualization-filter.png) + +[ダッシュボード フィルター](filters-dashboard.md)同様に、簡易フィルター セクションが変更されると表示形式コンテンツの動的なフィルターが有効になります。 + +## フィルターのカスケード + +クイック フィルターで表示される選択可能な値のリストは、以前のクイック フィルター選択に基づいてフィルターされます。左側のフィールドが優先され、右側のフィルターに表示される選択可能な値のリストを決定します。 + +たとえば、以下の例では、*Office* フィルターが最初に作成され、*Fullname* フィルターがその後に作成されました。すべての Office を選択すると、*County* のリストは次のようになります。 + +![Cascading Filter for the State Population Dashboard showing counties in Colorado](images/cascading-filter.png) + +ただし、**Cranbury, New Jersey, USA** と **Montevideo, Uruguay** のオフィスを選択した場合は、*County* のリストは異なります。 + +![Cascading Filter for the State Population Dashboard showing counties in Arkansas](images/cascading-filter-second-filter.png) + diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Access-Axis-Configuration.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Access-Axis-Configuration.png new file mode 100644 index 00000000..991fbdc8 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Access-Axis-Configuration.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/BrazilStatePopulation_all.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/BrazilStatePopulation_all.png new file mode 100644 index 00000000..93dd774e Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/BrazilStatePopulation_all.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Combo-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Combo-chart.png new file mode 100644 index 00000000..14def1f6 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Combo-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/HRDashboardEmployeesDIY_All.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/HRDashboardEmployeesDIY_All.png new file mode 100644 index 00000000..2ba64578 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/HRDashboardEmployeesDIY_All.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/KPIGaugeDifferenceColor_All.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/KPIGaugeDifferenceColor_All.png new file mode 100644 index 00000000..c30b8398 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/KPIGaugeDifferenceColor_All.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/KPIGaugePreviousMonth_All.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/KPIGaugePreviousMonth_All.png new file mode 100644 index 00000000..5ca08197 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/KPIGaugePreviousMonth_All.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/KPIGaugeSimple_All.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/KPIGaugeSimple_All.png new file mode 100644 index 00000000..93478f42 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/KPIGaugeSimple_All.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/KPIGaugeValuePercentage_All.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/KPIGaugeValuePercentage_All.png new file mode 100644 index 00000000..6c57fdb2 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/KPIGaugeValuePercentage_All.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/StatePopulation_all.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/StatePopulation_all.png new file mode 100644 index 00000000..4093f184 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/StatePopulation_all.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Thumbs.db b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Thumbs.db new file mode 100644 index 00000000..725e8907 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Thumbs.db differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorial-Change-Date-Difference-Label.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorial-Change-Date-Difference-Label.png new file mode 100644 index 00000000..1c431277 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorial-Change-Date-Difference-Label.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorial-Change-Date-Difference-Marker-Color.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorial-Change-Date-Difference-Marker-Color.png new file mode 100644 index 00000000..c0072049 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorial-Change-Date-Difference-Marker-Color.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorial-Change-Date-Type.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorial-Change-Date-Type.png new file mode 100644 index 00000000..b17b5ae5 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorial-Change-Date-Type.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/TutorialMultipleKPIGauges_All.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/TutorialMultipleKPIGauges_All.png new file mode 100644 index 00000000..1fc03563 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/TutorialMultipleKPIGauges_All.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorials-KPIGauge-Organizing-Data.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorials-KPIGauge-Organizing-Data.png new file mode 100644 index 00000000..3e5ce4fc Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorials-KPIGauge-Organizing-Data.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorials-MultipleKPIGauge-Organizing-Data.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorials-MultipleKPIGauge-Organizing-Data.png new file mode 100644 index 00000000..d2941835 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorials-MultipleKPIGauge-Organizing-Data.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorials-Navigate-Settings.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorials-Navigate-Settings.png new file mode 100644 index 00000000..f624dea3 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorials-Navigate-Settings.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorials-Select-KPI-Gauge-Spreadsheet.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorials-Select-KPI-Gauge-Spreadsheet.png new file mode 100644 index 00000000..ebe0869e Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorials-Select-KPI-Gauge-Spreadsheet.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorials-Select-Sparkline-Charts-Spreadsheet.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorials-Select-Sparkline-Charts-Spreadsheet.png new file mode 100644 index 00000000..1e965b43 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/Tutorials-Select-Sparkline-Charts-Spreadsheet.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/WorldPopulationGDP_All.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/WorldPopulationGDP_All.png new file mode 100644 index 00000000..94bd862f Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/WorldPopulationGDP_All.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/add-visualization-button.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/add-visualization-button.png new file mode 100644 index 00000000..b467ec75 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/add-visualization-button.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/advanced-settings-kpi-gauge.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/advanced-settings-kpi-gauge.png new file mode 100644 index 00000000..c5c3fe2c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/advanced-settings-kpi-gauge.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/area-chart-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/area-chart-icon.png new file mode 100644 index 00000000..48962aa9 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/area-chart-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/area-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/area-chart.png new file mode 100644 index 00000000..0b128033 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/area-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/area-sparkline-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/area-sparkline-chart.png new file mode 100644 index 00000000..b211b2c5 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/area-sparkline-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/axis-bounds-candlestick.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/axis-bounds-candlestick.png new file mode 100644 index 00000000..f662f0d7 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/axis-bounds-candlestick.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/axis-bounds-logarithmic.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/axis-bounds-logarithmic.png new file mode 100644 index 00000000..60db50db Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/axis-bounds-logarithmic.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/axis-bounds-section.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/axis-bounds-section.png new file mode 100644 index 00000000..013c7122 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/axis-bounds-section.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/axis-bounds.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/axis-bounds.png new file mode 100644 index 00000000..87ec5899 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/axis-bounds.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/axis-logarithmic-candlestick.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/axis-logarithmic-candlestick.png new file mode 100644 index 00000000..a9262d12 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/axis-logarithmic-candlestick.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/axis-logarithmic.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/axis-logarithmic.png new file mode 100644 index 00000000..9ed5dec3 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/axis-logarithmic.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/band-color-options.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/band-color-options.png new file mode 100644 index 00000000..b96d8a68 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/band-color-options.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bar-chart-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bar-chart-icon.png new file mode 100644 index 00000000..1c0a8076 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bar-chart-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bar-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bar-chart.png new file mode 100644 index 00000000..6a34c958 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bar-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bounds-axis.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bounds-axis.png new file mode 100644 index 00000000..26b3511b Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bounds-axis.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bubble-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bubble-chart.png new file mode 100644 index 00000000..b929c76b Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bubble-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bullet-graph-gauge.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bullet-graph-gauge.png new file mode 100644 index 00000000..8f38a8aa Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bullet-graph-gauge.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bullet-graph-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bullet-graph-icon.png new file mode 100644 index 00000000..66a23675 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bullet-graph-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bullet-graph-organizing-data.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bullet-graph-organizing-data.png new file mode 100644 index 00000000..bd2593c5 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/bullet-graph-organizing-data.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/candlestick-chart-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/candlestick-chart-icon.png new file mode 100644 index 00000000..530be407 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/candlestick-chart-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/candlestick-chart-types.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/candlestick-chart-types.png new file mode 100644 index 00000000..1de20b97 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/candlestick-chart-types.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/candlestick-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/candlestick-chart.png new file mode 100644 index 00000000..ae6a0142 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/candlestick-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/candlestick-organizing-data.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/candlestick-organizing-data.png new file mode 100644 index 00000000..9d209bdc Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/candlestick-organizing-data.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/candlestick-visualization-editor-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/candlestick-visualization-editor-example.png new file mode 100644 index 00000000..dbb4b02a Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/candlestick-visualization-editor-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/cascading-filter-second-filter.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/cascading-filter-second-filter.png new file mode 100644 index 00000000..6c6cb594 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/cascading-filter-second-filter.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/cascading-filter.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/cascading-filter.png new file mode 100644 index 00000000..a70a36e6 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/cascading-filter.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/chart-trendline-simple-series-charts.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/chart-trendline-simple-series-charts.png new file mode 100644 index 00000000..acb119cc Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/chart-trendline-simple-series-charts.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/chart-types-simple-series-charts.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/chart-types-simple-series-charts.png new file mode 100644 index 00000000..0c2152a0 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/chart-types-simple-series-charts.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/chart-types-sparkline.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/chart-types-sparkline.png new file mode 100644 index 00000000..be4f0334 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/chart-types-sparkline.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/choropleth-map.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/choropleth-map.png new file mode 100644 index 00000000..e6654f7b Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/choropleth-map.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/circular-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/circular-chart.png new file mode 100644 index 00000000..0467c404 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/circular-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/circular-gauge-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/circular-gauge-icon.png new file mode 100644 index 00000000..752e4af4 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/circular-gauge-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/circular-gauge.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/circular-gauge.png new file mode 100644 index 00000000..752e4af4 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/circular-gauge.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/column-chart-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/column-chart-icon.png new file mode 100644 index 00000000..adb178ad Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/column-chart-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/column-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/column-chart.png new file mode 100644 index 00000000..1c2788e9 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/column-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/connecting-to-another-dashboard-option.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/connecting-to-another-dashboard-option.png new file mode 100644 index 00000000..211b8962 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/connecting-to-another-dashboard-option.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/custom-date-range-date-filter.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/custom-date-range-date-filter.png new file mode 100644 index 00000000..ef33cb99 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/custom-date-range-date-filter.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/dashboard-filter-connection-option-visualization-editor.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/dashboard-filter-connection-option-visualization-editor.png new file mode 100644 index 00000000..3d29458f Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/dashboard-filter-connection-option-visualization-editor.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/dashboard-filter-data-source-menu.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/dashboard-filter-data-source-menu.png new file mode 100644 index 00000000..da18778e Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/dashboard-filter-data-source-menu.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/dashboard-filter-dialog-connect-option.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/dashboard-filter-dialog-connect-option.png new file mode 100644 index 00000000..d598662c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/dashboard-filter-dialog-connect-option.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/dashboard-filter-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/dashboard-filter-dialog.png new file mode 100644 index 00000000..448596dd Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/dashboard-filter-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/dashboard-filters-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/dashboard-filters-dialog.png new file mode 100644 index 00000000..5f89c1f8 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/dashboard-filters-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/dashboard-filters-select-data-filter-field.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/dashboard-filters-select-data-filter-field.png new file mode 100644 index 00000000..fd88ff7c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/dashboard-filters-select-data-filter-field.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/data-filter-dialog-select-value-text-view.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/data-filter-dialog-select-value-text-view.png new file mode 100644 index 00000000..b0ca8230 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/data-filter-dialog-select-value-text-view.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/data-filter-select-value-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/data-filter-select-value-example.png new file mode 100644 index 00000000..1e568cc5 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/data-filter-select-value-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/data-filters-dashboard-filters-hr-dashboard.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/data-filters-dashboard-filters-hr-dashboard.png new file mode 100644 index 00000000..1d693f92 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/data-filters-dashboard-filters-hr-dashboard.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/data-source-parameters-dashboard-filter.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/data-source-parameters-dashboard-filter.png new file mode 100644 index 00000000..f3a1b6fb Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/data-source-parameters-dashboard-filter.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/date-filter-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/date-filter-dialog.png new file mode 100644 index 00000000..0869b16c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/date-filter-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/date-filter-option.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/date-filter-option.png new file mode 100644 index 00000000..2ad29a19 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/date-filter-option.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/delete-filter-option.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/delete-filter-option.png new file mode 100644 index 00000000..3d86b13e Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/delete-filter-option.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/different-candlestick-charts.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/different-candlestick-charts.png new file mode 100644 index 00000000..a538e4e9 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/different-candlestick-charts.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/different-gauge-visualizations.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/different-gauge-visualizations.png new file mode 100644 index 00000000..9c8f9063 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/different-gauge-visualizations.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/different-stacked-charts-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/different-stacked-charts-example.png new file mode 100644 index 00000000..6f9fa66f Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/different-stacked-charts-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/disconnect-option-dashboard-filter.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/disconnect-option-dashboard-filter.png new file mode 100644 index 00000000..be5127be Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/disconnect-option-dashboard-filter.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/doughnut-chart-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/doughnut-chart-icon.png new file mode 100644 index 00000000..8ac09f8e Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/doughnut-chart-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/doughnut-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/doughnut-chart.png new file mode 100644 index 00000000..6dce046d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/doughnut-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/duplicate-visualization-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/duplicate-visualization-example.png new file mode 100644 index 00000000..731e4648 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/duplicate-visualization-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/edit-connection-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/edit-connection-dialog.png new file mode 100644 index 00000000..b4f45cda Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/edit-connection-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/edit-mode-filter.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/edit-mode-filter.png new file mode 100644 index 00000000..c98cfcbd Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/edit-mode-filter.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/editor-view-dashboard-filter.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/editor-view-dashboard-filter.png new file mode 100644 index 00000000..843540f6 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/editor-view-dashboard-filter.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/example-data-visualizations.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/example-data-visualizations.png new file mode 100644 index 00000000..c70dc364 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/example-data-visualizations.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-as-powerpoint-option.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-as-powerpoint-option.png new file mode 100644 index 00000000..db241a82 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-as-powerpoint-option.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-dashboard-as-excel.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-dashboard-as-excel.png new file mode 100644 index 00000000..a2fc0b4c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-dashboard-as-excel.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-dashboard-as-powerpoint.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-dashboard-as-powerpoint.png new file mode 100644 index 00000000..45b13783 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-dashboard-as-powerpoint.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-image-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-image-dialog.png new file mode 100644 index 00000000..25b493c4 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-image-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-image-toolbar.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-image-toolbar.png new file mode 100644 index 00000000..b500cf98 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-image-toolbar.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-images-annotation.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-images-annotation.png new file mode 100644 index 00000000..3ccb72d6 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-images-annotation.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-option-excel.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-option-excel.png new file mode 100644 index 00000000..2c155ab4 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-option-excel.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-option-overflow-menu.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-option-overflow-menu.png new file mode 100644 index 00000000..06e809a8 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-option-overflow-menu.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-option.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-option.png new file mode 100644 index 00000000..f2f4fab1 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-option.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-pdf-options.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-pdf-options.png new file mode 100644 index 00000000..5839d4df Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-pdf-options.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-visualization.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-visualization.png new file mode 100644 index 00000000..b87ef6e1 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/export-visualization.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/field-settings-aggregation-options.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/field-settings-aggregation-options.png new file mode 100644 index 00000000..c9a1b793 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/field-settings-aggregation-options.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/filter-options-dashboard.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/filter-options-dashboard.png new file mode 100644 index 00000000..2a6f2cf3 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/filter-options-dashboard.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/filter-types.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/filter-types.png new file mode 100644 index 00000000..0ea03c39 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/filter-types.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/filtered-text-view-visualization.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/filtered-text-view-visualization.png new file mode 100644 index 00000000..f78a3bf7 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/filtered-text-view-visualization.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/format-options.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/format-options.png new file mode 100644 index 00000000..193ec127 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/format-options.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/funnel-chart-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/funnel-chart-icon.png new file mode 100644 index 00000000..fa1786da Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/funnel-chart-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/funnel-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/funnel-chart.png new file mode 100644 index 00000000..4a55bde8 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/funnel-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/gauge-kpi-chart-type.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/gauge-kpi-chart-type.png new file mode 100644 index 00000000..d77178cc Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/gauge-kpi-chart-type.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/gauge-views.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/gauge-views.png new file mode 100644 index 00000000..76640855 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/gauge-views.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/gauges-bullet-graph-chart-types.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/gauges-bullet-graph-chart-types.png new file mode 100644 index 00000000..3cd947dd Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/gauges-bullet-graph-chart-types.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/gauges-circular-chart-types.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/gauges-circular-chart-types.png new file mode 100644 index 00000000..7e1c810d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/gauges-circular-chart-types.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/gauges-linear-chart-types.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/gauges-linear-chart-types.png new file mode 100644 index 00000000..0df02407 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/gauges-linear-chart-types.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/gauges-text-chart-types.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/gauges-text-chart-types.png new file mode 100644 index 00000000..ca377fd6 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/gauges-text-chart-types.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/image-chart-data-organization.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/image-chart-data-organization.png new file mode 100644 index 00000000..94bc97d7 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/image-chart-data-organization.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/image-chart-sample.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/image-chart-sample.png new file mode 100644 index 00000000..567a574d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/image-chart-sample.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/image-chart-type.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/image-chart-type.png new file mode 100644 index 00000000..260c4d7d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/image-chart-type.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/image-export-format.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/image-export-format.png new file mode 100644 index 00000000..ae009051 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/image-export-format.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/image-view-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/image-view-icon.png new file mode 100644 index 00000000..4d0fbb47 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/image-view-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/image-view.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/image-view.png new file mode 100644 index 00000000..4d0fbb47 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/image-view.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/kpi-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/kpi-icon.png new file mode 100644 index 00000000..c1772fdb Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/kpi-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/kpi.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/kpi.png new file mode 100644 index 00000000..f8517ef2 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/kpi.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/limit-options.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/limit-options.png new file mode 100644 index 00000000..b1c148ce Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/limit-options.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/line-chart-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/line-chart-icon.png new file mode 100644 index 00000000..38634026 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/line-chart-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/line-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/line-chart.png new file mode 100644 index 00000000..0be311f2 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/line-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/linear-gauge-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/linear-gauge-icon.png new file mode 100644 index 00000000..ad40c3e1 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/linear-gauge-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/linear-gauge.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/linear-gauge.png new file mode 100644 index 00000000..b661b34e Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/linear-gauge.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/linear-regression-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/linear-regression-dialog.png new file mode 100644 index 00000000..acf76cbc Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/linear-regression-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/linear-regression-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/linear-regression-example.png new file mode 100644 index 00000000..dae7fd05 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/linear-regression-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/linking-to-url.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/linking-to-url.png new file mode 100644 index 00000000..3c01c1bb Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/linking-to-url.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/location-visualization-filter.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/location-visualization-filter.png new file mode 100644 index 00000000..d826ac83 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/location-visualization-filter.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/maximized-visualization-trigger.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/maximized-visualization-trigger.png new file mode 100644 index 00000000..d67a6555 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/maximized-visualization-trigger.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/multiple-kpi-gauges.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/multiple-kpi-gauges.png new file mode 100644 index 00000000..f5ac389c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/multiple-kpi-gauges.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/multiple-selection-dashboard-filters.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/multiple-selection-dashboard-filters.png new file mode 100644 index 00000000..f96f0678 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/multiple-selection-dashboard-filters.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/multiple-selection-option-dashboard-filter-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/multiple-selection-option-dashboard-filter-dialog.png new file mode 100644 index 00000000..54bb1471 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/multiple-selection-option-dashboard-filter-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/new-visualization-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/new-visualization-dialog.png new file mode 100644 index 00000000..a14e0080 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/new-visualization-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/new-visualization-screen.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/new-visualization-screen.png new file mode 100644 index 00000000..4a770ca2 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/new-visualization-screen.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-candlestick-logarithmic-axis.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-candlestick-logarithmic-axis.png new file mode 100644 index 00000000..ae801dbb Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-candlestick-logarithmic-axis.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-candlestick-spreadsheet.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-candlestick-spreadsheet.png new file mode 100644 index 00000000..4e53df04 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-candlestick-spreadsheet.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-chart-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-chart-icon.png new file mode 100644 index 00000000..931c94da Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-chart-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-chart-types.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-chart-types.png new file mode 100644 index 00000000..0fbfc3f8 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-chart-types.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-chart.png new file mode 100644 index 00000000..1a8e29fa Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-charts-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-charts-example.png new file mode 100644 index 00000000..5f173e62 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-charts-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-organizing-data.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-organizing-data.png new file mode 100644 index 00000000..81329c29 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-organizing-data.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-visualization-editor.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-visualization-editor.png new file mode 100644 index 00000000..43dc0f06 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/ohlc-visualization-editor.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/organizing-data-circular-gauge-visualization.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/organizing-data-circular-gauge-visualization.png new file mode 100644 index 00000000..f24e1597 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/organizing-data-circular-gauge-visualization.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/organizing-data-gauge-visualization.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/organizing-data-gauge-visualization.png new file mode 100644 index 00000000..2c14782a Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/organizing-data-gauge-visualization.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/organizing-data-text-view.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/organizing-data-text-view.png new file mode 100644 index 00000000..de373b06 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/organizing-data-text-view.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/outlier-detection-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/outlier-detection-example.png new file mode 100644 index 00000000..2c41ffea Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/outlier-detection-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/overflow-edit-option.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/overflow-edit-option.png new file mode 100644 index 00000000..af215e05 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/overflow-edit-option.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/percentage-distribution.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/percentage-distribution.png new file mode 100644 index 00000000..a91e0b57 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/percentage-distribution.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/pie-chart-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/pie-chart-icon.png new file mode 100644 index 00000000..2d784b84 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/pie-chart-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/pie-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/pie-chart.png new file mode 100644 index 00000000..1f5412ca Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/pie-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/pivot-editor-view-kpi-gauge.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/pivot-editor-view-kpi-gauge.png new file mode 100644 index 00000000..98ccdec5 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/pivot-editor-view-kpi-gauge.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/radial-chart-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/radial-chart-icon.png new file mode 100644 index 00000000..1080c94c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/radial-chart-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/radial-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/radial-chart.png new file mode 100644 index 00000000..1080c94c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/radial-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/required-selection-option-filters.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/required-selection-option-filters.png new file mode 100644 index 00000000..cfa7553e Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/required-selection-option-filters.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/reusing-visualization-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/reusing-visualization-example.png new file mode 100644 index 00000000..e67514c1 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/reusing-visualization-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sample-dashboard-filters.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sample-dashboard-filters.png new file mode 100644 index 00000000..b850eb95 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sample-dashboard-filters.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sample-linked-dashboards-2.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sample-linked-dashboards-2.png new file mode 100644 index 00000000..c4e6a531 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sample-linked-dashboards-2.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sample-linked-dashboards.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sample-linked-dashboards.png new file mode 100644 index 00000000..27f00a90 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sample-linked-dashboards.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/scatter-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/scatter-chart.png new file mode 100644 index 00000000..f7711343 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/scatter-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/scatter-map.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/scatter-map.png new file mode 100644 index 00000000..cffe217e Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/scatter-map.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/select-data-filter-text-view.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/select-data-filter-text-view.png new file mode 100644 index 00000000..318b36f2 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/select-data-filter-text-view.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/select-image-view.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/select-image-view.png new file mode 100644 index 00000000..3adb3eaf Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/select-image-view.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/select-your-data-source.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/select-your-data-source.png new file mode 100644 index 00000000..e49f4634 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/select-your-data-source.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/selected-value-trigger.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/selected-value-trigger.png new file mode 100644 index 00000000..fd597374 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/selected-value-trigger.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/settings-linking-option.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/settings-linking-option.png new file mode 100644 index 00000000..4b28283e Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/settings-linking-option.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/settings-tutorials.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/settings-tutorials.png new file mode 100644 index 00000000..2a3d51aa Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/settings-tutorials.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/simple-series-charts-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/simple-series-charts-example.png new file mode 100644 index 00000000..04d02276 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/simple-series-charts-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/simple-series-charts-example2.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/simple-series-charts-example2.png new file mode 100644 index 00000000..1a5e09f3 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/simple-series-charts-example2.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/simple-series-charts-example3.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/simple-series-charts-example3.png new file mode 100644 index 00000000..94e7c814 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/simple-series-charts-example3.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/simple-series-charts-organizing-data.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/simple-series-charts-organizing-data.png new file mode 100644 index 00000000..15024455 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/simple-series-charts-organizing-data.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/simple-series-charts-spreadsheet.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/simple-series-charts-spreadsheet.png new file mode 100644 index 00000000..79ab07af Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/simple-series-charts-spreadsheet.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/simple-sparkline-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/simple-sparkline-chart.png new file mode 100644 index 00000000..e2567862 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/simple-sparkline-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/slice-label-settings.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/slice-label-settings.png new file mode 100644 index 00000000..b06c7f04 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/slice-label-settings.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-area-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-area-chart.png new file mode 100644 index 00000000..e3d87188 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-area-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-chart-columns-options.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-chart-columns-options.png new file mode 100644 index 00000000..931b642d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-chart-columns-options.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-chart-date-aggregation.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-chart-date-aggregation.png new file mode 100644 index 00000000..f86a4378 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-chart-date-aggregation.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-chart-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-chart-icon.png new file mode 100644 index 00000000..08f96bbd Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-chart-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-chart.png new file mode 100644 index 00000000..4b5dcabd Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-charts-organizing-data.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-charts-organizing-data.png new file mode 100644 index 00000000..ed0f5d16 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-charts-organizing-data.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-charts-settings.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-charts-settings.png new file mode 100644 index 00000000..6703d751 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-charts-settings.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-charts-spreadsheet.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-charts-spreadsheet.png new file mode 100644 index 00000000..9a1bb52d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-charts-spreadsheet.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-with-day-aggregation.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-with-day-aggregation.png new file mode 100644 index 00000000..a215edb0 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-with-day-aggregation.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-with-less-columns-and-area-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-with-less-columns-and-area-chart.png new file mode 100644 index 00000000..e9b69e78 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/sparkline-with-less-columns-and-area-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/spline-area-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/spline-area-chart.png new file mode 100644 index 00000000..c370f9be Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/spline-area-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/spline-area-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/spline-area-icon.png new file mode 100644 index 00000000..c370f9be Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/spline-area-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/spline-chart-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/spline-chart-icon.png new file mode 100644 index 00000000..8f6bf117 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/spline-chart-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/spline-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/spline-chart.png new file mode 100644 index 00000000..231952f2 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/spline-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-area-chart-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-area-chart-icon.png new file mode 100644 index 00000000..55106cb5 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-area-chart-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-area-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-area-chart.png new file mode 100644 index 00000000..84d0efd6 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-area-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-bar-chart-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-bar-chart-icon.png new file mode 100644 index 00000000..e74f521f Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-bar-chart-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-bar-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-bar-chart.png new file mode 100644 index 00000000..91066034 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-bar-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-chart-spreadsheet-data-source-details-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-chart-spreadsheet-data-source-details-dialog.png new file mode 100644 index 00000000..d020bc0a Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-chart-spreadsheet-data-source-details-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-chart-types.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-chart-types.png new file mode 100644 index 00000000..b6d4e379 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-chart-types.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-charts-organizing-data.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-charts-organizing-data.png new file mode 100644 index 00000000..3ce76f85 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-charts-organizing-data.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-column-chart-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-column-chart-icon.png new file mode 100644 index 00000000..22304ca4 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-column-chart-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-column-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-column-chart.png new file mode 100644 index 00000000..66587046 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/stacked-column-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/start-position-settings.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/start-position-settings.png new file mode 100644 index 00000000..8ad00bb7 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/start-position-settings.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/statistical-functions-enable-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/statistical-functions-enable-icon.png new file mode 100644 index 00000000..244257ec Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/statistical-functions-enable-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/step-area-chart-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/step-area-chart-icon.png new file mode 100644 index 00000000..41adb9da Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/step-area-chart-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/step-area-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/step-area-chart.png new file mode 100644 index 00000000..7e02e45a Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/step-area-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/step-line-chart-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/step-line-chart-icon.png new file mode 100644 index 00000000..e2b44138 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/step-line-chart-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-gauge-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-gauge-icon.png new file mode 100644 index 00000000..7aec8597 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-gauge-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-gauge-organizing-data.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-gauge-organizing-data.png new file mode 100644 index 00000000..780f54e4 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-gauge-organizing-data.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-gauge.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-gauge.png new file mode 100644 index 00000000..5651fc33 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-gauge.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-option-in-export-image.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-option-in-export-image.png new file mode 100644 index 00000000..d02ae363 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-option-in-export-image.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-view-chart-types.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-view-chart-types.png new file mode 100644 index 00000000..2d8b51d4 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-view-chart-types.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-view-icon.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-view-icon.png new file mode 100644 index 00000000..55ef7213 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-view-icon.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-view-sample.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-view-sample.png new file mode 100644 index 00000000..1132ecba Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-view-sample.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-view-visualization.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-view-visualization.png new file mode 100644 index 00000000..9f7019e5 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-view-visualization.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-view.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-view.png new file mode 100644 index 00000000..3eb173dc Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/text-view.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/time-series-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/time-series-chart.png new file mode 100644 index 00000000..e4158f66 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/time-series-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/time-series-forecast-dialog.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/time-series-forecast-dialog.png new file mode 100644 index 00000000..3cd28d02 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/time-series-forecast-dialog.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/time-series-forecast-visualization-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/time-series-forecast-visualization-example.png new file mode 100644 index 00000000..b17d2532 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/time-series-forecast-visualization-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/treemap-chart.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/treemap-chart.png new file mode 100644 index 00000000..1855d6c3 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/treemap-chart.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/tutorials-settings.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/tutorials-settings.png new file mode 100644 index 00000000..9e799af8 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/tutorials-settings.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/tutorials-simple-series-charts-spreadsheet.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/tutorials-simple-series-charts-spreadsheet.png new file mode 100644 index 00000000..4cbeb8be Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/tutorials-simple-series-charts-spreadsheet.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/underlying-data-time-series.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/underlying-data-time-series.png new file mode 100644 index 00000000..fbcc9253 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/underlying-data-time-series.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/value-circular-gauge.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/value-circular-gauge.png new file mode 100644 index 00000000..b98248ff Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/value-circular-gauge.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/various-charts-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/various-charts-example.png new file mode 100644 index 00000000..5cd5fa21 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/various-charts-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/visualization-editor-dashboard-filter.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/visualization-editor-dashboard-filter.png new file mode 100644 index 00000000..642ee9ee Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/visualization-editor-dashboard-filter.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/visualization-filter-visualization-editor.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/visualization-filter-visualization-editor.png new file mode 100644 index 00000000..0b6cc085 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/visualization-filter-visualization-editor.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/visualization-quick-filter-example.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/visualization-quick-filter-example.png new file mode 100644 index 00000000..a086225e Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/visualization-quick-filter-example.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/visualization-tutorials-sample.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/visualization-tutorials-sample.png new file mode 100644 index 00000000..76100701 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/visualization-tutorials-sample.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/visualizations-editor-sections.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/visualizations-editor-sections.png new file mode 100644 index 00000000..9aa3d2de Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/images/visualizations-editor-sections.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/index.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/index.md new file mode 100644 index 00000000..90747ad5 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/index.md @@ -0,0 +1,28 @@ +--- +displayed_sidebar: userSideBar +hide_table_of_contents: true +--- + +# Reveal ユーザー ドキュメントへようこそ! + +Reveal は、インタラクティブな表示形式を簡単に作成、分析、共有できるモダンなビジネス インテリジェンス (BI) ソリューションです。この包括的なユーザーガイドでは、最初のダッシュボードの作成から複雑な表示形式のカスタマイズ、高度なデータ フィルターの適用に至るまで、Reveal の機能を最大限に活用するための情報を提供します。 + +## このドキュメントの内容 + +### [ダッシュボード](dashboard-export.md) +ダッシュボードの作成と管理に関する洞察を得ます。ダッシュボードをリンクする方法や、PDF、Excel、画像、PowerPoint などの形式でエクスポートする方法を理解し、ビジネスニーズに合わせてその可能性を最大限に引き出しましょう。 + +### [表示形式](visualizations-overview.md) +データ表示形式の世界に飛び込んでみましょう。表示形式エディターの理解から、階級区分図、複合チャート、散布マップなどの特定のチャート タイプの探索まで、Reveal はデータを表現するための多彩なオプションを提供します。 + +### [フィールドとデータ操作](fields/overview.md) +フィールド設定の操作方法、アドホック階層の作成、条件付き書式の適用、フィールド フィルターやルールの管理方法について説明します。高度なデータ処理のための計算フィールドについての詳細情報も得られます。 + +### [フィルター](filters-overview.md) +フィルターを適用およびカスタマイズしてデータを絞り込む方法を理解します。ダッシュボード間でのフィルター接続、フィルターのプロパティ管理、日付範囲フィルターや表示形式フィルターなどの特殊なフィルターの使用方法が含まれます。 + +### [チュートリアル](tutorials-overview.md) +特定のチャート タイプと高度な機能を作成し、習得するためのステップバイステップのチュートリアルです。ローソク足チャート、KPI ゲージ、スパークライン チャートを作成する方法など、実用的な手順を提供します。 + +Reveal は、データを実用的な洞察に変えるお手伝いをします。このドキュメントを活用して、Reveal を使ったデータ表示形式とビジネス インテリジェンスをマスターしましょう。 + diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/reusing-visualizations.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/reusing-visualizations.md new file mode 100644 index 00000000..61b77180 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/reusing-visualizations.md @@ -0,0 +1,29 @@ +--- +title: Reveal で表示形式を再利用する方法 +_description: 表示形式を再利用し、ダッシュボードの作成を高速化できます。 +_language: ja +--- + +# 表示形式の再利用 + +表示形式を再利用してダッシュボードの作成をスピード アップできます。それを行うには、必要な表示形式を**コピーし貼り付ける**だけです。 + +![Overflow menu of a visualization in a dashboard displayed](images/reusing-visualization-example.png) + +## 表示形式の複製 + +ダッシュボード内で元の表示形式と同じものを作成します。既にカスタマイズした表示形式を複製して、複製したデータ セットを調整します。たとえば、以下のチャートはすべてのオフィスの**雇用**を示し、特定のものを別に表示します。 + +![Duplicated visualizations](images/duplicate-visualization-example.png) + +## 表示形式のコピーと貼り付け + +ダッシュボード内、またはダッシュボード間の任意の表示形式をコピーし貼り付けることができます。注: 他のダッシュボードの表示形式を使用して新しいダッシュボードを作成できます。 + +## 考慮点 + +新しい表示形式は元の表示形式と**同じ名前**になります。 + +ダッシュボード編集モードの表示形式のオーバーフロー メニューから **[名前の変更]** を選択できます。鉛筆アイコンを使用して、[表示形式エディター](visualization-editor.md)でタイトルを変更することもできます。 + +元の表示形式に**データ エディターのデータ**がある場合、新しい表示形式にもこのデータが使用されます。必要に応じて、データ エディターからフィールドを削除します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/statistical-functions.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/statistical-functions.md new file mode 100644 index 00000000..bc9781b8 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/statistical-functions.md @@ -0,0 +1,101 @@ +--- +title: 統計関数を使用する方法 +_description: 統計関数を使用して表示形式からより多くの洞察を得る方法を説明します。 +_language: ja +--- + +# Reveal の統計関数 + +Reveal の統計関数を使用すると、表示形式からより多くの気付きを得ることができます。3 種類の高度な予測分析を提供します。[**時系列予測**](#時系列予測)、[**線形回帰**](#線形回帰)、および[**外れ値の検出**](#外れ値の検出)を使用して、データ シリーズで予測を行い、傾向を認識して評価し、外れ値を検出できます。 + +## 統計関数へのアクセス + +3 つの**統計関数**の 1 つを表示形式に適用するには、以下を行う必要があります。 + +1. **ダッシュボードのビュー モード**でダッシュボードを開きます。 + +2. 表示形式を**最大化します** (右上隅の**矢印**アイコンをクリックします)。 + +3. 画面の右上に表示されるアイコンをクリックまたはタップします (以下を参照)。 + +![Statistical functions icon](images/statistical-functions-enable-icon.png) + +:::note +**関数の有効/無効**: 表示形式に 3 つの関数のうち有効にできるのは 1 つのみです。有効な関数を再度クリックして無効にするか、あるいはリストから別の関数を選択して切り替えます。 +::: + +## 統計関数タイプ + +以下の表は、すべての関数の用途、関数が使用するアルゴリズム、および関数を有効にできる表示形式について説明します。 + +| **関数** | **アルゴリズム** | **使用方法** | **それをサポートする表示形式 it?** | +| ----------------------- | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 時系列予測 | 指数平滑法 | 特定のデータ系列について、データの予測を行うこと。ーザーは将来の時間範囲を選択できます。 | カテゴリ チャート: エリア、棒、柱状、折れ線、スプライン、スプライン エリア、ステップ エリア、ステップ折れ線 | +| 線形回帰 | 線形回帰 | 2 つの変数間の線形関係を見つけることによって傾向を評価すること。アルゴリズムは、チャートのほとんどのポイントに近い線を計算して、進行中の傾向を示します。 | カテゴリ チャート: エリア、棒、柱状、折れ線、スプライン、スプライン エリア、ステップ エリア、ステップ折れ線 | +| 外れ値の検出 | 四分位範囲ルール | ランダム要因のために他のデータから際立っているデータを検出するため。 | カテゴリ チャート: エリア、柱状、折れ線、スプライン、スプライン エリア、ステップ エリア、ステップ折れ線; 散布図 | + +### 時系列予測 + +**時系列予測**関数は、特定のデータ シリーズのデータを予測するために使用します。以下の例では、関数が次の 12 か月間の 2 つの製品の売上予測を提供するために使用されています。 + +![Time series sales forecast for next 12 month](images/time-series-forecast-visualization-example.png) + +上記の予測を実現するには、以下の手順を実行します。 + +1. **[統計関数]** メニューから **[時系列予測]** を選択します。 + +2. 以下の設定ダイアログが開きます。 + + ![Time series forecast settings](images/time-series-forecast-dialog.png) + + ここで、**季節の長さ**と**期間予測**を構成する必要があります。 + + * **季節の長さ** - 表示形式のために季節の**日数、月数、年数**を選択します。季節の長さの時間単位は、**[日付]** フィールドが日、月、または年のいずれで測定されるかに基づいて決定されます。 + + 時系列データでは、**季節が変動が発生する特定の定期的な間隔です**。Reveal の指数平滑法アルゴリズムは、進化トレンドを計算し、季節調整を使用してそれを等しくします。 + + たとえば、スキー用品の販売は 1 年以内に変動します - 11 月と 12 月にピークに達し、4月に大幅に減少する場合があります。この傾向は来年も繰り返されます。つまり、この例の季節の長さは 12 か月です。 + + * **予測期間** - データを予測する**日、月、または年**を選択します。期間の長さの時間単位は、[日付] フィールドが日、月、または年のいずれで測定されるかに基づいて決定されます。 + +:::note +**時系列関数で使用可能な最小データ**: 表示形式には 2 つの季節以上のデータが含まれている必要があります。含まれていない場合、時系列関数を使用できません。つまり、季節の期間が 12 か月の場合は少なくとも 24 か月、6 か月の場合は 12 か月以上のデータが必要です。 +::: + +予測は線とその周りの網掛け領域で可視化されます。線は予測を表示し、**網掛け領域**は将来のデータセットが入ると予想される範囲を示します。 + +時系列関数を適用した後に**表示形式の基になるデータ**を確認すると、予測値が黄色で強調表示されます (以下を参照)。 + +![Underlying data in table format with highlighted forecasted data](images/underlying-data-time-series.png) + +:::note +**時系列関数は時系列のチャートでのみ使用できます。**: 表示形式に日付フィールドが含まれていない場合、時系列関数を使用しようとするとエラーが表示されます。 +::: + +### 線形回帰 + +線形回帰は、2 つの変数間の関係を線形方程式で示すための統計モデルです。回帰分析の結果、表示形式の上に折れ線グラフが作成され、**進行中の傾向を評価します**。線はデータセット内のほとんどのポイントに近づくように計算され、データの全体形状に適合します。 + +**線形回帰**関数では、**選択した期間のデータの線形予測**を含めることもできます。**[統計関数]** メニューから **[線形回帰]** 関数を選択すると、以下のダイアログが表示されます。 + +![Forecast settings dialog for the Linear regression function](images/linear-regression-dialog.png) + +**予測期間**には、データを予測する**日、月、または年**を選択します。期間の長さの時間単位は、**日付**フィールドが日、月、または年のいずれで測定されるかに基づいて決定されます。 + +以下は、**線形回帰**関数を表示形式に適用します。この場合、観測された傾向に基づいた予測を示すために線が 6 か月間延長されます。 + +![Linear regression with a forecast for 6 months](images/linear-regression-example.png) + +上記の表示形式で描画される線は、売上 (Y 軸に配置された変数) の変化が時間 (または X 軸に配置された他の変数) に起因する範囲を示します。売上データと時間データの間の線形関係が折れ線を決定します。これにより、売上が徐々に低下する傾向がより明確になります。 + +線形回帰を適用した後に**表示形式の基本データ**を確認すると、[時系列予測](#時系列予測)の最後のスクリーンショットに示すように、予測値が黄色で強調表示されます。 + +### 外れ値の検出 + +外れ値は、データの他の観測値から逸脱する極値です。**外れ値の検出**関数は、データ シリーズの残りのポイントの平均値から大幅に逸脱されたポイントを表示します。 + +![Outlier detection applied](images/outlier-detection-example.png) + +上記の例では、検出されたデータ ポイントは分配の残りの部分から離れて位置し、特定の瞬間に売上の急上昇を示します。これは、売上の全体的なパターンとは大幅に異なります。 + +外れ値の検出関数を適用した後に**表示形式の基になるデータ**を確認すると、外れ値として検出されたデータが黄色で強調表示されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-candlestick.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-candlestick.md new file mode 100644 index 00000000..b72399f1 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-candlestick.md @@ -0,0 +1,87 @@ +--- +title: Reveal でローソク足の表示形式を作成する方法 +_description: データのローソク足チャートの表示形式を作成する方法を説明します。 +_language: ja +--- + +## ローソク足表示形式を作成 + +このチュートリアルは、サンプル スプレッドシートを使用して**ローソク足**の表示形式を作成する方法を説明します。 + +![A sample with different candlestick charts](images/different-candlestick-charts.png) + +## 重要なコンセプト + +[OHLC](tutorials-ohlc.md) チャートとローソク足チャートは各財務データの始値、高値、安値、終値を表します。財務シナリオと株の変動の分析のために役立ちます。このチャートは各垂直軸に**始値**および**終値**を表す 2 つの水平線で数値を垂直軸に表します。 + +そのため、ローソク足チャートには以下の項目が必要になります。 + + - **通常日付に関連する日付エディターの **[ラベル]** プレースホルダーにドロップする 1 つのフィールド。 + + - *Open*、*High*、*Low* および *Close* の **4 つの異なるフィールド** データ エディターのカテゴリ。 + +![Candlestick chart visualization settings](images/candlestick-visualization-editor-example.png) + +チャートに追加情報を表示するためのオプションが複数あります。 + + - **軸の構成**: 軸の構成でチャートの最大値と最小値を構成できます。デフォルトで最小値は 0 に設定され、最大値は使用されるデータによって設定されます。 + + - **対数軸構成**: [対数] ボックスをチェックする場合、値のスケールは通常のリニア スケールを使用する代わりに大きさを使用するリニア スケール以外で計算されます。 + +## サンプル データ ソース + +このチュートリアルでは、Reveal Visualization Tutorials の「OHLC and Candlestick」シートを使用します。 + +## ローソク足チャートを作成する方法 + +1. オーバーフロー メニューで **[編集]** を選択します。 + + ![Edit button in overflow menu](images/overflow-edit-option.png) + +2. 右上隅にある **[+ 表示形式]** ボタンを選択します。 + + ![Add new visualization button](images/add-visualization-button.png) + +3. データ ソースのリストからデータ ソースを選択します。 + + ![Selecting the data source from the list of data sources](images/visualization-tutorials-sample.png) + +4. **OHLC and Candlestick** シートを選択します。 + + ![Selecting the OHLC and Candlesticks spreadsheet](images/ohlc-candlestick-spreadsheet.png) + +5. **表示形式ピッカー**を開き、**ローソク足**の表示形式を選択します。デフォルトで、表示形式のタイプは**柱状**に設定されています。 + + ![List of chart types](images/candlestick-chart-types.png) + +6. *Date* フィールドを **[ラベル]** にドラッグアンドドロップし、*Open*、*High*、*Low* および *Close* フィールドを対応するプレースホルダーにドラッグアンドドロップします。 + + ![Organizing data fields](images/candlestick-organizing-data.png) + +## 軸の構成の変更 + +[ゲージの範囲](tutorials-gauge.md#ゲージの化でしきい値を追加する方法)と同様に、チャート軸構成でチャート (範囲) の最小値と最大値を設定できます。この機能を使用して、特定のデータ含有や除外ができます。 + +以下は軸構成のメニューへアクセスするための手順です。 + +| | | | +| ------------------------------------------- | --------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | +| 1\. **設定メニューにアクセスする** | Navigating to Settings | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **軸範囲セクションに移動する** | Navigating to Axis Bounds | 変更する設定は **[軸範囲]** です。 | + +最大値または最小値 (または両方) のどれを設定するかに基づいて、以下のオプションの 1 つへアクセスする必要があります。 + +### 最小境界値を変更します。 + +デフォルト値は「自動」に設定されています。境界値を変更する場合は、チャートの開始値を入力してください。 + +### 最大境界値を変更します。 + +最大境界値の場合、Reveal が元のデータを使用するためにデフォルトの値は **[自動]** に設定されます。別の値を設定するには、チャートの上限値を入力します。 + +## 軸を対数軸として設定 + +| | | | +| -------------------------------------- | ------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------- | +| 1\. **設定メニューにアクセスする** | Navigating to Settings | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **軸を対数に変更する** | Accessing Axis configuration | **[軸]** ドロップダウンを開き、**[対数]** を選択します。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-gauge.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-gauge.md new file mode 100644 index 00000000..cbba21bc --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-gauge.md @@ -0,0 +1,157 @@ +--- +title: Reveal でゲージで表示形式を作成する方法 +_description: ンプルス プレッドシートを使用してゲージ チャートの表示形式を作成する方法を説明します。 +_language: ja +--- + +# ゲージで表示形式を作成する方法 + +このチュートリアルは、サンプル スプレッドシートを使用して**ゲージ**の表示形式を作成する方法を説明します。 + +![Different Gauge Visualizations](images/different-gauge-visualizations.png) + +## 重要なコンセプト + +ゲージ チャートは、2 つのレイアウトから選択できます。 + + - **しきい値の構成**。ゲージのしきい値の構成ではゲージの最大値と最小値を設定できます。デフォルトで最小値に設定されますが、特定のデータを除外するために変更できます。 + + - **バンド構成**。バンドの構成は 3 つの範囲を設定できます (より大きい、中間、より小さい) です。データ ソースに基づく範囲でデフォルトの値を上書きします。 + +## サンプル データ ソース + +このチュートリアルでは、Reveal Visualization Tutorials の「Gauge Views」シートを使用します。 + +## リニア ゲージを作成する方法 + +1. オーバーフロー メニューで **[編集]** を選択します。 + + ![Edit button in overflow menu](images/overflow-edit-option.png) + +2. 右上隅にある **[+ 表示形式]** ボタンを選択します。 + + ![Add new visualization button](images/add-visualization-button.png) + +3. データ ソースのリストからデータ ソースを選択します。 + + ![Selecting the data source from the list of data sources](images/visualization-tutorials-sample.png) + +4. **Gauge Views** シートを選択します。 + + ![Selecting Gauge Views spreadsheet](images/gauge-views.png) + +5. **表示形式ピッカー**を開き、**リニア**表示形式を選択します。デフォルトで、表示形式のタイプは**柱状**に設定されています。 + + ![List of chart types](images/gauges-linear-chart-types.png) + +6. たとえば、このリニア ゲージは国別で平均寿命を表します。*Country Name* フィールドを **[ラベル]** へ、年フィールドの 1 つを **[値]** へドラッグアンドドロップします。 + + ![Tutorials-LinearGauge-Data](images/organizing-data-gauge-visualization.png) + +## 円形ゲージを作成する方法 + +1. オーバーフロー メニューで **[編集]** を選択します。 + + ![Edit button in overflow menu](images/overflow-edit-option.png) + +2. 右上隅にある **[+ 表示形式]** ボタンを選択します。 + + ![Add new visualization button](images/add-visualization-button.png) + +3. データ ソースのリストからデータ ソースを選択します。 + + ![Selecting the data source from the list of data sources](images/visualization-tutorials-sample.png) + +4. **Gauge Views** シートを選択します。 + + ![Selecting Gauge Views spreadsheet](images/gauge-views.png) + +5. **表示形式ピッカー**を開き、**円型**表示形式を選択します。デフォルトで、表示形式のタイプは**柱状**に設定されています。 + + ![List of chart types](images/gauges-circular-chart-types.png) + +6. たとえば、このリニア ゲージは国別で平均寿命を表します。*Country Name* フィールドを **[ラベル]** へ、年フィールドの 1 つを **[値]** へドラッグアンドドロップします。 + + ![Tutorials-LinearGauge-Data](images/organizing-data-circular-gauge-visualization.png) + + +円形ゲージは、特に平均値と値の合計の表示に適しています。[値] に表示されるフィールドの集計を変更する手順: + +| | | | +| -------------------------------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | +| 1\. **[値] のフィールド設定にアクセスする** | ![Add-Data-Filter-CircularGauge](images/value-circular-gauge.png) | **[値]** のフィールドを選択してアクセスします。 | +| 2\. **別の集計を選択する** | ![CircularGauge-Aggregation](images/field-settings-aggregation-options.png) | **[集計]** のドロップダウンを展開し、別のオプションを選択します (平均値など)。 | + + +## テキスト ゲージを作成する方法 + +1. オーバーフロー メニューで **[編集]** を選択します。 + + ![Edit button in overflow menu](images/overflow-edit-option.png) + +2. 右上隅にある **[+ 表示形式]** ボタンを選択します。 + + ![Add new visualization button](images/add-visualization-button.png) + +3. データ ソースのリストからデータ ソースを選択します。 + + ![Selecting the data source from the list of data sources](images/visualization-tutorials-sample.png) + +4. **Gauge Views** シートを選択します。 + + ![Selecting Gauge Views spreadsheet](images/gauge-views.png) + +5. **表示形式ピッカー**を開き、**テキスト**の表示形式を選択します。デフォルトで、表示形式のタイプは**柱状**に設定されています。 + + ![List of chart types](images/gauges-text-chart-types.png) + +6. 例えば、このテキスト ゲージは国別平均寿命を表します。年フィールドの 1 つを **[値]** にドラッグアンドドロップし、*Country Name* フィールドを **[データ フィルター]** にドラッグアンドドロップします。次に、フィールドを選択して、必要な特定の国を選択します。 + + ![Organizing the data while using text gauge visualizaiton](images/text-gauge-organizing-data.png) + +上記の [テキスト ゲージのサンプル] は平均値の集計を使用します。 + +## ブレット グラフを作成する方法 + +1. オーバーフロー メニューで **[編集]** を選択します。 + + ![Edit button in overflow menu](images/overflow-edit-option.png) + +2. 右上隅にある **[+ 表示形式]** ボタンを選択します。 + + ![Add new visualization button](images/add-visualization-button.png) + +3. データ ソースのリストからデータ ソースを選択します。 + + ![Selecting the data source from the list of data sources](images/visualization-tutorials-sample.png) + +4. **Gauge Views** シートを選択します。 + + ![Selecting Gauge Views spreadsheet](images/gauge-views.png) + +5. **表示形式ピッカー**を開き、**ブレット グラフ**を選択します。デフォルトで、表示形式のタイプは**柱状**に設定されています。 + + ![List of chart types](images/gauges-bullet-graph-chart-types.png) + +6. 例えば、このブレット グラフ は国別平均寿命を表します。*Country Name* フィールドを **[ラベル]** へ、年フィールドの 1 つを **[値]** へ、別の年フィールドを **[ターゲット]** へドラッグアンドドロップします。 + + ![Organizing data while using a bullet graph](images/bullet-graph-organizing-data.png) + +## ゲージの化でしきい値を追加する方法 + +しきい値を使用すると、ゲージの最小値と最大値を設定できます。[重要なコンセプト](#重要なコンセプト)で述べたように、特定のデータを除外するように変更できます。以下は作業手順です。 + +| | | | +| ---------------------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | +| 1\. **設定を変更する** | ![Tutorials-Navigate-Settings](images/tutorials-settings.png) | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **制限のデフォルトの選択を変更する** | ![Tutorials-Limits-Bounds](images/limit-options.png) | 最大値または最小値 (または両方) 値を設定するかどうかに基づいて、チャートの開始値または終了値を入力します。 | + +## バンドの色の変更 + +以下は、バンド ([より大きい]、[中間] および [より小さい]) の色を変更するための手順です。 + +| | | | +| ---------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------ | +| 1\. **設定を変更する** | ![Tutorials-Navigate-Settings](images/tutorials-settings.png) | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **色のドロップダウンを表示する** | ![Tutorials-Colors-Dropdown](images/band-color-options.png) | 色を変更する範囲のドロップダウンを展開します。バンドの色として、Reveal の 3 つの事前定義された色のいずれかを選択します。| + diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-image.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-image.md new file mode 100644 index 00000000..18f74a9b --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-image.md @@ -0,0 +1,47 @@ +--- +title: Reveal で画像チャートを作成する方法 +_description: サンプルス プレッドシートを使用して画像チャートの表示形式を作成する方法を説明します。 +_language: ja +--- + +# 画像チャートを作成する方法 + +このチュートリアルでは、サンプル スプレッドシートを使用して**画像**の表示形式を作成する方法を説明します。 + +![A sample showing different image chart visualizations in one dashboard](images/image-chart-sample.png) + +## 重要なコンセプト + +[表示形式] セクションに述べたように、画像チャートは URL へ要求を送信して、埋め込みのブラウザーで結果を表示します。したがって、データ ソースに以下の項目が必要です: + + - ウィジェットに表示されるウェブ リソースへのリンク。 + + - リンクを**データセットの最初の行**に含みます。 + +## サンプル データ ソース + +このチュートリアルでは、Reveal Visualization Tutorials の「Image Chart」シートを使用します。 + + 1. オーバーフロー メニューで **[編集]** を選択します。 + + ![Edit button in overflow menu](images/overflow-edit-option.png) + + 2. 右上隅にある **[+ 表示形式]** ボタンを選択します。 + + ![Add new visualization button](images/add-visualization-button.png) + + 3. データ ソースのリストからデータ ソースを選択します。 + + ![Tutorials-Select-Data-Source](images/select-your-data-source.png) + + 4. データ ソースを設定したら、*Image View* シートを選択します。 + + ![Tutorials-Select-Image-View-Spreadsheet](images/select-image-view.png) + + 5. デフォルトで、表示形式のタイプは**柱状**に設定されています。**[画像]** オプションを選択します。 + + ![Tutorial-Image-View-Select](images/image-chart-type.png) + + 6. 使用可能なフィールドのいずれかを **[URL]** にドラッグします。 + + ![Tutorials-ImageView-Organizing-Data](images/image-chart-data-organization.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-kpi-gauge.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-kpi-gauge.md new file mode 100644 index 00000000..9f09e0a9 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-kpi-gauge.md @@ -0,0 +1,105 @@ +--- +title: Reveal で KPI ゲージ チャートを作成する方法 +_description: サンプルス プレッドシートを使用して KPI ゲージの表示形式を作成する方法を説明します。 +_language: ja +--- + +# KPI ゲージを作成 + +このチュートリアルでは、サンプル スプレッドシートを使用して KPI ゲージの表示形式を作成する方法を説明します。 + +| | | +|:---:|:---:| +| ![KPIGaugeSimple All](images/KPIGaugeSimple_All.png)
[KPI ゲージ](#kpi-ゲージの作成) | ![TutorialMultipleKPIGauges All](images/TutorialMultipleKPIGauges_All.png)
[複数の KPI ゲージ](#1-つの表示形式で複数の-kpi-ゲージを作成する方法) | +| ![KPIGaugePreviousMonth All](images/KPIGaugePreviousMonth_All.png)
[月ごとの KPI ゲージ](#日付比較タイプの変更) | ![KPIGaugeValuePercentage All](images/KPIGaugeValuePercentage_All.png)
[値とパーセンテージの違いがある KPI ゲージ](#kpi-ゲージの差分ラベルの変更) | +| ![KPIGaugeDifferenceColor All](images/KPIGaugeDifferenceColor_All.png)
[値が減少したときに緑色のマーカーが付いた KPI ゲージ](#差分マーカーの色の変更) | | + +## 重要なコンセプト + +KPI ゲージは、特定の期間内のパフォーマンスとその変動を表示するためのものです。作成するには、次のものが必要です: + + - データエディターの **[日付]** プレースホルダーにドロップする **1 つのフィールド**。 + + - **[値]** にドロップする **1 つのフィールド**。 + +## サンプル データ ソース + +このチュートリアルでは、Reveal Visualization Tutorials の「KPI View」シートを使用します。 + +## KPI ゲージの作成 + +1. オーバーフロー メニューで **[編集]** を選択します。 + + ![Edit button in overflow menu](images/overflow-edit-option.png) + +2. 右上隅にある **[+ 表示形式]** ボタンを選択します。 + + ![Add new visualization button](images/add-visualization-button.png) + +3. データ ソースのリストからデータ ソースを選択します。 + + ![Selecting the data source from the list of data sources](images/visualization-tutorials-sample.png) + +4. **KPI View** シートを選択します。 + + ![Selecting a KPI Gauge](images/Tutorials-Select-KPI-Gauge-Spreadsheet.png) + +5. **表示形式ピッカー**を開き、**KPI vs Time** を選択します。デフォルトで、表示形式のタイプは**柱状**に設定されています。 + + ![Select Change Visualization option](images/gauge-kpi-chart-type.png) + +6. *Date* フィールドを [日付] に、*Sales* フィールドを [値] に、*State* フィールドを [カテゴリ] にドラッグアンドドロップします。 + + ![Select KPI Gauge](images/Tutorials-KPIGauge-Organizing-Data.png) + +## 1 つの表示形式で複数の KPI ゲージを作成する方法 + +1 つの表示形式で複数の KPI を作成するには、データ エディターの**カテゴリ** プレースホルダーにフィールドを追加する必要があります。 + +1. オーバーフロー メニューで **[編集]** を選択します。 + + ![Edit button in overflow menu](images/overflow-edit-option.png) + +2. 右上隅にある **[+ 表示形式]** ボタンを選択します。 + + ![Add new visualization button](images/add-visualization-button.png) + +3. データ ソースのリストからデータ ソースを選択します。 + + ![Selecting the data source from the list of data sources](images/visualization-tutorials-sample.png) + +4. **KPI View** シートを選択します。 + + ![Selecting a KPI Gauge](images/Tutorials-Select-KPI-Gauge-Spreadsheet.png) + +5. **表示形式ピッカー**を開き、**KPI vs Time** を選択します。デフォルトで、表示形式のタイプは**柱状**に設定されています。 + + ![Select Change Visualization option](images/gauge-kpi-chart-type.png) + +6. *Date* フィールドを [日付] に、*Sales* フィールドを [値] に、*State* フィールドを [カテゴリ] にドラッグアンドドロップします。 + ![Tutorials-MultipleKPIGauge-Organizing-Data](images/Tutorials-MultipleKPIGauge-Organizing-Data.png) + +## 日付比較タイプの変更 + +デフォルトでは、KPI ゲージの日付タイプは前年比になります。[タイプ] フィールドを変更することでこれを変更できます。以下は変更手順です。 + +| | | | +| -------------------------------- | ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | +| 1\. **設定メニューにアクセスする** | ![Tutorials-Navigate-Settings](images/Tutorials-Navigate-Settings.png) | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **タイプを変更する** | ![Tutorial-Change-Date-Type](images/Tutorial-Change-Date-Type.png) | デフォルトでは、日付のタイプは **[今年と前年]** に設定されます。**[期間]** の横にあるドロップダウンを選択し、選択を **[今月と先月]** に変更します。 | + +## KPI ゲージの差分ラベルの変更 + +| | | | +| -------------------------------- | ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1\. **設定メニューにアクセスする** | ![Tutorials-Navigate-Settings](images/Tutorials-Navigate-Settings.png) | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **タイプを変更する** | ![Tutorial-Change-Date-Difference-Label](images/Tutorial-Change-Date-Difference-Label.png) | デフォルトで、差分ラベルは**パーセンテージ**に設定されています。 **[差異の表示]** の横のドロップダウンを選択し、選択を **[値とパーセンテージ]** に変更します。 | + +## 差分マーカーの色の変更 + +デフォルトでは、KPI ゲージのマーカーの色は、正の値の場合は緑、負の値の場合は赤に設定されます。ただし、減少をプラスとして表現したい場合もあります。以下は設定方法です。 + +| | | | +| -------------------------------- | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1\. **設定メニューにアクセスする** | ![Tutorials-Navigate-Settings](images/Tutorials-Navigate-Settings.png) | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **タイプを変更する** | ![Tutorial-Change-Date-Difference-Marker-Color](images/Tutorial-Change-Date-Difference-Marker-Color.png) | デフォルトでは、マーカーの色は緑に設定されます。**[値の増加を表す色]** の横のドロップダウンを選択し、選択を **[赤色]** に変更します。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-ohlc.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-ohlc.md new file mode 100644 index 00000000..0c743685 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-ohlc.md @@ -0,0 +1,88 @@ +--- +title: Reveal で OHLC の表示形式を作成する方法 +_description: サンプルス プレッドシートを使用して OHLC の表示形式を作成する方法を説明します。 +_language: ja +--- + +# OHLC チャートを作成する方法 + +このチュートリアルは、サンプル スプレッドシートを使用して OHLC チャートを作成する方法を説明します。 + +![Tutorials-Select-OHLC-tutorials-candlesticks-Spreadsheet](images/ohlc-charts-example.png) + + +## 重要なコンセプト + +OHLC チャートとローソク足チャートは各財務データの始値、高値、安値、終値を表します。財務シナリオと株の変動の分析のために役立ちます。このチャートは各垂直軸に**始値**および**終値**を表す 2 つの水平線で数値を垂直軸に表します。 + +そのため、OHLC チャートには以下の項目が必要になります。 + + - 通常日付に関連する日付エディターの **[ラベル]** プレースホルダーにドロップする 1 つのフィールド。 + + - データ エディターの [始値]、[高値]、[安値]、および [終値] カテゴリの **4 つの異なるフィールド**。 + +![OHLCChartVisualizationSettings\_All](images/ohlc-visualization-editor.png) + +チャートに追加情報を表示するためのオプションが複数あります。 + + - **軸の構成**: 軸の構成でチャートの最大値と最小値を構成できます。デフォルトで最小値は 0 に設定され、最大値は使用されるデータによって設定されます。 + + - **対数軸構成**: [対数] ボックスをチェックする場合、値のスケールは通常のリニア スケールを使用する代わりに大きさを使用するリニア スケール以外で計算されます。 + +## サンプル データ ソース + +このチュートリアルでは、Reveal Visualization Tutorials の「OHLC and Candlestick」シートを使用します。 + +## OHLC チャートを作成する方法 + +1. オーバーフロー メニューで **[編集]** を選択します。 + + ![Edit button in overflow menu](images/overflow-edit-option.png) + + 2. 右上隅にある **[+ 表示形式]** ボタンを選択します。 + + ![Add new visualization button](images/add-visualization-button.png) + + 3. データ ソースのリストからデータ ソースを選択します。 + + ![Tutorials-Select-Data-Source](images/visualization-tutorials-sample.png) + + 4. データ ソースを設定したら、**OHLC and Candlestick** シートを選択します。 + + ![Tutorials-Select-OHLC-tutorials-candlesticks-Spreadsheet](images/ohlc-candlestick-spreadsheet.png) + + 5. **表示形式ピッカー**を開き、**OHLC** を選択します。デフォルトで、表示形式のタイプは**柱状**に設定されています。 + + ![Tutorials-Select-Change-Visualization](images/ohlc-chart-types.png) + + 6. *Day* フィールドを **[ラベル]** にドラッグアンドドロップし、*Open*、*High*、*Low* および *Close* フィールドを対応するプレースホルダーにドラッグアンドドロップします。 + + ![Organizing the data from the data source](images/ohlc-organizing-data.png) + +## 軸の構成の変更 + +[ゲージの範囲](tutorials-gauge.md#ゲージの化でしきい値を追加する方法)と同様に、チャート軸構成でチャート (範囲) の最小値と最大値を設定できます。この機能を使用して、特定のデータ含有や除外ができます。 + +以下は軸構成のメニューへアクセスするための手順です。 + +| | | | +| ------------------------------------------- | ------------------------------------------------------------------------------------ | ----------------------------------------------------------- | +| 1\. **設定メニューにアクセスする** | ![Tutorials-Navigate-Settings](images/tutorials-settings.png) | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **軸範囲セクションに移動する** | ![Tutorial-Access-Axis-Configuration](images/bounds-axis.png) | 変更する設定は**軸範囲**です。 | + +最大値または最小値 (または両方) のどれを設定するかに基づいて、以下のオプションの 1 つへアクセスする必要があります。 + +### 最小境界値を変更します。 + +デフォルトの値は *0* です。境界値を変更する場合は、チャートの開始値を入力してください。 + +### 最大境界値を変更します。 + +最大境界値の場合、Reveal が元のデータを使用するためにデフォルトの値は **[自動]** に設定されます。別の値を設定するには、チャートの上限値を入力します。 + +## 軸を対数軸として設定 + +| | | | +| -------------------------------------- | ----------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | +| 1\. **設定メニューにアクセスする** | ![Tutorials-Navigate-Settings](images/tutorials-settings.png) | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **軸を対数に変更する** | ![Tutorial-Access-OHLC-Axis-Configuration](images/ohlc-candlestick-logarithmic-axis.png) | **[軸]** ドロップダウンを開き、**[対数]** を選択します。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-overview.md new file mode 100644 index 00000000..1df29997 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-overview.md @@ -0,0 +1,11 @@ +# 表示形式のチュートリアル + +このセクションでは、Reveal の表示形式の作成手順を説明します。すべてのセクションで、このリンクを使用してダウンロードできる Data Visualizations データ ソースを使用しています。 + +| | | | | | +|:-:|:-:|:-:|:-:|:-:| +| ![Area Chart](images/area-chart-icon.png)
[エリア](tutorials-simple-charts.md) | ![Bar Chart](images/bar-chart-icon.png)
[棒](tutorials-simple-charts.md) | ![Bullet Graph Gauge](images/bullet-graph-icon.png)
[ブレット グラフ](tutorials-gauge.md#ブレット-グラフを作成する方法) | ![Candlestick Chart](images/candlestick-chart-icon.png)
[ロウソク足](tutorials-candlestick.md) | ![Circular Gauge](images/circular-gauge-icon.png)
[円型](tutorials-gauge.md#円形ゲージを作成する方法) | +| ![Column Chart](images/column-chart-icon.png)
[柱状](tutorials-simple-charts.md) | ![Doughnut Chart](images/doughnut-chart-icon.png)
[ドーナツ型](tutorials-simple-charts.md) | ![Funnel Chart](images/funnel-chart-icon.png)
[ファンネル](tutorials-simple-charts.md) | ![Web View](images/image-view-icon.png)
[画像](tutorials-image.md) | ![kpi](images/kpi-icon.png)
[KPI](tutorials-kpi-gauge.md) | +| ![Line Chart](images/line-chart-icon.png)
[折れ線](tutorials-simple-charts.md) | ![Linear Gauge](images/linear-gauge-icon.png)
[リニア](tutorials-gauge.md#リニア-ゲージを作成する方法) | ![OHLC Chart](images/ohlc-chart-icon.png)
[OHLC](tutorials-ohlc.md) | ![Pie Chart](images/pie-chart-icon.png)
[円](tutorials-simple-charts.md) | ![Circular Chart](images/radial-chart-icon.png)
[ラジアル](tutorials-simple-charts.md) | +| ![Sparkline Chart](images/sparkline-chart-icon.png)
[スパークライン](tutorials-sparkline-charts.md) | ![Spline Chart](images/spline-chart-icon.png)
[スプライン](tutorials-simple-charts.md) | ![Spline Area](images/spline-area-icon.png)
[スプライン エリア](tutorials-simple-charts.md) | ![Stacked Area Chart](images/stacked-area-chart-icon.png)
[積層型エリア](tutorials-stacked-charts.md) | ![Stacked Bar Chart](images/stacked-bar-chart-icon.png)
[積層型棒](tutorials-stacked-charts.md) | +| ![Stacked Column Chart](images/stacked-column-chart-icon.png)
[積層型柱状](tutorials-stacked-charts.md) | ![Step Area Chart](images/step-area-chart-icon.png)
[ステップ エリア](tutorials-simple-charts.md) | ![Step Line Chart](images/step-line-chart-icon.png)
[ステップ折れ線](tutorials-simple-charts.md) | ![Text Gauge](images/text-gauge-icon.png)
[テキスト](tutorials-gauge.md#テキスト-ゲージを作成する方法) | ![Text View](images/text-view-icon.png)
[テキスト ビュー](tutorials-text-view.md) | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-simple-charts.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-simple-charts.md new file mode 100644 index 00000000..72214b06 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-simple-charts.md @@ -0,0 +1,99 @@ +--- +title: Reveal でシンプル シリーズ チャートの表示形式を作成する方法 +_description: サンプルス プレッドシートを使用してシンプル シリーズの表示形式を作成する方法を説明します。 +_language: ja +--- + +# シンプル シリーズ チャートを作成する方法 + +このチュートリアルは、サンプル スプレッドシートを使用して**シンプル シリーズ** チャートの表示形式を作成する方法を説明します。 + +![Visualizations made by using simple series charts](images/simple-series-charts-example.png) + +![Visualizations made by using another set of simple series charts](images/simple-series-charts-example2.png) + +![Another set of visualizations made with different chart](images/simple-series-charts-example3.png) + +## 重要なコンセプト + +チャートを使用する時、表示される情報とともに追加の情報も追加できます。これは以下の機能で追加できます。 + + - チャートに折れ線で表示する**チャート近似曲線**。変数間の関係や情報全体の方向性を表す場合に役立ちます。チャートに回帰と呼ばれるいくつかのアルゴリズムを適用できます。回帰は **[チャートの近似曲線]** から選択できます。 + + - **軸の構成**: 軸の構成でチャートの最大値と最小値を構成できます。デフォルトで最小値は 0 に設定され、最大値は使用されるデータによって設定されます。 + + - **対数軸構成**: [対数] ボックスをチェックする場合、値のスケールは通常のリニア スケールを使用する代わりに大きさを使用するリニア スケール以外で計算されます。 + + - **開始位置**: 円チャートおよびドーナツ型チャートでチャートのスライスを回転する開始位置を構成し、データの表示順序を変更できます。 + + - **スライス ラベル**: ドーナツ型、ファンネル、および円チャートでは、値やパーセンテージ、またはその両方を同時に表示するスライス ラベルを構成できます。 + +## サンプル データ ソース + +このチュートリアルでは、Reveal Visualization Tutorials の「Simple Series Charts」シートを使用します。 + +## チャートの作成 + +1. オーバーフロー メニューで **[編集]** を選択します。 + + ![Edit button in overflow menu](images/overflow-edit-option.png) + +2. 右上隅にある **[+ 表示形式]** ボタンを選択します。 + + ![Add new visualization button](images/add-visualization-button.png) + +3. データ ソースのリストからデータ ソースを選択します。 + + ![Selecting the data source from the list of data sources](images/visualization-tutorials-sample.png) + +4. **Simple Series Charts** シートを選択します。 + + ![Selecting Simple Series Chart sheet](images/simple-series-charts-spreadsheet.png) + +5. **表示形式ピッカー**を開き、**カテゴリ**の下にある**チャート**表示形式のいずれかを選択します。デフォルトで、表示形式のタイプは**柱状**に設定されています。 + + ![List of chart types](images/chart-types-simple-series-charts.png) + +6. たとえば、上の表のチャートには、選択した国のリストの人口が表示されます。*Country Name* フィールドを **[ラベル]** へ、*Population* フィールドを **[値]** へドラッグアンドドロップします。 + + ![Organizing the data from the Simple Series Charts sheet](images/simple-series-charts-organizing-data.png) + +## チャートに近似曲線を追加する + +情報全体の方向性またチャートの変数の関係を表すためにチャート 近似曲線を追加できます。以下は作業手順です。 + +| | | | +| ----------------------------------- | ---------------------------------------------------------------------- | ---------------------------------------------------------------- | +| 1\. **設定を変更する** | ![Tutorials-Navigate-Settings](images/settings-tutorials.png) | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **チャートの近似曲線にアクセスする** | ![Chart Trendlines option in the settings](images/chart-trendline-simple-series-charts.png) | 下向き矢印を選択して [チャートの近似曲線] ドロップダウンを展開し、Reveal の定義済み近似曲線のいずれかを選択します。 | + +## 軸の構成の変更 + +[ゲージの範囲](tutorials-gauge.md#ゲージの化でしきい値を追加する方法)と同様に、チャート軸構成でチャートの最小と最大値を設定できます。この機能を使用して、特定のデータ含有や除外ができます。 + +| | | | +| -------------------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | +| 1\. **設定を変更する** | ![Tutorials-Navigate-Settings](images/settings-tutorials.png) | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **範囲の設定にアクセスする** | ![Axis bounds in the settings options](images/axis-bounds-section.png) | [軸範囲] に移動します。最大値または最小値 (または両方) 値を設定するかどうかに基づいて、チャートの開始値または終了値を入力します。 | + + +## 軸を対数軸として設定 + +| | | | +| ----------------------------------------- | ------------------------------------------------------------------------ | ----------------------------------------------------------- | +| 1\. **設定を変更する** | ![Tutorials-Navigate-Settings](images/settings-tutorials.png) | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **軸オプションにアクセスする** | ![Tutorials-Axis-Bounds](images/axis-logarithmic.png) | 下矢印を選択して [軸] ドロップダウンを展開し、[対数] を選択します。 | + +## ドーナツ型と円チャートの開始位置の変更 + +| | | | +| ------------------------------------------------- | ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------- | +| 1\. **設定を変更する** | ![Tutorials-Navigate-Settings](images/settings-tutorials.png) | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **開始位置セクションにアクセスする** | ![Start position settings](images/start-position-settings.png) | 下矢印を選択して、[開始位置] ドロップダウンを展開します。チャートに対して、Reveal の事前定義された開始位置 (0°、90°、180°、または 270°) のいずれかを選択します。 | + +## ドーナツ型、ファンネルと円チャートのスライスのラベルの変更 + +| | | | +| ---------------------------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | +| 1\. **設定を変更する** | ![Tutorials-Navigate-Settings](images/settings-tutorials.png) | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **スライス ラベルのセクションにアクセスする** | ![Tutorials-Slice-Label](images/slice-label-settings.png) | 下矢印を選択して、スライス ラベル ドロップダウンを展開します。Reveal の事前定義されたラベル付けオプション (パーセント、値、または値とパーセント) のいずれかを選択します。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-sparkline-charts.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-sparkline-charts.md new file mode 100644 index 00000000..bbf12b13 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-sparkline-charts.md @@ -0,0 +1,98 @@ +--- +title: Reveal でスパークライン チャートの表示形式を作成する方法 +_description: サンプル スプレッドシートを使用してスパークライン チャートの表示形式を作成する方法を説明します。 +_language: ja +--- + +# スパークライン チャートの作成 + +このチュートリアルは、サンプル スプレッドシートを使用してスパークライン チャートの表示形式を作成する方法を説明します。 + +![Simple Sparkline Chart example](images/simple-sparkline-chart.png) +![Sparkline Area Chart example](images/sparkline-area-chart.png) +![Sparkline with Day Aggregation example](images/sparkline-with-day-aggregation.png) +![Sparkline with less columns and area chart example](images/sparkline-with-less-columns-and-area-chart.png) + +## 重要なコンセプト + +スパークライン チャートは、指定した日付範囲のトレンドとその進行を表示します。OHLC チャートやローソク足チャートなど、ファイナンシャル シナリオと株の変動の分析のために役立ちます。スパークラインは、グリッドセル内に折れ線チャートを表示します。 + + - データ エディターの **[日付]** プレースホルダーにドロップする**フィールド**。 + + - **[値]** にドロップする**フィールド**。 + + - **[カテゴリ]** にドロップする**フィールド**。 + +スパークライン チャートを使用する時、表示するデータに対して情報を追加、変更または削除できます。これは以下の機能で追加できます。 + + - スパークラインの**チャート タイプ**は、**折れ線**または**エリア** チャートのいずれかを選択できます。 + + - チャートの日付**集計**。 + + - 同じチャート内に表示される**値の数**。 + + - データに**過去 2 か月を含めるかどうか、またそれらの差異など**、スパークラインのグリッドに含める明示的な情報。 + +:::note +スパークライン チャートには、デフォルトで過去 12 か月間の傾向とその進行状況が表示されます。[スパークライン チャートの日付範囲設定](#日付集計の変更)を使用して日付範囲を調整できます。 +::: + +## サンプル データ ソース + +このチュートリアルでは、Reveal Visualization Tutorials の「Sparkline Charts」シートを使用します。 + +## スパークライン チャートの作成 + + +1. オーバーフロー メニューで **[編集]** を選択します。 + + ![Edit button in overflow menu](images/overflow-edit-option.png) + +2. 右上隅にある **[+ 表示形式]** ボタンを選択します。 + + ![Add new visualization button](images/add-visualization-button.png) + +3. データ ソースのリストからデータ ソースを選択します。 + + ![Selecting the data source from the list of data sources](images/visualization-tutorials-sample.png) + +4. **Sparkline Charts** シートを選択します。 + + ![Tutorials-Select-Sparkline-Charts-Spreadsheet.png](images/sparkline-charts-spreadsheet.png) + +5. **表示形式ピッカー**を開き、**スパークライン チャート**を選択します。デフォルトで、表示形式のタイプは**柱状**に設定されています。 + + ![Tutorials-Charts-Select-Sparkline-Chart](images/chart-types-sparkline.png) + +6. *Date* フィールドを **[日付]** に、*Offer* フィールドを **[値]** に、*Stocks* を **[カテゴリ]** にドラッグアンドドロップします。 + + ![Tutorials-SparklineChart-Organizing-Data](images/sparkline-charts-organizing-data.png) + +## スパークラインのチャート タイプを変更する方法 + +スパークライン チャートに使用するチャートのタイプを変更できます。以下は作業手順です。 + +| | | | +| -------------------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------- | +| 1\. **設定メニューにアクセスする** | ![Setting options for sparkline charts](images/sparkline-charts-settings.png) | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **チャート タイプを変更する** | ![Different chart types for Sparkline](images/area-sparkline-chart.png) | デフォルトで、チャート タイプは [折れ線] に設定されています。[エリア] に設定します。 | + +## 日付集計の変更 + +デフォルトでは、情報の集計は **12 ヶ月**です。**[表示: 過去]** 設定で変更できます。以下は変更手順です。 + +| | | | +| -------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1\. **設定メニューにアクセスする** | ![Tutorials-Navigate-Settings](images/sparkline-charts-settings.png) | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **Change the Aggregation** | ![Tutorial-Change-Date-Aggregation-Sparkline](images/sparkline-chart-date-aggregation.png) | デフォルトで、[表示: 過去] 設定は **[月]** に設定されます。[月] の横のドロップダウンを選択し、[年] または [日] に変更します。 | + +日付の集計の隣にある数値を変更して、表示するデータを増減できます。 + +## スパークラインの列数を変更する方法 + +Reveal で、表示形式の列数は、過去 2 か月とそれらの差を表示するかどうかによって定義されます。デフォルトで有効になります。以下は削除方法です。 + +| | | | +| ------------------------------------ | ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1\. **設定メニューにアクセスする** | ![Tutorials-Navigate-Settings](images/sparkline-charts-settings.png) | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **Change the Displayed Columns** | ![Different options for the columns in the sparkline chart](images/sparkline-chart-columns-options.png) | どちらもスパークラインに表示しない場合は、**[最後の 2 つの値の列を表示] または [差異のある列を表示] ボックスをオフにします**。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-stacked-charts.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-stacked-charts.md new file mode 100644 index 00000000..547b134c --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-stacked-charts.md @@ -0,0 +1,77 @@ +--- +title: Reveal で積層型チャートの表示形式を作成する方法 +_description: サンプルス プレッドシートを使用して積層型チャートの表示形式を作成する方法を説明します。 +_language: ja +--- + +# 積層型チャートを作成する方法 + +このチュートリアルはサンプル スプレッドシートを使用し**積層型**チャートを作成する方法を説明します。 + +![Tutorials-Create-New-Dashboard](images/different-stacked-charts-example.png) + +## 重要なコンセプト + +積層型チャートは、3 つのレイアウトから選択できます - [エリア](#積層型チャートの作成)、[柱状](#積層型チャートの作成)および[棒](#積層型チャートの作成)。 + +以下の項目も設定できます。 + + - **軸の構成**: 軸の構成でチャートの最大値と最小値を構成できます。デフォルトで最小値は 0 に設定され、最大値は使用されるデータによって設定されます。 + + - **対数軸構成**: [対数] ボックスをチェックする場合、値のスケールは通常のリニア スケールを使用する代わりに大きさを使用するリニア スケール以外で計算されます。 + +## サンプル データ ソース + +このチュートリアルでは、Reveal Visualization Tutorials の *Stacked Charts* シートを使用します。 + + +## 積層型チャートの作成 + +1. オーバーフロー メニューで **[編集]** を選択します。 + + ![Edit button in overflow menu](images/overflow-edit-option.png) + +2. 右上隅にある **[+ 表示形式]** ボタンを選択します。 + + ![Add new visualization button](images/add-visualization-button.png) + +3. データ ソースのリストからデータ ソースを選択します。 + + ![Selecting the data source from the list of data sources](images/visualization-tutorials-sample.png) + +4. **Stacked Charts** シートを選択します。 + + ![Stacked Charts Spreadsheet in the tutorial data source](images/stacked-chart-spreadsheet-data-source-details-dialog.png) + +5. **表示形式ピッカー**を開き、**積層型**表示形式のいずれかを選択します。デフォルトで、表示形式のタイプは**柱状**に設定されています。 + + ![List of stacked chart types](images/stacked-chart-types.png) + +6. 積層型チャートでは、データ エディターの **[値]** プレースホルダーに 2 つ以上のフィールドをドラッグ アンド ドロップする必要があります。今の例で、*1960*、*2003*、*2008* と *2010* を **[値]** へ、*Country Name* を **[ラベル]** へドラッグアンドドロップします。 + + ![Organizing the data from the stacked charts spreadsheet](images/stacked-charts-organizing-data.png) + +## 軸の構成の変更 + +[ゲージの範囲](tutorials-gauge.md#ゲージの化でしきい値を追加する方法)と同様に、チャート軸構成でチャートの最小と最大値を設定できます。この機能を使用して、特定のデータ含有や除外ができます。 + +| | | | +| -------------------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | +| 1\. **設定を変更する** | ![Settings section](images/tutorials-settings.png) | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **範囲の設定にアクセスする** | ![Tutorials-Axis-Bounds](images/axis-bounds.png) | [軸範囲] に移動します。最大値または最小値 (または両方) 値を設定するかどうかに基づいて、チャートの開始値または終了値を入力します。 | + +## 軸を対数軸として設定 + +| | | | +| ----------------------------------------- | ------------------------------------------------------------------------ | ----------------------------------------------------------- | +| 1\. **設定を変更する** | ![Tutorials-Navigate-Settings](images/tutorials-settings.png) | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **軸のオプションにアクセスする** | ![Tutorials-Axis-Bounds](images/axis-bounds-logarithmic.png) | 下矢印を選択して、軸ドロップダウンを展開します。次に、[対数] を選択します。| + +## パーセンテージの配分を有効します。 + +積層型チャートにパーセンテージの配分も構成できます。このタイプのチャートに値とパーセンテージの配分スケールを切り替えます。以下は作業手順です。 + +| | | | +| -------------------------------------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | +| 1\. **設定を変更する** | ![Tutorials-Navigate-Settings](images/tutorials-settings.png) | 表示形式エディターの **[設定]** セクションに移動します。 | +| 2\. **パーセンテージの配分を有効にする** | ![Tutorials-Percentage-Distribution](images/percentage-distribution.png) | [パーセンテージの配分] ボックスをチェックして、パーセンテージの配分設定を有効にします。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-text-view.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-text-view.md new file mode 100644 index 00000000..6979c430 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/tutorials-text-view.md @@ -0,0 +1,69 @@ +--- +title: Reveal でテキスト ビューの表示形式を作成する方法 +_description: サンプルス プレッドシートを使用してテキスト ビューの表示形式を作成する方法を説明します。 +_language: ja +--- + +# テキスト ビューを作成する方法 + +このチュートリアルはサンプル スプレッドシートを使用し**テキスト ビュー**を作成する方法を説明します。 + +![Visualization sample using text view](images/text-view-sample.png) + +## 重要なコンセプト + +テキストビューではキーと値のパターンで情報が表示されますが、**列のラベルとペアになっているデータの最初の行のみが表示されます**。ただし、フィルターを追加して、必要な行が Reveal 表示されるようにすることができます。 + +## サンプル データ ソース + +このチュートリアルでは、Reveal Visualization Tutorials の「Simple Series Charts」シートを使用します。 + +## テキスト ビューを作成する方法 + + 1. オーバーフロー メニューで **[編集]** を選択します。 + + ![Edit button in overflow menu](images/overflow-edit-option.png) + +2. 右上隅にある **[+ 表示形式]** ボタンを選択します。 + + ![Add new visualization button](images/add-visualization-button.png) + +3. データ ソースのリストからデータ ソースを選択します。 + + ![Selecting the data source from the list of data sources](images/visualization-tutorials-sample.png) + +4. **Simple Series Charts** シートを選択します。 + + ![Simple Series Charts Spreadsheed in the data source ](images/tutorials-simple-series-charts-spreadsheet.png) + +5. **表示形式ピッカー**を開き、**テキスト ビュー**を選択します。デフォルトで、表示形式のタイプは**柱状**に設定されています。 + + ![Text View in the chart types list](images/text-view-chart-types.png) + +6. たとえば、上記のテキスト ビューには、特定の国の人口、平均余命および出生率が表示されます。*Country Name*、*Population*、*Life Expectancy*、*Fertility Rate* を [列] にドラッグアンドドロップします。 + + ![Organizing data in the data filter for text view](images/organizing-data-text-view.png) + + 以下は結果です。 + ![Text View Visualization](images/text-view-visualization.png) + +## 選択された行を変更する + +デフォルトで、テキスト ビューはシートの最初の行を表示されます。これを変更するためにフィルターを適用できます。たとえば、テキスト ビューに行 9 (ボスニア・ヘルツェゴビナ) を表示させます。 + +1. *Country Name* フィールドを **[データ フィルター]** にドラッグ アンド ドロップします。 + + ![Selecting an example for data filter for the text view](images/select-data-filter-text-view.png) + +2. [フィルター タイプ] を選択してドロップダウン メニューを有効にし、**[値の選択]** を選択します。 + + ![Select Value option from the list of filter types](images/data-filter-dialog-select-value-text-view.png) + +3. デフォルトでは、すべての値が選択済です。**[すべて]** ボックスのチェックを外し、**Bosnia and Herzegovina** のみを選択します。次に、**[フィルターの作成]** を選択します。 + + ![Choosing country from the list of selected values](images/data-filter-select-value-example.png) + + 更新されたデータが表示されます: + + ![Text View Filtered](images/filtered-text-view-visualization.png) + \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/visualization-editor.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/visualization-editor.md new file mode 100644 index 00000000..09f5a10c --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/visualization-editor.md @@ -0,0 +1,62 @@ +--- +title: 表示形式エディターの使用方法 +_description: 表示形式を作成および編集し、さまざまなオプションを使用する方法をご覧ください。 +_language: ja +--- + +# 表示形式エディター + +**表示形式エディター**は、Reveal で表示形式を作成および編集する場所です。ここでは、データセットからのデータが集約されて使用できるように準備されているほか、それを使用して構築するためのさまざまな表示形式が表示されます。 + +## 表示形式の作成方法 + +表示形式は、ダッシュボードの基本要素です。したがって、表示形式の作成を開始するときに、開始点には ２ つの選択肢があります。 + +* **新しいダッシュボードを作成する**ことから始めます。このダッシュボードでは、新しい表示形式が最初または唯一の表示形式になります。これを行うには、青い **[+ 表示形式]** ボタンをクリックまたはタップします。 + +* 既存のダッシュボードに**新しい表示形式を追加する**ことから始めます。これを行うには、右上隅のオーバーフロー ボタンを選択し、**[編集]** をクリックまたはタップして、**[+ 表示形式]** の青いボタンをクリックまたはタップします。 + +その後、新しいデータ ソースを追加するか、既存のデータ ソースを選択するように求められます。 + +![Dialog with a list of data sources](images/new-visualization-screen.png) + +データ ソースを選択して構成すると、[表示形式エディター](visualization-editor.md)に移動し、表示形式の作成を開始できます。 + +表示形式エディターは、データを使用して最も望ましいビューを作成するのに役立ちます。 + +## 表示形式エディターにアクセスする + +表示形式エディターには、次の 2 つの方法でアクセスできます。 + +**1. 表示形式作成プロセス** + +データ ソースを選択して設定すると、**表示形式エディター**が自動的に開きます。 + +**2. ダッシュボード編集プロセス** + +選択したダッシュボードを開き、**ダッシュボード編集**モードに入ると、表示形式のオーバーフロー ボタンから **[編集]** を選択して、**表示形式エディターにアクセス**できます。または、オーバーフロー メニューの横にある鉛筆アイコンをクリックまたはタップすることもできます。 + +## 表示形式エディターの概要 + +以下は、**エディター**のすべてのセクションとその機能のリストです。 + +![Sections of the Visualization editor](images/visualizations-editor-sections.png) + +1. **[データ] セクション** - このセクションには 2 つのパネルがあります。 + 1. **[フィールド]** - データ ソース内で使用可能なすべてのフィールドが左側のパネルに表示されます。各フィールドには、フィールド タイプ (**日付**、**値**、**テキスト**) をユーザーに通知するインジケーターがあります。使用可能なフィールドが 10 を超えると、検索バーが表示されます。このパネルの **[+]** アイコンを使用すると、データ ソースをブレンドするか、フィールドを計算することができます。**脳**アイコンを使用すると、BigQuery または Azure の**機械学習モデル**のフィールドを表示形式に使用できます。BigQuery 機械学習モデルは、BigQuery データ ソースでのみ機能することにご注意ください。 + 2. **表示形式フィールド** - ここでフィールドをドラッグアンドドロップするか、**[+]** マークをクリックして使用可能なフィールドから作成する表示形式に使用するフィールドを選択します。 + +2. **[設定] セクション** - このセクションでは、表示する内容をカスタマイズできます。各表示形式には独自の設定があります。 **[設定]** セクションの下部に、リンクのオプションが表示されます。これは、ドリル ダウンを全く新しいレベルに到達させる強力な機能です。詳細については、[ダッシュボード リンク](dashboard-linking.md) トピックをご覧ください。 + +3. **表示形式ピッカー** - ここで目的の表示形式を選択して、最終結果をプレビューできます。ドロップダウン メニューでさまざまなチャート タイプを切り替えると、表示形式フィールドのセクションが変更されます。各表示形式のフィールドは異なりますが、入力するだけで自動的に変更されます。 + +4. **表示形式のワークスペース** - フィールドをドラッグアンドドロップしながら作成または編集している表示形式を確認できます。そのチャート タイプを作成するために必要なすべてのフィールドが揃うまで、表示形式は入力されません。 + +5. **データ ソース** - 現在使用しているデータ ソースがここに表示されます。クリックによってデータ ソース内のシート、テーブル、またはビューを変更し、またエディターを離れることなく、接続を新しいデータ ソースへ完全に変更できます。 + +特に、次のことが可能になります。 +- データの**並べ替え**と**フィルター** +- データ エディターの**集計データ**。 +- データの**検索**、**視覚化**、および**書式設定**。 + +表示形式の作成を完了したら、**チェック** アイコンを選択して**ダッシュボード エディター**に戻ります。ダッシュボード エディターでは、表示形式をドラッグしてレイアウト、サイズ、配置を操作できます。ダッシュボードの書式設定とスタイル設定の準備ができたら、**チェック** アイコンをもう一度クリックまたはタップしてダッシュボードを保存します。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/visualizations-overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/visualizations-overview.md new file mode 100644 index 00000000..3f493333 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/user/visualizations-overview.md @@ -0,0 +1,51 @@ +--- +title: Reveal の表示形式 – 必要な知識 +_description: Reveal でのデータ表示形式の仕組みとカスタマイズ方法の概要です。 +_language: ja +--- + +# データ表示形式 + +Reveal は、さまざまな表示形式を提供することにより、ビジネス データから可能な限り多くの気付きを得るのに役立ちます。 + +## 表示形式の概要 + +ビジネス データを理解するために Reveal は情報の表示形式をカスタマイズする複数のオプションを提供します。これらは表示形式といいます。すべてのダッシュボードは 1 つ以上の表示形式で構成されます。 + +以下に示すダッシュボードには、セールスのさまざまな側面を分析する多様な表示形式が含まれています。 + +![Reveal's log in screen](images/example-data-visualizations.png) + +## 適切な表示形式タイプの選択 + +最適なチャート タイプを選択するには、データを確認し、表示形式で伝えようとしているストーリーを見つけるのに役立つ質問に答える必要があります。 + +データを比較することか、データの分布を示すことあるいはデータを全体の一部分として提示しようとしていますか? 財務、マーケティング、または販売データのトレンド分析を行っていますか? 日付/時刻軸が必要ですか? データ間の関係を調べていますか? または、読みやすく、簡単なストーリーを伝える KPI とゲージを表示したいだけですか? データを地図上にプロットすることは重要ですか? + +データを通じて何を表示したいかについて回答し、以下の表を使用して最適なチャートを選択してください。 + +| | | | | | | | | | | | +|:------------------:|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------:|:----------------------------------------------------------------------------------------------------------:|:----------------------------------------------------------------------------------------------------------:|:----------------------------------------------------------------------------------------------------------------:|:------------------------------------------------------:|:---------------------------------------------------------------------------:|:---------------------------------------------------------------------------:| +| データの比較 | ![Bar Chart icon](images/bar-chart.png)
[棒](chart-types/category-charts.md) | ![Column Chart icon](images/column-chart.png)
[柱状](chart-types/category-charts.md) | ![Area Chart icon](images/area-chart.png)
[エリア](chart-types/category-charts.md) | ![Spline Chart icon](images/spline-chart.png)
[スプライン](chart-types/category-charts.md) | ![Combo Chart icon](images/Combo-chart.png)
[複合](chart-types/combo-charts.md) | ![Circular Gauge icon](images/circular-chart.png)
[円型](chart-types/gauge-charts.md#円形ゲージ) | ![Spline Area Chart icon](images/spline-area-chart.png)
[スプライン エリア](chart-types/category-charts.md) | ![OHLC Chart icon](images/ohlc-chart.png)
[OHLC](chart-types/financial-charts.md) | ![Candlestick Chart icon](images/candlestick-chart.png)
[ロウソク足](chart-types/financial-charts.md) | ![Time Series Chart icon](images/time-series-chart.png)
[時系列](chart-types/time-series-charts.md) | +| 部分から全体 | ![Stacked Column Chart icon](images/stacked-column-chart.png)
[積層型柱状](chart-types/category-charts.md) | ![Stacked Bar Chart icon](images/stacked-bar-chart.png)
[積層型棒](chart-types/category-charts.md) | ![Stacked Area Chart icon](images/stacked-area-chart.png)
[積層型エリア](chart-types/category-charts.md) | ![Pie Chart icon](images/pie-chart.png)
[円](chart-types/category-charts.md) | ![Doughnut Chart icon](images/doughnut-chart.png)
[ドーナツ型](chart-types/category-charts.md) | ![Funnel Chart icon](images/funnel-chart.png)
[ファンネル](chart-types/category-charts.md) | ![Treemap Chart icon](images/treemap-chart.png)
[ツリーマップ](chart-types/treemap-charts.md) | | | | +| データ分布 | ![Step Area Chart icon](images/step-area-chart.png)
[ステップ エリア](chart-types/category-charts.md) | ![Stacked Column Chart icon](images/stacked-column-chart.png)
[積層型柱状](chart-types/category-charts.md) | ![Scatter Chart icon](images/scatter-chart.png)
[散布図](chart-types/scatter-bubble-charts.md) | ![Bubble Chart icon](images/bubble-chart.png)
[バブル](chart-types/scatter-bubble-charts.md) | | | | | | | +| データ トレンド分析 | ![Line Chart icon](images/line-chart.png)
[折れ線](chart-types/category-charts.md) | ![Spline Chart icon](images/spline-chart.png)
[スプライン](chart-types/category-charts.md) | ![Combo Chart icon](images/Combo-chart.png)
[複合](chart-types/combo-charts.md) | ![OHLC Chart icon](images/ohlc-chart.png)
[OHLC](chart-types/financial-charts.md) | ![Candlestick Chart icon](images/candlestick-chart.png)
[ロウソク足](chart-types/financial-charts.md) | ![Radial Chart icon](images/radial-chart.png)
[ラジアル](chart-types/radial-charts.md) | ![Time Series Chart icon](images/time-series-chart.png)
[時系列](chart-types/time-series-charts.md) | | | | +| データの関係 | ![Scatter Chart icon](images/scatter-chart.png)
[散布図](chart-types/scatter-bubble-charts.md) | ![Bubble Chart icon](images/bubble-chart.png)
[バブル](chart-types/scatter-bubble-charts.md) | ![Line Chart icon](images/line-chart.png)
[折れ線](chart-types/category-charts.md) | | | | | | | | +| KPI とゲージ | ![Bullet Graph Gauge icon](images/bullet-graph-gauge.png)
[ブレット グラフ](chart-types/gauge-charts.md#ブレット-グラフ) | ![Linear Gauge icon](images/linear-gauge.png)
[リニア](chart-types/gauge-charts.md#リニア-ゲージ) | ![Text Chart icon](images/text-gauge.png)
[テキスト](chart-types/gauge-charts.md#テキスト-ゲージ) | ![KPI Gauge icon](images/kpi.png)
[KPI](chart-types/kpi-gauge.md) | ![Circular Gauge icon](images/circular-gauge.png)
[円型](chart-types/gauge-charts.md#円形ゲージ) | | | | | | +| 地理的データ | ![Choropleth Map icon](images/choropleth-map.png)
[階級区分図](chart-types/choropleth-map.md) | ![Scatter Map icon](images/scatter-map.png)
[散布マップ](chart-types/scatter-map.md) | | | | | | | | | + + + +これらの各表示形式の使用方法に関する詳細が必要な場合は、表のハイパーリンクを使用してください。 + +## 表示形式チュートリアル + +このセクションでは、Reveal の表示形式の作成手順を説明します。すべてのセクションで、このリンクを使用してダウンロードできる Data Visualizations データ ソースを使用しています。 + +| | | | | | +|:-:|:-:|:-:|:-:|:-:| +| ![Area Chart](images/area-chart-icon.png)
[エリア](tutorials-simple-charts.md) | ![Bar Chart](images/bar-chart-icon.png)
[棒](tutorials-simple-charts.md) | ![Bullet Graph Gauge](images/bullet-graph-icon.png)
[ブレット グラフ](tutorials-gauge.md#ブレット-グラフを作成する方法) | ![Candlestick Chart](images/candlestick-chart-icon.png)
[ローソク足](tutorials-candlestick.md) | ![Circular Gauge](images/circular-gauge-icon.png)
[円型](tutorials-gauge.md#円形ゲージを作成する方法) | +| ![Column Chart](images/column-chart-icon.png)
[柱状](tutorials-simple-charts.md) | ![Doughnut Chart](images/doughnut-chart-icon.png)
[ドーナツ型](tutorials-simple-charts.md) | ![Funnel Chart](images/funnel-chart-icon.png)
[ファンネル](tutorials-simple-charts.md) | ![Web View](images/image-view-icon.png)
[画像](tutorials-image.md) | ![kpi](images/kpi-icon.png)
[KPI](tutorials-kpi-gauge.md) | +| ![Line Chart](images/line-chart-icon.png)
[折れ線](tutorials-simple-charts.md) | ![Linear Gauge](images/linear-gauge-icon.png)
[リニア](tutorials-gauge.md#リニア-ゲージを作成する方法) | ![OHLC Chart](images/ohlc-chart-icon.png)
[OHLC](tutorials-ohlc.md) | ![Pie Chart](images/pie-chart-icon.png)
[円](tutorials-simple-charts.md) | ![Circular Chart](images/radial-chart-icon.png)
[ラジアル](tutorials-simple-charts.md) | +| ![Sparkline Chart](images/sparkline-chart-icon.png)
[スパークライン](tutorials-sparkline-charts.md) | ![Spline Chart](images/spline-chart-icon.png)
[スプライン](tutorials-simple-charts.md) | ![Spline Area](images/spline-area-icon.png)
[スプライン エリア](tutorials-simple-charts.md) | ![Stacked Area Chart](images/stacked-area-chart-icon.png)
[積層型エリア](tutorials-stacked-charts.md) | ![Stacked Bar Chart](images/stacked-bar-chart-icon.png)
[積層型棒](tutorials-stacked-charts.md) | +| ![Stacked Column Chart](images/stacked-column-chart-icon.png)
[積層型柱状](tutorials-stacked-charts.md) | ![Step Area Chart](images/step-area-chart-icon.png)
[ステップ エリア](tutorials-simple-charts.md) | ![Step Line Chart](images/step-line-chart-icon.png)
[ステップ折れ線](tutorials-simple-charts.md) | ![Text Gauge](images/text-gauge-icon.png)
[テキスト](tutorials-gauge.md#テキスト-ゲージを作成する方法) | ![Text View](images/text-view-icon.png)
[テキスト ビュー](tutorials-text-view.md) | \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/amazon-athena.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/amazon-athena.md new file mode 100644 index 00000000..b10b734d --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/amazon-athena.md @@ -0,0 +1,339 @@ +--- +pagination_next: web/authentication +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# Amazon Athena データ ソース + +## 概要 + +Amazon Athena は、標準 SQL を使用して Amazon S3 内のデータを簡単に分析できるインタラクティブなクエリ サービスです。このトピックでは、Reveal アプリケーションで Amazon Athena データ ソースに接続して、データを視覚化および分析する方法について説明します。 + +## サーバーの構成 + +### インストール + + + + +ASP.NET アプリケーションの場合、Amazon Athena サポートを有効にするには、別の NuGet パッケージをインストールする必要があります。 + +```bash +dotnet add package Reveal.Sdk.Data.Amazon.Athena +``` + +次に、アプリケーションに Amazon Athena プロバイダーを登録します。 + +```csharp +builder.Services.AddControllers().AddReveal( builder => +{ + builder.DataSources.RegisterAmazonAthena(); +}); +``` + + + + +Node.js アプリケーションの場合、Amazon Athena データ ソースはメインの Reveal SDK パッケージにすでに含まれています。標準の Reveal SDK セットアップ以外に追加のインストールは必要ありません。 + + + + +Java アプリケーションの場合、Amazon Athena データ ソースはメインの Reveal SDK パッケージにすでに含まれています。標準の Reveal SDK セットアップ以外に追加のインストールは必要ありません。 + + + + +### 接続の構成 + +Amazon Athena のすべての接続プロパティは、データ ソース プロバイダーの実装を通じてサーバー側で構成されます。 + + + + +```csharp +// Create a data source provider +public class DataSourceProvider : IRVDataSourceProvider +{ + public async Task ChangeDataSourceItemAsync(IRVUserContext userContext, string dashboardId, RVDataSourceItem dataSourceItem) + { + // Required: Update the underlying data source + await ChangeDataSourceAsync(userContext, dataSourceItem.DataSource); + + if (dataSourceItem is RVAthenaDataSourceItem athenaItem) + { + // Configure specific item properties as needed + if (athenaItem.Id == "my-data-source-item") + { + athenaItem.Table = "your_table_name"; + } + } + + return dataSourceItem; + } + + public Task ChangeDataSourceAsync(IRVUserContext userContext, RVDashboardDataSource dataSource) + { + if (dataSource is RVAthenaDataSource athenaDS) + { + // Configure connection properties + athenaDS.Region = "your_region"; + athenaDS.Database = "your_database_name"; + } + + return Task.FromResult(dataSource); + } +} +``` + + + + +```javascript +// Create data source providers +const dataSourceItemProvider = async (userContext, dataSourceItem) => { + // Required: Update the underlying data source + await dataSourceProvider(userContext, dataSourceItem.dataSource); + + if (dataSourceItem instanceof reveal.RVAthenaDataSourceItem) { + // Configure specific item properties if needed + if (dataSourceItem.id === "my-data-source-item") { + dataSourceItem.table = "your_table_name"; + } + } + + return dataSourceItem; +} + +const dataSourceProvider = async (userContext, dataSource) => { + if (dataSource instanceof reveal.RVAthenaDataSource) { + // Configure connection properties + dataSource.region = "your_region"; + dataSource.database = "your_database_name"; + } + + return dataSource; +} + +``` + + + + +```typescript +// Create data source providers +const dataSourceItemProvider = async (userContext: IRVUserContext | null, dataSourceItem: RVDataSourceItem) => { + // Required: Update the underlying data source + await dataSourceProvider(userContext, dataSourceItem.dataSource); + + if (dataSourceItem instanceof RVAthenaDataSourceItem) { + // Configure specific item properties if needed + if (dataSourceItem.id === "my-data-source-item") { + dataSourceItem.table = "your_table_name"; + } + } + + return dataSourceItem; +} + +const dataSourceProvider = async (userContext: IRVUserContext | null, dataSource: RVDashboardDataSource) => { + if (dataSource instanceof RVAthenaDataSource) { + // Configure connection properties + dataSource.region = "your_region"; + dataSource.database = "your_database_name"; + } + + return dataSource; +} +``` + + + + +```java +// Create a data source provider +public class DataSourceProvider implements IRVDataSourceProvider { + + public RVDataSourceItem changeDataSourceItem(IRVUserContext userContext, String dashboardId, RVDataSourceItem dataSourceItem) { + // Required: Update the underlying data source + changeDataSource(userContext, athenaItem.getDataSource()); + + if (dataSourceItem instanceof RVAthenaDataSourceItem athenaItem) { + // Configure specific item properties if needed + if ("my-data-source-item".equals(athenaItem.getId())) { + athenaItem.setTable("your_table_name"); + } + } + + return dataSourceItem; + } + + public RVDashboardDataSource changeDataSource(IRVUserContext userContext, RVDashboardDataSource dataSource) { + if (dataSource instanceof RVAthenaDataSource athenaDS) { + // Configure connection properties + athenaDS.setRegion("your_region"); + athenaDS.setDatabase("your_database_name"); + } + + return dataSource; + } +} +``` + + + + +:::danger Important +`ChangeDataSourceAsync` メソッドでデータ ソースに加えられた変更は、`ChangeDataSourceItemAsync` メソッドには引き継がれません。どちらの方法でも、データ ソース プロパティを**更新する必要があります**。上記の例に示すように、`ChangeDataSourceItemAsync` メソッド内で `ChangeDataSourceAsync` メソッドを呼び出し、データ ソース項目の基になるデータ ソースをパラメーターとして渡すことをお勧めします。 +::: + +### 認証 + +Amazon Athena の認証は、AWS 認証情報を使用してサーバー側で処理されます。認証オプションの詳細については、「[認証](../authentication.md#amazon-web-services)」トピックを参照してください。 + + + + +```csharp +public class AuthenticationProvider: IRVAuthenticationProvider +{ + public Task ResolveCredentialsAsync(IRVUserContext userContext, RVDashboardDataSource dataSource) + { + IRVDataSourceCredential userCredential = null; + if (dataSource is RVS3DataSource) + { + userCredential = new RVAmazonWebServicesCredentials("key", "secret"); + } + return Task.FromResult(userCredential); + } +} +``` + + + + +```javascript +const authenticationProvider = async (userContext, dataSource) => { + if (dataSource instanceof reveal.RVS3DataSource) { + return new reveal.RVAmazonWebServicesCredentials("key", "secret"); + } + return null; +} +``` + + + + +```ts +const authenticationProvider = async (userContext:IRVUserContext | null, dataSource: RVDashboardDataSource) => { + if (dataSource instanceof RVS3DataSource) { + return new RVAmazonWebServicesCredentials("key", "secret"); + } + return null; +} +``` + + + + +```java +public class AuthenticationProvider implements IRVAuthenticationProvider { + @Override + public IRVDataSourceCredential resolveCredentials(IRVUserContext userContext, RVDashboardDataSource dataSource) { + if (dataSource instanceof RVS3DataSource) { + return new RVAmazonWebServicesCredentials("key", "secret"); + } + return null; + } +} +``` + + + + +## クライアント側の実装 + +クライアント側では、データ ソースの ID、タイトル、サブタイトルなどの基本プロパティを指定するだけです。実際の接続構成はサーバー上で行われます。 + +### データ ソースの作成 + +**手順 1** - `RevealView.onDataSourcesRequested` イベントのイベント ハンドラーを追加します。 + +```js +const revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + // Add data source here + callback(new $.ig.RevealDataSources([], [], false)); +}; +``` + +**手順 2** - `RevealView.onDataSourcesRequested` イベント ハンドラーで、`RVAthenaDataSource` オブジェクトの新しいインスタンスを作成します。`title` と `subtitle` プロパティを設定します。`RVAthenaDataSource` オブジェクトを作成したら、それをデータ ソース コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + const athenaDS = new $.ig.RVAthenaDataSource(); + athenaDS.title = "My Athena Data Source"; + athenaDS.subtitle = "Amazon Athena"; + + callback(new $.ig.RevealDataSources([athenaDS], [], false)); +}; +``` + +アプリケーションが実行されたら、新しい可視化を作成すると、新しく作成された Amazon Athena データ ソースが [データ ソースの選択] ダイアログにリストされます。 + +![](images/amazon-athena-data-source.jpg) + +### データ ソース項目の作成 + +データ ソース項目は、ユーザーが表示形式のために選択できる Athena データ ソース内の特定のデータセットを表します。クライアント側では、ID、タイトル、サブタイトルを指定するだけです。 + +```js +revealView.onDataSourcesRequested = (callback) => { + // Create the data source + const athenaDS = new $.ig.RVAthenaDataSource(); + athenaDS.title = "My Athena Data Source"; + athenaDS.subtitle = "Amazon Athena"; + + // Create a data source item + const athenaDSI = new $.ig.RVAthenaDataSourceItem(athenaDS); + athenaDSI.id = "my-data-source-item"; + athenaDSI.title = "My Athena Data Source Item"; + athenaDSI.subtitle = "Amazon Athena"; + + callback(new $.ig.RevealDataSources([athenaDS], [athenaDSI], false)); +}; +``` + +アプリケーションが実行されたら、新しい可視化を作成すると、新しく作成された Amazon Athena データ ソース項目が [データ ソースの選択] ダイアログにリストされます。 + +![](images/amazon-athena-data-source-item.jpg) + +## その他のリソース + +- [Amazon Athena のドキュメント](https://docs.aws.amazon.com/athena/) +- [GitHub のサンプル ソース コード](https://github.com/RevealBi/sdk-samples-javascript/tree/main/DataSources/Amazon-Athena) + +## API リファレンス + + + + +* [RVAthenaDataSource](https://help.revealbi.io/api/aspnet/latest/Reveal.Sdk.Data.Amazon.Athena.RVAthenaDataSource.html) - Amazon Athena データ ソースを表します +* [RVAthenaDataSourceItem](https://help.revealbi.io/api/aspnet/latest/Reveal.Sdk.Data.Amazon.Athena.RVAthenaDataSourceItem.html) - Amazon Athena データ ソース項目を表します + + + + +* [RVAthenaDataSource](https://help.revealbi.io/api/javascript/latest/classes/rvathenadatasource.html) - Amazon Athena データ ソースを表します +* [RVAthenaDataSourceItem](https://help.revealbi.io/api/javascript/latest/classes/rvathenadatasourceitem.html) - Amazon Athena データ ソース項目を表します + + + + +* [RVAthenaDataSource](https://help.revealbi.io/api/java/latest/com/infragistics/reveal/sdk/api/model/RVAthenaDataSource.html) - Amazon Athena データ ソースを表します +* [RVAthenaDataSourceItem](https://help.revealbi.io/api/java/latest/com/infragistics/reveal/sdk/api/model/RVAthenaDataSourceItem.html) - Amazon Athena データ ソース項目を表します + + + diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/amazon-s3.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/amazon-s3.md new file mode 100644 index 00000000..709fd355 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/amazon-s3.md @@ -0,0 +1,53 @@ +--- +pagination_next: web/authentication +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# Amazon S3 データ ソースの追加 + +:::danger 重大な変更 + +現在、Reveal SDK は、Reveal SDK core パッケージからデータ ソースを分離する過程にあります。プロジェクトの継続的な機能を確保するために、プロジェクトに追加のパッケージをインストールすることが必要になる場合があります。詳細については、[サポートされるデータ ソース](web/datasources.md#サポートされるデータ-ソース) トピックを参照してください。 + +::: + +**手順 1** - `RevealView.onDataSourcesRequested` イベントのイベント ハンドラーを追加します。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + //add code here + callback(new $.ig.RevealDataSources([], [], false)); +}; +``` + +**手順 2** - `RevealView.onDataSourcesRequested` イベント ハンドラーで、[RVS3DataSource](https://help.revealbi.io/api/javascript/latest/classes/rvgoogledrivedatasource.html) オブジェクトの新しいインスタンスを作成します。`Title`、`Subtitle`、および `Region` プロパティを設定します。`RVS3DataSource` オブジェクトを作成したら、それをデータ ソース コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + var s3 = new $.ig.RVS3DataSource(); + s3.title = "My S3 Server"; + s3.subtitle = "Amazon S3"; + s3.region = "region"; + + callback(new $.ig.RevealDataSources([s3], [], false)); +}; +``` + +アプリケーションを実行し、新しい可視化を作成すると、新しく作成された Amazon S3 データ ソースが [データ ソースの選択] ダイアログに表示されます。 + +![](images/amazon-s3-data-source.jpg) + +:::note + +`RVS3DataSource` は、Reveal SDK に登録された認証プロバイダーに基づいてフォルダーとファイルを読み込みます。Amazon S3 は `RVAmazonWebServicesCredentials` を使用して認証します。詳細については、[認証](../authentication.md#amazon-web-services)トピックを参照してください。 + +::: + +:::info コードの取得 + +このサンプルのソース コードは、[GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/DataSources/Amazon-S3) にあります。 + +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/csv.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/csv.md new file mode 100644 index 00000000..ba81d02d --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/csv.md @@ -0,0 +1,73 @@ +--- +pagination_next: web/authentication +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# CSV データ ソースの追加 + +:::danger 重大な変更 + +現在、Reveal SDK は、Reveal SDK core パッケージからデータ ソースを分離する過程にあります。プロジェクトの継続的な機能を確保するために、プロジェクトに追加のパッケージをインストールすることが必要になる場合があります。詳細については、[サポートされるデータ ソース](web/datasources.md#サポートされるデータ-ソース) トピックを参照してください。 + +::: + +**手順 1** - `RevealView.onDataSourcesRequested` イベントのイベント ハンドラーを追加します。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + //add code here + callback(new $.ig.RevealDataSources([], [], false)); +}; +``` + +**手順 2** - `RevealView.onDataSourcesRequested` イベント ハンドラーで、[RVWebResourceDataSource](https://help.revealbi.io/api/javascript/latest/classes/rvwebresourcedatasource.html) オブジェクトの新しいインスタンスを作成します。CSV リソースへのアクセスに認証が必要ない場合は、`URL` プロパティを CSV リソースの URL に設定し、`useAnonymousAuthentication` プロパティを `false` に設定します。オプションで、`RVWebResourceDataSource` オブジェクトをコールバックのデータ ソース コレクションに追加して、RevealView の [データ ソース] ダイアログに表示できます。 + +```js +revealView.onDataSourcesRequested = (callback) => { + const webDS = new $.ig.RVWebResourceDataSource(); + webDS.title = "Web Data Source"; + webDS.subtitle = "Web Data Source Subtitle"; + webDS.url = "https://raw.githubusercontent.com/fivethirtyeight/data/master/airline-safety/airline-safety.csv"; + webDS.useAnonymousAuthentication = true; + + callback(new $.ig.RevealDataSources([webDS], [], false)); +}; +``` + +アプリケーションを実行し、新しい可視化を作成すると、新しく作成された Web リソース データ ソースが [データ ソースの選択] ダイアログに表示されます。 + +![](images/web-resource-data-source.jpg) + +**手順 3** - [データ ソース] ダイアログの **[CSV の設定]** 画面をスキップして CSV データを直接使用するには、[RVWebResourceDataSourceItem](https://help.revealbi.io/api/javascript/latest/classes/rvwebresourcedatasourceitem.html) の新しいインスタンスを作成し、前の手順で作成した `RVWebResourceDataSource` オブジェクトをコンストラクター引数として渡します。次に、[RVCsvDataSourceItem](https://help.revealbi.io/api/javascript/latest/classes/rvcsvdatasourceitem.html) の新しいインスタンスを作成し、`RVWebResourceDataSourceItem` をコンストラクター引数として渡します。`Title`、`Subtitle`、およびその他の必要なプロパティを設定します。`RVCsvDataSourceItem` オブジェクトを作成したら、それをデータ ソース項目コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + const webDS = new $.ig.RVWebResourceDataSource(); + webDS.title = "Web Data Source"; + webDS.subtitle = "Web Data Source Subtitle"; + webDS.url = "https://raw.githubusercontent.com/fivethirtyeight/data/master/airline-safety/airline-safety.csv"; + webDS.useAnonymousAuthentication = true; + + //to skip the "Set up your CSV" dialog and directly use the CSV data + const webDSI = new $.ig.RVWebResourceDataSourceItem(webDS); + const csvDSI = new $.ig.RVCsvDataSourceItem(webDSI); + csvDSI.title = "CSV Data"; + csvDSI.subtitle = "CSV Data Subtitle"; + + callback(new $.ig.RevealDataSources([webDS], [csvDSI], false)); +}; +``` + +アプリケーションを実行し、新しい可視化を作成すると、新しく作成された CSV データ ソース項目が [データ ソースの選択] ダイアログに表示されます。 + +![](images/csv-data-source-item.jpg) + + +:::info コードの取得 + +このサンプルのソース コードは、[GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/DataSources/Csv) にあります。 + +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/databricks.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/databricks.md new file mode 100644 index 00000000..9c8eabec --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/databricks.md @@ -0,0 +1,377 @@ +--- +pagination_next: web/authentication +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# Databricks データ ソース + +## 概要 + +Databricks は、データ エンジニアリング チームとデータ サイエンス チームが大規模なデータ処理、機械学習、分析を共同で行うことができる統合分析プラットフォームです。このトピックでは、Reveal アプリケーションで Databricks データ ソースに接続して、データを視覚化および分析する方法について説明します。 + +:::important 前提条件 +Reveal で Databricks データ ソースを構成する前に、適切なデータベース ドライバーをインストールする必要があります。 +- Windows/.NET の場合: [Databricks ODBC ドライバー](https://www.databricks.com/spark/odbc-drivers-download) +- Node.js の場合: [Databricks ODBC ドライバー](https://www.databricks.com/spark/odbc-drivers-download) +- Java の場合: JDBC ドライバーは Maven 経由で自動的にインストールされます。 + +これらのドライバーは、Databricks データ ソースへの接続を確立するために不可欠です。インストール後、Databricks のドキュメントに従ってドライバーが適切に構成されていることを確認します。 +::: + +## サーバーの構成 + +### インストール + + + + +**手順 1** - Reveal Databricks コネクタ パッケージをインストールします。 + +ASP.NET アプリケーションの場合、Databricks サポートを有効にするには、別の NuGet パッケージをインストールする必要があります。 + +```bash +dotnet add package Reveal.Sdk.Data.Databricks +``` + +**手順 2** - アプリケーションに Databricks データ ソースを登録します。 + +```csharp +builder.Services.AddControllers().AddReveal( builder => +{ + builder.DataSources.RegisterDatabricks(); +}); +``` + + + + +Node.js アプリケーションの場合、Databricks データ ソースはメインの Reveal SDK パッケージに既に含まれています。標準の Reveal SDK セットアップ以外に追加のインストールは必要ありません。 + + + + +Java アプリケーションの場合、Databricks データ ソースはメインの Reveal SDK パッケージに既に含まれています。標準の Reveal SDK セットアップ以外に追加のインストールは必要ありません。 + +:::danger 重要 +Databricks JDBC ドライバーは Apache Arrow をサポートしています。Java JVM バージョン 11 以降を使用する場合は、JVM 引数に --add-opens java.base/java.nio=ALL-UNNAMED という行を追加してください。この JVM 引数がない場合、ドライバーは動作しません。 +::: + +JVM 引数を設定するには、`pom.xml` ファイルに以下を追加してください: + +```xml + + org.springframework.boot + spring-boot-maven-plugin + + --add-opens java.base/java.nio=ALL-UNNAMED + + +``` + +この方法は一例です。他にも設定方法は多数ありますので、詳細は関連ドキュメントをご確認ください。 + + + + +### 接続の構成 + + + + +```csharp +// Create a data source provider +public class DataSourceProvider : IRVDataSourceProvider +{ + public async Task ChangeDataSourceItemAsync(IRVUserContext userContext, string dashboardId, RVDataSourceItem dataSourceItem) + { + // Required: Update the underlying data source + await ChangeDataSourceAsync(userContext, dataSourceItem.DataSource); + + if (dataSourceItem is RVDatabricksDataSourceItem databricksItem) + { + // Configure specific item properties as needed + if (databricksItem.Id == "databricks_sales_data") + { + databricksItem.Table = "sales_data"; + } + } + + return dataSourceItem; + } + + public Task ChangeDataSourceAsync(IRVUserContext userContext, RVDashboardDataSource dataSource) + { + if (dataSource is RVDatabricksDataSource databricksDS) + { + // Configure connection properties + databricksDS.Host = "your-databricks-instance.cloud.databricks.com"; + databricksDS.HttpPath = "/sql/1.0/warehouses/abc123"; + databricksDS.Port = 443; + databricksDS.Database = "default"; + databricksDS.Schema = "public"; + } + + return dataSource; + } +} +``` + + + + +```javascript +// Create data source providers +const dataSourceItemProvider = async (userContext, dataSourceItem) => { + // Required: Update the underlying data source + await dataSourceProvider(userContext, dataSourceItem.dataSource); + + if (dataSourceItem instanceof reveal.RVDatabricksDataSourceItem) { + // Configure specific item properties if needed + if (dataSourceItem.id === "databricks_sales_data") { + dataSourceItem.table = "sales_data"; + } + } + + return dataSourceItem; +} + +const dataSourceProvider = async (userContext, dataSource) => { + if (dataSource instanceof reveal.RVDatabricksDataSource) { + // Configure connection properties + dataSource.host = "your-databricks-instance.cloud.databricks.com"; + dataSource.httpPath = "/sql/1.0/warehouses/abc123"; + dataSource.port = 443; + dataSource.database = "default"; + dataSource.schema = "public"; + } + + return dataSource; +} +``` + + + + +```typescript +// Create data source providers +const dataSourceItemProvider = async (userContext: IRVUserContext | null, dataSourceItem: RVDataSourceItem) => { + // Required: Update the underlying data source + await dataSourceProvider(userContext, dataSourceItem.dataSource); + + if (dataSourceItem instanceof RVDatabricksDataSourceItem) { + // Configure specific item properties if needed + if (dataSourceItem.id === "databricks_sales_data") { + dataSourceItem.table = "sales_data"; + } + } + + return dataSourceItem; +} + +const dataSourceProvider = async (userContext: IRVUserContext | null, dataSource: RVDashboardDataSource) => { + if (dataSource instanceof RVDatabricksDataSource) { + // Configure connection properties + dataSource.host = "your-databricks-instance.cloud.databricks.com"; + dataSource.httpPath = "/sql/1.0/warehouses/abc123"; + dataSource.port = 443; + dataSource.database = "default"; + dataSource.schema = "public"; + } + + return dataSource; +} +``` + + + + +```java +// Create a data source provider +public class DataSourceProvider implements IRVDataSourceProvider { + + public RVDataSourceItem changeDataSourceItem(IRVUserContext userContext, String dashboardId, RVDataSourceItem dataSourceItem) { + // Required: Update the underlying data source + changeDataSource(userContext, databricksItem.getDataSource()); + + if (dataSourceItem instanceof RVDatabricksDataSourceItem databricksItem) { + // Configure specific item properties if needed + if ("databricks_sales_data".equals(databricksItem.getId())) { + databricksItem.setTable("sales_data"); + } + } + + return dataSourceItem; + } + + public RVDashboardDataSource changeDataSource(IRVUserContext userContext, RVDashboardDataSource dataSource) { + if (dataSource instanceof RVDatabricksDataSource databricksDS) { + // Configure connection properties + databricksDS.setHost("your-databricks-instance.cloud.databricks.com"); + databricksDS.setHttpPath("/sql/1.0/warehouses/abc123"); + databricksDS.setPort(443); + databricksDS.setDatabase("default"); + databricksDS.setSchema("public"); + } + + return dataSource; + } +} +``` + + + + +:::danger Important +`ChangeDataSourceAsync` メソッドでデータ ソースに加えられた変更は、`ChangeDataSourceItemAsync` メソッドには引き継がれません。どちらの方法でも、データ ソース プロパティを**更新する必要があります**。上記の例に示すように、`ChangeDataSourceItemAsync` メソッド内で `ChangeDataSourceAsync` メソッドを呼び出し、データ ソース項目の基になるデータ ソースをパラメーターとして渡すことをお勧めします。 +::: + +### 認証 + +Databricks の認証は、個人アクセス トークンを使用してサーバー側で処理されます。認証オプションの詳細については、「[認証](../authentication.md)」トピックを参照してください。 + + + + +```csharp +public class AuthenticationProvider: IRVAuthenticationProvider +{ + public Task ResolveCredentialsAsync(IRVUserContext userContext, RVDashboardDataSource dataSource) + { + IRVDataSourceCredential userCredential = null; + if (dataSource is RVDatabricksDataSource) + { + // Use Personal Access Token + userCredential = new RVBearerTokenDataSourceCredential("your_personal_access_token", "your_userid"); + } + return Task.FromResult(userCredential); + } +} +``` + + + + +```javascript +const authenticationProvider = async (userContext, dataSource) => { + if (dataSource instanceof reveal.RVDatabricksDataSource) { + // Use Personal Access Token + return new reveal.RVBearerTokenDataSourceCredential("your_personal_access_token", "your_userid"); + } + return null; +} +``` + + + + +```ts +const authenticationProvider = async (userContext: IRVUserContext | null, dataSource: RVDashboardDataSource) => { + if (dataSource instanceof RVDatabricksDataSource) { + // Use Personal Access Token + return new RVBearerTokenDataSourceCredential("your_personal_access_token", "your_userid"); + } + return null; +} +``` + + + + +```java +public class AuthenticationProvider implements IRVAuthenticationProvider { + @Override + public IRVDataSourceCredential resolveCredentials(IRVUserContext userContext, RVDashboardDataSource dataSource) { + if (dataSource instanceof RVDatabricksDataSource) { + // Use Personal Access Token + return new RVBearerTokenDataSourceCredential("your_personal_access_token", "your_userid"); + } + return null; + } +} +``` + + + + +## クライアント側の実装 + +クライアント側では、データ ソースの ID、タイトル、サブタイトルなどの基本プロパティを指定するだけです。実際の接続構成はサーバー上で行われます。 + +### データ ソースの作成 + +**手順 1** - `RevealView.onDataSourcesRequested` イベントのイベント ハンドラーを追加します。 + +```js +const revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + // Add data source here + callback(new $.ig.RevealDataSources([], [], false)); +}; +``` + +**手順 2** - `RevealView.onDataSourcesRequested` イベント ハンドラーで、`RVDatabricksDataSource` オブジェクトの新しいインスタンスを作成します。`title` と `subtitle` プロパティを設定します。`RVDatabricksDataSource` オブジェクトを作成したら、それをデータ ソース コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + const databricksDS = new $.ig.RVDatabricksDataSource(); + databricksDS.title = "Databricks"; + databricksDS.subtitle = "Data Source"; + + callback(new $.ig.RevealDataSources([databricksDS], [], false)); +}; +``` + +アプリケーションが実行されたら、新しい可視化を作成すると、新しく作成された Databricks データ ソースが [データ ソースの選択] ダイアログに表示されます。 + +![](images/databricks-data-source.jpg) + +### データ ソース項目の作成 + +データ ソース項目は、ユーザーが表示形式のために選択できる Databricks データ ソース内の特定のデータセットを表します。クライアント側では、ID、タイトル、サブタイトルを指定するだけです。 + +```js +revealView.onDataSourcesRequested = (callback) => { + // Create the data source + const databricksDS = new $.ig.RVDatabricksDataSource(); + databricksDS.title = "My Databricks Datasource"; + databricksDS.subtitle = "Databricks"; + + // Create a data source item + const databricksDSI = new $.ig.RVDatabricksDataSourceItem(databricksDS); + databricksDSI.id = "databricks_sales_data"; + databricksDSI.title = "My Databricks Datasource Item"; + databricksDSI.subtitle = "Databricks"; + + callback(new $.ig.RevealDataSources([databricksDS], [databricksDSI], false)); +}; +``` + +アプリケーションが実行されたら、新しい可視化を作成すると、新しく作成された Databricks データ ソース項目が [データ ソースの選択] ダイアログに表示されます。 + +![](images/databricks-data-source-item.jpg) + +## その他のリソース + +- [Databricks SQL ドキュメント](https://docs.databricks.com/sql/index.html) +- [Databricks ODBC ドライバー](https://www.databricks.com/spark/odbc-drivers-download) +- [Databricks JDBC ドライバー](https://www.databricks.com/spark/jdbc-drivers-download) +- [GitHub のサンプル ソース コード](https://github.com/RevealBi/sdk-samples-javascript/tree/main/DataSources/Databricks) + +## API リファレンス + + + + +* [RVDatabricksDataSource](https://help.revealbi.io/api/aspnet/latest/Reveal.Sdk.Data.Databricks.RVDatabricksDataSource.html) - Databricks データ ソースを表します +* [RVDatabricksDataSourceItem](https://help.revealbi.io/api/aspnet/latest/Reveal.Sdk.Data.Databricks.RVDatabricksDataSourceItem.html) - Databricks データ ソース項目を表します + + + + +* [RVDatabricksDataSource](https://help.revealbi.io/api/javascript/latest/classes/rvdatabricksdatasource.html) - Databricks データ ソースを表します +* [RVDatabricksDataSourceItem](https://help.revealbi.io/api/javascript/latest/classes/rvdatabricksdatasourceitem.html) - Databricks データ ソース項目を表します + + + \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/elasticsearch.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/elasticsearch.md new file mode 100644 index 00000000..287a4693 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/elasticsearch.md @@ -0,0 +1,318 @@ +--- +pagination_next: web/authentication +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# Elasticsearch データ ソース + +## 概要 + +Elasticsearch は、増え続けるユースケースに対応できる、分散型の RESTful 検索および分析エンジンです。Elastic Stack の中核として、データを一元的に保存し、高速な検索、微調整された関連性、簡単にスケールする強力な分析を実現します。Elasticsearch SQL を使用すると、Elasticsearch インデックスに対して SQL クエリを実行でき、使い慣れた SQL 構文を使用してデータを操作しやすくなります。このトピックでは、Reveal アプリケーションで Elasticsearch データ ソースに接続して、データを視覚化および分析する方法について説明します。 + +## サーバーの構成 + +### インストール + + + + +ASP.NET アプリケーションの場合、Elasticsearch サポートを有効にするには、別の NuGet パッケージをインストールする必要があります。 + +```bash +dotnet add package Reveal.Sdk.Data.Elasticsearch +``` + +次に、アプリケーションに Elasticsearch プロバイダーを登録します。 + +```csharp +builder.Services.AddControllers().AddReveal( builder => +{ + builder.DataSources.RegisterElasticsearch(); +}); +``` + + + + +Node.js アプリケーションの場合、Elasticsearch データ ソースはメインの Reveal SDK パッケージにすでに含まれています。標準の Reveal SDK セットアップ以外に追加のインストールは必要ありません。 + + + + +### 接続の構成 + +Elasticsearch のすべての接続プロパティは、データ ソース プロバイダーの実装を通じてサーバー側で構成されます。 + + + + +```csharp +// データ ソース プロバイダーを作成する +public class DataSourceProvider : IRVDataSourceProvider +{ + public async Task ChangeDataSourceItemAsync(IRVUserContext userContext, string dashboardId, RVDataSourceItem dataSourceItem) + { + // 必須: 基になるデータ ソースを更新する + await ChangeDataSourceAsync(userContext, dataSourceItem.DataSource); + + if (dataSourceItem is RVElasticsearchDataSourceItem elasticsearchDataSourceItem) + { + // 特定のインデックスを使用して構成する + if (dataSourceItem.Id == "elasticsearchDataSourceItemId") + { + elasticsearchDataSourceItem.Index = "kibana_sample_data_ecommerce"; + } + + // またはカスタム SQL クエリを使用して構成する + if (dataSourceItem.Id == "elasticsearchDataSourceItemCustomQueryId") + { + elasticsearchDataSourceItem.CustomQuery = "SELECT * FROM \"kibana_sample_data_ecommerce\" WHERE \"customer_first_name\" = 'Eddie'"; + } + + // フィールドの複数値処理を構成する + elasticsearchDataSourceItem.FieldMultiValueLeniency = true; + } + + return dataSourceItem; + } + + public Task ChangeDataSourceAsync(IRVUserContext userContext, RVDashboardDataSource dataSource) + { + if (dataSource is RVElasticsearchDataSource elasticsearchDataSource) + { + // 接続プロパティを構成する + elasticsearchDataSource.Nodes = new List { "http://localhost:9200" }; + + // オプション: SSL/TLS 証明書フィンガープリントを構成する + elasticsearchDataSource.CertificateFingerprint = "your_certificate_fingerprint"; + + // オプション: データ ソース レベルでフィールドの複数値処理を構成する + elasticsearchDataSource.FieldMultiValueLeniency = true; + } + + return Task.FromResult(dataSource); + } +} +``` + + + + +```javascript +// データ ソース プロバイダーを作成する +const dataSourceItemProvider = async (userContext, dataSourceItem) => { + // 必須: 基になるデータ ソースを更新する + await dataSourceProvider(userContext, dataSourceItem.dataSource); + + if (dataSourceItem instanceof reveal.RVElasticsearchDataSourceItem) { + // 特定のインデックスを使用して構成する + if (dataSourceItem.id === "elasticsearchDataSourceItemId") { + dataSourceItem.index = "kibana_sample_data_ecommerce"; + } + + // またはカスタム SQL クエリを使用して構成する + if (dataSourceItem.id === "elasticsearchDataSourceItemCustomQueryId") { + dataSourceItem.customQuery = "SELECT * FROM \"kibana_sample_data_ecommerce\" WHERE \"customer_first_name\" = 'Eddie'"; + } + + // フィールドの複数値処理を構成する + dataSourceItem.fieldMultiValueLeniency = true; + } + + return dataSourceItem; +} + +const dataSourceProvider = async (userContext, dataSource) => { + if (dataSource instanceof reveal.RVElasticsearchDataSource) { + // 接続プロパティを構成する + dataSource.nodes = ["http://localhost:9200"]; + + // オプション: SSL/TLS 証明書フィンガープリントを構成する + dataSource.certificateFingerprint = "your_certificate_fingerprint"; + + // オプション: データ ソース レベルでフィールドの複数値処理を構成する + dataSource.fieldMultiValueLeniency = true; + } + + return dataSource; +} + +``` + + + + +```typescript +// データ ソース プロバイダーを作成する +const dataSourceItemProvider = async (userContext: IRVUserContext | null, dataSourceItem: RVDataSourceItem) => { + // 必須: 基になるデータ ソースを更新する + await dataSourceProvider(userContext, dataSourceItem.dataSource); + + if (dataSourceItem instanceof RVElasticsearchDataSourceItem) { + // 特定のインデックスを使用して構成する + if (dataSourceItem.id === "elasticsearchDataSourceItemId") { + dataSourceItem.index = "kibana_sample_data_ecommerce"; + } + + // またはカスタム SQL クエリを使用して構成する + if (dataSourceItem.id === "elasticsearchDataSourceItemCustomQueryId") { + dataSourceItem.customQuery = "SELECT * FROM \"kibana_sample_data_ecommerce\" WHERE \"customer_first_name\" = 'Eddie'"; + } + + // フィールドの複数値処理を構成する + dataSourceItem.fieldMultiValueLeniency = true; + } + + return dataSourceItem; +} + +const dataSourceProvider = async (userContext: IRVUserContext | null, dataSource: RVDashboardDataSource) => { + if (dataSource instanceof RVElasticsearchDataSource) { + // 接続プロパティを構成する + dataSource.nodes = ["http://localhost:9200"]; + + // オプション: SSL/TLS 証明書フィンガープリントを構成する + dataSource.certificateFingerprint = "your_certificate_fingerprint"; + + // オプション: データ ソース レベルでフィールドの複数値処理を構成する + dataSource.fieldMultiValueLeniency = true; + } + + return dataSource; +} +``` + + + + +:::danger 重要 +`ChangeDataSourceAsync` メソッドでデータ ソースに加えられた変更は、`ChangeDataSourceItemAsync` メソッドに引き継がれません。両方のメソッドでデータ ソース プロパティを更新する**必要があります**。上記の例に示すように、`ChangeDataSourceItemAsync` メソッド内で `ChangeDataSourceAsync` メソッドを呼び出し、データ ソース項目の基になるデータ ソースをパラメーターとして渡すことをお勧めします。 +::: + +### 認証 + +Elasticsearch の認証は、個人アクセス トークンを使用してサーバー側で処理されます。認証オプションの詳細については、「[認証](../authentication.md#ユーザー名パスワード認証)」トピックを参照してください。 + + + + +```csharp +public class AuthenticationProvider: IRVAuthenticationProvider +{ + public Task ResolveCredentialsAsync(IRVUserContext userContext, RVDashboardDataSource dataSource) + { + IRVDataSourceCredential userCredential = null; + + if (dataSource is RVElasticsearchDataSource) + { + userCredential = new RVUsernamePasswordDataSourceCredential("elastic", "your_password"); + } + + return Task.FromResult(userCredential); + } +} +``` + + + + +```javascript +const authenticationProvider = async (userContext, dataSource) => { + if (dataSource instanceof reveal.RVElasticsearchDataSource) { + return new reveal.RVUsernamePasswordDataSourceCredential("elastic", "your_password"); + } + return null; +} +``` + + + + +```ts +const authenticationProvider = async (userContext:IRVUserContext | null, dataSource: RVDashboardDataSource) => { + if (dataSource instanceof RVElasticsearchDataSource) { + return new RVUsernamePasswordDataSourceCredential("elastic", "your_password"); + } + return null; +} +``` + + + + +## クライアント側の実装 + +クライアント側では、データ ソースの ID、タイトル、サブタイトルなどの基本プロパティを指定するだけです。実際の接続構成はサーバー上で行われます。 + +### データ ソースの作成 + +**手順 1** - `RevealView.onDataSourcesRequested` イベントのイベント ハンドラーを追加します。 + +```js +const revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + // ここにデータ ソースを追加する + callback(new $.ig.RevealDataSources([], [], false)); +}; +``` + +**手順 2** - `RevealView.onDataSourcesRequested` イベント ハンドラーで、`RVElasticsearchDataSource` オブジェクトの新しいインスタンスを作成します。`title` プロパティと `subtitle` プロパティを設定します。`RVElasticsearchDataSource` オブジェクトを作成したら、それをデータ ソース コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + const elasticsearchDS = new $.ig.RVElasticsearchDataSource(); + elasticsearchDS.title = "My Elasticsearch Data Source"; + elasticsearchDS.subtitle = "Elasticsearch"; + + callback(new $.ig.RevealDataSources([elasticsearchDS], [], false)); +}; +``` + +アプリケーションを実行すると、新しい表示形式を作成すると、新しく作成された Elasticsearch データ ソースが [データ ソースの選択] ダイアログに表示されます。 + +### データ ソース項目の作成 + +データ ソース項目は、ユーザーが表示形式のために選択できる Elasticsearch データ ソース内の特定のデータセットを表します。クライアント側では、ID、タイトル、サブタイトルを指定するだけです。 + +```js +revealView.onDataSourcesRequested = (callback) => { + // データ ソースを作成する + const elasticsearchDS = new $.ig.RVElasticsearchDataSource(); + elasticsearchDS.title = "My Elasticsearch Data Source"; + elasticsearchDS.subtitle = "Elasticsearch"; + + // データ ソース アイテムを作成する + const elasticsearchDSI = new $.ig.RVElasticsearchDataSourceItem(elasticsearchDS); + elasticsearchDSI.id = "my-data-source-item"; + elasticsearchDSI.title = "My Elasticsearch Data Source Item"; + elasticsearchDSI.subtitle = "Elasticsearch"; + + callback(new $.ig.RevealDataSources([elasticsearchDS], [elasticsearchDSI], false)); +}; +``` + +アプリケーションを実行すると、新しい表示形式を作成すると、新しく作成された Elasticsearch データ ソース項目が [データ ソースの選択] ダイアログに表示されます。 + +## その他のリソース + +- [Elasticsearch ドキュメント](https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html) +- [Elasticsearch SQL ドキュメント](https://www.elastic.co/guide/en/elasticsearch/reference/current/xpack-sql.html) + +## API リファレンス + + + + +* [RVElasticsearchDataSource](https://help.revealbi.io/api/aspnet/latest/Reveal.Sdk.Data.Elasticsearch.RVElasticsearchDataSource.html) - Elasticsearch データ ソースを表します +* [RVElasticsearchDataSourceItem](https://help.revealbi.io/api/aspnet/latest/Reveal.Sdk.Data.Elasticsearch.RVElasticsearchDataSourceItem.html) - Elasticsearch データ ソース項目を表します + + + + +* [RVElasticsearchDataSource](https://help.revealbi.io/api/javascript/latest/classes/rvelasticsearchdatasource.html) - Elasticsearch データ ソースを表します +* [RVElasticsearchDataSourceItem](https://help.revealbi.io/api/javascript/latest/classes/rvelasticsearchdatasourceitem.html) - Elasticsearch データ ソース項目を表します + + + diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/excel-file.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/excel-file.md new file mode 100644 index 00000000..75dc9d97 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/excel-file.md @@ -0,0 +1,159 @@ +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# Excel ファイル データ ソースの追加 + +:::danger 重大な変更 + +現在、Reveal SDK は、Reveal SDK core パッケージからデータ ソースを分離する過程にあります。プロジェクトの継続的な機能を確保するために、プロジェクトに追加のパッケージをインストールすることが必要になる場合があります。詳細については、[サポートされるデータ ソース](web/datasources.md#サポートされるデータ-ソース) トピックを参照してください。 + +::: + +**手順 1** - サーバー アプリケーションで、Excel ファイルを格納するフォルダーを作成します。 + + + + +![](images/excel-file-folder.jpg) + + + + + +![](images/excel-file-folder-java.jpg) + + + + + +![](images/excel-file-folder-node.jpg) + + + + + +![](images/excel-file-folder-node.jpg) + + + + + +**手順 2** - `RevealEmbedSettings.LocalFileStoragePath` プロパティを**手順 1** で作成したフォルダーの場所に設定します。 + + + + +```cs +builder.Services.AddControllers().AddReveal( builder => +{ + builder.AddSettings(settings => + { + settings.LocalFileStoragePath = "Data"; + }); +}); +``` + + + + + +```java +RevealEngineInitializer.initialize(new InitializeParameterBuilder() +.setLocalFilesStoragePath("data") +.build()); +``` + + + + + +```js +const revealOptions = { + localFileStoragePath: "data" +} +app.use('/', reveal(revealOptions)); +``` + + + + + +```ts +const revealOptions: RevealOptions = { + localFileStoragePath: "data" +} +app.use('/', reveal(revealOptions)); +``` + + + + +**手順 3** - `RevealView.onDataSourcesRequested` イベントのイベント ハンドラーを追加します。 + +まず、`id` を `revealView` に設定した `
` タグを定義します。 + +```html +
+``` + +`revealView` を初期化し、イベント ハンドラーを追加します。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + //add code here + callback(new $.ig.RevealDataSources([], [], true)); +}; +``` + +**手順 4** - `RevealView.onDataSourcesRequested` イベント ハンドラーで、`RVLocalFileDataSourceItem` オブジェクトの新しいインスタンスを作成します。`Uri` プロパティを、データ ソースとして使用する Excel ファイルのパス (ファイル名を含む) に設定します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + var localFileItem = new $.ig.RVLocalFileDataSourceItem(); + localFileItem.uri = "local:/Samples.xlsx"; + + callback(new $.ig.RevealDataSources([], [], true)); +}; +``` + +:::caution + +Excel ファイルパスの前に `local:/` を付ける必要があります。これは、`RevealEmbedSettings.LocalFileStoragePath` をファイル パスのルートとして使用してファイルを読み込むように Reveal SDK に指示するためです。ルート パス内にサブフォルダーがある場合は、これらのサブフォルダーを `Uri` プロパティに含めるようにしてください。 + +例: +* サブフォルダーなし - `RVLocalFileDataSourceItem.Uri = "local:/FileName.xlsx"` +* サブフォルダーあり - `RVLocalFileDataSourceItem.Uri = "local:/SubFolder/FileName.xlsx"` +::: + +**手順 5** - 前の手順で作成した `RVLocalFileDataSourceItem` インスタンスをコンストラクター引数に指定して、`RVExcelDataSourceItem` オブジェクトの新しいインスタンスを作成し、`Title` プロパティを Excel ファイル内のデータを説明する文字列に設定します。 + +最後に、`RVExcelDataSourceItem` オブジェクトを `callback` のデータ ソース項目配列に追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + var localFileItem = new $.ig.RVLocalFileDataSourceItem(); + localFileItem.uri = "local:/Samples.xlsx"; + + var excelDataSourceItem = new $.ig.RVExcelDataSourceItem(localFileItem); + excelDataSourceItem .title = "Local Excel File"; + + callback(new $.ig.RevealDataSources([], [excelDataSourceItem], true)); +}; +``` + +アプリケーションを開始し、新しい表示形式を作成すると、[データ ソースの選択] ダイアログに新しく作成された Excel ファイル データ ソースが表示されます。 + +![](images/excel-file-data-source.jpg) + +:::info コードの取得 + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/DataSources/ExcelFile) にあります。 + +::: + +:::caution + +サーバーがクライアント アプリケーションとは異なる URL で実行されている場合は、`$.ig.RevealSdkSettings.setBaseUrl` を呼び出す必要があります。サーバー アプリケーションとクライアント アプリケーションの両方が同じ URL で実行されている場合、このメソッドは必要ありません。このメソッドを呼び出す必要があるのは 1 回だけです。 + +::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/google-big-query.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/google-big-query.md new file mode 100644 index 00000000..cbbf941b --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/google-big-query.md @@ -0,0 +1,71 @@ +--- +pagination_next: web/authentication +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# Google BigQuery データ ソースの追加 + +:::danger 重大な変更 + +現在、Reveal SDK は、Reveal SDK core パッケージからデータ ソースを分離する過程にあります。プロジェクトの継続的な機能を確保するために、プロジェクトに追加のパッケージをインストールすることが必要になる場合があります。詳細については、[サポートされるデータ ソース](web/datasources.md#サポートされるデータ-ソース) トピックを参照してください。 + +::: + +**手順 1** - `RevealView.onDataSourcesRequested` イベントのイベント ハンドラーを追加します。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + //add code here + callback(new $.ig.RevealDataSources([], [], false)); +}; +``` + +**手順 2** - `RevealView.onDataSourcesRequested` イベント ハンドラーで、[RVBigQueryDataSource](https://help.revealbi.io/api/javascript/latest/classes/rvbigquerydatasource.html) オブジェクトの新しいインスタンスを作成します。`Title` プロパティを設定します。`RVBigQueryDataSource` オブジェクトを作成したら、それをデータ ソース項目コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + var bigQuery = new $.ig.RVBigQueryDataSource(); + bigQuery.title = "My Big Query"; + + callback(new $.ig.RevealDataSources([bigQuery], [], false)); +}; +``` +アプリケーションを実行し、新しい可視化を作成すると、新しく作成された Big Query データ ソースが [データ ソースの選択] ダイアログに 表示されます。 + +![](images/big-query-data-source.jpg) + +:::note + +`RVBigQueryDataSource` は、Reveal SDK に登録された認証プロバイダーに基づいてテーブルを読み込みます。Google Big Query は `RVBearerTokenDataSourceCredential` を使用して認証します。詳細については、[認証](../authentication.md#ベアラー-トークン認証)トピックを参照してください。 + +::: + +**手順 3** - [RVBigQueryDataSourceItem](https://help.revealbi.io/api/javascript/latest/classes/rvbigquerydatasourceitem.html) オブジェクトの新しいインスタンスを作成して、新しい Big Query データ ソース項目を作成します。`Title` および `Subtitle` プロパティの値を指定します。`RVBigQueryDataSourceItem` オブジェクトを作成したら、それをデータ ソース項目コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + var bigQuery = new $.ig.RVBigQueryDataSource(); + bigQuery.title = "My Big Query"; + bigQuery.subtitle = "My Big Query Subtitle"; + + var bigQueryItem = new $.ig.RVBigQueryDataSourceItem(bigQuery); + bigQueryItem.title = "My Big Query Item"; + bigQueryItem.subtitle = "My Big Query Item Subtitle"; + + callback(new $.ig.RevealDataSources([bigQuery], [bigQueryItem], false)); +}; +``` + +アプリケーションが実行されたら、新しい可視化を作成すると、新しく作成された Big Query データ ソース項目が [データ ソースの選択] ダイアログに表示されます。 + +![](images/big-query-data-source-item.jpg) + + +:::info コードの取得 + +このサンプルのソース コードは、[GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/DataSources/BigQuery-ServiceAccount) にあります。 + +::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/google-sheets.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/google-sheets.md new file mode 100644 index 00000000..e320b20d --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/google-sheets.md @@ -0,0 +1,71 @@ +--- +pagination_next: web/authentication +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# Google スプレッドシート データ ソースの追加 + +:::danger 重大な変更 + +現在、Reveal SDK は、Reveal SDK core パッケージからデータ ソースを分離する過程にあります。プロジェクトの継続的な機能を確保するために、プロジェクトに追加のパッケージをインストールすることが必要になる場合があります。詳細については、[サポートされるデータ ソース](web/datasources.md#サポートされるデータ-ソース) トピックを参照してください。 + +::: + +**手順 1** - `RevealView.onDataSourcesRequested` イベントのイベント ハンドラーを追加します。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + //add code here + callback(new $.ig.RevealDataSources([], [], false)); +}; +``` + +**手順 2** - `RevealView.onDataSourcesRequested` イベント ハンドラーで、[RVGoogleDriveDataSourceItem](https://help.revealbi.io/api/javascript/latest/classes/rvgoogledrivedatasourceitem.html) オブジェクトの新しいインスタンスを作成します。`Identifier` プロパティを Google スプレッドシート ID に設定します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + //get file from google drive + const googleDriveDSI = new $.ig.RVGoogleDriveDataSourceItem(); + googleDriveDSI.identifier = "file_identifier"; + + callback(new $.ig.RevealDataSources([], [], false)); +}; +``` + +`Identifier` とも呼ばれる Google スプレッドシート ID は、Google スプレッドシートで作成する各スプレッドシートの一意の識別子です。`Identifier` を見つける最も簡単な方法は、スプレッドシートの URL を確認することです。URL では、スプレッドシート ID は、URL の「/d/」部分の後に続く文字と数字の文字列です。 + +![](images/google-sheets-url-identifier.jpg) + +この例では、`Identifier` は **1Tv8z8ya_qTfaiRSYv0U_z21nubgzE_-ZskuPbP1VDxA** です。 + +**手順 3** - [RVGoogleSheetDataSourceItem](https://help.revealbi.io/api/javascript/latest/classes/rvgooglesheetdatasourceitem.html) オブジェクトの新しいインスタンスを作成して、新しい Google スプレッドシート データ ソース項目を作成します。値に対応する `Title`、`Subtitle`、および `Sheet` プロパティを設定します。`RVGoogleSheetDataSourceItem` オブジェクトを作成したら、それをデータ ソース項目コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + //get file from google drive + const googleDriveDSI = new $.ig.RVGoogleDriveDataSourceItem(); + googleDriveDSI.identifier = "file_identifier"; + + //indicate the file is a google sheet and set the sheet name + const googleSheet = new $.ig.RVGoogleSheetDataSourceItem(googleDriveDSI); + googleDriveDSI.title = "My Google Sheet"; + googleSheet.subtitle = "Google Drive"; + googleSheet.sheet = "Sheet1"; + + callback(new $.ig.RevealDataSources([], [googleSheet], false)); +}; +``` + +アプリケーションが実行されたら、新しい可視化を作成すると、新しく作成された Google スプレッド データ ソース項目が [データ ソースの選択] ダイアログに表示されます。 + +![](images/google-sheets-data-source.jpg) + + +:::info コードの取得 + +このサンプルのソース コードは、[GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/DataSources/GoogleSheets-ServiceAccount) にあります。 + +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/amazon-athena-data-source-item.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/amazon-athena-data-source-item.jpg new file mode 100644 index 00000000..c174b39e Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/amazon-athena-data-source-item.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/amazon-athena-data-source.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/amazon-athena-data-source.jpg new file mode 100644 index 00000000..27d53bd9 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/amazon-athena-data-source.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/amazon-s3-data-source.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/amazon-s3-data-source.jpg new file mode 100644 index 00000000..a9a6a53a Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/amazon-s3-data-source.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/big-query-data-source-item.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/big-query-data-source-item.jpg new file mode 100644 index 00000000..88d006e7 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/big-query-data-source-item.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/big-query-data-source.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/big-query-data-source.jpg new file mode 100644 index 00000000..3c477913 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/big-query-data-source.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/csv-data-source-item.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/csv-data-source-item.jpg new file mode 100644 index 00000000..e79cab50 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/csv-data-source-item.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/databricks-data-source-item.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/databricks-data-source-item.jpg new file mode 100644 index 00000000..97566fe5 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/databricks-data-source-item.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/databricks-data-source.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/databricks-data-source.jpg new file mode 100644 index 00000000..e77728d2 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/databricks-data-source.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/excel-file-data-source.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/excel-file-data-source.jpg new file mode 100644 index 00000000..870c2791 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/excel-file-data-source.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/excel-file-folder-java.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/excel-file-folder-java.jpg new file mode 100644 index 00000000..8eb9ec2c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/excel-file-folder-java.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/excel-file-folder-node.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/excel-file-folder-node.jpg new file mode 100644 index 00000000..adf07293 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/excel-file-folder-node.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/excel-file-folder.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/excel-file-folder.jpg new file mode 100644 index 00000000..3285f638 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/excel-file-folder.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/google-sheets-data-source.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/google-sheets-data-source.jpg new file mode 100644 index 00000000..fbf7f3b3 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/google-sheets-data-source.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/google-sheets-url-identifier.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/google-sheets-url-identifier.jpg new file mode 100644 index 00000000..e6903ca4 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/google-sheets-url-identifier.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/json-data-source-item.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/json-data-source-item.jpg new file mode 100644 index 00000000..22270492 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/json-data-source-item.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/mariadb-data-source-item.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/mariadb-data-source-item.jpg new file mode 100644 index 00000000..7cb98a6f Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/mariadb-data-source-item.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/mariadb-data-source.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/mariadb-data-source.jpg new file mode 100644 index 00000000..fbd55f7f Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/mariadb-data-source.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/mongodb-data-source-item.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/mongodb-data-source-item.jpg new file mode 100644 index 00000000..e406c00b Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/mongodb-data-source-item.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/mongodb-data-source.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/mongodb-data-source.jpg new file mode 100644 index 00000000..2595182d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/mongodb-data-source.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/ms-sql-server-data-source-item.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/ms-sql-server-data-source-item.jpg new file mode 100644 index 00000000..ba0d63b5 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/ms-sql-server-data-source-item.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/ms-sql-server-data-source.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/ms-sql-server-data-source.jpg new file mode 100644 index 00000000..067c0bc3 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/ms-sql-server-data-source.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/mysql-data-source-item.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/mysql-data-source-item.jpg new file mode 100644 index 00000000..eb4ff794 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/mysql-data-source-item.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/mysql-data-source.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/mysql-data-source.jpg new file mode 100644 index 00000000..c4b8b51c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/mysql-data-source.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/oracle-data-source-item.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/oracle-data-source-item.jpg new file mode 100644 index 00000000..bb0c69e0 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/oracle-data-source-item.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/oracle-data-source.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/oracle-data-source.jpg new file mode 100644 index 00000000..f7e1f68d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/oracle-data-source.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/postgres-data-source-item.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/postgres-data-source-item.jpg new file mode 100644 index 00000000..a6a30f49 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/postgres-data-source-item.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/postgres-data-source.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/postgres-data-source.jpg new file mode 100644 index 00000000..7d320261 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/postgres-data-source.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/rest-data-source.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/rest-data-source.jpg new file mode 100644 index 00000000..2f79c478 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/rest-data-source.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/snowflake-data-source-item.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/snowflake-data-source-item.jpg new file mode 100644 index 00000000..c2124e12 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/snowflake-data-source-item.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/snowflake-data-source.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/snowflake-data-source.jpg new file mode 100644 index 00000000..266e3f9b Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/snowflake-data-source.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/web-resource-data-source.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/web-resource-data-source.jpg new file mode 100644 index 00000000..83e36d00 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/images/web-resource-data-source.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/in-memory-data.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/in-memory-data.md new file mode 100644 index 00000000..8e07db12 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/in-memory-data.md @@ -0,0 +1,299 @@ +# インメモリ データ ソースの追加 + +:::danger 重大な変更 + +現在、Reveal SDK は、Reveal SDK core パッケージからデータ ソースを分離する過程にあります。プロジェクトの継続的な機能を確保するために、プロジェクトに追加のパッケージをインストールすることが必要になる場合があります。詳細については、[サポートされるデータ ソース](web/datasources.md#サポートされるデータ-ソース) トピックを参照してください。 + +::: + +Reveal SDK を使用すると、実行時に生成されたデータを使用してダッシュボードを作成できます。このデータは通常、ASP.NET Web API サーバー アプリケーション内で使用されるビジネス オブジェクト (POCO クラス) によってサポートされます。このタイプのデータは、**インメモリ データ**と呼ばれます。 + +アプリケーションのインメモリ データを Reveal SDK のデータ ソース項目として追加するには、主に 3 つの手順があります。 + +**手順 1** - ASP.NET Web API サーバー アプリケーションで、`IRVDataProvider` を実装するクラスを作成します。このクラスは、Reveal SDK に返される実際のインメモリ データを提供します。`RVInMemoryDataSourceItem.DatasetId` プロパティをチェックして、返すデータを確認する必要があります。 + +```cs +public class MyInMemoryDataProvider: IRVDataProvider +{ + public Task GetData(IRVUserContext userContext, RVInMemoryDataSourceItem dataSourceItem) + { + if (dataSourceItem.DatasetId == "MyDataSetId") + { + return Task.FromResult(new RVInMemoryData(your-data)); + } + else + { + throw new Exception("Invalid datasetId"); + } + } +} +``` + +`GetData` メソッドは、`Task` を返します。つまり、使用するインメモリ データはすべて `RVInMemoryData` オブジェクトでラップする必要があります。インメモリ データをコンストラクター引数に指定して `RVInMemoryData` オブジェクトの新しいインスタンスを作成するだけです。 + +**手順 2** - `RevealSetupBuilder.AddDataProvider` メソッドを使用して、作成した `IRVDataProvider` を `RevealSetupBuilder` に追加するよう、`Program.cs` ファイル の `AddReveal` メソッドを更新します。 + +```cs +builder.Services.AddControllers().AddReveal( builder => +{ + builder.AddDataProvider(); +}); +``` + +**手順 3** - `RevealView.onDataSourcesRequested` イベント内で `$.ig.RVInMemoryDataSourceItem` を作成します。 + +`RevealView.onDataSourcesRequested` にイベント ハンドラーを追加します。 + +まず、`id` を `revealView` に設定した `
` タグを定義します。 + +```html +
+``` + +次に、イベント ハンドラーで、`$.ig.RVInMemoryDataSourceItem` オブジェクトの新しいインスタンスを作成し、パラメーターとして一意の名前 / ID を指定します。この ID は、`IRVDataProvider` で、要求しているデータはどのデータ ソースかを示すために使用されます。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + + var inMemoryDataSourceItem = new $.ig.RVInMemoryDataSourceItem("MyDataSetId"); + inMemoryDataSourceItem.title = "My Data"; + + callback(new $.ig.RevealDataSources([], [inMemoryDataSourceItem], true)); +}; +``` + +:::caution + +サーバーがクライアント アプリケーションとは異なる URL で実行されている場合は、`$.ig.RevealSdkSettings.setBaseUrl` を呼び出す必要があります。サーバー アプリケーションとクライアント アプリケーションの両方が同じ URL で実行されている場合、このメソッドは必要ありません。このメソッドを呼び出す必要があるのは 1 回だけです。 + +::: + +## 例: インメモリ データ ソースの実装 + +### ビジネス オブジェクトの作成 + +ASP.NET Web API サーバー アプリケーションで、`Product`、`Seller`、および `Sale` の 3 つのビジネス オブジェクトを作成します。これらのオブジェクトは、ダッシュボードに表示されるデータを保持するために使用されます。 + +```cs +public class Product +{ + public string Name { get; set; } = string.Empty; + public double UnitPrice { get; set; } +} + +public class Seller +{ + public string Name { get; set; } = string.Empty; + public string City { get; set; } = string.Empty; +} + +public class Sale +{ + internal Product Product { get; set; } = new Product(); + + internal Seller Seller { get; set; } = new Seller(); + + public string SalesPerson + { + get { return Seller.Name; } + set { Seller.Name = value; } + } + + public DateTime Date { get; set; } + + public string City + { + get { return Seller.City; } + set { Seller.City = value; } + } + + public string ProductName + { + get { return Product.Name; } + set { Product.Name = value; } + } + + internal double Value { get; set; } + + internal string Quarter { get; set; } = string.Empty; + + public int NumberOfUnits { get; set; } + + public double UnitPrice + { + get { return Product.UnitPrice; } + set { Product.UnitPrice = value; } + } + + public int AmountOfSale + { + get { return (int)UnitPrice * NumberOfUnits; } + set { Product.UnitPrice = value / NumberOfUnits; } + } +} +``` + +### インメモリ データの生成 + +次に、Reveal ダッシュボードの構築に使用されるデータを生成する必要があります。このために、ダッシュボードで使用するランダム データを生成する `SalesDataGenerator` というヘルパー クラスを作成します。 + +```cs +public class SalesDataGenerator +{ + private static string[] _products = new string[4] { "Apple", "Grape", "Orage", "Banana" }; + private static string[] _sellerNames = new string[8] { "Ellen Adams", "Lisa Andrews", "William Fox", "Walter Harp", "Jessica Oxley", "Misty Shock", "Chris Meyer", "Jay Calvin" }; + private static string[] _cities = new string[6] { "Tokyo", "Shanghai", "Beijing", "Singapore", "New York", "Seoul" }; + private static readonly Random Random = new Random(); + public static List GenerateSales(int numberOfSales) + { + List sales = new List(); + + for (double i = 0; i < numberOfSales; i++) + { + Sale sale = new Sale + { + Quarter = "Q " + i, + Value = GetRandomPrice(), + Date = GetRandomDate(), + Product = GerRandomProduct(), + NumberOfUnits = GetRandomNumUnits(), + Seller = GetRandomSeller() + }; + sales.Add(sale); + } + return sales; + } + + private static Seller GetRandomSeller() + { + return new Seller + { + City = GetRandomCity(), + Name = GetRandomSellerName() + }; + } + + private static string GetRandomSellerName() + { + Random a = new Random(Random.Next()); + int length = _sellerNames.Length; + int RandomMaxLength = a.Next(length) % 2 == 0 ? a.Next(length) : length; + return _sellerNames[a.Next(RandomMaxLength)]; + } + + private static string GetRandomCity() + { + Random a = new Random(Random.Next()); + int length = _cities.Length; + int RandomMaxLength = a.Next(length) % 2 == 0 ? a.Next(length) : length; + return _cities[a.Next(RandomMaxLength)]; + } + + private static int GetRandomNumUnits() + { + Random a = new Random(Random.Next()); + return a.Next(1, 100); + } + + private static Product GerRandomProduct() + { + return new Product + { + Name = GetRandomProductName(), + UnitPrice = GetRandomPrice() + }; + } + + private static double GetRandomPrice() + { + Random a = new Random(Random.Next()); + return a.NextDouble() * 1000; + } + + private static string GetRandomProductName() + { + Random a = new Random(Random.Next()); + int length = _products.Length; + int RandomMaxLength = a.Next(length) % 2 == 0 ? a.Next(length) : length; + return _products[a.Next(RandomMaxLength)]; + } + + private static DateTime GetRandomDate() + { + Random a = new Random(Random.Next()); + int day = a.Next(1, 28); + int month = a.Next(1, 13); + int year = a.Next(2016, 2020); + + return new DateTime(year, month, day); + } +} +``` + +### データ プロバイダーの作成 + +ダッシュボードで使用するデータを作成したので、次の手順は、そのデータを Reveal SDK で利用できるようにすることです。これを行うには、`IRVDataProvider` を実装する新しいクラスを作成する必要があります。このインターフェイスは、Reveal SDK 内のインメモリ データの実装に特に使用されます。 + +`MyInMemoryDataProvider` という新しいクラスを作成し、`IRVDataProvider` インターフェイスを実装しましょう。`_salesInMemoryData` という名前の変数を定義し、`SalesDataGenerator` を使用して生成した 10,000 個のデータ レコードを参照していることに注意してください。 + +```cs +public class MyInMemoryDataProvider: IRVDataProvider +{ + RVInMemoryData _salesInMemoryData = new RVInMemoryData(SalesDataGenerator.GenerateSales(10000)); + + public Task GetData(IRVUserContext userContext, RVInMemoryDataSourceItem dataSourceItem) + { + if (dataSourceItem.DatasetId == "SalesRecords") + { + return Task.FromResult(_salesInMemoryData); + } + else + { + throw new Exception("Invalid datasetId"); + } + } +} +``` + +ご覧のとおり、`GetData` メソッドでは、`DatasetId` で特定の値をチェックしています。この ID が `SalesRecords` データ ソース項目と一致する場合、ダッシュボードのデータ ソースとして `_salesInMemoryData` 変数に格納されているインメモリ ビジネス オブジェクト コレクションを使用します。 + +データとデータ プロバイダーができたので、`RevealSetupBuilder.AddDataProvider` メソッドを使用して、作成した `IRVDataProvider` を `RevealSetupBuilder` に追加するよう、`Program.cs` ファイルの `AddReveal` メソッドを更新する必要があります。 + +```cs +builder.Services.AddControllers().AddReveal( builder => +{ + builder.AddDataProvider(); +}); +``` + +ここで、`DataSetId` 値について疑問に思われるかもしれません。これは、次の手順でデータ ソース項目を作成するときに発生します。 + +### onDataSourcesRequested イベントの処理 + +次の手順は、`RevealView.onDataSourcesRequested` イベントにイベント ハンドラーを追加することです。 + +まず、`id` を `revealView` に設定した `
` タグを定義します。 + +```html +
+``` + +ここで、`revealView` を初期化し、`RevealView.onDataSourcesRequested` イベントを処理します。この例では、**SalesRecords** の `id` と **SalesRecords** に設定された `title` で新しい `$.ig.RVInMemoryDataSourceItem` を作成しています。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + + var inMemoryDSI = new $.ig.RVInMemoryDataSourceItem("SalesRecords"); + inMemoryDSI.title = "Sales Records"; + + callback(new $.ig.RevealDataSources([], [inMemoryDSI], true)); +}; +``` + +:::info コードの取得 + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/DataSources/InMemory) にあります。 + +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/json.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/json.md new file mode 100644 index 00000000..c701a476 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/json.md @@ -0,0 +1,94 @@ +--- +pagination_next: web/authentication +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# JSON データ ソースの追加 + +:::danger 重大な変更 + +現在、Reveal SDK は、Reveal SDK core パッケージからデータ ソースを分離する過程にあります。プロジェクトの継続的な機能を確保するために、プロジェクトに追加のパッケージをインストールすることが必要になる場合があります。詳細については、[サポートされるデータ ソース](web/datasources.md#サポートされるデータ-ソース) トピックを参照してください。 + +::: + +**手順 1** - `RevealView.onDataSourcesRequested` イベントのイベント ハンドラーを追加します。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + //add code here + callback(new $.ig.RevealDataSources([], [], false)); +}; +``` + +**手順 2** - `RevealView.onDataSourcesRequested` イベント ハンドラーで、[RVWebResourceDataSource](https://help.revealbi.io/api/javascript/latest/classes/rvwebresourcedatasource.html) オブジェクトの新しいインスタンスを作成します。CSV リソースへのアクセスに認証が必要ない場合は、`URL` プロパティを CSV リソースの URL に設定し、`useAnonymousAuthentication` プロパティを `false` に設定します。オプションで、`RVWebResourceDataSource` オブジェクトをコールバックのデータ ソース コレクションに追加して、RevealView の [データ ソース] ダイアログに表示できます。 + +```js +revealView.onDataSourcesRequested = (callback) => { + const webDS = new $.ig.RVWebResourceDataSource(); + webDS.title = "Web Data Source"; + webDS.subtitle = "Web Data Source Subtitle"; + webDS.url = "https://excel2json.io/api/share/6e0f06b3-72d3-4fec-7984-08da43f56bb9"; + webDS.useAnonymousAuthentication = true; + + callback(new $.ig.RevealDataSources([webDS], [], false)); +}; +``` + +アプリケーションが実行されたら、新しい可視化を作成すると、新しく作成された Web リソース データ ソースが [データ ソースの選択] ダイアログに表示されます。 + +![](images/web-resource-data-source.jpg) + +**手順 3** - データ ソース ダイアログの **[JSON の設定]** 画面をスキップして JSON データを直接使用するには、[RVWebResourceDataSourceItem](https://help.revealbi.io/api/javascript/latest/classes/rvwebresourcedatasourceitem.html) の新しいインスタンスを作成し、前の手順で作成した `RVWebResourceDataSource` オブジェクトをコンストラクター引数として渡します。次に、[RVJsonDataSourceItem](https://help.revealbi.io/api/javascript/latest/classes/rvjsondatasourceitem.html) の新しいインスタンスを作成し、「RVWebResourceDataSourceItem」 をコンストラクター引数として渡します。`Title` と `Subtitle` プロパティを設定します。最後に、`Config` プロパティをデータの構造を表す JSON 文字列に設定する**必要があります**。このプロセスを簡単にするために、[RVJsonSchemaConfigBuilder](https://help.revealbi.io/api/javascript/latest/classes/rvjsonschemaconfigbuilder.html) クラスを使用して、流暢な API を使用して JSON 構造を構築できます。 + +`RVJsonDataSourceItem` オブジェクトを作成したら、それをデータ ソース項目コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + const webDS = new $.ig.RVWebResourceDataSource(); + webDS.title = "Web Data Source"; + webDS.subtitle = "Web Data Source Subtitle"; + webDS.url = "https://raw.githubusercontent.com/fivethirtyeight/data/master/airline-safety/airline-safety.csv"; + webDS.useAnonymousAuthentication = true; + + //to skip the "Set up your JSON" dialog and directly use the JSON data + const webDSI = new $.ig.RVWebResourceDataSourceItem(webDS); + const jsonDSI = new $.ig.RVJsonDataSourceItem(webDSI); + jsonDSI.title = "Sales by Category"; + jsonDSI.subtitle = "Excel2Json"; + jsonDSI.config = new $.ig.RVJsonSchemaConfigBuilder() + .addNumericField("CategoryID") + .addStringField("CategoryName") + .addStringField("ProductName") + .addNumericField("ProductSales") + .build(); + + callback(new $.ig.RevealDataSources([webDS], [jsonDSI], false)); +}; +``` + +アプリケーションが実行されたら、新しい3可視化を作成すると、[データ ソースの選択] ダイアログに新しく作成された JSON データ ソース項目が表示されます。 + +![](images/json-data-source-item.jpg) + +# ネストされたプロパティの操作 + +JSON では、データは階層的に編成され、多くの場合、オブジェクトに他のオブジェクトまたは配列が含まれる入れ子構造が特徴です。これらの構造をプログラムでナビゲートするには、ネストされたプロパティを指定できます。これは基本的に、目的のデータにつながるキーまたはインデックスのシーケンスです。 +```js +const jsonDsItem = new $.ig.RVJsonDataSourceItem(dsItem); +jsonDsItem.config = new RevealApi.RVJsonSchemaConfigBuilder() + .addStringField("fieldA") + .addNumericField("fieldB") + .addNumericField("/geo/location/lat") + .addNumericField("/geo/location/lng") + .setIterationDepth(0) + .build(); +``` + +:::info コードの取得 + +このサンプルのソース コードは、[GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/DataSources/Json) にあります。 + +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/mariadb.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/mariadb.md new file mode 100644 index 00000000..e92c2c6a --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/mariadb.md @@ -0,0 +1,290 @@ +--- +pagination_next: web/authentication +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# MariaDB Data Source + +## Introduction + +MariaDB is a community-developed, commercially supported open-source relational database that is a drop-in replacement for MySQL. This topic explains how to connect to MariaDB data sources in your Reveal application to visualize and analyze your data. + + +## Server Configuration + +### Installation + + + + +**Step 1** - Install the Reveal MariaDB connector package + +For ASP.NET applications, you need to install a separate NuGet package to enable MariaDB support: + +```bash +dotnet add package Reveal.Sdk.Data.MariaDB +``` + +**Step 2** - Register the MariaDB data source in your application: + +```csharp +builder.Services.AddControllers().AddReveal(builder => +{ + builder.DataSources.RegisterMariaDB(); +}); +``` + + + + +For Node.js applications, the MariaDB data source is already included in the main Reveal SDK package. No additional installation is required beyond the standard Reveal SDK setup. + + + + + +### Connection Configuration + + + + +```csharp +// Create a data source provider +public class DataSourceProvider : IRVDataSourceProvider +{ + public async Task ChangeDataSourceItemAsync(IRVUserContext userContext, string dashboardId, RVDataSourceItem dataSourceItem) + { + // Required: Update the underlying data source + await ChangeDataSourceAsync(userContext, dataSourceItem.DataSource); + + if (dataSourceItem is RVMariaDBDataSourceItem mariadbItem) + { + // Configure specific item properties as needed + if (mariadbItem.Id == "mariadb_sales_data") + { + mariadbItem.Table = "orders"; + } + } + + return dataSourceItem; + } + + public Task ChangeDataSourceAsync(IRVUserContext userContext, RVDashboardDataSource dataSource) + { + if (dataSource is RVMariaDBDataSource mariadbDS) + { + // Configure connection properties + mariadbDS.Host = "localhost"; + mariadbDS.Port = 3306; + mariadbDS.Database = "your-db-name"; + } + + return Task.FromResult(dataSource); + } +} +``` + + + + +```javascript +// Create data source providers +const dataSourceItemProvider = async (userContext, dataSourceItem) => { + // Required: Update the underlying data source + await dataSourceProvider(userContext, dataSourceItem.dataSource); + + if (dataSourceItem instanceof reveal.RVMariaDBDataSourceItem) { + // Configure specific item properties if needed + if (dataSourceItem.id === "mariadb_sales_data") { + dataSourceItem.table = "orders"; + } + } + + return dataSourceItem; +} + +const dataSourceProvider = async (userContext, dataSource) => { + if (dataSource instanceof reveal.RVMariaDBDataSource) { + // Configure connection properties + dataSource.host = "localhost"; + dataSource.port = 3306; + dataSource.database = "your-db-name"; + } + + return dataSource; +} +``` + + + + +```typescript +// Create data source providers +const dataSourceItemProvider = async (userContext: IRVUserContext | null, dataSourceItem: RVDataSourceItem) => { + // Required: Update the underlying data source + await dataSourceProvider(userContext, dataSourceItem.dataSource); + + if (dataSourceItem instanceof RVMariaDBDataSourceItem) { + // Configure specific item properties if needed + if (dataSourceItem.id === "mariadb_sales_data") { + dataSourceItem.table = "orders"; + } + } + + return dataSourceItem; +} + +const dataSourceProvider = async (userContext: IRVUserContext | null, dataSource: RVDashboardDataSource) => { + if (dataSource instanceof RVMariaDBDataSource) { + // Configure connection properties + dataSource.host = "localhost"; + dataSource.port = 3306; + dataSource.database = "your-db-name"; + } + + return dataSource; +} +``` + + + + + +:::danger Important +Any changes made to the data source in the `ChangeDataSourceAsync` method are not carried over into the `ChangeDataSourceItemAsync` method. You **must** update the data source properties in both methods. We recommend calling the `ChangeDataSourceAsync` method within the `ChangeDataSourceItemAsync` method passing the data source item's underlying data source as the parameter as shown in the examples above. +::: + +### Authentication + +Authentication for MariaDB is typically handled with username and password. For detailed information on authentication options, see the [Authentication](web/authentication.md) topic. + + + + +```csharp +public class AuthenticationProvider : IRVAuthenticationProvider +{ + public Task ResolveCredentialsAsync(IRVUserContext userContext, RVDashboardDataSource dataSource) + { + IRVDataSourceCredential userCredential = null; + if (dataSource is RVMariaDBDataSource) + { + userCredential = new RVUsernamePasswordDataSourceCredential("your_username", "your_password"); + } + return Task.FromResult(userCredential); + } +} +``` + + + + +```javascript +const authenticationProvider = async (userContext, dataSource) => { + if (dataSource instanceof reveal.RVMariaDBDataSource) { + return new reveal.RVUsernamePasswordDataSourceCredential("your_username", "your_password"); + } + return null; +} +``` + + + + +```ts +const authenticationProvider = async (userContext: IRVUserContext | null, dataSource: RVDashboardDataSource) => { + if (dataSource instanceof RVMariaDBDataSource) { + return new RVUsernamePasswordDataSourceCredential("your_username", "your_password"); + } + return null; +} +``` + + + + + +## Client-Side Implementation + +On the client side, you only need to specify basic properties like ID, title, and subtitle for the data source. The actual connection configuration happens on the server. + +### Creating Data Sources + +**Step 1** - Add an event handler for the `RevealView.onDataSourcesRequested` event. + +```js +const revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + // Add data source here + callback(new $.ig.RevealDataSources([], [], false)); +}; +``` + +**Step 2** - In the `RevealView.onDataSourcesRequested` event handler, create a new instance of the `RVMariaDBDataSource` object. Set the `title` and `subtitle` properties. After you have created the `RVMariaDBDataSource` object, add it to the data sources collection. + +```js +revealView.onDataSourcesRequested = (callback) => { + const mariadbDS = new $.ig.RVMariaDBDataSource(); + mariadbDS.title = "MariaDB"; + mariadbDS.subtitle = "Data Source"; + + callback(new $.ig.RevealDataSources([mariadbDS], [], false)); +}; +``` + +When the application runs, create a new Visualization and you will see the newly created MariaDB data source listed in the "Select a Data Source" dialog. + +![](images/mariadb-data-source.jpg) + +### Creating Data Source Items + +Data source items represent specific tables or datasets within your MariaDB data source that users can select for visualization. On the client side, you only need to specify ID, title, and subtitle. + +```js +revealView.onDataSourcesRequested = (callback) => { + // Create the data source + const mariadbDS = new $.ig.RVMariaDBDataSource(); + mariadbDS.title = "My MariaDB Datasource"; + mariadbDS.subtitle = "MariaDB"; + + // Create a data source item + const mariadbDSI = new $.ig.RVMariaDBDataSourceItem(mariadbDS); + mariadbDSI.id = "mariadb_sales_data"; + mariadbDSI.title = "My MariaDB Datasource Item"; + mariadbDSI.subtitle = "MariaDB"; + + callback(new $.ig.RevealDataSources([mariadbDS], [mariadbDSI], true)); +}; +``` + +When the application runs, create a new Visualization and you will see the newly created MariaDB data source item listed in the "Select a Data Source" dialog. + +![](images/mariadb-data-source-item.jpg) + +:::warning Error Messages +MariaDB is MySQL-compatible, and it is common for drivers and error messages to reference MySQL even when connected to MariaDB. +::: + +## Additional Resources + +- [MariaDB Documentation](https://mariadb.com/kb/en/documentation/) +- [Sample Source Code on GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/DataSources/MariaDB) + +## API Reference + + + + +* [RVMariaDBDataSource](https://help.revealbi.io/api/aspnet/latest/Reveal.Sdk.Data.MariaDB.RVMariaDBDataSource.html) - Represents a MariaDB data source +* [RVMariaDBDataSourceItem](https://help.revealbi.io/api/aspnet/latest/Reveal.Sdk.Data.MariaDB.RVMariaDBDataSourceItem.html) - Represents a MariaDB data source item + + + + +* [RVMariaDBDataSource](https://help.revealbi.io/api/javascript/latest/classes/rvmariadbdatasource.html) - Represents a MariaDB data source +* [RVMariaDBDataSourceItem](https://help.revealbi.io/api/javascript/latest/classes/rvmariadbdatasourceitem.html) - Represents a MariaDB data source item + + + diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/mongodb.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/mongodb.md new file mode 100644 index 00000000..5f7ba141 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/mongodb.md @@ -0,0 +1,183 @@ +--- +pagination_next: web/authentication +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# MongoDB データ ソースの追加 + +:::danger 重大な変更 + +現在、Reveal SDK は、Reveal SDK core パッケージからデータ ソースを分離する過程にあります。プロジェクトの継続的な機能を確保するために、プロジェクトに追加のパッケージをインストールすることが必要になる場合があります。詳細については、[サポートされるデータ ソース](web/datasources.md#サポートされるデータ-ソース) トピックを参照してください。 + +::: + +## クライアント側 + +**手順 1** - `RevealView.onDataSourcesRequested` イベントのイベント ハンドラーを追加します。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + //add code here + callback(new $.ig.RevealDataSources([], [], false)); +}; +``` + +**手順 2** - `RevealView.onDataSourcesRequested` イベント ハンドラーで、`RVMongoDBDataSource` オブジェクトの新しいインスタンスを作成します。`Title` プロパティを、MongoDB Server に対応する値に設定します。`RVMongoDBDataSource` オブジェクトを作成したら、それをデータ ソース コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + var mongoDataSource = new $.ig.RVMongoDataSource(); + mongoDataSource.title = "My MongoDB"; + + callback(new $.ig.RevealDataSources([mongoDataSource], [], false)); +}; +``` + +アプリケーションが実行されたら、新しい可視化を作成すると、新しく作成された MongoDB データ ソースが [データ ソースの選択] ダイアログに表示されます。 + +![](images/mongodb-data-source.jpg) + +**手順 3** - `RVMongoDBDataSourceItem` オブジェクトの新しいインスタンスを作成して、新しいデータ ソース項目を追加します。データベース コレクションに対応する `id` および `title` プロパティを設定します。`RVMongoDBDataSourceItem` オブジェクトを作成したら、それをデータ ソース項目コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + var mongoDataSource = new $.ig.RVMongoDBDataSource(); + mongoDataSource.title = "My MongoDB"; + + var mongoDsi = new $.ig.RVMongoDBDataSourceItem(mongoDataSource); + mongoDsi.id = "MyMongoDatasourceItem"; + mongoDsi.title = "My MongoDB Item"; + + callback(new $.ig.RevealDataSources([mongoDataSource], [mongoDsi], false)); +}; +``` + +アプリケーションが実行されたら、新しい可視化を作成すると、新しく作成された MongoDB データ ソースが [データ ソースの選択] ダイアログに表示されます。 + +![](images/mongodb-data-source-item.jpg) + +## サーバー側 + +**手順 1** - クライアントでデータ ソースとデータ ソース項目を作成しますが、接続情報は指定しません。`id`、`title`、および/または `subtitle` のみを入力してください。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + + var mongoDS = new $.ig.RVMongoDBDataSource(); + mongoDS.id = "MyMongoDBDataSource"; + mongoDS.title = "My MongoDB"; + + var mongoDSI = new $.ig.RVMongoDBDataSourceItem(mongoDS); + mongoDSI.id = "MyMongoDBDataSourceItem"; + mongoDSI.title = "My MongoDB Item"; + + callback(new $.ig.RevealDataSources([mongoDS], [mongoDSI], false)); +}; +``` + +**手順 2** - データ ソース プロバイダーを作成します。この例では、クライアントで定義された **MongoDB** データベースに接続するための接続情報を提供しています。これを実現するために、使用しているデータ ソース/項目のタイプを決定し、オブジェクトで使用可能なプロパティを設定します。 + + + + +```cs +public class DataSourceProvider : IRVDataSourceProvider +{ + public Task ChangeDataSourceItemAsync(IRVUserContext userContext, string dashboardId, RVDataSourceItem dataSourceItem) + { + if (dataSourceItem is RVMongoDBDataSourceItem mongoDsi) + { + //required: update underlying data source + ChangeDataSourceAsync(userContext, mongoDsi.DataSource); + + //only change the table if we have selected our data source item + if (mongoDsi.Id == "MyMongoDatasourceItem") + { + //set the collection + mongoDsi.collection = "orders"; + } + } + return Task.FromResult(dataSourceItem); + } + + public Task ChangeDataSourceAsync(IRVUserContext userContext, RVDashboardDataSource dataSource) + { + if (dataSource is RVMongoDBDataSource mongoDatasource) + { + mongoDatasource.connectionString = "mongodb+srv://cluster0.ta2xrrt.mongodb.net/"; + mongoDatasource.database = "test"; + } + return Task.FromResult(dataSource); + } +} +``` + + + + + +```js +const dataSourceItemProvider = async (userContext, dataSourceItem) => { + if (dataSourceItem instanceof reveal.RVMongoDBDataSourceItem) { + + //required: update underlying data source + dataSourceProvider(userContext, dataSourceItem.dataSource); + + //only change the collection if we have selected our data source item + if (dataSourceItem.id === "MyMongoDBDatasourceItem") { + dataSourceItem.collection = "orders"; + } + } + return dataSourceItem; +} + +const dataSourceProvider = async (userContext, dataSource) => { + if (dataSource instanceof reveal.RVMongoDBDataSource) { + dataSource.connectionString = "mongodb+srv://cluster0.ta2xrrt.mongodb.net/"; + dataSource.database = "test"; + } + return dataSource; +} +``` + + + + + +```ts +const dataSourceItemProvider = async (userContext: IRVUserContext | null, dataSourceItem: RVDataSourceItem) => { + if (dataSourceItem instanceof RVMongoDBDataSourceItem) { + + //required: update underlying data source + dataSourceProvider(userContext, dataSourceItem.dataSource); + + //only change the collection if we have selected our data source item + if (dataSourceItem.id === "MyMongoDBDatasourceItem") { + dataSourceItem.collection = "orders"; + } + } + return dataSourceItem; +} + +const dataSourceProvider = async (userContext: IRVUserContext | null, dataSource: RVDashboardDataSource) => { + if (dataSource instanceof RVMongoDBDataSource) { + dataSource.connectionString = "mongodb+srv://cluster0.ta2xrrt.mongodb.net/"; + dataSource.database = "test"; + } + return dataSource; +} +``` + + + + + +:::info コードの取得 + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/DataSources/MongoDB) にあります。 + +::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/ms-sql-server.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/ms-sql-server.md new file mode 100644 index 00000000..048d453f --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/ms-sql-server.md @@ -0,0 +1,224 @@ +--- +pagination_next: web/authentication +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# MS SQL Server データ ソースの追加 + +:::danger 重大な変更 + +現在、Reveal SDK は、Reveal SDK core パッケージからデータ ソースを分離する過程にあります。プロジェクトの継続的な機能を確保するために、プロジェクトに追加のパッケージをインストールすることが必要になる場合があります。詳細については、[サポートされるデータ ソース](web/datasources.md#サポートされるデータ-ソース) トピックを参照してください。 + +::: + +## クライアント側 + +**手順 1** - `RevealView.onDataSourcesRequested` イベントのイベント ハンドラーを追加します。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + //add code here + callback(new $.ig.RevealDataSources([], [], false)); +}; +``` + +**手順 2** - `RevealView.onDataSourcesRequested` イベント ハンドラーで、`RVSqlServerDataSource` オブジェクトの新しいインスタンスを作成します。MS SQL Server に対応する `Title` プロパティを設定します。`RVSqlServerDataSource` オブジェクトを作成したら、それをデータ ソース コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + var sqlDataSource = new $.ig.RVSqlServerDataSource(); + sqlDataSource.title = "My SQL Server"; + + callback(new $.ig.RevealDataSources([sqlDataSource], [], false)); +}; +``` + +アプリケーションを開始し、新しい表示形式を作成すると、[データ ソースの選択] ダイアログに新しく作成された MS SQL Server データ ソースが表示されます。 + +![](images/ms-sql-server-data-source.jpg) + +**手順 3** - `RVSqlServerDataSourceItem` オブジェクトの新しいインスタンスを作成して、新しいデータ ソース項目を追加します。データベース テーブルに対応する `Id` および `Title` プロパティを設定します。`RVSqlServerDataSourceItem` オブジェクトを作成したら、それをデータ ソース コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + var sqlDataSource = new $.ig.RVSqlServerDataSource(); + sqlDataSource.title = "My SQL Server"; + + var sqlServerDsi = new $.ig.RVSqlServerDataSourceItem(sqlDataSource); + sqlServerDsi.id = "MySqlServerDatasourceItem"; + sqlServerDsi.title = "My SQL Server Item"; + + callback(new $.ig.RevealDataSources([sqlDataSource], [sqlServerDsi], false)); +}; +``` + +アプリケーションを開始し、新しい表示形式を作成すると、[データ ソースの選択] ダイアログに新しく作成された MS SQL Server データ ソース項目が表示されます。 + +![](images/ms-sql-server-data-source-item.jpg) + +## サーバー側 + +**手順 1** - クライアントでデータ ソースとデータ ソース項目を作成しますが、接続情報は指定しません。`id`、`title`、および/または `subtitle` のみを提供します。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + + var sqlServerDS = new $.ig.RVSqlServerDataSource(); + sqlServerDS.id = "MySqlServerDataSource"; + sqlServerDS.title = "My Sql Server"; + + var sqlServerDSI = new $.ig.RVSqlServerDataSourceItem(sqlServerDS); + sqlServerDSI.id = "MySqlServerDataSourceItem"; + sqlServerDSI.title = "My Sql Server Item"; + + callback(new $.ig.RevealDataSources([sqlDataSource], [sqlServerDSI], false)); +}; +``` + +**手順 2** - データ ソース プロバイダーを作成します。この例では、クライアントで定義された **MS SQL Server** データベースに接続するための接続情報を提供しています。これを実現するために、使用しているデータ ソース/項目のタイプを決定し、オブジェクトで使用可能なプロパティを設定します。 + + + + +```cs +public class DataSourceProvider : IRVDataSourceProvider +{ + public Task ChangeDataSourceItemAsync(IRVUserContext userContext, string dashboardId, RVDataSourceItem dataSourceItem) + { + if (dataSourceItem is RVSqlServerDataSourceItem sqlServerDsi) + { + //required: update underlying data source + ChangeDataSourceAsync(userContext, sqlServerDsi.DataSource); + + //only change the table if we have selected our data source item + if (sqlServerDsi.Id == "MySqlServerDatasourceItem") + { + //set the table/view + sqlServerDsi.Table = "Orders"; + } + } + return Task.FromResult(dataSourceItem); + } + + public Task ChangeDataSourceAsync(IRVUserContext userContext, RVDashboardDataSource dataSource) + { + if (dataSource is RVSqlServerDataSource sqlDatasource) + { + sqlDatasource.Host = "10.0.0.20"; + sqlDatasource.Database = "Northwind"; + sqlDatasource.Schema = "dbo"; + } + return Task.FromResult(dataSource); + } +} +``` + + + + + +```java +public class DataSourceProvider implements IRVDataSourceProvider { + + public RVDataSourceItem changeDataSourceItem(IRVUserContext userContext, String dashboardsID, RVDataSourceItem dataSourceItem) { + + if (dataSourceItem instanceof RVSqlServerDataSourceItem sqlServerDsi) { + //required: update underlying data source + changeDataSource(userContext, dataSourceItem.getDataSource()); + + //only change the table if we have selected our custom data source item + if (dataSourceItem.getId() == "MySqlServerDatasourceItem") { + sqlServerDsi.setTable("Orders"); + } + } + return dataSourceItem; + } + + public RVDashboardDataSource changeDataSource(IRVUserContext userContext, RVDashboardDataSource dataSource) { + if (dataSource instanceof RVSqlServerDataSource sqlDatasource) { + sqlDatasource.setHost("10.0.0.20"); + sqlDatasource.setDatabase("Northwind"); + sqlDatasource.setSchema("dbo"); + } + return dataSource; + } +} +``` + + + + + +```js +const dataSourceItemProvider = async (userContext, dataSourceItem) => { + if (dataSourceItem instanceof reveal.RVSqlServerDataSourceItem) { + + //required: update underlying data source + dataSourceProvider(userContext, dataSourceItem.dataSource); + + //only change the table if we have selected our data source item + if (dataSourceItem.id === "MySqlServerDatasourceItem") { + dataSourceItem.table = "Orders"; + } + } + return dataSourceItem; +} + +const dataSourceProvider = async (userContext, dataSource) => { + if (dataSource instanceof reveal.RVSqlServerDataSource) { + dataSource.host = "10.0.0.20"; + dataSource.database = "Northwind"; + dataSource.schema = "dbo"; + } + return dataSource; +} +``` + + + + + +```ts +const dataSourceItemProvider = async (userContext: IRVUserContext | null, dataSourceItem: RVDataSourceItem) => { + if (dataSourceItem instanceof RVSqlServerDataSourceItem) { + + //required: update underlying data source + dataSourceProvider(userContext, dataSourceItem.dataSource); + + //only change the table if we have selected our data source item + if (dataSourceItem.id === "MySqlServerDatasourceItem") { + dataSourceItem.table = "Orders"; + } + } + return dataSourceItem; +} + +const dataSourceProvider = async (userContext: IRVUserContext | null, dataSource: RVDashboardDataSource) => { + if (dataSource instanceof RVSqlServerDataSource) { + dataSource.host = "10.0.0.20"; + dataSource.database = "Northwind"; + dataSource.schema = "dbo"; + } + return dataSource; +} +``` + + + + + +:::tip Entra ID 認証 + +Microsoft Entra ID を使用して SQL Server データベースに対して認証を行う場合は、[Microsoft Entra ID 認証](../authentication.md#microsoft-entra-id-認証) セクションで完全な例を参照してください。 + +::: + +:::info コードの取得 + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/DataSources/MsSqlServer) にあります。 + +::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/mysql.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/mysql.md new file mode 100644 index 00000000..d9aa4c33 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/mysql.md @@ -0,0 +1,225 @@ +--- +pagination_next: web/authentication +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# MySQL データ ソースの追加 + +:::danger 重大な変更 + +現在、Reveal SDK は、Reveal SDK core パッケージからデータ ソースを分離する過程にあります。プロジェクトの継続的な機能を確保するために、プロジェクトに追加のパッケージをインストールすることが必要になる場合があります。詳細については、[サポートされるデータ ソース](web/datasources.md#サポートされるデータ-ソース) トピックを参照してください。 + +::: + +## クライアント側 + +**手順 1** - `RevealView.onDataSourcesRequested` イベントのイベント ハンドラーを追加します。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + //add code here + callback(new $.ig.RevealDataSources([], [], false)); +}; +``` + +**手順 2** - `RevealView.onDataSourcesRequested` イベント ハンドラーで、`RVMySqlDataSource` オブジェクトの新しいインスタンスを作成します。`Host`、`Database`、`Port`、および `Title` プロパティを、MySQL サーバーに対応する値に設定します。`RVMySqlDataSource` オブジェクトを作成したら、それをデータ ソース コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + var mySqlDataSource = new $.ig.RVMySqlDataSource(); + mySqlDataSource.host = "your-db-host"; + mySqlDataSource.database = "your-db-name"; + mySqlDataSource.port = 1234; + mySqlDataSource.title = "My MySQL"; + + callback(new $.ig.RevealDataSources([mySqlDataSource], [], false)); +}; +``` + +アプリケーションが実行されたら、新しい可視化を作成すると、新しく作成された MySQL データ ソースが [データ ソースの選択] ダイアログに表示されます。 + +![](images/mysql-data-source.jpg) + +**手順 3** - `RVMySqlDataSourceItem` オブジェクトの新しいインスタンスを作成して、新しいデータ ソース項目を追加します。データベース テーブルに対応する `Id`、`Title`、および `Table` プロパティを設定します。`RVMySqlDataSourceItem` オブジェクトを作成したら、それをデータ ソース項目コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + var mySqlDataSource = new $.ig.RVMySqlDataSource(); + mySqlDataSource.host = "your-db-host"; + mySqlDataSource.database = "your-db-name"; + mySqlDataSource.port = 1234; + mySqlDataSource.title = "My MySQL"; + + var mySqlDsi = new $.ig.RVMySqlDataSourceItem(mySqlDataSource); + mySqlDsi.id = "MyMySqlDataSourceItem"; + mySqlDsi.title = "My MySQL Item"; + mySqlDsi.table = "TableName"; + + callback(new $.ig.RevealDataSources([mySqlDataSource], [mySqlDsi], false)); +}; +``` + +アプリケーションが実行されたら、新しい可視化を作成すると、新しく作成された MySQL データ ソース項目が [データ ソースの選択] ダイアログに表示されます。 + +![](images/mysql-data-source-item.jpg) + +## サーバー側 + +**手順 1** - クライアントでデータ ソースとデータ ソース項目を作成しますが、接続情報は指定しません。`id`、`title`、および/または `subtitle` のみを入力してください。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + + var mySqlDataSource = new $.ig.RVMySqlDataSource(); + mySqlDataSource.id = "MyMySqlDataSource"; + mySqlDataSource.title = "My MySQL"; + + var mySqlDataSourceItem = new $.ig.RVMySqlDataSourceItem(mySqlDataSource); + mySqlDataSourceItem.id = "MyMySqlDataSourceItem"; + mySqlDataSourceItem.title = "My MySQL Item"; + + callback(new $.ig.RevealDataSources([mySqlDataSource], [mySqlDataSourceItem], true)); +}; +``` + +**手順 2** - データ ソース プロバイダーを作成します。この例では、クライアントで定義された **MySQL** データベースに接続するための接続情報を提供しています。これを実現するために、使用しているデータ ソース/項目のタイプを決定し、オブジェクトで使用可能なプロパティを設定します。 + + + + +```cs +public class DataSourceProvider : IRVDataSourceProvider +{ + public Task ChangeDataSourceItemAsync(IRVUserContext userContext, string dashboardId, + RVDataSourceItem dataSourceItem) + { + if (dataSourceItem is RVMySqlDataSourceItem mySqlDataSourceItem) + { + //update underlying data source + ChangeDataSourceAsync(userContext, mySqlDataSourceItem.DataSource); + + //only change the table if we have selected our custom data source item + if (mySqlDataSourceItem.Id == "MyMySqlDataSourceItem") + { + mySqlDataSourceItem.Table = "orders"; + } + } + + return Task.FromResult(dataSourceItem); + } + + public Task ChangeDataSourceAsync(IRVUserContext userContext, + RVDashboardDataSource dataSource) + { + if (dataSource is RVMySqlDataSource mySqlDataSource) + { + mySqlDataSource.Host = "localhost"; + mySqlDataSource.Database = "database"; + } + + return Task.FromResult(dataSource); + } +} +``` + + + + + +```java +public class DataSourceProvider implements IRVDataSourceProvider { + public RVDataSourceItem changeDataSourceItem(IRVUserContext userContext, String dashboardsID, RVDataSourceItem dataSourceItem) { + + if (dataSourceItem instanceof RVMySqlDataSourceItem mySqlDataSourceItem) { + + //update underlying data source + changeDataSource(userContext, dataSourceItem.getDataSource()); + + //only change the table if we have selected our custom data source item + if (Objects.equals(dataSourceItem.getId(), "MyMySqlDataSourceItem")) { + mySqlDataSourceItem.setTable("orders"); + } + } + return dataSourceItem; + } + + public RVDashboardDataSource changeDataSource(IRVUserContext userContext, RVDashboardDataSource dataSource) { + + if (dataSource instanceof RVMySqlDataSource mySqlDataSource) { + mySqlDataSource.setHost("localhost"); + mySqlDataSource.setDatabase("database"); + } + return dataSource; + } +} +``` + + + + + +```js +const dataSourceItemProvider = async (userContext, dataSourceItem) => { + if (dataSourceItem instanceof reveal.RVMySqlDataSourceItem) { + + //update underlying data source + dataSourceProvider(userContext, dataSourceItem.dataSource); + + //only change the table if we have selected our data source item + if (dataSourceItem.id === "MyMySqlDataSourceItem") { + dataSourceItem.table = "orders"; + } + } + return dataSourceItem; +} + +const dataSourceProvider = async (userContext, dataSource) => { + if (dataSource instanceof reveal.RVMySqlDataSource) { + dataSource.host = "localhost"; + dataSource.database = "database"; + } + return dataSource; +} +``` + + + + + +```ts +const dataSourceItemProvider = async (userContext: IRVUserContext | null, dataSourceItem: RVDataSourceItem) => { + if (dataSourceItem instanceof RVMySqlDataSourceItem) { + + //update underlying data source + dataSourceProvider(userContext, dataSourceItem.dataSource); + + //only change the table if we have selected our data source item + if (dataSourceItem.id === "MyMySqlDataSourceItem") { + dataSourceItem.table = "orders"; + } + } + return dataSourceItem; +} + +const dataSourceProvider = async (userContext: IRVUserContext | null, dataSource: RVDashboardDataSource) => { + if (dataSource instanceof RVMySqlDataSource) { + dataSource.host = "localhost"; + dataSource.database = "database"; + } + return dataSource; +} +``` + + + + + +:::info コードの取得 + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/DataSources/MySQL) にあります。 + +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/oracle.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/oracle.md new file mode 100644 index 00000000..8d7ef9ba --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/oracle.md @@ -0,0 +1,310 @@ +--- +pagination_next: web/authentication +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# Oracle データ ソースの追加 + +:::danger 重大な変更 + +現在、Reveal SDK は、Reveal SDK core パッケージからデータ ソースを分離する過程にあります。プロジェクトの継続的な機能を確保するために、プロジェクトに追加のパッケージをインストールすることが必要になる場合があります。詳細については、[サポートされるデータ ソース](web/datasources.md#サポートされるデータ-ソース) トピックを参照してください。 + +::: + +## クライアント側 + +**手順 1** - `RevealView.onDataSourcesRequested` イベントのイベント ハンドラーを追加します。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + //add code here + callback(new $.ig.RevealDataSources([], [], false)); +}; +``` + +**手順 2** - `RevealView.onDataSourcesRequested` イベント ハンドラーで、`RVOracleSIDDataSource` または `RVOracleServiceDataSource` オブジェクト (セットアップに応じて) の新しいインスタンスを作成します。`Host`、`Database`、`Port`、`Title`、および `SID` / `Service` (SID またはサービス名を使用しているかどうかに応じて) プロパティを Oracle サーバーに対応する値に設定します。`RVOracleXXXXDataSource` オブジェクトを作成したら、それをデータ ソース コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + //if you are using SID + const oracleSIDDataSource = new $.ig.RVOracleSIDDataSource(); + oracleSIDDataSource.id = "MyOracleSIDDataSource"; + oracleSIDDataSource.title = "My Oracle SID"; + oracleSIDDataSource.host = "your-host"; + oracleSIDDataSource.port = "your-port"; + oracleSIDDataSource.database = "your-database"; + + //if you are using Service Name + const oracleServiceDataSource = new $.ig.RVOracleServiceDataSource(); + oracleServiceDataSource.id = "MyOracleServiceDataSource"; + oracleServiceDataSource.title = "My Oracle Service"; + oracleServiceDataSource.host = "your-host"; + oracleServiceDataSource.port = "your-port"; + oracleServiceDataSource.database = "your-database"; + + callback(new $.ig.RevealDataSources([oracleSIDDataSource, oracleServiceDataSource], [], true)); +}; +``` + +アプリケーションが実行されたら、新しい可視化を作成すると、新しく作成された Oracle データ ソースが [データ ソースの選択] ダイアログに表示されます。 + +![](images/oracle-data-source.jpg) + +**手順 3** - `RVOracleDataSourceItem` オブジェクトの新しいインスタンスを作成して、新しいデータ ソース項目を追加します。データベース テーブルに対応する `Id`、`Title`、および `Table` プロパティを設定します。`RVOracleDataSourceItem` オブジェクトを作成したら、それをデータ ソース項目コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + //if you are using SID + const oracleSIDDataSource = new $.ig.RVOracleSIDDataSource(); + oracleSIDDataSource.id = "MyOracleSIDDataSource"; + oracleSIDDataSource.title = "My Oracle SID"; + oracleSIDDataSource.host = "your-host"; + oracleSIDDataSource.port = "your-port"; + oracleSIDDataSource.database = "your-database"; + + //if you are using Service Name + const oracleServiceDataSource = new $.ig.RVOracleServiceDataSource(); + oracleServiceDataSource.id = "MyOracleServiceDataSource"; + oracleServiceDataSource.title = "My Oracle Service"; + oracleServiceDataSource.host = "your-host"; + oracleServiceDataSource.port = "your-port"; + oracleServiceDataSource.database = "your-database"; + + const oracleSIDDataSourceItem = new $.ig.RVOracleDataSourceItem(oracleSIDDataSource); + oracleSIDDataSourceItem.id = "MyOracleSIDDataSourceItem"; + oracleSIDDataSourceItem.title = "My Oracle SID Item"; + + const oracleServiceDataSourceItem = new $.ig.RVOracleDataSourceItem(oracleServiceDataSource); + oracleServiceDataSourceItem.id = "MyOracleServiceDataSourceItem"; + oracleServiceDataSourceItem.title = "My Oracle Service Item"; + + callback(new $.ig.RevealDataSources([oracleSIDDataSource, oracleServiceDataSource], [oracleSIDDataSourceItem, oracleServiceDataSourceItem], true)); +}; +``` + +アプリケーションが実行されたら、新しい可視化を作成すると、新しく作成された Oracle データ ソース項目が [データ ソースの選択] ダイアログに表示されます。 + +![](images/oracle-data-source-item.jpg) + +## サーバー側 + +**手順 1** - クライアントでデータ ソースとデータ ソース項目を作成しますが、接続情報は指定しません。`id`、`title`、および/または `subtitle` のみを入力してください。 + +```js +revealView.onDataSourcesRequested = (callback) => { + //if you are using SID + const oracleSIDDataSource = new $.ig.RVOracleSIDDataSource(); + oracleSIDDataSource.id = "MyOracleSIDDataSource"; + oracleSIDDataSource.title = "My Oracle SID"; + + //if you are using Service Name + const oracleServiceDataSource = new $.ig.RVOracleServiceDataSource(); + oracleServiceDataSource.id = "MyOracleServiceDataSource"; + oracleServiceDataSource.title = "My Oracle Service"; + + const oracleSIDDataSourceItem = new $.ig.RVOracleDataSourceItem(oracleSIDDataSource); + oracleSIDDataSourceItem.id = "MyOracleSIDDataSourceItem"; + oracleSIDDataSourceItem.title = "My Oracle SID Item"; + + const oracleServiceDataSourceItem = new $.ig.RVOracleDataSourceItem(oracleServiceDataSource); + oracleServiceDataSourceItem.id = "MyOracleServiceDataSourceItem"; + oracleServiceDataSourceItem.title = "My Oracle Service Item"; + + callback(new $.ig.RevealDataSources([oracleSIDDataSource, oracleServiceDataSource], [oracleSIDDataSourceItem, oracleServiceDataSourceItem], true)); +}; +``` + +**手順 2** - データ ソース プロバイダーを作成します。この例では、クライアントで定義された **Oracle** データベースに接続するための接続情報を提供しています。これを実現するために、使用しているデータ ソース/項目のタイプを決定し、オブジェクトで使用可能なプロパティを設定します。 + + + + +```cs +public class DataSourceProvider : IRVDataSourceProvider +{ + public Task ChangeDataSourceItemAsync(IRVUserContext userContext, string dashboardId, + RVDataSourceItem dataSourceItem) + { + if (dataSourceItem is RVOracleDataSourceItem oracleDataSourceItem) + { + //update underlying data source + ChangeDataSourceAsync(userContext, oracleDataSourceItem.DataSource); + + //only change the table if we have selected our custom data source item + if (oracleDataSourceItem.Id == "MyOracleSIDDataSourceItem") + { + oracleDataSourceItem.Table = "your-table"; + } + + if (oracleDataSourceItem.Id == "MyOracleServiceDataSourceItem") + { + oracleDataSourceItem.Table = "your-table"; + } + } + + return Task.FromResult(dataSourceItem); + } + + public Task ChangeDataSourceAsync(IRVUserContext userContext, + RVDashboardDataSource dataSource) + { + //using SID + if (dataSource is RVOracleSIDDataSource oracleSidDataSource) + { + oracleSidDataSource.Host = "your-host"; + oracleSidDataSource.Database = "your-database"; + oracleSidDataSource.SID = "your-service-sid"; + } + + //using service name + if (dataSource is RVOracleServiceDataSource oracleServiceDataSource) + { + oracleServiceDataSource.Host = "your-host"; + oracleServiceDataSource.Database = "your-database"; + oracleServiceDataSource.Service = "your-service-name"; + } + + return Task.FromResult(dataSource); + } +} +``` + + + + + +```java +public class DataSourceProvider implements IRVDataSourceProvider { + public RVDataSourceItem changeDataSourceItem(IRVUserContext userContext, String dashboardsID, RVDataSourceItem dataSourceItem) { + + if (dataSourceItem instanceof RVOracleDataSourceItem oracleDataSourceItem) { + + //update underlying data source + changeDataSource(userContext, dataSourceItem.getDataSource()); + + //only change the table if we have selected our custom data source item + if (Objects.equals(dataSourceItem.getId(), "MyOracleSIDDataSourceItem")) { + oracleDataSourceItem.setTable("your-table"); + } + + if (Objects.equals(dataSourceItem.getId(), "MyOracleServiceDataSourceItem")) { + oracleDataSourceItem.setTable("your-table"); + } + } + return dataSourceItem; + } + + public RVDashboardDataSource changeDataSource(IRVUserContext userContext, RVDashboardDataSource dataSource) { + //using SID + if (dataSource instanceof RVOracleSIDDataSource oracleSIDDataSource) { + oracleSIDDataSource.setHost("your-host"); + oracleSIDDataSource.setDatabase("your-database"); + oracleSIDDataSource.setSID("your-sid"); + } + + //using service name + if (dataSource instanceof RVOracleServiceDataSource oracleServiceDataSource) { + oracleServiceDataSource.setHost("your-host"); + oracleServiceDataSource.setDatabase("your-database"); + oracleServiceDataSource.setService("your-service-name"); + } + + return dataSource; + } +} +``` + + + + + +```js +const dataSourceItemProvider = async (userContext, dataSourceItem) => { + if (dataSourceItem instanceof reveal.RVOracleDataSourceItem) { + + //update underlying data source + dataSourceProvider(userContext, dataSourceItem.dataSource); + + //only change the table if we have selected our data source item + if (dataSourceItem.id === "MyOracleSIDDataSourceItem") { + dataSourceItem.table = "your-table"; + } + + if (dataSourceItem.id === "MyOracleServiceDataSourceItem") { + dataSourceItem.table = "your-table"; + } + } + return dataSourceItem; +} + +const dataSourceProvider = async (userContext, dataSource) => { + //using SID + if (dataSource instanceof reveal.RVOracleSIDDataSource) { + dataSource.host = "your-host"; + dataSource.database = "your-database"; + dataSource.sID = "your-sid"; + } + + //using service name + if (dataSource instanceof reveal.RVOracleServiceDataSource) { + dataSource.host = "your-host"; + dataSource.database = "your-database"; + dataSource.service = "your-service-name"; + } + return dataSource; +} +``` + + + + + +```ts +const dataSourceItemProvider = async (userContext: IRVUserContext | null, dataSourceItem: RVDataSourceItem) => { + if (dataSourceItem instanceof RVOracleDataSourceItem) { + + //update underlying data source + dataSourceProvider(userContext, dataSourceItem.dataSource); + + //only change the table if we have selected our data source item + if (dataSourceItem.id === "MyOracleSIDDataSourceItem") { + dataSourceItem.table = "your-table"; + } + + if (dataSourceItem.id === "MyOracleServiceDataSourceItem") { + dataSourceItem.table = "your-table"; + } + } + return dataSourceItem; +} + +const dataSourceProvider = async (userContext: IRVUserContext | null, dataSource: RVDashboardDataSource) => { + //using SID + if (dataSource instanceof RVOracleSIDDataSource) { + dataSource.host = "your-host"; + dataSource.database = "your-database"; + dataSource.sID = "your-sid"; + } + + //using service name + if (dataSource instanceof RVOracleServiceDataSource) { + dataSource.host = "your-host"; + dataSource.database = "your-database"; + dataSource.service = "your-service-name"; + } + return dataSource; +} +``` + + + + + +:::info コードの取得 + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/DataSources/Oracle) にあります。 + +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/postgres.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/postgres.md new file mode 100644 index 00000000..1672baed --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/postgres.md @@ -0,0 +1,229 @@ +--- +pagination_next: web/authentication +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# PostgreSQL データ ソースの追加 + +:::danger 重大な変更 + +現在、Reveal SDK は、Reveal SDK core パッケージからデータ ソースを分離する過程にあります。プロジェクトの継続的な機能を確保するために、プロジェクトに追加のパッケージをインストールすることが必要になる場合があります。詳細については、[サポートされるデータ ソース](web/datasources.md#サポートされるデータ-ソース) トピックを参照してください。 + +::: + +## クライアント側 + +**手順 1** - `RevealView.onDataSourcesRequested` イベントのイベント ハンドラーを追加します。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + //add code here + callback(new $.ig.RevealDataSources([], [], false)); +}; +``` + +**手順 2** - `RevealView.onDataSourcesRequested` イベント ハンドラーで、`RVPostgresDataSource` オブジェクトの新しいインスタンスを作成します。`Host`、`Database`、`Port`、および `Title` プロパティを、PostgreSQL サーバーに対応する値に設定します。`RVPostgresDataSource` オブジェクトを作成したら、それをデータ ソース コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + var postgresDataSource = new $.ig.RVPostgresDataSource(); + postgresDataSource.host = "your-db-host"; + postgresDataSource.database = "your-db-name"; + postgresDataSource.port = 1234; + postgresDataSource.title = "My PostgreSQL"; + + callback(new $.ig.RevealDataSources([postgresDataSource], [], false)); +}; +``` + +アプリケーションが実行されたら、新しい可視化を作成すると、新しく作成された PostgreSQL データ ソースが [データ ソースの選択] ダイアログに表示されます。 + +![](images/postgres-data-source.jpg) + +**手順 3** - `RVPostgresDataSourceItem` オブジェクトの新しいインスタンスを作成して、新しいデータ ソース項目を追加します。データベース テーブルに対応する `Id`、`Title`、および `Table` プロパティを設定します。`RVPostgresDataSourceItem` オブジェクトを作成したら、それをデータ ソース項目コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + var postgresDataSource = new $.ig.RVPostgresDataSource(); + postgresDataSource.host = "your-db-host"; + postgresDataSource.database = "your-db-name"; + postgresDataSource.port = 1234; + postgresDataSource.title = "My PostgreSQL"; + + var postgresDsi = new $.ig.RVPostgresDataSourceItem(postgresDataSource); + postgresDsi.id = "MyPostgresDataSourceItem"; + postgresDsi.title = "My PostgreSQL Item"; + postgresDsi.table = "TableName"; + + callback(new $.ig.RevealDataSources([postgresDataSource], [postgresDsi], false)); +}; +``` + +アプリケーションが実行されたら、新しい可視化を作成すると、新しく作成された PostgreSQL データ ソース項目が [データ ソースの選択] ダイアログに表示されます。 + +![](images/postgres-data-source-item.jpg) + +## サーバー側 + +**手順 1** - クライアントでデータ ソースとデータ ソース項目を作成しますが、接続情報は指定しません。`id`、`title`、および/または `subtitle` のみを入力してください。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + + var postgresDataSource = new $.ig.RVPostgresDataSource(); + postgresDataSource.id = "MyPostgresDataSource"; + postgresDataSource.title = "My PostgreSQL"; + + var postgresDsi = new $.ig.RVPostgresDataSourceItem(postgresDataSource); + postgresDsi.id = "MyPostgresDataSourceItem"; + postgresDsi.title = "My PostgreSQL Item"; + + callback(new $.ig.RevealDataSources([postgresDataSource], [postgresDsi], false)); +}; +``` + +**手順 2** - データ ソース プロバイダーを作成します。この例では、クライアントで定義された **PostgreSQL** データベースに接続するための接続情報を提供しています。これを実現するために、使用しているデータ ソース/項目のタイプを決定し、オブジェクトで使用可能なプロパティを設定します。 + + + + +```cs +public class DataSourceProvider : IRVDataSourceProvider +{ + public Task ChangeDataSourceItemAsync(IRVUserContext userContext, string dashboardId, + RVDataSourceItem dataSourceItem) + { + if (dataSourceItem is RVPostgresDataSourceItem postgresDataSourceItem) + { + //update underlying data source + ChangeDataSourceAsync(userContext, postgresDataSourceItem.DataSource); + + //only change the table if we have selected our custom data source item + if (postgresDataSourceItem.Id == "MyPostgresDataSourceItem") + { + postgresDataSourceItem.Table = "orders"; + } + } + + return Task.FromResult(dataSourceItem); + } + + public Task ChangeDataSourceAsync(IRVUserContext userContext, + RVDashboardDataSource dataSource) + { + if (dataSource is RVPostgresDataSource postgresDataSource) + { + postgresDataSource.Host = "localhost"; + postgresDataSource.Database = "database"; + postgresDataSource.Schema = "public"; + } + + return Task.FromResult(dataSource); + } +} +``` + + + + + +```java +public class DataSourceProvider implements IRVDataSourceProvider { + public RVDataSourceItem changeDataSourceItem(IRVUserContext userContext, String dashboardsID, RVDataSourceItem dataSourceItem) { + + if (dataSourceItem instanceof RVPostgresDataSourceItem postgresDataSourceItem) { + + //update underlying data source + changeDataSource(userContext, dataSourceItem.getDataSource()); + + //only change the table if we have selected our custom data source item + if (dataSourceItem.getId() == "MyPostgresDataSourceItem") { + postgresDataSourceItem.setTable("orders"); + } + } + return dataSourceItem; + } + + public RVDashboardDataSource changeDataSource(IRVUserContext userContext, RVDashboardDataSource dataSource) { + + if (dataSource instanceof RVPostgresDataSource postgresDataSource) { + postgresDataSource.setHost("localhost"); + postgresDataSource.setDatabase("database"); + postgresDataSource.setSchema("public"); + } + return dataSource; + } +} +``` + + + + + +```js +const dataSourceItemProvider = async (userContext, dataSourceItem) => { + if (dataSourceItem instanceof reveal.RVPostgresDataSourceItem) { + + //update underlying data source + dataSourceProvider(userContext, dataSourceItem.dataSource); + + //only change the table if we have selected our data source item + if (dataSourceItem.id === "MyPostgresDataSourceItem") { + dataSourceItem.table = "orders"; + } + } + return dataSourceItem; +} + +const dataSourceProvider = async (userContext, dataSource) => { + if (dataSource instanceof reveal.RVPostgresDataSource) { + dataSource.host = "localhost"; + dataSource.database = "database"; + dataSource.schema = "public"; + } + return dataSource; +} +``` + + + + + +```ts +const dataSourceItemProvider = async (userContext: IRVUserContext | null, dataSourceItem: RVDataSourceItem) => { + if (dataSourceItem instanceof RVPostgresDataSourceItem) { + + //update underlying data source + dataSourceProvider(userContext, dataSourceItem.dataSource); + + //only change the table if we have selected our data source item + if (dataSourceItem.id === "MyPostgresDataSourceItem") { + dataSourceItem.table = "orders"; + } + } + return dataSourceItem; +} + +const dataSourceProvider = async (userContext: IRVUserContext | null, dataSource: RVDashboardDataSource) => { + if (dataSource instanceof RVPostgresDataSource) { + dataSource.host = "localhost"; + dataSource.database = "database"; + dataSource.schema = "public"; + } + return dataSource; +} +``` + + + + + +:::info コードの取得 + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/DataSources/PostgreSQL) にあります。 + +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/rest.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/rest.md new file mode 100644 index 00000000..e070744a --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/rest.md @@ -0,0 +1,49 @@ +--- +pagination_next: web/authentication +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# REST データ ソースの追加 + +:::danger 重大な変更 + +現在、Reveal SDK は、Reveal SDK core パッケージからデータ ソースを分離する過程にあります。プロジェクトの継続的な機能を確保するために、プロジェクトに追加のパッケージをインストールすることが必要になる場合があります。詳細については、[サポートされるデータ ソース](web/datasources.md#サポートされるデータ-ソース) トピックを参照してください。 + +::: + +**手順 1** - `RevealView.onDataSourcesRequested` イベントのイベント ハンドラーを追加します。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + //add code here + callback(new $.ig.RevealDataSources([], [], false)); +}; +``` + +**手順 2** - `RevealView.onDataSourcesRequested` イベント ハンドラーで、[RVRESTDataSource](https://help.revealbi.io/api/javascript/latest/classes/rvrestdatasource.html) オブジェクトの新しいインスタンスを作成します。REST エンドポイントへのアクセスに認証が必要ない場合は、`URL` プロパティを REST エンドポイントの URL に設定し、`useAnonymousAuthentication` プロパティを false に設定します。`RVRESTDataSource` オブジェクトを作成したら、それをデータ ソース コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + const restDataSource = new $.ig.RVRESTDataSource(); + restDataSource.title = "Sales by Category"; + restDataSource.subtitle = "Excel2Json"; + restDataSource.url = "https://excel2json.io/api/share/6e0f06b3-72d3-4fec-7984-08da43f56bb9"; + restDataSource.useAnonymousAuthentication = true; + + callback(new $.ig.RevealDataSources([restDataSource], [], true)); +}; +``` + +アプリケーションが実行されたら、新しい可視化を作成すると、新しく作成された REST データ ソースが [データ ソースの選択] ダイアログに表示されます。 + +![](images/rest-data-source.jpg) + + +:::info コードの取得 + +このサンプルのソース コードは、[GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/DataSources/RestService) にあります。 + +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/snowflake.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/snowflake.md new file mode 100644 index 00000000..5e301027 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-data-sources/snowflake.md @@ -0,0 +1,330 @@ +--- +pagination_next: web/authentication +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# Snowflake データ ソース + +## はじめに + +Snowflake は、データ分析、データ共有、ビジネス インテリジェンス ワークロード向けにスケーラブルなストレージとコンピューティング リソースを提供するクラウドベースのデータ ウェアハウス プラットフォームです。このトピックでは、Reveal アプリケーションで Snowflake データ ソースに接続してデータを視覚化および分析する方法について説明します。 + +## サーバー構成 + +### インストール + + + + +**手順 1** - Reveal Snowflake コネクタ パッケージをインストールします。 + +ASP.NET アプリケーションの場合、Snowflake サポートを有効にするには、別の NuGet パッケージをインストールする必要があります。 + +```bash +dotnet add package Reveal.Sdk.Data.Snowflake +``` + +**手順 2** - アプリケーションに Snowflake データ ソースを登録します。 + +```csharp +builder.Services.AddControllers().AddReveal( builder => +{ + builder.DataSources.RegisterSnowflake(); +}); +``` + + + + +Node.js アプリケーションの場合、Snowflake データ ソースはメインの Reveal SDK パッケージに既に含まれています。標準の Reveal SDK セットアップ以外に追加のインストールは必要ありません。 + + + + +Java アプリケーションの場合、Snowflake データ ソースはメインの Reveal SDK パッケージに既に含まれています。標準の Reveal SDK セットアップ以外に追加のインストールは必要ありません。 + + + + +### 接続構成 + + + + +```csharp +public class DataSourceProvider : IRVDataSourceProvider +{ + public Task ChangeDataSourceItemAsync(IRVUserContext userContext, string dashboardId, + RVDataSourceItem dataSourceItem) + { + if (dataSourceItem is RVSnowflakeDataSourceItem snowflakeDataSourceItem) + { + //update underlying data source + ChangeDataSourceAsync(userContext, snowflakeDataSourceItem.DataSource); + + //only change the table if we have selected our custom data source item + if (snowflakeDataSourceItem.Id == "MySnowflakeDataSourceItem") + { + snowflakeDataSourceItem.Schema = "TPCDS_SF100TCL"; + snowflakeDataSourceItem.Table = "CUSTOMER"; + } + } + + return Task.FromResult(dataSourceItem); + } + + public Task ChangeDataSourceAsync(IRVUserContext userContext, + RVDashboardDataSource dataSource) + { + if (dataSource is RVSnowflakeDataSource snowflakeDataSource) + { + snowflakeDataSource.Account = "your-account"; + snowflakeDataSource.Host = "your-account-host"; + snowflakeDataSource.Database = "SNOWFLAKE_SAMPLE_DATA"; + } + + return Task.FromResult(dataSource); + } +} +``` + + + + +```java +public class DataSourceProvider implements IRVDataSourceProvider { + public RVDataSourceItem changeDataSourceItem(IRVUserContext userContext, String dashboardsID, RVDataSourceItem dataSourceItem) { + + if (dataSourceItem instanceof RVSnowflakeDataSourceItem snowflakeDataSourceItem) { + + //update underlying data source + changeDataSource(userContext, dataSourceItem.getDataSource()); + + //only change the table if we have selected our custom data source item + if (Objects.equals(dataSourceItem.getId(), "MySnowflakeDataSourceItem")) { + snowflakeDataSourceItem.setSchema("TPCDS_SF100TCL"); + snowflakeDataSourceItem.setTable("CUSTOMER"); + } + } + return dataSourceItem; + } + + public RVDashboardDataSource changeDataSource(IRVUserContext userContext, RVDashboardDataSource dataSource) { + + if (dataSource instanceof RVSnowflakeDataSource snowflakeDataSource) { + snowflakeDataSource.setAccount("your-account"); + snowflakeDataSource.setHost("your-account-host"); + snowflakeDataSource.setDatabase("SNOWFLAKE_SAMPLE_DATA"); + } + return dataSource; + } +} +``` + + + + +```javascript +const dataSourceItemProvider = async (userContext, dataSourceItem) => { + if (dataSourceItem instanceof reveal.RVSnowflakeDataSourceItem) { + + //update underlying data source + dataSourceProvider(userContext, dataSourceItem.dataSource); + + //only change the table if we have selected our data source item + if (dataSourceItem.id === "MySnowflakeDataSourceItem") { + dataSourceItem.schema = "TPCDS_SF100TCL"; + dataSourceItem.table = "CUSTOMER"; + } + } + return dataSourceItem; +} + +const dataSourceProvider = async (userContext, dataSource) => { + if (dataSource instanceof reveal.RVSnowflakeDataSource) { + dataSource.account = "your-account"; + dataSource.host = "your-account-host"; + dataSource.database = "SNOWFLAKE_SAMPLE_DATA"; + } + return dataSource; +} +``` + + + + +```ts +const dataSourceItemProvider = async (userContext: IRVUserContext | null, dataSourceItem: RVDataSourceItem) => { + if (dataSourceItem instanceof RVSnowflakeDataSourceItem) { + + //update underlying data source + dataSourceProvider(userContext, dataSourceItem.dataSource); + + //only change the table if we have selected our data source item + if (dataSourceItem.id === "MySnowflakeDataSourceItem") { + dataSourceItem.schema = "TPCDS_SF100TCL"; + dataSourceItem.table = "CUSTOMER"; + } + } + return dataSourceItem; +} + +const dataSourceProvider = async (userContext: IRVUserContext | null, dataSource: RVDashboardDataSource) => { + if (dataSource instanceof RVSnowflakeDataSource) { + dataSource.account = "your-account"; + dataSource.host = "your-account-host"; + dataSource.database = "SNOWFLAKE_SAMPLE_DATA"; + } + return dataSource; +} +``` + + + + +:::danger Important +`ChangeDataSourceAsync` メソッドでデータ ソースに加えた変更は、`ChangeDataSourceItemAsync` メソッドには引き継がれません。両方のメソッドでデータ ソースのプロパティを更新する**必要があります**。上記の例に示すように、`ChangeDataSourceItemAsync` メソッド内で、データ ソース項目の基になるデータ ソースをパラメーターとして渡して `ChangeDataSourceAsync` メソッドを呼び出すことをお勧めします。 +::: + +### 認証 + +Snowflake の認証は、ユーザー名とパスワードの資格情報を使用してサーバー側で処理されます。すべての認証オプションの詳細については、「[認証](../authentication.md)」トピックを参照してください。 + + + + +```csharp +public class AuthenticationProvider: IRVAuthenticationProvider +{ + public Task ResolveCredentialsAsync(IRVUserContext userContext, RVDashboardDataSource dataSource) + { + IRVDataSourceCredential userCredential = null; + if (dataSource is RVSnowflakeDataSource) + { + userCredential = new RVUsernamePasswordDataSourceCredential("username", "password"); + } + return Task.FromResult(userCredential); + } +} +``` + + + + +```javascript +const authenticationProvider = async (userContext, dataSource) => { + if (dataSource instanceof reveal.RVSnowflakeDataSource) { + return new reveal.RVUsernamePasswordDataSourceCredential("username", "password"); + } + return null; +} +``` + + + + +```ts +const authenticationProvider = async (userContext: IRVUserContext | null, dataSource: RVDashboardDataSource) => { + if (dataSource instanceof RVSnowflakeDataSource) { + return new RVUsernamePasswordDataSourceCredential("username", "password"); + } + return null; +} +``` + + + + +```java +public class AuthenticationProvider implements IRVAuthenticationProvider { + @Override + public IRVDataSourceCredential resolveCredentials(IRVUserContext userContext, RVDashboardDataSource dataSource) { + if (dataSource instanceof RVSnowflakeDataSource) { + return new RVUsernamePasswordDataSourceCredential("username", "password"); + } + return null; + } +} +``` + + + + +## クライアント側の実装 + +### データ ソースの作成 + +**手順 1** - `RevealView.onDataSourcesRequested` イベントのイベント ハンドラーを追加します。 + +```js +const revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + // Add data source here + callback(new $.ig.RevealDataSources([], [], false)); +}; +``` + +**手順 2** - `RevealView.onDataSourcesRequested` イベント ハンドラーで、`RVSnowflakeDataSource` オブジェクトの新しいインスタンスを作成します。`title` と `subtitle` プロパティを設定します。`RVSnowflakeDataSource` オブジェクトを作成したら、それをデータ ソース コレクションに追加します。 + +```js +revealView.onDataSourcesRequested = (callback) => { + const snowflakeDS = new $.ig.RVSnowflakeDataSource(); + snowflakeDS.title = "Snowflake"; + snowflakeDS.subtitle = "Data Source"; + + callback(new $.ig.RevealDataSources([snowflakeDS], [], false)); +}; +``` + +アプリケーションが実行されたら、新しい可視化を作成すると、新しく作成された Snowflake データ ソースが [データ ソースの選択] ダイアログに表示されます。 + +![](images/snowflake-data-source.jpg) + +### データ ソース項目の作成 + +データ ソース項目は、ユーザーが視覚化のために選択できる Snowflake データ ソース内の特定のデータセットを表します。クライアント側では、ID、タイトル、サブタイトルのみを指定する必要があります。 + +```js +revealView.onDataSourcesRequested = (callback) => { + // Create the data source + const snowflakeDS = new $.ig.RVSnowflakeDataSource(); + snowflakeDS.title = "My Snowflake Datasource"; + snowflakeDS.subtitle = "Snowflake"; + + // Create a data source item + const snowflakeDSI = new $.ig.RVSnowflakeDataSourceItem(snowflakeDS); + snowflakeDSI.id = "MySnowflakeDataSourceItem"; + snowflakeDSI.title = "My Snowflake Datasource Item"; + snowflakeDSI.subtitle = "Snowflake"; + + callback(new $.ig.RevealDataSources([snowflakeDS], [snowflakeDSI], false)); +}; +``` + +アプリケーションが実行されたら、新しい可視化を作成すると、新しく作成された Snowflake 項目データ ソースが [データ ソースの選択] ダイアログに表示されます。 + +![](images/snowflake-data-source-item.jpg) + +## その他のリソース + +- [Snowflake ドキュメント](https://docs.snowflake.com/) +- [GitHub のサンプル ソース コード](https://github.com/RevealBi/sdk-samples-javascript/tree/main/DataSources/Snowflake) + +## API リファレンス + + + + +* [RVSnowflakeDataSource](https://help.revealbi.io/api/aspnet/latest/Reveal.Sdk.Data.Snowflake.RVSnowflakeDataSource.html) - Snowflake データ ソースを表します +* [RVSnowflakeDataSourceItem](https://help.revealbi.io/api/aspnet/latest/Reveal.Sdk.Data.Snowflake.RVSnowflakeDataSourceItem.html) - Snowflake データ ソース項目を表します + + + + +* [RVSnowflakeDataSource](https://help.revealbi.io/api/javascript/latest/classes/rvsnowflakedatasource.html) - Snowflake データ ソースを表します +* [RVSnowflakeDataSourceItem](https://help.revealbi.io/api/javascript/latest/classes/rvsnowflakedatasourceitem.html) - Snowflake データ ソース項目を表します + + + diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-license-key.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-license-key.md new file mode 100644 index 00000000..a045abbd --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/adding-license-key.md @@ -0,0 +1,78 @@ +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# ライセンス キーを追加 + +Reveal SDK をインストールするときは、ライセンス キーを指定する必要があります。指定しない場合、SDK は機能しません。ライセンス キーは 2 種類あります: +- トライアル - [Reveal SDK Web サイト](https://www.revealbi.io/ja/download-sdk)からトライアルをリクエストすると取得されます。 +- ライセンス済み - Reveal SDK の購入時にライセンスを取得されています。[カスタマー ポータル](https://account.infragistics.com/subscriptions)で入手できます。 + +## キー ファイル +デフォルトでは、Reveal SDK は、ユーザーの「ホーム」ディレクトリの下で `.revealbi-sdk` という名前のフォルダー内の `license.key` というファイルで有効なライセンスを検索します。 + +「ホーム」ディレクトリは、お使いの OS によって異なります。 +- Windows: `C:/Users/your-user-name/` +- Mac: `/Users/your-user-name/` +- Linux: `/home/your-user-name/` + +ライセンス キーを受け取ったら、「ホーム」ディレクトリにある `.revealbi-sdk` という名前のディレクトリ内に `license.key` という名前のテキスト ファイルを作成してください。このファイルにライセンス キーをコンテンツとして記載します。 + +:::note [ライセンス キー ファイルの内容] + +ファイルには生のライセンス文字列のみを含めてください。追加のコード、コメント、引用符、またはフォーマットを含めないでください。それ以外が含まれている場合、アプリケーションは「ファイルに有効な Base64 文字列が含まれていない」という内容のランタイム例外をスローする可能性があります。 + +::: + +例えば、Windows を使用している場合、ライセンス ファイルの場所は `C:/Users/ユーザー名/.revealbi-sdk/license.key` になります。 + +## コードで設定 + +ライセンス キーはアプリケーション コードで指定することもできます。 + + + + +```cs +services.AddMvc().AddReveal(builder => +{ + builder.AddSettings(settings => + { + settings.License = "LICENSE_KEY"; + }); +}); +``` + + + + + +```java +RevealEngineInitializer.initialize(new InitializeParameterBuilder(). + setLicense("LICENSE_KEY"). + build()); +``` + + + + + +```js +const revealOptions = { + license: "LICENSE_KEY", +}; +app.use("/", reveal(revealOptions)); +``` + + + + + +```ts +const revealOptions: RevealOptions = { + license: "LICENSE_KEY", +}; +app.use("/", reveal(revealOptions)); +``` + + + \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/authentication.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/authentication.md new file mode 100644 index 00000000..2bbad51f --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/authentication.md @@ -0,0 +1,538 @@ +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# 認証 + +Reveal SDK を使用すると、認証プロバイダーを使用し、そのプロバイダーを Reveal SDK に登録することで、ユーザー名 / パスワードおよびベアラー トークン認証資格情報などのさまざまな認証方法をデータ ソースに提供できます。 + +認証プロバイダーは、認証資格情報を要求しているデータ ソースを確認し、その特定のデータ ソースの正しい認証資格情報を返すために使用されます。 + +**手順 1** - 認証プロバイダーを作成します。 + + + + +```cs +public class AuthenticationProvider: IRVAuthenticationProvider +{ + public Task ResolveCredentialsAsync(IRVUserContext userContext, RVDashboardDataSource dataSource) + { + ... + } +} +``` + + + + + +```java +public class AuthenticationProvider implements IRVAuthenticationProvider { + @Override + public IRVDataSourceCredential resolveCredentials(IRVUserContext userContext, RVDashboardDataSource dataSource) { + ... + } +} +``` + + + + + +```js +const authenticationProvider = async (userContext, dataSource) => { + ... +} +``` + + + + + +```ts +const authenticationProvider = async (userContext: IRVUserContext | null, dataSource: RVDashboardDataSource) => { + ... +} +``` + + + + +**手順 2** - 認証プロバイダーを Reveal SDK に登録します。 + + + + +```cs +builder.Services.AddControllers().AddReveal( builder => +{ + builder.AddAuthenticationProvider(); +}); +``` + + + + + +```java +RevealEngineInitializer.initialize(new InitializeParameterBuilder(). + setAuthProvider(new AuthenticationProvider()). + build()); +``` + + + + + +```js +const revealOptions = { + authenticationProvider: authenticationProvider +}; + +app.use('/', reveal(revealOptions)); +``` + + + + + +```js +const revealOptions: RevealOptions = { + authenticationProvider: authenticationProvider +}; + +app.use('/', reveal(revealOptions)); +``` + + + + +## ユーザー名/パスワード認証 + +データ ソースがユーザー名とパスワードの使用を要求する場合、`RVUsernamePasswordDataSourceCredential` クラスのインスタンスを返す必要があります。`RVUsernamePasswordDataSourceCredential` クラスは、**ユーザー名**、**パスワード**、およびオプションで**ドメイン**を定義するコンストラクターのオーバーロードを提供します。 + + + + +```cs +public class AuthenticationProvider: IRVAuthenticationProvider +{ + public Task ResolveCredentialsAsync(IRVUserContext userContext, RVDashboardDataSource dataSource) + { + IRVDataSourceCredential userCredential = null; + if (dataSource is RVPostgresDataSource) + { + userCredential = new RVUsernamePasswordDataSourceCredential("username", "password"); + } + else if (dataSource is RVSqlServerDataSource) + { + userCredential = new RVUsernamePasswordDataSourceCredential("username", "password", "domain"); + } + return Task.FromResult(userCredential); + } +} +``` + + + + + +```java +public class AuthenticationProvider implements IRVAuthenticationProvider { + @Override + public IRVDataSourceCredential resolveCredentials(IRVUserContext userContext, RVDashboardDataSource dataSource) { + if (dataSource instanceof RVPostgresDataSource) { + return new RVUsernamePasswordDataSourceCredential("username", "password"); + } + else if (dataSource instanceof RVSqlServerDataSource) { + return new RVUsernamePasswordDataSourceCredential("username", "password", "domain"); + } + return null; + } +} +``` + + + + + +```js +const authenticationProvider = async (userContext, dataSource) => { + if (dataSource instanceof reveal.RVPostgresDataSource) { + return new reveal.RVUsernamePasswordDataSourceCredential("username", "password"); + } else if (dataSource instanceof reveal.RVSqlServerDataSource) { + return new reveal.RVUsernamePasswordDataSourceCredential("username", "password", "domain"); + } + return null; +} +``` + + + + + +```ts +const authenticationProvider = async (userContext:IRVUserContext | null, dataSource: RVDashboardDataSource) => { + if (dataSource instanceof RVPostgresDataSource) { + return new RVUsernamePasswordDataSourceCredential("username", "password"); + } else if (dataSource instanceof RVSqlServerDataSource) { + return new RVUsernamePasswordDataSourceCredential("username", "password", "domain"); + } + return null; +} +``` + + + + +データ ソースが認証なしで匿名ログインを使用している場合、空のコンストラクターで `RVUsernamePasswordDataSourceCredential` を使用できます。 + + + + +```cs +if (dataSource is RVSqlServerDataSource) +{ + userCredential = new RVUsernamePasswordDataSourceCredential(); +} +``` + + + + + +```java +if (dataSource instanceof RVSqlServerDataSource) { + return new RVUsernamePasswordDataSourceCredential(); +} +``` + + + + + +```js +if (dataSource instanceof reveal.RVSqlServerDataSource) { + return new reveal.RVUsernamePasswordDataSourceCredential(); +} +``` + + + + + +```ts +if (dataSource instanceof RVSqlServerDataSource) { + return new RVUsernamePasswordDataSourceCredential(); +} +``` + + + + +`RVUsernamePasswordDataSourceCredential` は、以下のデータ ソースでサポートされます。 +- Amazon Redshift +- Microsoft Analysis Services サーバー +- Microsoft Dynamics CRM (オンプレミスおよびオンライン) +- Microsoft SQL Server +- MySQL +- OData サービス +- Oracle +- PostgreSQL +- REST サービス +- Snowflake +- Sybase +- ウェブ リソース + +## ベアラー トークン認証 + +データ ソースがセキュリティ トークンの使用を要求する場合、`RVBearerTokenDataSourceCredential` クラスのインスタンスを返す必要があります。`RVBearerTokenDataSourceCredential` クラスは、**トークン**と**ユーザー ID** を定義するコンストラクターのオーバーロードを提供します。 + + + + +```cs +public class AuthenticationProvider: IRVAuthenticationProvider +{ + public Task ResolveCredentialsAsync(IRVUserContext userContext, RVDashboardDataSource dataSource) + { + IRVDataSourceCredential userCredential = null; + if (dataSource is RVGoogleDriveDataSource) + { + userCredential = new RVBearerTokenDataSourceCredential("token", "userid"); + } + return Task.FromResult(userCredential); + } +} +``` + + + + + +```java +public class AuthenticationProvider implements IRVAuthenticationProvider { + @Override + public IRVDataSourceCredential resolveCredentials(IRVUserContext userContext, RVDashboardDataSource dataSource) { + if (dataSource instanceof RVGoogleDriveDataSource) { + return new RVBearerTokenDataSourceCredential("token", "userid"); + } + return null; + } +} +``` + + + + + +```js +const authenticationProvider = async (userContext, dataSource) => { + if (dataSource instanceof reveal.RVGoogleDriveDataSource) { + return new reveal.RVBearerTokenDataSourceCredential("token", "userid"); + } + return null; +} +``` + + + + + +```ts +const authenticationProvider = async (userContext:IRVUserContext | null, dataSource: RVDashboardDataSource) => { + if (dataSource instanceof RVGoogleDriveDataSource) { + return new RVBearerTokenDataSourceCredential("token", "userid"); + } + return null; +} +``` + + + + +`RVBearerTokenDataSourceCredential` は、以下のデータ ソースでサポートされます。 +- Box +- Databricks +- Dropbox +- Google アナリティクス +- Google Big Query +- Google Drive +- Microsoft SQL Server +- OData サービス +- OneDrive +- REST サービス +- SharePoint オンライン +- Snowflake +- ウェブ リソース + +## Microsoft Entra ID 認証 + +Microsoft Entra ID (旧 Azure Active Directory) を使用して、Entra ID 認証をサポートするデータ ソース (Microsoft SQL Server など) のベアラー トークンを取得できます。取得したトークンは、`RVBearerTokenDataSourceCredential` を使用して Reveal SDK に渡されます。 + +:::info + +この例では、.NET 用の [Microsoft Authentication Library (MSAL)](https://learn.microsoft.com/ja-jp/entra/msal/overview) を使用しています。この方法を使用する前に、[Microsoft Entra ID](https://learn.microsoft.com/ja-jp/entra/identity-platform/quickstart-register-app) でアプリケーションを登録し、適切なデータベース権限を付与する必要があります。 + +::: + +**手順 1** - `Microsoft.Identity.Client` NuGet パッケージをインストールします。 + +```bash +dotnet add package Microsoft.Identity.Client +``` + +**手順 2** - Entra ID からトークンを取得し、`RVBearerTokenDataSourceCredential` として返す認証プロバイダーを作成します。 + + + + +```cs +public class AuthenticationProvider : IRVAuthenticationProvider +{ + public async Task ResolveCredentialsAsync(IRVUserContext userContext, + RVDashboardDataSource dataSource) + { + if (dataSource is RVSqlServerDataSource) + { + var token = await GetEntraTokenAsync("https://database.windows.net/.default"); + return new RVBearerTokenDataSourceCredential(token, "myaccount@mydomain.com"); + } + + return new RVUsernamePasswordDataSourceCredential(); + } + + private static readonly string ClientId = "your-client-id"; + private static readonly string ClientSecret = "your-client-secret"; + private static readonly string TenantId = "your-tenant-id"; + + private static async Task GetEntraTokenAsync(string scope) + { + var app = ConfidentialClientApplicationBuilder + .Create(ClientId) + .WithClientSecret(ClientSecret) + .WithAuthority(AzureCloudInstance.AzurePublic, TenantId) + .Build(); + + var result = await app + .AcquireTokenForClient(new[] { scope }) + .ExecuteAsync(); + + return result.AccessToken; + } +} +``` + + + + +:::note + +`your-client-id`、`your-client-secret`、`your-tenant-id` を Entra ID アプリ登録の値に置き換えてください。スコープ値 `https://database.windows.net/.default` は Azure SQL Server に固有です。他のデータ ソースでは異なるスコープが必要になる場合があります。 + +::: + +Microsoft Entra ID 認証は、以下のデータ ソースでサポートされます。 +- Microsoft SQL Server +- [Snowflake](https://docs.snowflake.com/en/user-guide/oauth-azure) + +## キーペア認証 + +データ ソースがキーペア認証を必要とする場合、`RVKeyPairDataSourceCredential` クラスのインスタンスを返す必要があります。`RVKeyPairDataSourceCredential` クラスは、**ユーザー**と**暗号化されていない RSA 秘密キー**を定義するコンストラクターのオーバーロードを提供します。 + + + + +```cs +public class AuthenticationProvider: IRVAuthenticationProvider +{ + public Task ResolveCredentialsAsync(IRVUserContext userContext, RVDashboardDataSource dataSource) + { + IRVDataSourceCredential userCredential = null; + if (dataSource is RVSnowflakeDataSource) + { + userCredential = new RVKeyPairDataSourceCredential("user", "unencrypted rsa-key"); + } + return Task.FromResult(userCredential); + } +} +``` + + + + + +```java +public class AuthenticationProvider implements IRVAuthenticationProvider { + @Override + public IRVDataSourceCredential resolveCredentials(IRVUserContext userContext, RVDashboardDataSource dataSource) { + if (dataSource instanceof RVSnowflakeDataSource) { + return new RVKeyPairDataSourceCredential("user", "unencrypted rsa-key"); + } + return null; + } +} +``` + + + + + +```js +const authenticationProvider = async (userContext, dataSource) => { + if (dataSource instanceof reveal.RVSnowflakeDataSource) { + return new reveal.RVKeyPairDataSourceCredential("user", "unencrypted rsa-key"); + } + return null; +} +``` + + + + + +```ts +const authenticationProvider = async (userContext:IRVUserContext | null, dataSource: RVDashboardDataSource) => { + if (dataSource instanceof RVSnowflakeDataSource) { + return new RVKeyPairDataSourceCredential("user", "unencrypted rsa-key"); + } + return null; +} +``` + + + + +`RVKeyPairDataSourceCredential` は、以下のデータ ソースでサポートされます。 +- Snowflake + +## Amazon Web Services + +データ ソースが Amazon Web Services (AWS) を使用している場合は、`RVAmazonWebServicesCredentials` クラスのインスタンスを返す必要があります。`RVAmazonWebServicesCredentials` クラスは、**key** と **secret** を定義するためのコンストラクターのオーバーロードを提供します。 + + + + +```cs +public class AuthenticationProvider: IRVAuthenticationProvider +{ + public Task ResolveCredentialsAsync(IRVUserContext userContext, RVDashboardDataSource dataSource) + { + IRVDataSourceCredential userCredential = null; + if (dataSource is RVS3DataSource) + { + userCredential = new RVAmazonWebServicesCredentials("key", "secret"); + } + return Task.FromResult(userCredential); + } +} +``` + + + + + +```java +public class AuthenticationProvider implements IRVAuthenticationProvider { + @Override + public IRVDataSourceCredential resolveCredentials(IRVUserContext userContext, RVDashboardDataSource dataSource) { + if (dataSource instanceof RVS3DataSource) { + return new RVAmazonWebServicesCredentials("key", "secret"); + } + return null; + } +} +``` + + + + + +```js +const authenticationProvider = async (userContext, dataSource) => { + if (dataSource instanceof reveal.RVS3DataSource) { + return new reveal.RVAmazonWebServicesCredentials("key", "secret"); + } + return null; +} +``` + + + + + +```ts +const authenticationProvider = async (userContext:IRVUserContext | null, dataSource: RVDashboardDataSource) => { + if (dataSource instanceof RVS3DataSource) { + return new RVAmazonWebServicesCredentials("key", "secret"); + } + return null; +} +``` + + + + +`RVAmazonWebServicesCredentials` は、次のデータ ソースでサポートされています。 +- Amazon Athena +- Amazon S3 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/beta-features.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/beta-features.md new file mode 100644 index 00000000..355dbffa --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/beta-features.md @@ -0,0 +1,80 @@ +# ベータ機能 API + +Reveal SDK は、**ベータ機能**を有効にして管理するための集中的な方法を提供します。これにより、正式にリリースされる前に新しい機能や実験的な機能をテストできます。 + +## ベータ機能の有効化 +ベータ機能は以下を使用して有効にできます。 + +```javascript +//enable one feature +$.ig.RevealSdkSettings.betaFeatures.enable("newPieChart"); + +//enable multiple features +$.ig.RevealSdkSettings.betaFeatures.enable("newPieChart", "newDonutChart"); + +//alternatively use an array +$.ig.RevealSdkSettings.betaFeatures.enable(...[ + "newPieChart", + "newDonutChart" +]); +``` + +## ベータ機能の無効化 +以前に有効にしたベータ機能を無効にするには: + +```javascript +$.ig.RevealSdkSettings.betaFeatures.disable("newPieChart"); +``` + +## 有効化されたすべてのベータ機能を取得する + +```javascript +const betafeatures = $.ig.RevealSdkSettings.betaFeatures.getEnabledFeatures(); +``` + +## 利用可能なベータ フラグ +次のベータ機能フラグを使用できます: + +### `newBulletGraph` +実験的なブレット グラフの表示形式を有効にします。 + +> 🚫 現時点では一般的な使用には**推奨されません**。このコンポーネントはまだ**開発中**であり、**実稼働環境に対応していません**。機能の制限、不完全なスタイリング、および予期しない問題が発生する可能性がありますので、ご注意ください。 + +### `newCircularGauge` +実験的なラジアル (円形) ゲージの表示形式を有効にします。 + +> 🚫 現時点では一般的な使用には**推奨されません**。このコンポーネントはまだ**開発中**であり、**実稼働環境に対応していません**。機能の制限、不完全なスタイリング、および予期しない問題が発生する可能性がありますので、ご注意ください。 + +### `newLinearGauge` +実験的なリニア ゲージの表示形式を有効にします。 + +> 🚫 現時点では一般的な使用には**推奨されません**。このコンポーネントはまだ**開発中**であり、**実稼働環境に対応していません**。機能の制限、不完全なスタイリング、および予期しない問題が発生する可能性がありますので、ご注意ください。 + +### `newDataGrid` +Reveal SDK で新しいデータ グリッドの表示形式を有効にします。 + +新しいデータ グリッドには次の機能があります: +- レンダリング パフォーマンスの向上 +- 強化された並べ替えとフィルタリング機能 +- 列の集計のサポート +- 列のピン固定機能 +- モバイルやタブレットでのエクスペリエンスを向上させるレスポンシブ レイアウト +- モダンなグリッド エクスペリエンスのためのその他の改善 + +この機能により、グリッドの表示形式が大幅にアップグレードされ、ユーザーはより強力で柔軟なデータ グリッド コンポーネントを利用できるようになります。表形式のデータを扱う際に、高度なグリッド機能と優れたパフォーマンスが必要なユーザーに最適です。 + +> ✅ ダッシュボードでの改善されたグリッド パフォーマンスと新しいグリッド機能をテストする場合に**推奨されます**。 + +### `newTooltip` +Reveal SDK で新しいホバーベースのツールチップ エクスペリエンスを有効にします。 + +この機能を有効にすると、次のようになります。 + +- ツールチップはクリック時ではなく**ホバー時**に表示されます。 +- **ツールチップ アクション** (ドリルダウン、フィルタリングなど) は、クリックしなくてもすぐに利用できます。 +- 表示形式内のインタラクティブ オプションの発見可能性と使いやすさが向上します。 +- 一般的なデータ視覚化の実践に合わせた、よりモダンで直感的なエクスペリエンスを提供します。 + +この動作は、ユーザーがデータ ポイントを**クリックした**後にのみ表示されるデフォルトのツールチップからの大きな変更です。`newTooltip` フラグにより、インタラクションの流れが簡素化され、ホバー ツールチップによる高速かつ手間の少ないデータ探索が可能になります。 + +> ✅ より高速でインタラクティブなデータ探索をテストする場合に**推奨されます**。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/caching.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/caching.md new file mode 100644 index 00000000..a1e060fb --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/caching.md @@ -0,0 +1,309 @@ +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# キャッシュ + +Reveal SDK のキャッシュは、クエリされたすべてのデータを、キャッシュと呼ばれる高速な組み込みデータベースに保存することでパフォーマンスを最適化するように設計されたデフォルトの仕組みです。このプロセスにより、頻繁にアクセスされるデータがすぐに利用できるようになり、クエリの開始時に、要求されたデータがすでにキャッシュに存在するかどうかが SDK によって自動的にチェックされます。キャッシュ ヒットの場合、SDK は元のソースへの追加リクエストを必要とせずに、情報を迅速に取得します。 + +## キャッシュの仕組み +SDK を通じてデータをクエリすると、パイプライン ステップごとに、そのデータを取得するために使用されるすべてのオプションを含む新しい**キー**が作成されます。この**キー**は、パイプライン ステップからの結果データと一緒に保存されます。同じ操作を繰り返すと、各パイプライン ステップに固有のキーが認識され、対応するデータがキャッシュから取得されます。ただし、順序付けやフィルタリングなど、特定のステップのデータ クエリの構成を変更すると、**キー**は一致せず、影響を受けるステップおよびそれ以降のステップで処理が実行されます。この新しいクエリは結果とともに保存されます。たとえば、Excel ファイルから取得したデータの順序を変更しても、ファイルが再度ダウンロードされることはなく、フィルターやその後のステップなど、変更が必要な特定のステップの処理のみが実行されます。 + +### 処理パイプライン +処理パイプラインは、データがシステムで処理される一連のステージを示します。処理パイプラインを理解することは、キャッシュがどこでどのように動作するかを識別するために重要であり、データ取得の最適化と全体的な処理効率の向上に重要な役割を果たします。 + +```mermaid +graph LR; + A[Download Resource]-->B[Create Dataset]-->C[Calculate Fields]-->D[Filter]-->E[Pivot Table Build]-->F[Post Pivot - Calculate Fields]-->G[Post Pivot - Filter]; +``` + +
+ +- `[Download Resource]` ステージは、通常、CSV/Json/Excel ファイルをダウンロードするリソースベースのデータ ソースを使用する場合にのみ適用されます。 +- 要求されたデータによっては、一部のステージがスキップされたり、変更が加えられなかったりする場合があります。たとえば、処理するピボット後の計算フィールドがないか、データ ソースに送信されるクエリにすべてのフィルターが含まれている場合は、`[Filter]` ステップが不要になる可能性があります。 +- SSAS データ ソースは別の処理パイプラインを使用するため、これらのステージは SSAS データ ソースには適用されません。 + +### キャッシュ ファイル +デフォルトでは、キャッシュ ファイルは現在のユーザーの一時ディレクトリ内の `RevealCache_XXXX` という名前のフォルダーに保存されます。`XXXX` はインスタンスを識別する番号です。`CachePath` と `DataCachePath` という 2 つの構成プロパティを使用して、このデフォルトの動作をオーバーライドできます。 + +```cs +builder.Services + .AddControllers() + .AddReveal(revealSetupBuilder => + { + revealSetupBuilder.AddSettings(settings => + { + settings.CachePath = "your-cache-path"; + settings.DataCachePath = "your-data-cache-path"; + }); + }); +``` + +- `CachePath` は、残りのキャッシュ ファイル (ダウンロード ファイルなど) が保存されるディレクトリを指します。デフォルトでは、システムの一時ディレクトリにある `RevealCache_XXXX` という名前のディレクトリになります。 +- `DataCachePath` は、ファイル キャッシュ データが保存されるディレクトリを指します。デフォルトは `CachePath` です。 + +追加のプロパティを構成して、キャッシュ サイズを制御できます。 + +```cs +builder.Services.AddControllers().AddReveal(revealSetupBuilder => +{ + revealSetupBuilder.AddSettings(settings => + { + settings.MaxStorageCells = 10000000; + settings.MaxDownloadSize = 209715200; + settings.MaxStringCellSize = 256; + settings.MaxTotalStringsSize = 64000000; + }); +}); +``` + +- `MaxStorageCells` は、任意のデータ ソースから処理されるセルの予想される最大サイズを指します。エンジンは、キャッシュにディスク領域を使いすぎないようにします。この設定は、キャッシュ管理のヒントを提供します。デフォルトは 1000 万セルです。 +- `MaxDownloadSize` は、1 回のダウンロード (CSV ファイルなど) の最大サイズをバイト単位で表します。デフォルトは 200 MB です。 +- `MaxStringCellSize` は、データセット列の文字列が持つことができる文字数の制限を指します。デフォルトは 256 です。 +- `MaxTotalStringsSize` は、すべてのセルの文字の総数として指定された、ピボット テーブルまたはグリッドの予想される最大サイズを指します。この設定によりメモリ管理のヒントを提供し、エンジンによるメモリの過多な使用を避けます。デフォルトは 6400 万です。 + +### キャッシュの種類 +**Download (ダウンロード)** - `[Download Resource]` ステージで使用されるこのキャッシュは、CSV/Excel/Json ファイルからデータを読み取るときに、ダウンロードされたリソースを保存します。ファイルシステム キャッシュは `[RevealCache]/download` に保存され、関連するメタデータは `[RevealCache]/download.sqlite` に保存されます。 + +個々のダウンロードは、`MaxDownloadSize` 設定で指定されたバイト数によって制限されます。ダウンロード キャッシュの全体的なサイズは 5GB に固定されています。現時点ではこの制限を変更するための API が存在しないことに注意してください。 + +**Dataset (データセット)** - `[Create Dataset]` ステージと `[Calculate Fields]` ステージで使用されます。 + +Sqlite ファイルは `[RevealCache]/dataset` に保存され、メタデータは `dataset.sqlite` に存在します。 + +一部のデータセットはメモリ内に生成され、メモリ内のデータセット キャッシュにも保存されます。 + +個々のデータセットのサイズは、一連のパラメーターによって間接的に制限されます: `MaxStorageCells` および `MaxTotalStringsSize`。データセット キャッシュの合計サイズは 5 GB に固定されています。現時点では、この制限を変更するために使用できる API はありません。 + +**Tabular Data (表形式のデータ)** - このキャッシュは、すべてのステージを実行した後の結果を保持します。 + +データは JSON としてシリアル化され、メモリ内キャッシュに一時的に保存されます。 + +## キャッシュの更新 +キャッシュの更新には、精度を維持し、最新の情報を反映するために、キャッシュ内に保存されているデータを更新することが含まれます。デフォルトでは、キャッシュは `1 日に 1 回`更新されるように設定されています。キャッシュ更新の動作は視覚化 UI から変更でき、ユーザーは特定の要件に基づいて更新期間を変更したり、手動更新をトリガーしたりできます。 + +メニューの更新オプション (3 つの点で示されている) をクリックするだけで、手動更新をトリガーできます。 + +![](images/cache-refresh.jpg) + +データの更新頻度コンボ ボックスから別の値を選択することで、更新頻度を変更できます。このオプションは、データ ソース構成ダイアログで使用できます。 + +使用できるオプションは以下のとおりです。 +- 常に +- 1 時間に 1 回 +- 1 日に 1 回 +- 週に １ 回 + +![](images/cache-frequency.jpg) + +## キャッシュの無効化 +キャッシュを無効にすることは利用可能なオプションではありません。ただし、データ ソースのデータ更新頻度を `[常に]` に設定すると、同様の結果が得られます。この構成により、アプリケーションはキャッシュをバイパスして常に新しいデータを取得できるようになります。クエリ中にキャッシュが参照されない場合でも、処理されたデータは保存されることに注意してください。このアプローチでは最新の情報へのアクセスが保証されますが、リアルタイム アクセスを利用する場合、データ ソースへの負荷の増加による潜在的なパフォーマンスへの影響に留意することが重要です。開発者は、デバッグ目的や、頻繁に変更される動的データを扱う場合に、一時的にこの構成を選択することがあります。 + +キャッシュをバイパスするには、データ ソースのデータ更新頻度を `[常に]` に設定します。 + +![](images/cache-disable.jpg) + +## Redis Cache + +Reveal SDK は、分散キャッシュ プロバイダーとして Redis を使用することをサポートしており、複数のサーバー インスタンス間でのキャッシュ共有を可能にします。これは、アプリケーションの複数のインスタンスが同じキャッシュされたデータにアクセスする必要がある負荷分散環境で特に役立ちます。 + +:::note + +Redis Cache 機能は、表形式のデータに使用されるメモリ内キャッシュを置き換えます。ローカル処理操作では引き続き SQLite キャッシュが使用されます。ローカル処理は、直接クエリできないソースからのデータを取得してローカルで処理する必要がある場合に発生します。これには以下の設定が含まれます。 +- ストアド プロシージャ +- REST API +- クロス データ ソース結合を含むデータ ソース項目 +- クエリ実行のために元のソースからデータを取得して一時的に保存する必要があるその他のソース + +::: + +### インストール + + + + +ASP.NET アプリケーションの場合、Redis Cache のサポートを有効にするには、別の NuGet パッケージをインストールする必要があります。 + +```bash +dotnet add package Reveal.Sdk.Cache.Redis +``` + + + + +Node.js アプリケーションの場合、Redis Cache はメインの Reveal SDK パッケージに既に含まれています。標準の Reveal SDK セットアップ以外に追加のインストールは必要ありません。 + + + + +Java アプリケーションの場合、Redis Cache はメインの Reveal SDK パッケージに既に含まれています。標準の Reveal SDK セットアップ以外に追加のインストールは必要ありません。 + + + + +### 構成 + +Redis Cache を有効にするには、アプリケーションの初期化時に接続を構成します。 + + + + +```cs +builder.AddRedisCache((options) => { + options.ConnectionString = "localhost:6379"; +}); +``` + + + + + +```js +const revealOptions = { + ... + redisOptions: { connectionString: "localhost:6379" } +}; +``` + + + + + +```ts +const revealOptions: RevealOptions = { + ... + redisOptions: { connectionString: "localhost:6379" } +}; +``` + + + + + +```java +initializeParameterBuilder.enableRedisCache((options) -> { + options.setConnectionString("localhost:6379"); +}); +``` + + + + +### Redis 構成オプション + +Redis Cache プロバイダーは、接続と動作をカスタマイズするためのさまざまな構成オプションをサポートしています。 + +- **ConnectionString** - Redis サーバー接続文字列またはエンドポイント (例: "localhost:6379")。デフォルトは空の文字列です。 +- **EndPoints** - Redis クラスターまたは複数の Redis インスタンスに接続するために使用されるエンドポイント URL のリスト。デフォルトは null です。 +- **User** - Redis 認証のユーザー名。デフォルトは null です。 +- **Password** - Redis 認証のパスワード。デフォルトは null です。 +- **UseSsl** - SSL/TLS 暗号化が有効かどうかを示します。デフォルトは false です。 +- **DefaultDatabase** - 使用するデフォルトのデータベース番号。デフォルトは 0 です。 +- **ClientName** - 識別用のクライアント名。デフォルトは null です。 +- **ConnectTimeoutMs** - 接続タイムアウト (ミリ秒単位)。デフォルトは 5000 です。 +- **SyncTimeoutMs** - 同期操作のタイムアウト (ミリ秒単位)。デフォルトは 5000 です。 +- **AsyncTimeoutMs** - 非同期操作のタイムアウト (ミリ秒単位)。デフォルトは 5000 です。 +- **ConnectRetry** - 接続再試行回数。デフォルトは 3 です。 +- **KeepAliveSeconds** - キープアライブ間隔 (秒単位)、無効にするには -1。デフォルトは 60 です。 +- **AbortOnConnectFail** - 接続失敗時に中止するかどうかを示します。デフォルトは false です。 +- **AllowAdmin** - 管理コマンド (FLUSHDB、CONFIG など) が許可されるかどうかを示します。デフォルトは false です。 +- **ReconnectRetryPolicy** - 再接続再試行ポリシー: Linear または Exponential。デフォルトは Linear です。 +- **RetryDelayMs** - 再試行ポリシーの基本遅延 (ミリ秒単位)。デフォルトは 1000 です。 + +追加の構成オプションの例: + + + + +```cs +builder.AddRedisCache((options) => { + options.ConnectionString = "localhost:6379"; + options.Password = "your-password"; + options.UseSsl = true; + options.DefaultDatabase = 1; + options.ConnectTimeoutMs = 10000; +}); +``` + + + + + +```js +const revealOptions = { + ... + redisOptions: { + connectionString: "localhost:6379", + password: "your-password", + useSsl: true, + defaultDatabase: 1, + connectTimeoutMs: 10000 + } +}; +``` + + + + + +```ts +const revealOptions: RevealOptions = { + ... + redisOptions: { + connectionString: "localhost:6379", + password: "your-password", + useSsl: true, + defaultDatabase: 1, + connectTimeoutMs: 10000 + } +}; +``` + + + + + +```java +initializeParameterBuilder.enableRedisCache((options) -> { + options.setConnectionString("localhost:6379"); + options.setPassword("your-password"); + options.setUseSsl(true); + options.setDefaultDatabase(1); + options.setConnectTimeoutMs(10000); +}); +``` + + + + +## よくある質問 + +**質問: キャッシュは多くのディスク領域を消費しますか?** + +**答:** キャッシュは約 20 GB を使用するように設計されており、必要に応じて古いエントリが自動的に削除されます。現在、このサイズを調整するための公開設定はありません。 + +**質問: ディスクがいっぱいになってきていますが、Reveal が原因だと思います。** + +**答え:** バグを報告する前に、OS の一時ディレクトリがクリアされていないか確認してください。Reveal やその他のプロセスは、OS が再起動するまで削除されない可能性がある一時ファイルを生成する場合があります。このディレクトリを定期的に管理するために、クリーンアップ処理をスケジュールすることを考慮してください。Reveal は自動的に削除される一時ファイルをいくつか作成します。そのため、最近作成されたファイルは Reveal で進行中の操作の一部である可能性があるため、クリーンアップ処理によって削除されないようにしてください。さらに、Reveal のキャッシュ フォルダーが OS の一時ディレクトリ内に存在する場合、クリーンアップ処理によって削除されることはありません。 + +**質問: 異なるユーザーのキャッシュ エントリを分離するにはどうすればよいですか?** + +**答え:** これはセキュリティ上の理由からよく行われます。ただし、異なるユーザーが基になるデータ ソースに対して同等のアクセス権を持っている場合は、キャッシュ エントリを共有することで全体的なパフォーマンスを向上できます。デフォルトでは、Reveal は後者のアプローチを採用します。セキュリティに関しては、次の点に注意する必要があります。 + - 現在のユーザーを識別するには、`IRVUserContextProvider` の `IRVUserContext.UserId` プロパティを設定します。このコンテキストは `IRVDataSourceProvider` および `IRVAuthenticationProvider` でアクセス可能であり、ユーザー固有の決定が可能になります。 + - 現在のユーザーの `IRVDataSourceProvider` でデータ ソースを構成します。データ ソースをユーザーのロールに関連するものに制限し、それに応じてプロパティを調整します (例: Database/Table/CustomQuery プロパティがユーザーの権限と一致していることを確認する)。 + - `IRVAuthenticationProvider` でユーザーに適切な資格情報を割り当てます。 + + これらの手順は、キャッシュに関係なく、セキュリティにとって重要です。キャッシュに関しては、Reveal は提供された情報 (データ ソース、資格情報、場合によっては UserId) を利用してキャッシュ エントリを作成します。これらのエントリは、同じデータ ソースと資格情報を共有している場合にのみユーザー間で共有できます。つまり、一致する権限で同一のクエリを実行できることを意味します。 + +**質問: `IRVUserContext.UserId` はキャッシュエントリにどのような影響を与えますか?** + +**答え:** 現在のところ、個別の UserId 値がキャッシュ内に個別のエントリを生成するという保証はありません。ただし、`RVHeadersDataSourceCredentials` 資格情報タイプを使用する場合は、UserId が正しく設定されていることを確認することが重要です。正しく設定されていないと、キャッシュの問題が発生する可能性があります。 + +**質問: `RVBearerTokenDataSourceCredential.UserId` プロパティはキャッシュ エントリにどのような影響を与えますか?** + +**答え:** `RVBearerTokenDataSourceCredential.UserId` が設定されている場合は、キャッシュ エントリ キーの作成時に使用されるため、パフォーマンスを向上させるために設定することをお勧めします。`RVBearerTokenDataSourceCredential` の UserId は `RVBearerTokenDataSourceCredential` アクセス トークンにリンクされた UserId に対応し、`IRVUserContext` の UserId と異なる場合があることに注意してください。 + +**質問: 導入では、Reveal サーバーのインスタンスが複数存在します。どうすればキャッシュを共有できるのでしょうか?** + +**答え:** Reveal SDK は、複数のサーバー インスタンス間でキャッシュを共有できる Redis Cache をサポートするようになりました。[Redis Cache](#redis-cache) セクションで説明されているように Redis Cacheを構成すると、すべてのサーバー インスタンスが同じ分散キャッシュにアクセスできるようになります。これは、負荷分散された展開に推奨される方法です。 + +代替手段として、Redis が利用できない場合、ロード バランサーを設定し、同一グループのユーザーを同じ Reveal サーバー インスタンスにルーティングすることができます。これにより、キャッシュ エントリが特定のインスタンス内に作成され、それらのユーザーからの後続のリクエストは同じインスタンスにヒットし、キャッシュされたデータを効率的に利用できるようになります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/chart-types.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/chart-types.md new file mode 100644 index 00000000..e13e05c6 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/chart-types.md @@ -0,0 +1,69 @@ +# チャート タイプ + +**チャート タイプ**は、ダッシュボードの視覚化として使用できるさまざまなタイプのチャートを表します。可視化を作成または編集する場合、チャート タイプは [チャート タイプ] ドロップダウン メニューから選択します。 + +![](images/chart-types.jpg) + +Reveal SDK は、さまざまなグループに配置された 37 タイプのチャートを提供します。グループは次のとおりです。 + +- 最も人気 +- グリッド +- カテゴリ +- ゲージ +- マップ +- 散布 +- 財務 +- 時間 +- その他 + +## チャート タイプのカスタマイズ +カスタム可視化を変更、削除、またはチャート タイプ ドロップダウンに追加するには、`revealView.chartTypes` 配列内の項目を変更するだけです。 + +### チャート タイプの更新 +既存のチャート タイプを更新するには、`revealView.chartTypes` プロパティでチャート タイプを見つけます。チャート タイプのさまざまなプロパティを変更して、チャート タイプ項目の名前変更、アイコンの変更、または再グループ化を行います。 + +```js +var barConfig = revealView.chartTypes.find(x => x.chartType == 'BarChart'); +barConfig.title = 'My Cool Bar'; +barConfig.icon = 'https://help.revealbi.io/img/logo.png'; +barConfig.groups = ["Enterprise Visualizations", "HR", "Some Other Category"]; +``` + +### チャート タイプの削除 +削除するチャート タイプ項目のインデックスを見つけて、それを `chartTypes` 配列から削除することで、チャート タイプを削除します。 + +```js +var gridConfig = revealView.chartTypes.find(x => x.chartType == 'Grid'); +revealView.chartTypes.splice(revealView.chartTypes.indexOf(gridConfig), 1); +``` + +### カスタム チャート タイプの追加 +既存のチャート タイプ項目を更新および削除するだけでなく、カスタム可視化を新しいチャート タイプとして [チャート タイプ] ドロップダウンに追加することもできます。 + +```js +revealView.chartTypes.push({ + title: "Custom Viz", + url: "https://host/customViz.html", //provide the url to your custom vizualization + icon: "https://help.revealbi.io/img/logo.png", + groups: ["Custom Vizualizations"] +}); +``` + +## デフォルトのチャート タイプを設定する +デフォルトでは、Reveal SDK はデフォルトのチャート タイプとして `ColumnChart` チャートを設定します。デフォルトのチャート タイプを変更するには、`revealView.defaultChartType` プロパティを [RVChartType](https://help.revealbi.io/api/javascript/latest/enums/rvcharttype.html) 列挙メンバーの 1 つに設定します。 + +```js +revealView.defaultChartType = "StackedColumnChart"; +``` + +デフォルトのチャート タイプをカスタム可視化に設定する場合は、`revealView.defaultCustomChartType` プロパティをカスタム可視化のタイトルに設定する必要があります。 + +```js +revealView.defaultChartType = "My Custom Viz"; +``` + +:::info コードの取得 + +チャート タイプを示すサンプルは、[GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/ChartTypes) で見つけることができます。 + +::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/click-events.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/click-events.md new file mode 100644 index 00000000..f8275545 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/click-events.md @@ -0,0 +1,24 @@ +# クリック イベント + +エンドユーザーが表示形式内のデータ ポイントをクリックすると、`onVisualizationDataPointClicked` イベントが呼び出されます。`onVisualizationDataPointClicked` イベントにイベント ハンドラーを追加することで、このイベントに応答できます。 + +```js +revealView.onVisualizationDataPointClicked = (visualization, cell, row) => { + +}; +``` + +イベント ハンドラーには、次のパラメーターがあります: +- **cell** - クリックされたデータ ポイントを取得します。 +- **row** - セルに関連付けられているセル データのコレクションを取得します。 +- **visualization** - クリックされた視覚化を取得します。 + +`cell` や`row` のパラメーターなど、イベントによって公開されたパラメーターを使用することで、クリックされたデータ ポイントに関連付けられているデータを読み取ることができます。 + +`row` プロパティは、クリックされたセルに関連付けられた各データ ポイントを表すすべての `RVDataCell` オブジェクトのコレクションを提供することを理解することが重要です。 + +`RVDataCell` には次のプロパティがあります: +- **columnLabel** - データ ポイントに属する列のラベルまたはカスタム名称 +- **columnName** - データ ポイントに属する列の名前 +- **formattedValue** - データ ポイントの書式設定された値 +- **value** - データ ポイントの元の値 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/configure-export.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/configure-export.md new file mode 100644 index 00000000..c850cfa7 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/configure-export.md @@ -0,0 +1,107 @@ +# エクスポートの構成 + +## ASP.NET + +ダッシュボードを**画像**、**PDF**、または **PowerPoint** に (プログラムで、またはユーザーの操作を通じて) エクスポートするために、RevealSDK は内部で [Playwright](https://playwright.dev/dotnet/) を使用します。 + +デフォルトでは、ユーザーがダッシュボードを画像、PDF、または PowerPoint に初めてエクスポートしようとすると、Playwright は Chromium ブラウザーを現在のプラットフォームのデフォルトの場所にダウンロードしようとします。Windows の場合、デフォルトのパスは **%userprofile%/AppData/Local/ms-playwright** です。 + +このダウンロードには時間がかかり、ダッシュボードをエクスポートしようとする最初のエンドユーザーユーザーに遅延が発生する可能性があります。これは開発中は問題ありませんが、プロダクション環境では望ましくない場合があります。これらのシナリオでは、以下の設定を使用して、エクスポートの動作を微調整できます。 + +これらの設定は `RevealEmbedSettings.Export` のプロパティで公開されます。 +- CreateChromiumInstancesOnDemand - これを false に設定すると、アプリの起動時に Playwright の初期化が強制的に行われます。 +- ChromiumDownloadFolder - Chromium 実行可能ファイルがダウンロードされるパス。 +- ChromiumExecutablePath - Chromium 実行可能ファイルがサーバーに予めインストールされているパス。 +- MaxConcurrentExportingThreads - エクスポートに使用される最大同時スレッド数。 +- ExportingTimeout - エクスポート操作のタイムアウト期間 (ミリ秒単位)。デフォルト値は 30000 ms。指定されたタイムアウト期間内にエクスポート操作が終了しない場合、エクスポート操作は失敗します。 + +Playwright と Chromium をサーバーに手動でインストールするには、[Playwright CLI](https://playwright.dev/dotnet/docs/cli) を使用します。 + +```bash +dotnet tool install --global Microsoft.Playwright.CLI +playwright install chromium +``` + +## Java + +(プログラム上またはユーザー インタラクションによって) ダッシュボードを**画像**にエクスポートするには、Reveal SDK は [Playwright](https://playwright.dev/java/) を使用します。ダッシュボードを **Excel**、**PDF**、または **PowerPoint** にエクスポートするには、Reveal SDK は **ExportTool** と呼ばれる内部アプリケーションを使用します。 + +デフォルトでは、エンドユーザーがダッシュボードを画像、PDF、PowerPoint に初めてエクスポートしようとすると、Playwright と ExportTool の両方が、それらの動作に必要な依存関係のダウンロードを自動的に開始します。ただし、プラットフォームによっては、事前にインストールが必要な依存関係があったり、サーバー環境が外部ダウンロードを制限しているなど、これらのツールを手動でセットアップする必要がある場合があります。 + +### Playwright の構成 + +Playwright は必要なバイナリをダウンロードしようとしますが、手動での構成が必要な場合は、Playwright の[ドキュメンテーション](https://playwright.dev/java/docs/intro) を確認してください。 + +#### Linux 依存性 + +Linux では、複数のネイティブ・ライブラリに依存します。インストールする必要のある依存関係の正確なリストは、使用するディストリビューション、バージョン、および以前にインストールしたパッケージのリストに依存します。 + +以下に、基本的な Ubuntu 18.0.4 ディストリビューションに必要なライブラリの一覧を示します。 + +```bash +sudo apt-get update + +sudo apt-get install -y libatk1.0-0\ + libatk-bridge2.0-0\ + libxkbcommon0\ + libxcomposite1\ + libxdamage1\ + libxfixes3\ + libxrandr2\ + libgbm1\ + libgtk-3-0\ + libpango-1.0-0\ + libcairo2\ + libgdk-pixbuf2.0-0\ + libatspi2.0-0 + +sudo apt-get install -y --no-install-recommends xvfb +``` + +:::note + +必要であれば、ログファイルに含まれるエラーから、不足しているライブラリに関する詳細な情報を得ることができます。 + +::: + +Ubuntu を使用する場合は、[Maven](https://maven.apache.org/install.html) を使用して Chromium の依存関係をインストールする必要があります。 + +```bash +mvn exec:java -e -Dexec.mainClass=com.microsoft.playwright.CLI -Dexec.args="install-deps chromium" +``` + +その他の環境では、以下の依存関係が必要な場合があります: + +```bash +sudo apt-get install -y --allow-unauthenticated libc6-dev +sudo apt-get install -y --allow-unauthenticated libx11-dev +``` + +### ExportTool の手動セットアップ + +ここからの手順は、以下のシナリオの場合のみ必要です。 +- 自動ダウンロードの仕組みに問題がある場合。 +- 事前にすべてをインストールしておきたい場合。 + +ステップ 1 - お使いのプラットフォームに必要なバイナリをダウンロードします: [Windows](https://download.infragistics.com/reveal/Builds/sdk/java/ExportTool/[var:sdkVersion]/win-x64.zip)、[Linux](https://download.infragistics.com/reveal/Builds/sdk/java/ExportTool/[var:sdkVersion]/linux-x64.zip)、[macOS](https://download.infragistics.com/reveal/Builds/sdk/java/ExportTool/[var:sdkVersion]/osx-x64.zip) + +ステップ 2 - Web アプリケーションが動作しているサーバーのディレクトリにファイルを解凍します (ユーザーはそのディレクトリにアクセスできる必要があります)。 + +ステップ 3 - ZIP ファイルを解凍した後、`///ExportTool` フォルダから ExportTool を入手できます。例を以下に示します。 + +`/1.0.0/linux-x64/ExportTool.` + +ステップ 4 - Reveal の初期化中に、ZIP ファイルを解凍したディレクトリを設定します。以下のようなコードになるはずです: + +```java +String exportToolDir = ""; +RevealEngineInitializer.initialize(new InitializeParameterBuilder(). + setExportToolContainerPath(exportToolDir). + build()); +``` + +また、以下のようにシステムプロパティ **reveal.exportToolContainerPath** を通じてディレクトリを指定することもできます: + +```bash +java -Dreveal.exportToolContainerPath= -jar target/upmedia-backend-spring.war +``` diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/creating-dashboards.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/creating-dashboards.md new file mode 100644 index 00000000..6327f519 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/creating-dashboards.md @@ -0,0 +1,24 @@ +# ダッシュボードの作成 + +新しいダッシュボードの作成は本当に簡単です。`$.ig.RevealView.Dashboard` プロパティを `$.ig.RVDashboard` オブジェクトの新しいインスタンスに設定する必要があります。 + +まず、`id` を `revealView` に設定して `
` 要素を定義します。 +```html +
+``` + +次に、JavaScript で、`$.ig.RevealView.Dashboard` プロパティを `$.ig.RVDashboard` オブジェクトの新しいインスタンスに設定します。 +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.dashboard = new $.ig.RVDashboard(); +``` + +アプリケーションを実行すると、新しい空のダッシュボードが表示されます。 + +![](images/creating-dashboards.jpg) + +ご覧のとおり、これにより使用する新しいダッシュボード インスタンスが提供されますが、ダッシュボードで使用するデータ ソースを `$.ig.RevealView` に提供していない限り、エンドユーザーは新しいダッシュボードで表示形式を作成できません。 + +次の手順: +- [データ ソースの追加](adding-data-sources/in-memory-data.md) +- [ダッシュボードの読み込み](loading-dashboards.md) \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/custom-menu-items.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/custom-menu-items.md new file mode 100644 index 00000000..5a8fd774 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/custom-menu-items.md @@ -0,0 +1,146 @@ +# カスタム メニュー項目 + +Reveal SDK はカスタム メニュー項目の追加をサポートしており、ユーザーはダッシュボードや可視化のコンテキスト メニューの動作を変更できます。メニューのカスタマイズにより、カスタム メニュー項目を追加したり、セパレーターを定義してセクションを作成したりすることで、独自の機能をメニューに組み込むことができます。 + +メニューを操作するには、まずクライアント上で `revealView.onMenuOpening` イベントのイベント ハンドラーを追加する必要があります。 + +```js +const revealView = new $.ig.RevealView("#revealView"); + +revealView.onMenuOpening = function (visualization, args) { + ... +}; +``` + +`menuLocation` プロパティを利用することで、ダッシュボード全体または可視化全体のメニュー項目の動作をカスタマイズできます。値 `Dashboard` はメニューがダッシュボード上にあることを示し、`Visualization` はメニューが可視化用であることを示します。 + +```js +const revealView = new $.ig.RevealView("#revealView"); + +revealView.onMenuOpening = function (visualization, args) { + //to modify menu behavior on dashboard + if (args.menuLocation === $.ig.RVMenuLocation.Dashboard) { + ... + } + + // to modify menu behavior on visualizations + if (args.menuLocation === $.ig.RVMenuLocation.Visualization) { + ... + } +}; +``` + +さらに、可視化の `title` などの追加プロパティに基づいて動作を柔軟にカスタマイズできます。 + +```js +const revealView = new $.ig.RevealView("#revealView"); + +revealView.onMenuOpening = function (visualization, args) { + //to modify menu behavior on dashboard + if (args.menuLocation === $.ig.RVMenuLocation.Dashboard) { + ... + } + + // to modify menu behavior on visualizations + if (args.menuLocation === $.ig.RVMenuLocation.Visualization) { + ... + + //adding a new menu item to the "Tasks completed" visualization + if(visualization.title === "Tasks Completed") { + ... + } + } +}; +``` + +## 例: 特定の可視化でのカスタム メニュー項目の作成 + +**手順 1** - クライアントに `revealView.onMenuOpening` イベントのイベント ハンドラーを追加します。 + +**手順 2** - クラス `RVMenuItem` の新しいインスタンスを作成し、それを `args.menuItems` 配列にプッシュします。`RVMenuItem` に指定されたコールバックは、クリックされると呼び出されます。 + +```js +$.ig.RevealSdkSettings.setBaseUrl("https://samples.revealbi.io/upmedia-backend/reveal-api/"); + +$.ig.RVDashboard.loadDashboard("Project Management").then(dashboard => { + const revealView = new $.ig.RevealView("#revealView"); + revealView.dashboard = dashboard; + + revealView.onMenuOpening = function (visualization, args) { + // to modify menu behavior on visualizations + if (args.menuLocation === $.ig.RVMenuLocation.Visualization) { + //adding a new menu item to the "Tasks completed" visualization + if(visualization.title === "Tasks Completed") { + const menuItem = new $.ig.RVMenuItem("Custom Item on Tasks Completed", new $.ig.RVImage("https://i.pinimg.com/736x/03/c8/a2/03c8a2aff8be6bee9064eef9b5d72d66.jpg", "Icon"), () => { + alert('my action'); + }) + args.menuItems.push(menuItem); + } + } + }; +}); +``` + +## 例: メニューに新しいセクションを作成する + +**手順 1** - クライアントに `revealView.onMenuOpening` イベントのイベント ハンドラーを追加します。 + +**手順 2** - `RVMenuSeparatorItem` をインスタンス化して、メニューにセパレーターを追加します。 + +**手順 3** - 新しいセクションに追加するメニュー項目の `RVMenuItem` のインスタンスを作成します。 + +```js +$.ig.RevealSdkSettings.setBaseUrl("https://samples.revealbi.io/upmedia-backend/reveal-api/"); + +$.ig.RVDashboard.loadDashboard("Project Management").then(dashboard => { + const revealView = new $.ig.RevealView("#revealView"); + revealView.dashboard = dashboard; + + revealView.onMenuOpening = function (visualization, args) { + // to modify menu behavior on visualizations + if (args.menuLocation === $.ig.RVMenuLocation.Visualization) { + args.menuItems.push(new $.ig.RVMenuSeparatorItem()); + const menuItem1 = new $.ig.RVMenuItem("New section item 1", new $.ig.RVImage("https://i.pinimg.com/736x/03/c8/a2/03c8a2aff8be6bee9064eef9b5d72d66.jpg", "Icon"), () => { + alert('action 1'); + }) + args.menuItems.push(menuItem1); + const menuItem2 = new $.ig.RVMenuItem("New section item 2", new $.ig.RVImage("https://i.pinimg.com/736x/03/c8/a2/03c8a2aff8be6bee9064eef9b5d72d66.jpg", "Icon"), () => { + alert('action 2'); + }) + args.menuItems.push(menuItem2); + } + }; +}); +``` + +![](images/adding-custom-menu-item.jpg) + +## 例: 事前定義されたメニュー項目の非表示 + +**手順 1** - クライアントに `revealView.onMenuOpening` イベントのイベント ハンドラーを追加します。 + +**手順 2** - `args.menuItems` 配列で、非表示にする要素を見つけて、その `isHidden` プロパティを `true` に設定します。 + +```js +$.ig.RevealSdkSettings.setBaseUrl("https://samples.revealbi.io/upmedia-backend/reveal-api/"); + +$.ig.RVDashboard.loadDashboard("Project Management").then(dashboard => { + const revealView = new $.ig.RevealView("#revealView"); + revealView.dashboard = dashboard; + + revealView.onMenuOpening = function (visualization, args) { + //hiding a menu item + for (let i = 0; i < args.menuItems.length; i++) { + if(args.menuItems[i].title === "Export") args.menuItems[i].isHidden = true; + } + }; +}); +``` + +![](images/hiding-menu-item.jpg) + +:::info コードの取得 + +このサンプルのソース コードは、[GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/CustomMenuItems) にあります。 + +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/custom-queries.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/custom-queries.md new file mode 100644 index 00000000..d9dedadc --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/custom-queries.md @@ -0,0 +1,178 @@ +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# カスタム クエリ + +カスタム クエリは、特定の要件に従ってデータベース内のデータを取得または操作するために特別に作成された命令です。 +データベース管理システムの事前定義クエリとは異なり、カスタム クエリは、独自のまたは複雑なデータの取得と操作のニーズを満たすように調整されています。 + +カスタム クエリは、次のデータ ソースでサポートされています。 + +- [Amazon Athena](adding-data-sources/amazon-athena.md) +- Amazon Redshift +- [Google BigQuery](adding-data-sources/google-big-query.md) +- Microsoft Azure SQL Database +- Microsoft Azure Synapse Analytics +- [Microsoft SQL Server](adding-data-sources/ms-sql-server.md) +- [MySQL](adding-data-sources/mysql.md) +- [Oracle](adding-data-sources/oracle.md) +- [PostgreSQL](adding-data-sources/postgres.md) +- [Snowflake](adding-data-sources/snowflake.md) + +**手順 1** - クライアント上のデータ ソース項目を定義します。 + +`RevealView.onDataSourcesRequested` イベントのイベント ハンドラーを追加します。この手順では、カスタム クエリでオーバーライドするデータ ソースを作成します。 +この例では、`RVSqlServerDataSource` を使用して SQL Server に接続しています。 + +```js +revealView.onDataSourcesRequested = (callback) => { + const sqlServerDataSource = new $.ig.RVSqlServerDataSource(); + sqlServerDataSource.id = "MySqlServerDataSource"; + sqlServerDataSource.title = "My SQL Server"; + + const sqlServerDataSourceItem = new $.ig.RVSqlServerDataSourceItem(sqlServerDataSource); + sqlServerDataSourceItem.id = "MySqlServerDataSourceItem"; + sqlServerDataSourceItem.title = "John Orders"; + + callback(new $.ig.RevealDataSources([sqlServerDataSource], [sqlServerDataSourceItem], true)); +}; +``` + +**手順 2** - サーバー上のデータ ソース項目をオーバーライドします。 + +```cs +if (sqlDataSourceItem.Id == "MySqlServerDataSourceItem") +{ + //get the sales-person-id from the userContext + var salesPersonId = userContext.Properties["sales-person-id"]; + + //parametrize your custom query with the property obtained before + sqlDataSourceItem.CustomQuery = + $"SELECT * FROM [Sales].[SalesOrderHeader] WHERE [SalesPersonId] = {salesPersonId}"; +} +``` + +## 例 - クライアントが提供する値を使用したカスタム クエリの作成 + +1 - クライアント上のデータ ソース項目を定義します。 + +```js +$.ig.RevealSdkSettings.setBaseUrl("http://localhost:5111/"); + +var revealView = new $.ig.RevealView("#revealView"); +revealView.startInEditMode = true; + +revealView.onDataSourcesRequested = (callback) => { + const sqlServerDataSource = new $.ig.RVSqlServerDataSource(); + sqlServerDataSource.id = "MySqlServerDataSource"; + sqlServerDataSource.title = "My SQL Server"; + + const sqlServerDataSourceItem = new $.ig.RVSqlServerDataSourceItem(sqlServerDataSource); + sqlServerDataSourceItem.id = "MySqlServerDataSourceItem"; + sqlServerDataSourceItem.title = "John Orders"; + + callback(new $.ig.RevealDataSources([sqlServerDataSource], [sqlServerDataSourceItem], true)); +}; +``` + +2 - クライアントでは、`$.ig.RevealSdkSettings.setAdditionalHeadersProvider()` メソッドを使用して、サーバーに送信する追加ヘッダーを設定します。この例では、`x-sales-person-id` という名前のヘッダーを使用しています。 + +```js +$.ig.RevealSdkSettings.setBaseUrl("http://localhost:5111/"); +$.ig.RevealSdkSettings.setAdditionalHeadersProvider(function (url) { + const headers = {}; + //set the x-sales-person-id header that identifies the sales person + headers["x-sales-person-id"] = "279"; + return headers; +}); + +var revealView = new $.ig.RevealView("#revealView"); +revealView.startInEditMode = true; + +revealView.onDataSourcesRequested = (callback) => { + const sqlServerDataSource = new $.ig.RVSqlServerDataSource(); + sqlServerDataSource.id = "MySqlServerDataSource"; + sqlServerDataSource.title = "My SQL Server"; + + const sqlServerDataSourceItem = new $.ig.RVSqlServerDataSourceItem(sqlServerDataSource); + sqlServerDataSourceItem.id = "MySqlServerDataSourceItem"; + sqlServerDataSourceItem.title = "John Orders"; + + callback(new $.ig.RevealDataSources([sqlServerDataSource], [sqlServerDataSourceItem], true)); +}; +``` + +3 - サーバー上のヘッダーを処理するための `RVUserContextProvider` を定義して登録します。ヘッダーを抽出し、適切なプロパティを登録する必要があります。 + +```cs +public class UserContextProvider : IRVUserContextProvider +{ + public IRVUserContext GetUserContext(HttpContext httpContext) + { + //when using standard auth mechanisms, the userId can be obtained using aspnetContext.User.Identity.Name. + var userIdentityName = httpContext.User.Identity?.Name; + var userId = userIdentityName ?? "guest"; + + //get the sales-person-id header set on the client + var salesPersonId = httpContext.Request.Headers["x-sales-person-id"]; + + //add the sales-person-id property + var props = new Dictionary { { "sales-person-id", salesPersonId } }; + + return new RVUserContext(userId, props); + } +} +``` + +4 - データ ソース プロバイダーで、データ ソース項目をオーバーライドしてカスタム クエリを定義します。 + +```cs +public class DataSourceProvider : IRVDataSourceProvider +{ + public Task ChangeDataSourceItemAsync(IRVUserContext userContext, string dashboardId, + RVDataSourceItem dataSourceItem) + { + if (dataSourceItem is RVSqlServerDataSourceItem sqlDataSourceItem) + { + //update underlying data source + ChangeDataSourceAsync(userContext, sqlDataSourceItem.DataSource); + + if (sqlDataSourceItem.Id == "MySqlServerDataSourceItem") + { + //get the sales-person-id from the userContext + var salesPersonId = userContext.Properties["sales-person-id"]; + + //parametrize your custom query with the property obtained before + sqlDataSourceItem.CustomQuery = + $"SELECT * FROM [Sales].[SalesOrderHeader] WHERE [SalesPersonId] = {salesPersonId}"; + } + } + + return Task.FromResult(dataSourceItem); + } + + public Task ChangeDataSourceAsync(IRVUserContext userContext, + RVDashboardDataSource dataSource) + { + if (dataSource is RVSqlServerDataSource sqlDataSource) + { + sqlDataSource.Host = "your-host"; + sqlDataSource.Database = "your-database"; + } + + return Task.FromResult(dataSource); + } +} +``` + +:::caution + +Java で `MySqlDataSourceItem` を使用する場合は、必ずテーブルの完全修飾名を使用してください。そうしないと機能しません。完全修飾テーブル名は、データベース識別子とテーブル識別子で構成されます (例: `database.table`)。クエリにこの構造が反映されていることを確認してください (`SELECT * FROM database.table` など)。 + +::: + +:::info コードの取得 + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/CustomQueries) にあります。 + +::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/custom-visualizations.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/custom-visualizations.md new file mode 100644 index 00000000..f0c6acd3 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/custom-visualizations.md @@ -0,0 +1,175 @@ +# カスタム表示形式 + +Reveal SDK は、アプリケーションにシームレスに統合される、豊富な種類の事前定義された表示形式を、デフォルトでユーザーに提供します。これらの表示形式は、データを素早く効率的に表示するための手段を提供します。ただし、特殊な状況や特別なケースでは、特有の要件に従ってデータの表示をカスタマイズする必要がある場合があります。このような場合、Reveal SDK はカスタム表示形式を通じてソリューションを提供します。 + +カスタム表示形式は、自由に定義できる特注のコンポーネントとして機能します。これらのコンポーネントは Reveal SDK から直接データを受け取ることができ、標準にはない高度にカスタマイズされた方法で情報を表示できるようになります。このようなカスタマイズにより、アプリケーションの特定の視覚的および分析的ニーズを確実に満たすことができ、よりカスタマイズされたユーザー中心のエクスペリエンスを提供できます。特殊なチャート、独自のグラフ、またはデータの独特な表現のいずれであっても、カスタム表示形式は、真にパーソナライズされた効果的なデータ プレゼンテーション ソリューションを作成するためのツールを開発者に提供します。 + +カスタム表示形式を作成するには、**事前定義されたコンポーネント** (表示形式が描画する方法を示す) と**ブリッジ** (コンポーネントと Reveal SDK によって管理されるデータとの間の接続として機能する) の両方が必要です。ブリッジはデータ変更のイベントを公開する必要があり、コンポーネントはこのイベントをサブスクライブして更新されたデータを取得する必要があります。 + +# ブリッジのセットアップ + +上記に記述した通り、SDK からのデータを使用するには、ブリッジを定義する必要があります。以下は、ブリッジがどのように構造化されるかを示しています。 + +```js +var host; +window.revealBridge = { + sendMessageToHost: function (data) { + try { + if (window.parent && window.parent.location) { + window.parent.postMessage(data, "*"); + } + } catch (e) { + // window.parent.postMessage couldn't be executed. + // This sould never happen but... + } + }, + + notifyExtensionIsReady: function (formatting) { + + if (formatting) { + this.sendMessageToHost({ message: "ready", formatting: true }); + } else { + this.sendMessageToHost({ message: "ready" }); + } + }, +} + +function processMessageFromHost(message) { + if (!message || !message.data || !message.data.metadata) { + return; + } + + if (message.data.message) { + // This is the same message that I'm sending to notify that the extension is ready and the iPad is sending it back here. + return; + } + + if (!window.revealBridgeListener) { + return; + } + + window.revealBridgeListener.dataReady(message.data); +}; + +window.addEventListener('message', processMessageFromHost, false); +``` + +# カスタム表示形式の定義 + +この例では、Angular を使用しています。Angular コンポーネントを作成しましょう。コンポーネント内には、ブリッジで事前に定義された `window.revealBridgeListener` のイベント ハンドラーを含める必要があります。 + +```ts +export class TableComponent implements OnInit { + + data: any = []; + headers: any = []; + + constructor(private ref: ChangeDetectorRef) { } + + ngOnInit(): void { + window.revealBridgeListener = { + dataReady: (incomingData: any) => { + this.data = this.dataToJson(incomingData); + this.createTableHeaders(this.data); + this.ref.detectChanges(); + } + }; + window.revealBridge.notifyExtensionIsReady(); + } + + createTableHeaders(data: any) { + if (data.length === 0) { + return; + } + + Object.keys(this.data[0]).map((propertyName: string) => { + this.headers.push(propertyName) + }) + } + + dataToJson(data: any) { + let propertyNames = []; + + if (!data.metadata.columns) { + return []; + } + + for (var c = 0; c < data.metadata.columns.length; c++) { + var column = data.metadata.columns[c]; + propertyNames.push(column.name); + } + + let dataObjects = []; + for (var i = 0; i < data.data.length; i++) { + var rowData = data.data[i]; + let dataObject: any = {}; + for (var j = 0; j < rowData.length; j++) { + dataObject[propertyNames[j]] = rowData[j]; + } + dataObjects.push(dataObject); + } + + return dataObjects; + } +} +``` + +これで、必要に応じてデータを表示する準備が整いました。以下はテンプレートを表しています。 + +```html +
+ + + + + + + + + + + +
{{header}}
{{ row[header] }}
+
+``` + +最後の手順として、このように定義したコンポーネントを参照して、カスタム表示形式を SDK に登録する必要があります。このコードは、Reveal ビューを含むコンポーネント内で呼び出す必要があります。 + +`RVChartTypeItem` オブジェクトを `revealView.chartTypes` 配列に追加します。必須のプロパティ (`title`、`url`、`icon`、および `groups`) を必ず指定してください。`url` プロパティは、定義したコンポーネントの場所を参照する必要があります。 + +チャート タイプの登録について、追加情報が必要な場合は、[カスタム チャート タイプの追加](chart-types.md#カスタム-チャート-タイプの追加)に関するドキュメントを参照してください。 + +```ts +export class DashboardViewerComponent implements AfterViewInit { + + @ViewChild('revealView') el!: ElementRef; + + async ngAfterViewInit() { + let dashboard = await $.ig.RVDashboard.loadDashboard("Sales"); + var revealView = new $.ig.RevealView(this.el.nativeElement); + revealView.dashboard = dashboard; + + //add custom vizualization to chart types drop down + revealView.chartTypes.push({ + title: "HTML Table", + url: "http://localhost:4200/table", //provide the url to your custom vizualization + icon: "https://help.revealbi.io/img/logo.png", + groups: ["Custom Vizualizations"] + }); + } +} +``` + +**[チャート タイプ]** ドロップダウンに、追加した表示形式が表示されます。 + +![](images/custom-visualizations-dialog.jpg) + +表示形式がダッシュボードに追加されると、次のようになります: + +![](images/custom-visualizations-data.jpg) + +:::info コードの取得 + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/CustomVisualization) にあります。 + +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/customizing-map-tiles.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/customizing-map-tiles.md new file mode 100644 index 00000000..0c8caa1f --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/customizing-map-tiles.md @@ -0,0 +1,64 @@ +# マップ タイルのカスタマイズ + +Reveal SDK には、散布マップ (散布図) の表示形式タイプが含まれています。デフォルトでは、この表示形式は追加のコンテキストを提供せずに、データ ポイントをマップ上に直接配置します。ただし、開発者は、ニーズに応じてこの動作を柔軟に調整できます。生データを直接表示するのではなく、マップ タイルを使用することを選択でき、フィードされたデータと一緒にマップ情報を表示することで表示形式を強化できます。このオプションは、地理データのより包括的で視覚的に魅力的な表現を提供します。 + +現在、以下のタイル マップ プロバイダーがシステムでサポートされています: `Bing`、`Esri`、`MapBox`、および `OpenStreetMap` です。 + +開始するには、まずデフォルトの散布マップを作成する必要があります。これはプロセスの最初の手順として機能し、散布マップの基本機能を探索できるようになります。 + +![](images/customizing-map-tiles-default.jpg) + +ご覧のとおり、ポイントが正しく生成された場合でも、生成されたマップにはコンテキストが欠けています。この問題を解決するには、マップにタイルを追加する必要があります。タイルを組み込むことで、マップの全体的なコンテキストを強化する必要な背景と視覚的なフレームワークが提供され、マップがより有益でユーザーにとって魅力的なものになります。 + +タイルを組み込むには、SDK と選択したプロバイダーとの間の接続を確立する必要があります。この場合、選択したプロバイダーとして `OpenStreetMap` を利用しています。 + +```js +const url = 'https://tile.openstreetmap.org/{Z}/{X}/{Y}.png' +$.ig.RevealSdkSettings.visualizations.scatterMaps = $.ig.ScatterMapVisualizationsConfiguration.createOpenStreetMapConfiguration(url); +``` + +![](images/customizing-map-tiles-tiles.jpg) + +## 他のプロバイダー + +### Bing + +**手順 1** - [Bing Maps Portal](https://www.bingmapsportal.com/) でアカウントを作成します。 + +**手順 2** - `[My account]` -> `[My Keys]` で新しいキーを作成します。 + +**手順 3** - 以前に生成したキーをアプリケーションに追加します。 + +```js +$.ig.RevealSdkSettings.visualizations.scatterMaps = new $.ig.ScatterMapVisualizationsConfiguration("Bing", "your-key"); +``` + +### Esri + +**手順 1** - [ArcGIS](https://www.arcgis.com/) でアカウントを作成します。 + +**手順 2** - [新しいトークンを生成します](https://developers.arcgis.com/rest/users-groups-and-items/generate-token.htm)。 + +**手順 3** - 生成されたトークンをアプリケーションに追加します。 + +```js +$.ig.RevealSdkSettings.visualizations.scatterMaps = new $.ig.ScatterMapVisualizationsConfiguration("Esri", "your-token"); +``` + +### MapBox + +**手順 1** - [MapBox](https://www.mapbox.com/) でアカウントを作成します。 + +**手順 2** - `[Tokens]` -> `[Create a token]` (または公開トークンを使用します)。 + +**手順 3** - 生成されたトークンをアプリケーションに追加します。 + +```js +$.ig.RevealSdkSettings.visualizations.scatterMaps = new $.ig.ScatterMapVisualizationsConfiguration("MapBox", "your-token"); +``` + +:::info コードの取得 + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/CustomizingMapTiles) にあります。 + +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/data-size-limits.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/data-size-limits.md new file mode 100644 index 00000000..f3ab38c0 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/data-size-limits.md @@ -0,0 +1,23 @@ +# データ制限 + +ダウンロードされたファイルのサイズ、結果セット内のセルの数 (集計後)、ピボット テーブルとグリッドのサイズ (セルの数として指定) に関して、Reveal Web を使用する場合のサーバー側のサイズ制限があります。 +これらの制限の目的は、サーバーのリソース (メモリとディスク領域) が不足するのを防ぐことです。 + +デフォルトの制限値: + +- csv/json/excel をダウンロードする場合は 200mb +- 1000 万のセル +- 6400 万文字 (すべてのセルのすべての文字列を追加) + +## デフォルト値を変更 + +### ソース +[**RevealEmbedSettings**](https://help.revealbi.io/api/aspnet/latest/Reveal.Sdk.RevealEmbedSettings.html) + + +| プロパティ | 型| 説明 | +|---|---|---| +| MaxDownloadSize | `System.Nullable` | 1 回のダウンロード (CSV ファイルなど) のサイズに制限を設定します。デフォルトは 200Mb です。| +| MaxInMemoryCells | `System.Nullable` | このプロパティを、任意のデータ ソース (SQL Server テーブルの行、CSV 行など) から処理されるセルの予想される最大サイズに設定します。エンジンは、キャッシュにディスク領域を使いすぎないようにします。この設定は、キャッシュ管理のヒントを提供します。デフォルトは 1000 万セルです。 | +| MaxStringCellSize | `System.Nullable` | データセット列の文字列が持つことができる文字数の制限を設定します。デフォルトは 256 です。 | +| MaxTotalStringsSize | `System.Nullable` | このプロパティを、すべてのセルの文字の総数として指定された、ピボット テーブルまたはグリッドの予想される最大サイズに設定します。エンジンはメモリの使用を避け、この設定はメモリ管理のヒントを提供します。デフォルトは 6400 万です。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/datasources.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/datasources.md new file mode 100644 index 00000000..771bb23c --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/datasources.md @@ -0,0 +1,345 @@ +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; +import DataSourcesTable from '@site/src/components/DataSourcesTable'; + +# データ ソース + +:::danger 重大な変更 + +現在、Reveal SDK は、Reveal SDK core パッケージからデータ ソースを分離する過程にあります。プロジェクトの継続的な機能を確保するために、プロジェクトに追加のパッケージをインストールすることが必要になる場合があります。詳細については、[サポートされるデータ ソース](web/datasources.md#サポートされるデータ-ソース) トピックを参照してください。 + +::: + +Reveal SDK は、分析ツール、コンテンツ マネージャー、クラウド サービス、CRM、データベース、スプレッドシート、公開データ ソースなど、30 を超えるデータ ソースをサポートしており、毎月さらに多くのデータ ソースが出荷されています。データ ソースは、ダッシュボードのどこからデータが取得されるかを定義します。各データ ソースには、接続文字列、ユーザー ID、パスワードなど、データに接続してデータを取得するためにコードで設定した固有のプロパティがあります。 + +Reveal SDK には、データ ソースに関して 2 つの概念があります。 +1. データ ソース - これはデータの主要なソースです。たとえば、SQL Server をデータ ソースにすることができます。 +2. データ ソース項目 - これは、データ ソースから利用できる特定の項目です。例えば、SQL Server の特定のテーブル。 + +データ ソース (データ ストア) とデータ ソース項目 (データ項目) は、Reveal View の **[データ ソースの選択]** ダイアログで別々に分類されます。 + +![](adding-data-sources/images/ms-sql-server-data-source-item.jpg) + +Reveal SDK でデータ ソースを作成するには、2 つの方法があります。 +1. クライアント側 +2. サーバー側 + +## データ ソースのインストール + +Reveal SDK で使用するデータ ソースを作成する前に、Reveal SDK アプリケーションで使用するデータ ソースごとに正しいパッケージをインストールする必要があります。 + +**手順 1** - 使用するデータ ソースのパッケージをインストールします。どのデータ ソースがサポートされているか、およびどのパッケージをインストールする必要があるかについては、[サポートされているデータ ソース](#サポートされるデータ-ソース) セクションを参照してください。 + +**手順 2** - データ ソース パッケージをインストールした後、データ ソースを Reveal SDK に登録します。 + + + + +```cs +using Reveal.Sdk; +using Reveal.Sdk.Data; + +builder.Services.AddControllers().AddReveal( builder => +{ + //all data sources use the RegisterXXX naming convention + builder.DataSources.RegisterMicrosoftSqlServer(); +}); +``` + + + + + +```java +Coming Soon... +``` + + + + + +```js +Coming Soon... +``` + + + + + +```ts +Coming Soon... +``` + + + + + +## クライアントでのデータ ソースの作成 + +クライアントでデータ ソースまたはデータ ソース項目を追加するには、`RevealView.onDataSourcesRequested` イベントにイベント ハンドラーを追加します。イベント ハンドラーでは、ダッシュボードで使用されるさまざまなタイプのデータ ソースまたはデータ ソース項目のインスタンスを作成するコードを記述します。次に、これらのインスタンスを `callback` に渡して、**[データ ソースの選択]** ダイアログで使用できるようにします。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + + //provide all data sources and data source items in callback + callback(new $.ig.RevealDataSources([], [], false)); +}; +``` +- データ ソースは、コールバックの最初のパラメーターに配列として提供されます。 +- データ ソース項目は、コールバックの 2 番目のパラメーターに配列として提供されます。 +- 3 番目のパラメーターは、ダッシュボードに保存されているデータ ソースが **[データ ソースの選択]** ダイアログに表示されるかどうかを決定します。`false` の場合、`onDataSourcesRequested` イベントで作成されたデータ ソースのみが表示されます。 + +クライアントでデータ ソースを作成するときは、データ ソースまたはデータ ソース項目のすべての接続情報を提供することが重要です。例えば、MS SQL Server のデータ ソースを作成する場合は、`host` や `database` などの接続情報を提供する必要があります。データ ソース項目の場合は、`table` を提供する必要があります。 + +```js +revealView.onDataSourcesRequested = (callback) => { + + var sqlServerDS = new $.ig.RVSqlServerDataSource(); + sqlServerDS.host = "your-db-host"; + sqlServerDS.database = "your-db-name"; + sqlServerDS.title = "My SQL Server"; + + var sqlServerDSI = new $.ig.RVSqlServerDataSourceItem(sqlServerDS); + sqlServerDSI.title = "My SQL Server Item"; + sqlServerDSI.table = "TableName"; + + callback(new $.ig.RevealDataSources([sqlServerDS], [sqlServerDSI], false)); +}; +``` + +データ ソースまたはデータ ソース項目で使用できるプロパティについては、データ ソースの対応するヘルプ トピックまたは [API ドキュメント](https://help.revealbi.io/api/javascript/latest/)を参照してください。 + +:::warning + +クライアントで JavaScript を使用してデータ ソースとデータ ソース項目を作成すると、サーバー名、ホスト名、IP アドレス、ポート番号、エンドポイントなどのすべての接続情報がブラウザーに公開されます。これにより、ユーザーはこれらの値を表示できるだけでなく、変更することもできます。公開する情報に注意し、クライアント側のアプローチを使用してデータ ソースを作成することに関連する潜在的なセキュリティ リスクを考慮することが重要です。 + +::: + +## サーバーでのデータ ソースの作成 + +サーバーでのデータ ソースまたはデータ ソース項目の作成は、クライアントでの作成と似ています。主な違いは、クライアントで接続情報が提供されないことです。`IRVDataSourceProvider` を実装することにより、すべての接続情報がサーバー上で提供されます。 + +イベント ハンドラーを `RevealView.onDataSourcesRequested` イベントに追加することから始め、データ ソースとデータ ソース項目を作成します。この例では、**MS SQL Server** を使用しています。データ ソースの識別に使用できる `id` と、**[データ ソースの選択]** ダイアログに表示される `title` のみを設定していることに注意してください。 + +```js +var revealView = new $.ig.RevealView("#revealView"); +revealView.onDataSourcesRequested = (callback) => { + + var sqlServerDS = new $.ig.RVSqlServerDataSource(); + sqlServerDS.id = "MySqlServerDataSource"; + sqlServerDS.title = "My Sql Server"; + + var sqlServerDSI = new $.ig.RVSqlServerDataSourceItem(sqlServerDS); + sqlServerDSI.id = "MySqlServerDataSourceItem"; + sqlServerDSI.title = "My Sql Server Item"; + + callback(new $.ig.RevealDataSources([sqlDataSource], [sqlServerDSI], false)); +}; +``` + +次に、サーバー アプリケーションで、データ ソース プロバイダーを作成する必要があります。データ ソース プロバイダーは、Reveal SDK に接続方法を指示するデータ ソースおよびデータ ソース項目のさまざまなプロパティを変更するために使用されます。 + +データ ソース プロバイダーは、次の 2 つの手順で作成できます。 + +**手順 1** - データ ソース プロバイダーを作成します。この例では、クライアントで定義された **MS SQL Server** データベースに接続するための接続情報を提供しています。これを実現するために、使用しているデータ ソース/項目のタイプを決定し、オブジェクトで使用可能なプロパティを設定します。 + + + + +```cs +public class DataSourceProvider : IRVDataSourceProvider +{ + public Task ChangeDataSourceItemAsync(IRVUserContext userContext, string dashboardId, RVDataSourceItem dataSourceItem) + { + if (dataSourceItem is RVSqlServerDataSourceItem sqlServerDsi) + { + //required: update underlying data source + ChangeDataSourceAsync(userContext, sqlServerDsi.DataSource); + + //only change the table if we have selected our data source item + if (sqlServerDsi.Id == "MySqlServerDatasourceItem") + { + //set the table/view + sqlServerDsi.Table = "Orders"; + } + } + return Task.FromResult(dataSourceItem); + } + + public Task ChangeDataSourceAsync(IRVUserContext userContext, RVDashboardDataSource dataSource) + { + if (dataSource is RVSqlServerDataSource sqlDatasource) + { + sqlDatasource.Host = "10.0.0.20"; + sqlDatasource.Database = "Northwind"; + sqlDatasource.Schema = "dbo"; + } + return Task.FromResult(dataSource); + } +} +``` + + + + + +```java +public class DataSourceProvider implements IRVDataSourceProvider { + + public RVDataSourceItem changeDataSourceItem(IRVUserContext userContext, String dashboardsID, RVDataSourceItem dataSourceItem) { + + if (dataSourceItem instanceof RVSqlServerDataSourceItem sqlServerDsi) { + //required: update underlying data source + changeDataSource(userContext, dataSourceItem.getDataSource()); + + //only change the table if we have selected our custom data source item + if (dataSourceItem.getId() == "MySqlServerDatasourceItem") { + sqlServerDsi.setTable("Orders"); + } + } + return dataSourceItem; + } + + public RVDashboardDataSource changeDataSource(IRVUserContext userContext, RVDashboardDataSource dataSource) { + if (dataSource instanceof RVSqlServerDataSource sqlDatasource) { + sqlDatasource.setHost("10.0.0.20"); + sqlDatasource.setDatabase("Northwind"); + sqlDatasource.setSchema("dbo"); + } + return dataSource; + } +} +``` + + + + + +```js +const dataSourceItemProvider = async (userContext, dataSourceItem) => { + if (dataSourceItem instanceof reveal.RVSqlServerDataSourceItem) { + + //required: update underlying data source + dataSourceProvider(userContext, dataSourceItem.dataSource); + + //only change the table if we have selected our data source item + if (dataSourceItem.id === "MySqlServerDatasourceItem") { + dataSourceItem.table = "Orders"; + } + } + return dataSourceItem; +} + +const dataSourceProvider = async (userContext, dataSource) => { + if (dataSource instanceof reveal.RVSqlServerDataSource) { + dataSource.host = "10.0.0.20"; + dataSource.database = "Northwind"; + dataSource.schema = "dbo"; + } + return dataSource; +} +``` + + + + + +```ts +const dataSourceItemProvider = async (userContext: IRVUserContext | null, dataSourceItem: RVDataSourceItem) => { + if (dataSourceItem instanceof RVSqlServerDataSourceItem) { + + //required: update underlying data source + dataSourceProvider(userContext, dataSourceItem.dataSource); + + //only change the table if we have selected our data source item + if (dataSourceItem.id === "MySqlServerDatasourceItem") { + dataSourceItem.table = "Orders"; + } + } + return dataSourceItem; +} + +const dataSourceProvider = async (userContext: IRVUserContext | null, dataSource: RVDashboardDataSource) => { + if (dataSource instanceof RVSqlServerDataSource) { + dataSource.host = "10.0.0.20"; + dataSource.database = "Northwind"; + dataSource.schema = "dbo"; + } + return dataSource; +} +``` + + + + + +**手順 2** - データ ソース プロバイダーを Reveal SDK に登録します。 + + + + +```cs +builder.Services.AddControllers().AddReveal( builder => +{ + builder.AddDataSourceProvider(); +}); +``` + + + + + +```java +RevealEngineInitializer.initialize(new InitializeParameterBuilder(). + setDataSourceProvider(new DataSourceProvider()). + build()); +``` + + + + + +```js +const revealOptions = { + dataSourceProvider: dataSourceProvider, + dataSourceItemProvider: dataSourceItemProvider, +} +app.use('/', reveal(revealOptions)); +``` + + + + + +```ts +const revealOptions: RevealOptions = { + dataSourceProvider: dataSourceProvider, + dataSourceItemProvider: dataSourceItemProvider, +} +app.use('/', reveal(revealOptions)); +``` + + + + + +:::danger Important + +`ChangeDataSourceAsync` メソッドでデータ ソースに加えられた変更は、`ChangeDataSourceItemAsync` メソッドには引き継がれません。どちらの方法でも、データ ソース プロパティを**更新する必要があります**。上記の例に示すように、`ChangeDataSourceItemAsync` メソッド内で `ChangeDataSourceAsync` メソッドを呼び出し、データ ソース項目の基になるデータ ソースをパラメーターとして渡すことをお勧めします。 + +::: + +## サポートされるデータ ソース + +:::tip 今後の拡張機能 + +現在、Reveal SDK は、Reveal SDK core パッケージからデータ ソースを分離する過程にあります。これにより、アプリケーションのサイズが削減されるだけでなく、新しいデータ ソースのリリースや既存のデータ ソースの更新も容易になります。Reveal SDK の次の進化に向けて取り組んでまいりますので、今しばらくお待ちいただきますようお願いいたします。 + +::: + +以下の表を使用して、サポートされているデータ ソースと、ターゲット フレームワークにインストールする必要があるパッケージを確認してください。 + + + +**SDK に含まれている** - このデータ ソースにインストールするための個別のパッケージはありません。データ ソースは Reveal SDK に含まれています。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/editing-dashboards.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/editing-dashboards.md new file mode 100644 index 00000000..7240429a --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/editing-dashboards.md @@ -0,0 +1,326 @@ +# ダッシュボードの編集 + +ダッシュボードの編集は主にエンドユーザー機能ですが、開発者がさまざまな編集イベントに応答したり、UI 要素を表示/非表示にして編集エクスペリエンスを制御したり、編集を完全に無効にしたりするのに役立つ API が多数あります。 + +## プロパティ + +### canAddCalculatedFields + +このプロパティは、表示形式エディターの **[計算フィールド]** メニュー項目を表示/非表示にします。 + +![](images/editing-canaddcalculatedfields.jpg) + +```js +revealView.canAddCalculatedFields = false; +``` + +### canAddDashboardFilter + +このプロパティは、ダッシュボードの **[ダッシュボード フィルターの追加]** メニュー項目を表示/非表示にします。 + +![](images/editing-canadddashboardfilter.jpg) + +```js +revealView.canAddDashboardFilter = false; +``` + +### canAddDateFilter + +このプロパティは、ダッシュボードの **[日付フィルターの追加]** メニュー項目を表示/非表示にします。 + +![](images/editing-canadddatefilter.jpg) + +```js +revealView.canAddDateFilter = false; +``` + +### canAddPostCalculatedFields + +このプロパティは、表示形式視覚化エディターのフィールド セクションの **F(x)** メニュー項目を表示/非表示にします。 + +![](images/editing-canaddpostcalculatedfields.jpg) + +```js +revealView.canAddPostCalculatedFields = false; +``` + +### canAddVisualization + +このプロパティは、編集モードのときにダッシュボードの **[+ 追加]** ボタンを表示/非表示にします。 + +```js +revealView.canAddVisualization = false; +``` + +### canChangeVisualizationBackgroundColor + +このプロパティを使用すると、表示形式エディターの **[設定]** タブで表示形式の背景色を指定できます。 + +![](images/editing-canChangeVisualizationBackgroundColor.jpg) + +```js +revealView.canChangeVisualizationBackgroundColor = true; +``` + +このプロパティを使用する場合は、次の依存関係をクライアント アプリケーションにインストールする必要があります: + +- Spectrum v 1.8.0 以降 + +``` html + + +``` + +### canCopyVisualization + +このプロパティは、表示形式の **[コピー]** メニュー項目を表示/非表示にします。 + +![](images/editing-cancopyvisualization.jpg) + +```js +revealView.canCopyVisualization = false; +``` + +### canDuplicateVisualization + +このプロパティは、表示形式の **[複製]** メニュー項目を表示/非表示にします。 + +![](images/editing-canduplicatevisualization.jpg) + +```js +revealView.canDuplicateVisualization = false; +``` + +### canEdit + +このプロパティは、ダッシュボードの **[編集]** メニュー項目を表示/非表示にします。 + +![](images/editing-canedit.jpg) + +```js +revealView.canEdit = false; +``` + +`RevealView.canEdit` プロパティが `false` に設定されている場合、ダッシュボード編集は完全に無効になります。 + +### canMaximizeVisualization + +このプロパティは、表示形式の**最大化**ボタンを表示/非表示にします。 + +![](images/editing-canMaximizeVisualization.jpg) + +```js +revealView.canMaximizeVisualization = false; +``` + +### canSaveAs + +このプロパティは、ダッシュボード メニューの **[名前を付けて保存]** ボタンを表示/非表示にします。 + +![](images/editing-canSaveAs.jpg) + +```js +revealView.canSaveAs = false; +``` + +### showChangeDataSource + +このプロパティは、表示形式エディターの [データ] タブにある **[データ ソースの変更]** ボタンを表示/非表示にします。 + +![](images/editing-showChangeDataSource.jpg) + +```js +revealView.showChangeDataSource = false; +``` + +### showEditDataSource + +このプロパティは、表示形式エディターでデータ ソースの **[編集]** メニュー項目を表示/非表示にします。 + +![](images/editing-showeditdatasource.jpg) + +```js +revealView.showEditDataSource = false; +``` + +### showExportImage + +このプロパティは、エクスポート メニューから **[画像]** 項目を表示/非表示にします。 + +![](images/editing-showExportImage.jpg) + +```js +revealView.showExportImage = false; +``` + +### showExportToExcel + +このプロパティは、エクスポート メニューから **[Excel]** 項目を表示/非表示にします。 + +![](images/editing-showExportToExcel.jpg) + +```js +revealView.showExportToExcel = false; +``` + +### showExportToPDF + +このプロパティは、エクスポート メニューから **[PDF]** 項目を表示/非表示にします。 + +![](images/editing-showExportToPDF.jpg) + +```js +revealView.showExportToPDF = false; +``` + +### showExportToPowerPoint + +このプロパティは、エクスポート メニューから **[PowerPoint]** 項目を表示/非表示にします。 + +![](images/editing-showExportToPowerPoint.jpg) + +```js +revealView.showExportToPowerPoint = false; +``` + +### showFilters + +このプロパティは、ダッシュボード フィルターを表示/非表示にします。 + +![](images/editing-showFilters.jpg) + +```js +revealView.showFilters = false; +``` + +### showHeader + +このプロパティは、ダッシュボードのタイトルとダッシュボード メニューを含むダッシュボード ヘッダー全体を表示/非表示にします。 + +```js +revealView.showHeader = false; +``` + +### showMenu + +このプロパティは、`RevealView` の右上隅に配置されているダッシュボード メニューを表示/非表示にします。 + +```js +revealView.showMenu = false; +``` + +### showRefresh + +このプロパティは、ダッシュボード メニューの **[更新]** ボタンを表示/非表示にします。 + +![](images/editing-showRefresh.jpg) + +```js +revealView.showRefresh = false; +``` + +### startInEditMode + +`true` に設定すると、このプロパティは、ダッシュボードが最初に読み込まれたときに `RevealView` を「編集モード」にします。 + +![](images/editing-startineditmode.jpg) + +```js +revealView.startInEditMode = false; +``` + +### startWithNewVisualization + +`true` に設定すると、このプロパティはすぐに [新しい表示形式] ダイアログを起動し、データ ソースを選択するように求めます。 + +![](images/editing-startwithnewvisualization.jpg) + +```js +revealView.startWithNewVisualization = false; +``` + +:::info + +既存のダッシュボードを読み込んでいて、`RevealView.startInEditMode` プロパティを `true` に設定していない場合、このプロパティは機能しません。 + +::: + +## Events + +### onVisualizationEditorOpening + +表示形式エディターが開く**前**にアプリケーション ロジックを実行したい場合や、条件が満たされるまでエディターが開かないようにしたい場合もあります。これを行うには、イベント ハンドラーを `RevealView.onVisualizationEditorOpening` イベントに追加します。 + +```js +revealView.onVisualizationEditorOpening = function (args) { + if(args.isNewVisualization == false){ //the user is trying to edit an existing visualization + args.cancel = true; //prevent it + } +}; +``` + +`VisualizationEditorOpeningArgs` には、次のプロパティが含まれています: +- **cancel** - イベントをキャンセルするかどうかを示す値を取得または設定します。イベントをキャンセルする必要がある場合は `true`。それ以外の場合は `false`。 +- **isNewVisualization** - `true` の場合、表示形式は新しく追加された表示形式です。`false` の場合、それは既存の表示形式です。 +- **visualization** - 編集および/または追加された表示形式 + +:::info + +`VisualizationEditorOpeningArgs.cancel` を `true` に設定すると、表示形式視覚化エディターは開きません。 + +::: + +### onVisualizationEditorOpened + +表示形式エディターを開いた**後**、既存の表示形式を編集するとき、または新しい表示形式を作成するときに通知を受け取りたい場合は、`RevealView.onVisualizationEditorOpened` イベントにイベント ハンドラーを追加できます。 + +```js +revealView.onVisualizationEditorOpened = function (args) { + if(args.isNewVisualization == false) { + //the user is editing an existing visualization + } +}; +``` + +`VisualizationEditorOpenedEventArgs` には、次のプロパティが含まれています: +- **isNewVisualization** - `true` の場合、表示形式は新しく追加された表示形式です。`false` の場合、それは既存の表示形式です。 +- **visualization** - 編集および/または追加された表示形式 + +### onVisualizationEditorClosing + +表示形式エディターが閉じる**前**にアプリケーション ロジックを実行したい場合や、条件が満たされるまでエディターが閉じないようにしたい場合もあります。これを行うには、`RevealView.onVisualizationEditorClosing` イベントにイベント ハンドラーを追加します。 + +```js +revealView.onVisualizationEditorClosing = function (args) { + if(args.isNewVisualization == false) { //the user is editing + args.resetVisualization = true; //puts the widget to the state when it was when the user started editing it + } +}; +``` + +`VisualizationEditorClosingArgs` には、次のプロパティが含まれています: +- **cancel** - イベントをキャンセルするかどうかを示す値を取得または設定します。イベントをキャンセルする必要がある場合は `true`。それ以外の場合は `false`。 +- **isNewVisualization** - `true` の場合、表示形式は新しく追加された表示形式です。`false` の場合、それは既存の表示形式です。 +- **resetVisualization** - `true` の場合、表示形式を編集前の状態にリセットします。 +- **visualization** - 編集および/または追加された表示形式 + +:::info + +`VisualizationEditorClosingArgs.cancel` を `true` に設定すると、表示形式視覚化エディターは閉じません。 + +::: + +### onVisualizationEditorClosed +エンドユーザーが `RevealView` で単一の表示形式を編集するときはいつでも、エディターが閉じられた**後**に `RevealView.onVisualizationEditorClosed` イベントが発生します。これは、既存の表示形式の編集、または新しい表示形式の追加に対応する場合があります。`RevealView.onVisualizationEditorClosed` イベントにイベント ハンドラーを追加することで、このイベントに応答できます。 + +```js +revealView.onVisualizationEditorClosed = function (args) { + if(args.isNewVisualization == false) { + } +}; +``` + +`VisualizationEditorClosedEventArgs` には、次のプロパティが含まれています: +- **isCancelled** - 表示形式エディターが **X ボタン** (`false`) または **Check ボタン** (`true`) のどちらで閉じられたかを決定します。 +- **isNewVisualization** - `true` の場合、表示形式は新しく追加された表示形式です。`false` の場合、それは既存の表示形式視覚化です。 +- **visualization** - 編集および/または追加された表示形式 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/exporting-dashboards.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/exporting-dashboards.md new file mode 100644 index 00000000..ea73dd3c --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/exporting-dashboards.md @@ -0,0 +1,155 @@ +# エクスポート + +Reveal SDK を使用すると、ダッシュボードと表示形式の両方をエクスポートして、新しいドキュメント タイプまたは画像を生成できます。 + +サポートされているダッシュボードのエクスポート形式: +- CSV +- Excel +- 画像 +- PDF +- PowerPoint + +サポートされている視覚化エクスポート形式: +- Excel +- 画像 + +すべてのエクスポート オプションは、ダッシュボードを開いたとき、または視覚化を最大化したときに、`RevealView` オーバー フロー メニューの **[エクスポート]** メニュー項目にあります。 + +![](images/export-menu-item.jpg) + +ユーザーが **[エクスポート]** ボタンをクリックすると、有効なエクスポート オプションの 1 つを選択できます。 + +## CSV へエクスポート +CSV エクスポートは、エンドユーザーが **[エクスポート]** オーバーフロー メニューから **[CSV]** メニュー項目をクリックすると実行されます。 + +![](images/export-csv.jpg) + +**[CSV]** メニュー項目は、`RevealView.showExportToCSV` プロパティを設定することで表示/非表示にできます。 + +```js +revealView.showExportToCSV = false; +``` + +**[CSV]** メニュー項目をクリックすると、エンドユーザーにさまざまなオプションの入力を求められます。これにより、ユーザーはエクスポートの名前を変更したり、エクスポートに含める表示形式のデータを選択したり、フォーマットされた値を使用するか生の値を使用するかを選択できます。 + +![](images/export-csv-options.jpg) + +## Excel へエクスポート +エンドユーザーが **[エクスポート]** オーバーフロー メニューから **[Excel]** メニュー項目をクリックすると、Excel のエクスポートが実行されます。 + +![](images/export-excel.jpg) + +**[Excel]** メニュー項目は、`RevealView.showExportToExcel` プロパティを設定することで表示/非表示にできます。 + +```js +revealView.showExportToExcel = false; +``` + +**[Excel]** メニュー項目をクリックすると、エンドユーザーは、ワークブックのタイトル、ワークシートのタイトル、作成するワークシート、および表示形式を含めるかどうかを変更できるさまざまなオプションを求められます。 + +![](images/export-excel-options.jpg) + + +## 画像へのエクスポート +Reveal SDK では、ダッシュボードまたは表示形式を画像にエクスポートする方法が 2 つあります: +- エンドユーザーによるエクスポート +- プログラムでエクスポート + +### エンドユーザーによる画像エクスポート +エンドユーザーの画像のエクスポートは、エンドユーザーが **[エクスポート]** オーバーフロー メニューから **[画像]** メニュー項目をクリックすると実行されます。 + +![](images/export-image.jpg) + +**[画像]** メニュー項目は、`RevealView.showExportImage` プロパティを設定することで表示/非表示にできます。 + +```js +revealView.showExportImage = false; +``` + +**[画像]** メニュー項目をクリックすると、エンドユーザーにダイアログが表示され、画像をクリップボードにコピーするか、組み込みの画像エディターを使用して画像を編集するか、画像を PNG としてディスクに保存するかを選択できます。 + +![](images/export-image-options.jpg) + +#### カスタム画像のエクスポート +デフォルトでは、エンドユーザーが **[画像をエクスポート] ダイアログ**の **[画像をエクスポート]** ボタンをクリックすると、画像がエクスポートされ、エンドユーザーが画像ファイルを保存する場所を選択できるようにブラウザーのダウンロードに追加されます。ただし、この動作は傍受することができ、代わりにカスタム画像エクスポート ロジックを使用できます。 + +カスタム画像エクスポートを使用するには、`RevealView.onImageExported` イベントにイベント ハンドラーを追加する必要があります。 + +```js +revealView.onImageExported = (image) => { + +}; +``` + +`RevealView.onImageExported` イベントは、画像のエクスポートを保存するのに役立つ次のパラメーターを提供します: +- **image** - 撮影されたダッシュボードのスクリーンショット + +#### 例: カスタム画像のエクスポート + +```js +revealView.onImageExported = (image) => { + var body = window.open("about:blank").document.body; + body.appendChild(image); +}; +``` + +### プログラムで画像のエクスポート +エンドユーザーの操作なしでダッシュボードの画像をプログラムでエクスポートするには、`RevealView.toImage` メソッドを呼び出す必要があります。`RevealView.toImage` メソッドを呼び出すと、画面に表示されている RevealView コンポーネントのスクリーンショットが作成されます。``RevealView.toImage`` メソッドは、[画像をエクスポート] ダイアログでユーザーにプロンプトを**表示しません**。 + +```cs +revealView.toImage( image => { + //handle image +}); +``` + +#### 例: プログラムで画像のエクスポート + +```html + +``` + +```js +function exportToImage() { + revealView.toImage(image => { + console.log(image); + var body = window.open("about:blank").document.body; + body.appendChild(image); + }); +} +``` + +:::info コードの取得 + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/master/Exporting-Image) にあります。 + +::: + +## PDF へのエクスポート +PDF エクスポートは、エンドユーザーが **[エクスポート]** オーバーフロー メニューから **[PDF]** メニュー項目をクリックすると実行されます。 + +![](images/export-pdf.jpg) + +**[PDF]** メニュー項目は、`RevealView.ShowExportToPDF` プロパティを設定することで表示/非表示にできます。 + +```js +revealView.showExportToPDF = false; +``` + +**[PDF]** メニュー項目をクリックすると、エンドユーザーにさまざまなオプションの入力を求められます。これにより、ユーザーは PDF ドキュメントのタイトルを変更したり、ドキュメントに含める表示形式、各表示形式のタイトルと説明、ブランド、ページの向き、言語を選択ができます。 + +![](images/export-pdf-options.jpg) + +## PowerPoint へエクスポート +エンドユーザーが **[エクスポート]** オーバーフロー メニューから **[PowerPoint]** メニュー項目をクリックすると、PowerPoint のエクスポートが実行されます。 + +![](images/export-powerpoint.jpg) + +**PowerPoint** メニュー項目は、`RevealView.ShowExportToPowerpoint` プロパティを設定することで表示/非表示にできます。 + +```js +revealView.showExportToPowerPoint = false; +``` + +**PowerPoint** メニュー項目をクリックすると、エンドユーザーは、PowerPoint ドキュメントのタイトルを変更したり、ドキュメントに含める表示形式、各表示形式のタイトルと説明、およびブランディングを選択したりできるさまざまなオプションが表示されます。 + +![](images/export-powerpoint-options.jpg) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/filtering-dashboards.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/filtering-dashboards.md new file mode 100644 index 00000000..55470e4f --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/filtering-dashboards.md @@ -0,0 +1,176 @@ +# ダッシュボードのフィルタリング + +フィルターはダッシュボードの上部にあり、Reveal SDK を使用して変更できます。 + +![](images/filtering-filter-location.jpg) + +フィルターには次の 2 種類があります: +- Date Filter (日付フィルター) +- ダッシュボード フィルター + +## 日付フィルター +**日付フィルター**は、データが関連付けられていないため、特別な種類のフィルターです。選択できる値のリストはありません。代わりに、日付間隔または範囲を選択します。[今日]、[すべての期間]、[前月] などの事前定義された日付間隔のリストから選択するか、独自のカスタム範囲（2019 年 1 月 12 日から 2021 年 1 月 12 日まで) を指定できます。 + +**日付フィルター**は常に最初のフィルターであり、1 つしか存在できません。 + +![](images/filtering-date-filter.jpg) + +### 日付間隔の使用 +事前定義された日付間隔のセットを使用してダッシュボードの**日付フィルター**を設定するには、`Dashboard.dateFilter` プロパティを `RVDateDashboardFilter` オブジェクトの新しいインスタンスに設定し、適切なRV `DateFilterType` 値をパラメーターとして使用する必要があります。 + +例えば, このコード スニペットは、ダッシュボードの日付フィルターを **[年度累計]** に設定します。 +```js +revealView.dashboard.dateFilter = new $.ig.RVDateDashboardFilter($.ig.RVDateFilterType.YearToDate); +``` +ここでは、ダッシュボード UI が Date Filter を **[年度累計]** に更新したことを確認できます。 + +![](images/filtering-date-filter-yeartodate.jpg) + +`RVDateFilterType` の値は次のとおりです: +- AllTime +- CustomRange +- LastMonth +- LastWeek +- LastYear +- MonthToDate +- NextMonth +- NextQuarter +- NextYear +- PreviousMonth +- PreviousQuarter +- PreviousYear +- QuarterToDate +- ThisMonth +- ThisQuarter +- ThisYear +- Today +- TrailingTwelveMonths +- YearToDate +- Yesterday + +### カスタム日付範囲の使用 +カスタムの日付範囲を設定するには、`Dashboard.dateFilter` プロパティを `RVDateDashboardFilter` オブジェクトの新しいインスタンスに設定し、`RVDateFilterType.CustomRange` 値をパラメーターとして使用し、`RVDateRange` (fromDate 引数と toDate 引数を提供する) を 2 番目のパラメーターに指定する必要があります。 + +この例では、`日付フィルター`を過去 75 日間にわたるカスタムの日付範囲に設定します。 +```js +var fromDate = new Date(); +fromDate.setDate(fromDate.getDate() - 75); +var toDate = new Date(); +var dateRange = new $.ig.RVDateRange(fromDate, toDate); + +revealView.dashboard.dateFilter = new $.ig.RVDateDashboardFilter($.ig.RVDateFilterType.CustomRange, dateRange); +``` + +ここでは、ダッシュボード UI が更新され、日付範囲が表示されるように Date Filter が更新されていることがわかります。 + +![](images/filtering-date-filter-daterange.jpg) + +:::info コードの取得 + +日付フィルターを示すサンプルは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/master/FilteringDashboards-Dates) にあります。 + +::: + +## ダッシュボード フィルター + +**ダッシュボード フィルター**は、日付フィルターが定義されている場合、日付フィルターの後に表示され、単一のダッシュボードに複数のダッシュボード フィルターを定義できます。この画像には、3 つのダッシュボード フィルター (Territory、Employee、Product) が定義されています。 + +![](images/filtering-dashboard-filters.jpg) + +ダッシュボード フィルターを使用する場合、注意する必要がある主なオブジェクトは `RVDashboardFilter` オブジェクトです。`RVDashboardFilter` オブジェクトは、ダッシュボード用に定義された個々のフィルターを表します。フィルターのタイトル、選択可能な値、現在選択されている値など、フィルターに関する情報が含まれています。 + +`RVDashboardFilter` オブジェクトには、次のプロパティとメソッドがあります: +- **id** - フィルターの一意の ID、通常は GUID。 +- **title (1)** - フィルターの名前。ダッシュボード フィルター UI のフィルターのヘッダーとしても使用されます。 +- **selectedValues (3)** -フィルター用に選択された値のコレクション。これらは、UI のフィルター ドロップダウン内のチェックボックスで表されます。 +- **getFilterValues() (2)** - フィルターで使用可能なすべてのフィルター値のコレクションを返します。これらはドロップダウン リストのオプションとして機能し、適用/選択するフィルター値を選択します。 + +![](images/filtering-filter-legend.jpg) + +### すべてのフィルターの取得 + +ダッシュボード フィルターには、`RVDashboard.filters` プロパティを使用してアクセスできます。`RVDashboard.filters` プロパティは、ダッシュボードに定義されているすべてのフィルターを返します。 +```js +var allDashboardFilters = revealView.dashboard.filters; +``` + +`RVDashboard.filters` プロパティは、`RVDashboardFilter` オブジェクトの読み取り専用コレクションを返します。 + +### 特定のフィルターの取得 +Reveal SDK は、`RVDashboard.filters` プロパティをループすることなく、特定のダッシュボード フィルターを取得するための API を提供します。代わりに、`RVDashboard.filters.getById` または `RVDashboard.filters.getByTitle` メソッドのいずれかを使用できます。 + +##### ID で取得 + +```js +var territoryFilter = revealView.dashboard.filters.getById("ddf3fa65-6893-4d8b-73ad-0b28fc1af330"); +``` + +##### Title で取得 + +```js +var territoryFilter = revealView.dashboard.filters.getByTitle("Territory"); +``` + +これらのメソッドは、特定のダッシュボード フィルターを表す `RVDashboardFilter` オブジェクトを返します。 + +### 利用可能なフィルター値の取得 + + ダッシュボード フィルターで使用可能なすべてのフィルター値のコレクションを取得するには、`RVDashboardFilter.getFilterValues()` メソッドを使用します。 +```js +var territoryFilter = revealView.dashboard.filters.getByTitle("Territory"); +territoryFilter.GetFilterValues( filterValues => { + //handle filterValues +}); +``` +`RVDashboardFilter.getFilterValues()` メソッドは、`RVFilter` オブジェクトのコレクションを返します。 + +`RVFilter` オブジェクトには、次のプロパティがあります: +- **label** - フィルター ドロップダウン UI に表示されるテキスト。 +- **value** - `RVFilter` オブジェクトの基になる値。 + +### 選択したフィルター値の取得 + +ダッシュボード フィルターに対して現在選択されているフィルター値のコレクションを取得するには、`RVDashboardFilter.selectedValues` プロパティを使用できます。 +```js +var territoryFilter = revealView.dashboard.filters.getByTitle("Territory"); +var selectedFilterValues = territoryFilter.selectedValues; +``` + +### 選択したフィルター値の設定 + +`RVDashboardFilter.selectedValues` プロパティを使用して、ダッシュボード フィルターの選択された値をプログラムで設定できます。`RVDashboardFilter.selectedValues` プロパティを`配列`の新しいインスタンスに設定するだけです。`配列`には、ダッシュボード フィルター内で選択するすべてのフィルター値が含まれている必要があります。 + +##### 単一の選択したフィルター値の設定 + +```js +var territoryFilter = revealView.dashboard.filters.getByTitle("Territory"); +territoryFilter.selectedValues = [ "Japan" ]; +``` + +##### 複数の選択したフィルターの設定 + +```js +var territoryFilter = revealView.dashboard.filters.getByTitle("Territory"); +territoryFilter.selectedValues = [ "Japan", "India" ]; +``` + +### 選択したフィルターのクリア + +特定のダッシュボード フィルターに対して選択されているフィルター値をクリアするには、`RVDashboardFilter.selectedValues` プロパティを新しい空の`配列`に設定するだけです。 + +```cs +var territoryFilter = revealView.dashboard.filters.getByTitle("Territory"); +territoryFilter.selectedValues = []; +``` + +:::info コードの取得 + +[GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/master/FilteringDashboards) でダッシュボード フィルターのデモ サンプルを見つけることができます。 + +::: + +## フィルターの非表示 +カスタム フィルター UI またはその他のカスタム フィルター操作を使用する場合、エンドユーザーがダッシュボードのフィルター処理で混乱しないように、`RevealView` でフィルターを含むパネルを非表示にすることができます。`RevealView.showFilters` プロパティを `false` に設定すると、日付とダッシュボードのフィルターを非表示にできます。 +```cs +revealView.showFilters = false; +``` diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-angular.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-angular.md new file mode 100644 index 00000000..e88fb77d --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-angular.md @@ -0,0 +1,169 @@ +# Reveal SDK for Angular で作業を開始 + +## 手順 1 - Angular アプリの作成 + +1 - お気に入りのターミナルを開きます。 + +![](images/getting-started-angular-terminal.jpg) + +2 - アプリケーションを作成します。 + +```bash +ng new getting-started +``` + +3 - ディレクトリを新しく作成した app ディレクトリに移動し、お気に入りのエディターでプロジェクトを開きます。この例では、Visual Studio Code を使用しています。 + +```bash +cd getting-started +code . +``` + +## 手順 2 - Reveal JavaScript API の追加 + +1 - `index.html` ファイルを開いて変更し、ページの下部に (`` 終了タグの直前) `infragistics.reveal.js` スクリプトを含めます。 + +```html + +``` + +2 - 残りの Reveal JavaScript API 依存関係をインストールします。 + +- Jquery 2.2 またはそれ以降 + +```html + +``` + +- Day.js 1.8.15 またはそれ以降 + +```html + +``` + +最終の `index.html` ファイルは以下のようになります。 + +```html title="index.html" + + + + + GettingStarted + + + + + + + + //highlight-start + + + + //highlight-end + + +``` + +## 手順 3 - Reveal ビューの初期化 + +1 - `src/app/app.component.html` ファイルを開いて変更します。ファイルのすべての内容を削除し、新しい `
` タグを追加して、参照を `revealView` に設定します。 + +```html +
+``` + +2 - `src/app/app.component.ts` ファイルを開いて変更します。最初に、import ステートメントの下のファイルの先頭で、タイプ `any` の `$` という名前の新しい変数を宣言することによって、jQuery を使用できることを確認する必要があります。これにより、TypeScript が JavaScript をコンパイルします。 + +```ts +declare let $: any; +``` + +次に、HTML で `ViewChild` として定義した `revalView` にアクセスします。この参照を保持するプロパティを追加します。 + +```ts title="src/app/app.component.html" +export class AppComponent { + + // highlight-next-line + @ViewChild('revealView') el!: ElementRef; + +} +``` + +コンポーネントに `AfterViewInit` インターフェイスを実装する必要があります。 + +```ts title="src/app/app.component.html" {5-7} +export class AppComponent implements AfterViewInit { + + @ViewChild('revealView') el!: ElementRef; + + ngAfterViewInit(): void { + + } + +} +``` + +それが完了したら、`RevealView` を初期化できます。 + +```ts title="src/app/app.component.html" +export class AppComponent implements AfterViewInit { + + @ViewChild('revealView') el!: ElementRef; + + ngAfterViewInit(): void { + // highlight-next-line + var revealView = new $.ig.RevealView(this.el.nativeElement); + } + +} +``` + +次に、新しい `$.ig.RevealView` を作成し、`ViewChild` プロパティに保存されている `revealView` 要素を渡すことで、`RevealView` の新しいインスタンスを作成します。 + +最終の `app.component.ts` ファイルは以下のようになります。 + +```ts title="src/app/app.component.html" +import { AfterViewInit, Component, ElementRef, ViewChild } from '@angular/core'; + +declare let $: any; + +@Component({ + selector: 'app-root', + templateUrl: './app.component.html', + styleUrls: ['./app.component.scss'] +}) +export class AppComponent implements AfterViewInit { + + @ViewChild('revealView') el!: ElementRef; + + ngAfterViewInit(): void { + var revealView = new $.ig.RevealView(this.el.nativeElement); + } + +} +``` + +:::caution + +クライアント アプリは、クライアントが別の URL でホストしている場合、`$.ig.RevealSdkSettings.setBaseUrl("url-to-server");` をダッシュボードをホストしているサーバー アドレスに設定する必要があります。 + +::: + +## 手順 4 - アプリケーションの実行 + +Visual Studio Code ターミナルで、`npm start` コマンドを入力します。 + +```bash npm2yarn +npm start +``` + +![](images/angular-app-running.jpg) + +完了しました! 最初の Reveal SDK Angular アプリケーションを作成しました。 + +:::info コードの取得 + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/01-GettingStarted/client/angular) にあります。 + +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-aspnet.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-aspnet.md new file mode 100644 index 00000000..8934a893 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-aspnet.md @@ -0,0 +1,175 @@ +# Reveal SDK for ASP.NET で作業を開始 + +## 手順 1 - 手順新しい ASP.NET Web アプリの作成 + +以下の手順では、新しい ASP.NET Core Web App プロジェクトを作成する方法を説明します。既存のアプリケーションに Reveal SDK を追加する場合は、手順 2 へ移動します。 + +1 - Visual Studio を起動し、スタート ページで **[新しいプロジェクトの作成]** をクリックします。**ASP.NET Core Web App** テンプレートを選択し、**[次へ]** をクリックします。 + +![](images/getting-started-new-asp-net-core-web-app-project.jpg) + +2 - プロジェクト名と説明と場所を入力し、**[次へ]** をクリックします。 + +![](images/getting-started-new-asp-net-core-web-app-name.jpg) + +3 - フレームワーク、認証タイプ、Docker オプションを選択し、**[作成]** をクリックします。 + +![](images/getting-started-new-asp-net-core-web-app-info.jpg) + +## 手順 2 - Reveal SDK の追加 + +1 - ソリューションまたはプロジェクトを右クリックし、**[ソリューションの NuGet パッケージの管理]** を選択します。 + +![](images/getting-started-nuget-packages-manage.jpg) + +2 - パッケージ マネージャー ダイアログで **[参照]** タブを開き、**Infragistics (Local)** パッケージ ソースを選択して **Reveal.Sdk.AspNetCore** NuGet パッケージをプロジェクトにインストールします。 + +![](images/getting-started-nuget-packages-install.jpg) + +3 - `Program.cs` ファイルを開き、`using Reveal.Sdk` 名前空間を追加します。次に、以下のように `IMcvBuilder.AddReveal()` への呼び出しを追加します。 + +```cs +using Reveal.Sdk; + +builder.Services.AddRazorPages().AddReveal(); +``` + +## 手順 3 - Reveal JavaScript API の追加 + +1 - `Pages/Shared/_Layout.cshtml` ファイルを開いて変更し、ページの下部に (`` 終了タグの直前、`jquery.min.js` スクリプトの後) `infragistics.reveal.js` スクリプトを含めます。 + +```html + +``` + +2 - 残りの Reveal JavaScript API 依存関係をインストールします。 + +- Jquery 2.2 またはそれ以降 + +```html + +``` + +- Day.js 1.8.15 またはそれ以降 + +```html + +``` + +最終の `_Layout.cshtml` ファイルは以下のようになります。 + +```html title="Pages/Shared/_Layout.cshtml" + + + + + + @ViewData["Title"] - GettingStarted + + + + + +
+ +
+
+
+ @RenderBody() +
+
+ +
+
+ © 2022 - GettingStarted - Privacy +
+
+ + // highlight-next-line + + + + + // highlight-start + + + // highlight-end + + @await RenderSectionAsync("Scripts", required: false) + + +``` + +## 手順 4 - Reveal ビューの初期化 + +1 - `Pages/Index.cshtml` ファイルを開いて変更し、新しい `
` タグを追加して、`id` を `revealView` に設定します。 + +```html +
+``` + +2 - `Index.cshtml` ファイルの最後に `Scripts` セクションを追加し、`revealView` を初期化します。 + +```html +@section Scripts +{ + +} +``` + +次に、新しい `$.ig.RevealView` を作成し、`#revealView` セレクターを渡すことで、`RevealView` の新しいインスタンスを作成します。 + +最終の `Index.cshtml` ファイルは以下のようになります。 + +```html +@page +@model IndexModel +@{ + ViewData["Title"] = "Home page"; +} + +// highlight-next-line +
+ +@section Scripts +{ + +} +``` +## 手順 5 - アプリケーションの実行 + +**[F5]** を押してアプリケーションを実行します。 + +![](images/asp-net-core-web-app-running.jpg) + +完了しました! 最初の Reveal SDK アプリケーションを作成しました。 + +:::info コードの取得 + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/01-GettingStarted/client/aspnet-webapp) にあります。 + +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-javascript.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-javascript.md new file mode 100644 index 00000000..0e8e8abf --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-javascript.md @@ -0,0 +1,130 @@ +# Reveal SDK for HTML/JavaScript で作業を開始 + +## 手順 1 - HTML ファイルの作成 + +1 - お気に入りのコード エディターを開き、新しい HTML ファイルを作成し、`index.html` という名前でファイルを保存します。 + +```html title="index.html" + + + + + + + Reveal Sdk - HTML/JavaScript + + + + + +``` + +## 手順 2 - Reveal JavaScript API の追加 + +1 - `index.html` ファイルを変更し、ページの下部に (`` 終了タグの直前) `infragistics.reveal.js` スクリプトを含めます。 + +```html + +``` + +2 - 残りの Reveal JavaScript API 依存関係をインストールします。 + +- Jquery 2.2 またはそれ以降 + +```html + +``` + +- Day.js 1.8.15 またはそれ以降 + +```html + +``` + +最終の `index.html` ファイルは以下のようになります。 + +```html title="index.html" + + + + + + + Reveal Sdk - HTML/JavaScript + + + + // highlight-start + + + + // highlight-end + + +``` + +## 手順 3 - Reveal ビューの初期化 + +1 - `index.html` ファイルを変更し、開始 `` タグの後に新しい `
` タグを追加して、`id` を `revealView` に設定します。 + +```html +
+``` + +2 - `index.html` ファイルの最後に JavaScript の `Script` タグを追加し、`revealView` を初期化します。 + +```html + +``` + +次に、新しい `$.ig.RevealView` を作成し、`#revealView` セレクターを渡すことで、`RevealView` の新しいインスタンスを作成します。 + +最終の `index.html` ファイルは以下のようになります。 + +```html title="index.html" + + + + + + + Reveal Sdk - HTML/JavaScript + + + //highlight-start +
+ + + + + + + //highlight-end + + +``` + +:::caution + +クライアント アプリは、クライアントが別の URL でホストしている場合、`$.ig.RevealSdkSettings.setBaseUrl("url-to-server");` をダッシュボードをホストしているサーバー アドレスに設定する必要があります。 + +::: + +## 手順 4 - アプリケーションの実行 + +`index.html` ファイルをダブルクリックしてデフォルトのブラウザーで Web ページを起動します。 + +![](images/angular-app-running.jpg) + +完了しました! 最初の Reveal SDK アプリケーションを作成しました。 + +:::info コードの取得 + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/01-GettingStarted/client/html) にあります。 + +::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-react.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-react.md new file mode 100644 index 00000000..f13f9acb --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-react.md @@ -0,0 +1,174 @@ +# Reveal SDK for React で作業を開始 + +## 手順 1 - React アプリの作成 + +1 - お気に入りのターミナルを開きます。 + +![](images/getting-started-angular-terminal.jpg) + +2 - 「create-react-app」コマンドを使用して新しい React アプリケーションを作成します。 + +```bash +npx create-react-app getting-started --template typescript +``` + +3 - ディレクトリを新しく作成した app ディレクトリに移動し、お気に入りのエディターでプロジェクトを開きます。この例では、Visual Studio Code を使用しています。 + +```bash +cd getting-started +code . +``` + +## 手順 2 - Reveal JavaScript API の追加 + +1 - `public/index.html` ファイルを開いて変更し、ページの下部に (`` 終了タグの直前) `infragistics.reveal.js` スクリプトを含めます。 + +```html + +``` + +2 - 残りの Reveal JavaScript API 依存関係をインストールします。 + +- Jquery 2.2 またはそれ以降 + +```html + +``` + +- Day.js 1.8.15 またはそれ以降 + +```html + +``` + +最終の `index.html` ファイルは以下のようになります。 + +```html title="index.html" + + + + + + + + + + + + + React App + + + +
+ + //highlight-start + + + + //highlight-end + + +``` + +## 手順 3 - Reveal ビューの初期化 + +1 - `src/app.tsx` ファイルを開いて変更します。`return` ステートメント内のすべてのコンテンツを削除し、新しい `
` タグを追加し、`id` を `revealView` に設定します。 + +```ts title="src/app.tsx" +function App() { + return ( + //highlight-next-line +
+ ); +} +``` + +2 - 最初に、import ステートメントの下のファイルの先頭で、タイプ `any` の `$` という名前の新しい変数を宣言することによって、jQuery を使用できることを確認する必要があります。これにより、TypeScript が JavaScript をコンパイルします。 + +```ts +declare let $: any; +``` + +3 - `App()` 関数コンポーネント内で、`revealView` を初期化します。 + +```ts +useEffect(() => { + //highlight-next-line + var revealView = new $.ig.RevealView("#revealView"); +}, []) +``` + +この JavaScript コードは、`useEffect` フックを使用して、コードが一度だけ呼び出されるようにします。次に、新しい `$.ig.RevealView` を作成し、`#revealView` セレクターを渡すことで、`RevealView` の新しいインスタンスを作成します。 + +最終の `app.tsx` ファイルは以下のようになります。 + +```ts title="src/app.tsx" +import React, { useEffect } from 'react'; +import './App.css'; + +//highlight-next-line +declare let $: any; + +function App() { + + useEffect(() => { + //highlight-next-line + var revealView = new $.ig.RevealView("#revealView"); + }, []) + + return ( + //highlight-next-line +
+ ); +} + +export default App; +``` + +:::caution + +クライアント アプリは、クライアントが別の URL でホストしている場合、`$.ig.RevealSdkSettings.setBaseUrl("url-to-server");` をダッシュボードをホストしているサーバー アドレスに設定する必要があります。 + +::: + +## 手順 4 - アプリケーションの実行 + +Visual Studio Code ターミナルで、`npm start` コマンドを入力します。 + +```bash npm2yarn +npm start +``` + +![](images/angular-app-running.jpg) + +完了しました! 最初の Reveal SDK React アプリケーションを作成しました。 + +:::info コードの取得 + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/01-GettingStarted/client/react) にあります。 + +::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-server-nest.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-server-nest.md new file mode 100644 index 00000000..fbe13605 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-server-nest.md @@ -0,0 +1,106 @@ +# NestJS を使用した Reveal SDK サーバーの設定 + + +# NestJS を使用した Reveal SDK の設定 + +このガイドでは、Reveal SDK を [**NestJS**](https://nestjs.com/) プロジェクトに統合する手順を説明します。以下の手順に従って、NestJS サーバーに強力なデータ分析機能を追加します。 + +## 手順 1 - NestJS プロジェクトの作成 + +1. まず、まだインストールしていない場合は、NestJS CLI をグローバルにインストールします。 + +```bash +npm install -g @nestjs/cli +``` + +2. 以下のコマンドを実行して、新しいプロジェクトを作成します。 + +```bash +nest new reveal-nest-server +``` + +3. コマンドライン パスを新しく作成したプロジェクト ディレクトリに変更します。 + +```bash +cd reveal-nest-server +``` + +## 手順 2 - Reveal SDK のインストール + +1. NestJS プロジェクト ディレクトリ内に、Node.js 用の Reveal SDK をインストールします。 + +```bash npm2yarn +npm install reveal-sdk-node +``` + +## 手順 3 - `main.ts` ファイルの変更 + +Reveal SDK を統合するには、`main.ts` ファイルを直接変更し、CORS を有効にして Reveal SDK ルートを追加します。 + +1. `src/main.ts` ファイルを開きます。 + +2. `bootstrap` 関数を更新して、Reveal SDK を構成します。 + +```ts title="src/main.ts" +import { NestFactory } from '@nestjs/core'; +import { AppModule } from './app.module'; +// highlight-next-line +import reveal from 'reveal-sdk-node'; + +async function bootstrap() { + const app = await NestFactory.create(AppModule); + + // highlight-next-line + app.enableCors(); // DEVELOPMENT only! In production, configure appropriately. + + // highlight-next-line + app.use("/", reveal()); + + // Start the server + await app.listen(process.env.PORT ?? 5111); + console.log(`Reveal SDK server running on http://localhost:${process.env.PORT ?? 5111}`); +} +bootstrap(); +``` + +この設定により、Reveal SDK が `/` の下のルートを処理するように構成されます。CORS ポリシーもグローバルに有効化され、他のオリジンからのリクエストを許可します。 + +:::note + +tsconfig.json ファイルで `"esModuleInterop": true,` を設定する必要がある場合があります。 + +::: + +## 手順 4 - ダッシュボード フォルダーの作成 + +Reveal SDK では、ダッシュボード ファイルが作業ディレクトリ内の **dashboards** という名前のフォルダーに保存されることを想定しています。 + +1. プロジェクトのルート ディレクトリに、`dashboards` という名前のフォルダーを作成します。 + +```bash +mkdir dashboards +``` + +このフォルダーに任意の Reveal ダッシュボードを保存でき、サーバー経由でアクセスできるようになります。この動作を変更する必要がある場合は、カスタム `IRVDashboardProvider` を作成できます。 + +## 手順 5 - NestJS サーバーの起動 + +1. 以下のコマンドを実行して NestJS サーバーを起動します。 + +```bash +npm run start +``` + +あるいは、開発モードの場合は、ライブリロードを有効にしてサーバーを実行します。 + +```bash +npm run start:dev +``` + +これで、NestJS サーバーが実行され、Reveal SDK は `http://localhost:5111/` でリクエストを処理する準備が整いました。 + +:::info Get The Code + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/01-GettingStarted/server/nest) にあります。 + +::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-server-node-typescript.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-server-node-typescript.md new file mode 100644 index 00000000..8127e193 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-server-node-typescript.md @@ -0,0 +1,161 @@ +# Node.js と TypeScript を使用して Reveal SDK サーバーをセットアップする + +## 手順 1 - Node.js プロジェクトの作成 + +1 - コマンドラインを開き、**reveal-server-node** という名前のディレクトリを作成します。 + +```bash +mkdir reveal-server-node +``` + +2 - コマンドライン パスを新しく作成したディレクトリに変更します。 + +```bash +cd reveal-server-node +``` + +3 - ディレクトリで **npm** を初期化します。 + +```bash npm2yarn +npm init -y +``` + +4 - **express** フレームワークをインストールします。 + +```bash npm2yarn +npm install express +``` + +5 - **TypeScript** およびその他のパッケージ タイプをインストールします。 + +```bash npm2yarn +npm install typescript @types/node @types/express @types/cors --save-dev +``` + +6 - **Nodemon** および **ts-node** パッケージをインストールします。 + +```bash npm2yarn +npm install nodemon ts-node --save-dev +``` + +7 - **TypeScript** を構成します。この例では、ルート ディレクトリを「src」に、出力ディレクトリを「dist」に設定しています。 + +```bash +npx tsc --init --rootDir src --outDir dist +``` + +8 - **VS Code** でプロジェクトを開きます。 + +```bash +code . +``` + +9 - **src** というディレクトリに **app.ts** という名前の新しいファイルを作成します。 + +![](images/getting-started-server-node-typescript-create-app-file.jpg) + +次のコードを追加します: + +```js +import express, { Application } from 'express'; + +const app: Application = express(); + +app.listen(5111, () => { + console.log(`Reveal server accepting http requests`); +}); +``` + +## 手順 2 - Reveal SDK の追加 + +1 - Node.js 用の **Reveal SDK** をインストールします。 + +```bash npm2yarn +npm install reveal-sdk-node +``` + +2 - `app.ts` ファイルを変更して Reveal を追加します。 + +```js title="app.ts" +import express, { Application } from 'express'; +// highlight-next-line +import reveal from 'reveal-sdk-node'; + +const app: Application = express(); + +// highlight-next-line +app.use("/", reveal()); + +app.listen(5111, () => { + console.log(`Reveal server accepting http requests`); +}); +``` + +## 手順 3 - ダッシュボード フォルダーの作成 + +1 - Visual Studio Code で、エクスプローラーの **[新しいフォルダー]** ボタンをクリックし、**dashboards** という名前を付けます。フォルダーは **dashboards** という名前で、アプリケーションの作業ディレクトリに作成する必要があります。 + +![](images/getting-started-server-node-typescript-create-dashboards-folder.jpg) + +デフォルトで、Reveal SDK は **dashboards** フォルダーからすべてのダッシュボードを読み込む規則を使用します。この規則を変更でするにはカスタムの `IRVDashboardProvider` を作成します。 + +## 手順 4 - CORS ポリシー (デバッグ) の設定 + +アプリケーションの開発とデバッグでは、サーバーとクライアント アプリを異なる URL でホストするのが一般的です。たとえば、サーバーは `https://localhost:24519` で実行されますが、Angular アプリは `https://localhost:4200` で実行されます。クライアント アプリケーションからダッシュボードを読み込もうとすると、Cross-Origin Resource Sharing (CORS) ポリシーが原因で失敗します。このシナリオを有効にするには、CORS ポリシーを作成し、サーバー プロジェクトで有効にする必要があります。 + +1 - **cors** パッケージと TypeScript 型をインストールします。 + +```bash npm2yarn +npm install cors +npm install @types/cors --save-dev +``` + +2 - `app.ts` ファイルを変更して **cors** を有効にします。 + +```js title="app.ts" +import express, { Application } from 'express'; +import reveal from 'reveal-sdk-node'; +// highlight-next-line +import cors from "cors"; + +const app: Application = express(); + +// highlight-next-line +app.use(cors()); + +app.use("/", reveal()); + +app.listen(5111, () => { + console.log(`Reveal server accepting http requests`); +}); +``` + +## 手順 5 - Node.js サーバーの起動 + +最後の手順は、次のコマンドを実行して Node.js サーバーを起動することです。 + +```bash +npx nodemon src/app.ts +``` + +必要に応じて、次のスクリプトを `package.json` ファイルに追加できます。 + +```json title="package.json" +"scripts": { + "start": "node dist/app.js", //runs the app.js file in the dist folder that was generated from the build script + "dev": "npx nodemon src/app.ts", //runs the server and watches for changes during development + "build": "tsc -p .", //builds the app and generates javascript files in the dist folder +}, +``` + +次に、開発中に **dev** スクリプトを実行します。 + +```bash npm2yarn +npm run dev +``` + +:::info コードの取得 + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/01-GettingStarted/server/nodejs-ts) にあります。 + +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-server-node.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-server-node.md new file mode 100644 index 00000000..ac18edce --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-server-node.md @@ -0,0 +1,121 @@ +# Node.js を使用した Reveal SDK サーバーの設定 + +## 手順 1 - Node.js プロジェクトの作成 + +1 - コマンドラインを開き、**reveal-server-node** という名前のディレクトリを作成します。 + +```bash +mkdir reveal-server-node +``` + +2 - コマンドライン パスを新しく作成したディレクトリに変更します。 + +```bash +cd reveal-server-node +``` + +3 - ディレクトリで **npm** を初期化します。 + +```bash npm2yarn +npm init -y +``` + +4 - **express** フレームワークをインストールします。 + +```bash npm2yarn +npm install express +``` + +5 - **VS Code** でプロジェクトを開きます。 + +```bash +code . +``` + +6 - **main.js** という名前の新しいファイルを作成し、次のコードを追加します: + +```js title="main.js" +var express = require('express'); + +const app = express(); + +app.listen(8080, () => { + console.log(`Reveal server accepting http requests`); +}); +``` + +## 手順 2 - Reveal SDK の追加 + +1 - Node.js 用の **Reveal SDK** をインストールします。 + +```bash npm2yarn +npm install reveal-sdk-node +``` + +2 - `main.js` ファイルを変更して Reveal を追加します。 + +```js +var express = require('express'); +// highlight-next-line +var reveal = require('reveal-sdk-node'); + +const app = express(); + +// highlight-next-line +app.use('/', reveal()); + +app.listen(8080, () => { + console.log(`Reveal server accepting http requests`); +}); +``` + +## 手順 3 - ダッシュボード フォルダーの作成 + +1 - Visual Studio Code で、エクスプローラーの [**新しいフォルダー**] ボタンをクリックし、**dashboards** という名前を付けます。フォルダーの名前は **dashboards** にしてください。 + +![](images/getting-started-server-node-create-dashboards-folder.jpg) + +デフォルトで、Reveal SDK は **dashboards** フォルダーからすべてのダッシュボードを読み込む規則を使用します。この規則を変更でするにはカスタムの `IRVDashboardProvider` を作成します。 + +## 手順 4 - CORS ポリシー (デバッグ) の設定 + +アプリケーションの開発とデバッグでは、サーバーとクライアント アプリを異なる URL でホストするのが一般的です。たとえば、サーバーは `https://localhost:24519` で実行されますが、Angular アプリは `https://localhost:4200` で実行されます。クライアント アプリケーションからダッシュボードを読み込もうとすると、Cross-Origin Resource Sharing (CORS) ポリシーが原因で失敗します。このシナリオを有効にするには、CORS ポリシーを作成し、サーバー プロジェクトで有効にする必要があります。 + +1 - **cors** パッケージをインストールします。 + +```bash npm2yarn +npm install cors +``` + +2 - `main.js` ファイルを変更して **cors** を有効にします。 + +```js title="main.js" +var express = require('express'); +var cors = require('cors'); +var reveal = require('reveal-sdk-node'); + +const app = express(); + +//highlight-next-line +app.use(cors()); // DEVELOPMENT only! In production, configure appropriately. + +app.use('/', reveal()); + +app.listen(8080, () => { + console.log(`Reveal server accepting http requests`); +}); +``` + +## 手順 5 - Node.js サーバーの起動 + +最後の手順は、次のコマンドを実行して Node.js サーバーを起動することです。 + +```bash +node main.js +``` + +:::info コードの取得 + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/01-GettingStarted/server/nodejs-js) にあります。 + +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-server.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-server.md new file mode 100644 index 00000000..e2f3f951 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-server.md @@ -0,0 +1,82 @@ +# Reveal SDK Server の設定 + +## 手順 1 - 手順新しい ASP.NET Core Web API の作成 + +以下の手順では、新しい ASP.NET Core Web API プロジェクトを作成する方法を説明します。既存のアプリケーションに Reveal SDK を追加する場合は、手順 2 へ移動します。 + +1 - Visual Studio を起動し、スタート ページで **[新しいプロジェクトの作成]** をクリックします。**[ASP.NET Core Web API]** テンプレートを選択し、**[次へ]** をクリックします。 + +![](images/getting-started-angular-project.jpg) + +2 - プロジェクト名を入力し、場所を先ほど作成した **server** ディレクトリに設定して、**[次へ]** をクリックします。 + +![](images/getting-started-angular-name.jpg) + +3 - フレームワーク、認証タイプ、Docker オプションを選択し、**[作成]** をクリックします。 + +![](images/getting-started-angular-info.jpg) + +## 手順 2 - Reveal SDK の追加 + +1 - ソリューションまたはプロジェクトを右クリックし、**[ソリューションの NuGet パッケージの管理]** を選択します。 + +![](images/getting-started-nuget-packages-manage.jpg) + +2 - パッケージ マネージャー ダイアログで **[参照]** タブを開き、**Infragistics (Local)** パッケージ ソースを選択して **Reveal.Sdk.AspNetCore** NuGet パッケージをプロジェクトにインストールします。 + +![](images/getting-started-nuget-packages-install.jpg) + +:::info + +トライアル版をお使いの場合、[NuGet.org](https://www.nuget.org/packages/Reveal.Sdk.Web.AspNetCore.Trial/) にある **Reveal.Sdk.Web.AspNetCore.Trial** NuGet パッケージをインストールできます。 + +::: + +3 - `Program.cs` ファイルを開き、`using Reveal.Sdk;` 名前空間を追加します。次に、既存の `builder.Services.AddControllers()` メソッドに `IMcvBuilder.AddReveal()` の呼び出しを追加します。 + +```cs +using Reveal.Sdk; + +builder.Services.AddControllers().AddReveal(); +``` + +## 手順 3 - ダッシュボード フォルダーの作成 + +1 - プロジェクトを右クリックし、**[追加] -> [新しいフォルダー]** を選択します。フォルダーの名前は **「Dashboards」** にしてください。 + +![](images/setting-up-server-create-dashboards-folder.jpg) + +デフォルトで、Reveal SDK は **Dashboards** フォルダーからすべてのダッシュボードを読み込む規則を使用します。この規則を変更するにはカスタムの `IRVDashboardProvider` を作成します。詳細については、[ダッシュボードの読み込み](loading-dashboards.md)トピックを参照してください。 + + +## 手順 4 - CORs ポリシー (デバッグ) の設定 + +アプリケーションの開発とデバッグでは、サーバーとクライアント アプリを異なる URL でホストするのが一般的です。たとえば、サーバーは `https://localhost:24519` で実行されますが、Angular アプリは `https://localhost:4200` で実行されます。クライアント アプリケーションからダッシュボードを読み込もうとすると、ASP.NET Core の Cross-Origin Requests (CORs) セキュリティ ポリシーが原因で失敗します。このシナリオを有効にするには、CORs ポリシーを作成し、サーバー プロジェクトで有効にする必要があります。 + +1 - `Program.cs` ファイルを開いて変更し、任意のヘッダーとメソッドへの任意のオリジン (URL) アクセスを許可する CORs ポリシーを作成します。 + +```cs +builder.Services.AddCors(options => +{ + options.AddPolicy("AllowAll", + builder => builder.AllowAnyOrigin().AllowAnyHeader().AllowAnyMethod() + ); +}); +``` + +2 - ポリシーはデバッグ モードでのみ適用します。プロダクション アプリケーションがある場合、プロダクション ビルドに適切なポリシーを適用します。 + +```cs +if (app.Environment.IsDevelopment()) +{ + app.UseCors("AllowAll"); +} +``` + +ミドルウェアが実行される順序を理解することが重要です。`UseCors` は特定の順序で呼び出す必要があります。この例では、`UseHttpsRedirection()` の後と `UseAuthorization()` の前にあります。詳細については、[この Microsoft ヘルプ トピック](https://docs.microsoft.com/ja-jp/aspnet/core/security/cors?view=aspnetcore-6.0)を参照してください。 + +:::info コードの取得 + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/01-GettingStarted/server/aspnet) にあります。 + +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-spring-boot-jersey.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-spring-boot-jersey.md new file mode 100644 index 00000000..698e79d6 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/getting-started-spring-boot-jersey.md @@ -0,0 +1,270 @@ +# Spring Boot と Jersey を使用した Reveal SDK サーバーのセットアップ + +## 手順 1 - Jersey プロジェクトで Spring Boot を作成する + +以下の手順では、Jersey プロジェクトを使用して新しい Java Spring Boot を作成する方法について説明します。既存のアプリケーションに Reveal SDK を追加する場合は、手順 2 へ移動します。 + +Visual Studio Code で Spring Boot アプリケーションを開発するには、以下をインストールする必要があります: +- [開発キット (JDK)](https://www.microsoft.com/openjdk) +- [Java 用拡張パック](https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-pack) +- [Spring Boot 拡張パック](https://marketplace.visualstudio.com/items?itemName=pivotal.vscode-boot-dev-pack) + +Visual Studio Code と Java の使用を開始する方法の詳細については、[Java の使用を開始する](https://code.visualstudio.com/docs/java/java-tutorial)チュートリアルを参照してください。 + +1 - Visual Studio Code を起動し、コマンド パレットを開いて **>Spring Initializr: Create a Maven Project** と入力し、**Enter** を押します。 + +![](images/getting-started-spring-boot-jersey-project.jpg) + +2 - Spring Boot バージョン **3.3.2** を選択します。 + +![](images/getting-started-spring-boot-jersey-version.jpg) + +:::caution + +バージョン 2.x は Reveal 1.7.x 以降、サポートされていません。 + +::: + +3 - 言語として **Java** を選択します。 + +![](images/getting-started-spring-boot-jersey-language.jpg) + +4 - グループ ID を提供します。この例では、**com.server** を使用しています。 + +![](images/getting-started-spring-boot-jersey-group-id.jpg) + +5 - 成果物 ID を提供します。この例では、**reveal** を使用しています。 + +![](images/getting-started-spring-boot-jersey-artifact-id.jpg) + +6 - **War** パッケージ タイプを選択します。 + +![](images/getting-started-spring-boot-jersey-package-type.jpg) + +7 - Java のバージョンを選択します。Spring Boot 3.x を使用する場合、**17** 以降が必要です。 + +![](images/getting-started-spring-boot-jersey-java-version.jpg) + +8 - **Spring Web** と **Jersey** の依存関係を選択します。 + +![](images/getting-started-spring-boot-jersey-dependencies.jpg) + +9 - 新しく作成したプロジェクトを保存して開きます。 + +![](images/getting-started-spring-boot-jersey-explorer.jpg) + +## 手順 2 - Reveal SDK の追加 + +1 - **pom.xml** ファイルを更新します。 + +まず、Reveal Maven リポジトリを追加します。 + +```xml title="pom.xml" + + + reveal.public + https://maven.revealbi.io/repository/public + + +``` + +次に、Reveal SDK を依存関係として追加します。 + +```xml title="pom.xml" + + com.infragistics.reveal.sdk + reveal-sdk + [var:sdkVersion] + +``` + +2 - Jersey Config クラスを作成し、`RevealEngineInitializer.initialize` メソッドを呼び出して Reveal SDK を初期化します。Reveal SDK が Jersey で適切に機能するには、すべての Reveal SDK クラスを Jersey に登録する必要があります。Reveal SDK クラスを登録するには、`RevealEngineInitializer.getClassesToRegister` メソッドによって返されたクラスをループして、Jersey Config に登録します。 + +```java title="RevealJerseyConfig.java" +import org.glassfish.jersey.server.ResourceConfig; +import org.springframework.stereotype.Component; + +import com.infragistics.reveal.engine.init.InitializeParameterBuilder; +import com.infragistics.reveal.engine.init.RevealEngineInitializer; + +import javax.ws.rs.ApplicationPath; + +@Component +@ApplicationPath("/") +public class RevealJerseyConfig extends ResourceConfig +{ + public RevealJerseyConfig() + { + RevealEngineInitializer.initialize(); + + //register all Reveal classes in JAX-RS context + for (Class clazz : RevealEngineInitializer.getClassesToRegister()) { + register(clazz); + } + } +} +``` + +## 手順 3 - ダッシュボード プロバイダーの作成 + +1 - Visual Studio Code で **resources** フォルダーを選択し、エクスプローラーで [新しいフォルダー] ボタンをクリックします。新しいフォルダーに **dashboards** という名前を付けます。 + +![](images/getting-started-spring-boot-jersey-dashboards-folder.jpg) + +2 - 次に、新しく作成された **dashboards** フォルダーから Reveal ダッシュボードを読み込むダッシュボード プロバイダーを作成します。 + +```java title="RevealDashboardProvider.java" +import com.infragistics.reveal.sdk.api.IRVUserContext; + +import java.io.IOException; +import java.io.InputStream; + +import com.infragistics.reveal.sdk.api.IRVDashboardProvider; + +public class RevealDashboardProvider implements IRVDashboardProvider { + + @Override + public InputStream getDashboard(IRVUserContext userContext, String dashboardId) throws IOException { + InputStream dashboardStream = getClass().getResourceAsStream("/dashboards/" + dashboardId + ".rdash"); + return dashboardStream; + } + + @Override + public void saveDashboard(IRVUserContext arg0, String arg1, InputStream arg2) throws IOException { + + } +} +``` + +3 - 最後に、`RevealJerseyConfig` クラスの `RevealEngineInitializer` を使用してダッシュボード プロバイダーを登録します。 + +```java title="RevealJerseyConfig.java" +@Component +@ApplicationPath("/") +public class RevealJerseyConfig extends ResourceConfig +{ + public RevealJerseyConfig() + { + RevealEngineInitializer.initialize(new InitializeParameterBuilder() + // highlight-next-line + .setDashboardProvider(new RevealDashboardProvider()) + .build()); + + //register all Reveal classes in JAX-RS context + for (Class clazz : RevealEngineInitializer.getClassesToRegister()) { + register(clazz); + } + } +} +``` + +## 手順 4 - CORs ポリシー (デバッグ) の設定 + +アプリケーションの開発とデバッグでは、サーバーとクライアント アプリを異なる URL でホストするのが一般的です。例えば、サーバーは `https://localhost:24519` で実行されている可能性がありますが、Angular アプリは `https://localhost:4200` で実行されている可能性があります。クライアント アプリケーションからダッシュボードを読み込もうとすると、Cross-Origin Resource Sharing (CORS) ポリシーが原因で失敗します。このシナリオを有効にするには、CORS ポリシーを作成し、サーバー プロジェクトで有効にする必要があります。 + +1 - CorsFilter を作成します。 + +```java title="CorsFilter.java" +import java.io.IOException; + +import jakarta.ws.rs.container.ContainerRequestContext; +import jakarta.ws.rs.container.ContainerRequestFilter; +import jakarta.ws.rs.container.ContainerResponseContext; +import jakarta.ws.rs.container.ContainerResponseFilter; +import jakarta.ws.rs.container.PreMatching; +import jakarta.ws.rs.core.Response; + +@PreMatching +public class CorsFilter implements ContainerRequestFilter, ContainerResponseFilter { + + /** + * Method for ContainerRequestFilter. + */ + @Override + public void filter(ContainerRequestContext request) throws IOException { + + // If it's a preflight request, we abort the request with + // a 200 status, and the CORS headers are added in the + // response filter method below. + if (isPreflightRequest(request)) { + request.abortWith(Response.ok().build()); + return; + } + } + + /** + * A preflight request is an OPTIONS request + * with an Origin header. + */ + private static boolean isPreflightRequest(ContainerRequestContext request) { + return request.getHeaderString("Origin") != null + && request.getMethod().equalsIgnoreCase("OPTIONS"); + } + + /** + * Method for ContainerResponseFilter. + */ + @Override + public void filter(ContainerRequestContext request, ContainerResponseContext response) + throws IOException { + + // if there is no Origin header, then it is not a + // cross origin request. We don't do anything. + if (request.getHeaderString("Origin") == null) { + return; + } + + + // If it is a preflight request, then we add all + // the CORS headers here. + if (isPreflightRequest(request)) { + response.getHeaders().add("Access-Control-Allow-Credentials", "true"); + response.getHeaders().add("Access-Control-Allow-Methods", + "GET, POST, PUT, DELETE, OPTIONS, HEAD"); + response.getHeaders().add("Access-Control-Allow-Headers", + // Whatever other non-standard/safe headers (see list above) + // you want the client to be able to send to the server, + // put it in this list. And remove the ones you don't want. + "X-Requested-With, Authorization, " + + "Accept-Version, Content-MD5, CSRF-Token, Content-Type"); + } + + // Cross origin requests can be either simple requests + // or preflight request. We need to add this header + // to both type of requests. Only preflight requests + // need the previously added headers. + response.getHeaders().add("Access-Control-Allow-Origin", "*"); + } +} +``` + +2 - `RevealJerseyConfig` クラスに `CorsFilter` を登録します。 + +```java title="RevealJerseyConfig.java" +@Component +@ApplicationPath("/") +public class RevealJerseyConfig extends ResourceConfig +{ + public RevealJerseyConfig() + { + RevealEngineInitializer.initialize(new InitializeParameterBuilder() + .setDashboardProvider(new RevealDashboardProvider()) + .build()); + + //register all Reveal classes in JAX-RS context + for (Class clazz : RevealEngineInitializer.getClassesToRegister()) { + register(clazz); + } + + //register the cors filter for debugging + // highlight-next-line + register(CorsFilter.class); + } +} +``` + +:::info コードの取得 + +このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/01-GettingStarted/server/spring-boot-jersey) にあります。 + +::: \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/adding-custom-menu-item.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/adding-custom-menu-item.jpg new file mode 100644 index 00000000..2cadb811 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/adding-custom-menu-item.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/angular-app-running.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/angular-app-running.jpg new file mode 100644 index 00000000..399e3941 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/angular-app-running.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/asp-net-core-web-app-running.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/asp-net-core-web-app-running.jpg new file mode 100644 index 00000000..24ac47f2 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/asp-net-core-web-app-running.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/cache-disable.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/cache-disable.jpg new file mode 100644 index 00000000..7d87665c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/cache-disable.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/cache-frequency.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/cache-frequency.jpg new file mode 100644 index 00000000..4834e89d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/cache-frequency.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/cache-refresh.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/cache-refresh.jpg new file mode 100644 index 00000000..a52dc1fe Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/cache-refresh.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/chart-types.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/chart-types.jpg new file mode 100644 index 00000000..4640ca48 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/chart-types.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/creating-dashboards.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/creating-dashboards.jpg new file mode 100644 index 00000000..399e3941 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/creating-dashboards.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/custom-visualizations-data.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/custom-visualizations-data.jpg new file mode 100644 index 00000000..08ec49e0 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/custom-visualizations-data.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/custom-visualizations-dialog.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/custom-visualizations-dialog.jpg new file mode 100644 index 00000000..80258a14 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/custom-visualizations-dialog.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/customizing-map-tiles-default.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/customizing-map-tiles-default.jpg new file mode 100644 index 00000000..c1360ef6 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/customizing-map-tiles-default.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/customizing-map-tiles-tiles.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/customizing-map-tiles-tiles.jpg new file mode 100644 index 00000000..4e2b0795 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/customizing-map-tiles-tiles.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canChangeVisualizationBackgroundColor.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canChangeVisualizationBackgroundColor.jpg new file mode 100644 index 00000000..7df3485f Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canChangeVisualizationBackgroundColor.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canCopyVisualiation.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canCopyVisualiation.jpg new file mode 100644 index 00000000..3beaf95c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canCopyVisualiation.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canMaximizeVisualization.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canMaximizeVisualization.jpg new file mode 100644 index 00000000..3cb7c43a Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canMaximizeVisualization.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canSaveAs.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canSaveAs.jpg new file mode 100644 index 00000000..07ec366b Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canSaveAs.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canaddcalculatedfields.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canaddcalculatedfields.jpg new file mode 100644 index 00000000..97962b05 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canaddcalculatedfields.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canadddashboardfilter.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canadddashboardfilter.jpg new file mode 100644 index 00000000..15de0491 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canadddashboardfilter.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canadddatefilter.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canadddatefilter.jpg new file mode 100644 index 00000000..6f2be5dc Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canadddatefilter.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canaddpostcalculatedfields.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canaddpostcalculatedfields.jpg new file mode 100644 index 00000000..52ccb869 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canaddpostcalculatedfields.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-cancopyvisualization.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-cancopyvisualization.jpg new file mode 100644 index 00000000..e74398b1 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-cancopyvisualization.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canduplicatevisualization.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canduplicatevisualization.jpg new file mode 100644 index 00000000..050cc192 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canduplicatevisualization.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canedit.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canedit.jpg new file mode 100644 index 00000000..731ca2eb Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-canedit.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showChangeDataSource.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showChangeDataSource.jpg new file mode 100644 index 00000000..ba6e823a Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showChangeDataSource.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showExportImage.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showExportImage.jpg new file mode 100644 index 00000000..d24f4592 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showExportImage.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showExportToExcel.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showExportToExcel.jpg new file mode 100644 index 00000000..6b3bd5ff Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showExportToExcel.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showExportToPDF.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showExportToPDF.jpg new file mode 100644 index 00000000..52b44f90 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showExportToPDF.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showExportToPowerPoint.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showExportToPowerPoint.jpg new file mode 100644 index 00000000..3ea79208 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showExportToPowerPoint.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showFilters.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showFilters.jpg new file mode 100644 index 00000000..2644f71e Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showFilters.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showRefresh.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showRefresh.jpg new file mode 100644 index 00000000..a208797d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showRefresh.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showeditdatasource.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showeditdatasource.jpg new file mode 100644 index 00000000..a598a609 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-showeditdatasource.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-startineditmode.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-startineditmode.jpg new file mode 100644 index 00000000..25cdcc0c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-startineditmode.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-startwithnewvisualization.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-startwithnewvisualization.jpg new file mode 100644 index 00000000..f97b7214 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/editing-startwithnewvisualization.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-csv-options.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-csv-options.jpg new file mode 100644 index 00000000..2a606ab5 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-csv-options.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-csv.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-csv.jpg new file mode 100644 index 00000000..4eae0677 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-csv.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-excel-options.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-excel-options.jpg new file mode 100644 index 00000000..856fa8d8 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-excel-options.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-excel.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-excel.jpg new file mode 100644 index 00000000..d797f02b Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-excel.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-image-options.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-image-options.jpg new file mode 100644 index 00000000..aa418f66 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-image-options.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-image.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-image.jpg new file mode 100644 index 00000000..75d403d3 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-image.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-menu-item.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-menu-item.jpg new file mode 100644 index 00000000..1351a2f2 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-menu-item.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-pdf-options.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-pdf-options.jpg new file mode 100644 index 00000000..a58d0ee4 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-pdf-options.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-pdf.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-pdf.jpg new file mode 100644 index 00000000..b1c668f8 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-pdf.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-powerpoint-options.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-powerpoint-options.jpg new file mode 100644 index 00000000..03406aa2 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-powerpoint-options.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-powerpoint.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-powerpoint.jpg new file mode 100644 index 00000000..ea4bc8e5 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/export-powerpoint.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/filtering-dashboard-filters.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/filtering-dashboard-filters.jpg new file mode 100644 index 00000000..2e2a6bed Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/filtering-dashboard-filters.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/filtering-date-filter-daterange.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/filtering-date-filter-daterange.jpg new file mode 100644 index 00000000..8180b014 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/filtering-date-filter-daterange.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/filtering-date-filter-yeartodate.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/filtering-date-filter-yeartodate.jpg new file mode 100644 index 00000000..9160f589 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/filtering-date-filter-yeartodate.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/filtering-date-filter.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/filtering-date-filter.jpg new file mode 100644 index 00000000..835ec85a Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/filtering-date-filter.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/filtering-filter-legend.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/filtering-filter-legend.jpg new file mode 100644 index 00000000..111e1dfa Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/filtering-filter-legend.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/filtering-filter-location.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/filtering-filter-location.jpg new file mode 100644 index 00000000..4b1a4560 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/filtering-filter-location.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-angular-info.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-angular-info.jpg new file mode 100644 index 00000000..b936c2e7 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-angular-info.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-angular-name.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-angular-name.jpg new file mode 100644 index 00000000..21c62dc3 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-angular-name.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-angular-project.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-angular-project.jpg new file mode 100644 index 00000000..e2a883cd Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-angular-project.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-angular-terminal.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-angular-terminal.jpg new file mode 100644 index 00000000..0c0fc52e Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-angular-terminal.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-new-asp-net-core-web-app-info.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-new-asp-net-core-web-app-info.jpg new file mode 100644 index 00000000..2014a311 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-new-asp-net-core-web-app-info.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-new-asp-net-core-web-app-name.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-new-asp-net-core-web-app-name.jpg new file mode 100644 index 00000000..6702c6e6 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-new-asp-net-core-web-app-name.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-new-asp-net-core-web-app-project.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-new-asp-net-core-web-app-project.jpg new file mode 100644 index 00000000..26fada91 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-new-asp-net-core-web-app-project.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-nuget-packages-install.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-nuget-packages-install.jpg new file mode 100644 index 00000000..ebfd33a7 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-nuget-packages-install.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-nuget-packages-manage.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-nuget-packages-manage.jpg new file mode 100644 index 00000000..c8b0fff5 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-nuget-packages-manage.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-server-node-create-dashboards-folder.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-server-node-create-dashboards-folder.jpg new file mode 100644 index 00000000..6a5bf240 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-server-node-create-dashboards-folder.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-server-node-typescript-create-app-file.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-server-node-typescript-create-app-file.jpg new file mode 100644 index 00000000..59ec648f Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-server-node-typescript-create-app-file.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-server-node-typescript-create-dashboards-folder.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-server-node-typescript-create-dashboards-folder.jpg new file mode 100644 index 00000000..97ecbc80 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-server-node-typescript-create-dashboards-folder.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-java-version.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-java-version.jpg new file mode 100644 index 00000000..2ef73442 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-java-version.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-artifact-id.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-artifact-id.jpg new file mode 100644 index 00000000..cb4946ed Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-artifact-id.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-dashboards-folder.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-dashboards-folder.jpg new file mode 100644 index 00000000..85f39ce8 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-dashboards-folder.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-dependencies.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-dependencies.jpg new file mode 100644 index 00000000..827f2a0a Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-dependencies.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-explorer.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-explorer.jpg new file mode 100644 index 00000000..50244b39 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-explorer.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-group-id.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-group-id.jpg new file mode 100644 index 00000000..70899111 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-group-id.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-java-version.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-java-version.jpg new file mode 100644 index 00000000..2ef73442 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-java-version.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-language.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-language.jpg new file mode 100644 index 00000000..a9d7dd78 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-language.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-package-type.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-package-type.jpg new file mode 100644 index 00000000..6cf6185f Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-package-type.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-project.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-project.jpg new file mode 100644 index 00000000..7fbdc2ab Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-project.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-version.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-version.jpg new file mode 100644 index 00000000..034ee2e0 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/getting-started-spring-boot-jersey-version.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/hiding-menu-item.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/hiding-menu-item.jpg new file mode 100644 index 00000000..70d65f13 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/hiding-menu-item.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/install-finish.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/install-finish.jpg new file mode 100644 index 00000000..74f05ffc Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/install-finish.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/install-start.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/install-start.jpg new file mode 100644 index 00000000..07ba4964 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/install-start.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/install-unblock-zip.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/install-unblock-zip.jpg new file mode 100644 index 00000000..6e6852e5 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/install-unblock-zip.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/javascript-copy-reveal-files.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/javascript-copy-reveal-files.jpg new file mode 100644 index 00000000..12520b41 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/javascript-copy-reveal-files.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/javascript-create-reveal-folder.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/javascript-create-reveal-folder.jpg new file mode 100644 index 00000000..2de63895 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/javascript-create-reveal-folder.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/linking-add.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/linking-add.jpg new file mode 100644 index 00000000..71c2d4fa Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/linking-add.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/linking-open-campaigns.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/linking-open-campaigns.jpg new file mode 100644 index 00000000..d16f5991 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/linking-open-campaigns.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/linking-select-dashboard.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/linking-select-dashboard.jpg new file mode 100644 index 00000000..f3604d67 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/linking-select-dashboard.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/load-dashboards-dashboard-directory.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/load-dashboards-dashboard-directory.jpg new file mode 100644 index 00000000..19bd76c1 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/load-dashboards-dashboard-directory.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/loading-dashboard-as-resource-java.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/loading-dashboard-as-resource-java.jpg new file mode 100644 index 00000000..23500737 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/loading-dashboard-as-resource-java.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/loading-dashboard-as-resource.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/loading-dashboard-as-resource.jpg new file mode 100644 index 00000000..de9530b1 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/loading-dashboard-as-resource.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/loading-dashboards-default-directory-node.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/loading-dashboards-default-directory-node.jpg new file mode 100644 index 00000000..412b63b1 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/loading-dashboards-default-directory-node.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/loading-dashboards-default-directory.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/loading-dashboards-default-directory.jpg new file mode 100644 index 00000000..ed02ca98 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/loading-dashboards-default-directory.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/localization-override.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/localization-override.jpg new file mode 100644 index 00000000..0ce79f8b Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/localization-override.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/localization-test-visualization-fields.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/localization-test-visualization-fields.jpg new file mode 100644 index 00000000..6d1a057d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/localization-test-visualization-fields.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/localization-test.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/localization-test.jpg new file mode 100644 index 00000000..2730c760 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/localization-test.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/maximize-three_divisions_dashboard.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/maximize-three_divisions_dashboard.png new file mode 100644 index 00000000..b5130a81 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/maximize-three_divisions_dashboard.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/maximize-three_divisions_dashboard_maximized.png b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/maximize-three_divisions_dashboard_maximized.png new file mode 100644 index 00000000..a760dc0a Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/maximize-three_divisions_dashboard_maximized.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/nuget-package-source-local-vs.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/nuget-package-source-local-vs.jpg new file mode 100644 index 00000000..d80e69b3 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/nuget-package-source-local-vs.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/overview-high-level-architecture.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/overview-high-level-architecture.jpg new file mode 100644 index 00000000..71b791ff Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/overview-high-level-architecture.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/saving-save-button.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/saving-save-button.jpg new file mode 100644 index 00000000..3bb0b872 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/saving-save-button.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/saving-saveas-button.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/saving-saveas-button.jpg new file mode 100644 index 00000000..9dab5fef Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/saving-saveas-button.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/setting-up-server-create-dashboards-folder.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/setting-up-server-create-dashboards-folder.jpg new file mode 100644 index 00000000..e288f429 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/setting-up-server-create-dashboards-folder.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/theming-mountain-dark.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/theming-mountain-dark.jpg new file mode 100644 index 00000000..692c1835 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/theming-mountain-dark.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/theming-mountain-light.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/theming-mountain-light.jpg new file mode 100644 index 00000000..c023a5dc Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/theming-mountain-light.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/theming-ocean-dark.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/theming-ocean-dark.jpg new file mode 100644 index 00000000..e62d2768 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/theming-ocean-dark.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/theming-ocean-light.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/theming-ocean-light.jpg new file mode 100644 index 00000000..9055b93a Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/theming-ocean-light.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/tooltips-row-property.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/tooltips-row-property.jpg new file mode 100644 index 00000000..c7d71b5d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/tooltips-row-property.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/tooltips.jpg b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/tooltips.jpg new file mode 100644 index 00000000..e78e1e59 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/images/tooltips.jpg differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/index.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/index.md new file mode 100644 index 00000000..4b3af0ce --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/index.md @@ -0,0 +1,16 @@ +--- +displayed_sidebar: webSidebar +hide_table_of_contents: true +--- + +# Reveal SDK for Web へようこそ! + +Reveal は、埋め込み分析用に構築された最新の BI ソリューションです。データ分析をアプリケーションに簡単に統合でき、Reveal 表示形式を制御できる豊富な API を利用しながら、アプリでのユーザー エクスペリエンスを強化できます。 + +ユーザー エクスペリエンスのエキスパートによって構築され、ビジネス ユーザー向けに設計された Reveal は、表示形式の作成、表示、チームとの共有を簡単にします。使用しているデバイスに関係なく、シームレスで同一のエクスペリエンスを提供します。 + +**参照リンク:** +1. [Server SDK のインストール](install-server-sdk.md) +2. [Client SDK のインストール](install-client-sdk.md) +3. [はじめてのサーバー作成](getting-started-server.md) +4. [はじめてのアプリ作成](getting-started-javascript.md) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/install-client-sdk.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/install-client-sdk.md new file mode 100644 index 00000000..2025610d --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/install-client-sdk.md @@ -0,0 +1,78 @@ +# Client SDK のインストール + +## スクリプト ファイルを使用してインストールする + +### CDN を使用してインストールする +`index.html` ファイルを変更し、ページの下部に (`` 終了タグの直前) `infragistics.reveal.js` スクリプトを含めます。 + +```html + +``` + +:::caution 本番環境では使用しないでください + +Reveal SDK CDN は、プロトタイピング、オンボーディング、デモ、および試用シナリオ**のみ**を対象としています。 + +本番アプリケーションの場合は、Reveal SDK ライブラリを**セルフホスト化する必要があります**。可用性の保証、バージョン管理、パフォーマンスの最適化、長期的な安定性など、本番ワークロードに必要な保証が提供されないため、本番環境で CDN に依存することは推奨されません。 + +本番環境にデプロイする際は、予測可能な動作と更新の完全な制御を確保するために、SDK アセットをダウンロードして独自のインフラストラクチャから提供してください。 + +::: + +### JavaScript ファイルを使用してインストールする +Reveal CDN を使用できない場合は、独自のドメインで Reveal SDK JavaScript ファイルをホストすることもできます。Reveal SDK 配布ファイルは、次のリンクからダウンロードできます: + +https://dl.revealbi.io/reveal/libs/[var:sdkVersion]/reveal-sdk-distribution-js.zip + +1 - クライアント アプリケーションで `assets` と呼ばれる新しいフォルダーを作成し、`assets` フォルダー内に `reveal` と呼ばれる別のフォルダーを作成します。 + +![](images/javascript-create-reveal-folder.jpg) + +2 - Reveal SDK ディストリビューション ファイルからすべての JavaScript ファイルを、前に作成した `assets/reveal` フォルダーにコピーします。 + +![](images/javascript-copy-reveal-files.jpg) + +3 - `index.html` ファイルを変更し、ページの下部に (`` 終了タグの直前) `infragistics.reveal.js` スクリプトを含めます。 + +```html + +``` + +### 依存関係の追加 +Reveal SDK が正しく機能するには、次の依存関係が必要です。 + +**Jquery 2.2 またはそれ以降** + +```html + +``` + +**Day.js 1.8.15 またはそれ以降** + +```html + +``` + +`index.html` ファイルを変更し、ページの下部に (`infragistics.reveal.js` スクリプトの直前) すべての依存関係スクリプトを含めます。 + +最終の `index.html` ファイルは以下のようになります。 + +```html title="index.html" + + + + + + + Reveal Sdk - HTML/JavaScript + + + + // highlight-start + + + + // highlight-end + + +``` \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/install-server-sdk.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/install-server-sdk.md new file mode 100644 index 00000000..83de7bea --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/install-server-sdk.md @@ -0,0 +1,156 @@ +# Server SDK のインストール + +## ASP.NET + +以下の手順では、Reveal SDK を既存の ASP.NET Core プロジェクトにインストールする方法について説明します。 + +1 - ソリューションまたはプロジェクトを右クリックし、**[ソリューションの NuGet パッケージの管理]** を選択します。 + +![](images/getting-started-nuget-packages-manage.jpg) + +2 - パッケージ マネージャー ダイアログで **[参照]** タブを開き、**nuget.org** パッケージ ソースまたは **Infragistics (Local)** パッケージ ソースを選択して **Reveal.Sdk.AspNetCore** NuGet パッケージをプロジェクトにインストールします。 + +![](images/getting-started-nuget-packages-install.jpg) + +3 - `Program.cs` ファイルを開き、`using Reveal.Sdk;` 名前空間を追加します。次に、既存の `builder.Services.AddControllers()` メソッドに `IMcvBuilder.AddReveal()` の呼び出しを追加します。 + +```cs +using Reveal.Sdk; + +builder.Services.AddControllers().AddReveal(); +``` + +4 - プロジェクトを右クリックし、**[追加] -> [新しいフォルダー]** を選択します。フォルダーの名前は **「Dashboards」** にしてください。 + +![](images/setting-up-server-create-dashboards-folder.jpg) + +デフォルトで、Reveal SDK は **Dashboards** フォルダーからすべてのダッシュボードを読み込む規則を使用します。この規則を変更するにはカスタムの `IRVDashboardProvider` を作成します。詳細については、[ダッシュボードの読み込み](loading-dashboards.md)トピックを参照してください。 + +## Node.js + +1 - Node.js 用の **Reveal SDK** をインストールします。 + +```bash npm2yarn +npm install reveal-sdk-node +``` + +2 - `main.js` ファイルを変更して Reveal を追加します。 + +```js +var express = require('express'); +// highlight-next-line +var reveal = require('reveal-sdk-node'); + +const app = express(); + +// highlight-next-line +app.use('/', reveal()); + +app.listen(8080, () => { + console.log(`Reveal server accepting http requests`); +}); +``` + +3 - Visual Studio Code で、エクスプローラーの **[新しいフォルダー]** ボタンをクリックし、**dashboards** という名前を付けます。フォルダーは **dashboards** という名前で、アプリケーションの作業ディレクトリに作成する必要があります。 + +![](images/getting-started-server-node-create-dashboards-folder.jpg) + +デフォルトで、Reveal SDK は **dashboards** フォルダーからすべてのダッシュボードを読み込む規則を使用します。この規則を変更でするにはカスタムの `IRVDashboardProvider` を作成します。 + +## Java + +以下の手順では、Reveal SDK を既存の Java アプリケーションにインストールする方法について説明します。 + +1 - **pom.xml** ファイルを更新します。Reveal Maven リポジトリを追加します。 + +```xml title="pom.xml" + + + reveal.public + https://maven.revealbi.io/repository/public + + +``` + +2 - Reveal SDK を依存関係として追加します。 + +```xml title="pom.xml" + + com.infragistics.reveal.sdk + reveal-sdk + [var:sdkVersion] + +``` + +### Spring Boot - Jersey + +Jersey Config クラスを作成し、`RevealEngineInitializer.initialize` メソッドを呼び出して Reveal SDK を初期化します。Reveal SDK を Jersey で正しく動作させるためには、Reveal SDK の全クラスを Jersey に登録する必要があります。Reveal SDK のクラスを登録するには、`RevealEngineInitializer.getClassesToRegister` メソッドによって返されるクラスをループして、Jersey Config にそれらを登録します。 + +```java title="RevealJerseyConfig.java" +import org.glassfish.jersey.server.ResourceConfig; +import org.springframework.stereotype.Component; + +import com.infragistics.reveal.engine.init.RevealEngineInitializer; + +import javax.ws.rs.ApplicationPath; + +@Component +@ApplicationPath("/") +public class RevealJerseyConfig extends ResourceConfig +{ + public RevealJerseyConfig() + { + RevealEngineInitializer.initialize(); + + //register all Reveal classes in JAX-RS context + for (Class clazz : RevealEngineInitializer.getClassesToRegister()) { + register(clazz); + } + } +} +``` + +### Tomcat + +1 - Jakarta RESTful Web Services (JAX-RS) 実装への依存関係を追加します。Jersey、RESTeasy、Apache CXF など複数の選択肢の中から選ぶことができます。お好みのプロバイダー提供元が説明する手順に従ってください。 + +例として Jersey 用に追加する必要がある依存関係を以下に示します: + +```xml + + org.glassfish.jersey.containers + jersey-container-servlet + 2.32 + + + org.glassfish.jersey.inject + jersey-cdi2-se + 2.32 + +``` + +2 - ServletContextListener クラスを作成し `RevealEngineInitializer.initialize` メソッドを呼び出して Reveal SDK を初期化します。 + +```java +import javax.servlet.ServletContextEvent; +import javax.servlet.ServletContextListener; +import javax.servlet.annotation.WebListener; + +import com.infragistics.reveal.engine.init.RevealEngineInitializer; + +@WebListener +public class RevealServletContextListener implements ServletContextListener { + + @Override + public void contextDestroyed(ServletContextEvent ctx) { + + } + + @Override + public void contextInitialized(ServletContextEvent ctx) { + + //initialize Reveal + RevealEngineInitializer.initialize(); + } +} +``` \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/known-issues.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/known-issues.md new file mode 100644 index 00000000..8936b428 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/known-issues.md @@ -0,0 +1,101 @@ +# 既知の問題 + +## Windows Azure App Service でのエクスポート非対応 + +### 問題 + +**Azure App Service (Windows)** 上でホストしている場合、エクスポート機能は**サポートされていません**。これは、ブラウザー ベースのエクスポートに必要な **Playwright** が、Azure App Service 内の **Windows ディストリビューションではサポートされていない**ためです。 + +### 回避策 + +次の 2 つの方法で解決できます。 + +1. **Linux App Service プランを使用する** + アプリを Windows ではなく **Azure App Service (Linux)** 上でホストします。 + ASP.NET Core の起動時に、`Program.cs` 内で Web アプリケーションを実行する**前**に Playwright インストーラーを呼び出します。 + + ```csharp + var builder = WebApplication.CreateBuilder(args); + //... + + Microsoft.Playwright.Program.Main(new string[] { "install", "chromium", "--with-deps" }); + + app.UseAuthorization(); + app.MapControllers(); + app.Run(); + ``` + + これにより、Chromium および必要な依存関係がランタイムで利用可能になります。 + +2. **Windows コンテナーを使用する** + Windows 環境を維持する必要がある場合は、アプリケーションを **Windows コンテナー**内でホストします。 + これにより、コンテナー イメージ内で Playwright をインストールおよび構成でき、Windows App Service の制限を回避できます。 + +## エクスポート時にカスタム表示形式がサポートされない + +### 問題 + +**カスタム表示形式** (標準の Reveal チャート タイプを拡張する、ユーザー定義の表示形式) は、ダッシュボードをいずれの形式 (PDF、Excel、PowerPoint、画像) でエクスポートしても空白で表示されます。これは、すべてのプラットフォームに共通する既知の制限です。 + +### 根本原因 + +Reveal SDK は、カスタム表示形式のレンダリングを完全には制御できません。エクスポート プロセス中のレンダリング タイミングの問題により、エクスポート操作が表示形式の内容をキャプチャする前に、カスタム表示形式が完全に表示またはレンダリングされない場合があります。その結果、エクスポートされたファイルでは空白のプレースホルダーが表示されます。 + +### 回避策 + +この制限に対する**プログラム的な回避策はありません**。ただし、次の方法を利用できます。手動でスクリーンショットを**取得**し、エクスポート機能の代替として、Word ドキュメント、PDF、PowerPoint プレゼンテーションなどの任意の形式に配置してください。 + +## `
` タグが `` に追加される
+
+### 問題
+RevealView コンポーネントは、`` 要素の末尾に非表示の `
` タグを追加します。このタグは、レイアウト計算のためにフォント サイズを測定する用途でビューアーによって内部的に使用されます。アプリケーションに `
` 要素を対象とする CSS (グローバル タイポグラフィや余白のスタイルなど) が定義されている場合、これらのルールが RevealView 測定要素に誤って適用される可能性があります。これにより、UI で予期しない視覚的な乱れやレイアウトのズレが発生する可能性があります。
+
+### 回避策
+これらの不要なスタイルが測定要素に影響を与えないようにするには、グローバル スタイルシートに次の CSS ルールを追加してください。
+
+```css
+body > pre.rv-multiline-editor {
+    height: 0px !important;
+}
+```
+
+## Linux ARM64 Node でのエクスポート
+
+- Node.js を使用していて、[Linux ARM64 上で実行する場合、Chromium は自動的にインストールできません](https://github.com/puppeteer/puppeteer/issues/7740)。そのため、ダッシュボードをエクスポートする前に、パッケージ マネージャーを使用して、または手動で、Chromium をインストールする必要があります。Reveal は Chromium バイナリを `/usr/bin/chromium` の下で探します。
+
+## グリッド行ページング
+
+- ページングは​​次のプロバイダーでサポートされています:SQL Server、MySQL、BigQuery、MongoDB、PostgreSQL、Snowflake、SyBase、Redshift、Databricks、Cube.dev、Athena、および Oracle。
+- ストアド プロシージャーをサポートするプロバイダーでは、テーブルのようにクエリを実行して行の範囲を返すことができないため、ストアド プロシージャーを選択するとグリッド ページングが無効になります。
+- サーバー上でのデータ処理が false の場合、ページングは​​使用できません。
+- 通常の表示モードでページングを有効にしてグリッドを並べ替えると、列の並べ替えは左から右に適用されます。つまり、最後の列を並べ替えてから最初の列を並べ替えると、その順序ではなく、左から右に適用されます。
+
+## ヘッドレス エクスポート
+
+- Node.js SDK のヘッドレス エクスポートは Linux/MacOSX では使用できません。
+- ```DocumentExportOptions``` が使用されている場合、ヘッドレス エクスポートは失敗します。代わりにフォーマット固有のクラス (例: ```PdfExportOptions```) を使用してください。
+
+## ヘッドレス エクスポート - グローバル フィルター
+
+- XMLA フィルターは現在 ASP.NET ではサポートされません。
+- Node.js のグローバル フィルターは現在サポートされません。
+
+## ライセンス
+
+- NuGet パッケージを使用する際に、Reveal SDK のライセンス (SDK インストーラーに有効なキーを入力) 後もウォーターマークが表示されてしまうます。回避策: プロジェクトから NuGet パッケージをアンインストールし、NuGet のキャッシュをクリアして、パッケージを再度インストールしてください。NuGet のすべてのキャッシュをクリアしたくない場合、キャッシュした場所を検索し、Infragistics Reveal 項目のみをクリアできます。場所は NuGet のバージョンと、packages.config または PackageReferece のどちらが使用されているかによって異なります。
+
+## MacOS ARM64 のサポート (ベータ版)
+
+- マシンの構成によってはロケールの問題 (例: 9,5 と 9.5) が発生する可能性があります。
+
+## MongoDB コネクター
+
+- `currentTimeZone` 関数を使用した計算フィールドによる結合が失敗する問題。
+- `_id` 列を参照する計算フィールドによる結合が失敗する問題。
+- `concatenate` 関数はパラメーターを文字列に暗黙的にキャストしないため、非文字列の列参照/関数を評価するときにエラーが発生する可能性があります。
+- 行にフィールドがなく、列に 1 つ以上のディメンションがあるピボットに、行が生成されない問題。
+- [埋め込み](https://www.mongodb.com/basics/embedded-mongodb)はサポートされていませんが単一値の埋め込みはサポートされています。
+- MongoDB バージョン v5.0 以上がサポートされています。
+- 名前にドット 「.」 またはドル記号 「$」 が含まれるフィールドは無視されます。ほとんどの場合、特別な処理が必要です: [ドットとドル記号の考慮事項](https://www.mongodb.com/docs/manual/core/dot-dollar-considerations/)。
+- ObjectId 型のフィールドによるフィルタリング。
+- MongoDB で null を含む合計を実行すると、結果は SQL サーバーのような null ではなく 0 になります。
\ No newline at end of file
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/linking-dashboards.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/linking-dashboards.md
new file mode 100644
index 00000000..89c47153
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/linking-dashboards.md
@@ -0,0 +1,184 @@
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# ダッシュボード リンク
+
+Reveal SDK はダッシュボードのリンクをサポートしているため、ユーザーはダッシュボードをナビゲートできます。ダッシュボードからダッシュボードに移動することで、業務上のハイレベルな概要からより詳細なビューに進むことができます。
+
+Reveal SDK の観点からは、ダッシュボードのリンクは、エンドユーザーがビジュアル化されたリンクをクリックして別のダッシュボードをロードするときに呼び出されます。
+
+![](images/linking-open-campaigns.jpg)
+
+
+## ダッシュボード リンクの作成
+
+**[設定]** タブの **[リンク]** セクションにある [+] ボタンをクリックすると、表示形式エディターでダッシュボード リンクが作成されます。
+
+![](images/linking-add.jpg)
+
+このボタンをクリックすると、エンドユーザーがダッシュボードを選択できるダイアログが表示されます。**[ダッシュボードの選択]** 項目をクリックすると、ダッシュボード選択ダイアログが表示されます。 
+
+![](images/linking-select-dashboard.jpg)
+
+この時点で、開発者は、ユーザーが選択できるダッシュボードの範囲を紹介するカスタム ユーザー インターフェイスを作成する必要があります。このプロセスを容易にするために、Reveal SDK には、カスタマイズされた UI を表示するためのトリガーとして機能する `onDashboardSelectorRequested` イベントが用意されています。このイベント内のイベント引数には、選択したダッシュボードの一意の ID を提供し、それを SDK にリンクするコールバック関数が含まれています。
+
+```js
+revealView.onDashboardSelectorRequested = (args) => {
+    //todo: show dialog to list dashboards and set the selected dashboardId    
+
+    //invoke the callback with the dashboardId selected in the custom dialog
+    args.callback(dashboardId);
+}
+```
+
+カスタム UI からダッシュボードが選択されたら、次の手順は、リンクされたダッシュボードをロードする方法を SDK に指示することです。このために、SDK は `onLinkedDashboardProviderAsync` イベントを提供します。このイベントでは、リンクされたダッシュボード インスタンスが返されます。
+
+```js
+revealView.onLinkedDashboardProviderAsync = (dashboardId, title) => {
+    return $.ig.RVDashboard.loadDashboard(dashboardId);
+};
+```
+
+:::info
+
+`onLinkedDashboardProviderAsync` イベントは、**ダッシュボード リンク**が表示形式のツールチップ内でクリックされたときにも呼び出されます。
+
+:::
+
+## 例: ダッシュボード リンク
+
+これは、ダッシュボード リンクを追加するためのカスタム ダッシュボード選択 UI を実装するために必要な手順の高レベルの例です。作業例の完全なソース コードについては、サンプルの終了にある GitHub リンクを参照してください。
+
+1 - サーバー アプリケーションで、利用可能なすべてのダッシュボードの名前を返すサービス エンドポイントを公開して、カスタム UI に表示します。
+
+
+  
+
+```cs
+app.MapGet("dashboards", () =>
+{
+    // Get the file path for the dashboards
+    var filePath = Path.Combine(Environment.CurrentDirectory, "Dashboards");
+
+    // Get the names of all files in the directory
+    var files = Directory.GetFiles(filePath);
+
+    //return just the dashboard file names
+    return files.Select(x => Path.GetFileNameWithoutExtension(x));
+});
+```
+
+  
+
+  
+
+```java
+@Component
+@Path("dashboards/")
+public class RevealDashboardController {
+
+    @GET
+    @Produces(MediaType.APPLICATION_JSON)
+    public List getFileNamesWithoutExtension() {
+        List filenames = new ArrayList();
+        File directory = new File("dashboards");
+        File[] files = directory.listFiles();
+
+        for (File file : files) {
+            String fileNameWithExtension = file.getName();
+            String fileNameWithoutExtension = fileNameWithExtension.substring(0, fileNameWithExtension.lastIndexOf("."));
+            filenames.add(fileNameWithoutExtension);
+        }
+
+        return filenames;
+    }
+}
+```
+
+  
+
+      
+
+```ts
+app.get("/dashboards/", (req, res) => {
+	fs.readdir("dashboards", (err, files) => {
+		if (err) {
+		  res.status(500).send('Error getting directory information');
+		} else {
+		  const filenames = files.map((file) => {
+			const extension = path.parse(file).ext;
+			return file.slice(0, -extension.length);
+		  });
+		  res.send(filenames);
+		}
+	  });
+});
+```
+
+  
+
+
+2 - カスタム ダッシュボード セレクター UI として使用する HTML ダイアログを作成します。
+
+```html
+
+    

+    
+
+```
+
+3 - RevealView で `onDashboardSelectorRequested` イベントを処理します。このイベントでは、カスタム UI の表示を担当するメソッドを呼び出します。カスタム UI で使用できるように、コールバックを関数に渡します。
+
+```js
+revealView.onDashboardSelectorRequested = (args) => {
+    openDialog(args.callback);
+}
+```
+
+4 - サービス エンドポイントからすべてのダッシュボード ファイル名を取得する `openDialog` 関数を実装し、ダイアログに表示するダッシュボードのリストを動的に作成します。
+
+```js
+const dialog = document.getElementById("dbSelector");
+
+function openDialog(callback) {
+    fetch("http://localhost:5111/dashboards")
+        .then(resp => resp.json())
+        .then(data => {
+            var container = document.querySelector("#thumbnails");
+            container.innerHTML = "";
+
+            data.forEach(id => {
+                createThumbnail(container, id, callback);
+            });
+
+        }).then(() => dialog.showModal());
+}
+
+function createThumbnail(container, id, callback) {
+    const button = document.createElement("button");
+    button.innerHTML = id;
+    button.addEventListener('click', (arg) => {
+        callback(id);
+        closeDialog();
+    });
+    button.className = "Reveal-Thumbnail-Box";
+    container.appendChild(button);
+}
+
+function closeDialog() {
+    dialog.close();
+}
+```
+
+5 - `onLinkedDashboardProviderAsync` イベントを処理して、リンクされたダッシュボードを読み込みます。
+```js
+revealView.onLinkedDashboardProviderAsync = (dashboardId, title) => {
+    return $.ig.RVDashboard.loadDashboard(dashboardId);
+};
+```
+
+:::info コードの取得
+
+このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/LinkingDashboards-UI) にあります。
+
+:::
\ No newline at end of file
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/loading-dashboards.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/loading-dashboards.md
new file mode 100644
index 00000000..34955253
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/loading-dashboards.md
@@ -0,0 +1,367 @@
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# ダッシュボードを読み込む
+
+Reveal ダッシュボードはサーバーに保存されます。クライアント アプリケーションは `$.ig.RVDashboard.loadDashboard` メソッドを呼び出し、読み込むダッシュボードの名前を渡します。ダッシュボードの要求はサーバーに送信され、サーバーは要求されたダッシュボードをクライアントに返信します。クライアントはサーバーから返信されてきたダッシュボードを受け取り、`RevealView.dashboard` プロパティに設定します。
+
+デフォルトでは Reveal SDK はファイル パスからダッシュボードをロードする規約を使用しています。具体的には、Reveal SDK はサーバー上の作業ディレクトリにある **Dashboards** フォルダー内でダッシュボードを探します。
+
+1 - サーバー アプリケーションで、作業ディレクトリに **Dashboards** という名前のフォルダを作成しその中にダッシュボード ファイルを配置します。
+
+
+
+  
+
+![](images/loading-dashboards-default-directory.jpg)
+
+  
+
+  
+
+:::danger サポート対象外
+
+Java では現在デフォルトのダッシュボード ローダーはサポートされていません。カスタムのダッシュボード プロバイダーを作成する必要があります。
+
+:::
+
+  
+
+      
+
+![](images/loading-dashboards-default-directory-node.jpg)
+
+  
+
+
+2 - クライアント アプリケーションで、`$.ig.RevealSdkSettings.setBaseUrl`メソッドを呼び出しサーバーの URL を渡します。デバッグ時には、サーバーの URL は `https://localhost` の後にポート番号が付いたものになります。
+
+例:
+
+```js
+$.ig.RevealSdkSettings.setBaseUrl("https://localhost:5111/");   
+```
+
+:::caution
+
+サーバーがクライアント アプリケーションと異なる URL で動作している場合、`$.ig.RevealSdkSettings.setBaseUrl` を呼び出すことが必要です。サーバー アプリケーションとクライアント アプリケーションの両方が同じ URL で実行されている場合、このメソッドは必要ありません。このメソッドは一度だけ呼び出す必要があります。
+
+:::
+
+3 - `$.ig.RVDashboard.loadDashboard` メソッドを呼び出し、拡張子 .rdash を除いたダッシュボード ファイル名を渡します。このメソッドには要求したダッシュボードをサーバーから受け取るコールバックがあります。コールバックでダッシュボードを受け取ったら、`$.ig.RevealView` のインスタンスを取得し、サーバーからの応答にあるダッシュボードを `RevealView.dashboard` プロパティにセットします。
+
+```js
+$.ig.RVDashboard.loadDashboard("Sales", (dashboard) => {
+    var revealView = new $.ig.RevealView("#revealView");
+    revealView.dashboard = dashboard;
+});
+```
+
+:::info コードの取得
+
+このサンプルのソースコードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/LoadingDashboards) にあります。
+
+:::
+
+## カスタム ダッシュボード プロバイダー
+
+デフォルトの **Dashboards** ディレクトリと異なる場所をアプリケーションで使用する場合、代わりにダッシュボードをロードするためのカスタム ダッシュボード プロバイダを提供することができます。
+
+1 - ダッシュボード プロバイダーを作成します。
+
+
+  
+
+```cs
+public class DashboardProvider : IRVDashboardProvider
+{
+    public Task GetDashboardAsync(IRVUserContext userContext, string dashboardId)
+    {
+        throw new NotImplementedException();
+    }
+
+    public Task SaveDashboardAsync(IRVUserContext userContext, string dashboardId, Dashboard dashboard)
+    {
+        throw new NotImplementedException();
+    }
+}
+```
+
+  
+
+  
+
+```java
+public class DashboardProvider implements IRVDashboardProvider {
+
+    @Override
+    public InputStream getDashboard(IRVUserContext userContext, String dashboardId) throws IOException {
+        return null;
+    }
+
+    @Override
+    public void saveDashboard(IRVUserContext arg0, String arg1, InputStream arg2) throws IOException {
+        return null;
+    }	
+}
+```
+
+  
+
+      
+
+```ts
+const dashboardProvider = async (userContext:IRVUserContext | null, dashboardId: string) => {
+	return null;
+}
+```
+
+  
+
+
+2 - ダッシュボード プロバイダーを Reveal SDK に登録します。
+
+
+  
+
+```cs
+builder.Services.AddControllers().AddReveal( builder =>
+{
+    builder.AddDashboardProvider();
+});
+```
+
+  
+
+  
+
+```java
+RevealEngineInitializer.initialize(new InitializeParameterBuilder().
+    setDashboardProvider(new DashboardProvider()).
+    build());
+```
+
+  
+  
+      
+
+```ts
+const revealOptions: RevealOptions = {
+	dashboardProvider: dashboardProvider,
+};
+
+app.use("/", reveal(revealOptions));
+```
+
+  
+
+
+
+
+## 例: ファイル パスから読み込む
+
+
+  
+
+```cs
+public class DashboardProvider : IRVDashboardProvider
+{
+    public Task GetDashboardAsync(IRVUserContext userContext, string dashboardId)
+    {
+        var filePath = Path.Combine(Environment.CurrentDirectory, $"MyDashboardsFolder/{dashboardId}.rdash");
+        var dashboard = new Dashboard(filePath);
+        return Task.FromResult(dashboard);
+    }
+
+    public Task SaveDashboardAsync(IRVUserContext userContext, string dashboardId, Dashboard dashboard)
+    {
+        throw new NotImplementedException();
+    }
+}
+```
+
+  
+
+  
+
+```java
+public class RevealDashboardProvider implements IRVDashboardProvider {
+
+    @Override
+    public InputStream getDashboard(IRVUserContext userContext, String dashboardId) throws IOException {
+        InputStream dashboardStream = new FileInputStream("dashboards/" + dashboardId + ".rdash");
+        return dashboardStream;
+    }
+
+    @Override
+    public void saveDashboard(IRVUserContext arg0, String arg1, InputStream arg2) throws IOException {
+        
+    }	
+}
+```
+
+  
+
+      
+
+```ts
+const dashboardProvider = async (userContext:IRVUserContext | null, dashboardId: string) => {
+	return fs.createReadStream(`myDashboards/${dashboardId}.rdash`);
+}
+```
+
+  
+
+
+:::info
+
+このサンプルのソースコードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/LoadingDashboards-File) にあります。
+
+:::
+
+
+
+## 例: リソースから読み込む
+
+1 - サーバー アプリケーションにリソースとして Reveal ダッシュボード **.rdash** ファイルを埋め込む。
+
+
+
+  
+
+ASP.NET サーバー アプリケーションにリソースとして Reveal ダッシュボード **.rdash** ファイルを埋め込むには、Visual Studio でダッシュボード ファイルのプロパティを開き、.rdash ファイルの **ビルド アクション** を **埋め込みリソース** に設定します。
+
+![](images/loading-dashboard-as-resource.jpg)
+
+  
+
+  
+
+Reveal ダッシュボード **.rdash** ファイルを Java サーバー アプリケーションのリソースとして埋め込むには、ダッシュボード ファイルを **resources** ディレクトリに配置します。
+
+![](images/loading-dashboard-as-resource-java.jpg)
+
+  
+
+
+
+2 - ダッシュボード プロバイダーを作成します。
+
+
+  
+
+```cs
+public class DashboardProvider : IRVDashboardProvider
+{
+    public Task GetDashboardAsync(IRVUserContext userContext, string dashboardId)
+    {
+        var resource = Assembly.GetExecutingAssembly().GetManifestResourceStream($"RevealSdk.Server.Dashboards.{dashboardId}.rdash");
+        using (resource)
+        {
+            var dashboard = new Dashboard(resource);
+            return Task.FromResult(dashboard);
+        }
+    }
+
+    public Task SaveDashboardAsync(IRVUserContext userContext, string dashboardId, Dashboard dashboard)
+    {
+        throw new NotImplementedException();
+    }
+}
+```
+
+:::note
+
+`Assembly.GetManifestResourceStream` メソッドで提供するリソースの `name` には、.rdash ファイルの `namespace` とファイル名を含める必要があります。
+
+:::
+
+  
+
+  
+
+```java
+public class RevealDashboardProvider implements IRVDashboardProvider {
+
+    @Override
+    public InputStream getDashboard(IRVUserContext userContext, String dashboardId) throws IOException {
+        InputStream dashboardStream = getClass().getResourceAsStream("/dashboards/" + dashboardId + ".rdash");
+		return dashboardStream;
+    }
+
+    @Override
+    public void saveDashboard(IRVUserContext arg0, String arg1, InputStream arg2) throws IOException {
+        
+    }	
+}
+```
+
+  
+
+
+
+:::info コードの取得
+
+このサンプルのソースコードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/LoadingDashboards-Resource) にあります。
+
+:::
+
+## 例: JSON から読み込む
+
+上級ユーザーや、Reveal ダッシュボードを .rdash ファイルではなく .json ファイルにシリアライズするユーザーのために、サーバー アプリケーションで `Dashboard.LoadFromJsonAsync` メソッドを使用してこれらの JSON ベースのファイルをロードすることができます。
+
+
+  
+
+```cs
+public class DashboardProvider : IRVDashboardProvider
+{
+    public Task GetDashboardAsync(IRVUserContext userContext, string dashboardId)
+    {
+        var filePath = Path.Combine(Environment.CurrentDirectory, $"Dashboards/{dashboardId}.json");
+        var json = File.ReadAllText(filePath);
+        var dashboard = Dashboard.FromJsonString(json);
+        return Task.FromResult(dashboard);
+    }
+
+    public Task SaveDashboardAsync(IRVUserContext userContext, string dashboardId, Dashboard dashboard)
+    {
+        throw new NotImplementedException();
+    }
+}
+```
+
+  
+
+  
+
+:::danger サポート対象外
+
+この機能は現在 Java ではサポートされていません。
+
+:::
+
+  
+
+      
+
+:::danger サポート対象外
+
+この機能は現在 Node.jsではサポートされていません。
+
+:::
+
+  
+
+
+:::caution
+
+Reveal ダッシュボードが JSON にシリアライズされた後にその内容を操作または変更すると、ダッシュボードの整合性が失われ、ダッシュボードの内容に不可逆的な損傷が生じる可能性があります。その結果、ダッシュボードの読み込みエラーもしくは読み込み失敗によってアプリケーションで実行時例外がスローされる可能性があります。
+
+:::
+
+:::info コードの取得
+
+このサンプルのソースコードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/LoadingDashboards-Json) にあります。
+
+:::
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/localizing.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/localizing.md
new file mode 100644
index 00000000..50e8d7cf
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/localizing.md
@@ -0,0 +1,186 @@
+# ローカライズ
+
+Reveal SDK はローカリゼーションの強力なサポートを提供し、多様な世界市場にわたってその多用途性と魅力を強化します。わかりやすく包括的なローカリゼーション フレームワークより、開発者はアプリケーションをさまざまな言語にシームレスに適応させることができます。
+
+現在のローカリゼーション ロケールは、デフォルトではユーザーのブラウザーによって自動的に決定されます。ただし、文字列のローカライズを有効にするには、SDK 自体のロケールを設定する必要があります。この手順では、内部文字列の表示言語をカスタマイズできます。SDK は次のロケールをサポートします: `de`、`es`、`fr`、`it`、`ja`、`ko`、`ms`、`nl`、`pt`、`ru`、`zh- cn`、`zh-tw`。このリストは、`$.ig.SupportedLocales` プロパティを調べることで参照できます。
+
+ロケールを設定するには、メソッド `$.ig.RevealSdkSettings.overrideLocale` を使用し、前述のリストから目的のロケールをパラメーターとして渡します。ロケールを再度オーバーライドする前に、promise を待つことが重要です。問題を回避するには、必ずこの順序に従ってください。
+
+```js
+$.ig.RevealSdkSettings.overrideLocale('ja').then(_ => {
+    ...
+})
+```
+
+すべての内部テキストが日本語に変更されるはずです。
+
+![](images/localization-override.jpg)
+
+その後、可視化のタイトルや列名などの文字列のローカライズを開始する準備が整います。
+
+カスタム翻訳を提供するには、クライアントに `$.ig.RevealSdkSettings.localizedStringsProvider` イベントのハンドラーを追加する必要があります。このイベントは `RVLocalizationElement` と `RVLocalizationContext` を受け取り、ローカライズされた文字列を返す必要があります。
+
+```js
+$.ig.RevealSdkSettings.localizedStringsProvider = function (element, context) {
+    ...
+    return localizedString;
+};
+```
+
+ここでは、あらゆる入力文字列に対してローカライズされた文字列 `test` を一貫して返すイベント ハンドラーを追加してみます。
+
+```js
+$.ig.RevealSdkSettings.localizedStringsProvider = function (element, context) {
+    return "test";
+};
+```
+
+追加後、ダッシュボードは次のように表示されます。
+
+![](images/localization-test.jpg)
+
+もう少し詳しく見てみましょう。 すべてに対して `test` を返すのではなく、視覚化フィールド ラベルに対してのみ `test` を返すようにしましょう。
+
+```js
+$.ig.RevealSdkSettings.localizedStringsProvider = function (element, context) {
+    if (element.elementType === $.ig.RVLocalizationElementType.VisualizationFieldLabel) {
+        return "test";
+    }
+    return element.title ?? element.name;
+};
+```
+
+![](images/localization-test-visualization-fields.jpg)
+
+この方法を使用して、要素タイプ `DashboardFilterTitle`、`DashboardTitle`、`FieldLabel`、`VisualizationFieldLabel`、および `VisualizationTitle` のローカライズ動作をカスタマイズできます。
+
+## 例: コンボ ボックスからロケールを選択する
+
+**手順 1** - 利用可能なローカリゼーション オプションを含むコンボ ボックスをページに追加します。
+
+```html
+

+    
+    

+        English
+        Japanese
+        Spanish
+        Italian
+        French
+    

+

+```
+
+**手順 2** - `changeLang` メソッドを追加します。
+
+```js
+//function to set the language from the combobox and save it on sessionStorage
+function changeLang(lang) {
+    sessionStorage.setItem('lang', lang);
+    location.reload();
+}
+```
+
+**手順 3** - 必要な単語を含むディクショナリを作成します。
+
+```js
+//this map helps us get the index by lang
+const lang = {
+    "en": 0, "ja": 1, "es": 2, "it": 3, "fr": 4
+};
+
+//this is a map with the word we want to translate and a list of words in each language
+const dictionaryTable = {
+    "Date Filter": ["Date Filter", "日付フィルター", "Filtro de Fecha", "Filtro data", "Filtre de date"],
+    "Date": ["Date", "日にち", "Fecha", "Data", "Date"],
+    "Marketing": ["Marketing", "マーケティング", "Marketing", "Marketing", "Commercialisation"],
+    "Spend": ["Spend", "費やす", "Gastado", "Spendere", "Dépenser"],
+    "Budget": ["Budget", "バジェット", "Presupuesto", "Bilancio", "Budget"],
+    "CTR": ["CTR", "クリック率", "CTR", "CTR", "CTR"],
+    "Spend by Territory": ["Spend by Territory", "テリトリー別支出額", "Gastos por territorios", "Spese per territorio", "Dépenses par territoire"],
+    "Spend vs Budget": ["Spend vs Budget", "支出対予算", "Gasto vs Presupuesto", "Spesa vs budget", "Dépenses vs budget"],
+    "Organic Traffic": ["Organic Traffic", "オーガニックトラフィック", "Tráfico orgánico", "Traffico organico", "Trafic organique"],
+};
+```
+
+**手順 4** - ディクショナリから翻訳する関数を作成します。
+
+```js
+//function to translate, expects an RVLocalizationElement and returns a localized string
+function translate(element) {
+    const selectedLang = sessionLang.toLowerCase();
+    const elementDesc = element.title ? element.title : element.name;
+    const candidateList = dictionaryTable[elementDesc];
+    const candidate = candidateList ? candidateList[lang[selectedLang]] : undefined;
+    return candidate ? candidate : elementDesc;
+}
+```
+
+**手順 5** - `$.ig.RevealSdkSettings.localizedStringsProvider` イベントのハンドラーを追加します。
+
+```js
+$.ig.RevealSdkSettings.overrideLocale(sessionLang).then(_ => {
+    $.ig.RevealSdkSettings.localizedStringsProvider = function (element, context) {
+        return translate(element);
+    };
+})
+```
+
+**手順 6** - 残りのコードを追加してダッシュボードを読み込みます。
+
+```js
+const sessionLang = sessionStorage.getItem('lang') ?? 'en';
+
+const lang = {
+    "en": 0, "ja": 1, "es": 2, "it": 3, "fr": 4
+};
+
+const dictionaryTable = {
+    //"OriginalWord": ["English", "Japanese", "Spanish", "Italian", "French"], => example guide
+    "Date Filter": ["Date Filter", "日付フィルター", "Filtro de Fecha", "Filtro data", "Filtre de date"],
+    "Date": ["Date", "日にち", "Fecha", "Data", "Date"],
+    "Marketing": ["Marketing", "マーケティング", "Marketing", "Marketing", "Commercialisation"],
+    "Spend": ["Spend", "費やす", "Gastado", "Spendere", "Dépenser"],
+    "Budget": ["Budget", "バジェット", "Presupuesto", "Bilancio", "Budget"],
+    "CTR": ["CTR", "クリック率", "CTR", "CTR", "CTR"],
+    "Spend by Territory": ["Spend by Territory", "テリトリー別支出額", "Gastos por territorios", "Spese per territorio", "Dépenses par territoire"],
+    "Spend vs Budget": ["Spend vs Budget", "支出対予算", "Gasto vs Presupuesto", "Spesa vs budget", "Dépenses vs budget"],
+    "Organic Traffic": ["Organic Traffic", "オーガニックトラフィック", "Tráfico orgánico", "Traffico organico", "Trafic organique"],
+};
+
+//function to translate, expects an RVLocalizationElement and returns a localized string
+function translate(element) {
+    const elementDesc = element.title ? element.title : element.name;
+    const candidateList = dictionaryTable[elementDesc];
+    const candidate = candidateList ? candidateList[lang[sessionLang]] : undefined;
+    return candidate ? candidate : elementDesc;
+}
+
+//function to set the language from the combo box and save it into sessionStorage
+function changeLang(lang) {
+    sessionStorage.setItem('lang', lang)
+    location.reload();
+}
+
+// set this to your server url
+$.ig.RevealSdkSettings.setBaseUrl("https://samples.revealbi.io/upmedia-backend/reveal-api/");
+
+$.ig.RevealSdkSettings.overrideLocale(sessionLang).then(_ => {
+    $.ig.RevealSdkSettings.localizedStringsProvider = function (element, context) {
+        return translate(element);
+    };
+})
+
+$.ig.RVDashboard.loadDashboard("Marketing").then(dashboard => {
+    const revealView = new $.ig.RevealView("#revealView");
+    revealView.dashboard = dashboard;
+})
+```
+
+:::info コードの取得
+
+このサンプルのソース コードは、[GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/LocalizingDashboards) にあります。
+
+:::
\ No newline at end of file
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/logging.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/logging.md
new file mode 100644
index 00000000..12e1652c
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/logging.md
@@ -0,0 +1,17 @@
+# ログ
+
+## ASP.NET
+Reveal SDK のログを有効にするには、`"Reveal.Sdk": "Debug"` エントリを appsettings.json ファイルに追加します。
+```json title="appsettings.json"
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft": "Warning",
+      "Microsoft.Hosting.Lifetime": "Information",
+      // highlight-next-line
+      "Reveal.Sdk": "Debug"
+    }
+  },
+}
+```
\ No newline at end of file
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/maximizing-visualizations.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/maximizing-visualizations.md
new file mode 100644
index 00000000..3fc0257c
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/maximizing-visualizations.md
@@ -0,0 +1,81 @@
+# 表示形式の最大化と単一表示形式モード
+
+## 概要
+
+ダッシュボードをユーザーに表示するときに、最大化された表示形式を 1 つだけ表示したい場合があります。さらに、最初の表示形式をロックして、ユーザーがダッシュボード全体にアクセスできないようにしたい場合もあるかもしれません。Web Client SDK を使用することで、両方のシナリオを実現できます。
+
+![](images/maximize-three_divisions_dashboard_maximized.png)
+
+### サンプル詳細
+
+3 つの表示形式を持つダッシュボードがあり、それぞれの表示形式に会社の異なる部門のデータが表示されているとします。
+
+![](images/maximize-three_divisions_dashboard.png)
+
+この例では、業務アプリケーションでこれらの表示形式を使用します。これらの表示形式を各部署のホーム ページに表示される情報の一部として含めたいものとします。
+
+## 表示形式の最大化
+
+表示形式を最大化した状態でダッシュボードを開くには、__revealView__ の dashboard プロパティにダッシュボードを設定する必要があります。次に、__$.ig.RevealView__ インスタンスの __maximizedVisualization__ プロパティに、最大化する表示形式を設定します。このプロパティに表示形式を設定しないと、ダッシュボード全体が表示されます。
+
+``` js
+$.ig.RVDashboard.loadDashboard("AllDivisions", function (dashboard) {
+    var revealView = new $.ig.RevealView("#revealView");
+    revealView.dashboard = dashboard;
+    revealView.maximizedVisualization = dashboard.visualizations.getByTitle('Sales');
+});
+```
+
+最初に最大化された表示形式は Sales というタイトルの表示形式になりますが、それでもエンドユーザーはダッシュボードに戻って残りの表示形式を表示できます。
+
+## 単一表示形式モード
+
+また、最初の表示形式をロックして、常に表示形式を 1 つのみ表示するようにすることもできます。これにより、ダッシュボードは単一の視覚化ダッシュボードのように機能します。これが [単一表示形式モード] の概念です。
+
+[単一表示形式モード] をオンにするには、次のように __singleVisualizationMode__ を true に設定します。
+
+``` js
+revealView.singleVisualizationMode = true;
+```
+
+この 1 行を追加すると、ダッシュボードは単一の表示形式ダッシュボードとして機能します。各部門のホーム ページで同じことができます。`dashboard.visualizations.getByTitle()` の表示形式タイトルを適切なタイトルに置き換えるだけです。
+
+### ロックされた表示形式を動的に変更
+
+ページを再読み込みせずに、表示されている単一の表示形式を動的に変更することもできます。ユーザーの視点では、アプリは部門のリストと最大化された表示形式を備えた単一ページのアプリケーションになります。ユーザーがリストから 1 つの部門を選択すると、最大化された視覚化が更新されます。
+
+このシナリオは、以下に示すように、__$.ig.RevealView__ の **maximizedVisualization** プロパティを使用して実現できます。
+
+```html
+

+    

+        
+        
+        
+    

+    

+

+```
+
+```js
+var dashboardId = 'AllDivisions';
+
+$.ig.RVDashboard.loadDashboard(dashboardId, function (dashboard) {
+    var revealView = window.revealView = new $.ig.RevealView("#revealView");
+    revealView.singleVisualizationMode = true;
+    revealView.dashboard = dashboard;
+    revealView.maximizedVisualization = dashboard.visualizations.getByTitle('Sales');
+
+});
+
+function maximizeVisualization(title) {
+    var dashboard = window.revealView.dashboard;
+    window.revealView.maximizedVisualization = dashboard.visualizations.getByTitle(title);
+}
+```
+
+注意事項:
+  - __$.ig.RevealView__ オブジェクトは \_window.revealView\ に設定され、後で **maximizeVisualization** プロパティを設定する際に使用できるようになっています。
+  - div の前のセクションに追加されたボタンは、最大化された表示形式を切り替えるための単なる例です。実際のアプリケーションでは同様のコードを使用する必要があります。
+  - この例では、サンプル ダッシュボードが持つ表示形式と一致するようにボタンがハードコードされていますが、ダッシュボードが持つ表示形式のリストから動的に生成することもできます。
+    詳細については __$.ig.RVDashboard.visualizations__ を参照してください。
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/obfuscate-connection-data.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/obfuscate-connection-data.md
new file mode 100644
index 00000000..75f271ce
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/obfuscate-connection-data.md
@@ -0,0 +1,230 @@
+# 接続データの難読化
+
+接続データの難読化は、DB 名やホストなど、機密と見なされる可能性のある、サーバーと交換される情報をマスクするために使用されます。DataSource または DataSourceItems の情報のエンコードは、オブジェクトをクライアントに返す前にサーバー側で行われます。DataSource および DataSourceItems 情報は通常、ダッシュボードの編集時にサーバーからクライアントに送信されます。IRVObjectEncoder の実装に加えて、IRVDataSourceProvider の実装を使用してデコードを行う必要があります。データベースおよび REST プロバイダーでのみサポートされます。
+
+
+# MS SQL Server データ ソースの難読化
+
+**手順 1** - ASP.NET Web API サーバー アプリケーションで、`IRVObjectEncoder` を実装するクラスを作成します。 
+このクラスは、MS SQL Server 情報をエンコードされた値で実際に置換します。
+
+```cs
+    internal class SampleEncoder : IRVObjectEncoder
+    {
+        public Task Encode(IRVUserContext userContext, RVDashboardDataSource dataSource)
+        {
+            var sqlDs = dataSource as RVSqlServerDataSource;
+            if (sqlDs != null)
+            {
+                sqlDs = (RVSqlServerDataSource)dataSource;
+                EncodeDatasource(sqlDs);
+                return Task.FromResult((RVDashboardDataSource)sqlDs);
+            }
+            return Task.FromResult(null);
+        }
+
+        public Task Encode(IRVUserContext userContext, RVDataSourceItem dataSourceItem)
+        {
+            var sqlServerDsi = dataSourceItem as RVSqlServerDataSourceItem;
+            if (sqlServerDsi!= null)            
+            {   
+                var sqlServerDS = (RVSqlServerDataSource)sqlServerDsi.DataSource;
+                EncodeDatasource(sqlServerDS);
+                EncodeDataSourceItem(sqlServerDsi);
+                return Task.FromResult((RVDataSourceItem)sqlServerDsi);
+            }
+            return Task.FromResult((RVDataSourceItem)null);
+        }
+
+        private static void EncodeDatasource(RVSqlServerDataSource sqlServerDS)
+        {
+            sqlServerDS.Host = EncodeHost(sqlServerDS.Host);
+            sqlServerDS.Database = EncodeDatabase(sqlServerDS.Database);
+            sqlServerDS.Schema = EncodeSchema(sqlServerDS.Schema);
+
+        }
+
+        private static void EncodeDataSourceItem(RVSqlServerDataSourceItem sqlServerDsi)
+        {
+            sqlServerDsi.Database = EncodeDatabase(sqlServerDsi.Database);
+            sqlServerDsi.Table = EncodeTableName(sqlServerDsi.Table);
+            sqlServerDsi.Schema = EncodeSchema(sqlServerDsi.Schema);
+            sqlServerDsi.Id = sqlServerDsi.Database + "__" + sqlServerDsi.Schema + "__" + sqlServerDsi.Table;
+        }
+
+        private static string EncodeTableName(string name)
+        {
+            if (name == "real_table_name_1")
+            {
+                name = "Table_1";
+            }
+            else if (name == "real_table_name_2")
+            {
+                name = "Table_2"   
+            } 
+            // else etc.
+            return name;
+        }
+		
+        private static string EncodeHost(string host)
+        {
+            if (host == "real_host_name")
+            {
+                host = "Host";
+            }
+            // else etc.
+            return host;
+        }
+	
+        private static string EncodeDatabase(string database)
+        {
+            if (database == "real_database_name")
+            {
+                database = "Database";
+            }
+            // else etc.
+            return database;
+        }
+
+        private static string EncodeSchema(string schema)
+        {
+            if (schema == "real_schema")
+            {
+                schema = "Schema";
+            }
+            // else etc.
+            return schema;
+        }
+    }
+```
+
+このクラスの `Encode` メソッドは、表示形式がデータを取得するために使用する `RVDataSourceItem` を返します。
+`Encode` メソッドの引数に渡された `RVDataSourceItem` を変更して返すことにより、Datasource/DatasourceItem の機密情報を変更できます。
+
+**手順 2** - `RevealSetupBuilder.AddObjectEncoder` メソッドを使用して、作成した `IRVObjectEncoder` を `RevealSetupBuilder` に追加するよう、`Program.cs` ファイルの `AddReveal` メソッドを更新します。
+
+```cs
+.AddReveal(builder =>
+        {
+            builder
+            .AddObjectEncoder()
+			.AddSettings(settings =>
+            {
+                settings.LocalFileStoragePath = "Data";
+                settings.DataCachePath = cacheFilePath;
+                settings.CachePath = cacheFilePath;
+            });
+        });
+```
+
+**手順 3** - ASP.NET Web API サーバー アプリケーションで、`IRVDataSourceProvider` を実装するクラスを作成します。このクラスは、データベース/REST 設定の実際の置換を実行します。このクラスの `ChangeDataSourceItemAsync` メソッドは、表示形式がデータを取得するために使用する `RVDataSourceItem` を返します。`ChangeDataSourceItemAsync` メソッドで引数として提供される `RVDataSourceItem` 項目を変更することにより、データを取得するサーバーまたはテーブルを変更できます。各 `RVDataSource` を `RVSqlServerDataSource` としてキャストし、すべての `RVDataSourceItem` を `RVSqlServerDataSourceItem` としてキャストし、そのプロパティを次のように変更することにより、ダッシュボード内のすべての MS SQL Server データ ソース項目の MS SQL Server ホスト、データベース、ID、およびテーブル名を変更できます。
+
+```cs
+    internal class LocalSamplesDataSourceProvider : IRVDataSourceProvider
+    {
+        public Task ChangeDataSourceAsync(IRVUserContext userContext, RVDashboardDataSource dataSource)
+        {
+            var sqlDs = dataSource as RVSqlServerDataSource;
+            if (sqlDs != null)
+            {
+                sqlDs = (RVSqlServerDataSource)dataSource;
+                DecodeDataSource(sqlDs);
+                return Task.FromResult((RVDashboardDataSource)dataSource);
+            }
+            return Task.FromResult(null);
+        }
+
+        public Task ChangeDataSourceItemAsync(IRVUserContext userContext, string dashboardId, RVDataSourceItem dataSourceItem)
+        {
+            var sqlServerDsi = dataSourceItem as RVSqlServerDataSourceItem;
+            if (sqlServerDsi != null)
+            {
+                var sqlServerDS = (RVSqlServerDataSource)sqlServerDsi.DataSource;
+                DecodeDataSource(sqlServerDS);
+                DecodeDataSourceItem(sqlServerDsi);
+                return Task.FromResult((RVDataSourceItem)sqlServerDsi);
+            }
+            return Task.FromResult(null);
+        }
+
+        private static void DecodeDataSource(RVSqlServerDataSource sqlServerDS)
+        {
+            sqlServerDS.Host = DecodeHost(sqlServerDS.Host);
+            sqlServerDS.Database = DecodeDatabase(sqlServerDS.Database);
+            sqlServerDS.Schema = DecodeSchema(sqlServerDS.Schema);
+        }
+
+        private static void DecodeDataSourceItem(RVSqlServerDataSourceItem sqlServerDsi)
+        {
+            sqlServerDsi.Database = DecodeDatabase(sqlServerDsi.Database);
+            sqlServerDsi.Schema = DecodeSchema(sqlServerDsi.Schema);
+            sqlServerDsi.Table = DecodeTableName(sqlServerDsi.Table);
+        }
+
+        private static string DecodeTableName(string name)
+        {
+            if (name == "Table_1")
+            {
+                name = "real_table_name_1";
+            }
+            else if (name == "Table_2")
+            {
+                name = "real_table_name_2"
+            } 
+            // else etc.
+
+            return name;
+        }
+		
+        private static string DecodeHost(string host)
+        {
+            if (host == "Host")
+            {
+                host = "real_host_name";
+            }
+            // else etc.
+            return host;
+        }
+		
+        private static string DecodeSchema(string schema)
+        {
+            if (schema == "Schema")
+            {
+                schema = "real_schema";
+            }
+            // else etc.
+            return schema;
+        }
+    
+        private static string DecodeDatabase(string database)
+        {
+            if (database == "Database")
+            {
+                database = "real_database_name";
+            }
+            // else etc.
+            return database;
+        }
+    }
+```
+
+
+**手順 4** - `RevealSetupBuilder.AddDataSourceProvider` メソッドを使用して、作成した `IRVDataSourceProvider` を `RevealSetupBuilder` に追加するよう、`Program.cs` ファイルの `AddReveal` メソッドを更新します。
+
+```cs
+.AddReveal(builder =>
+    {
+        builder
+        // Registers LocalSamplesDataSourceProvider, which in step 3 decodes the previously encoded values.
+        .AddDataSourceProvider()
+        .AddObjectEncoder()
+		.AddSettings(settings =>
+            {
+                settings.LocalFileStoragePath = "Data";
+                settings.DataCachePath = cacheFilePath;
+                settings.CachePath = cacheFilePath;
+            });
+    });
+```
+
+
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/overview.md
new file mode 100644
index 00000000..172f9955
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/overview.md
@@ -0,0 +1,69 @@
+# Reveal の概要
+
+Reveal は、組み込み分析用に構築されたビジネス インテリジェンス ソリューションです。Reveal を使用すると、次のことができます:
+
+- 機能豊かなセルフ サービス ダッシュボードと最新のレポート機能を提供します。
+- あらゆる JavaScript フレームワーク (React、Angular、Vue JS、Web Components、Blazor など)、Windows Forms、または WPF アプリケーションで使用できます。
+- ブランド エクスペリエンスに合わせて UX をカスタマイズできます。
+- ほぼすべてのデータ ソースに接続して、ダッシュボードを作成することができます。
+- Java、ASP.NET、または Node.js のバックエンドを、任意のクラウド (パブリックまたはプライベート) または独自のオンプレミス サーバーに配置できます。
+
+## Reveal のアーキテクチャ
+
+Reveal には、クライアント アプリケーションへのダッシュボードの配信を可能にする 2 つのコア コンポーネントがあります。
+
+- **Reveal クライアント SDK**: Web アプリケーションに統合するための JavaScript ライブラリと CSS ファイルのセット。Reveal クライアント SDK は Web Component として出荷され、任意のクライアント アプリ (Angular、React、Blazor、Vue など) で使用できます。
+- **Reveal サーバー SDK**: サーバー アプリケーションに統合するサーバー側コンポーネント。これは現在、.NET Core、Java、および Node.js 用に出荷されています。
+
+この図は、SDK コンポーネントについて説明しています。  
+
+![reveal-high-level-architecture](images/overview-high-level-architecture.jpg)
+
+Reveal クライアントには、クライアントが要求と応答を送受信するサーバーのエンドポイントである baseUrl プロパティがあります。
+
+クライアント アプリは、アプリケーションでダッシュボードを描画するために使用される RevealView オブジェクトを作成します。また、既存のダッシュボードを編集したり、新しいダッシュボードを新規に作成したりすることもできます。RevealView には、ユーザーのダッシュボード エクスペリエンスの中心となる[プロパティとイベント](https://help.revealbi.io/api/javascript/latest/classes/revealview.html)があります。メニューの表示と非表示を切り替えたり、チャートのツールチップを有効または無効にしたり、ダッシュボード フィルターを追加または削除したりなどのプロパティを設定できます。 
+
+RevealView オブジェクトは、ダッシュボードまたは資格情報の保存を扱いません。ダッシュボードの定義を含むバイナリ コンテンツ (ZIP ファイル形式の .rdash ファイル) は、サーバー アプリによって http リクエストで提供されます。サーバー アプリは、Reveal SDK の既定の保存/読み込みエクスペリエンスを使用するか、ダッシュボードの読み込みと保存の方法をオーバーライドすることができます。
+
+## Reveal でのデータ ソースのサポート
+
+Reveal SDK は、分析ツール、コンテンツ マネージャー、クラウド サービス、CRM、データベース、スプレッドシート、公開データ ソースなど、30 を超えるデータ ソースをサポートしています。データ ソースは、ダッシュボードのどこからデータが取得されるかを定義します。各データ ソースには、接続文字列、ユーザー ID、パスワードなど、データに接続してデータを取得するためにコードで設定した固有のプロパティがあります。
+
+Reveal SDK には、データ ソースに関して 2 つの概念があります。
+
+- データ ソース - これはデータの主要なソースです。たとえば、SQL Server をデータ ソースにすることができます。
+- データ ソース項目 - これは、データ ソースから利用できる特定の項目です。例えば、SQL Server の特定のテーブルなどです。
+
+サポートされているデータ ソースのリストは、この[ヘルプ トピック](datasources.md)で確認できます。
+
+
+## 資格情報とセキュリティ
+
+Reveal はデータを保存せず、資格情報も保存しません。認証を必要とするデータベースまたはその他のデータ ソースからデータを要求する場合、アプリケーション コードは、構成ファイルからデータを読み込むか、安全なストレージに格納することにより、資格情報管理を処理します。Reveal は、これらの資格情報の保存と処理を開発者による実装に委任します。
+
+認証および承認 API について説明する 2 つのヘルプ トピックがあります。
+-	[認証](authentication.md) – ユーザー名とパスワード、および、ベアラー トークン、の両方の認証資格情報について、データ ソースで使用する方法を示します。
+-	[ユーザー資格情報](user-context.md) – アプリケーションの認証済みユーザーの ID を取得し、その情報をカスタム クエリに送信する方法を示します。
+
+たとえば、SQL Server データベースのデータを使用する表示形式の資格情報を解決するには、次のようなコードを使用して接続の詳細を設定します。これらの詳細がどこに保存され、どのように取得されるかは、実装されたサーバー コードによります。
+
+```c#
+public class AuthenticationProvider: IRVAuthenticationProvider
+{
+    public Task ResolveCredentialsAsync(IRVUserContext userContext, RVDashboardDataSource dataSource)
+    {
+        IRVDataSourceCredential userCredential = null;
+        if (dataSource is RVSqlServerDataSource)
+        {
+            userCredential = new RVUsernamePasswordDataSourceCredential("sqlserveruser", "password");
+        }
+        return Task.FromResult(userCredential);
+    }
+}
+```
+
+## 配置
+
+Reveal SDK を含むアプリケーションには、配置に関する制限はありません。Reveal SDK サーバー側コンポーネントは、既存のアプリケーションまたは新しいアプリケーションに組み込む一連のライブラリ (Windows、Mac OS、および Linux のいずれかで .NET Framework、Java、および Node.js をサポート) であるためです。Reveal サーバー側コンポーネントはアプリケーションのコンテキストに統合されるため、AWS、Microsoft Azure、Google Cloud などのクラウド プロバイダー、または独自のオンプレミス サーバーへの配置が可能です。
+
+Reveal SDK は、SDK コンポーネントの複数のインスタンスが同時に実行される可能性があるマルチテナント アプリケーションに配置することもでき、それぞれがキャッシュ ストレージ、資格情報管理、ダッシュボード処理などの独自のリソースで構成されます。
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/release-notes.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/release-notes.md
new file mode 100644
index 00000000..8d8be143
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/release-notes.md
@@ -0,0 +1,1630 @@
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# リリース ノート
+
+## 1.8.4 (Mar 5th, 2026)
+
+### New Features
+
+#### All Platforms
+
+- New data source: MariaDB.
+- Redshift now supports stored procedures.
+- KPI visualizations now support conditional formatting.
+- Added "Between" and "Not Between" number comparison operators for conditional formatting.
+- Keyboard accessibility improvements in View Mode for grid and pivot visualizations.
+- Localization now uses the user's language preference instead of the server locale. This affects labels such as "Grand Total" in Excel export, and "Previous" and "Current" in KPI visualizations.
+- Elasticsearch now supports parameterized queries.
+- MySQL now supports timezone conversion.
+- Added a "Remove" button to the visualization editor fields list.
+- Added a search box to the visualization type selection dialog.
+- Added an `onFilterValueChanged` event to the RevealView. The event fires when the user uses the filtering UI or API to modify the selection of a filter.
+
+```javascript
+revealView.onFilterValueChanged = (args) => {
+    console.log("Filter:", args.filter);
+    console.log("Source:", args.source.title);
+    console.log("Old value:", args.oldValue);
+    console.log("New value:", args.newValue);
+};
+```
+
+### Bugs
+
+#### All Platforms
+
+- The "Null or empty" filter option text is now localized.
+- Switching visualizations quickly when using statistical functions could lose the original baseline.
+- MongoDB blending regression.
+- Cache not working in some scenarios for NodeJS and Java SDKs.
+- Pivot Excel export headers missing when grand totals are visible.
+- Dashboard filter refresh rate ignoring the metadata screen expiration setting.
+- Stacked chart y-axis range only using first value field's range.
+- Combination chart: changing the display order alters the y-axis range.
+- Local evaluation of "not equals" operators incorrect.
+- ScatterMap null reference exception when reloading data.
+- Date range generation for quarter-based rules incorrect on web.
+- SSAS hierarchical filters not working correctly.
+- MySQL error when the database name includes a hyphen.
+- Field search box not showing up in the visualization editor.
+- Dashboard filter binding issues.
+- Auto connect filters issues.
+- Headless export inconsistencies with deferred rendering.
+- Maximized visualization sizing and loading incorrect when dashboard has global filters.
+- Multiple visualization editors could appear simultaneously in the dashboard layout.
+- Show data labels setting not applied in Excel export.
+- Data source icon not displaying for some data sources.
+- Maximized visualization state incorrectly reported after minimizing.
+- Headless export null pointer when the server returns 4xx or 5xx errors.
+- Exporting a dashboard containing text widget could fail.
+- Null values not treated as the smallest value when sorting.
+- Azure Analysis Services could cause a null reference when global filters are present.
+
+#### Java
+
+- Headless export crash when exporting a grid visualization.
+
+## 1.8.3 (2026 年 1 月 9 日)
+
+### 新機能
+
+#### すべてのプラットフォーム
+
+- 条件付き書式の形状選択ポップアップが改善され、クリア オプションが含まれるようになりました。
+- 新しい円チャートとドーナツ チャートが一般利用可能になりました。この更新された円チャートとドーナツ チャートは、以前の円チャートとドーナツ チャートの表示形式を置き換えます。
+- ヘッドレス エクスポートが最適化され、より信頼性が高く、わずかに高速になりました。
+- SQL Server では、計算フィールドを作成するときに `ISEMPTY` 関数がサポートされるようになりました。
+- onUrlLinkRequested イベントで null が返されると、ナビゲーションがキャンセルされるようになりました。
+- 大きい数値の形式がローカライズされるようになりました。
+- ダッシュボード フィールド フィルター値のフィールドとは異なるフィールドをダッシュボード フィルターのラベルに使用できるように UX が改善されました。
+- Elasticsearch にいくつかの改善が加えられました: `FORMATDATE` 関数のサポートの追加、`LOG` 関数 (単一パラメーター呼び出し) の問題の修正、`FYEAR` (会計年度) 関数の問題の修正、SQL インジェクション攻撃を防ぐための改善。
+- データ ソース アイコンを非表示にしたり変更したりできるようになりました。
+
+```js
+revealView.onAssetRequested = (args) => {
+    // Use default
+    return null;
+    
+    // Hide icon
+    return { visible: false };
+    
+    // Custom icon
+    return { imageUrl: "./images/custom.jpg" };
+
+    // Conditional
+    if (args.dataSource instanceof RVSqlServerDataSource) {
+        return { imageUrl: "./images/sqlserver.jpg" };
+    }
+};
+```
+
+- 定義済みの計算フィールドのサポートが追加されました。
+
+```csharp
+//Registration
+mvcBuilder.AddReveal(builder =>
+{
+    builder.AddDataModelProvider();
+});
+
+//Implementation example
+
+internal class MyDataModelProvider : IRVDataModelProvider
+{
+    private static readonly List calculatedFields;
+
+    static MyDataModelProvider()
+    {
+        calculatedFields = new List {
+            new RVDataModelCalculatedField("GrossAmount", "Gross Amount", RVDashboardDataType.Numeric, "[UnitPrice] * [Quantity]"),
+            new RVDataModelCalculatedField("DiscountAmount", "Discount Amount", RVDashboardDataType.Numeric, "[GrossAmount] * [Discount]"),
+            new RVDataModelCalculatedField("NetAmount", "Net Amount", RVDashboardDataType.Numeric, "[GrossAmount] * [Discount]")
+        };
+    }
+
+    public Task> GetCalculatedFieldsAsync(RVDataSourceItem dsItem, IRequestContext userContext)
+    {
+        if (dsItem.Title == "Order Details")
+            return Task.FromResult(calculatedFields);
+        else
+            return Task.FromResult>(null);
+    }
+
+    public Task> GetMeasuresAsync(RVDataSourceItem dsItem, IRequestContext userContext)
+    {
+        if (dsItem.Title == "Order Details")
+            return Task.FromResult(new List {
+                new RVDataModelMeasure("Total Revenue", "sum([NetAmount])", "Total Revenue (net)"),
+                new RVDataModelMeasure("ASP", "sum([NetAmount]) / SUM([Quantity])", "Revenue-weighted price per unit")
+            });
+        else
+            return Task.FromResult>(null);
+    }
+
+    public Task> EditSchemaAsync(RVDataSourceItem dsItem, List baseSchema, IRequestContext requestContext)
+    {
+        if (dsItem.Title == "Order Details")
+        {
+            baseSchema.FirstOrDefault(f => f.Name == "Discount").DefaultAggregation = RVDashboardAggregationType.CountDistinct;
+            return Task.FromResult(baseSchema);
+        }
+        else
+        {
+            return Task.FromResult>(null);
+        }
+    }
+}
+```
+
+- MongoDB で `ENDOFMONTH` 関数がサポートされるようになりました。
+
+### バグ修正
+
+#### すべてのプラットフォーム
+
+- TypeScript で RedisCacheOptions の型定義が不足している問題。
+- パーセンテージベースのチャートに大きい数値の書式設定が正しく適用されない問題。
+- Elasticsearch でインデックス プレビュー時にエラーが発生する問題。
+- MySQL ストアド プロシージャ パラメーターがフィルター バインディング オプションとして表示されない問題。
+- onFiltersChanged イベントがインタラクティブ フィルタリングに対して発生するが、selectedValues プロパティが更新されない問題。
+- KPI 表示形式が最小化モードでラベルと重なる場合がある問題。
+- Google Analytics で一部のメジャーの集計が正しくない問題。
+- Google Analytics で日付階層を使用すると、誤ったメトリック値が表示される問題。
+- [データ ラベルを表示] をオフにしてもラベルが非表示にならない問題。
+- マップ表示形式を含むヘッドレス エクスポートが失敗する問題。
+- `RevealSdkSettings.FormattingProvider` が定義されている場合、大きい数値の書式設定が正しく機能しない問題。
+- Analysis Services でカスタム日付範囲が機能しない問題。
+- 凡例を下部に設定すると円チャートとドーナツ チャートが消える問題。
+- ARM アーキテクチャの macOS でアクセスすると Analysis Services がクラッシュする問題。
+- テーマのカスタム フォントが使用されない問題。
+- カスタム テーマが Reveal のデフォルトに置き換えられる問題。
+- クエリ結果から null 日付を読み取ると MySQL エラーが発生する問題。
+- カスタム表示形式にフィールドのラベルが含まれない問題。
+- 散布図の表示形式で、インタラクティブ フィルタリングのツールチップに誤ったテキストが表示される問題。
+
+#### Java
+
+- 数値フィルターが整数ではなく小数を送信する問題。
+
+## 1.8.2 (2025 年 11 月 11 日)
+
+これは、Redis Cache サポートの重大な問題を修正し、Node.js の TypeScript サポートを追加する重要なパッチリリースです。**Redis Cache (1.8.1 で導入) を使用している場合は、このバージョンにアップグレードする必要があります。**
+
+### バグ修正
+
+#### すべてのプラットフォーム
+
+- 構成された Redis Cache が正しく機能しない重大なバグを修正しました。
+
+#### Node
+
+- 開発エクスペリエンスと型安全性を向上させるための TypeScript 型定義を追加しました。
+
+## 1.8.1 (2025 年 11 月 5 日)
+
+### 新機能
+
+#### すべてのプラットフォーム
+
+- 条件付き書式が強化され、ルールとスタイルを構成できるようになりました。現在サポートされている表示形式は、グリッド、ピボット、テキスト ビュー、棒チャートと柱状チャートです。
+- 新しいデータ ソース: Elasticsearch。
+- 新しいキャッシュ プロバイダー: Redis。
+
+Java:
+
+```java
+initializeParameterBuilder.enableRedisCache((options) -> {
+    options.setConnectionString("localhost:6379");
+});
+```
+
+ASP.NET:
+```csharp
+builder.AddRedisCache((options) => {
+    options.ConnectionString = "localhost:6379";
+});
+```
+
+Node:
+
+```ts
+const revealOptions = {
+        ...
+	redisOptions: { connectionString: "localhost:6379" }
+}
+```
+
+- 複数の日付ダッシュボード フィルターが一般利用可能になりました。
+- RevealView の `showCancel` プロパティを設定すると、ダッシュボードの編集時にキャンセル ボタンをプログラムで非表示にすることができます。
+- RevealSdkSettings で `theme` プロパティが設定されると、RevealView の外観が自動的に更新されるようになりました。
+- MongoDB プロバイダーはグリッド ページングをサポートするようになりました。
+- Snowflake プロバイダーはグリッド ページングをサポートするようになりました。
+- RevealView の `exitEditMode` は、編集モードを終了したかどうかを示すブール値を返すようになりました。
+- SQL Server の EMPTY 関数のサポートが追加されました。
+- ページングをサポートするデータ ソースでデータ ブレンドを使用する際のグリッド ページングのサポートが追加されました。
+- CSV のエクスポートのサポートが追加されました。
+- 読み取り専用フィルターのサポートが追加されました。
+- ダッシュボード フィルターを非表示にするサポートが追加されました。
+- 表示形式エディターの [設定] タブからラジアル線軸の範囲をカスタマイズするためのサポートが追加されました。
+- フィルター ダイアログの [フィールドの選択] ポップアップに、フィールドの上にストアド プロシージャがリストされるようになりました。
+
+
+#### Java
+
+- JTDS ドライバーは mssql-jdbc (v12.10.1.jre11) に置き換えられました。
+- RVJDBCPropertiesCredentials は使用されなくなり、削除されました。
+
+### バグ修正
+
+#### すべてのプラットフォー
+
+- Pivot テーブルで数値フィールドを並べ替えるとクラッシュする問題。
+- Excel エクスポート時、タイトルにダッシュを含む列ヘッダーの問題。
+- ダッシュボード編集中、`PRE` 要素が HTML body に直接追加される問題。
+- 棒と柱状チャートで軸ラベルが重複表示される問題。
+- RVDashboard の `onDateFilterChanged` が常に最初の日付フィルターを報告する問題。
+- ブレンディング列追加時にグリッド ページングが無効になる問題。
+- 表示形式エディターにデータ切り捨てインジケーターが表示されない問題。
+- ブラウザーがバックグラウンド時にチャートが消える場合がある問題。
+- カスタム表示形式使用時にダッシュボードをスクロールできない問題。
+- REST データ ソースでデータ フィルター展開時 "Invalid DateTime" エラーが発生する問題。
+- RevealView の `onVisualizationEditorClosing` イベントでイベント キャンセル時に例外が発生する問題。
+- `onUrlLinkRequested` イベントが 「Visualization Maximized」 のダッシュボード リンク  トリガーで呼ばれない問題。
+- フィルターに 3000 を超える項目がある場合、フィルタリング後に値の選択解除が機能しない問題。
+- 時系列軸ラベルが設定した日付表示形式に従わない問題。
+- 日付フィルターを接続した表示形式のダッシュボード リンクが開かない問題。
+- データ更新後にフィルター値が更新されない問題。
+- Analysis Server プロバイダーが日付を日付ディメンションとして表示しない問題。
+- フィールドの書式設定タイプを通貨に変更した際、通貨記号ドロップダウンが表示されない問題。
+- 散布図の表示形式保存または更新時にズームがリセットされる問題。
+- API でダッシュボード日付フィルター ルールを 「すべての期間」 に設定した場合にデータが表示されない問題。
+
+#### Java
+
+- ヘッドレス エクスポートがブラウザー クライアントのロケールではなく OS ロケールを使用する問題。
+
+## 1.8.0 (2025 年 9 月 3 日)
+
+### 重大な変更
+
+- .NET 6 のサポートは削除されました。
+
+### 新機能
+
+#### すべてのプラットフォーム
+
+- Snowflake のキーペア認証に対応しました。
+- Snowflake のストアド プロシージャに対応しました。
+- 依存関係 `Snowflake.Data` が v4.8.0 に更新されました。
+- SQL Server のストアド プロシージャ呼び出し時に、手動のステートメント構築ではなくコマンド パラメーターを使用するようになりました。
+- Node で使用されるネイティブ バイナリが .NET 8 に更新されました。
+- Redshift がグリッド行のページングに対応しました。
+
+### バグ修正
+
+#### すべてのプラットフォーム
+
+- データが存在しない状態で「並べ替え条件」ラベルでフィールドを選択すると、「Index was outside the bounds of the array. (インデックスが配列の範囲外です)」というエラーが発生する問題を修正しました。
+- エクスポート ボタンをクリックした後にローディング スピナーが表示されず、複数回クリックできてしまう問題。
+- Chrome のデバイス ツールバー使用時にスクロールすると RevealView が応答しなくなる問題。
+- 複数フィールドで値による並べ替える際にピボット展開が壊れる問題。
+- ヘッドレス エクスポート時の `VisualizationOptions.ShowFilters` に関連する問題。
+- コンテンツに改行が含まれる場合、表示形式の説明が表示されない問題。
+- Amazon Athena でグリッドのページングが動作しない問題。
+- REST データ ソース使用時にダッシュボード フィルターがカスケードしない問題。
+- MongoDB の計算フィールドで日付に数値を加算・減算すると誤った結果になる問題。
+- フィルター選択後に折れ線チャートがデータを表示しない問題。
+- MySQL がストアド プロシージャおよびそのパラメーターを重複して生成する問題。
+- ダッシュボードに日付の表示形式フィルターが含まれると、ヘッドレス エクスポートでコンソール エラーが表示される問題。
+- ダッシュボードを Excel にエクスポートした際、部分的に不正な .xslx ファイルが生成され、開く前に修復が必要となる場合がある問題。
+- グローバル フィルターで「複数」かつ「必須」を設定し「すべて」を選択した場合に、最初のオプションのみが選択される問題。
+- 積層型縦棒でズームイン・ズームアウト時にゴースト効果が発生する問題。
+- ヘッドレス エクスポートが設定されたエクスポート言語を使用しない問題。
+- 会計年度・学期・四半期を扱う場合に、ドリルダウン/ドリルアップのナビゲーション パス ラベルに不整合が発生する問題。
+- コンテンツに改行が含まれる場合、ダッシュボードの説明が表示されない問題。
+
+#### ASP.NET
+
+- `ImageExportOptions` コンストラクターに `InitScript` が含まれていない問題。
+- `ExportOptions` コンストラクターに `IncludeFiltersSummaryPage` が含まれていない問題。
+
+#### Node
+
+- MacOS ARM64 でパッケージ インストール時に x64 ネイティブ バイナリがダウンロードされる問題。
+
+## 1.7.6 (2025 年 7 月 22 日)
+
+重大なバグを修正した緊急パッチ リリース。
+
+### バグ修正
+- データが存在しない状態で「並べ替え条件」ラベルでフィールドを選択すると、「Index was outside the bounds of the array. (インデックスが配列の範囲外です。)」というエラーが発生する問題を修正しました。
+- `ERROR TypeError: $.ig.SdkDashboardDocument.fromJson is not a function` というエラーによりサムネイルが正しく表示されない不具合を修正しました。
+
+## 1.7.5 (2025 年 7 月 8 日)
+
+### 新機能
+
+#### すべてのプラットフォーム
+
+- Databricks は現在、個人アクセス トークン、OAuth トークン パススルー、OAuth クライアント資格情報、Microsoft Entra ID クライアント資格情報などの認証タイプをサポートするようになりました。
+- Reveal はネイティブ JS プロトタイプ (Array など) を拡張しなくなりました。
+- 日付フィルターがダッシュボードの `filters` コレクションに含まれるようになりました。
+- `weekLevelEnabled` を `true` に設定することにより、`onFieldsInitializing` を通じてフィールドにオプトインの週の日付集計が追加されました。
+
+```js
+revealView.onFieldsInitializing = function (args) {
+    args.fields.forEach(f => {
+    if (f.type == $.ig.RVDashboardDataType.Date || f.type == $.ig.RVDashboardDataType.DateTime) {
+        f.weekLevelEnabled = true;
+    }});
+};
+```
+- 編集モードに入ると、強調表示フィルターが削除されるようになりました。
+- 依存関係 ANTLR が v4.13.1 に更新されました。
+- Redshift コネクターは、同じ AWS クラスターに含まれるデータベースのクロス データベース ブレンディングをサポートするようになりました。
+- 既存の日付ダッシュボード フィルターのルールと範囲のプロパティを API 経由で設定できるようになりました。
+
+```js
+revealView.dashboard.filters[0].rule = new $.ig.RVDateRule($.ig.RVPeriodRelation.Last, 2, $.ig.RVPeriodType.Day);
+//-or-
+revealView.dashboard.filters[0].range = new $.ig.RVDateRange(new Date(2023, 0, 1), new Date(2023, 11, 31));
+```
+
+- 複数の日付ダッシュボード フィルターのサポートがベータ機能として追加されました。
+- `RVDashboard.dateFilter` は非推奨です。互換性のため当面は残されていますが、存在する場合は最初の `DateDashboardFilter` を参照します。
+
+#### Java
+
+- 依存関係 ANTLR が v4.13.2 に更新されました。
+- 依存関係 okhttp が v4.12.0 に更新されました。
+
+#### Node
+
+- ヘッドレス Excel エクスポートでフィルターと日付フィルターがサポートされるようになりました。
+- Puppeteer が Chrome を別の場所に展開するようになったため、nodemon を使用している場合は該当ディレクトリを除外するよう設定を更新してください。
+
+```json
+"nodemonConfig": {
+  "ignore": ["chrome-headless*/*"]
+}
+```
+
+### バグ修正
+
+#### すべてのプラットフォーム
+
+- ヘッドレス エクスポート時に JS ファイルが不足していることによるコンソール エラー。
+- 複製されたテキスト ボックスで説明文が消えます。
+- ダッシュボードにテキスト ボックスの表示形式が含まれていると、ヘッドレス エクスポートが失敗します。
+- ドリルダウンを解除すると強調表示が失われる問題 (フィルターは維持されている)。
+- 強調表示のフィルター設定により、他のチャートに 1 日余分に表示される問題。
+- 強調表示がエクスポート時に正しく表示されない問題。
+- 表示形式エディターに強調表示フィルターが表示される問題。
+- 「次の」期間関係を持つ DateRules では、2日以上の場合に正しい日数を表示しない問題。
+- 棒と柱状チャートの表示形式では、最初の読み込み時にプロット領域が適切に使用されない問題。
+- 日時フィルターのメニューに AllTime をカスタム項目として追加すると、メニュー項目が重複して表示される問題。
+- 散布図の表示形式を使用すると、マップの中心が移動する問題。
+- 複数のグリッドの表示形式を含む Excel エクスポート時にダイアログが重複表示される問題。
+- 階級区分図では、「アメリカ合衆国の州」マップを使用する時、州の扱いが正しくない問題。
+- ピボット表示形式にてツールチップ フィルターを適用後に null 参照例外が発生する問題。
+- グリッド表示形式で表示形式タイプを変更すると、表示形式が消えコンソール エラーが発生する問題。
+- カテゴリー フィールドでのダッシュボード リンク パラメーターが機能しない問題。
+- 範囲が設定されていない CustomRange フィルターを含むダッシュボードを開くと null 参照エラーが発生する問題。
+- 階層が定義されていない単一の日付フィールドでもドリルダウンが可能になる問題。
+- ドリルアップ/ドリルダウン時に日付形式が失われる問題。
+- ツールチップのフィールド項目がフィールド ラベルを使用しない問題。
+- フィルター ラベルに含まれる日本語がヘッドレス エクスポートによる PDF ファイルで文字化けする問題。
+- 新規作成した円チャートが PDF に正しくエクスポートされない問題。
+- グリッド ページングではデータが 2 回読み込まれる問題。
+- 長い凡例が正しく表示されない問題。
+- 「現在までの …」フィルターを使用してピボットを展開すると、間違ったデータが表示される問題。
+- 日付範囲フィルター「過去 12 か月」には現在の月のデータが含まれる問題。
+- モバイル表示でフィルターの不透明度が通常サイズよりも濃く表示される問題。
+- 他のピボット行が存在する場合、展開機能が正常に動作しない問題。
+- 項目が重複している場合、アドホック ピボット展開機能が正しく動作しない問題。
+- 空の要素でドリルダウンを実行するとクラッシュが発生する問題。
+- 展開済みのピボット行に対するドリルダウンが正しく動作しない問題。
+- API を使用して日付グローバル フィルターの範囲を設定しても、UI が更新されない問題。
+- 日付フィルターを変更した後、視覚化を更新するには更新が必要です。
+- Excel データ ソースで日付列が数値として検出される問題。
+- 生データ画像のエクスポート時にクラッシュが発生する問題。
+- API を使用して作成直後の日付グローバル フィルターを変更しても UI が更新されない問題。
+
+## 1.7.4 (2025 年 5 月 6 日)
+
+### 新機能
+
+#### すべてのプラットフォーム
+
+- 新しいデータ ソース: Databricks。
+- フィールド エディターが改善され、オプション カテゴリごとのタブが追加されました。
+- ベータ機能 API が追加されました。
+
+```js
+// Enable beta feature
+$.ig.RevealSdkSettings.betaFeatures.enable("newDonutChart", "newPieChart");
+
+// Disable beta feature
+$.ig.RevealSdkSettings.betaFeatures.disable("newDonutChart", "newPieChart");
+```
+
+- チャート ツールバーが正式リリースされました。RevealView の `showToolbar` プロパティを通じて有効または無効にできます。このプロパティのデフォルト値は `false` です。
+- インタラクティブなフィルタリングが正式リリースされました。この機能を有効にするには、RevealView で `interactiveFilteringEnabled` を `true` に設定します。ツールチップの 「Filter By」 をクリックすると、この機能によって他のチャートのデータが強調表示されます。
+- 表示されるパーセンテージの小数桁を構成するための新しいプロパティがスライス チャートの表示形式エディターに追加されました。
+- `database` プロパティを含むデータ ソースでは、そこから派生したデータ ソース項目には、デフォルトで `database` プロパティが設定されなくなりました。これにより、RVDataSourceItem の `database` プロパティを設定することが必須ではなくなりますが、セキュリティ上の理由から、null に設定する場合でも明示的に設定することを強くお勧めします。
+- RVAmazonWebServicesCredentials にオプションの `sessionToken` パラメーターのサポートが追加されました。
+
+#### Node
+
+- `dashboardProvider` と `dashboardStorageProvider` は、ストリームに `Readable` 型定義のストリームを使用するようになりました。これにより、ファイルよりも多くの場所をサポートできるようになります。
+
+### バグ修正
+
+#### すべてのプラットフォーム
+
+- 単一の表示形式モードを使用すると、UI 要素の位置がずれて表示されます。
+- エディターで可視化フィルターを変更しても反映されません。
+- いくつかの数値変換によりクラッシュが発生します。
+- ヘッドレス エクスポートでは、`PREVIOUS_YEAR` フィルターの設定は機能しません。
+- ダッシュボードにエラーのある表示形式がある場合、Excel エクスポートは失敗します。
+- 年と四半期の階層のダッシュボード リンクで計算された日付範囲が間違っています。
+- 展開またはドリルダウンし、会計年度の日付フィールドにフィルターを適用すると、誤ったデータが表示されます。
+- 前の数値が負の場合、KPI vs Time の % の増加の符号が正しくありません。
+- ヘッドレス エクスポートでは、PDF をターゲットにする場合、各表示形式のグローバル フィルターと表示形式フィルターが欠落します。
+- 一部の表示形式では SSAS のパフォーマンスが低下します。
+- `NotEquals` および `NotContains` フィルターは SSAS では機能しません。
+- ヘッドレス エクスポートでは日付フィルターが「 Unnamed 」として表示されます。
+- インターフェイス `IRVDateFilterMenuItem` は、「infragistics.reveal.d.ts」 ファイルの RevealApi 名前空間の一部ではありません。
+- PowerPoint エクスポートではトークンと Luis の名前が表示されています。
+- Google Analytics や同様のデータ ソースを使用した日付の強調表示が機能しません。
+- ツールチップに合計を表示するフラグは無視されます。
+- 必要なプロパティが設定されていない場合、Google Analytics のデータ ソース選択がクラッシュします。
+- 棒チャート またはスライス チャートの表示形式で、計算フィールドの値に Infinity が含まれると 「value.toFixed is not a function (value.toFixed は関数ではありません)」 というエラーが発生します。
+- 表示形式の説明がタイトルと重複しています。
+- 数値 0 のセルを含む Excel エクスポートは空として表示されます。
+
+#### Java
+
+- マップビ表示形式を使用して表示形式をエクスポートするときに、黄色の 「configure」 バナーが表示されます。
+
+## 1.7.3 (2025 年 3 月 4 日)
+
+### 新機能
+
+#### すべてのプラットフォーム
+
+- 軸タイトルは現在一般提供されており、エディターの表示形式フィールドをクリックして専用のテキスト ボックスからカスタマイズできます。
+- 固定線が一般利用可能になりました。
+- 数値軸を含むチャートの表示形式が強化され、ラベルの重複の可能性が減りました。
+- チャートの凡例を表示形式の上部または下部に配置できるようになり、さらに左、右、または中央にカスタマイズできるようになりました。これらのオプションは、表示形式エディターの [設定] タブにあります。
+- グリッド ページングでは、列ヘッダーにある並べ替えアイコンを使用した並べ替えがサポートされるようになりました。
+- 列の表示形式ではラベルが列の上に表示されるようになり、棒の表示形式ではラベルが棒の右側に表示されるようになります。
+- 表示形式におけるラベルの非表示と表示がさらに強化されました。
+- `revealView.onDateFilterMenuOpening` の `args.items` プロパティは、`IRVDateFilterMenuItem` オブジェクトの配列を使用するようになりました。
+
+```js
+revealView.onDateFilterMenuOpening = function(args)
+{
+    var list = args.items; //List of IRVDateFilterMenuItem objects
+    var pos, newItem;
+
+    //Add "Last 2 months" to the months section
+    pos = list.findIndex(obj => obj.title === "Month to date"); //Last item in the months section
+    var lastTwoMonthsRule = new $.ig.RVDateRule($.ig.RVPeriodRelation.Last, 2, $.ig.RVPeriodType.Month);
+    newItem = new $.ig.RVDateFilterMenuOption(lastTwoMonthsRule);
+    list.splice(pos + 1, 0, newItem);
+
+    //Remove the "Today" option
+    pos = list.findIndex(obj => obj.title === "Today");
+    list.splice(pos, 1);
+
+    //Add "First week of 2024" to a new section at the end of the menu
+    list.push(new $.ig.RVDateFilterMenuSeparator()); //Add section separator
+    var firstWeek24Range = new $.ig.RVDateRange(new Date("2024-01-01"), new Date("2024-01-31"));
+    newItem = new $.ig.RVDateFilterMenuOption(firstWeek24Range, "First week of 2024")
+    list.push(newItem);
+};
+```
+
+#### Node
+
+- 依存関係 `puppeteer-core` が `14.1.2` から `24.1.1` に更新されました。
+
+### バグ修正
+
+#### すべてのプラットフォーム
+
+- `RevealView` の `serialize` プロパティは、実際にはバイト配列を返す問題。
+- ヘッダー、タイトル、フィルターを非表示にした場合、単一の表示形式モードでチャートの上部に空白スペースが表示される問題。
+- `RVIntegratedAuthenticationCredential` を使用するとエラーが発生する問題。
+- `showHeaders` が `false` に設定されている場合、最大化後に表示形式フィルターが非表示になる問題。
+- Analysis Services は、一部のロケール/カルチャでは間違った値を返す問題。
+- ダッシュボード フィルターの 「値の選択」 を選択するとクラッシュする問題。
+- パーセンテージと列を使用した条件付き書式が機能しない問題。
+- `ChangeDataSourceItemAsync` のデータ ソース ID が正しくない問題。
+- ヘッドレス エクスポートで作成された PDF ファイルで日本語が文字化けする問題。
+- エクスポートされた PDF ファイルでは日本語の日付形式が正しくない問題。
+- ヘッドレス エクスポートで作成された PDF ファイルのダッシュボードタイトルに、不要な番号 「(1)」 が表示される問題。
+- ダッシュボード/表示形式フィルターの日付形式が日本語では正しくない問題。
+- ダッシュボード フィルターは、接続されていない場合でも、最大化されるとすべての表示形式に表示される問題。
+- 表示形式を最大化するとフィルターは消える問題。
+- 積層型棒チャートではカテゴリ ラベルが逆の順序で表示される問題。
+- API 経由でダッシュボードの日付フィルターに `DateRule` を設定するときにエラーが発生する問題。
+- XMLA 表示形式のメニューから表示形式フィルターに `DateRule` を設定するときにエラーが発生する問題。
+- 複合の表示形式を作成または読み込むときにクラッシュします。
+- グリッドからダッシュボードの日付フィルターへのダッシュボードのリンクが機能しない問題。
+- エクスポート関連のエンドポイントのコンテンツ タイプ応答ヘッダーがない問題。
+- インタラクティブ エクスポートの例外がユーザーに通知されない問題。
+- データ切り捨てインジケーターの配置が間違っている問題。
+- ダッシュボード フィルターを使用した Analysis Services では、Excel へのエクスポートが失敗する問題。
+- (ベータ版) ツールバーのアイコンの位置がずれている問題。
+- (ベータ版) ツールバーのボタンでは、アクションを実行するためにダブルクリックする必要がある問題。
+
+#### Java
+
+- 午後の時間帯に REST データ ソースから日付フィールドをクエリすると、時間コンポーネントには正午が表示される問題。
+
+## 1.7.2 (2025 年 1 月 20 日)
+
+### 新機能
+
+#### すべてのプラットフォーム
+
+- (ベータ版) `onMenuOpening` を使用してツールバーのカスタム メニュー項目のサポートが追加されました。
+- (ベータ版) 同じ表示形式内でフィルタリングされたデータを比較できます。インタラクティブ フィルタリングが強化され、XMLA データ ソースがサポートされるようになりました。複数の表示形式がある場合に、「フィルター条件」オプションが表示されるようになりました。さらに、階級区分図では選択した国が強調表示されます。フィルターが追加されると、変更を防ぐために読み取り専用になります。日付によるフィルタリングも可能になりましたが、選択できる日付値は 1 つに制限されています。
+- (ベータ版) 表示形式エディターの設定ペインで、軸タイトルを「なし」、「X 軸」、「Y 軸」、または「両方」のオプションで制御できるようになりました。この機能を有効にするには、`$.ig.RevealSdkSettings.enableBetaFeatures` を `true` に設定します。
+- PostgreSQL データ プロバイダーは、マテリアライズド ビューをサポートするようになりました。
+- BigQuery データ プロバイダーはデータ ブレンディングをサポートするようになりました。
+- ドーナツ型チャートの表示形式では、ラベルなし、ラベルのみ、値のみ、ラベルと値の両方、といった中央ラベル モードがサポートされるようになりました。
+- Snowflake データ ソースの依存関係 Snowflake.Data が v2.0.18 に更新されました。
+- 日付フィルター プリセット ドロップダウンでは、使用可能な日付フィルターの編集、および `onDateFilterMenuOpening` イベントによる独自のフィルターの追加がサポートされるようになりました。半期ベースの日付ルールのサポートも追加されました。
+
+```js
+revealView.onDateFilterMenuOpening = customizeDateFilterMenu;
+//revealView.ShowDateFilterDropdown = false; //Hides the button that shows the dropdown altogether
+
+function customizeDateFilterMenu(args)
+{
+  //if(![my_access_check]) { //Perform access check to the filter menu
+  //  args.Cancel = true; //Cancel opening of filter items list
+  //  return;
+  //}
+
+    var list = args.Items; //List of RVDateFilterMenuItem objects
+    var pos;
+
+    //Add "Last 2 months" to the "months" section
+    pos = list.getItemIndex("Month to date"); //Obtain the beginning of the "years" section
+    var lastTwoMonthsRule = new $.ig.RVDateRule($.ig.RVPeriodRelation.Last, 2, $.ig.RVPeriodType.Month);
+    list.insert(pos + 1, lastTwoMonthsRule); //Insert using helper
+
+    //Add "Last 2 weeks" to a new section after the "days" section
+    pos = list.getItemIndex("Last 7 days");
+    list.insertSeparator(pos + 3);
+    var lastTwoWeeksOpt = new $.ig.RVDateFilterMenuOption(new $.ig.RVDateRule($.ig.RVPeriodRelation.Last, 2, $.ig.RVPeriodType.Week));  //Instantiate RVDateFilterMenuOption directly
+    list.insert(pos + 4, lastTwoWeeksOpt);
+
+    //Remove "Today" option
+    var todayItem = list.getByTitle("Today");
+    list.remove(todayItem);
+
+    //Add "First week of 2024" to a new section at the end of the menu
+    list.addSeparator();
+    var firstWeekOf2024Range = new $.ig.RVDateRange(new Date("2024-01-01"), new Date("2024-01-07")); //Customized description
+    list.add(firstWeekOf2024Range, "First week of 2024");
+}
+
+//The new rules also integrate with the existing filters API
+revealView.dashboard.dateFilter = new $.ig.RVDateDashboardFilter(new $.ig.RVDateRule($.ig.RVPeriodRelation.Last, 3, $.ig.RVPeriodType.Day));
+```
+
+- ダッシュボード フィルターは表示形式に自動的に接続を試行するようになりました。接続できない場合は、以前と同じように手動接続を使用できます。
+- ダッシュボード ヘッダーとは独立してダッシュボード タイトルの表示・非表示を切り替える `showTitle` プロパティが `RevealView` に追加されました。デフォルト値は `true` です。
+- `RevealView` に `ShowSave` プロパティが追加されました。このプロパティは、保存ボタンが表示されるかどうかを決定します。デフォルト値は `true` です。
+- 軸グリッド線は、表示形式エディターの設定ペインで、なし、水平、垂直、または両方のオプションを使用して制御できるようになりました。
+- `RevealView` に、最大化時に表示形式フィルターの表示を切り替える `showVisualizationFilters` プロパティが追加されました。デフォルト値は `true` です。
+
+#### ASP.NET & Node
+
+- Microsoft の SQLite 実装に対応し、Web 上でのオプションとして暗号化のサポートが追加されました。暗号化を有効にするには、安全且つ空でないパスワードを使用して `RevealEmbedSettings.EnableEncryption("yourpassword")` を呼び出す必要があります。デフォルトでは、暗号化なしのレガシー SQLite 実装が引き続き有効になっています (`RevealEmbedSettings.IsLegacyCacheEnabled = true`)。このフラグを `false` に設定することで、暗号化なしの Microsoft 実装に切り替えることができます。注: `EnableEncryption` は、レガシー実装を自動的に無効にします。この変更は、元の SQLite ライブラリを廃止するための移行の開始を示しています。この期間中のフィードバックを歓迎します。
+
+ASP.NET:
+```csharp
+builder.Services.AddControllers().AddReveal(revealSetupBuilder =>
+{
+    revealSetupBuilder.AddSettings(
+    settings => 
+    {
+        settings.IsLegacyCacheEnabled = true;  
+        //settings.EnableEncryption("optional-password"); //this method isn't called by default
+    });
+});
+```
+
+Node:
+```js
+const revealOptions = {
+    //...
+    isLegacyCacheEnabled: true,
+    //enableCacheEncryption: true,
+    //cacheEncryptionPassword: "optional-password",
+}
+app.use('/', reveal(revealOptions));
+```
+
+### バグ修正
+
+#### すべてのプラットフォーム
+
+- スライスベース (円チャート、ドーナツ型チャート、ファンネル チャート) および散布マップの表示形式では、`onVisualizationDataPointClicked` が呼び出されませんでした。
+- `TODAY`/`NOW` 計算フィールド関数を使用すると、データが間違っている可能性があります。
+- 最大軸値の設定時にエラーが発生します。
+- 他のウィジェットが異なる XMLA データ ソースからのものである場合、XMLA データ ソースからのウィジェットを強調表示する際にエラーが発生します。
+- XMLA データ ソースからのフィルターにより、他のデータ ソースを使用するウィジェットへの自動接続が可能になり、表示形式が壊れます。
+- XMLA グローバル フィルターが機能しません。
+- 一部の読み込みシナリオでは、ダッシュボードの識別子が null に設定されていました。
+- Google アナリティクス 4 のフィルターとグローバル フィルター値の読み込みエラーが発生します。
+- 最後の固定チャート線フィールドが削除できません。
+- 総計を含む表示形式で SSAS 'FillTotalsInRow' エラーが発生します。
+- SSAS では、一部のチャート タイプを使用しているときにデータが表示されません。
+- フィルターを追加するときに「Uncaught TypeError: String.isNullOrEmpty は関数ではありません」というエラーが発生します。
+- 十分なスペースがない場合、ラベルが非表示にならないことがあります。
+- 生データを表示した後に別のチャート タイプに切り替えると例外が発生します。
+
+## 1.7.1 (2024 年 11 月 5 日)
+
+### 重大な変更
+
+#### すべてのプラットフォーム
+
+- `ChartInteractionEventArgs` は `TooltipShowingEventArgs` に名前が変更されました。
+
+### 新機能
+
+#### すべてのプラットフォーム
+
+- チャートの表示形式では、値 0 のデータ ラベルは自動的に非表示になります。
+- カスタム メニュー項目は、`onTooltipShowing` 関数に渡される引数の `customItems` プロパティに `RVTooltipItem` を追加することで、表示形式ツールチップに追加できるようになりました。
+
+```js
+revealView.onTooltipShowing = function (args) {
+    //A string pointing to the image may be used or an RVImage, such as:
+    //var caseIcon = new $.ig.RVImage("https://svgsilh.com/png-512/306879.png", "Case Icon"); 
+    var caseIcon = "https://svgsilh.com/png-512/306879.png";
+    var openIcon = "https://svgsilh.com/png-512/41335.png";
+
+    if (args.cell.formattedValue == "Digital Security Center")
+    {
+        args.customItems.push(new $.ig.RVTooltipItem("Critical", "Escalate Incident", caseIcon, (sender, clickArgs) => { console.log("Clicked"); }));
+        args.customItems.push(new $.ig.RVTooltipItem("Critical", "Open Incident Report", openIcon, (sender, clickArgs) => { console.log("Clicked"); }));
+
+        args.customItems.push(new $.ig.RVTooltipItem("High", "Send Reminder", null, (sender, clickArgs) => { console.log("Clicked"); }));
+        args.customItems.push(new $.ig.RVTooltipItem("High", "Assign Lead Investigator", null, (sender, clickArgs) => { console.log("Clicked"); }));
+    }
+}
+```
+
+- ホバー時にアクションを表示するツールチップの配置が改善されました。
+- URL リンクは、`onDashboardSelectorRequested` を実装する必要なく、すぐに使用できるようになりました。
+- URL のリンク ダイアログにターゲット設定が追加されました。ターゲットは、引数パラメーターの `target` プロパティを使用して `onUrlLinkRequested` を通じて指定できます。
+
+```js
+revealView.onUrlLinkRequested = (args) => {
+        args.target = "_blank";
+        return "https://www.google.com/";
+};
+```
+
+- 新しい表示形式を作成するか、既存の表示形式を編集してグリッドに切り替えると、サポートされているデータ ソースでデフォルトでグリッドのページングが有効になっています。
+- Shadow DOM を利用する Web コンポーネント フレームワークをより適切にサポートするために、マウスホイールイベントの改善が行われました。
+- 高負荷時のリクエスト実行と資格情報解決のパフォーマンスが向上しました。
+- クエリ実行のパフォーマンスを向上させるために、MongoDb の match ステージを簡素化しました。
+
+#### ASP.NET
+
+- .NET 8.0 のサポートが追加されました。
+- 依存関係 Npgsql v6.0.9 が v7.0.7 に更新されました。
+- 依存関係 Snowflake.Data v1.1.4 が v2.0.18 に更新されました。
+- Sybase コネクターの場合、依存関係 System.Data.SqlClient v4.7.0 が v4.8.6 に更新されました。
+
+#### Java
+
+- キャッシュ ファイルの場所をカスタマイズできるように、新しい `public InitializeParameterBuilder setCachePath(String path)` メソッドが `InitializeParameterBuilder` に追加されました。
+
+### バグ修正
+
+#### すべてのプラットフォーム
+
+- ツリーマップのツールチップに誤った情報が表示されています。
+- プレビュー用にデータが読み込まれている間、「表示するデータがありません」というメッセージが表示されます。
+- 複数のデータ ソースが利用可能な場合、InMemory データ ソースではエディターが直接開きます。
+- 日付範囲カレンダーが動作しません。
+- 計算フィールドをデータ フィルターとして割り当てることは、Postgres では正しく機能しません。
+- 計算フィールドでは「並べ替え」を行うことができません。
+- 「サーバーでデータを処理」設定で、SQL ベースのプロバイダーの計算フィールドによる並べ替えでエラーが発生します。
+- `trunc` 関数は連結内で正しく動作しません。
+- グリッドの表示形式を使用してフィールドに構成した場合、大きな数値の書式設定が適用されませんでした。
+- 日付表示形式フィルターの選択値を設定するときに、UI に間違った日付書式が表示されます。
+- クリック/ホバー イベントで日付の値が正しく報告されません。
+- コンボの表示形式では、軸ごとの最低軸の最小値は計算されません。
+- 積層型棒の表示形式では、小数を 0 に設定すると、Y軸のマーカーが重複して表示されます。
+- Analysis Services ディメンション構造は、更新によってサーバーから更新されません。
+- インタラクティブ フィルタリングはラベル ゲージでは機能しません。
+- 生データに切り替えてから別の表示形式に切り替えるとクラッシュが発生します。
+- ページングされた行グリッドをスクロールして表示するとクラッシュが発生します。
+- テキストの表示形式には、「表示するデータはありません」 と表示されます。
+- ドーナツ チャートで大きな数値が縮小されずにオーバーフローしています。
+- RevealView の `showFilters` プロパティを `false` に設定すると、意図したとおりに機能しません。
+- 階層からカテゴリにフィールドをドラッグすると、アプリケーションがクラッシュします。
+
+#### ASP.NET
+
+- Serilog をロガーとして使用すると、メッセージ パラメーターが適切に置き換えられません。
+
+## 1.7.0 (2024 年 9 月 10 日)
+
+### 重大な変更
+
+#### Java
+
+- Spring Boot 2.x はサポートされなくなりました。アプリケーションをホストするには、JDK 17 以降 と Jakarta EE 9 準拠サーバーを備えた Spring Boot 3.x を使用する必要があります。
+
+### 新機能
+
+#### すべてのプラットフォーム
+
+- (ベータ版) カテゴリ チャートに固定線を追加できるようになりました。このベータ機能にアクセスするには、`$.ig.RevealSdkSettings` の `enableBetaFeatures` プロパティを有効にします。エディターの固定行セクションでは、データ フィールド、または最高値、最低値、平均値、または固定値の集計特殊フィールドのいずれかを使用できます。
+- 表示形式フィルター API に日付のサポートが追加されました。たとえば、「過去 7 日間」などの日付ベースの表示形式フィルターがある場合、次のコードを使用して、返される `RVDateRange` オブジェクトの `from` プロパティと `to` プロパティをチェックすることで、フィルターが評価した日付範囲を確認できます。
+
+```js
+var dateRange = revealView.dashboard.visualizations[0].filters[0].dateRange;
+```
+
+- `$.ig.RevealSdkSettings` の `enableBetaFeatures` フラグを必要とせずに、サーバー側グリッド ページングが利用できるようになりました。ページングは​​次のプロバイダーでサポートされています: SQL Server、MySQL、BigQuery、PostgreSQL、SyBase、Athena、Oracle。ストアド プロシージャーをサポートするプロバイダーでは、テーブルのようにクエリを実行して行の範囲を返すことができないため、ストアド プロシージャーを選択するとグリッド ページングが無効になります。さらに、サーバー上でのデータ処理が false の場合、およびブレンドされたデータを使用する場合、ページングは​​使用できません。
+- 表示形式レベルの説明が追加されました。表示形式を編集するときに、必要に応じて説明を入力できるようになりました。
+- 表示形式ではダッシュボードのリンクが自動的にサポートされるようになりました。デフォルトの機能は、[「ダッシュボードのリンク」](https://help.revealbi.io/ja/web/linking-dashboards/)トピックの手順を使用して上書きできます。
+- 表示形式を最大化すると、オーバーフロー メニューから個別に PDF にエクスポートできるようになりました。
+- `ExportOptions` オブジェクトの `includeFiltersSummaryPage` プロパティを設定することで、エクスポートでフィルター集計ページを非表示にできるようになりました。例外は NodeJS です。このプラットフォームでは、設定に関係なくフィルターの集計ページは含まれません。
+- オーバーフロー メニューまたはフィルター検索ボックスをクリックしたときの背景オーバーレイが明るくなりました。
+- グリッド表示形式で非表示フィールドを定義する機能が追加されました。これを使用して、URL またはダッシュボード リンクを定義できます。
+- (ベータ版) 同じ表示形式内でフィルタリングされたデータを比較できます。シリーズのツールチップには、選択した値でフィルタリングするオプションが含まれます。表示形式の残りの部分には、フィルタリングされた値と元の値を簡単に比較できるように、両方の値が表示されます。このリリースでは、ファンネル、ツリーマップ、ゲージのサポートが追加されました。この機能は現在、次のグラフ タイプでサポートされています: 縦棒、棒、折れ線、時系列、エリア、ステップ エリア、スプライン、積層型縦棒、積層型エリア、積層型棒、ファンネル、ツリーマップ、ゲージ。この機能を有効にするには、RevealView で `interactiveFilteringEnabled` を `true` に設定します。
+- ヘッドレス エクスポートで画像のエクスポートがサポートされます。
+- Sql Server Analysis Services データ ソースは `EffectiveUserName` プロパティをサポートするようになり、これにより特定のユーザーになりすますことが可能になりました。このプロパティは、たとえば、userContext に設定されている現在のユーザーの値を使用して `IRVDataSourceProvider` 実装のプロパティを設定することにより、シングル サインオンを実現するために活用できます。
+
+#### ASP.NET & Node
+
+- Windows 統合認証が、SQL Server Analysis Services データ ソースでサポートされます。これを有効にするには、'IRVAuthenticationProvider' 実装で `RVIntegratedAuthenticationCredential` の新しいインスタンスを返します。
+
+#### Java
+
+- Spring Boot v3 のサポートが追加されました。Spring Boot v2.x はサポートされなくなりました。Spring Boot v3 を使用するには、JDK 17 以上を使用し、アプリケーションをホストするための Jakarta EE 9 準拠のサーバーが必要になります。
+- ExportTool に ARM64 サポートが追加されました。
+
+### バグ修正
+
+#### すべてのプラットフォーム
+
+- キャッシュされたファイルは、Reveal キャッシュにエントリを追加した後、.tmp ファイルを削除していませんでした。
+- フォント サイズを変更した後、テキストエリアフィールドのプレースホルダーの位置がずれます。
+- 値またはラベル フィールドで構成された並べ替えが円チャートの表示形式に反映されません。
+- TextBox のみを含むダッシュボードを編集するとクラッシュが発生する可能性があります。
+- 「今日」と「昨日」の日付フィルターでは、異なるタイムゾーンで誤った値が表示されます。
+- マウスが押されたときにクリック可能な要素の背景色が間違っています。
+- 日付フィールドに null 値がある場合、Excel エクスポートで間違ったチャートが生成されます。
+- カテゴリを使用すると積層型縦棒チャートの色が消えます。
+- 散布図では、一部の状態が緑色で表示されます。
+- `onFieldsInitializing` を使用してラベルを変更しても、ダッシュボード フィルターのフィールド選択には反映されません。
+- 表示形式タイプを変更して Excel にエクスポートすると、フィールドの書式設定が失われます。
+- ヘッドレス エクスポート `InitScript` が表示形式で機能しません。
+- マップ の形状は https ではなく http から読み込まれます。
+- ダッシュボードの説明が body タグの子として追加されます。
+- ダッシュボードのリンクは、null または空の文字列値では機能しません。
+- Web コンポーネントを使用しているときにダッシュボードのタイトルまたは説明を変更すると、それらのフィールドはデフォルトに戻ります。
+- Snowflake メタデータ ブラウザーはすべてのスキーマのテーブルを表示します。
+
+## 1.6.7 (2024 年 6 月 26 日)
+
+### 新機能
+
+#### すべてのプラットフォーム
+
+- 表示形式フィルター (クイック フィルターとも呼ばれます) にプログラムでアクセスし、選択した値を変更するための API が追加されました。
+
+```js
+//Add a selected value, specified by index from the list of available values, to a field given its name.
+function addSelValueToFilter(fieldName, valueIdx) {
+	var flt = revealView.dashboard.visualizations[0].filters.getByFieldName(fieldName);
+	var valuesPromise = flt.getFilterValues(); //Retrieve the selectable values for the filter
+	valuesPromise.then(function (values) {              
+		var selValues = flt.selectedValues;
+		selValues.push(values[valueIdx]); //Add the specified value to the selection
+		flt.selectedValues = selValues;
+	});
+}
+```
+- (ベータ版) 同じ表示形式内でフィルタリングされたデータを比較できます。シリーズのツールチップには、選択した値でフィルタリングするオプションが含まれます。表示形式の残りの部分には、フィルタリングされた値と元の値を簡単に比較できるように、両方の値が表示されます。現在、次のチャート タイプがサポートされています: 縦棒、棒、折れ線、時系列、エリア、ステップ エリア、スプライン、積層型縦棒、積層型エリア、積層型棒。この機能を有効にするには、RevealView で `highlightedFilteringEnabled` を `true` に設定します。
+- (ベータ版) 近似曲線、ラベル、ズームなどにすばやくアクセスするための表示形式ツールバーが追加されました。この機能を有効にするには、`$.ig.RevealSdkSettings` で `enableNewToolbar` を `true` に設定します。
+- SQL ベースのデータ ソースに対しクライアント側でカスタム クエリを提供できる機能を削除しました。
+- RVGoogleAnalyticsDataSource と RVGoogleAnalyticsDataSourceItem は、Google がこのコネクタの API を 2024 年 7 月 1 日に廃止する予定であるため、削除されました。
+- RevealView に `onDashboardChanged` イベントを追加しました。
+
+```js
+revealView.onDashboardChanged = function (args: DashboardChangedEventArgs) {
+  console.log('Dashboard has changed.');
+  console.log('Old Dashboard:', args.oldValue);
+  console.log('New Dashboard:', args.newValue);
+
+  // Accessing filters for the old and new dashboard
+  if(args.oldValue) {
+    console.log('Old Dashboard Filters:', args.oldValue.filters);
+  }
+  if(args.newValue) {
+    console.log('New Dashboard Filters:', args.newValue.filters);
+  }
+};
+```
+- データ ソース ダイアログ内のテーブルがアルファベット順に並べ替えられるようになりました。この変更は次のコネクタに適用されます: SQL Server、MySql、Postgres、Redshift、Oracle、Snowflake。
+- ヘッドレス エクスポートにグリッド データが含まれるようになりました。
+- RVGoogleAnalytics4DataSource に `accountId` および `propertyId` プロパティが含まれるようになり、RVGoogleAnalytics4DataSourceItem の該当するプロパティは非推奨になりました。
+
+#### Java
+
+- プロバイダーを実装しなくてもダッシュボードをサーバーに保存できるように、デフォルトの RVDashboardProvider を追加しました。
+
+### バグ修正
+
+#### すべてのプラットフォーム
+
+- ラベル セクションにフィールドが設定されていない XMLA ベースの表示形式をエクスポートすると、Excel エクスポートがクラッシュする問題。
+- ChangeDataSourceItemAsync の DataSource ID が正しくない問題。
+- ダッシュボードに Sparkline 表示形式が読み込まれたときに例外が発生する問題。
+- 無効なキャストによって、グリッド表示形式で例外が発生する問題。
+- ブレンディング UI で、ストアド プロシージャーが有効な追加データ ソースとして表示される問題。
+- データベースから DateTime.MaxValue を読み取るときにエラーが発生する問題。
+- タイトルのないウィジェットを含む Excel ファイルをエクスポートするとクラッシュする問題。
+- ピボット表示形式の Excel エクスポートで、展開された行を含む場合に列が混在する問題。
+- 折れ線チャートの表示形式をエクスポートするときに、行ヘッダーが null になる問題。
+- Excel にエクスポートするときに、予約文字が正しくフィルタリングされない問題。
+- Excel エクスポートで、日付の書式設定が適用されない問題。
+- フィルター エディターのフィールド リストが、式エディターのフィールド リストに影響する問題。
+- SharePoint O365 データ ソースが正しく機能しない問題。
+- `datediff` 計算式が、一重引用符ではなく二重引用符で機能する問題。
+- BigQuery の日付精密ハンドリングが間違っている問題。
+- エディターの検索バーが複数回レンダリングされる問題。
+- 計算フィールドを追加した後、フィルターされたフィールド リストが正しくない問題。
+
+#### ASP.NET & Java
+
+- RDASH プロパティが、サーバー上で設定されたものよりも優先される問題。
+
+#### Java
+
+- ExportTool が間違ったパスに作成される問題。
+
+## 1.6.6 (2024 年 4 月 19 日)
+
+### 新機能
+
+#### すべてのプラットフォーム
+
+- `showDescription` プロパティによって制御されるオプションの説明テキスト ボックスを RevealView に追加しました。
+- グリッドまたはピボットを PDF にエクスポートすると、ページの幅に収まらない列を含むオーバーフロー テーブルが生成されるようになりました。
+- PDF エクスポート時にグリッド列の幅が優先されるようになりました。
+- Excel へのエクスポートにおけるピボット グリッドの表示形式の外観が改善されました。
+- (ベータ版) グリッド表示形式にサーバー側のページング サポートが追加されました。この機能を有効にして、表示形式エディターの設定ペインに表示するには、`$.ig.RevealSdkSettings.enableBetaFeatures` を `true` に設定します。ページングは​​次のプロバイダーでサポートされています: SQL Server、MySQL、BigQuery、PostgreSQL、SyBase、Athena、Oracle。ストアド プロシージャーをサポートするプロバイダーでは、テーブルのようにクエリを実行して行の範囲を返すことができないため、ストアド プロシージャーを選択するとグリッド ページングが無効になります。さらに、サーバー上でのデータ処理が false の場合、およびブレンドされたデータを使用する場合、ページングは​​使用できません。
+- `SkiaSharp`、`SkiaSharp.HarfBuzz`、および `SkiaSharp.NativeAssets.Linux` v2.88.3 依存関係が v2.88.7 に更新されました。
+表示形式エディターでデータ ツールチップをプレビューするかどうかを制御するフラグが RevealView に追加されました。クエリが最初の 5 行を取得するのを防ぐため、これらはデフォルトでオフになっています。このツールチップを有効にするには、`isPreviewDataInVisualizationEditorEnabled` を `true` に設定します。
+- サーバー上でプロセス データを使用する場合、MySql でブレンディングがサポートされるようになりました。
+- ラジアル チャートの新しいルック & フィール。以前のルック & フィールは非推奨ですが、必要に応じて `RevealSdkSettings.EnableNewCharts = false` を実行することで復元できます。
+- 棒チャートと柱状チャートには、表示形式エディターの設定ペインに重複とギャップの設定が含まれるようになりました。これにより、バー間の重なりの量とグループ間のスペースの量を制御できます。
+- ツリーマップの表示形式では、マウスをホバーするとツールヒントが表示され、ノードが強調表示されるようになりました。
+- `Playwright` v1.27.2 の依存関係が v1.42.0 に更新されました。
+
+#### Node
+- データ ソース ダイアログでデータ ソース項目をフィルター処理できるようにする `dataSourceItemFilter` プロパティが RevealOptions に追加されました。
+```ts
+dataSourceItemFilter?: (userContext: IRVUserContext | null, dataSourceItem: RVDataSourceItem) => Promise
+```
+
+### バグ修正
+
+#### すべてのプラットフォーム
+
+- UI からエクスポートする場合、円チャートとドーナツ型チャートが表示されない問題。
+- 計算フィールドが依存しているデータ ブレンドを削除しても、計算フィールドが削除されない問題。
+- Redshift で関数を呼び出すとエラーが発生する問題。
+- Postgres 関数が正しく動作しない問題。
+- コンテナーまたは任意の祖先要素で transform:scale スタイルを使用する場合の RevealView の配置とサイズ設定で発生する問題。
+- `canAddDateFilter` を設定すると例外が発生する問題。
+- ダッシュボード プロパティが null または undefined に設定されている場合、保存イベント `args.isNew` は `false` になる問題。
+- ストアド プロシージャー パラメーター画面では、以前のデータが取得されたり、まったく取得されなかったりする場合があります。
+- 検索バーを使用すると、ポップアップ要素でスクロールが機能しなくなる問題。
+- 散布マップ インジケーターのホバー領域がズームに応じて移動する問題。
+- 分数の数字は、階級区分図のツールチップには表示されない問題。
+- 3000 を超えるフィルター値は保持されない問題。
+- 事後計算フィールドの UI で名前が変更されたピボット フィールドに関するエラーが発生する問題。
+- プレビュー データ セルが再利用されないため、複数回レンダリングされる問題。
+- MacOS ARM64 でグリッドがクラッシュする問題。
+- 円チャートの凡例が、表示するのに十分なスペースがある場合に表示されなくなる問題。
+- サーバー上のプロセス データをオフにした状態で MySql をブレンドするとエラーが発生する問題。
+- スライス チャートでホバー イベントが意図したとおりに動作しない問題。
+- ピボット グリッドの表示形式に総計が表示されない問題。
+- Analysis Services データ プロバイダーを使用すると、誤った総計値が表示される問題。
+- Analysis Services データ プロバイダーを使用すると、ダッシュボードと視覚化フィルターに誤った総計が表示される問題。
+- ピボット グリッドで値を並べ替えた後、フィールド名の変更が失われる問題。
+- 「...hierarchy already appears in the Axis1 axis.」 エラーが Analysis Services で発生する問題。
+- Analysis Services で 「上の N」 フィルターを適用すると、誤った結果が返される問題。
+- リソースベースの表示形式では誤ったキャッシュ エントリが取得される問題。
+- ブレンディングを使用すると、誤ったキャッシュ エントリがヒットされる問題。
+- ブラウザーがバックグラウンドに移動した後、検索ボックスにフォーカスを設定できない問題。
+
+## 1.6.4 (2024 年 2 月 14 日)
+
+### 重大な変更
+
+- プロパティ名 `showExportToPowerpoint` が `showExportToPowerPoint` に変更されました。
+- 散布図とバブル チャートの新しいルック & フィール。古いルック アンド フィールは廃止されました。必要に応じて、`RevealSdkSettings.enableNewCharts = false` を実行することで復元できます。
+
+### 新機能
+
+#### すべてのプラットフォーム
+
+- `RVDashboard` の `description` プロパティを公開しました。
+- ダッシュボードのタイトルを個々の Excel シートに追加しました。
+- Excel および PDF にエクスポートする際にダッシュボード フィルターが含まれるようになりました。
+- PostgreSQL ストアド プロシージャは現在サポートされていないため、タブから削除しました。
+
+### バグ修正
+
+#### すべてのプラットフォーム
+
+- データ ソース項目の設定が欠落している場合、Athena エラー メッセージが不十分である問題。
+- ソース項目プロバイダーが実装されていない場合に、S3 DS 「Region has not been set (地域が設定されていません)」 エラーが発生する問題。
+- ソース項目プロバイダーが実装されていない場合に、Redshift DS 「Host can't be null (ホストを null にすることはできません)」 エラーが発生する問題。
+- ソース項目プロバイダーが実装されていない場合に、MySql 「unable to connect (接続できません)」 エラーが発生する問題。
+- データ ソース項目プロバイダーが実装されていない場合に、テーブル選択時に Postgres エラーが発生する問題。
+- 一部のグリッドのシナリオで大文字と小文字を区別しない並べ替えが正しくない問題。
+- 選択した項目に変更が加えられた際に FilterChanged イベントが発生しない問題。
+- 「サーバーでデータを処理」フラグの初期化が誤っている問題。
+- フィールドのフォーマットを構成時に 「Uncaught TypeError: t.mkFormat is not a function (キャッチされない TypeError: t.mkFormat は関数ではありません)」 のエラーが発生する問題。
+- M1 Mac/ARM64 で SQLite の例外がクラッシュを引き起こす問題。
+- 別のデータ ソースからフィールドを追加する際の `CURRENTTIMEZONE()` が正しくない問題。
+- KPI vs Time で今月の空の値が表示されるようになりました。
+- グリッドまたはピボット タイプの表示形式における日付タイプの列の並べ替えが正しく動作しない問題。
+- 表示形式の読み込み中にエクスポートを実行すると複数のポップアップが表示される問題。
+- エクスポートする際に 413 エラーが発生する問題。
+- RevealView の複数のインスタンスがサポートされない問題。
+- マップの場所名の比較では大文字と小文字が区別される問題。
+
+#### Java
+
+- SSRS または CSV データに対して数値の丸めが機能しない問題。
+- MySql - カスタム クエリの設定が機能しない問題。
+- エクスポートがタイムアウトしてエラーが発生する問題。
+
+#### Node
+
+- 現在の Chromium バージョンが Node + MAC M1 で動作しない問題。
+
+## 1.6.3 (2024 年 1 月 15 日)
+
+- **ASP.NET 7.0** をターゲットとするプロジェクトの依存関係の競合を修正するパッチ リリース。`System.Security.Cryptography.Pkcs` を更新しました (6.0.3 => 7.0.0)。
+
+## 1.6.2 (2024 年 1 月 5 日)
+
+### 新機能
+
+#### すべてのプラットフォーム
+
+- 表示形式の背景色ピッカーが [Coloris](https://github.com/mdbassit/Coloris) を使用するように更新されました。この機能強化により、デフォルトで背景色設定の可視性が有効になったため、プロパティ `canChangeVisualizationBackgroundColor` は廃止対象とされています。さらに、[Spectrum](https://bgrins.github.io/spectrum/) の依存関係は必要なくなりました。
+- キャッシュ ファイル `tabulardata.sqlite` の sqlite ストレージは、無制限に増大することを防ぐためにデフォルトで無効になりました。
+- `$.ig.RevealSdkSettings.enableActionsOnHoverTooltip` が有効になっている場合、アクション ツールチップがピボット表示形式で利用できるようになりました。チャート表示形式上にマウスを置くと、データ ポイントから特定のピクセル数以内にツールチップが表示されるようになりました。
+- 「サーバーでデータを処理」が有効になっている SQL Server データ ソースで次の関数を使用する計算フィールドのサポート: `fyear`、`and`、`or`、`concatenate`、`replace`、`date`、`time`、`hour`、`minute`、`second`、`formatdate`、および `datevalue`。
+- 実行時にダッシュボード内の URL リンクをインターセプトおよび変更できるようにするために、`onUrlLinkRequested` という名前の新しいクライアント イベントが追加されました。
+
+```javascript
+revealView.onUrlLinkRequested = (args) => {
+    return args.url + "&webUpdated=true&cellValue=" + args.cell.value();                
+};
+```
+
+- サーバー エクスポートを使用して単一の表示形式をエクスポートする機能が追加されました。
+
+
+  
+
+```cs
+var pdfOptions = new PdfExportOptions();
+
+pdfOptions.Visualizations.Add(new VisualizationExport() {Title = "Sales by Product" });
+pdfOptions.Visualizations.Add(new VisualizationExport("9ea0b74d-8944-474c-5e8c-78ce2b30d16c"));
+
+//or
+pdfOptions.Visualizations.AddByTitle("Sales by Product");
+pdfOptions.Visualizations.AddById("9ea0b74d-8944-474c-5e8c-78ce2b30d16c");
+
+
+await _exporter.ExportToPdf(dashboardId,  path + ".pdf", pdfOptions);
+```
+
+  
+
+  
+
+```java
+ArrayList viz = new ArrayList();
+
+viz.add(new VisualizationExport("9ea0b74d-8944-474c-5e8c-78ce2b30d16c"));
+
+VisualizationExport ve = new VisualizationExport();
+ve.setTitle("Sales by Product");
+viz.add(ve);
+
+PdfExportOptions options = new PdfExportOptions();
+options.setVisualizations(viz);	
+
+RevealEngineLocator.dashboardExporter.exportToPdf(dashboardId, null, options ,new ExportStreamCallback() {
+	@Override
+	public void onSuccess(InputStream stream) {
+		try {								
+			Files.copy(stream, Paths.get(filePath), StandardCopyOption.REPLACE_EXISTING);
+			asyncResponse.resume(filePath);
+		}
+		catch(Exception e) {
+			asyncResponse.resume(e);
+		}
+	}
+
+	@Override
+	public void onFailure(Exception e) {
+		asyncResponse.resume(e);							
+	}	
+});
+```
+
+  
+  
+      
+
+```javascript
+import reveal, { ExportFormat, IDashboardExporter, PdfExportOptions, VisualizationExport } from 'reveal-sdk-node';
+
+var options = new PdfExportOptions();
+var ve = new VisualizationExport();
+ve.title = "Spend vs Budget";
+
+options.visualizations.push(ve);    
+
+revealServer.exporter.exportPdf("Marketing", fileName, options, null);
+```
+
+  
+
+
+
+- クライアントおよびサーバーのエクスポートでのカスタム カラーのサポートが追加されました。
+
+
+  
+
+```cs
+PdfExportOptions options = new PdfExportOptions();
+
+options.InitScript = @"
+	function init(revealView){
+		$.ig.RevealSdkSettings.theme = new $.ig.MountainDarkTheme();                   
+
+		revealView.refreshTheme();                
+
+		revealView.onVisualizationSeriesColorAssigning = function (visualization, defaultColor, fieldName, categoryName) {
+			if (categoryName === ""Critical"") {
+					return ""rgb(0,0,0)"";
+			}
+			return defaultColor;
+		}
+	}";
+
+await _exporter.ExportToPdf(dashboardId, path, options);
+```
+
+  
+
+  
+
+```java
+PdfExportOptions options = new PdfExportOptions();	
+			
+options.setInitScript("function init(revealView){\r\n"
+		+ "		$.ig.RevealSdkSettings.theme = new $.ig.MountainDarkTheme();                   \r\n"
+		+ "\r\n"
+		+ "		revealView.refreshTheme();                \r\n"
+		+ "\r\n"
+		+ "		revealView.onVisualizationSeriesColorAssigning = function (visualization, defaultColor, fieldName, categoryName) {\r\n"
+		+ "			if (categoryName === \"Critical\") {\r\n"
+		+ "					return \"rgb(0,0,0)\";\r\n"
+		+ "			}\r\n"
+		+ "			return defaultColor;\r\n"
+		+ "		}\r\n"
+		+ "	}");
+
+String filePath = rootFileName + dashboardId + "_stream.pdf";
+
+RevealEngineLocator.dashboardExporter.exportToPdf(dashboardId, null, options ,new ExportStreamCallback() {
+
+	@Override
+	public void onSuccess(InputStream stream) {
+		//Do something
+	}
+
+	@Override
+	public void onFailure(Exception e) {
+		asyncResponse.resume(e);							
+	}
+	
+});
+```
+
+  
+  
+      
+
+```javascript
+var options = new PdfExportOptions();
+options.initScript = `
+function init(revealView){
+	$.ig.RevealSdkSettings.theme = new $.ig.MountainDarkTheme();                   
+
+	revealView.refreshTheme();                
+
+	revealView.onVisualizationSeriesColorAssigning = function (visualization, defaultColor, fieldName, categoryName) {
+		if (categoryName === "Critical") {
+				return "rgb(0,0,0)";
+		}
+		return defaultColor;
+	}
+}`;
+	
+revealServer.exporter.exportPdf("Cybersecurity_Sample_ManyFilters_Values", "c:\\Temp\\Exports\\export_node.pdf", options, new RVUserContext("someone"));
+```
+
+  
+
+
+
+- 編集モードを制御する機能を追加しました。
+  - `enterEditMode()`
+  - `exitEditMode(applyChanges: boolean)`
+  - `onEditModeEntered`
+  - `onEditModeExited`
+  
+```javascript
+
+
+
+
+

+
+
+    
+
+
+```
+- 異なる接続で異なるデータベースにアクセスできるようにするために、`RVSnowflakeDataSoure` に `role` プロパティが追加されました。
+- MySQL コネクターでのストアド プロシージャーのサポートが追加されました。
+- ダッシュボード フィルターに表示される値の最大数を制御するために、`RevealSdkSettings` プロパティに `maxFilterSize` が追加されました。
+
+#### ASP.NET
+
+- ヘッドレス エクスポートのグローバル フィルター設定のサポートが追加されました。
+
+```cs
+PdfExportOptions options = new PdfExportOptions();
+options.DateFilter = new RVDateDashboardFilter(RVDateFilterType.CustomRange,
+                                        new RVDateRange(new DateTime(2022,4,1), DateTime.Now)
+                                );
+
+options.Filters.Add(new RVDashboardFilter("incident_severity", new List { "Medium", "Critical" }));
+options.Filters.Add(new RVDashboardFilter("team", new List { "Digital Security Center"}));
+
+await _exporter.ExportToPdf(dashboardId, path, options);
+```
+
+#### ASP.NET & Node
+
+- MongoDB コネクターのカスタム クエリのサポートが追加されました。
+- MongoDB コネクターのサーバー上でのデータ ブレンディング (結合) のサポートが追加されました。
+- MacOS および Linux 上の ASP.NET および Node 用の ARM64 のサポートが追加されました。
+
+#### Java
+
+- JavaScript SDK ディストリビューションは https://maven.revealbi.io/repository/public/com/infragistics/reveal/sdk/reveal-sdk-distribution/x.y.z/reveal-sdk-distribution-x.y.z-js.zip で利用できなくなります。代わりに、場所は https://dl.infragistics.com/reveal/libs/x.y.z/reveal-sdk-distribution-js.zip になります。
+- ヘッドレス エクスポートのグローバル フィルター設定のサポートが追加されました。
+
+```java
+PdfExportOptions options = new PdfExportOptions();	
+
+RVDateDashboardFilter dateFilter = new RVDateDashboardFilter(RVDateFilterType.CUSTOM_RANGE,
+			new RVDateRange( new GregorianCalendar(2022,4,1), new GregorianCalendar())
+                        );
+						
+options.setDateFilter(dateFilter);
+					
+options.getFilters().add(new RVDashboardFilter("incident_severity", new ArrayList(Arrays.asList("Medium", "Critical"))));
+```
+
+### バグ修正
+
+#### すべてのプラットフォーム
+
+- `canAddDateFilter` を設定すると例外が発生する問題。
+- 選択した値の検索を使用すると、Redshift フィルターで 3k 制限を超える値が表示されない問題。
+- 表示形式エディターでフィールド設定を表示するときに「データ ラベルを表示」というテキストが翻訳されない問題。
+- SSAS コネクターを使用する場合、並べ替え時にピボット グリッドが行を混同する問題。
+- KPI vs Time - データがある状態から表示するデータがない状態に変化したときにテキストが重なる問題。
+- クリック イベントがないときに「最初の表示形式を追加」の上にマウスを置くとポインター カーソルが表示される問題。
+- クライアントが別の言語を使用している場合のサーバー側のローカリゼーションの問題。
+- クライアントが別の言語を使用している場合のサーバー側のローカリゼーションの問題。
+- [新しい計算フィールド] ウィンドウのツールチップに空白のヒントが表示される問題。
+- データ ソース項目はデータ ソースのサブタイトルを上書きしてはなりません。
+- 大量のデータがある場合、グリッド表示形式の読み込みに時間がかかる問題。
+- Snowflake ホストのスペイン語翻訳では 「Anfitrion」 と表示される問題。
+- `chartTypes` を構成するときに、`AreaChart` が変更に応答しない問題。
+- バージョンにビルド番号が付加されることによるサーバー側のダッシュボードのエクスポートの問題。
+
+#### ASP.NET & Node
+
+- MongoDB コネクターで、空のフィールドでフィルタリングするときに、フィールドが設定されていないドキュメントをフィルタリングしない問題。
+
+## 1.6.1 (2023 年 10 月 25 日)
+
+### 重大な変更
+
+#### すべてのプラットフォーム
+
+- 単一視覚化モードを有効にすると、`RevealView` の次のプロパティが自動的に `false` に設定されます: `showChangeVisualization`、`canEdit`、`showMenu`、`showStatisticalFunctions`、`showFilters`。
+- `window.revealDisableKeyboardManagement` プロパティはデフォルトで `true` に設定されるようになりました。`true` に設定すると、タブのフォーカスは RevealView で停止しません。
+- スライス チャート (円チャート、ファンネル チャート、ドーナツ チャート) のルック アンド フィールが変わりました。古いルック アンド フィールは非推奨ですが、必要に応じて `RevealSdkSettings.enableNewCharts = false` を実行することで復元できます。
+
+### 新機能
+
+#### すべてのプラットフォーム
+
+- 個々の可視化のヘッドレス エクスポート。
+- 外部ダッシュボード リンクに `noopener` 属性が追加されました
+- 可視化間のマージンを変更するために、プロパティ `VisualizationMargin` が `RevealTheme` に追加されました
+- 単一の可視化の改善: 1) プロパティ `showBreadcrumb` および `showBreadcrumbDashboardTitle` を使用したダッシュボード タイトルとブレッドクラム コントロール、2) プロパティ `showTitle` が `RVVisualization` に追加、3) `RevealView` のプロパティ : `showChangeVisualization`、`canEdit`、`showMenu`、`showStatisticalFunctions`、`showFilters` は、単一視覚化モードを有効にするときに自動的に `false` に設定されます。
+- SQL ベースのストアド プロシージャはクエリをログに出力し、データ型の不一致を通知します。
+
+#### ASP.NET & Node
+
+- 新しいデータ ソース: MongoDB
+
+### バグ修正
+
+#### すべてのプラットフォーム
+
+- PostgreSQL で何百ものスキーマがある場合に、テーブルのリストの読み込みが非常に遅くなる問題を修正しました。パフォーマンスを向上させるために、サーバー上でスキーマがフィルタリングされるようになりました。
+- `window.revealDisableKeyboardManagement` プロパティはデフォルトで `true` に設定されるようになりました。`true` に設定すると、タブのフォーカスは RevealView で停止しません。
+- チャート セレクターを繰り返し使用すると、アプリが応答しなくなることがある問題を修正しました。
+- 散布図で小数点以下の桁を使用する値が正しく表示されない問題を修正しました。
+- null 値をフィルタリングできない問題を修正しました。
+- RevealView は font-family で指定されたバックアップ フォントをサポートしていない問題を修正しました。
+- ダーク テーマを使用するとテーブルとビューのタブが表示されない問題を修正しました。
+- 言語が英語に設定されていない場合、Choropleth チャートでデータのない領域が緑色で表示される問題を修正しました。
+- KPI 可視化で使用される計算フィールドを変更した後にエディターを終了すると例外が発生する問題を修正しました。
+- PowerPoint および PDF エクスポートでツリーマップが表示されない問題を修正しました。
+- `RVWebResourceDataItem` で画像または PDF を使用する場合のエラー ダイアログが表示される問題を修正しました。
+- オプションを選択してもエクスポート オプションのポップオーバーが閉じない問題を修正しました。
+- `RVODataDataSource` の `url` プロパティが `RVODataDataSourceItem` にコピーされる問題を修正しました。
+-「その他」カテゴリが表示されている場合にシリーズのオフセット色に色を割り当てる問題を修正しました。
+
+#### Java
+
+- ヘッドレス エクスポートが Linux で機能しない問題を修正しました。
+
+## 1.6.0 (2023 年 8 月 28 日)
+
+### 重大な変更
+
+#### すべてのプラットフォーム 
+* ライセンス キーの変更: 試用モードでもライセンス キーが必要になりました。ライセンス キーが見つからないか無効な場合、SDK は初期化に失敗します。さらに、ライセンス形式が変更され、新しい形式がサポートされる唯一の形式になります。新しいライセンス キーを営業担当者にリクエストしてください。試用版ライセンス キーは、[こちら](https://www.revealbi.io/ja/download-sdk)に登録することで入手できます。
+* `availableChartTypes` プロパティは削除されました。これに代わるのは、以下の「新機能」セクションで説明する `chartTypes` プロパティです。
+* クロスプラットフォームのパフォーマンスを向上させるために、'libgdiplus' への依存関係が削除されました。
+* SDK は Quill.js に依存しなくなりました。
+
+#### ASP.NET
+* ほとんどのデータ ソースはコア パッケージから削除されました。これらは個別のパッケージとして利用できるようになりました。データ ソース パッケージは[登録](/web/datasources.md#データ-ソースのインストール)することが**必須**です。サポートされているデータ ソースと対応するアドイン nuget パッケージに関する情報は、[こちら](/web/datasources.md#サポートされるデータ-ソース)にあります。
+* Reveal には .net 6.0 以降が必要になりました。
+* データ関連のオブジェクトは `Reveal.Sdk.Data` 名前空間に移動されました。
+* データ ソース オブジェクト (例: RVSqlServerDataSource) は、それぞれの名前空間 (例: `Reveal.Sdk.Data.Microsoft.SqlServer`) に移動されました。
+ 
+### 新機能
+
+#### すべてのプラットフォーム 
+
+* 可視化エディターでカスタム可視化をチャート タイプとして追加する機能。新しい `chartTypes` プロパティを使用すると、これが可能になるだけでなく、既存のチャート タイプのアイコン、タイトル、グループ化を変更したり、それらを使用できなくしたりすることもできます。
+```
+//Update existing configuration
+var barConfig = revealView.chartTypes.find(x => x.chartType == 'BarChart');
+barConfig.icon = 'https://host:port/images/bar-chart.png';
+barConfig.groups = ["Enterprise Visualizations", "HR", "Category"];
+
+//Add pre-configured custom visualization
+revealView.chartTypes.push({
+            title: "Custom Visualization",
+            url: "https://host:port/customViz.html",
+            icon: "https://host:port/icon.png",
+            groups: ["HR"]
+        });
+
+//Delete Grid configuration
+var gridConfig = revealView.chartTypes.find(x => x.chartType == 'Grid');
+revealView.chartTypes.splice(revealView.chartTypes.indexOf(gridConfig), 1);
+```
+
+* (ベータ版) マウスをホバーしているときにチャート アクションを使用できます。`$.ig.RevealSdkSettings.enableActionsOnHoverTooltip = true` を使用してオンにします。
+* 計算フィールドの式言語は、先頭に '0' を付けずに指定された小数をサポートするようになりました (例: '0.5' を意味する '.5')。
+* 次の計算フィールド関数に対する BigQuery データ ソースのサポートが追加されました: YEAR、QUARTER、MONTH、DAY、HOUR、MINUTE、SECOND、REPLACE、WEEKDAY、MONTHNAME、MONTHSHORTNAME、EMPTY、RANDBETWEEN。
+* コピーと貼り付けが改善されました。ブラウザーのタブやページを更新しても機能するようになりました。
+* コンテナーのサイズが変更されると、RevealView 自体のサイズも変更されます。
+* ストアド プロシージャのサポートを Oracle データ ソースに追加しました (Java ではまだ利用できません)。
+* Athena データ ソースへの参加を許可しました。
+
+### バグ修正
+
+#### すべてのプラットフォーム 
+* menuItem アクション関数を使用して複数のメニュー項目をプッシュすると、最後のアクション関数が呼び出される問題。
+* ドーナツ チャートには `` 値の凡例は表示されませんが、それらのセクションが表示される問題。
+* PDF へのエクスポートでは、割り当てられたテーマが使用されない問題。
+* フィルター上のテキスト [X Selected/Show All] (X 選択 / すべて表示) をクリックできない問題。
+* テキスト [X Selected/Show All] (X 選択 / すべて表示) のフィルターでは、セルの背景が全幅に表示されない問題。
+* カスタム テーマ フォントの使用は、KPI の視覚化には影響しない問題。
+* JavaScript クライアントで定義された Oracle データ ソースで [No providerid specified...] (プロバイダー ID が指定されていません...) エラーが発生する問題。
+* 特定のシナリオでは、データ選択ビューの検索バーの位置がリセットされない問題。
+* データ ソース ダイアログでテーブルを検索すると、テーブルをスクロールした後にエラー / クラッシュが発生する問題。
+* DefaultRefreshRate が 0 の場合、画像 / PDF Web リソースは読み込まれない問題。
+* スパークラインでは数値の書式設定は適用されない問題。
+* ゲージのツールチップには数値の書式設定が表示されない問題。
+* BigQuery の「NUMERIC」データ型は適切にサポートされていないため、エラーが発生する問題。
+* BigQuery には四半期集計がない問題。
+* BigQuery の「MOD」関数では、2 つの異なるタイプの数値データ（float64 と int64 など）を使用することはできない問題。
+* datasourceItem にスキーマが設定されていない場合、postgres で [Function does not exist] (関数が存在しません) エラーが発生する問題。
+* データをグリッドとして表示する場合、統計関数は表示されない問題。
+* チャート視覚化用のエクスポート xlsx は、Reveal SDK で変更すると正しくない問題。
+* BigQuery のデータ ソースの追加画面でデータセットの大きなリストをスクロールすると、チェックボックスの状態が一貫性がなくなる問題。
+* プロジェクト ID が DS 上でのみ設定されている場合、BigQuery DataSourceItem は機能しない問題。
+* 文字「y」、「m」、「d」、または「h」のいずれかを含むカスタム形式の Excel セルからデータが取得される場合、そのデータは常に日付型として解釈される問題。
+* ツリーマップは数値の書式設定を準拠しない問題。
+* 数値の書式設定は財務チャートのツールチップには表示されない問題。
+* ラジアル チャートのツールチップには数値の書式設定は表示されない問題。
+* Athena と BigQuery では、100k セル制限の警告が表示されない問題。
+* 数学関数ログが Athena で動作しなくなった問題。
+
+#### ASP.NET
+* ヘッドレス エクスポートとインタラクティブ エクスポートの両方が Linux では機能しない問題。
+* Microsoft.Data.SqlClient >= 5.0.0 が Asp.net プロジェクトで使用されている場合の問題を修正しました。
+* Oracle データ ソースで資格情報エラーを確認しました。
+
+#### Node
+* NodeSDK を使用する場合、リクエスト ヘッダーは RVRESTDataSource に対して機能しない問題。
+
+#### Java
+* システムのデフォルトの文字セットが UTF-8 でない場合、BigQuery から読み取られたデータのエンコーディングの問題。
+* createwidget API の IRVDataSourceProvider.changeDataSourceItem で null IRVUserContext を取得する問題。
+
+## 1.5.0 (2023 年 5 月 4 日)
+
+### 重大な変更
+* 一部のシナリオでは、IRVDataSourceProvider で設定された情報がクライアントに表示され、ダッシュボード ファイルにも格納されていました。これは望ましい動作ではありませんでした。またダッシュボードの編集時に再現が困難な問題の発生原因でもありました。1.5.0 以降、IRVDataSourceProvider で設定されたデータ ソース情報はクライアントに送信されません。IRVDataSourceProvider の特定の実装によっては、これが大きな影響を与える可能性があります。一般的に言えば、実装が正しいことを確認するには、ChangeDataSource の重要な実装がある場合は、ChangeDataSourceItem も実装し、この ChangeDataSourceItem が dataSourceItem.dataSource オブジェクトで ChangeDataSource を呼び出すようにします。さらに、S3、Rest などのデータ ソースからの CSV、Json、Excel ファイルを操作する場合は、csv/json/excel データ ソース項目で ChangeDataSourceItem への呼び出しを受け取る可能性があることを考慮してください。その場合、dataSourceItem.resourceItem が適切に変更されていることを確認する必要があります。これは、dataSourceItem.resourceItem.dataSource に対して ChangeDataSource を呼び出すことも意味します。
+* IRVDataSourceProvider には、ChangeDataSourceAsync の実装が必要になりました。
+* ASP.NET SDK のインストーラーはリリースされなくなりました。開始するには、https://help.revealbi.io/web/getting-started-server/ でドキュメントを確認してください。
+
+### バグ修正
+
+#### すべてのプラットフォーム
+* ヘッドレス エクスポート: 横向きがデフォルトの向きになりました。
+* 新しいカテゴリ チャートの修正とパフォーマンスの向上。
+* クライアントではなく IRVDataSourceProvider の MsSql プロバイダーで Host プロパティを設定するとエラーが発生する問題。
+* Schema プロパティが dataSourceItem で設定されていない場合、Redshift クエリは失敗します (デフォルトの 'public' スキーマを使用する必要があります)。
+* 財務チャートが正しく機能していませんでした。
+* host プロパティは、RVSqlServerDataSource の IRVAuthenticationProvider で常に null の値を持っていました。
+* すべてのデータベース データ ソースでは、DataSourceItem で Database プロパティを設定する必要がありました (DataSource で設定されている場合でも)。現在、プロパティは DataSourceItem で非推奨になり、Database で設定するだけで機能します。
+* リンクされたダッシュボードを開くとクラッシュする問題。
+* Redshift/Postgres データを示すツリーマップが失敗した問題。
+* Redshift または Postgres で標準偏差集計を使用すると、エラーが発生する問題。
+* IRVDataSourceProvider を使用して Excel データ ソースに別のシートを設定しても機能しませんでした。
+* 表示形式エディター モードで、タイトルと統計アイコンの間の空白スペースをクリックするとエラーが発生する問題。
+* 新しい表示形式 (空白のタイトルとして初期化されている場合) のタイトルを変更できない問題。
+* JSON 属性名が数字で始まる場合、抽出される値は常に空である問題。
+* データ ブレンド フィールド パネルがマウス ホイールまたはトラックパッドでスクロールしない問題。
+* 編集モードでフィルターが 10 個以上ある場合、フィルターを移動できない問題。
+* カスタム クエリ プロパティが構成された Sybase ds 項目ラッパーがすべてのデータを返す問題。
+* Analysis Services データ ソースの置き換えが機能しない問題。
+* Dynamics CRM - データ ソース項目を使用してデータを取得しようとすると、NRE がスローされる問題。
+* DashboardEmptyState に画像が設定されていない場合に例外がスローされる問題。
+* RVReportingServicesDataSourceItem には、パラメーターを設定するためのプロパティが表示されない問題。
+* RVReportingServicesDataSourceItem を使用して PDF レポートをレンダリングすることはできない問題。
+* DataSource WebResource URL の代わりに 「No Url specified for web resource」エラーが発生する問題。
+* `IRVDataSourceProvider.ChangeDataSourceItemAsync` への呼び出しは、dashboardId 引数に対して常に null を持つ問題。
+* KPI インジケーター - 「表示するデータがありません。」のスタイルが間違っている問題。
+* オプションの選択を開始すると、一部のグローバル フィルターがリセットされる問題。
+* カスタム スタイルを含む特定の Excel シートを使用すると、Null 参照例外がスローされる問題。
+* MySQL タイムスタンプ列は、実際にセッションのタイムゾーンにある場合、UTC 日時として読み取られる問題。
+* nuget ファイルには、必要以上の依存関係が含まれている問題。
+* RVRedshiftDataSourceItem を使用すると、Redshift ブレンディングのパフォーマンスが低下する問題。
+* SDK で InMemory データ ソースを使用する際にエラーが発生する問題。
+* Lead の ConvertedDate をフィルターとして使用すると、Salesforce 表示形式でエラーが発生する問題。
+* DS/DSI シナリオの置換後に S3 Excel リソース項目が機能しない問題 (ウィジェットの作成時にシートを選択した後、アプリがロードされたままになる)。
+* Rest API URL はエラーに表示されるべきではありません。
+* d.ts の RVDashboard.visualizations タイプを VisualizationsArray に変更しました。
+
+#### Node
+* Node.js SDK のヘッドレス エクスポートに関するいくつかの改善。Linux/MacOS で利用できるようになりました。
+
+#### Java
+* Snowflake DataSource の 'Schema' プロパティが無視されていた問題。
+* Java SDK の使用時にアセットの表示形式が機能しない問題。
+* タイプ 'timestamptz' の列を使用するテーブルの Redshift クエリは、null 値が含まれている場合に失敗した問題。
+* Java SDK で MaxDownloadSize 制限が無視されている問題。
+
+## 1.4.0 (2023 年 2 月)
+
+### 重大な変更
+* カテゴリ チャートの新しいルック & フィール。以前のルック & フィールは非推奨ですが、何らかの理由で必要な場合は、`revealSdkSettings.enableNewCharts = false` を実行することで復元できます。
+* データ ソース項目のサブタイトルは自動生成されなくなりました。Subtitle プロパティのみが考慮されます。
+
+### 新機能
+
+#### すべてのプラットフォーム
+* フィールドの削除、名前の変更、または並べ替えによって、表示形式エディターに表示されるフィールドのリストをカスタマイズできるようにする新しい API - `onFieldsInitializing` - を追加しました。使用例: 
+```
+revealView.onFieldsInitializing = function (args) {
+	args.fields = args.fields.filter(f => !["Avg.CPC", "Avg. CPC"].some(e => e == f.name));
+};
+```
+* BigQuery、Snowflake、Athena が `CustomQuery` プロパティをサポートするようになりました。
+* Snowflake - SDK からの `Warehouse` プロパティの設定を許可できるようになりました。
+
+#### Node
+* (ベータ版) node.js SDK のヘッドレス エクスポート。現在、Windows プラットフォームでのみ機能します。
+* Node.js SDK で `RVHeadersDataSourceCredentials` が利用可能になりました。
+
+### バグ修正
+
+#### すべてのプラットフォーム
+* 3 番目のデータセットに結合しようとすると、アプリがフリーズする問題。
+* Id プロパティが設定されていない場合に、RVDashboardDataSource を使用するとクラッシュする 問題。(Web のみ)
+* onDateFilterChanged の range パラメーターで送信された日付の時間部分に一貫性がない問題。
+* グローバル フィルター範囲セレクターに一貫性のない日が表示される問題。「今日」または「昨日」を使用すると、2 つの異なる日が表示されました。
+* フィールドが以前のデータ ブレンドからのものである場合、結合に使用されたフィールドがデータ ブレンド エディターに表示されない問題。
+* クライアントで Database プロパティを指定しない限り、Athena DataSourceItem はエラーを発生する問題。(Web のみ)。
+* RVSnowflakeDataSourceItem が正しく機能しない問題。
+
+#### ASP.NET
+* DocumentExportOptions が使用されている場合、ヘッドレス エクスポートは失敗します。
+
+#### Java
+* Snowflake で 「Fail to retrieve row count for first arrow chunk」 というエラーが発生する問題。(Java のみ)
+
+## 1.3.1 (2023 年 1 月)
+
+### 重大な変更
+
+#### ASP.NET
+- `Reveal.Sdk.Web.AspNetCore.Trial` nuget パッケージは、**非推奨**になり、**更新されなくなりました**。
+- 新しい `Reveal.Sdk.AspNetCore` nuget パッケージが [nuget.org](https://www.nuget.org/packages/Reveal.Sdk.AspNetCore) で利用できるようになり、試用版とライセンス版の両方として機能します。試用版のロックを解除するには、SDK でライセンス キーを設定します。ライセンス キーは、Reveal SDK の初期化パラメーターで設定されるようになりました (以前は、これはインストーラーで行われていました)。設定方法は次のとおりです。
+
+```cs
+services
+    .AddMvc()
+        .AddReveal(builder =>
+        {
+            builder
+              .AddSettings(settings =>
+              {
+                  settings.License = "XYZ123";
+              });
+        });	
+```
+
+#### Node
+- `RVUserNamePasswordDataSourceCredential` の名前を `RVUsernamePasswordDataSourceCredential` に変更しました。大文字の「N」を小文字の「n」に変更しました。
+
+### バグ修正
+
+#### すべてのプラットフォーム
+- ヘッドレス エクスポートのいくつかの改善点: 
+	- API を改善しました。
+	- マップを使用した表示形式が正しく表示されるようになりました。
+	- 実行時のメモリ フットプリントが減少しました。
+	- ダッシュボードにタイトルがないとエクスポートが失敗する問題を修正しました。
+- 修正された問題: パラメータを使用した REST データ ソースを作成するときに発生する問題。[戻る] ボタンが押された場合、値はすでに入力されていますが、実際には適用されませんでした。
+- 修正された問題: 有効期限の設定に関係なく、ダッシュボードを開くと、使用可能な値のダッシュボード フィルタ リストが常に更新されていました。
+- 修正された問題: ダッシュボード フィルタの有効期限の値が保存されませんでした。
+- 修正された問題: 最大化してから復元すると、ダッシュボードの水平フィルターが失われます。
+- 修正された問題: キーボード (タブ) を使用して、ダッシュボード ビューのケバブ メニューにアクセスできませんでした。
+- 修正された問題: リンクされた表示形式でダッシュボード フィルターを選択すると、ダッシュボードのリンクが機能しなくなります。
+- 修正された問題: 散布図のマウスオーバー ツールチップに間違った値が表示されます。
+- 修正された問題: MenuOpening イベントをキャンセルしても、実際にはキャンセルされませんでした。
+- 修正された問題: ChangeDataSourceItemAsync メソッドで、userContext パラメーターに null 値が含まれていました。
+
+#### Java
+- 修正された問題: Azure で mssql に接続すると、「Login failed due to client TLS version...」エラーが発生します。
+- 修正された問題: Google アナリティクス 4 を対話的にに追加できませんでした。
+
+## 1.3.0 (2022 年 11 月)
+
+### 新機能
+- バックエンドからダッシュボードをエクスポートできるようににりました:
+
+
+  
+
+```cs
+var pdfStream = await dashboardExporter.ExportToPdf(dashboardId);
+```
+
+  
+
+  
+
+```java
+RevealEngineLocator.dashboardExporter.exportToPdf(dashboardId, new ExportStreamCallback() {
+	@Override
+	public void onSuccess(InputStream stream) {
+		// result PDF to be read from the stream parameter
+	}
+	@Override
+	public void onFailure(Exception e) {
+		// the export failed :(
+	}
+});
+```
+
+  
+
+
+
+
+- 新しいデータ ソース: Google アナリティクス 4。
+- インタラクティブなダッシュボードのフィルタリング。チャートまたはピボット テーブルのデータ ポイントをクリックして、同じデータ ソースを使用してすべての表示形式をフィルター処理します。`revealView.interactiveFilteringEnabled = true` で有効にします。
+- コールバックを含むメソッドには、promise メソッドの処理を可能にする追加の署名が含まれるようになりました。
+
+```javascript
+$.ig.RevealUtility.loadDashboard(dashboardId).then(dashboard => {
+  revealView.dashboard = dashboard;
+});
+```
+
+async/await を使用する場合:
+
+```javascript
+let dashboard = await $.ig.RevealUtility.loadDashboard(dashboardId);
+revealView.dashboard = dashboard;
+```
+
+- `$.ig.revealSdkSettings` から `ensureFontsLoadedAsync` メソッドを使用してデフォルトのフォントを手動でロードする必要はなくなりました。
+- 計算フィールドに新しい 'DateDiff' 関数を追加しました。
+
+### バグ修正
+
+#### すべてのプラットフォーム
+- Postgres & Redshift でブール値をフィルタリングする際のエラー (「演算子が存在しません」) を修正しました。
+- ロケールにハイフンが含まれている場合にローカリゼーションが機能しない問題を修正しました。
+- REST データ ソースから新しい表示形式を作成するときに、`IRVDataSourceProvider.ChangeDataSourceItem` が呼び出されない問題を修正しました。
+- v1.2.3 で誤って追加され、CORS で問題を引き起こしていた新しい http ヘッダー 'XRID' を削除しました。
+
+#### Java
+- sdk-ext: commons-text ライブラリを更新しました。
+- 一部の Excel ファイルを処理するときの応答時間が非常に遅い問題を修正しました。
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/replacing-datasources.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/replacing-datasources.md
new file mode 100644
index 00000000..b8fd7c2e
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/replacing-datasources.md
@@ -0,0 +1,104 @@
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# Replacing Data Sources
+
+When embedding the Reveal SDK in your application, you can replace the connection details of data sources at runtime. This allows you to change various properties of the data source such as the table, port, database, schema, host, file location, and more depending on the data source being used.
+
+The Reveal SDK utilizes the data source provider to give you, the developer, an opportunity to modify the details of a data source. It also provides the [User Context](user-context.md) so that you can use information about the current user, and properties of that user, to load the appropriate data.
+
+A data source provider can be created with two steps:
+
+***Step 1** - Create the data source provider.
+
+
+  
+
+```cs
+public class DataSourceProvider : IRVDataSourceProvider
+{
+    public Task ChangeDataSourceItemAsync(IRVUserContext userContext, string dashboardId, RVDataSourceItem dataSourceItem)
+    {
+      throw new NotImplementedException();
+    }
+
+    public Task ChangeDataSourceAsync(IRVUserContext userContext, RVDashboardDataSource dataSource)
+    {
+      throw new NotImplementedException();
+    }
+}
+```
+
+  
+
+  
+
+```java
+public class DataSourceProvider implements IRVDataSourceProvider {
+
+	public RVDashboardDataSource changeDataSource(IRVUserContext userContext, RVDashboardDataSource dataSource) {
+		return null;
+	}
+
+	public RVDataSourceItem changeDataSourceItem(IRVUserContext userContext, String dashboardsID, RVDataSourceItem dataSourceItem) {
+		return null;
+	}
+}
+```
+
+  
+
+      
+
+```ts
+const dataSourceProvider = async (userContext: IRVUserContext | null, dataSource: RVDashboardDataSource) => {
+	return null;
+}
+
+const dataSourceItemProvider = async (userContext: IRVUserContext | null, dataSourceItem: RVDataSourceItem) => {
+	return null;
+}
+```
+
+  
+
+
+
+**Step 2** - Register the data source provider with the Reveal SDK.
+
+
+  
+
+```cs
+builder.Services.AddControllers().AddReveal( builder =>
+{
+    builder.AddDataSourceProvider();
+});
+```
+
+  
+
+  
+
+```java
+RevealEngineInitializer.initialize(new InitializeParameterBuilder().
+    setDataSourceProvider(new DataSourceProvider()).
+    build());
+```
+
+  
+
+      
+
+```ts
+const revealOptions: RevealOptions = {
+	dataSourceProvider: dataSourceProvider,
+	dataSourceItemProvider: dataSourceItemProvider,
+}
+app.use('/', reveal(revealOptions));
+```
+
+  
+
+
+
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/saving-dashboards.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/saving-dashboards.md
new file mode 100644
index 00000000..e646418c
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/saving-dashboards.md
@@ -0,0 +1,404 @@
+# ダッシュボードの保存
+
+ダッシュボードの保存は、アプリケーションの `RevealView` コントロール内の保存ボタンを使用してエンドユーザーによって呼び出されます。
+
+`RevealView` でサポートされている保存操作には次の 2 種類があります:
+- **保存** - 現在のダッシュボードを保存し、ディスク上の現在の **.rdash** ファイルを上書きします。
+- **名前を付けて保存** - 現在のダッシュボードを新しい **.rdash** ファイルとしてディスクに保存します。元の **.rdash** ファイルはそのままにしておきます。
+
+エンドユーザーが編集モードのときに、`RevealView` の右上隅にある**チェック ボタン**をクリックすると、**保存**操作が呼び出されます。
+
+![](images/saving-save-button.jpg)
+
+エンドユーザーが `RevealView` の右上隅にある**ケバブ メニュー**を開き、**[名前を付けて保存]** メニュー項目を選択すると、**名前を付けて保存**操作が呼び出されます。
+
+![](images/saving-saveas-button.jpg)
+
+## 保存の実装
+サーバーの **Dashboards** フォルダーにダッシュボードを保存するという規約に従う場合、Reveal SDK はデフォルトの**保存**機能を提供します。ただし、ダッシュボードをサーバーの **Dashboards** フォルダーに保存せず、カスタムの `IRVDashboardProvider` を作成している場合は、独自のカスタム保存ロジックを実装する必要があります。[ダッシュボードの読み込み](loading-dashboards.md)トピックでは、カスタムの保存場所からダッシュボードを読み込む方法について説明します。
+
+まず、既存の `IRVDashboardProvider` クラスを変更して、`IRVDashboardProvider.SaveDashboardAsync` メソッドを実装します。この例では、ダッシュボード ファイルを **MyDashboards** という名前のフォルダーに保存しています。
+
+```cs
+public class DashboardProvider : IRVDashboardProvider
+{
+    public Task GetDashboardAsync(IRVUserContext userContext, string dashboardId)
+    {
+        var filePath = Path.Combine(Environment.CurrentDirectory, $"MyDashboards/{dashboardId}.rdash");
+        var dashboard = new Dashboard(filePath);
+        return Task.FromResult(dashboard);
+    }
+
+    public async Task SaveDashboardAsync(IRVUserContext userContext, string dashboardId, Dashboard dashboard)
+    {
+        var filePath = Path.Combine(Environment.CurrentDirectory, $"MyDashboards/{dashboardId}.rdash");
+        await dashboard.SaveToFileAsync(filePath);
+    }
+}
+```
+
+## 名前を付けて保存の実装
+Reveal SDK は、デフォルトで**保存**機能を提供します。ただし、Reveal SDK は、エンドユーザーからダッシュボードの新しいファイル名をキャプチャする必要があるため、**名前を付けて保存**の実装を提供しません。つまり、開発者は、クライアント アプリケーション内で **名前を付けて保存**の操作を実行するために必要なすべてのコードを記述する必要があります。
+
+Reveal SDK で**名前を付けて保存**を実行するには、次の 2 つの方法があります:
+- 新しいファイル名をキャプチャしてから、`IRVDashboardProvider` 実装を使用してサーバーに保存を実行します。
+- 新しいファイル名をキャプチャし、カスタム保存ロジックを使用してダッシュボードを手動でシリアル化します。
+
+カスタム保存ロジックを実装する場合、つまりダッシュボードを手動でシリアル化し、結果をカスタム REST サービスエンドポイントに POST/PUT する場合は、`RevealView.serverSideSave` プロパティを `false` に設定する必要があります。これにより、すべての保存操作がクライアント アプリケーションによって制御され、サーバーに存在する可能性のある `IRVDashboardProvider` 実装を使用しないことが Reveal SDK に指示されます。
+
+```js
+revealView.serverSideSave = false;
+```
+
+クライアントで保存操作を実行するには、`RevealView.onSave` イベントにイベント ハンドラーを追加する必要があります。
+
+```js
+revealView.onSave = (rv, args) => {
+    //handle save
+};
+```
+
+`RevealView.onSave` イベントは、`RevealView` と `DashboardSaveEventArgs` の 2 つのパラメーターを提供します。
+
+`DashboardSaveEventArgs` オブジェクトは、ダッシュボードの保存に役立つ次のプロパティとメソッドを提供します:
+- **name** - これは現在のダッシュボードのタイトル (`RevealView` のダッシュボードの上部に表示されるテキスト) です。**.rdash** の名前がダッシュボードのタイトルと一致することが重要です。
+- **dashboardId** - 保存されているダッシュボードの Id。既存のダッシュボードの場合、これは読み込み時に使用される ID です。新しいダッシュボードまたは名前を付けて保存の操作の場合、値は null になります。このプロパティの値は、既存のダッシュボードを「名前を付けて保存」するとき、または新規ダッシュボードを保存するときに、saveFinished を呼び出す前に設定する必要があります。設定しないと、ダッシュボード名と一致すると見なされます。
+- **isNew** - このイベントが新しく作成されたダッシュボードを保存することによって発生したかどうかを示すフラグ。既存のダッシュボードを保存または名前を付けて保存する場合は false になります。
+- **saveAs** - これが**名前を付けて保存**操作であるかどうかを判別します。
+- **serialize(bytes => { })** - 現在のダッシュボードをカスタム保存ロジックで使用できる `byte[]` に​​シリアル化します。**保存**操作で使用されます。
+- **serializeWithNewName(name, bytes => { })** - `name` と `dashboardId` を変更し、ダッシュボードをカスタム保存ロジックで使用できる `byte []` に​​シリアル化します。現在読み込まれているダッシュボードの `name` または `dashboardId` は変更しません。保存操作中にこれを手動で行う必要があります。**名前を付けて保存**操作で使用されます。
+- **saveFinished() - REQUIRED** - このメソッドは、`RevealView` を編集モードから表示モードにし、保存が完了したことを示します。
+
+## 保存を無効にする
+編集を無効にするか、**[名前を付けて保存]** UI 要素を非表示にすることで、エンドユーザーが**保存**または**名前を付けて保存**の操作を呼び出さないようにすることができます。
+
+**保存**操作を無効にするには、`RevealView.canEdit` プロパティを `false` に設定して、編集を完全に無効にする必要があります。
+
+```js
+revealView.canEdit="false";
+```
+
+**名前を付けて保存**の操作を無効にするには、`RevealView.canSaveAs` プロパティを `false` に設定する必要があります。
+
+```js
+revealView.canSaveAs="false";
+```
+
+## 例: IRVDashboardProvider を使用した保存の実装
+この例では、クライアント アプリケーションに**保存**と**名前を付けて保存**の両方を実装しますが、実際の保存を実行するには、サーバーの `IRVDashboardProvider` 実装に依存します。
+
+ASP.NET Core Web API サーバー アプリケーションで、`IRVDashboardProvider` インターフェイスを実装する新しいクラスを作成します。`GetDashboardAsync` メソッドで、カスタム ファイル ディレクトリからダッシュボードを読み込むおよび保存するロジックを追加します。この例では、ASP.NET Core Web API サーバー アプリケーションは **MyDashboards** という名前のフォルダーを使用してすべてのダッシュボードを格納します。
+
+```cs
+public class DashboardProvider : IRVDashboardProvider
+{
+    public Task GetDashboardAsync(IRVUserContext userContext, string dashboardId)
+    {
+        var filePath = Path.Combine(Environment.CurrentDirectory, $"MyDashboards/{dashboardId}.rdash");
+        var dashboard = new Dashboard(filePath);
+        return Task.FromResult(dashboard);
+    }
+
+    public async Task SaveDashboardAsync(IRVUserContext userContext, string dashboardId, Dashboard dashboard)
+    {
+        var filePath = Path.Combine(Environment.CurrentDirectory, $"MyDashboards/{dashboardId}.rdash");
+        await dashboard.SaveToFileAsync(filePath);
+    }
+}
+```
+
+`RevealSetupBuilder.AddDashboardProvider` メソッドを使用して、作成した `IRVDashboardProvider` を `RevealSetupBuilder` に追加するよう、`Program.cs` ファイルの `AddReveal` メソッドを更新します。
+
+```cs
+builder.Services.AddControllers().AddReveal( builder =>
+{
+    builder.AddDashboardProvider();
+});
+```
+
+次に、クライアント アプリケーションを開き、`RevealView.onSave` イベントのイベント ハンドラーを追加し、`DashboardSaveEventArgs.saveAs` プロパティをチェックして、**保存**または**名前を付けて保存**の操作を処理しているかどうかを確認します。
+
+```js
+revealView.onSave = (rv, args) => {
+    if (args.saveAs) {
+
+    }
+    else {
+        
+    }
+};
+```
+
+まず、**保存**機能を実装することから始めましょう。これは、`DashboardSaveEventArgs.saveFinished` を呼び出すだけで実行できます。これにより、`IRVDashboardProvider` で提供されるサーバー側の保存コードが呼び出され、編集モードが終了します。
+
+```js
+revealView.onSave = (rv, args) => {
+    if (args.saveAs) {
+        //todo
+    }
+    else {
+        args.saveFinished();
+    }
+};
+```
+
+それでは、**名前を付けて保存**機能を実装しましょう。**名前を付けて保存**を実装する最初の手順は、一意のファイル名を処理していることを確認することです。ダッシュボード名がすでに存在するかどうかをクライアント アプリケーションに通知する REST エンドポイントを ASP.NET Core Web API サーバーに追加しましょう。`Program.cs` ファイルを開き、次のコードを追加します:
+
+```cs
+app.Map("/isduplicatename/{name}", (string name) =>
+{
+    var filePath = Path.Combine(Environment.CurrentDirectory, "MyDashboards");
+    return File.Exists($"{filePath}/{name}.rdash");
+});
+```
+
+また、新しい API を呼び出す関数をクライアント アプリケーションに追加する必要があります。
+
+```js
+function isDuplicateName(name) {
+    return fetch(`https://localhost:7111/isduplicatename/${name}`).then(resp => resp.text());
+}
+```
+
+それでは、**名前を付けて保存**の操作の実装を始めましょう。まず、エンドユーザーから新しい名前を取得しましょう。次に、ユーザーが指定した名前が重複していないかどうかを確認します。重複している場合は、既存のファイルを上書きするようにユーザーにプロンプトを出します。エンドユーザーが既存のダッシュボード ファイルを上書きしたくない場合は、`return` ステートメントを呼び出して保存プロセスをキャンセルします。
+
+```js
+if (args.saveAs) {
+    var newName = prompt("Please enter the dashboard name");
+    isDuplicateName(newName).then(isDuplicate => {
+        if (isDuplicate === "true") {
+            if (!window.confirm("A dashboard with name: " + newName + " already exists. Do you want to override it?")) {
+                return;
+            }
+        }
+
+        //todo - perform save
+    }
+}
+```
+
+**名前を付けて保存**の操作を完了するには、`DashboardSaveEventArgs.dashboardId` と `DashboardSaveEventArgs.name` をダッシュボードの新しい名前に設定しましょう。これにより、現在 `RevealView` に読み込まれているダッシュボードが更新され、サーバーに保存されているファイルと一致します。次に、`DashboardSaveEventArgs.saveFinished` メソッドを呼び出します。このメソッドは、`IRVDashboardProvider` で提供されるサーバー側の保存コードを呼び出し、編集モードを終了します。
+
+```js
+args.dashboardId = args.name = newName;
+args.saveFinished();
+}
+```
+
+`RevealView.onSave` イベントの最終的なコードは次のようになります。
+
+```js
+revealView.onSave = (rv, args) => {
+    if (args.saveAs) {
+        var newName = prompt("Please enter the dashboard name");
+        isDuplicateName(newName).then(isDuplicate => {
+            if (isDuplicate === "true") {
+                if (!window.confirm("A dashboard with name: " + newName + " already exists. Do you want to override it?")) {
+                    return;
+                }
+            }
+
+            args.dashboardId = args.name = newName;
+            args.saveFinished();
+        });
+
+    }
+    else {
+        args.saveFinished();
+    }
+}
+```
+
+:::info コードの取得
+
+このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/SavingDashboards-Server) にあります。
+
+:::
+
+
+## 例: カスタム保存の実装
+この例では、クライアント アプリケーションに**保存**と**名前を付けて保存**の両方を実装しますが、実際の保存を実行する処理はカスタム実装にします。
+
+カスタム保存機能を実装するための最初の手順は、`revealView.serverSideSave` を `false` に設定することです。これは、クライアントが保存操作を処理することを Reveal SDK に通知します。
+
+```js
+revealView.serverSideSave = false;
+```
+
+次に、保存イベントのイベント ハンドラーを追加し、`DashboardSaveEventArgs.saveAs` プロパティを確認して、**保存**または**名前を付けて保存**の操作を処理しているかどうかを確認します。
+
+```js
+revealView.onSave = (rv, args) => {
+    if (args.saveAs) {
+
+    }
+    else {
+        
+    }
+};
+```
+
+まず、**保存**機能を実装することから始めましょう。まず、ダッシュボードのサーバーへの保存を処理する REST サービス エンドポイントを ASP.NET Core Web API サーバー アプリケーションに追加する必要があります。`Program.cs` ファイルを変更し、既存のダッシュボード ファイルの更新を処理する **PUT** ルート エンドポイントをマップします。
+
+このサンプル コードでは、最初にファイルが存在することを確認し、存在しない場合はメソッドを終了します。存在する場合は、リクエストの本文からダッシュボードの `byte[]` 配列を取得する必要があります。`request.Body` からストリームを読み取り、`byte []` に格納し、既存のファイルを上書きして変更をディスクに書き込みます。
+
+```cs
+app.MapPut("/dashboards/{name}", async (HttpRequest request, string name) =>
+{
+    var filePath = Path.Combine(Environment.CurrentDirectory, $"Dashboards/{name}.rdash");
+    if (!File.Exists(filePath))
+        return;
+
+    byte[] bytes;
+    using (var ms = new MemoryStream())
+    {
+        await request.Body.CopyToAsync(ms);
+        bytes = ms.ToArray();
+    }
+
+    using (var stream = File.Open(filePath, FileMode.Open))
+    {
+        stream.Write(bytes, 0, bytes.Length);
+    }
+});
+```
+
+次に、保存を実行する関数をクライアント アプリケーションに追加しましょう。この関数は、**保存**操作と**名前を付けて保存**の操作の両方を処理します。この関数には、ダッシュボードの `name`、ダッシュボードの内容を表す `byte[]`、およびこれが**保存**または**名前を付けて保存**の操作であるかどうかを判別する `isSaveAs` のパラメーターがあります。**名前を付けて保存**の操作の場合、リクエストの`メソッド`を **POST** に設定します。これは、新しいファイルが作成されることを示します。
+
+```js
+function saveDashboard(name, bytes, isSaveAs = false) {
+
+    let url = `https://localhost:7111/dashboards/${name}`;
+    let params = {
+        body: bytes,
+        method: "PUT"
+    }
+
+    if (isSaveAs) {
+        params.method = "POST"
+    }
+
+    return fetch(url, params);
+}
+```
+
+`RevealView.onSave` イベントに**保存**ロジックを実装しましょう。まず、`DashboardSaveEventArgs.serialize` メソッドを呼び出して現在のダッシュボードを `byte[]` に​​シリアル化して、REST サービス エンドポイントに送信できるようにする必要があります。`DashboardSaveEventArgs.serialize` メソッドのコールバックで、前に作成した `saveDashboard` 関数を呼び出し、`DashboardSaveEventArgs.name` と `byte[]` を引数として渡します。`saveDashboard` が完了すると、`DashboardSaveEventArgs.saveFinished` メソッドを呼び出します。このメソッドは、保存が完了したことを Reveal SDK に通知し、`RevealView` を編集モードから外します。
+
+```js
+revealView.onSave = (rv, args) => {
+    if (args.saveAs) {
+        //todo
+    }
+    else {
+        args.serialize(bytes => {
+            this.saveDashboard(args.name, bytes).then(() => {
+                args.saveFinished();
+            });
+        });
+    }
+};
+```
+
+それでは、**名前を付けて保存**機能を実装しましょう。**名前を付けて保存**を実装する最初の手順は、一意のファイル名を処理していることを確認することです。ダッシュボード名がすでに存在するかどうかをクライアント アプリケーションに通知する REST エンドポイントを ASP.NET Core Web API サーバーに追加しましょう。`Program.cs` ファイルを開き、次のコードを追加します:
+
+```cs
+app.Map("/isduplicatename/{name}", (string name) =>
+{
+    var filePath = Path.Combine(Environment.CurrentDirectory, "Dashboards");
+    return File.Exists($"{filePath}/{name}.rdash");
+});
+```
+
+また、新しい API を呼び出す関数をクライアント アプリケーションに追加します。
+
+```js
+function isDuplicateName(name) {
+    return fetch(`https://localhost:7111/isduplicatename/${name}`).then(resp => resp.text());
+}
+```
+
+それでは、**名前を付けて保存**の操作の実装を始めましょう。まず、エンドユーザーから新しい名前を取得しましょう。次に、ユーザーが指定した名前が重複していないかどうかを確認します。重複している場合は、既存のファイルを上書きするようにユーザーにプロンプトを出します。エンドユーザーが既存のダッシュボード ファイルを上書きしたくない場合は、保存プロセスをキャンセルします。まず、`DashboardSaveEventArgs.saveFinished` メソッドを呼び出して、`RevealView` を強制的に編集モードを終了させてから、`return` を実行して、保存操作を実行せずに保存イベントを終了します。
+
+```js
+if (args.saveAs) {
+    var newName = prompt("Please enter the dashboard name");
+    isDuplicateName(newName).then(isDuplicate => {
+        if (isDuplicate === "true") {
+            if (!window.confirm("A dashboard with name: " + newName + " already exists. Do you want to override it?")) {
+                args.saveFinished();
+                return;
+            }
+        }
+
+        //todo - perform save
+    });
+}
+```
+
+**名前を付けて保存**の操作を完了するには、別の REST サービス エンドポイントを ASP.NET Core Web API サーバーに追加して **POST** を処理する必要があります。`Program.cs` ファイルを変更し、新しいダッシュボード ファイルの保存を処理する **POST** ルート エンドポイントをマップします。
+
+このサンプル コードでは、リクエストの本文からダッシュボード `byte[]` を取得することを想定しています。`request.Body` からストリームを読み取り、`byte[]` に格納し新しいダッシュボード ファイルを保存します。
+
+```cs
+app.MapPost("/dashboards/{name}", async (HttpRequest request, string name) =>
+{
+    var ms = new MemoryStream();
+    await request.Body.CopyToAsync(ms);
+    var bytes = ms.ToArray();
+
+    var filePath = Path.Combine(Environment.CurrentDirectory, $"Dashboards/{name}.rdash");
+    using (var stream = new FileStream(filePath, FileMode.Create, FileAccess.Write))
+    {
+        await stream.WriteAsync(bytes, 0, bytes.Length);
+    }
+});
+```
+
+クライアント コードを更新して、**名前を付けて保存**操作を完了しましょう。保存を実行する前に、`DashboardSaveEventArgs.dashboardId` と `DashboardSaveEventArgs.name` をダッシュボードの新しい名前に設定しましょう。これにより、現在 `RevealView` に読み込まれているダッシュボードが更新され、サーバーに保存されているファイルと一致します。次に、`DashboardSaveEventArgs.serializeWithNewName` を呼び出して、現在のダッシュボードを `byte[]` にシリアル化する必要があります。このメソッドは、新しい `name` を使用してダッシュボードを `byte[]` にシリアライズし、新しくシリアライズされたダッシュボードのタイトルと ID を更新します。`DashboardSaveEventArgs.serializeWithNewName` メソッドのコールバックで、前に作成した `saveDashboard` 関数を呼び出し、`DashboardSaveEventArgs.name`、`byte[]`、および `true` (名前を付けて保存を示す) を引数として渡します。`saveDashboard` が完了すると、`DashboardSaveEventArgs.saveFinished` メソッドを呼び出します。このメソッドは、保存が完了したことを Reveal SDK に通知し、`RevealView` を編集モードから外します。
+
+```js
+args.dashboardId = args.name = newName;
+args.serializeWithNewName(newName, bytes => {
+    this.saveDashboard(newName, bytes, true).then(() => {
+        args.saveFinished();
+    });
+});
+```
+
+`RevealView.onSave` イベントの最終的なコードは次のようになります。
+
+```js
+revealView.onSave = (rv, args) => {
+    if (args.saveAs) {
+        var newName = prompt("Please enter the dashboard name");
+        isDuplicateName(newName).then(isDuplicate => {
+            if (isDuplicate === "true") {
+                if (!window.confirm("A dashboard with name: " + newName + " already exists. Do you want to override it?")) {
+                    args.saveFinished();
+                    return;
+                }
+            }
+
+            args.dashboardId = args.name = newName;
+            args.serializeWithNewName(newName, bytes => {
+                this.saveDashboard(newName, bytes, true).then(() => {
+                    args.saveFinished();
+                });
+            });
+        });
+    }
+    else {
+        args.serialize(bytes => {
+            this.saveDashboard(args.name, bytes).then(() => {
+                args.saveFinished();
+            });
+        });
+    }
+};
+```
+
+:::info コードの取得
+
+このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/SavingDashboards-Client) にあります。
+
+:::
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/server-export.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/server-export.md
new file mode 100644
index 00000000..077b91b2
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/server-export.md
@@ -0,0 +1,256 @@
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# サーバーのエクスポート
+
+ダッシュボードは、UI を必要とせずに、サーバー上の Excel、PDF、または PowerPoint にエクスポートできます。「ヘッドレス エクスポート」とも呼ばれます。サーバー上のダッシュボードのエクスポートは、`IDashboardExporter` を使用して実行されます。
+
+`IDashboardExporter` は、次のように ASP.NET コントローラーまたは最小限の API 関数に挿入することで取得できます。
+
+```cs
+app.MapGet("/dashboards/export/{name}", async (string name, IDashboardExporter dashboardExporter) =>
+{
+
+}
+```
+
+## ダッシュボードをエクスポートする方法
+`IDashboardExporter` は、ダッシュボードをファイル ストリームとして、またはディスク上のファイル パスにエクスポートするための API を提供します。サポートされている各エクスポート形式には、エクスポート プロセスを簡素化するための API があります。
+
+**Excel**
+```cs
+//export to stream
+var stream = await dashboardExporter.ExportToExcel(dashboardName);
+
+//export to file
+await dashboardExporter.ExportToExcel(dashboardName, filePath);
+```
+
+**PDF**
+```cs
+//export to stream
+var stream = await dashboardExporter.ExportToPdf(dashboardName);
+
+//export to file
+await dashboardExporter.ExportToPdf(dashboardName, filePath);
+```
+
+**PowerPoint**
+```cs 
+//export to stream
+var stream = await dashboardExporter.ExportToPowerPoint(dashboardName);
+
+//export to file
+await dashboardExporter.ExportToPowerPoint(dashboardName, filePath);
+```
+
+:::info
+
+PDF または PowerPoint 形式へのエクスポートには、時間がかかる場合があります。UI からサーバー側のエクスポートを呼び出す場合は、エクスポートが処理中であることを視覚的に示すインジケーターをユーザーに提供してください。
+
+:::
+
+### ユーザー コンテキストの提供
+ダッシュボードには、Reveal SDK [ユーザー コンテキスト](user-context.md)を必要とするデータ ソースがある場合があります。この場合、エクスポート メソッドの引数として Reveal SDK の `IRVUserContext` を指定して、ダッシュボードのエクスポートを確実に成功させる必要があります。
+
+`IRVUserContext` を取得する最初の手順は、`IRVUserContextProvider` と `IHttpContextAccessor` を ASP.NET コントローラーまたは最小限の API 関数に挿入することです。次に、引数として `IHttpContextAccessor.HttpContext` を渡して `IRVUserContextProvider.GetUserContext` を呼び出します。
+
+```cs
+app.MapGet("/dashboards/export/{name}", async (string name, IDashboardExporter dashboardExporter, 
+    IRVUserContextProvider userContextProvider, IHttpContextAccessor httpContextAccessor) =>
+{
+    var userContext = userContextProvider.GetUserContext(httpContextAccessor.HttpContext);
+}
+```
+
+`IRVUserContext` インスタンスを取得したら、それを引数として export メソッドに渡すことができます。
+
+```cs
+//export to stream
+var stream = await dashboardExporter.ExportToExcel(dashboardName, userContext);
+
+//export to file
+await dashboardExporter.ExportToExcel(dashboardName, filePath, userContext);
+```
+
+## エクスポート オプション
+各エクスポート形式は、ダッシュボードをエクスポートする際のさまざまなオプションをサポートしています。たとえば、各ページのヘッダーに著者名を追加したり、各ページのフッターに会社名を追加したりできます。
+
+各エクスポート形式には、特定のオプション オブジェクトがあります:
+- Excel: `ExcelExportOptions` オブジェクトを使用
+- PDF: `PdfExportOptions` オブジェクトを使用
+- PowerPoint: `PowerPointExportOptions` オブジェクトを使用
+
+ダッシュボード エクスポートのオプションを設定するには、エクスポート形式オプション クラスのインスタンスを作成し、それを引数として export メソッドに提供します。
+
+```cs
+//create Pdf options
+var pdfOptions = new PdfExportOptions()
+{
+    Landscape = true
+};
+
+//export Pdf to stream
+var stream = await dashboardExporter.ExportToPdf(dashboardName, options: pdfOptions);
+```
+
+## 例: サーバーでのエクスポート
+この例では、形式に基づいてダッシュボードをエクスポートするサービス エンドポイントを作成します。
+
+サーバー プロジェクト内、ダッシュボード エクスポート用の新しいルートを作成します。ダッシュボード名とエクスポート形式をルート パラメーターとして定義します。また、エクスポートを実行するために `IDashboardExporter` を挿入する必要があります。次に、エクスポート形式のルート パラメーターに基づいて、正しいエクスポートを実行するためのロジックを作成します。エクスポートの結果を返すときは、必ず正しいコンテンツ タイプを指定してください。
+
+
+  
+
+```cs
+app.MapGet("/dashboards/export/{name}", async (string name, string format, IDashboardExporter dashboardExporter) =>
+{
+    Stream stream;
+    string contentType = "application/pdf";
+    if (format=="xlsx")
+    {
+        stream = await dashboardExporter.ExportToExcel(name);
+        contentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+    }
+    else if (format == "pptx")
+    {
+        stream = await dashboardExporter.ExportToPowerPoint(name);
+        contentType = "application/vnd.openxmlformats-officedocument.presentationml.presentation";
+    }
+    else
+    {
+        stream = await dashboardExporter.ExportToPdf(name);
+    }
+    
+    return Results.File(stream, contentType);
+});
+```
+
+  
+
+  
+
+```java
+@Component
+@Path("dashboards/export/")
+public class RevealExportController {
+
+    @GET
+    @Path("{name}")
+    public void getDashboardExport(@Suspended final AsyncResponse response, @PathParam("name") String name, @QueryParam("format") String format) throws IOException {
+        IDashboardExporter exporter = RevealEngineLocator.dashboardExporter;
+
+        if (format.equalsIgnoreCase("xlsx")) {
+            exporter.exportToExcel(name, new ExportStreamCallback() {
+                @Override
+                public void onFailure(Exception e) {
+                    response.resume(e);
+                }
+    
+                @Override
+                public void onSuccess(InputStream stream) {
+                    ResponseBuilder resp = Response.ok(stream).type("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
+                    response.resume(resp.build());
+                } 
+            });
+        }
+        else if (format.equalsIgnoreCase("pptx")) {
+            exporter.exportToPowerPoint(name, new ExportStreamCallback() {
+                @Override
+                public void onFailure(Exception e) {
+                    response.resume(e);
+                }
+    
+                @Override
+                public void onSuccess(InputStream stream) {
+                    ResponseBuilder resp = Response.ok(stream).type("application/vnd.openxmlformats-officedocument.presentationml.presentation");
+                    response.resume(resp.build());
+                } 
+            });            
+        }
+        else {
+            exporter.exportToPdf(name, new ExportStreamCallback() {
+                @Override
+                public void onFailure(Exception e) {
+                    response.resume(e);
+                }
+    
+                @Override
+                public void onSuccess(InputStream stream) {
+                    ResponseBuilder resp = Response.ok(stream).type("application/pdf");
+                    response.resume(resp.build());
+                } 
+            });
+        }
+    }
+}
+```
+
+  
+
+    
+
+```ts
+app.get("/dashboards/export/:name", async (req, resp) => {
+	const name = req.params.name;
+	const format = req.query.format;
+	let stream: ReadStream | void;
+	let contentType = "application/pdf";
+
+	if (format === "xlsx"){
+		contentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";	
+		stream = await revealServer.exporter.exportExcel(name, null, null, null);
+	}
+	else if (format === "pptx") {
+		contentType = "application/vnd.openxmlformats-officedocument.presentationml.presentation";
+		stream = await revealServer.exporter.exportPowerPoint(name, null, null, null);
+	}
+	else {
+		stream = await revealServer.exporter.exportPdf(name, null, null, null);
+	}
+
+	if (stream) {
+		resp.setHeader("Content-Type", contentType);
+		stream.pipe(resp);
+	}
+	else {
+		resp.send(404);
+	}
+});
+```
+
+  
+
+
+
+クライアント アプリケーションで、サービス エンドポイントを呼び出す関数を実行する一連のボタンを作成します。
+```html
+
+
+
+```
+
+この例では、**Sales** という名前のダッシュボードをエクスポートしています。これは、クリックされたボタンによって提供されたエクスポート形式を使用します。
+```js
+function onExportButtonClicked(format) {
+    fetch(`http://localhost:5111/dashboards/export/Sales?format=${format}`)
+    .then(resp => resp.blob())
+    .then(blob => 
+    {
+        downloadFile(blob, format);
+    });
+}
+
+function downloadFile(blob, format) {
+    var a = document.createElement("a");
+    a.download = `Sales.${format}`;
+    a.href = window.URL.createObjectURL(blob);
+    a.click();
+}
+```
+
+:::info コードの取得
+
+このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/Exporting-Server) にあります。
+
+:::
\ No newline at end of file
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/system-requirements.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/system-requirements.md
new file mode 100644
index 00000000..a0197653
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/system-requirements.md
@@ -0,0 +1,23 @@
+# システム要件
+
+## ASP.NET
+- ASP.NET 6.0 またはそれ以降
+
+## Java
+- Java SDK 11.0.10 およびそれ以降 (Spring Boot 3.x では Java SDK 17 以降)
+- Jakarta EE 9 準拠サーバー
+- Maven 3.6.3 およびそれ以降
+
+## Node
+- NodeJS 16.3 およびそれ以降
+
+:::info
+
+Mac M1/M2/M3/M4 で開発する場合は、Rosetta をインストールする必要があります。
+
+Rosetta を手動でインストールするには、ターミナルで次のコマンドを実行します:
+```bash
+/usr/sbin/softwareupdate --install-rosetta --agree-to-license
+```
+
+:::
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/theming-dashboards.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/theming-dashboards.md
new file mode 100644
index 00000000..9d320b32
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/theming-dashboards.md
@@ -0,0 +1,142 @@
+# ダッシュボードのテーマ設定
+
+## 定義済みのテーマ
+
+Reveal SDK には、適用できる 4 つの定義済みテーマが付属しています。
+
+| テーマ              | RevealView                               |
+| -----              | :--------:                               |
+| **Mountain Light** | ![](images/theming-mountain-light.jpg)  |
+| **Mountain Dark**  | ![](images/theming-mountain-dark.jpg)   |
+| **Ocean Light**    | ![](images/theming-ocean-light.jpg)     |
+| **Ocean Dark**     | ![](images/theming-ocean-dark.jpg)      |
+
+## テーマの適用
+
+定義済みのテーマを適用するには、`RevealSdkSetting.theme` プロパティに、希望するテーマのインスタンスを割り当てる必要があります。
+
+##### Mountain Light
+
+```js
+$.ig.RevealSdkSettings.theme = new $.ig.MountainLightTheme();
+```
+
+##### Mountain Dark
+
+```js
+$.ig.RevealSdkSettings.theme = new $.ig.MountainDarkTheme();
+```
+
+##### Ocean Light
+
+```js
+$.ig.RevealSdkSettings.theme = new $.ig.OceanLightTheme();
+```
+
+##### Ocean Dark
+
+```js
+$.ig.RevealSdkSettings.theme = new $.ig.OceanDarkTheme();
+```
+
+:::info
+
+`RevealSdkSetting.theme` プロパティは静的プロパティであり、アプリケーション内の `RevealView` のすべてのインスタンスに適用されます。
+
+:::
+
+## カスタム テーマ
+
+Reveal SDK を既存のアプリケーションに埋め込む場合、ダッシュボードがアプリケーションのルックアンドフィールと一致していることが重要です。定義済みの Reveal SDK テーマのいずれかがアプリケーションのテーマと一致しない場合は、アプリケーションのルックアンドフィールにより近いカスタム テーマを作成できます。
+
+テーマは、`RevealTheme` 型のクラスです。これにより、Reveal SDK UI コントロールのさまざまな要素の色とフォントを定義できます。
+
+`RevealTheme` には次のプロパティがあります:
+
+| 名前                                              | 説明                                                                                                    |
+| ----                                              | -----------                                                                                                    |
+| **chartColors**                                   | 表示形式でシリーズを示すために使用される色。色の数に制限はありません。すべての色が表示形式で使用されると、Reveal はこれらの色の新しい色合いを自動生成します。これにより、色が重複せず、各値に独自の色が設定されます。           |
+| **accentColor**                                   | Reveal のデフォルトのアクセント色は、[+ ダッシュボード] ボタンやその他のインタラクティブなアクションで確認することができる青の色合いです。アプリケーションで使用するのと同じアクセント色に一致するように色を変更できます。                                       |
+| **dashboardBackgroundColor**                      | ダッシュボードの背景色を設定します。これはメインの背景色です。                                |
+| **visualizationBackgroundColor**                  | 表示形式の背景色を設定します。これは二番目の背景色です。                         |
+| **conditionalFormatting**                         | 条件付き書式を使用するときに設定できる境界のデフォルトの色を変更します。                        |
+| **regularFont**                                   | 通常のフォント スタイルを設定します。                                                                                   |
+| **boldFont**                                      | 太字のフォント スタイルを設定します。                                                                                      |
+| **mediumFont**                                    | 中くらいの太さのフォント スタイルを設定します。                                                                                    |
+| **fontColor**                                     | フォントの色を設定します。                                                                                    |
+| **highlightColor**                                | 特定のダッシュボード シナリオ (予測および外れ値の統計関数) の強調色を設定します。     |
+| **visualizationMargin**                                | 表示形式間のマージン サイズをピクセル単位で設定します。     |
+| **useRoundedCorners**                             | ボタン、ツールチップ、コンテナ、表示形式などの隅の丸め有無を設定します。false に設定すると、コーナーは四角になります。                                                                                                                                                                        |
+
+:::info
+
+テーマのプロパティを更新するとき、または実行時に新しいテーマを適用するときは、テーマの変更を `RevealView` に適用するために、`RevealView.refreshTheme` メソッドを呼び出す必要があります。
+
+:::
+
+### 既存のテーマのクローン
+
+既存のテーマの値に基づいてテーマを作成する場合は、変更を加える前に現在の `RevealTheme` のクローンを作成できます。  テーマのクローンを作成するには、`RevealTheme.clone()` メソッドを使用するだけです。テーマのクローンを作成したら、テーマのプロパティを設定して、新しいテーマとして使用できます。
+
+```js
+function cloneCurrentTheme() {
+    var theme = $.ig.RevealSdkSettings.theme.clone();
+
+    theme.fontColor = "#0000cc";
+    theme.accentColor = "#009900";
+    theme.dashboardBackgroundColor = "#ffff66";
+    theme.visualizationBackgroundColor = "#cccccc";
+
+    theme.chartColors = ["rgb(192, 80, 77)", "rgb(101, 197, 235)", "rgb(232, 77, 137)"];
+
+    return theme;
+}
+```
+
+テーマのクローンを作成して変更し、既存のテーマを変更したら、テーマを適用できます。
+
+```js
+$.ig.RevealSdkSettings.theme = this.cloneCurrentTheme();
+```
+
+:::info
+
+`rgb(255, 255, 255)` (RGB) または `#000000` (HEX) 色のいずれかを使用して、色の値を指定できます。
+
+:::
+
+### カスタム テーマの作成
+
+より保守しやすく、再利用と共有が容易なテーマが必要な場合は、カスタム テーマを作成することをお勧めします。カスタム テーマの作成は、`RevealTheme` の新しいクラス インスタンスを作成し、そのプロパティを変更することで実現できます。
+
+カスタム テーマの例を次に示します:
+
+```js
+function createCustomTheme(){
+    var theme = new $.ig.RevealTheme();
+
+    theme.fontColor = "#ff0000";
+    theme.accentColor = "rgb(192, 80, 77)";
+    theme.dashboardBackgroundColor = "#000000";
+    theme.visualizationBackgroundColor = "rgb(153, 255, 255)";
+
+    theme.chartColors = ["rgb(192, 80, 77)", "rgb(101, 197, 235)", "rgb(232, 77, 137)"]
+
+    theme.mediumFont = "Gabriola";
+    theme.boldFont = "Wingdings";
+
+    return theme;
+};
+```
+
+カスタム テーマを作成したら、テーマを適用できます。
+
+```js
+$.ig.RevealSdkSettings.theme = this.createCustomTheme();
+```
+
+:::info コードの取得
+
+このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/ThemingDashboards) にあります。
+
+:::
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/third-party-software.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/third-party-software.md
new file mode 100644
index 00000000..b366135b
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/third-party-software.md
@@ -0,0 +1,83 @@
+
+# Reveal SDK で使用しているサードパーティ ソフトウェア
+
+
+## ASP .NET
+
+| **使用しているコード**| **ライセンス** |
+----------|-------|
+|[Newtonsoft.Json](https://www.newtonsoft.com/json)|[MIT](https://opensource.org/licenses/mit-license.html)|
+|[Microsoft.AspNetCore.Mvc.NewtonsoftJson](https://asp.net/)|[Apache 2.0](https://opensource.org/license/apache-2-0/)|
+|[Antlr4](https://github.com/antlr/antlr4)|[BSD 3-Clause](https://opensource.org/license/bsd-3-clause/)| 
+|[System.Data.SQLite](https://system.data.sqlite.org/index.html/doc/trunk/www/index.wiki)|[Public domain](https://www.sqlite.org/copyright.html)|
+|[System.Security.Principal](https://dot.net/)|[MS .NET Library](https://dotnet.microsoft.com/en-us/dotnet_library_license.htm)|
+|[System.Security.Principal.Windows](https://github.com/dotnet/runtime)|[MIT](https://opensource.org/license/mit/)|
+[System.Text.Encoding.CodePages](https://dot.net/)|[MIT](https://opensource.org/license/mit/)|
+|[AdoNetCore.AseClient.StrongName](https://github.com/DataAction/AdoNetCore.AseClient)|[Apache 2.0](https://opensource.org/license/apache-2-0/)|
+|[Npgsql](https://github.com/npgsql/npgsql)|[PostgreSQL License](https://github.com/npgsql/npgsql/blob/main/LICENSE)|
+[Oracle.ManagedDataAccess](https://github.com/dotnet/corefx)|[Oracle Free Distribution](https://www.nuget.org/packages/Oracle.ManagedDataAccess/21.9.0/License)|
+|[MySqlConnector](https://mysqlconnector.net/)|[MIT](https://opensource.org/license/mit/)|
+|[IG.Data.SqlClient](https://aka.ms/sqlclientproject)|[MIT](https://opensource.org/license/mit/)|
+|[System.IO.Packaging](https://dot.net/)|[MIT](https://opensource.org/license/mit/)|
+|[System.Runtime.Caching](https://dotnet.microsoft.com/en-us/)|[MIT](https://opensource.org/license/mit/)|
+|[Microsoft.AspNetCore.NodeServies](https://asp.net/)|[Apache 2.0](https://opensource.org/license/apache-2-0/)|
+|[System.Drawing.Common](https://github.com/dotnet/runtime)|[MIT](https://opensource.org/license/mit/)|
+|[DocumentFormat.OpenXML](https://github.com/dotnet/Open-XML-SDK)|[MIT](https://opensource.org/license/mit/)|
+|[AngleSharp](https://github.com/AngleSharp/AngleSharp)|[MIT](https://opensource.org/license/mit/)|
+|[System.Text.RegularExpresions](https://dot.net/)|[MS .NET Library](https://dotnet.microsoft.com/en-us/dotnet_library_license.htm)|
+|[log4net](https://logging.apache.org/log4net/)|[Apache 2.0](https://opensource.org/license/apache-2-0/)|
+|[System.Configuration.ConfigurationManager](https://dot.net/)|[MIT](https://opensource.org/license/mit/)|
+|[MongoDB.Driver](https://www.mongodb.com/docs/drivers/csharp/current/)|[Apache 2.0](https://opensource.org/license/apache-2-0/)|
+
+## NodeJS
+
+| **使用しているコード**| **ライセンス** |
+----------|-------|
+|[cors](https://www.npmjs.com/package/cors)|[MIT](https://opensource.org/licenses/mit-license.html)| 
+|[express](https://www.npmjs.com/package/express)|[MIT](https://opensource.org/licenses/mit-license.html)| 
+|[basic-ftp](https://www.npmjs.com/package/basic-ftp)|[MIT](https://opensource.org/licenses/mit-license.html)| 
+|[dotenv](https://www.npmjs.com/package/dotenv)|[BS2-Clause](https://opensource.org/license/bsd-2-clause/)| 
+|[typescript](https://www.npmjs.com/package/typescript)|[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)| 
+|[puppeteer-core](https://www.npmjs.com/package/puppeteer)|[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)| 
+
+
+## Java
+
+| **使用しているコード**| **ライセンス** |
+----------|-------|
+|[net.sourceforge.jexcelapi](https://jexcelapi.sourceforge.net/)|[LGPL](https://opensource.org/license/lgpl-license-html/)| 
+|[net.sourceforge.jtds](https://jexcelapi.sourceforge.net/)|[LGPL](https://opensource.org/license/lgpl-license-html/)| 
+|[org.postgresql](https://jdbc.postgresql.org/)|[BSD-2](https://jdbc.postgresql.org/license/)| 
+|[org.mariadb.jdbc](https://mariadb.com/kb/en/mariadb/about-mariadb-connector-j/)|[LGPL 2.1](https://www.gnu.org/licenses/old-licenses/lgpl-2.1.en.html)| 
+|[net.snowflake](https://docs.snowflake.com/en/user-guide/jdbc)|[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)| 
+|[joda-time](https://www.joda.org/joda-time/index.html)|[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)| 
+|[org.json](https://github.com/stleary/JSON-java)|[Public](https://www.json.org/license.html)| 
+|[org.antlr](https://github.com/antlr/antlr4)|[BSD 3-clause](https://opensource.org/license/bsd-3-clause/)| 
+|[gson](https://github.com/google/gson)|[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)| 
+|[sqlite-jdbc](https://xerial.org/software/)|[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)| 
+|[icu4j](https://unicode-org.github.io/icu/userguide/icu4j/)|[ICU](https://unicode-org.github.io/icu-docs/legal/)| 
+|[java-json-canonicalization](https://github.com/erdtman/java-json-canonicalization)|[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)| 
+|[okhttp](https://square.github.io/okhttp/)|[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)| 
+|[commons-text](https://commons.apache.org/proper/commons-text/)|[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)| 
+|[jackson-core](https://github.com/FasterXML/jackson-core)|[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)| 
+|[jcifs](https://www.jcifs.org/)|[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)| 
+|[servlet-api](https://www.javatpoint.com/servlet-api)|[CDDL](https://opensource.org/license/cddl-1-0/)| 
+|[kxml2](https://github.com/kobjects/kxml2)|[Public](https://github.com/kobjects/kxml2/blob/master/license.txt)| 
+|[javax.servlet.api](https://www.javatpoint.com/jsp-api)|[CDDL](https://opensource.org/license/cddl-1-0/)| 
+|[jersey-media-json-jackson](https://github.com/eclipse-ee4j/jersey/blob/master/media/json-binding/src/main/java/org/glassfish/jersey/jsonb/JsonBindingFeature.java)|[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)|
+|[jersey-media-json-binding](https://github.com/payara/patched-src-jersey/blob/master/media/json-binding/src/main/java/org/glassfish/jersey/jsonb/internal/JsonBindingProvider.java)|[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)|
+|[jersey-container-servlet](https://javadoc.io/doc/org.glassfish.jersey.containers/jersey-container-servlet-core/latest/index.html)|[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)|
+|[jersey-hk2](https://javaee.github.io/hk2/)|[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)|
+|[httpclient](https://hc.apache.org/httpcomponents-client-5.2.x/)|[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)|
+|[playwright](https://github.com/microsoft/playwright)|[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)|
+|[jakarta.ws.rs-api](https://jakarta.ee/specifications/restful-ws/3.0/apidocs/)|[EPL 2.0](https://www.eclipse.org/legal/epl-2.0a)|
+|[slf4j-simple](https://www.slf4j.org/manual.html)|[MIT](https://opensource.org/licenses/mit-license.html)|
+|[resteasy-servlet-initializer](https://github.com/resteasy/Resteasy/blob/main/resteasy-servlet-initializer/src/main/java/org/jboss/resteasy/plugins/servlet/ResteasyServletInitializer.java)|[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)|
+|[jersey-cdi2-se](https://github.com/topics/jersey-cdi2-se)|[Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0)|
+
+## Javascript (client-side) 
+
+| **使用しているコード**| **ライセンス** |
+|----------|-------|
+|[jquery](https://jquery.com/)|[MIT](https://opensource.org/licenses/mit-license.html)|
+|[day.js](https://github.com/iamkun/dayjs)|[MIT](https://opensource.org/licenses/mit-license.html)|
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/toc.yml b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/toc.yml
new file mode 100644
index 00000000..7acfb45d
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/toc.yml
@@ -0,0 +1,94 @@
+- name: 一般
+  header: true
+- name: 概要
+  href: overview.md
+- name: インストール
+  href: installation.md   
+- name: 作業の開始
+  items:
+    - name: サーバーの作成
+      items:
+        - name: ASP.NET Web API
+          href: getting-started-server.md
+        - name: Node.js
+          href: getting-started-server-node.md
+        - name: Node.js - TypeScript
+          href: getting-started-server-node-typescript.md
+        - name: Spring Boot - Jersey
+          href: getting-started-spring-boot-jersey.md
+    - name: Angular
+      href: getting-started-angular.md
+    - name: ASP.NET Core Web App
+      href: getting-started-aspnet.md
+    - name: HTML/JavaScript
+      href: getting-started-javascript.md
+    - name: React
+      href: getting-started-react.md
+- name: サーバーの構成
+  items:
+    - name: ASP.NET
+      href: configuring-server-aspnet.md
+- name: ダッシュボードの使用
+  header: true
+- name: 作成
+  href: creating-dashboards.md
+- name: 読み込み
+  href: loading-dashboards.md
+- name: フィルタリング
+  href: filtering-dashboards.md
+- name: 編集
+  href: editing-dashboards.md
+- name: 保存
+  href: saving-dashboards.md
+- name: リンク
+  href: linking-dashboards.md
+- name: エクスポート
+  href: exporting-dashboards.md
+- name: テーマ設定
+  href: theming-dashboards.md
+- name: データ ソースの使用
+  header: true
+- name: データ ソース
+  href: datasources.md
+- name: データ ソースの追加
+  items:
+    - name: Excel ファイル
+      href: adding-data-sources/excel-file.md
+    - name: インメモリ データ
+      href: adding-data-sources/in-memory-data.md
+    - name: MS SQL Server
+      href: adding-data-sources/ms-sql-server.md
+- name: データ ソースの置き換え
+  items:
+    - name: Excel ファイル
+      href: replacing-data-sources/excel-file.md
+    - name: MS SQL Server
+      href: replacing-data-sources/ms-sql-server.md
+    - name: オブジェクトのエンコード / デコード
+      href: replacing-data-sources/object-encode-decode.md
+- name: 認証
+  href: authentication.md
+- name: ユーザー コンテキスト
+  href: user-context.md
+- name: 表示形式の使用
+  header: true
+- name: 表示形式の最大化
+  href: maximizing-visualizations.md
+- name: クリック イベントへの応答
+  href: click-events.md
+- name: ツールチップ
+  href: tooltips.md
+- name: リリース情報
+  header: true
+- name: サーバー API リファレンス
+  href: api-reference-server.md
+- name: クライアント API リファレンス
+  href: api-reference-client.md
+- name: 既知の問題
+  href: known-issues.md
+- name: リリース ノート
+  href: release-notes.md
+- name: サードパーティ ソフトウェア
+  href: third-party-software.md
+- name: データ サイズの制限
+  href: data-size-limits.md
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/tooltips.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/tooltips.md
new file mode 100644
index 00000000..a399dc8b
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/tooltips.md
@@ -0,0 +1,60 @@
+# ツールチップの作業
+
+ツールチップは、ダッシュボードの表示形式でエンドユーザーがシリーズ上をホバーまたはクリックしたときに表示されるメッセージです。
+
+![](images/tooltips.jpg)
+
+ダッシュボードの表示形式にツールチップが表示されるとき、`RevealView.onTooltipShowing` イベントが呼び出されます。このイベントを処理すると、ツールチップ データの読み取りやツールチップの表示防止が可能になります。
+
+```js
+revealView.onTooltipShowing = (args) => {
+
+};
+```
+
+`TooltipShowingEventArgs` には、次のプロパティが含まれています:
+- **cell** - ツールチップに関連付けられたデータ ポイントを取得します。
+- **row** - ツールチップで提供されるセルデータのコレクションを取得します。
+- **visualization** - ツールチップを表示する表示形式を取得します。
+
+:::info
+
+`RevealView.onTooltipShowing` イベントは、グリッドやゲージなどの、ツールチップをサポートしない表示形式ではトリガーされません。
+
+:::
+
+## ツールチップ データの読み取り
+
+`TooltipShowingEventArgs.cell` および `TooltipShowingEventArgs.row` プロパティなど、`TooltipShowingEventArgs` イベントオブジェクトによって公開されるプロパティを使用することによって、ツールチップの表示に使用されるデータを読み取ることができます。
+
+`TooltipShowingEventArgs.row` プロパティは、ツールチップの各データ ポイントを表す `RVDataCell` オブジェクトのコレクションを提供することを理解することが重要です。
+
+`RVDataCell` クラスには次のプロパティがあります:
+- **columnLabel** - データ ポイントに属する列のラベルまたはカスタム名称
+- **columnName** - データ ポイントに属する列の名前
+- **formattedValue** - データ ポイントの書式設定された値
+- **value** - データ ポイントの元の値
+
+以下の画像は、`RVCell` のプロパティがツールチップに表示されるデータにマップする方法を示しています。
+
+![](images/tooltips-row-property.jpg)
+
+## ツールチップを表示しないようにする
+すべての表示形式または特定の表示形式でツールチップが表示されないようにするには、`TooltipShowingEventArgs.cancel` プロパティを `true` に設定します。
+
+この例では、`TooltipShowingEventArgs.visualization.title` プロパティが **Sales** であるかどうかを確認し、もしそうならば `TooltipShowingEventArgs.cancel` プロパティを `true` に設定してツールチップを表示しないようにします。
+
+```js
+revealView.onTooltipShowing = (args) => {
+    if (args.visualization.title == "Sales") {
+             args.cancel = true;
+    }
+};
+```
+
+:::info コードの取得
+
+このサンプルのソース コードは [GitHub](https://github.com/RevealBi/sdk-samples-javascript/tree/main/Tooltips) にあります。
+
+:::
+
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/web/upgrade-guide-v1.6.0.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/upgrade-guide-v1.6.0.md
similarity index 100%
rename from i18n/ja/docusaurus-plugin-content-docs/current/web/upgrade-guide-v1.6.0.md
rename to i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/upgrade-guide-v1.6.0.md
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/user-context.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/user-context.md
new file mode 100644
index 00000000..403db9ee
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/user-context.md
@@ -0,0 +1,454 @@
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# ユーザー コンテキスト
+
+最新の Web アプリケーションを構築する場合、Web クライアントからサーバー アプリケーションにデータを送信することが必要です。1 つのアプローチは HTTP ヘッダーを使用することです。これは、認証トークン (JWT トークンなど)、またはサーバー側コードの実行に必要なユーザー コンテキスト固有の情報を渡すときに非常に役立ちます。リクエスト ヘッダーを使用すると、機密情報を安全な方法で送信できるため、URL やリクエストの本文に機密情報を埋め込む必要がなくなります。
+
+Reveal では、ユーザー コンテキストは、アプリケーションの認証されたユーザーの ID と、特定のユーザーのコンテキストでサーバー リクエストを実行するために必要なその他の重要な情報を含めることができるオブジェクトです。ユーザー コンテキストは、`IRVDashboardProvider`、`IRVAuthenticationProvider`、`IRVDataSourceProvider` などの Reveal SDK プロバイダーで使用して、ユーザーが持つアクセス許可を制限または定義できます。
+
+Reveal SDK 内のユーザー コンテキストは、`IRVUserContextProvider` インターフェイスと `RVUserContext` オブジェクトによって表されます。`RVUserContext` は `IRVUserContext` のデフォルト実装であり、現在のユーザーのユーザー ID を保存する機能と、Reveal SDK の他の領域 (前述の `IRVObjectFilter`、`IRVDashboardProvider`、`IRVDataSourceProvider` など) で使用できるリクエストに関連する追加のプロパティを取得して保存する機能を提供します。
+
+`UserContextProvider` を実装するには、次の手順に従います:
+
+**手順 1** - ユーザー コンテキスト プロバイダーを作成します。
+
+
+  
+
+  ```cs
+  internal class UserContextProvider : IRVUserContextProvider
+  {
+      public IRVUserContext GetUserContext(HttpContext aspnetContext)       
+      {
+          //when using standard auth mechanisms, the userId can be obtained using aspnetContext.User.Identity.Name.
+          var userIdentityName = aspnetContext.User.Identity.Name;
+          var userId = (userIdentityName != null) ? userIdentityName : "guest";
+          
+          var props = new Dictionary() { { "some-property", aspnetContext.Current.Request.Cookies["some-cookie-name"].Value } };
+
+          return new RVUserContext(userId, props);
+      }    
+  }
+  ```
+
+  
+
+  
+
+  ```java
+  public class UserContextProvider extends RVContainerRequestAwareUserContextProvider {
+    @Override
+    protected IRVUserContext getUserContext(ContainerRequestContext requestContext) {
+          // this can be used to store values coming from the request.
+      var props = new HashMap();
+      props.put("some-property", "some-value");
+
+      return new RVUserContext("user identifier", props);
+    }
+  }
+  ```
+
+  
+
+      
+
+  ```js
+  const userContextProvider = (request) => {
+    // this can be used to store values coming from the request.
+    var props = new Map();
+    props.set("some-property", "some-value"); 
+    
+    return new reveal.RVUserContext("user identifier", props);
+  };
+  ```
+
+  
+
+      
+
+  ```ts
+  const userContextProvider = (request:IncomingMessage) => {
+    // this can be used to store values coming from the request.
+    var props = new Map();
+    props.set("some-property", "some-value"); 
+    
+    return new RVUserContext("user identifier", props);
+  };
+  ```
+
+  
+
+
+**手順 2** - ユーザー コンテキスト プロバイダーを Reveal SDK に登録します。
+
+
+  
+
+  ```cs
+  builder.Services.AddControllers().AddReveal( builder =>
+  {
+      builder.AddUserContextProvider();
+  });
+  ```
+
+  
+
+  
+
+  ```java
+  RevealEngineInitializer.initialize(new InitializeParameterBuilder().
+      setUserContextProvider(new UserContextProvider()).
+      build());
+  ```
+
+  
+
+      
+
+  ```js
+  const revealOptions = {
+    userContextProvider: userContextProvider
+  };
+  app.use('/reveal-api/', reveal(revealOptions));
+  ```
+
+  
+
+      
+
+  ```ts
+  const revealOptions: RevealOptions = {
+    userContextProvider: userContextProvider
+  };
+  app.use('/reveal-api/', reveal(revealOptions));
+  ```
+
+  
+
+
+これで、HTTP ヘッダー経由で渡されるコンテキスト固有の情報を取得して保存するようにサーバーが設定されました。サーバー実装を追加したら、クライアント側のコールバック `setAdditionalHeadersProvider` を使用します。
+
+
+#### クライアント側ヘッダーの受け渡し
+
+`UserContextProvider` に値を渡すには、`setAdditionalHeadersProvider` クライアント側コールバック関数を使用します。`setAdditionalHeadersProvider` コールバックは、Reveal サーバーにリクエストが行われる前にオプションで呼び出されるため、サーバー リクエストで追加のヘッダーを返すことができます。
+
+`setAdditionalHeadersProvider` コールバック関数は、次のようにヘッダーを含むオブジェクト配列を返すことが期待されます: `{ 'SessionId': sessionId }`、`{ 'UserId': userId }`、またはカスタム クエリ、ストアド プロシージャー、関数を実行するためのパラメーター。サーバー上で必要な値は、`setAdditionalHeadersProvider` と `UserContextProvider` を組み合わせて使用して送信できます。
+
+
+  
+
+```js
+RevealSdkSettings.setAdditionalHeadersProvider(function (url) {
+  var headers = {};
+  headers["x-header-one"] = "single_value";
+  headers["x-header-two"] = ["value_1", "value_2"];
+  return headers;
+});
+```
+  
+  
+
+```ts
+RevealSdkSettings.setAdditionalHeadersProvider((url: string) => {
+  var headers: Record = {};
+  headers["x-header-one"] = "single_value";
+  headers["x-header-two"] = ["value_1", "value_2"];
+  return headers;
+});
+```
+  
+
+
+## 例: 行レベル セキュリティのためのユーザー コンテキストの実装 
+
+Reveal BI の `IRVUserContextProvider` インターフェイスを使用すると、クライアント側の情報をサーバーに渡すことができます。この情報は、カスタム クエリで、ストアド プロシージャーや関数のパラメーターなどとして使用できます。このドキュメントでは、`IRVUserContextProvider` の使用方法と、クライアントからサーバーにパラメーターを渡す方法について説明します。
+
+このステップバイステップを説明するエンドツーエンドのウェビナーをこちらで視聴できます:
+
+https://youtu.be/q9mbN2kIXFs
+
+### HTML クライアントの作成
+
+以下は、クライアントからサーバーにいくつかのプロパティ値を渡す方法の例です。この場合、orderId、employeeId、customerId の値を持つ 3 つの HTML 選択があります。これらの値は、`setAdditionalHeadersProvider` コールバックでサーバーに渡されます。
+
+```` js 
+$.ig.RevealSdkSettings.setAdditionalHeadersProvider(function (url) {
+    return headers;
+});
+````
+
+`onDataSourcesRequested` に対してリクエストが行われると、各 HTML 選択の選択された値が `headers` 配列に設定されます。
+
+```` js 
+var selectedCustomerId = $('#customerId').val();
+headers["x-header-customerId"] = selectedCustomerId;
+
+var selectedOrderId = $('#orderId').val();
+headers["x-header-orderId"] = selectedOrderId;
+
+var selectedEmployeeId = $('#employeeId').val();
+headers["x-header-employeeId"] = selectedEmployeeId;
+````
+
+これはクライアント側の完全な HTML です。
+
+```html
+
+
+
+    
+    
+    
+    Reveal - Parameters and Stored Procs
+
+
+
+    
+
+      
+
+    
+      
+    

+    
+    
+
+    
+
+
+```
+
+### サーバー上での UserContextProvider の設定
+
+サーバー側では、これらの値がキーと値のペアのプロパティとして取得され、このトピックで前述したように他の関数で使用できるように保存されます。要求された各ヘッダーは、デフォルトの `UserId` プロパティに追加されるか、Dictionary オブジェクトのキーと値のペアとして追加されることに注意してください。
+
+```csharp
+public class UserContextProvider : IRVUserContextProvider
+{
+    IRVUserContext IRVUserContextProvider.GetUserContext(HttpContext aspnetContext)
+    {
+        var userId = aspnetContext.Request.Headers["x-header-customerId"];
+        var orderId = aspnetContext.Request.Headers["x-header-orderId"];
+        var employeeId = aspnetContext.Request.Headers["x-header-employeeId"];
+
+
+        string role = "User";
+        if (userId == "AROUT" || userId == "BLONP")
+        {
+            role = "Admin";
+        }
+
+        var props = new Dictionary() {
+                { "OrderId", orderId },
+                { "EmployeeId", employeeId },
+                { "Role", role } };
+
+        Console.WriteLine("UserContextProvider: " + userId + " " + orderId + " " + employeeId);
+
+        return new RVUserContext(userId, props);
+    }
+}
+```
+
+この例では、`UserContextProvider` クラスは `IRVUserContextProvider` インターフェイスを実装します。`GetUserContext` メソッドは、クライアントから送信されたヘッダーを取得し、ディクショナリに保存します。このディクショナリは他の関数で使用できます。
+
+## ObjectFilterProvider でのユーザー コンテキストの使用
+
+ユーザー コンテキストを `ObjectFilterProvider` で使用すると、`UserContext` プロパティで `role` として設定されたユーザーの role プロパティに基づいてデータをフィルターできます。
+
+```csharp
+public class ObjectFilterProvider : IRVObjectFilter
+{
+    public Task Filter(IRVUserContext userContext, RVDashboardDataSource dataSource)
+    {
+        throw new NotImplementedException();
+    }
+
+    public Task Filter(IRVUserContext userContext, RVDataSourceItem dataSourceItem)
+    {
+        if (userContext?.Properties != null && dataSourceItem is RVSqlServerDataSourceItem dataSQLItem)
+        {
+            if (userContext.Properties.TryGetValue("Role", out var roleObj) &&
+                roleObj?.ToString()?.ToLower() == "user")
+            {
+                var allowedItems = new HashSet { "Customers", "Orders", "Order Details" };
+
+                if ((dataSQLItem.Table != null && !allowedItems.Contains(dataSQLItem.Table)) ||
+                    (dataSQLItem.Procedure != null && !allowedItems.Contains(dataSQLItem.Procedure)))
+                {
+                    return Task.FromResult(false);
+                }
+            }
+        }
+        return Task.FromResult(true);
+    }
+
+}
+```
+
+この例では、`Filter` メソッドはユーザーのロールが 「user」 であるかどうかを確認します。有効な場合は、特定の項目へのアクセスのみが許可されます。
+
+## DataSourceProvider でのユーザー コンテキストの使用
+
+ユーザー コンテキストは、`DataSourceProvider` で `ChangeDataSourceAsync` または `ChangeDataSourceItemAsync` で使用することもできます。
+
+`ChangeDataSourceAsync` で使用すると、データ ソースまたはテナントにアクセスするユーザーのアクセス許可をチェックしたり、トークンから渡されたサーバーまたはホストのプロパティとしてアクセスしたりすることができます。
+
+`ChangeDataSourceItemAsync` で使用される場合、UserContext プロパティは通常、カスタム クエリ、ストアド プロシージャー、または関数呼び出しのパラメーターとして使用されます。
+
+次の例は、その方法を示しています。
+
+```csharp
+using Reveal.Sdk;
+using Reveal.Sdk.Data;
+using Reveal.Sdk.Data.Microsoft.SqlServer;
+
+namespace RevealSdk.Server.Reveal
+
+{
+    internal class DataSourceProvider : IRVDataSourceProvider
+    {
+        public Task ChangeDataSourceItemAsync
+                (IRVUserContext userContext, string dashboardId, RVDataSourceItem dataSourceItem)
+        {
+            if (dataSourceItem is RVSqlServerDataSourceItem sqlDsi)
+            {
+                ChangeDataSourceAsync(userContext, sqlDsi.DataSource);
+
+
+                string idPrefix = dataSourceItem.Id.Substring(0, 2).ToLower();
+                string storedProcName = dataSourceItem.Id.Substring(2);
+
+                if (idPrefix == "sp")
+                {
+                    switch (storedProcName)
+                    {
+                        case "OrdersByCustomer":
+                            sqlDsi.Procedure = "OrdersByCustomer";
+                            sqlDsi.ProcedureParameters = new Dictionary
+                                 {
+                                     { "@CustomerID", userContext.UserId }
+                                 };
+                            break;
+
+                        case "OrderDetails":
+                            int orderID;
+                            if (int.TryParse(userContext.Properties["OrderId"].ToString(), out orderID))
+                            {
+                                sqlDsi.Procedure = "OrderDetails";
+                                sqlDsi.ProcedureParameters = new Dictionary
+                                     {
+                                         { "@OrderID", orderID }
+                                     };
+                            }
+                            break;
+
+                        case "OrdersByEmployee":
+                            int employeeID;
+                            if (int.TryParse(userContext.Properties["EmployeeId"].ToString(), out employeeID))
+                            {
+                                sqlDsi.Procedure = "OrdersByEmployee";
+                                sqlDsi.ProcedureParameters = new Dictionary
+                                     {
+                                         { "@EmployeeID", employeeID }
+                                     };
+                            }
+                            break;
+
+                        default:
+                            // Handle unknown stored procedure
+                            break;
+                    }
+
+                }
+                else if (idPrefix == "cq")
+                {
+                    int employeeID;
+                    if (int.TryParse(userContext.Properties["EmployeeId"].ToString(), out employeeID))
+                    {
+                        sqlDsi.CustomQuery = "Select * from OrderAnalysis where EmployeeID = " + employeeID;
+                    }                    
+                }
+                else if (idPrefix == "tb")
+                {
+                    // Handle Tables or Views
+                }
+                else
+                {
+                    return null;
+                }
+
+
+
+            }
+            return Task.FromResult(dataSourceItem);
+        }
+
+        public Task ChangeDataSourceAsync(IRVUserContext userContext, RVDashboardDataSource dataSource)
+        {
+            if (dataSource is RVAzureSqlDataSource sqlDs)
+            {
+                sqlDs.Host = "server";
+                sqlDs.Database = "database";
+            }
+            return Task.FromResult(dataSource);
+        }
+    }
+}
+```
+
+この例では、`ChangeDataSourceItemAsync` メソッドは、ユーザーのプロパティに基づいてデータ ソース項目を変更します。ユーザーのプロパティを使用して、ストアド プロシージャーとカスタム クエリのパラメーターを設定します。
+
+## セキュリティに関する考慮事項
+
+クライアントからサーバーにパラメーターを渡すときは、セキュリティを考慮することが重要です。
+
+- 入力を検証してサニタイズします。入力が有効で安全に使用できることを確認します。
+- 安全な転送には HTTPS を使用します。これにより、送信中にデータが暗号化され、傍受されなくなります。
+- サーバー側の承認では、ユーザー コンテキストの信頼性と承認を検証する必要があります。これにより、ユーザーが本人であること、および必要な権限を持っていることが保証されます。
+
+詳細については、[Reveal BI SDK ドキュメント](https://help.revealbi.io/api/javascript/latest/)を参照してください。
\ No newline at end of file
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/_beta-message.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/_beta-message.md
new file mode 100644
index 00000000..38803491
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/_beta-message.md
@@ -0,0 +1,5 @@
+:::danger ベータ版の製品
+Reveal SDK の Web Component ラッパーは現在開発中です。最終リリースに向けて改善を重ねておりますので、ぜひ[ご意見・ご要望](https://github.com/RevealBi/reveal-sdk-wrappers/issues)をお寄せください。
+
+ラッパーに関するドキュメントも現在作成中ですが、完成を待たずに皆さまに共有させていただいています。
+:::
\ No newline at end of file
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/index.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/index.md
new file mode 100644
index 00000000..f07631b2
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/index.md
@@ -0,0 +1,25 @@
+import BetaWarning from './_beta-message.md'
+
+# Reveal SDK Web Component ラッパーの概要
+
+
+
+Reveal SDK Web Components ドキュメントへようこそ! このプロジェクトは、Reveal SDK をモダン化し強化することを目的とした[コミュニティ主導](https://github.com/RevealBi/reveal-sdk-wrappers)の取り組みです。Reveal SDK Web Components は、既存の jQuery ベースの `RevealView` コンポーネントを Web Components としてラップし、モダンな Web アプリケーションへの統合をより簡潔かつ効率的にします。 
+
+## Reveal SDK Web Component ラッパーとは？
+
+Reveal SDK Web Component ラッパーとは、Reveal SDK の中核である jQuery ベースの `RevealView` コンポーネントをラップした Web Components 群です。`RevealView` の複雑な機能をモダンな Web Components にカプセル化することで、Reveal の強力な機能をより直感的で開発者に優しい形で利用できるようにします。これにより、内部で使用されている jQuery 実装を意識することなく、Reveal の機能を活用することが可能になります。
+
+## なぜ Reveal SDK Web Components を使うのか?
+
+現在の高速な Web 開発環境においては、シンプルさ、統合のしやすさ、柔軟性が非常に重要です。Reveal SDK Web Components プロジェクトは、既存の jQuery ベースの機能をモダンな Web Components として提供することで、次のようなメリットをもたらします。
+
+1. **操作性の向上**: Reveal SDK Web Components では、Reveal SDK とのやり取りがより簡単になります。これらの Web Components は、jQuery ベースの `RevealView` を直接操作するのではなく、よりアクセスしやすい API を提供します。簡単な HTML タグを使用して複雑なデータ視覚化要素を統合できるようになり、学習曲線や開発時間が大幅に削減されます。
+
+2. **フレームワークとの高い互換性**: Reveal SDK Web Components は、Angular、React、Vue などの主要な JavaScript フレームワークとシームレスに連携できるよう設計されています。Web Component ラッパーにより、基盤となる `RevealView` を互換性の問題なしにこれらのフレームワークに統合できるため、好みの開発環境内で Reveal の機能を最大限に活用できます。
+
+3. **継続的な改善**: Reveal SDK Web Components および基盤となる Reveal API は、コミュニティやお客様からのフィードバックをもとに継続的に改善されています。常に最新の機能や改善点を利用できるため、より洗練されたデータ可視化を実現できます。
+
+## まとめ
+
+Reveal SDK Web Component ラッパーを使用すると、従来の jQuery ベースの `RevealView` の強力な機能を、よりモダンで効率的、かつ開発者に優しい形で活用できます。複雑な実装を意識することなく、高度なデータ可視化の構築に集中できるようになります。今すぐ探索を始め、データを生き生きと見せることがいかに簡単か実感してください!
\ No newline at end of file
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/installation-angular.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/installation-angular.md
new file mode 100644
index 00000000..38e1efad
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/installation-angular.md
@@ -0,0 +1,74 @@
+import BetaWarning from './_beta-message.md'
+
+# Angular に Reveal SDK Web Component ラッパーをインストールする
+
+
+
+Reveal SDK Web Web Component ラッパーを Angular アプリケーションに統合するのは簡単でシームレスです。開始するには以下の手順に従ってください:
+
+## インストール
+
+Reveal SDK Web Components を Angular アプリに追加するには、npm から必要なパッケージをインストールします:
+
+```bash npm2yarn
+npm install reveal-sdk-wrappers-angular
+```
+
+## モジュールのセットアップ
+
+`RevealViewComponent` をインポートして、アプリケーション内のスタンドアロン コンポーネントとして使用します。以下のインポートをアプリケーションのモジュールに追加します:
+
+```ts
+import { NgModule } from '@angular/core';
+import { BrowserModule } from '@angular/platform-browser';
+import { AppComponent } from './app.component';
+//highlight-next-line
+import { RevealViewComponent } from 'reveal-sdk-wrappers-angular';
+
+@NgModule({
+  declarations: [AppComponent],
+  imports: [
+    BrowserModule,
+    //highlight-next-line
+    RevealViewComponent
+  ],
+  providers: [],
+  bootstrap: [AppComponent],
+})
+export class AppModule {}
+```
+
+## Reveal SDK Web Components の使用
+
+これで、Angular アプリケーションで Reveal SDK Web Component ラッパーを使用する準備が整いました。
+
+:::note
+Reveal SDK Angular Web Component ラッパー内のすべてのコンポーネントは、`rva` プレフィックスを使用します。テンプレートにコンポーネントを追加するときは、必ずこのプレフィックスを使用してください。
+:::
+
+### HTML
+
+Reveal SDK Web コンポーネントをテンプレートに追加します:
+
+```html
+
+```
+
+### TypeScript
+
+コンポーネント クラスから読み込むダッシュボードを制御します。
+
+```ts
+import { Component } from '@angular/core';
+
+@Component({
+  selector: 'app-root',
+  templateUrl: './app.component.html',
+  styleUrls: ['./app.component.scss']
+})
+export class AppComponent {
+  dashboard: string = "Sales";
+}
+```
+
+これらの手順により、Reveal SDK Web Component ラッパーが Angular アプリケーションに正常に統合されました。プロジェクトで Reveal の強力なデータ表示形式機能を最大限に活用できるようになりました。その他のコンポーネントと機能を調べて、豊かでインタラクティブなユーザー エクスペリエンスを作成します。
\ No newline at end of file
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/installation-react.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/installation-react.md
new file mode 100644
index 00000000..0dd67c09
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/installation-react.md
@@ -0,0 +1,36 @@
+import BetaWarning from './_beta-message.md'
+
+# React に Reveal SDK Web Component ラッパーをインストールする
+
+
+
+Reveal SDK Web Component ラッパーは、React 開発者にとって自然な体験を保証するため、各コンポーネントの React 対応バージョンを提供しています。ドキュメント全体を通して HTML と React の例を簡単に切り替えることができます。
+
+## インストール
+
+React アプリに Reveal SDK Web Component ラッパーを追加するには、npm から必要なパッケージをインストールします:
+
+```bash npm2yarn
+npm install reveal-sdk-wrappers-react
+```
+
+## Reveal SDK Web Components の使用
+
+すべてのセットアップが完了したら、React アプリケーション内で Reveal SDK Web Component ラッパーを使用できるようになります。以下は、RvRevealView コンポーネントを統合する例です。
+
+```tsx
+import React from 'react';
+import { RvRevealView } from 'reveal-sdk-wrappers-react';
+
+function App() {
+  return (
+    

+      
+    

+  );
+}
+
+export default App;
+```
+
+これらの手順により、Reveal SDK Web Component ラッパーを React アプリケーションに正常に統合できました。これで、Reveal の強力なデータ表示形式機能を活用してプロジェクトを強化できるようになりました。その他のコンポーネントと機能を調べて、豊かでインタラクティブなユーザー エクスペリエンスを作成します。
\ No newline at end of file
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/installation.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/installation.md
new file mode 100644
index 00000000..7fb282b4
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/installation.md
@@ -0,0 +1,66 @@
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+import BetaWarning from './_beta-message.md'
+
+# インストール
+
+
+
+Reveal SDK Web Component ラッパーをプロジェクトに統合するのは簡単です。シンプルなセットアップのために CDN を使用する場合でも、npm 経由でローカルにインストールする場合でも、ニーズに応じた方法をご用意しています。React、Vue、Angular など特定のフレームワークを使用している場合は、それぞれの統合ガイドをご参照ください。
+
+## 前提条件
+
+Reveal SDK Web Component ラッパーが正しく機能するには、Reveal SDK クライアント ライブラリをインストールする必要があります。Reveal SDK Web Component ラッパーは既存の jQuery ベースの RevealView を中心に構築されるため、これらの依存関係は不可欠です。
+
+```html
+
+
+
+
+```
+
+Reveal SDK の設定の詳細については、[インストール ドキュメント](../install-client-sdk.md)を参照してください。
+
+## CDN のインストール
+
+もっとも簡単な導入方法として、CDN を使用することができます。Reveal SDK Web Component ラッパーを HTML に直接読み込むだけで利用可能です。
+
+```html
+
+```
+
+## NPM のインストール
+
+ローカルでのインストールやバージョン管理を行いたい場合は、npm 経由で Reveal SDK Web Component ラッパーを導入できます。
+
+### 手順 1: パッケージのインストール
+Web Component ラッパーをインストールするには、プロジェクト ディレクトリで次のコマンドを実行します。
+```bash npm2yarn
+npm install reveal-sdk-wrappers
+```
+
+### 手順 2: コンポーネントの登録
+インストール後、Web Components をアプリケーションに登録する必要があります。デフォルトでは、すべての Reveal SDK Web Component ラッパーがグローバルに登録され、個別のインポートなしに使用できます。
+```js
+import { defineRevealSdkWrappers } from "reveal-sdk-wrappers";
+defineRevealSdkWrappers();
+```
+
+### 手順 3: バンドル サイズの最適化 (オプション)
+特定のコンポーネントのみをインポートしてバンドル サイズを最適化したい場合は、必要に応じて個々のコンポーネントを登録できます。
+```js
+import { defineRevealSdkWrappers, RvRevealView } from "reveal-sdk-wrappers";
+defineRevealSdkWrappers(RvRevealView);
+```
+
+## コンポーネントの追加
+
+`rv-reveal-view `コンポーネントの使用を開始するには、これを HTML に含めます。
+```html
+
+```
+
+以上の手順に従うことで、Reveal SDK Web Component ラッパーをプロジェクトに統合し、強力なデータ可視化やインタラクティブなダッシュボード機能をすぐに利用できるようになります。SDK の豊富なコンポーネントやカスタマイズ オプションを活用して、ユーザーにとって魅力的でシームレスな体験を提供しましょう。
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/reveal-view/index.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/reveal-view/index.md
new file mode 100644
index 00000000..23b18caf
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/reveal-view/index.md
@@ -0,0 +1,32 @@
+import CodePreview from '@site/src/components/CodePreview'
+import BetaWarning from '../_beta-message.md'
+
+
+
+# Reveal View (Reveal ビュー)
+
+
+
+
+
+```html
+
+```
+
+```tsx
+import { RvRevealView } from "https://esm.sh/reveal-sdk-wrappers-react";
+
+const App = () => {
+    return (
+        
+    );
+};
+```
+
+
+
+::github-api-docs(
+    owner: revealbi,
+    repo: reveal-sdk-wrappers,
+    path: packages/wrappers/src/components/reveal-view/reveal-view.component.ts
+)
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/reveal-view/loading-dashboards.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/reveal-view/loading-dashboards.md
new file mode 100644
index 00000000..c0b6f1f9
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/reveal-view/loading-dashboards.md
@@ -0,0 +1,65 @@
+import CodePreview from '@site/src/components/CodePreview'
+import BetaWarning from '../_beta-message.md'
+
+
+
+# ダッシュボードの読み込み
+
+
+
+## ダッシュボード名で読み込む
+
+
+
+```html
+
+```
+
+```tsx
+import { RvRevealView } from "https://esm.sh/reveal-sdk-wrappers-react";
+
+const App = () => {
+    return (
+        
+    );
+};
+```
+
+
+
+## RVDashboard で読み込む
+
+
+
+```html
+
+```
+
+```js
+$.ig.RVDashboard.loadDashboard("Campaigns", (dashboard) => {
+    const revealView = document.getElementById("viewer");
+    revealView.dashboard = dashboard;
+});
+```
+
+```tsx
+import { RvRevealView } from "https://esm.sh/reveal-sdk-wrappers-react";
+
+declare const $: any;
+
+const App = () => {
+    const [dashboard, setDashboard] = useState();
+
+    useEffect(() => {
+        $.ig.RVDashboard.loadDashboard("Campaigns", (dashboard: any) => {
+            setDashboard(dashboard);
+        });
+    }, [])
+    
+    return (
+        
+    );
+};
+```
+
+
\ No newline at end of file
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/reveal-view/options.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/reveal-view/options.md
new file mode 100644
index 00000000..763d6d15
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/reveal-view/options.md
@@ -0,0 +1,299 @@
+import CodePreview from '@site/src/components/CodePreview'
+import BetaWarning from '../_beta-message.md'
+
+
+
+# オプション
+
+
+
+`RvRevealView` Web コンポーネントは、既存の jQuery コンポーネントをラップして、その使用を簡素化します。これを容易にするために、UI のさまざまな部分を Web に適した方法で制御できる `options` の概念を導入しました。
+
+# Reveal View (Reveal ビュー)
+
+
+
+```html
+
+```
+
+```js
+const options = {
+    canEdit: false,
+    filters: {
+        showFilters: false,
+    },
+    header: {
+        menu: {
+            refresh: false,
+            items: [
+                { 
+                    icon: "https://brianlagunas.com/wp-content/uploads/2019/08/cropped-brian-lagunas-512x512.png", 
+                    title: "Brian's Blog", 
+                    click: () => window.open("https://brianlagunas.com/", "_blank") 
+                },
+            ]}
+    },
+} 
+
+const revealView = document.getElementById("viewer");
+revealView.options = options;
+```
+
+```tsx
+import { RevealViewOptions } from "https://esm.sh/reveal-sdk-wrappers";
+import { RvRevealView } from "https://esm.sh/reveal-sdk-wrappers-react";
+
+const App = () => {
+    const options: RevealViewOptions = {
+        canEdit: false,
+        filters: {
+            showFilters: false,
+        },
+        header: {
+            menu: {
+                refresh: false,
+                items: [
+                    { 
+                        icon: "https://brianlagunas.com/wp-content/uploads/2019/08/cropped-brian-lagunas-512x512.png", 
+                        title: "Brian's Blog", 
+                        click: () => window.open("https://brianlagunas.com/", "_blank") 
+                    },
+                ]}
+        },
+    } 
+
+    return (
+        
+    );
+};
+```
+
+
+
+## RevealView オプション
+
+`RvRevealView` には以下のオプションを設定できます:
+
+```ts
+export interface RevealViewOptions {
+    /**
+     * Enables or disables edit mode for the dashboard.
+     */
+    canEdit?: boolean;
+    /**
+     * Allows the user to save the dashboard.
+     */
+    canSave?: boolean;
+    /**
+     * Allows the user to save the dashboard as a new dashboard.
+     */
+    canSaveAs?: boolean;
+    /**
+     * Configures the data sources available for creating dashboards.
+     */
+    dataSources?: DataSourcesConfig;
+    /**
+     * Enables saving the dashboard on the server.
+     */
+    saveOnServer?: boolean;
+    /**
+     * Starts the DashboardViewer in edit mode.
+     */
+    startInEditMode?: boolean;
+    /**
+     * Starts the DashboardViewer with a new visualization.
+     */
+    startWithNewVisualization?: boolean;
+    header?: HeaderOptions;
+    filters?: FilterOptions;
+    dataSourceDialog?: DataSourceDialogOptions;
+    visualizations?: VisualizationOptions;
+    editor?: EditorOptions;
+}
+```
+
+## DataSourceDialog オプション
+
+以下のオプションを使用して、データ ソース ダイアログの動作を構成します:
+
+```ts
+export interface DataSourceDialogOptions {
+    /**
+     * Displays data sources already defined in the dashboard.
+     */
+    showExistingDataSources?: boolean;
+    /**
+     * Shows the search input in the data source dialog.
+     */
+    showSearch?: boolean;
+}
+```
+
+## エディター オプション
+
+以下のオプションを使用してチャート エディターの動作を変更します:
+
+```ts
+export interface EditorOptions {
+    /**
+     * Customizes the list of chart types in the Chart Types selection dialog.
+     * @param {ChartTypeItem[]} chartTypes - The array of default chart type items.
+     * @returns {ChartTypeItem[]} - An array of processed chart type items.
+     */
+    chartTypes?: (chartTypes: ChartTypeItem[]) => ChartTypeItem[];
+    /**
+     * Removes specific chart types from the default list.
+     */
+    chartTypesToRemove?: ChartType[];
+    /**
+     * Adds custom chart types to the Chart Types selection dialog.
+     */
+    chartTypesToAdd?: ChartTypeCustomItem[];
+    /**
+     * Sets the default chart type for new visualizations.
+     */
+    defaultChartType?: ChartType | string;
+    /**
+     * Shows or hides the f(x) option in numeric values sections.
+     */
+    addPostCalculatedFields?: boolean;
+    /**
+     * Allows or disallows adding new calculated fields to the list.
+     */
+    addCalculatedFields?: boolean;
+    /**
+     * Enables or disables the "Add fields from another data source" button.
+     */
+    dataBlending?: boolean;
+    /**
+     * Shows or hides the edit button for a data source.
+     */
+    editDataSource?: boolean;
+    /**
+     * Enables or disables the "Add fields from a Machine Learning model" button.
+     */
+    machineLearning?: boolean;
+}
+```
+
+## フィルター オプション
+
+以下の設定を使用して、ダッシュボードのフィルター オプションを構成します:
+
+```ts
+export interface FilterOptions {
+    /**
+     * Enables or disables interactive filtering behavior.
+     */
+    interactiveFiltering?: boolean;
+    /**
+     * Shows or hides the filters.
+     */
+    showFilters?: boolean;
+    /**
+     * Allows the user to add a date filter.
+     */
+    addDateFilter?: boolean;
+    /**
+     * Allows the user to add a dashboard filter.
+     */
+    addDashboardFilter?: boolean;
+}
+```
+
+## ヘッダー オプション
+
+以下のオプションを使用してダッシュボードのヘッダー セクションを構成します:
+
+```ts
+export interface HeaderOptions {
+    /**
+     * Allows the user to add a new visualization.
+     */
+    canAddVisualization?: boolean;
+    /**
+     * Shows or hides the header.
+     */
+    showHeader?: boolean;
+    menu?: {
+        /**
+         * Shows or hides the menu.
+         */
+        showMenu?: boolean;
+        /**
+         * Shows or hides the "Export to Image" menu item.
+         */
+        exportToImage?: boolean;
+        /**
+         * Shows or hides the "Export to Excel" menu item.
+         */
+        exportToExcel?: boolean;
+        /**
+         * Shows or hides the "Export to PowerPoint" menu item.
+         */
+        exportToPowerPoint?: boolean;
+        /**
+         * Shows or hides the "Export to PDF" menu item.
+         */
+        exportToPdf?: boolean;
+        /**
+         * Shows or hides the "Refresh" menu item.
+         */
+        refresh?: boolean;
+        /**
+         * Adds custom menu items to the menu.
+         */
+        items?: MenuItem[];
+    };
+}
+```
+
+## 表示形式オプション
+
+以下のオプションを使用して表示形式の設定を調整します:
+
+```ts
+export interface VisualizationOptions {
+    /**
+     * Allows the user to maximize a visualization.
+     */
+    canMaximize?: boolean;
+    /**
+     * Sets the grouping separator between the category and field name. The default is "/".
+     */
+    categoryGroupingSeparator?: string;
+    /**
+     * Shows or hides crosshairs when hovering over a visualization.
+     */
+    crosshairs?: boolean;
+    /**
+     * Shows or hides tooltips when hovering over a visualization.
+     */
+    hoverTooltips?: boolean;
+    /**
+     * Shows or hides the Change Chart Type dropdown.
+     */
+    changeChartType?: boolean;
+    /**
+     * Shows or hides the Statistical Functions dropdown.
+     */
+    statisticalFunctions?: boolean;
+    menu?: {
+        /**
+         * Shows or hides the "Copy" menu item.
+         */
+        copy?: boolean;
+        /**
+         * Shows or hides the "Duplicate" menu item.
+         */
+        duplicate?: boolean;
+        /**
+         * Adds custom menu items to the menu.
+         */
+        items?: MenuItem[];
+    };
+}
+```
+
+これらのオプションを構成することで、`RvRevealView` コンポーネントの動作と外観を特定のニーズに合わせて調整し、よりカスタマイズされたユーザーフレンドリーなエクスペリエンスを提供できます。
\ No newline at end of file
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/visualization-viewer/index.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/visualization-viewer/index.md
new file mode 100644
index 00000000..590c83a4
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/visualization-viewer/index.md
@@ -0,0 +1,30 @@
+import CodePreview from '@site/src/components/CodePreview'
+import BetaWarning from '../_beta-message.md'
+
+# Visualization Viewer (表示形式ビューアー)
+
+
+
+
+
+```html
+
+```
+
+```tsx
+import { RvVisualizationViewer } from "https://esm.sh/reveal-sdk-wrappers-react";
+
+const App = () => {
+    return (
+        
+    );
+};
+```
+
+
+
+::github-api-docs(
+    owner: revealbi,
+    repo: reveal-sdk-wrappers,
+    path: packages/wrappers/src/components/visualization-viewer/visualization-viewer.component.ts
+)
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/visualization-viewer/options.md b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/visualization-viewer/options.md
new file mode 100644
index 00000000..b92559de
--- /dev/null
+++ b/i18n/ja/docusaurus-plugin-content-docs/version-1.8.4/web/web-component-wrappers/visualization-viewer/options.md
@@ -0,0 +1,78 @@
+import CodePreview from '@site/src/components/CodePreview'
+import BetaWarning from '../_beta-message.md'
+
+# オプション
+
+
+
+`RvRevealView` Web コンポーネントは、既存の jQuery コンポーネントをラップして、その使用を簡素化します。これを容易にするために、UI のさまざまな部分を Web に適した方法で制御できる `options` の概念を導入しました。
+
+# Reveal View (Reveal ビュー)
+
+
+
+```html
+
+```
+
+```js
+const options = {
+  crosshairs: true,
+  menu: {
+    showMenu: true,
+    copy: false,
+    exportToExcel: false,
+  },
+};
+
+const viewer = document.getElementById("viewer");
+viewer.options = options;
+```
+
+```tsx
+import { VisualizationViewerOptions } from "https://esm.sh/reveal-sdk-wrappers";
+import { RvVisualizationViewer } from "https://esm.sh/reveal-sdk-wrappers-react";
+
+const App = () => {
+    const options: VisualizationViewerOptions = {
+        crosshairs: true,
+        menu: {
+            showMenu: true,
+            copy: false,
+            exportToExcel: false,
+        },
+    };
+
+    return (
+        
+    );
+};
+```
+
+
+
+## 表示形式ビューアー オプション
+
+`RvVisualizationViewer` には以下のオプションを設定できます:
+
+```ts
+export interface VisualizationViewerOptions {
+  showFilters?: boolean;
+  categoryGroupingSeparator?: string;
+  crosshairs?: boolean;
+  hoverTooltips?: boolean;
+  changeChartType?: boolean;
+  statisticalFunctions?: boolean;
+  menu?: {
+    items?: MenuItem[];
+    copy?: boolean;
+    duplicate?: boolean;
+    exportToExcel?: boolean;
+    exportToImage?: boolean;
+    showMenu?: boolean;
+    refresh?: boolean;
+  };
+}
+```
+
+これらのオプションを構成することで、`RvVisualizationViewer` コンポーネントの動作と外観を特定のニーズに合わせて調整し、よりカスタマイズされたユーザーフレンドリーなエクスペリエンスを提供できます。
diff --git a/package-lock.json b/package-lock.json
index e4128d8f..14da3f2d 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -8,11 +8,11 @@
       "name": "revealbi",
       "version": "0.0.0",
       "dependencies": {
-        "@docusaurus/core": "^3.9.2",
-        "@docusaurus/plugin-google-tag-manager": "^3.9.2",
-        "@docusaurus/preset-classic": "^3.9.2",
-        "@docusaurus/remark-plugin-npm2yarn": "^3.9.2",
-        "@docusaurus/theme-mermaid": "^3.9.2",
+        "@docusaurus/core": "^3.10.0",
+        "@docusaurus/plugin-google-tag-manager": "^3.10.0",
+        "@docusaurus/preset-classic": "^3.10.0",
+        "@docusaurus/remark-plugin-npm2yarn": "^3.10.0",
+        "@docusaurus/theme-mermaid": "^3.10.0",
         "@inkeep/cxkit-docusaurus": "^0.5.20",
         "@mdx-js/react": "^3.0.0",
         "@monaco-editor/react": "^4.4.6",
@@ -22,9 +22,9 @@
         "react-dom": "^18.2.0"
       },
       "devDependencies": {
-        "@docusaurus/module-type-aliases": "^3.9.2",
-        "@docusaurus/tsconfig": "^3.9.2",
-        "@docusaurus/types": "^3.9.2",
+        "@docusaurus/module-type-aliases": "^3.10.0",
+        "@docusaurus/tsconfig": "^3.10.0",
+        "@docusaurus/types": "^3.10.0",
         "docusaurus-node-polyfills": "^1.0.0",
         "typescript": "^5.3.3"
       },
@@ -33,46 +33,46 @@
       }
     },
     "node_modules/@algolia/abtesting": {
-      "version": "1.15.0",
-      "resolved": "https://registry.npmjs.org/@algolia/abtesting/-/abtesting-1.15.0.tgz",
-      "integrity": "sha512-D1QZ8dQx5zC9yrxNao9ER9bojmmzUdL1i2P9waIRiwnZ5fI26YswcCd6VHR/Q4W3PASfVf2My4YQ2FhGGDewTQ==",
+      "version": "1.17.0",
+      "resolved": "https://registry.npmjs.org/@algolia/abtesting/-/abtesting-1.17.0.tgz",
+      "integrity": "sha512-nuhHZdTiCtRzJEe9VSNzyqE9cOQMt01UWBzymFnjbgwrxxZpbGHQde6Oa/y9zyspTCjbUtb7Q5HQek1CLiLyeg==",
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.49.0",
-        "@algolia/requester-browser-xhr": "5.49.0",
-        "@algolia/requester-fetch": "5.49.0",
-        "@algolia/requester-node-http": "5.49.0"
+        "@algolia/client-common": "5.51.0",
+        "@algolia/requester-browser-xhr": "5.51.0",
+        "@algolia/requester-fetch": "5.51.0",
+        "@algolia/requester-node-http": "5.51.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/autocomplete-core": {
-      "version": "1.19.2",
-      "resolved": "https://registry.npmjs.org/@algolia/autocomplete-core/-/autocomplete-core-1.19.2.tgz",
-      "integrity": "sha512-mKv7RyuAzXvwmq+0XRK8HqZXt9iZ5Kkm2huLjgn5JoCPtDy+oh9yxUMfDDaVCw0oyzZ1isdJBc7l9nuCyyR7Nw==",
+      "version": "1.19.8",
+      "resolved": "https://registry.npmjs.org/@algolia/autocomplete-core/-/autocomplete-core-1.19.8.tgz",
+      "integrity": "sha512-3YEorYg44niXcm7gkft3nXYItHd44e8tmh4D33CTszPgP0QWkaLEaFywiNyJBo7UL/mqObA/G9RYuU7R8tN1IA==",
       "license": "MIT",
       "dependencies": {
-        "@algolia/autocomplete-plugin-algolia-insights": "1.19.2",
-        "@algolia/autocomplete-shared": "1.19.2"
+        "@algolia/autocomplete-plugin-algolia-insights": "1.19.8",
+        "@algolia/autocomplete-shared": "1.19.8"
       }
     },
     "node_modules/@algolia/autocomplete-plugin-algolia-insights": {
-      "version": "1.19.2",
-      "resolved": "https://registry.npmjs.org/@algolia/autocomplete-plugin-algolia-insights/-/autocomplete-plugin-algolia-insights-1.19.2.tgz",
-      "integrity": "sha512-TjxbcC/r4vwmnZaPwrHtkXNeqvlpdyR+oR9Wi2XyfORkiGkLTVhX2j+O9SaCCINbKoDfc+c2PB8NjfOnz7+oKg==",
+      "version": "1.19.8",
+      "resolved": "https://registry.npmjs.org/@algolia/autocomplete-plugin-algolia-insights/-/autocomplete-plugin-algolia-insights-1.19.8.tgz",
+      "integrity": "sha512-ZvJWO8ZZJDpc1LNM2TTBdmQsZBLMR4rU5iNR2OYvEeFBiaf/0ESnRSSLQbryarJY4SVxtoz6A2ZtDMNM+iQEAA==",
       "license": "MIT",
       "dependencies": {
-        "@algolia/autocomplete-shared": "1.19.2"
+        "@algolia/autocomplete-shared": "1.19.8"
       },
       "peerDependencies": {
         "search-insights": ">= 1 < 3"
       }
     },
     "node_modules/@algolia/autocomplete-shared": {
-      "version": "1.19.2",
-      "resolved": "https://registry.npmjs.org/@algolia/autocomplete-shared/-/autocomplete-shared-1.19.2.tgz",
-      "integrity": "sha512-jEazxZTVD2nLrC+wYlVHQgpBoBB5KPStrJxLzsIFl6Kqd1AlG9sIAGl39V5tECLpIQzB3Qa2T6ZPJ1ChkwMK/w==",
+      "version": "1.19.8",
+      "resolved": "https://registry.npmjs.org/@algolia/autocomplete-shared/-/autocomplete-shared-1.19.8.tgz",
+      "integrity": "sha512-h5hf2t8ejF6vlOgvLaZzQbWs5SyH2z4PAWygNAvvD/2RI29hdQ54ldUGwqVuj9Srs+n8XUKTPUqb7fvhBhQrnQ==",
       "license": "MIT",
       "peerDependencies": {
         "@algolia/client-search": ">= 4.9.1 < 6",
@@ -80,99 +80,99 @@
       }
     },
     "node_modules/@algolia/client-abtesting": {
-      "version": "5.49.0",
-      "resolved": "https://registry.npmjs.org/@algolia/client-abtesting/-/client-abtesting-5.49.0.tgz",
-      "integrity": "sha512-Q1MSRhh4Du9WeLIl1S9O+BDUMaL01uuQtmzCyEzOBtu1xBDr3wvqrTJtfEceEkA5/Nw1BdGSHa6sDT3xTAF90A==",
+      "version": "5.51.0",
+      "resolved": "https://registry.npmjs.org/@algolia/client-abtesting/-/client-abtesting-5.51.0.tgz",
+      "integrity": "sha512-PKrKlIla1U2J7mFcIQn6N3pWP4oySmkxShnbbDsj/H7818gKbET5KsUwsVoNjWIxHKTJMCTcQ7ekAJ8Ea23NMg==",
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.49.0",
-        "@algolia/requester-browser-xhr": "5.49.0",
-        "@algolia/requester-fetch": "5.49.0",
-        "@algolia/requester-node-http": "5.49.0"
+        "@algolia/client-common": "5.51.0",
+        "@algolia/requester-browser-xhr": "5.51.0",
+        "@algolia/requester-fetch": "5.51.0",
+        "@algolia/requester-node-http": "5.51.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/client-analytics": {
-      "version": "5.49.0",
-      "resolved": "https://registry.npmjs.org/@algolia/client-analytics/-/client-analytics-5.49.0.tgz",
-      "integrity": "sha512-v50elhC80oyQw+8o8BwM+VvPuOo36+3W8VCfR4hsHoafQtGbMtP63U5eNcUydbVsM0py3JLoBaL1yKBK4L01sg==",
+      "version": "5.51.0",
+      "resolved": "https://registry.npmjs.org/@algolia/client-analytics/-/client-analytics-5.51.0.tgz",
+      "integrity": "sha512-U+HCY1K16Km91pIRL1kN6bW6BbGFAF/WhkRSCx4wyl1aFpbrlhSFQs/dAwWbmyBiHWwVWhl7stWHQ1pum5EfMw==",
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.49.0",
-        "@algolia/requester-browser-xhr": "5.49.0",
-        "@algolia/requester-fetch": "5.49.0",
-        "@algolia/requester-node-http": "5.49.0"
+        "@algolia/client-common": "5.51.0",
+        "@algolia/requester-browser-xhr": "5.51.0",
+        "@algolia/requester-fetch": "5.51.0",
+        "@algolia/requester-node-http": "5.51.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/client-common": {
-      "version": "5.49.0",
-      "resolved": "https://registry.npmjs.org/@algolia/client-common/-/client-common-5.49.0.tgz",
-      "integrity": "sha512-BDmVDtpDvymfLE5YQ2cPnfWJUVTDJqwpJa03Fsb7yJFJmbeKsUOGsnRkYsTbdzf0FfcvyvBB5zdcbrAIL249bg==",
+      "version": "5.51.0",
+      "resolved": "https://registry.npmjs.org/@algolia/client-common/-/client-common-5.51.0.tgz",
+      "integrity": "sha512-YPJ3dEuZLCRp846Az94t6Z2gwSNRazP+SmBco7p6SCa4fYrtIE820PDXYZshbNrj2Z8Qfbmv7BQ1Lecl5L3G/w==",
       "license": "MIT",
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/client-insights": {
-      "version": "5.49.0",
-      "resolved": "https://registry.npmjs.org/@algolia/client-insights/-/client-insights-5.49.0.tgz",
-      "integrity": "sha512-lDCXsnZDx7zQ5GzSi1EL3l07EbksjrdpMgixFRCdi2QqeBe42HIQJfPPqdWtwrAXjORRopsPx2z+gGYJP/79Uw==",
+      "version": "5.51.0",
+      "resolved": "https://registry.npmjs.org/@algolia/client-insights/-/client-insights-5.51.0.tgz",
+      "integrity": "sha512-/gEwLlR7fQ7YjOW+ADRZ0NxLDtpTC61FSzlZ01Gdl1kTJfU0Rq3Y/TYqwxGxlQGcUiXtGzrpjxXWh3Y0TZD6NA==",
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.49.0",
-        "@algolia/requester-browser-xhr": "5.49.0",
-        "@algolia/requester-fetch": "5.49.0",
-        "@algolia/requester-node-http": "5.49.0"
+        "@algolia/client-common": "5.51.0",
+        "@algolia/requester-browser-xhr": "5.51.0",
+        "@algolia/requester-fetch": "5.51.0",
+        "@algolia/requester-node-http": "5.51.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/client-personalization": {
-      "version": "5.49.0",
-      "resolved": "https://registry.npmjs.org/@algolia/client-personalization/-/client-personalization-5.49.0.tgz",
-      "integrity": "sha512-5k/KB+DsnesNKvMUEwTKSzExOf5zYbiPg7DVO7g1Y/+bhMb3wmxp9RFwfqwPfmoRTjptqvwhR6a0593tWVkmAw==",
+      "version": "5.51.0",
+      "resolved": "https://registry.npmjs.org/@algolia/client-personalization/-/client-personalization-5.51.0.tgz",
+      "integrity": "sha512-nRwUN1Y2cKyOAFZyIBagkEfZSIhP05nWhT4Rjwl84lcjECssYggftrAODrZ4leakXxSGjhxs/AdaAFEIBqwVFA==",
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.49.0",
-        "@algolia/requester-browser-xhr": "5.49.0",
-        "@algolia/requester-fetch": "5.49.0",
-        "@algolia/requester-node-http": "5.49.0"
+        "@algolia/client-common": "5.51.0",
+        "@algolia/requester-browser-xhr": "5.51.0",
+        "@algolia/requester-fetch": "5.51.0",
+        "@algolia/requester-node-http": "5.51.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/client-query-suggestions": {
-      "version": "5.49.0",
-      "resolved": "https://registry.npmjs.org/@algolia/client-query-suggestions/-/client-query-suggestions-5.49.0.tgz",
-      "integrity": "sha512-pjHNcrdjn7p3RQ5Ql1Baiwfdn9bkS+z4gqONJJP8kuZFqYP8Olthy4G7fl5bCB29UjdUj5EWlaElQKCtPluCtQ==",
+      "version": "5.51.0",
+      "resolved": "https://registry.npmjs.org/@algolia/client-query-suggestions/-/client-query-suggestions-5.51.0.tgz",
+      "integrity": "sha512-pybzYCG7VoQKppo+z5iZOKpW8XqtFxhsAIRgEaNboCnfypKukiBHJAwB+pmr7vMZXBsOHwklGYWwCG82e8qshA==",
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.49.0",
-        "@algolia/requester-browser-xhr": "5.49.0",
-        "@algolia/requester-fetch": "5.49.0",
-        "@algolia/requester-node-http": "5.49.0"
+        "@algolia/client-common": "5.51.0",
+        "@algolia/requester-browser-xhr": "5.51.0",
+        "@algolia/requester-fetch": "5.51.0",
+        "@algolia/requester-node-http": "5.51.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/client-search": {
-      "version": "5.49.0",
-      "resolved": "https://registry.npmjs.org/@algolia/client-search/-/client-search-5.49.0.tgz",
-      "integrity": "sha512-uGv2P3lcviuaZy8ZOAyN60cZdhOVyjXwaDC27a1qdp3Pb5Azn+lLSJwkHU4TNRpphHmIei9HZuUxwQroujdPjw==",
+      "version": "5.51.0",
+      "resolved": "https://registry.npmjs.org/@algolia/client-search/-/client-search-5.51.0.tgz",
+      "integrity": "sha512-DWVIlj6RqcvdhwP0gBU9OpOQPnHdcAk9jlT+z8rsNb2+liWv4eUlfQZ7saGBraFsnygEHD3PtdppIHvqwBAb5w==",
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.49.0",
-        "@algolia/requester-browser-xhr": "5.49.0",
-        "@algolia/requester-fetch": "5.49.0",
-        "@algolia/requester-node-http": "5.49.0"
+        "@algolia/client-common": "5.51.0",
+        "@algolia/requester-browser-xhr": "5.51.0",
+        "@algolia/requester-fetch": "5.51.0",
+        "@algolia/requester-node-http": "5.51.0"
       },
       "engines": {
         "node": ">= 14.0.0"
@@ -185,81 +185,81 @@
       "license": "MIT"
     },
     "node_modules/@algolia/ingestion": {
-      "version": "1.49.0",
-      "resolved": "https://registry.npmjs.org/@algolia/ingestion/-/ingestion-1.49.0.tgz",
-      "integrity": "sha512-sH10mftYlmvfGbvAgTtHYbCIstmNUdiAkX//0NAyBcJRB6NnZmNsdLxdFGbE8ZqlGXzoe0zcUIau+DxKpXtqCw==",
+      "version": "1.51.0",
+      "resolved": "https://registry.npmjs.org/@algolia/ingestion/-/ingestion-1.51.0.tgz",
+      "integrity": "sha512-bA25s12iUDJi/X8M7tWlPRT8GeOhls/yDbdoUqinz27lNqsOlcM1UrAxIKdIZ6lm3sXit+ewPIz1pS2x6rXu8g==",
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.49.0",
-        "@algolia/requester-browser-xhr": "5.49.0",
-        "@algolia/requester-fetch": "5.49.0",
-        "@algolia/requester-node-http": "5.49.0"
+        "@algolia/client-common": "5.51.0",
+        "@algolia/requester-browser-xhr": "5.51.0",
+        "@algolia/requester-fetch": "5.51.0",
+        "@algolia/requester-node-http": "5.51.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/monitoring": {
-      "version": "1.49.0",
-      "resolved": "https://registry.npmjs.org/@algolia/monitoring/-/monitoring-1.49.0.tgz",
-      "integrity": "sha512-RqhGcVVxLpK+lA0GZKywlQIXsI704flc12nv/hOdrwiuk/Uyhxs46KLM4ngip7wutU+7t0PYZWiVayrqBPN/ZQ==",
+      "version": "1.51.0",
+      "resolved": "https://registry.npmjs.org/@algolia/monitoring/-/monitoring-1.51.0.tgz",
+      "integrity": "sha512-zj+RcE5e0NE0/ew6oEOTgOplPHry+w2oi7h0Y87lhdq4E0d7xLS31KVB8kKfCGkrG7AYtZvrcyvLOKS5d0no4Q==",
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.49.0",
-        "@algolia/requester-browser-xhr": "5.49.0",
-        "@algolia/requester-fetch": "5.49.0",
-        "@algolia/requester-node-http": "5.49.0"
+        "@algolia/client-common": "5.51.0",
+        "@algolia/requester-browser-xhr": "5.51.0",
+        "@algolia/requester-fetch": "5.51.0",
+        "@algolia/requester-node-http": "5.51.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/recommend": {
-      "version": "5.49.0",
-      "resolved": "https://registry.npmjs.org/@algolia/recommend/-/recommend-5.49.0.tgz",
-      "integrity": "sha512-kg8omGRvmIPhhqtUqSIpS3regFKWuoWh3WqyUhGk27N4T7q8I++8TsDYsV8vK7oBEzw706m2vUBtN5fw2fDjmw==",
+      "version": "5.51.0",
+      "resolved": "https://registry.npmjs.org/@algolia/recommend/-/recommend-5.51.0.tgz",
+      "integrity": "sha512-/HDgccfye1Rq3bPxaSCsvSEBHzSMmtpM9ZRGRtAuC62Cv+ql/76IWnxjGTDXtqIJ+/j7ZlFYAzq9fkp95wF2SQ==",
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.49.0",
-        "@algolia/requester-browser-xhr": "5.49.0",
-        "@algolia/requester-fetch": "5.49.0",
-        "@algolia/requester-node-http": "5.49.0"
+        "@algolia/client-common": "5.51.0",
+        "@algolia/requester-browser-xhr": "5.51.0",
+        "@algolia/requester-fetch": "5.51.0",
+        "@algolia/requester-node-http": "5.51.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/requester-browser-xhr": {
-      "version": "5.49.0",
-      "resolved": "https://registry.npmjs.org/@algolia/requester-browser-xhr/-/requester-browser-xhr-5.49.0.tgz",
-      "integrity": "sha512-BaZ6NTI9VdSbDcsMucdKhTuFFxv6B+3dAZZBozX12fKopYsELh7dBLfZwm8evDCIicmNjIjobi4VNnNshrCSuw==",
+      "version": "5.51.0",
+      "resolved": "https://registry.npmjs.org/@algolia/requester-browser-xhr/-/requester-browser-xhr-5.51.0.tgz",
+      "integrity": "sha512-nJdW+WBwGlXWMJbxxB7/AJPvNq0lLJSudXmIQCJbmH8jsOXQhRpAtoCD4ceLyJKv3ze9JbQu4Gqu5JDLckuFcw==",
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.49.0"
+        "@algolia/client-common": "5.51.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/requester-fetch": {
-      "version": "5.49.0",
-      "resolved": "https://registry.npmjs.org/@algolia/requester-fetch/-/requester-fetch-5.49.0.tgz",
-      "integrity": "sha512-2nxISxS5xO5DLAj6QzMImgJv6CqpZhJVkhcTFULESR/k4IpbkJTEHmViVTxw9MlrU8B5GfwHevFd7vKL3a7MXQ==",
+      "version": "5.51.0",
+      "resolved": "https://registry.npmjs.org/@algolia/requester-fetch/-/requester-fetch-5.51.0.tgz",
+      "integrity": "sha512-bsBgRI/1h1mjS3eCyfGau78yGZVmiDLmT1aU6dMnk75/T0SgKqnSKNpQ53xKoDYVChGDcNnpHXWpoUSo8MH1+w==",
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.49.0"
+        "@algolia/client-common": "5.51.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/@algolia/requester-node-http": {
-      "version": "5.49.0",
-      "resolved": "https://registry.npmjs.org/@algolia/requester-node-http/-/requester-node-http-5.49.0.tgz",
-      "integrity": "sha512-S/B94C6piEUXGpN3y5ysmNKMEqdfNVAXYY+FxivEAV5IGJjbEuLZfT8zPPZUWGw9vh6lgP80Hye2G5aVBNIa8Q==",
+      "version": "5.51.0",
+      "resolved": "https://registry.npmjs.org/@algolia/requester-node-http/-/requester-node-http-5.51.0.tgz",
+      "integrity": "sha512-zPrIDVPpmKWgrjmWOqpqrhqAhNjvVkjoj+mqw2NBPxEOuKNzP0H+Qz5NJLLTOepBVj1UFedFaF3AUgxLsB9ukQ==",
       "license": "MIT",
       "dependencies": {
-        "@algolia/client-common": "5.49.0"
+        "@algolia/client-common": "5.51.0"
       },
       "engines": {
         "node": ">= 14.0.0"
@@ -450,9 +450,9 @@
       }
     },
     "node_modules/@babel/helper-define-polyfill-provider": {
-      "version": "0.6.6",
-      "resolved": "https://registry.npmjs.org/@babel/helper-define-polyfill-provider/-/helper-define-polyfill-provider-0.6.6.tgz",
-      "integrity": "sha512-mOAsxeeKkUKayvZR3HeTYD/fICpCPLJrU5ZjelT/PA6WHtNDBOE436YiaEUvHN454bRM3CebhDsIpieCc4texA==",
+      "version": "0.6.8",
+      "resolved": "https://registry.npmjs.org/@babel/helper-define-polyfill-provider/-/helper-define-polyfill-provider-0.6.8.tgz",
+      "integrity": "sha512-47UwBLPpQi1NoWzLuHNjRoHlYXMwIJoBf7MFou6viC/sIHWYygpvr0B6IAyh5sBdA2nr2LPIRww8lfaUVQINBA==",
       "license": "MIT",
       "dependencies": {
         "@babel/helper-compilation-targets": "^7.28.6",
@@ -627,22 +627,22 @@
       }
     },
     "node_modules/@babel/helpers": {
-      "version": "7.28.6",
-      "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.28.6.tgz",
-      "integrity": "sha512-xOBvwq86HHdB7WUDTfKfT/Vuxh7gElQ+Sfti2Cy6yIWNW05P8iUslOVcZ4/sKbE+/jQaukQAdz/gf3724kYdqw==",
+      "version": "7.29.2",
+      "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.29.2.tgz",
+      "integrity": "sha512-HoGuUs4sCZNezVEKdVcwqmZN8GoHirLUcLaYVNBK2J0DadGtdcqgr3BCbvH8+XUo4NGjNl3VOtSjEKNzqfFgKw==",
       "license": "MIT",
       "dependencies": {
         "@babel/template": "^7.28.6",
-        "@babel/types": "^7.28.6"
+        "@babel/types": "^7.29.0"
       },
       "engines": {
         "node": ">=6.9.0"
       }
     },
     "node_modules/@babel/parser": {
-      "version": "7.29.0",
-      "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.0.tgz",
-      "integrity": "sha512-IyDgFV5GeDUVX4YdF/3CPULtVGSXXMLh1xVIgdCgxApktqnQV0r7/8Nqthg+8YLGaAtdyIlo2qIdZrbCv4+7ww==",
+      "version": "7.29.2",
+      "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.2.tgz",
+      "integrity": "sha512-4GgRzy/+fsBa72/RZVJmGKPmZu9Byn8o4MoLpmNe1m8ZfYnz5emHLQz3U4gLud6Zwl0RZIcgiLD7Uq7ySFuDLA==",
       "license": "MIT",
       "dependencies": {
         "@babel/types": "^7.29.0"
@@ -1767,9 +1767,9 @@
       }
     },
     "node_modules/@babel/preset-env": {
-      "version": "7.29.0",
-      "resolved": "https://registry.npmjs.org/@babel/preset-env/-/preset-env-7.29.0.tgz",
-      "integrity": "sha512-fNEdfc0yi16lt6IZo2Qxk3knHVdfMYX33czNb4v8yWhemoBhibCpQK/uYHtSKIiO+p/zd3+8fYVXhQdOVV608w==",
+      "version": "7.29.2",
+      "resolved": "https://registry.npmjs.org/@babel/preset-env/-/preset-env-7.29.2.tgz",
+      "integrity": "sha512-DYD23veRYGvBFhcTY1iUvJnDNpuqNd/BzBwCvzOTKUnJjKg5kpUBh3/u9585Agdkgj+QuygG7jLfOPWMa2KVNw==",
       "license": "MIT",
       "dependencies": {
         "@babel/compat-data": "^7.29.0",
@@ -1851,12 +1851,12 @@
       }
     },
     "node_modules/@babel/preset-env/node_modules/babel-plugin-polyfill-corejs3": {
-      "version": "0.14.0",
-      "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-corejs3/-/babel-plugin-polyfill-corejs3-0.14.0.tgz",
-      "integrity": "sha512-AvDcMxJ34W4Wgy4KBIIePQTAOP1Ie2WFwkQp3dB7FQ/f0lI5+nM96zUnYEOE1P9sEg0es5VCP0HxiWu5fUHZAQ==",
+      "version": "0.14.2",
+      "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-corejs3/-/babel-plugin-polyfill-corejs3-0.14.2.tgz",
+      "integrity": "sha512-coWpDLJ410R781Npmn/SIBZEsAetR4xVi0SxLMXPaMO4lSf1MwnkGYMtkFxew0Dn8B3/CpbpYxN0JCgg8mn67g==",
       "license": "MIT",
       "dependencies": {
-        "@babel/helper-define-polyfill-provider": "^0.6.6",
+        "@babel/helper-define-polyfill-provider": "^0.6.8",
         "core-js-compat": "^3.48.0"
       },
       "peerDependencies": {
@@ -1933,18 +1933,6 @@
         "node": ">=6.9.0"
       }
     },
-    "node_modules/@babel/runtime-corejs3": {
-      "version": "7.29.0",
-      "resolved": "https://registry.npmjs.org/@babel/runtime-corejs3/-/runtime-corejs3-7.29.0.tgz",
-      "integrity": "sha512-TgUkdp71C9pIbBcHudc+gXZnihEDOjUAmXO1VO4HHGES7QLZcShR0stfKIxLSNIYx2fqhmJChOjm/wkF8wv4gA==",
-      "license": "MIT",
-      "dependencies": {
-        "core-js-pure": "^3.48.0"
-      },
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
     "node_modules/@babel/template": {
       "version": "7.28.6",
       "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.28.6.tgz",
@@ -3368,9 +3356,9 @@
       }
     },
     "node_modules/@docsearch/core": {
-      "version": "4.6.0",
-      "resolved": "https://registry.npmjs.org/@docsearch/core/-/core-4.6.0.tgz",
-      "integrity": "sha512-IqG3oSd529jVRQ4dWZQKwZwQLVd//bWJTz2HiL0LkiHrI4U/vLrBasKB7lwQB/69nBAcCgs3TmudxTZSLH/ZQg==",
+      "version": "4.6.3",
+      "resolved": "https://registry.npmjs.org/@docsearch/core/-/core-4.6.3.tgz",
+      "integrity": "sha512-rUOujwIpxJRgD7+kicVsI3D5sqBvdiRTquzWBpTEXZs8ZXfGbfzpus5HqumaNYTppN2HvH8E2yNuRwYdHJeOlA==",
       "license": "MIT",
       "peerDependencies": {
         "@types/react": ">= 16.8.0 < 20.0.0",
@@ -3390,20 +3378,20 @@
       }
     },
     "node_modules/@docsearch/css": {
-      "version": "4.6.0",
-      "resolved": "https://registry.npmjs.org/@docsearch/css/-/css-4.6.0.tgz",
-      "integrity": "sha512-YlcAimkXclvqta47g47efzCM5CFxDwv2ClkDfEs/fC/Ak0OxPH2b3czwa4o8O1TRBf+ujFF2RiUwszz2fPVNJQ==",
+      "version": "4.6.3",
+      "resolved": "https://registry.npmjs.org/@docsearch/css/-/css-4.6.3.tgz",
+      "integrity": "sha512-nlOwcXcsNAptQl4vlL4MA78qNJKO0Qlds5GuBjCoePgkebTXLSf8Qt1oyZ3YBshYupKXG9VRGEsk1zr23d+bzQ==",
       "license": "MIT"
     },
     "node_modules/@docsearch/react": {
-      "version": "4.6.0",
-      "resolved": "https://registry.npmjs.org/@docsearch/react/-/react-4.6.0.tgz",
-      "integrity": "sha512-j8H5B4ArGxBPBWvw3X0J0Rm/Pjv2JDa2rV5OE0DLTp5oiBCptIJ/YlNOhZxuzbO2nwge+o3Z52nJRi3hryK9cA==",
+      "version": "4.6.3",
+      "resolved": "https://registry.npmjs.org/@docsearch/react/-/react-4.6.3.tgz",
+      "integrity": "sha512-Bg2wdDsoQVlNCcEKuEJAU04tvHCqgx8rIu+uIoM4pRtcx3TBKJuXutJik3LTA8LRc9YEyHkrYUrmcC0D7BYf+g==",
       "license": "MIT",
       "dependencies": {
         "@algolia/autocomplete-core": "1.19.2",
-        "@docsearch/core": "4.6.0",
-        "@docsearch/css": "4.6.0"
+        "@docsearch/core": "4.6.3",
+        "@docsearch/css": "4.6.3"
       },
       "peerDependencies": {
         "@types/react": ">= 16.8.0 < 20.0.0",
@@ -3426,10 +3414,42 @@
         }
       }
     },
+    "node_modules/@docsearch/react/node_modules/@algolia/autocomplete-core": {
+      "version": "1.19.2",
+      "resolved": "https://registry.npmjs.org/@algolia/autocomplete-core/-/autocomplete-core-1.19.2.tgz",
+      "integrity": "sha512-mKv7RyuAzXvwmq+0XRK8HqZXt9iZ5Kkm2huLjgn5JoCPtDy+oh9yxUMfDDaVCw0oyzZ1isdJBc7l9nuCyyR7Nw==",
+      "license": "MIT",
+      "dependencies": {
+        "@algolia/autocomplete-plugin-algolia-insights": "1.19.2",
+        "@algolia/autocomplete-shared": "1.19.2"
+      }
+    },
+    "node_modules/@docsearch/react/node_modules/@algolia/autocomplete-plugin-algolia-insights": {
+      "version": "1.19.2",
+      "resolved": "https://registry.npmjs.org/@algolia/autocomplete-plugin-algolia-insights/-/autocomplete-plugin-algolia-insights-1.19.2.tgz",
+      "integrity": "sha512-TjxbcC/r4vwmnZaPwrHtkXNeqvlpdyR+oR9Wi2XyfORkiGkLTVhX2j+O9SaCCINbKoDfc+c2PB8NjfOnz7+oKg==",
+      "license": "MIT",
+      "dependencies": {
+        "@algolia/autocomplete-shared": "1.19.2"
+      },
+      "peerDependencies": {
+        "search-insights": ">= 1 < 3"
+      }
+    },
+    "node_modules/@docsearch/react/node_modules/@algolia/autocomplete-shared": {
+      "version": "1.19.2",
+      "resolved": "https://registry.npmjs.org/@algolia/autocomplete-shared/-/autocomplete-shared-1.19.2.tgz",
+      "integrity": "sha512-jEazxZTVD2nLrC+wYlVHQgpBoBB5KPStrJxLzsIFl6Kqd1AlG9sIAGl39V5tECLpIQzB3Qa2T6ZPJ1ChkwMK/w==",
+      "license": "MIT",
+      "peerDependencies": {
+        "@algolia/client-search": ">= 4.9.1 < 6",
+        "algoliasearch": ">= 4.9.1 < 6"
+      }
+    },
     "node_modules/@docusaurus/babel": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/babel/-/babel-3.9.2.tgz",
-      "integrity": "sha512-GEANdi/SgER+L7Japs25YiGil/AUDnFFHaCGPBbundxoWtCkA2lmy7/tFmgED4y1htAy6Oi4wkJEQdGssnw9MA==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/babel/-/babel-3.10.0.tgz",
+      "integrity": "sha512-mqCJhCZNZUDg0zgDEaPTM4DnRsisa24HdqTy/qn/MQlbwhTb4WVaZg6ZyX6yIVKqTz8fS1hBMgM+98z+BeJJDg==",
       "license": "MIT",
       "dependencies": {
         "@babel/core": "^7.25.9",
@@ -3440,10 +3460,9 @@
         "@babel/preset-react": "^7.25.9",
         "@babel/preset-typescript": "^7.25.9",
         "@babel/runtime": "^7.25.9",
-        "@babel/runtime-corejs3": "^7.25.9",
         "@babel/traverse": "^7.25.9",
-        "@docusaurus/logger": "3.9.2",
-        "@docusaurus/utils": "3.9.2",
+        "@docusaurus/logger": "3.10.0",
+        "@docusaurus/utils": "3.10.0",
         "babel-plugin-dynamic-import-node": "^2.3.3",
         "fs-extra": "^11.1.1",
         "tslib": "^2.6.0"
@@ -3453,17 +3472,17 @@
       }
     },
     "node_modules/@docusaurus/bundler": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/bundler/-/bundler-3.9.2.tgz",
-      "integrity": "sha512-ZOVi6GYgTcsZcUzjblpzk3wH1Fya2VNpd5jtHoCCFcJlMQ1EYXZetfAnRHLcyiFeBABaI1ltTYbOBtH/gahGVA==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/bundler/-/bundler-3.10.0.tgz",
+      "integrity": "sha512-iONUGZGgp+lAkw/cJZH6irONcF4p8+278IsdRlq8lYhxGjkoNUs0w7F4gVXBYSNChq5KG5/JleTSsdJySShxow==",
       "license": "MIT",
       "dependencies": {
         "@babel/core": "^7.25.9",
-        "@docusaurus/babel": "3.9.2",
-        "@docusaurus/cssnano-preset": "3.9.2",
-        "@docusaurus/logger": "3.9.2",
-        "@docusaurus/types": "3.9.2",
-        "@docusaurus/utils": "3.9.2",
+        "@docusaurus/babel": "3.10.0",
+        "@docusaurus/cssnano-preset": "3.10.0",
+        "@docusaurus/logger": "3.10.0",
+        "@docusaurus/types": "3.10.0",
+        "@docusaurus/utils": "3.10.0",
         "babel-loader": "^9.2.1",
         "clean-css": "^5.3.3",
         "copy-webpack-plugin": "^11.0.0",
@@ -3496,18 +3515,18 @@
       }
     },
     "node_modules/@docusaurus/core": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/core/-/core-3.9.2.tgz",
-      "integrity": "sha512-HbjwKeC+pHUFBfLMNzuSjqFE/58+rLVKmOU3lxQrpsxLBOGosYco/Q0GduBb0/jEMRiyEqjNT/01rRdOMWq5pw==",
-      "license": "MIT",
-      "dependencies": {
-        "@docusaurus/babel": "3.9.2",
-        "@docusaurus/bundler": "3.9.2",
-        "@docusaurus/logger": "3.9.2",
-        "@docusaurus/mdx-loader": "3.9.2",
-        "@docusaurus/utils": "3.9.2",
-        "@docusaurus/utils-common": "3.9.2",
-        "@docusaurus/utils-validation": "3.9.2",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/core/-/core-3.10.0.tgz",
+      "integrity": "sha512-mgLdQsO8xppnQZc3LPi+Mf+PkPeyxJeIx11AXAq/14fsaMefInQiMEZUUmrc7J+956G/f7MwE7tn8KZgi3iRcA==",
+      "license": "MIT",
+      "dependencies": {
+        "@docusaurus/babel": "3.10.0",
+        "@docusaurus/bundler": "3.10.0",
+        "@docusaurus/logger": "3.10.0",
+        "@docusaurus/mdx-loader": "3.10.0",
+        "@docusaurus/utils": "3.10.0",
+        "@docusaurus/utils-common": "3.10.0",
+        "@docusaurus/utils-validation": "3.10.0",
         "boxen": "^6.2.1",
         "chalk": "^4.1.2",
         "chokidar": "^3.5.3",
@@ -3519,7 +3538,7 @@
         "escape-html": "^1.0.3",
         "eta": "^2.2.0",
         "eval": "^0.1.8",
-        "execa": "5.1.1",
+        "execa": "^5.1.1",
         "fs-extra": "^11.1.1",
         "html-tags": "^3.3.1",
         "html-webpack-plugin": "^5.6.0",
@@ -3530,12 +3549,12 @@
         "prompts": "^2.4.2",
         "react-helmet-async": "npm:@slorber/react-helmet-async@1.3.0",
         "react-loadable": "npm:@docusaurus/react-loadable@6.0.0",
-        "react-loadable-ssr-addon-v5-slorber": "^1.0.1",
+        "react-loadable-ssr-addon-v5-slorber": "^1.0.3",
         "react-router": "^5.3.4",
         "react-router-config": "^5.1.1",
         "react-router-dom": "^5.3.4",
         "semver": "^7.5.4",
-        "serve-handler": "^6.1.6",
+        "serve-handler": "^6.1.7",
         "tinypool": "^1.0.2",
         "tslib": "^2.6.0",
         "update-notifier": "^6.0.2",
@@ -3551,15 +3570,21 @@
         "node": ">=20.0"
       },
       "peerDependencies": {
+        "@docusaurus/faster": "*",
         "@mdx-js/react": "^3.0.0",
         "react": "^18.0.0 || ^19.0.0",
         "react-dom": "^18.0.0 || ^19.0.0"
+      },
+      "peerDependenciesMeta": {
+        "@docusaurus/faster": {
+          "optional": true
+        }
       }
     },
     "node_modules/@docusaurus/cssnano-preset": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/cssnano-preset/-/cssnano-preset-3.9.2.tgz",
-      "integrity": "sha512-8gBKup94aGttRduABsj7bpPFTX7kbwu+xh3K9NMCF5K4bWBqTFYW+REKHF6iBVDHRJ4grZdIPbvkiHd/XNKRMQ==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/cssnano-preset/-/cssnano-preset-3.10.0.tgz",
+      "integrity": "sha512-qzSshTO1DB3TYW+dPUal5KHM7XPc5YQfzF3Kdb2NDACJUyGbNcFtw3tGkCJlYwhNCRKbZcmwraKUS1i5dcHdGg==",
       "license": "MIT",
       "dependencies": {
         "cssnano-preset-advanced": "^6.1.2",
@@ -3572,9 +3597,9 @@
       }
     },
     "node_modules/@docusaurus/logger": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/logger/-/logger-3.9.2.tgz",
-      "integrity": "sha512-/SVCc57ByARzGSU60c50rMyQlBuMIJCjcsJlkphxY6B0GV4UH3tcA1994N8fFfbJ9kX3jIBe/xg3XP5qBtGDbA==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/logger/-/logger-3.10.0.tgz",
+      "integrity": "sha512-9jrZzFuBH1LDRlZ7cznAhCLmAZ3HSDqgwdrSSZdGHq9SPUOQgXXu8mnxe2ZRB9NS1PCpMTIOVUqDtZPIhMafZg==",
       "license": "MIT",
       "dependencies": {
         "chalk": "^4.1.2",
@@ -3585,14 +3610,14 @@
       }
     },
     "node_modules/@docusaurus/mdx-loader": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/mdx-loader/-/mdx-loader-3.9.2.tgz",
-      "integrity": "sha512-wiYoGwF9gdd6rev62xDU8AAM8JuLI/hlwOtCzMmYcspEkzecKrP8J8X+KpYnTlACBUUtXNJpSoCwFWJhLRevzQ==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/mdx-loader/-/mdx-loader-3.10.0.tgz",
+      "integrity": "sha512-mQQV97080AH4PYNs087l202NMDqRopZA4mg5W76ZZyTFrmWhJ3mHg+8A+drJVENxw5/Q+wHMHLgsx+9z1nEs0A==",
       "license": "MIT",
       "dependencies": {
-        "@docusaurus/logger": "3.9.2",
-        "@docusaurus/utils": "3.9.2",
-        "@docusaurus/utils-validation": "3.9.2",
+        "@docusaurus/logger": "3.10.0",
+        "@docusaurus/utils": "3.10.0",
+        "@docusaurus/utils-validation": "3.10.0",
         "@mdx-js/mdx": "^3.0.0",
         "@slorber/remark-comment": "^1.0.0",
         "escape-html": "^1.0.3",
@@ -3624,12 +3649,12 @@
       }
     },
     "node_modules/@docusaurus/module-type-aliases": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/module-type-aliases/-/module-type-aliases-3.9.2.tgz",
-      "integrity": "sha512-8qVe2QA9hVLzvnxP46ysuofJUIc/yYQ82tvA/rBTrnpXtCjNSFLxEZfd5U8cYZuJIVlkPxamsIgwd5tGZXfvew==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/module-type-aliases/-/module-type-aliases-3.10.0.tgz",
+      "integrity": "sha512-/1O0Zg8w3DFrYX/I6Fbss7OJrtZw1QoyjDhegiFNHVi9A9Y0gQ3jUAytVxF6ywpAWpLyLxch8nN8H/V3XfzdJQ==",
       "license": "MIT",
       "dependencies": {
-        "@docusaurus/types": "3.9.2",
+        "@docusaurus/types": "3.10.0",
         "@types/history": "^4.7.11",
         "@types/react": "*",
         "@types/react-router-config": "*",
@@ -3643,20 +3668,21 @@
       }
     },
     "node_modules/@docusaurus/plugin-content-blog": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-content-blog/-/plugin-content-blog-3.9.2.tgz",
-      "integrity": "sha512-3I2HXy3L1QcjLJLGAoTvoBnpOwa6DPUa3Q0dMK19UTY9mhPkKQg/DYhAGTiBUKcTR0f08iw7kLPqOhIgdV3eVQ==",
-      "license": "MIT",
-      "dependencies": {
-        "@docusaurus/core": "3.9.2",
-        "@docusaurus/logger": "3.9.2",
-        "@docusaurus/mdx-loader": "3.9.2",
-        "@docusaurus/theme-common": "3.9.2",
-        "@docusaurus/types": "3.9.2",
-        "@docusaurus/utils": "3.9.2",
-        "@docusaurus/utils-common": "3.9.2",
-        "@docusaurus/utils-validation": "3.9.2",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-content-blog/-/plugin-content-blog-3.10.0.tgz",
+      "integrity": "sha512-RuTz68DhB7CL96QO5UsFbciD7GPYq6QV+YMfF9V0+N4ZgLhJIBgpVAr8GobrKF6NRe5cyWWETU5z5T834piG9g==",
+      "license": "MIT",
+      "dependencies": {
+        "@docusaurus/core": "3.10.0",
+        "@docusaurus/logger": "3.10.0",
+        "@docusaurus/mdx-loader": "3.10.0",
+        "@docusaurus/theme-common": "3.10.0",
+        "@docusaurus/types": "3.10.0",
+        "@docusaurus/utils": "3.10.0",
+        "@docusaurus/utils-common": "3.10.0",
+        "@docusaurus/utils-validation": "3.10.0",
         "cheerio": "1.0.0-rc.12",
+        "combine-promises": "^1.1.0",
         "feed": "^4.2.2",
         "fs-extra": "^11.1.1",
         "lodash": "^4.17.21",
@@ -3677,20 +3703,20 @@
       }
     },
     "node_modules/@docusaurus/plugin-content-docs": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-content-docs/-/plugin-content-docs-3.9.2.tgz",
-      "integrity": "sha512-C5wZsGuKTY8jEYsqdxhhFOe1ZDjH0uIYJ9T/jebHwkyxqnr4wW0jTkB72OMqNjsoQRcb0JN3PcSeTwFlVgzCZg==",
-      "license": "MIT",
-      "dependencies": {
-        "@docusaurus/core": "3.9.2",
-        "@docusaurus/logger": "3.9.2",
-        "@docusaurus/mdx-loader": "3.9.2",
-        "@docusaurus/module-type-aliases": "3.9.2",
-        "@docusaurus/theme-common": "3.9.2",
-        "@docusaurus/types": "3.9.2",
-        "@docusaurus/utils": "3.9.2",
-        "@docusaurus/utils-common": "3.9.2",
-        "@docusaurus/utils-validation": "3.9.2",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-content-docs/-/plugin-content-docs-3.10.0.tgz",
+      "integrity": "sha512-9BjHhf15ct8Z7TThTC0xRndKDVvMKmVsAGAN7W9FpNRzfMdScOGcXtLmcCWtJGvAezjOJIm6CxOYCy3Io5+RnQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@docusaurus/core": "3.10.0",
+        "@docusaurus/logger": "3.10.0",
+        "@docusaurus/mdx-loader": "3.10.0",
+        "@docusaurus/module-type-aliases": "3.10.0",
+        "@docusaurus/theme-common": "3.10.0",
+        "@docusaurus/types": "3.10.0",
+        "@docusaurus/utils": "3.10.0",
+        "@docusaurus/utils-common": "3.10.0",
+        "@docusaurus/utils-validation": "3.10.0",
         "@types/react-router-config": "^5.0.7",
         "combine-promises": "^1.1.0",
         "fs-extra": "^11.1.1",
@@ -3710,16 +3736,16 @@
       }
     },
     "node_modules/@docusaurus/plugin-content-pages": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-content-pages/-/plugin-content-pages-3.9.2.tgz",
-      "integrity": "sha512-s4849w/p4noXUrGpPUF0BPqIAfdAe76BLaRGAGKZ1gTDNiGxGcpsLcwJ9OTi1/V8A+AzvsmI9pkjie2zjIQZKA==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-content-pages/-/plugin-content-pages-3.10.0.tgz",
+      "integrity": "sha512-5amX8kEJI+nIGtuLVjYk59Y5utEJ3CHETFOPEE4cooIRLA4xM4iBsA6zFgu4ljcopeYwvBzFEWf5g2I6Yb9SkA==",
       "license": "MIT",
       "dependencies": {
-        "@docusaurus/core": "3.9.2",
-        "@docusaurus/mdx-loader": "3.9.2",
-        "@docusaurus/types": "3.9.2",
-        "@docusaurus/utils": "3.9.2",
-        "@docusaurus/utils-validation": "3.9.2",
+        "@docusaurus/core": "3.10.0",
+        "@docusaurus/mdx-loader": "3.10.0",
+        "@docusaurus/types": "3.10.0",
+        "@docusaurus/utils": "3.10.0",
+        "@docusaurus/utils-validation": "3.10.0",
         "fs-extra": "^11.1.1",
         "tslib": "^2.6.0",
         "webpack": "^5.88.1"
@@ -3733,15 +3759,15 @@
       }
     },
     "node_modules/@docusaurus/plugin-css-cascade-layers": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-css-cascade-layers/-/plugin-css-cascade-layers-3.9.2.tgz",
-      "integrity": "sha512-w1s3+Ss+eOQbscGM4cfIFBlVg/QKxyYgj26k5AnakuHkKxH6004ZtuLe5awMBotIYF2bbGDoDhpgQ4r/kcj4rQ==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-css-cascade-layers/-/plugin-css-cascade-layers-3.10.0.tgz",
+      "integrity": "sha512-6q1vtt5FJcg5osgkHeM1euErECNqEZ5Z1j69yiNx2luEBIso+nxCkS9nqj8w+MK5X7rvKEToGhFfOFWncs51pQ==",
       "license": "MIT",
       "dependencies": {
-        "@docusaurus/core": "3.9.2",
-        "@docusaurus/types": "3.9.2",
-        "@docusaurus/utils": "3.9.2",
-        "@docusaurus/utils-validation": "3.9.2",
+        "@docusaurus/core": "3.10.0",
+        "@docusaurus/types": "3.10.0",
+        "@docusaurus/utils": "3.10.0",
+        "@docusaurus/utils-validation": "3.10.0",
         "tslib": "^2.6.0"
       },
       "engines": {
@@ -3749,14 +3775,14 @@
       }
     },
     "node_modules/@docusaurus/plugin-debug": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-debug/-/plugin-debug-3.9.2.tgz",
-      "integrity": "sha512-j7a5hWuAFxyQAkilZwhsQ/b3T7FfHZ+0dub6j/GxKNFJp2h9qk/P1Bp7vrGASnvA9KNQBBL1ZXTe7jlh4VdPdA==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-debug/-/plugin-debug-3.10.0.tgz",
+      "integrity": "sha512-XcljKN+G+nmmK69uQA1d9BlYU3ZftG3T3zpK8/7Hf/wrOlV7TA4Ampdrdwkg0jElKdKAoSnPhCO0/U3bQGsVQQ==",
       "license": "MIT",
       "dependencies": {
-        "@docusaurus/core": "3.9.2",
-        "@docusaurus/types": "3.9.2",
-        "@docusaurus/utils": "3.9.2",
+        "@docusaurus/core": "3.10.0",
+        "@docusaurus/types": "3.10.0",
+        "@docusaurus/utils": "3.10.0",
         "fs-extra": "^11.1.1",
         "react-json-view-lite": "^2.3.0",
         "tslib": "^2.6.0"
@@ -3770,14 +3796,14 @@
       }
     },
     "node_modules/@docusaurus/plugin-google-analytics": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-google-analytics/-/plugin-google-analytics-3.9.2.tgz",
-      "integrity": "sha512-mAwwQJ1Us9jL/lVjXtErXto4p4/iaLlweC54yDUK1a97WfkC6Z2k5/769JsFgwOwOP+n5mUQGACXOEQ0XDuVUw==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-google-analytics/-/plugin-google-analytics-3.10.0.tgz",
+      "integrity": "sha512-hTEoodatpBZnUat5nFExbuTGA1lhWGy7vZGuTew5Q3QDtGKFpSJLYmZJhdTjvCFwv1+qQ67hgAVlKdJOB8TXow==",
       "license": "MIT",
       "dependencies": {
-        "@docusaurus/core": "3.9.2",
-        "@docusaurus/types": "3.9.2",
-        "@docusaurus/utils-validation": "3.9.2",
+        "@docusaurus/core": "3.10.0",
+        "@docusaurus/types": "3.10.0",
+        "@docusaurus/utils-validation": "3.10.0",
         "tslib": "^2.6.0"
       },
       "engines": {
@@ -3789,15 +3815,15 @@
       }
     },
     "node_modules/@docusaurus/plugin-google-gtag": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-google-gtag/-/plugin-google-gtag-3.9.2.tgz",
-      "integrity": "sha512-YJ4lDCphabBtw19ooSlc1MnxtYGpjFV9rEdzjLsUnBCeis2djUyCozZaFhCg6NGEwOn7HDDyMh0yzcdRpnuIvA==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-google-gtag/-/plugin-google-gtag-3.10.0.tgz",
+      "integrity": "sha512-iB/Zzjv/eelJRbdULZqzWCbgMgJ7ht4ONVjXtN3+BI/muil6S87gQ1OJyPwlXD+ELdKkitC7bWv5eJdYOZLhrQ==",
       "license": "MIT",
       "dependencies": {
-        "@docusaurus/core": "3.9.2",
-        "@docusaurus/types": "3.9.2",
-        "@docusaurus/utils-validation": "3.9.2",
-        "@types/gtag.js": "^0.0.12",
+        "@docusaurus/core": "3.10.0",
+        "@docusaurus/types": "3.10.0",
+        "@docusaurus/utils-validation": "3.10.0",
+        "@types/gtag.js": "^0.0.20",
         "tslib": "^2.6.0"
       },
       "engines": {
@@ -3809,14 +3835,14 @@
       }
     },
     "node_modules/@docusaurus/plugin-google-tag-manager": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-google-tag-manager/-/plugin-google-tag-manager-3.9.2.tgz",
-      "integrity": "sha512-LJtIrkZN/tuHD8NqDAW1Tnw0ekOwRTfobWPsdO15YxcicBo2ykKF0/D6n0vVBfd3srwr9Z6rzrIWYrMzBGrvNw==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-google-tag-manager/-/plugin-google-tag-manager-3.10.0.tgz",
+      "integrity": "sha512-FEjZxqKgLHa+Wez/EgKxRwvArNCWIScfyEQD95rot7jkxp6nonjI5XIbGfO/iYhM5Qinwe8aIEQHP2KZtpqVuA==",
       "license": "MIT",
       "dependencies": {
-        "@docusaurus/core": "3.9.2",
-        "@docusaurus/types": "3.9.2",
-        "@docusaurus/utils-validation": "3.9.2",
+        "@docusaurus/core": "3.10.0",
+        "@docusaurus/types": "3.10.0",
+        "@docusaurus/utils-validation": "3.10.0",
         "tslib": "^2.6.0"
       },
       "engines": {
@@ -3828,17 +3854,17 @@
       }
     },
     "node_modules/@docusaurus/plugin-sitemap": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-sitemap/-/plugin-sitemap-3.9.2.tgz",
-      "integrity": "sha512-WLh7ymgDXjG8oPoM/T4/zUP7KcSuFYRZAUTl8vR6VzYkfc18GBM4xLhcT+AKOwun6kBivYKUJf+vlqYJkm+RHw==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-sitemap/-/plugin-sitemap-3.10.0.tgz",
+      "integrity": "sha512-DVTSLjB97hIjmayGnGcBfognCeI7ZuUKgEnU7Oz81JYqXtVg94mVTthDjq3QHTylYNeCUbkaW8VF0FDLcc8pPw==",
       "license": "MIT",
       "dependencies": {
-        "@docusaurus/core": "3.9.2",
-        "@docusaurus/logger": "3.9.2",
-        "@docusaurus/types": "3.9.2",
-        "@docusaurus/utils": "3.9.2",
-        "@docusaurus/utils-common": "3.9.2",
-        "@docusaurus/utils-validation": "3.9.2",
+        "@docusaurus/core": "3.10.0",
+        "@docusaurus/logger": "3.10.0",
+        "@docusaurus/types": "3.10.0",
+        "@docusaurus/utils": "3.10.0",
+        "@docusaurus/utils-common": "3.10.0",
+        "@docusaurus/utils-validation": "3.10.0",
         "fs-extra": "^11.1.1",
         "sitemap": "^7.1.1",
         "tslib": "^2.6.0"
@@ -3852,15 +3878,15 @@
       }
     },
     "node_modules/@docusaurus/plugin-svgr": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-svgr/-/plugin-svgr-3.9.2.tgz",
-      "integrity": "sha512-n+1DE+5b3Lnf27TgVU5jM1d4x5tUh2oW5LTsBxJX4PsAPV0JGcmI6p3yLYtEY0LRVEIJh+8RsdQmRE66wSV8mw==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/plugin-svgr/-/plugin-svgr-3.10.0.tgz",
+      "integrity": "sha512-lNljBESaETZqVBMPqkrGchr+UPT1eZzEPLmJhz8I76BxbjqgsUnRvrq6lQJ9sYjgmgX52KB7kkgczqd2yzoswQ==",
       "license": "MIT",
       "dependencies": {
-        "@docusaurus/core": "3.9.2",
-        "@docusaurus/types": "3.9.2",
-        "@docusaurus/utils": "3.9.2",
-        "@docusaurus/utils-validation": "3.9.2",
+        "@docusaurus/core": "3.10.0",
+        "@docusaurus/types": "3.10.0",
+        "@docusaurus/utils": "3.10.0",
+        "@docusaurus/utils-validation": "3.10.0",
         "@svgr/core": "8.1.0",
         "@svgr/webpack": "^8.1.0",
         "tslib": "^2.6.0",
@@ -3875,26 +3901,26 @@
       }
     },
     "node_modules/@docusaurus/preset-classic": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/preset-classic/-/preset-classic-3.9.2.tgz",
-      "integrity": "sha512-IgyYO2Gvaigi21LuDIe+nvmN/dfGXAiMcV/murFqcpjnZc7jxFAxW+9LEjdPt61uZLxG4ByW/oUmX/DDK9t/8w==",
-      "license": "MIT",
-      "dependencies": {
-        "@docusaurus/core": "3.9.2",
-        "@docusaurus/plugin-content-blog": "3.9.2",
-        "@docusaurus/plugin-content-docs": "3.9.2",
-        "@docusaurus/plugin-content-pages": "3.9.2",
-        "@docusaurus/plugin-css-cascade-layers": "3.9.2",
-        "@docusaurus/plugin-debug": "3.9.2",
-        "@docusaurus/plugin-google-analytics": "3.9.2",
-        "@docusaurus/plugin-google-gtag": "3.9.2",
-        "@docusaurus/plugin-google-tag-manager": "3.9.2",
-        "@docusaurus/plugin-sitemap": "3.9.2",
-        "@docusaurus/plugin-svgr": "3.9.2",
-        "@docusaurus/theme-classic": "3.9.2",
-        "@docusaurus/theme-common": "3.9.2",
-        "@docusaurus/theme-search-algolia": "3.9.2",
-        "@docusaurus/types": "3.9.2"
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/preset-classic/-/preset-classic-3.10.0.tgz",
+      "integrity": "sha512-kw/Ye02Hc6xP1OdTswy8yxQEHg0fdPpyWAQRxr5b2x3h7LlG2Zgbb5BDFROnXDDMpUxB7YejlocJIE5HIEfpNA==",
+      "license": "MIT",
+      "dependencies": {
+        "@docusaurus/core": "3.10.0",
+        "@docusaurus/plugin-content-blog": "3.10.0",
+        "@docusaurus/plugin-content-docs": "3.10.0",
+        "@docusaurus/plugin-content-pages": "3.10.0",
+        "@docusaurus/plugin-css-cascade-layers": "3.10.0",
+        "@docusaurus/plugin-debug": "3.10.0",
+        "@docusaurus/plugin-google-analytics": "3.10.0",
+        "@docusaurus/plugin-google-gtag": "3.10.0",
+        "@docusaurus/plugin-google-tag-manager": "3.10.0",
+        "@docusaurus/plugin-sitemap": "3.10.0",
+        "@docusaurus/plugin-svgr": "3.10.0",
+        "@docusaurus/theme-classic": "3.10.0",
+        "@docusaurus/theme-common": "3.10.0",
+        "@docusaurus/theme-search-algolia": "3.10.0",
+        "@docusaurus/types": "3.10.0"
       },
       "engines": {
         "node": ">=20.0"
@@ -3905,9 +3931,9 @@
       }
     },
     "node_modules/@docusaurus/remark-plugin-npm2yarn": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/remark-plugin-npm2yarn/-/remark-plugin-npm2yarn-3.9.2.tgz",
-      "integrity": "sha512-Upr5W5Yvg97fD9ozDYgHBY0PPi80/1fbqW47v+yY/4o+Fiwwq9m/E5yuTNN3rO9h4+ueO/jrDMOFI/cG/mOV+A==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/remark-plugin-npm2yarn/-/remark-plugin-npm2yarn-3.10.0.tgz",
+      "integrity": "sha512-U0gAh0ruP3SblGjTHSqruwZw3ssihi7QTWoOSeUf44Y0SAAXJhE9kIfgNXOVzDV9tpSnFO8U6P3EUT6vytpmhQ==",
       "license": "MIT",
       "dependencies": {
         "mdast-util-mdx": "^3.0.0",
@@ -3921,26 +3947,27 @@
       }
     },
     "node_modules/@docusaurus/theme-classic": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/theme-classic/-/theme-classic-3.9.2.tgz",
-      "integrity": "sha512-IGUsArG5hhekXd7RDb11v94ycpJpFdJPkLnt10fFQWOVxAtq5/D7hT6lzc2fhyQKaaCE62qVajOMKL7OiAFAIA==",
-      "license": "MIT",
-      "dependencies": {
-        "@docusaurus/core": "3.9.2",
-        "@docusaurus/logger": "3.9.2",
-        "@docusaurus/mdx-loader": "3.9.2",
-        "@docusaurus/module-type-aliases": "3.9.2",
-        "@docusaurus/plugin-content-blog": "3.9.2",
-        "@docusaurus/plugin-content-docs": "3.9.2",
-        "@docusaurus/plugin-content-pages": "3.9.2",
-        "@docusaurus/theme-common": "3.9.2",
-        "@docusaurus/theme-translations": "3.9.2",
-        "@docusaurus/types": "3.9.2",
-        "@docusaurus/utils": "3.9.2",
-        "@docusaurus/utils-common": "3.9.2",
-        "@docusaurus/utils-validation": "3.9.2",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/theme-classic/-/theme-classic-3.10.0.tgz",
+      "integrity": "sha512-9msCAsRdN+UG+RwPwCFb0uKy4tGoPh5YfBozXeGUtIeAgsMdn6f3G/oY861luZ3t8S2ET8S9Y/1GnpJAGWytww==",
+      "license": "MIT",
+      "dependencies": {
+        "@docusaurus/core": "3.10.0",
+        "@docusaurus/logger": "3.10.0",
+        "@docusaurus/mdx-loader": "3.10.0",
+        "@docusaurus/module-type-aliases": "3.10.0",
+        "@docusaurus/plugin-content-blog": "3.10.0",
+        "@docusaurus/plugin-content-docs": "3.10.0",
+        "@docusaurus/plugin-content-pages": "3.10.0",
+        "@docusaurus/theme-common": "3.10.0",
+        "@docusaurus/theme-translations": "3.10.0",
+        "@docusaurus/types": "3.10.0",
+        "@docusaurus/utils": "3.10.0",
+        "@docusaurus/utils-common": "3.10.0",
+        "@docusaurus/utils-validation": "3.10.0",
         "@mdx-js/react": "^3.0.0",
         "clsx": "^2.0.0",
+        "copy-text-to-clipboard": "^3.2.0",
         "infima": "0.2.0-alpha.45",
         "lodash": "^4.17.21",
         "nprogress": "^0.2.0",
@@ -3961,15 +3988,15 @@
       }
     },
     "node_modules/@docusaurus/theme-common": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/theme-common/-/theme-common-3.9.2.tgz",
-      "integrity": "sha512-6c4DAbR6n6nPbnZhY2V3tzpnKnGL+6aOsLvFL26VRqhlczli9eWG0VDUNoCQEPnGwDMhPS42UhSAnz5pThm5Ag==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/theme-common/-/theme-common-3.10.0.tgz",
+      "integrity": "sha512-Dkp1YXKn16ByCJAdIjbDIOpVb4Z66MsVD694/ilX1vAAHaVEMrVsf/NPd9VgreyFx08rJ9GqV1MtzsbTcU73Kg==",
       "license": "MIT",
       "dependencies": {
-        "@docusaurus/mdx-loader": "3.9.2",
-        "@docusaurus/module-type-aliases": "3.9.2",
-        "@docusaurus/utils": "3.9.2",
-        "@docusaurus/utils-common": "3.9.2",
+        "@docusaurus/mdx-loader": "3.10.0",
+        "@docusaurus/module-type-aliases": "3.10.0",
+        "@docusaurus/utils": "3.10.0",
+        "@docusaurus/utils-common": "3.10.0",
         "@types/history": "^4.7.11",
         "@types/react": "*",
         "@types/react-router-config": "*",
@@ -3989,16 +4016,16 @@
       }
     },
     "node_modules/@docusaurus/theme-mermaid": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/theme-mermaid/-/theme-mermaid-3.9.2.tgz",
-      "integrity": "sha512-5vhShRDq/ntLzdInsQkTdoKWSzw8d1jB17sNPYhA/KvYYFXfuVEGHLM6nrf8MFbV8TruAHDG21Fn3W4lO8GaDw==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/theme-mermaid/-/theme-mermaid-3.10.0.tgz",
+      "integrity": "sha512-Y2xrlwhIJ80oOZIO3PXL6A7J869splfcMI87E3NKpYsy3zJxOyV+BP1QMtGi59ajKgU868HPuyyn6J+6BZGOBg==",
       "license": "MIT",
       "dependencies": {
-        "@docusaurus/core": "3.9.2",
-        "@docusaurus/module-type-aliases": "3.9.2",
-        "@docusaurus/theme-common": "3.9.2",
-        "@docusaurus/types": "3.9.2",
-        "@docusaurus/utils-validation": "3.9.2",
+        "@docusaurus/core": "3.10.0",
+        "@docusaurus/module-type-aliases": "3.10.0",
+        "@docusaurus/theme-common": "3.10.0",
+        "@docusaurus/types": "3.10.0",
+        "@docusaurus/utils-validation": "3.10.0",
         "mermaid": ">=11.6.0",
         "tslib": "^2.6.0"
       },
@@ -4017,19 +4044,20 @@
       }
     },
     "node_modules/@docusaurus/theme-search-algolia": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/theme-search-algolia/-/theme-search-algolia-3.9.2.tgz",
-      "integrity": "sha512-GBDSFNwjnh5/LdkxCKQHkgO2pIMX1447BxYUBG2wBiajS21uj64a+gH/qlbQjDLxmGrbrllBrtJkUHxIsiwRnw==",
-      "license": "MIT",
-      "dependencies": {
-        "@docsearch/react": "^3.9.0 || ^4.1.0",
-        "@docusaurus/core": "3.9.2",
-        "@docusaurus/logger": "3.9.2",
-        "@docusaurus/plugin-content-docs": "3.9.2",
-        "@docusaurus/theme-common": "3.9.2",
-        "@docusaurus/theme-translations": "3.9.2",
-        "@docusaurus/utils": "3.9.2",
-        "@docusaurus/utils-validation": "3.9.2",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/theme-search-algolia/-/theme-search-algolia-3.10.0.tgz",
+      "integrity": "sha512-f5FPKI08e3JRG63vR/o4qeuUVHUHzFzM0nnF+AkB67soAZgNsKJRf2qmUZvlQkGwlV+QFkKe4D0ANMh1jToU3g==",
+      "license": "MIT",
+      "dependencies": {
+        "@algolia/autocomplete-core": "^1.19.2",
+        "@docsearch/react": "^3.9.0 || ^4.3.2",
+        "@docusaurus/core": "3.10.0",
+        "@docusaurus/logger": "3.10.0",
+        "@docusaurus/plugin-content-docs": "3.10.0",
+        "@docusaurus/theme-common": "3.10.0",
+        "@docusaurus/theme-translations": "3.10.0",
+        "@docusaurus/utils": "3.10.0",
+        "@docusaurus/utils-validation": "3.10.0",
         "algoliasearch": "^5.37.0",
         "algoliasearch-helper": "^3.26.0",
         "clsx": "^2.0.0",
@@ -4048,9 +4076,9 @@
       }
     },
     "node_modules/@docusaurus/theme-translations": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/theme-translations/-/theme-translations-3.9.2.tgz",
-      "integrity": "sha512-vIryvpP18ON9T9rjgMRFLr2xJVDpw1rtagEGf8Ccce4CkTrvM/fRB8N2nyWYOW5u3DdjkwKw5fBa+3tbn9P4PA==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/theme-translations/-/theme-translations-3.10.0.tgz",
+      "integrity": "sha512-L9IbFLwTc5+XdgH45iQYufLn0SVZd6BUNelDbKIFlH+E4hhjuj/XHWAFMX/w2K59rfy8wak9McOaei7BSUfRPA==",
       "license": "MIT",
       "dependencies": {
         "fs-extra": "^11.1.1",
@@ -4061,16 +4089,16 @@
       }
     },
     "node_modules/@docusaurus/tsconfig": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/tsconfig/-/tsconfig-3.9.2.tgz",
-      "integrity": "sha512-j6/Fp4Rlpxsc632cnRnl5HpOWeb6ZKssDj6/XzzAzVGXXfm9Eptx3rxCC+fDzySn9fHTS+CWJjPineCR1bB5WQ==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/tsconfig/-/tsconfig-3.10.0.tgz",
+      "integrity": "sha512-TXdC3WXuPrdQAexLvjUJfnYf3YKEgEqAs5nK0Q88pRBCW7t7oN4ILvWYb3A5Z1wlSXyXGWW/mCUmLEhdWsjnDQ==",
       "dev": true,
       "license": "MIT"
     },
     "node_modules/@docusaurus/types": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/types/-/types-3.9.2.tgz",
-      "integrity": "sha512-Ux1JUNswg+EfUEmajJjyhIohKceitY/yzjRUpu04WXgvVz+fbhVC0p+R0JhvEu4ytw8zIAys2hrdpQPBHRIa8Q==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/types/-/types-3.10.0.tgz",
+      "integrity": "sha512-F0dOt3FOoO20rRaFK7whGFQZ3ggyrWEdQc/c8/UiRuzhtg4y1w9FspXH5zpCT07uMnJKBPGh+qNazbNlCQqvSw==",
       "license": "MIT",
       "dependencies": {
         "@mdx-js/mdx": "^3.0.0",
@@ -4104,16 +4132,16 @@
       }
     },
     "node_modules/@docusaurus/utils": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/utils/-/utils-3.9.2.tgz",
-      "integrity": "sha512-lBSBiRruFurFKXr5Hbsl2thmGweAPmddhF3jb99U4EMDA5L+e5Y1rAkOS07Nvrup7HUMBDrCV45meaxZnt28nQ==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/utils/-/utils-3.10.0.tgz",
+      "integrity": "sha512-T3B0WTigsIthe0D4LQa2k+7bJY+c3WS+Wq2JhcznOSpn1lSN64yNtHQXboCj3QnUs1EuAZszQG1SHKu5w5ZrlA==",
       "license": "MIT",
       "dependencies": {
-        "@docusaurus/logger": "3.9.2",
-        "@docusaurus/types": "3.9.2",
-        "@docusaurus/utils-common": "3.9.2",
+        "@docusaurus/logger": "3.10.0",
+        "@docusaurus/types": "3.10.0",
+        "@docusaurus/utils-common": "3.10.0",
         "escape-string-regexp": "^4.0.0",
-        "execa": "5.1.1",
+        "execa": "^5.1.1",
         "file-loader": "^6.2.0",
         "fs-extra": "^11.1.1",
         "github-slugger": "^1.5.0",
@@ -4136,12 +4164,12 @@
       }
     },
     "node_modules/@docusaurus/utils-common": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/utils-common/-/utils-common-3.9.2.tgz",
-      "integrity": "sha512-I53UC1QctruA6SWLvbjbhCpAw7+X7PePoe5pYcwTOEXD/PxeP8LnECAhTHHwWCblyUX5bMi4QLRkxvyZ+IT8Aw==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/utils-common/-/utils-common-3.10.0.tgz",
+      "integrity": "sha512-JyL7sb9QVDgYvudIS81Dv0lsWm7le0vGZSDwsztxWam1SPBqrnkvBy9UYL/amh6pbybkyYTd3CMTkO24oMlCSw==",
       "license": "MIT",
       "dependencies": {
-        "@docusaurus/types": "3.9.2",
+        "@docusaurus/types": "3.10.0",
         "tslib": "^2.6.0"
       },
       "engines": {
@@ -4149,14 +4177,14 @@
       }
     },
     "node_modules/@docusaurus/utils-validation": {
-      "version": "3.9.2",
-      "resolved": "https://registry.npmjs.org/@docusaurus/utils-validation/-/utils-validation-3.9.2.tgz",
-      "integrity": "sha512-l7yk3X5VnNmATbwijJkexdhulNsQaNDwoagiwujXoxFbWLcxHQqNQ+c/IAlzrfMMOfa/8xSBZ7KEKDesE/2J7A==",
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/@docusaurus/utils-validation/-/utils-validation-3.10.0.tgz",
+      "integrity": "sha512-c+6n2+ZPOJtWWc8Bb/EYdpSDfjYEScdCu9fB/SNjOmSCf1IdVnGf2T53o0tsz0gDRtCL90tifTL0JE/oMuP1Mw==",
       "license": "MIT",
       "dependencies": {
-        "@docusaurus/logger": "3.9.2",
-        "@docusaurus/utils": "3.9.2",
-        "@docusaurus/utils-common": "3.9.2",
+        "@docusaurus/logger": "3.10.0",
+        "@docusaurus/utils": "3.10.0",
+        "@docusaurus/utils-common": "3.10.0",
         "fs-extra": "^11.2.0",
         "joi": "^17.9.2",
         "js-yaml": "^4.1.0",
@@ -7607,9 +7635,9 @@
       "integrity": "sha512-6C8nqWur3j98U6+lXDfTUWIfgvZU+EumvpHKcYjujKH7woYyLj2sUmff0tRhrqM7BohUw7Pz3ZB1jj2gW9Fvmg=="
     },
     "node_modules/@types/gtag.js": {
-      "version": "0.0.12",
-      "resolved": "https://registry.npmjs.org/@types/gtag.js/-/gtag.js-0.0.12.tgz",
-      "integrity": "sha512-YQV9bUsemkzG81Ea295/nF/5GijnD2Af7QhEofh7xu+kvCN6RdodgNwwGWXB5GMI3NoyvQo0odNctoH/qLMIpg==",
+      "version": "0.0.20",
+      "resolved": "https://registry.npmjs.org/@types/gtag.js/-/gtag.js-0.0.20.tgz",
+      "integrity": "sha512-wwAbk3SA2QeU67unN7zPxjEHmPmlXwZXZvQEpbEUQuMCRGgKyE1m6XDuTUA9b6pCGb/GqJmdfMOY5LuDjJSbbg==",
       "license": "MIT"
     },
     "node_modules/@types/hast": {
@@ -8244,34 +8272,34 @@
       }
     },
     "node_modules/algoliasearch": {
-      "version": "5.49.0",
-      "resolved": "https://registry.npmjs.org/algoliasearch/-/algoliasearch-5.49.0.tgz",
-      "integrity": "sha512-Tse7vx7WOvbU+kpq/L3BrBhSWTPbtMa59zIEhMn+Z2NoxZlpcCRUDCRxQ7kDFs1T3CHxDgvb+mDuILiBBpBaAA==",
-      "license": "MIT",
-      "dependencies": {
-        "@algolia/abtesting": "1.15.0",
-        "@algolia/client-abtesting": "5.49.0",
-        "@algolia/client-analytics": "5.49.0",
-        "@algolia/client-common": "5.49.0",
-        "@algolia/client-insights": "5.49.0",
-        "@algolia/client-personalization": "5.49.0",
-        "@algolia/client-query-suggestions": "5.49.0",
-        "@algolia/client-search": "5.49.0",
-        "@algolia/ingestion": "1.49.0",
-        "@algolia/monitoring": "1.49.0",
-        "@algolia/recommend": "5.49.0",
-        "@algolia/requester-browser-xhr": "5.49.0",
-        "@algolia/requester-fetch": "5.49.0",
-        "@algolia/requester-node-http": "5.49.0"
+      "version": "5.51.0",
+      "resolved": "https://registry.npmjs.org/algoliasearch/-/algoliasearch-5.51.0.tgz",
+      "integrity": "sha512-u3XS8HaTzt5YN90KPsOXMRjYJUMVD1dtr6yi4NXQluMbZ5IjQNBu1MEabdAxFhYtEuexqomPMSmRIhQJUd3QSg==",
+      "license": "MIT",
+      "dependencies": {
+        "@algolia/abtesting": "1.17.0",
+        "@algolia/client-abtesting": "5.51.0",
+        "@algolia/client-analytics": "5.51.0",
+        "@algolia/client-common": "5.51.0",
+        "@algolia/client-insights": "5.51.0",
+        "@algolia/client-personalization": "5.51.0",
+        "@algolia/client-query-suggestions": "5.51.0",
+        "@algolia/client-search": "5.51.0",
+        "@algolia/ingestion": "1.51.0",
+        "@algolia/monitoring": "1.51.0",
+        "@algolia/recommend": "5.51.0",
+        "@algolia/requester-browser-xhr": "5.51.0",
+        "@algolia/requester-fetch": "5.51.0",
+        "@algolia/requester-node-http": "5.51.0"
       },
       "engines": {
         "node": ">= 14.0.0"
       }
     },
     "node_modules/algoliasearch-helper": {
-      "version": "3.27.1",
-      "resolved": "https://registry.npmjs.org/algoliasearch-helper/-/algoliasearch-helper-3.27.1.tgz",
-      "integrity": "sha512-XXGr02Cz285vLbqM6vPfb39xqV1ptpFr1xn9mqaW+nUvYTvFTdKgYTC/Cg1VzgRTQqNkq9+LlUVv8cfCeOoKig==",
+      "version": "3.28.1",
+      "resolved": "https://registry.npmjs.org/algoliasearch-helper/-/algoliasearch-helper-3.28.1.tgz",
+      "integrity": "sha512-6iXpbkkrAI5HFpCWXlNmIDSBuoN/U1XnEvb2yJAoWfqrZ+DrybI7MQ5P5mthFaprmocq+zbi6HxnR28xnZAYBw==",
       "license": "MIT",
       "dependencies": {
         "@algolia/events": "^4.0.1"
@@ -8483,9 +8511,9 @@
       "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q=="
     },
     "node_modules/autoprefixer": {
-      "version": "10.4.24",
-      "resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-10.4.24.tgz",
-      "integrity": "sha512-uHZg7N9ULTVbutaIsDRoUkoS8/h3bdsmVJYZ5l3wv8Cp/6UIIoRDm90hZ+BwxUj/hGBEzLxdHNSKuFpn8WOyZw==",
+      "version": "10.5.0",
+      "resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-10.5.0.tgz",
+      "integrity": "sha512-FMhOoZV4+qR6aTUALKX2rEqGG+oyATvwBt9IIzVR5rMa2HRWPkxf+P+PAJLD1I/H5/II+HuZcBJYEFBpq39ong==",
       "funding": [
         {
           "type": "opencollective",
@@ -8502,8 +8530,8 @@
       ],
       "license": "MIT",
       "dependencies": {
-        "browserslist": "^4.28.1",
-        "caniuse-lite": "^1.0.30001766",
+        "browserslist": "^4.28.2",
+        "caniuse-lite": "^1.0.30001787",
         "fraction.js": "^5.3.4",
         "picocolors": "^1.1.1",
         "postcss-value-parser": "^4.2.0"
@@ -8560,13 +8588,13 @@
       }
     },
     "node_modules/babel-plugin-polyfill-corejs2": {
-      "version": "0.4.15",
-      "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-corejs2/-/babel-plugin-polyfill-corejs2-0.4.15.tgz",
-      "integrity": "sha512-hR3GwrRwHUfYwGfrisXPIDP3JcYfBrW7wKE7+Au6wDYl7fm/ka1NEII6kORzxNU556JjfidZeBsO10kYvtV1aw==",
+      "version": "0.4.17",
+      "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-corejs2/-/babel-plugin-polyfill-corejs2-0.4.17.tgz",
+      "integrity": "sha512-aTyf30K/rqAsNwN76zYrdtx8obu0E4KoUME29B1xj+B3WxgvWkp943vYQ+z8Mv3lw9xHXMHpvSPOBxzAkIa94w==",
       "license": "MIT",
       "dependencies": {
         "@babel/compat-data": "^7.28.6",
-        "@babel/helper-define-polyfill-provider": "^0.6.6",
+        "@babel/helper-define-polyfill-provider": "^0.6.8",
         "semver": "^6.3.1"
       },
       "peerDependencies": {
@@ -8596,12 +8624,12 @@
       }
     },
     "node_modules/babel-plugin-polyfill-regenerator": {
-      "version": "0.6.6",
-      "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-regenerator/-/babel-plugin-polyfill-regenerator-0.6.6.tgz",
-      "integrity": "sha512-hYm+XLYRMvupxiQzrvXUj7YyvFFVfv5gI0R71AJzudg1g2AI2vyCPPIFEBjk162/wFzti3inBHo7isWFuEVS/A==",
+      "version": "0.6.8",
+      "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-regenerator/-/babel-plugin-polyfill-regenerator-0.6.8.tgz",
+      "integrity": "sha512-M762rNHfSF1EV3SLtnCJXFoQbbIIz0OyRwnCmV0KPC7qosSfCO0QLTSuJX3ayAebubhE6oYBAYPrBA5ljowaZg==",
       "license": "MIT",
       "dependencies": {
-        "@babel/helper-define-polyfill-provider": "^0.6.6"
+        "@babel/helper-define-polyfill-provider": "^0.6.8"
       },
       "peerDependencies": {
         "@babel/core": "^7.4.0 || ^8.0.0-0 <8.0.0"
@@ -8619,7 +8647,8 @@
     "node_modules/balanced-match": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
-      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw=="
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "license": "MIT"
     },
     "node_modules/base64-js": {
       "version": "1.5.1",
@@ -8642,9 +8671,9 @@
       ]
     },
     "node_modules/baseline-browser-mapping": {
-      "version": "2.10.0",
-      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.0.tgz",
-      "integrity": "sha512-lIyg0szRfYbiy67j9KN8IyeD7q7hcmqnJ1ddWmNt19ItGpNN64mnllmxUNFIOdOm6by97jlL6wfpTTJrmnjWAA==",
+      "version": "2.10.23",
+      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.23.tgz",
+      "integrity": "sha512-xwVXGqevyKPsiuQdLj+dZMVjidjJV508TBqexND5HrF89cGdCYCJFB3qhcxRHSeMctdCfbR1jrxBajhDy7o29g==",
       "license": "Apache-2.0",
       "bin": {
         "baseline-browser-mapping": "dist/cli.cjs"
@@ -8783,9 +8812,10 @@
       }
     },
     "node_modules/brace-expansion": {
-      "version": "1.1.12",
-      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz",
-      "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==",
+      "version": "1.1.14",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.14.tgz",
+      "integrity": "sha512-MWPGfDxnyzKU7rNOW9SP/c50vi3xrmrua/+6hfPbCS2ABNWfx24vPidzvC7krjU/RTo235sV776ymlsMtGKj8g==",
+      "license": "MIT",
       "dependencies": {
         "balanced-match": "^1.0.0",
         "concat-map": "0.0.1"
@@ -8933,9 +8963,9 @@
       }
     },
     "node_modules/browserslist": {
-      "version": "4.28.1",
-      "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.1.tgz",
-      "integrity": "sha512-ZC5Bd0LgJXgwGqUknZY/vkUQ04r8NXnJZ3yYi4vDmSiZmC/pdSN0NbNRPxZpbtO4uAfDUAFffO8IZoM3Gj8IkA==",
+      "version": "4.28.2",
+      "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.2.tgz",
+      "integrity": "sha512-48xSriZYYg+8qXna9kwqjIVzuQxi+KYWp2+5nCYnYKPTr0LvD89Jqk2Or5ogxz0NUMfIjhh2lIUX/LyX9B4oIg==",
       "funding": [
         {
           "type": "opencollective",
@@ -8952,11 +8982,11 @@
       ],
       "license": "MIT",
       "dependencies": {
-        "baseline-browser-mapping": "^2.9.0",
-        "caniuse-lite": "^1.0.30001759",
-        "electron-to-chromium": "^1.5.263",
-        "node-releases": "^2.0.27",
-        "update-browserslist-db": "^1.2.0"
+        "baseline-browser-mapping": "^2.10.12",
+        "caniuse-lite": "^1.0.30001782",
+        "electron-to-chromium": "^1.5.328",
+        "node-releases": "^2.0.36",
+        "update-browserslist-db": "^1.2.3"
       },
       "bin": {
         "browserslist": "cli.js"
@@ -9025,6 +9055,7 @@
       "version": "3.0.0",
       "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.0.0.tgz",
       "integrity": "sha512-pMhOfFDPiv9t5jjIXkHosWmkSyQbvsgEVNkz0ERHbuLh2T/7j4Mqqpz523Fe8MVY89KC6Sh/QfS2sM+SjgFDcw==",
+      "license": "MIT",
       "engines": {
         "node": ">= 0.8"
       }
@@ -9149,9 +9180,9 @@
       }
     },
     "node_modules/caniuse-lite": {
-      "version": "1.0.30001770",
-      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001770.tgz",
-      "integrity": "sha512-x/2CLQ1jHENRbHg5PSId2sXq1CIO1CISvwWAj027ltMVG2UNgW+w9oH2+HzgEIRFembL8bUlXtfbBHR1fCg2xw==",
+      "version": "1.0.30001791",
+      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001791.tgz",
+      "integrity": "sha512-yk0l/YSrOnFZk3UROpDLQD9+kC1l4meK/wed583AXrzoarMGJcbRi2Q4RaUYbKxYAsZ8sWmaSa/DsLmdBeI1vQ==",
       "funding": [
         {
           "type": "opencollective",
@@ -9604,7 +9635,8 @@
     "node_modules/concat-map": {
       "version": "0.0.1",
       "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
-      "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg=="
+      "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==",
+      "license": "MIT"
     },
     "node_modules/confbox": {
       "version": "0.1.8",
@@ -9678,6 +9710,7 @@
       "version": "0.5.2",
       "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.2.tgz",
       "integrity": "sha512-kRGRZw3bLlFISDBgwTSA1TMBFN6J6GWDeubmDE3AF+3+yXL8hTWv8r5rkLbqYXY4RjPk/EzHnClI3zQf1cFmHA==",
+      "license": "MIT",
       "engines": {
         "node": ">= 0.6"
       }
@@ -9711,6 +9744,18 @@
       "integrity": "sha512-NXdYc3dLr47pBkpUCHtKSwIOQXLVn8dZEuywboCOJY/osA0wFSLlSawr3KN8qXJEyX66FcONTH8EIlVuK0yyFA==",
       "license": "MIT"
     },
+    "node_modules/copy-text-to-clipboard": {
+      "version": "3.2.2",
+      "resolved": "https://registry.npmjs.org/copy-text-to-clipboard/-/copy-text-to-clipboard-3.2.2.tgz",
+      "integrity": "sha512-T6SqyLd1iLuqPA90J5N4cTalrtovCySh58iiZDGJ6FGznbclKh4UI+FGacQSgFzwKG77W7XT5gwbVEbd9cIH1A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/copy-webpack-plugin": {
       "version": "11.0.0",
       "resolved": "https://registry.npmjs.org/copy-webpack-plugin/-/copy-webpack-plugin-11.0.0.tgz",
@@ -9789,9 +9834,9 @@
       }
     },
     "node_modules/core-js-compat": {
-      "version": "3.48.0",
-      "resolved": "https://registry.npmjs.org/core-js-compat/-/core-js-compat-3.48.0.tgz",
-      "integrity": "sha512-OM4cAF3D6VtH/WkLtWvyNC56EZVXsZdU3iqaMG2B4WvYrlqU831pc4UtG5yp0sE9z8Y02wVN7PjW5Zf9Gt0f1Q==",
+      "version": "3.49.0",
+      "resolved": "https://registry.npmjs.org/core-js-compat/-/core-js-compat-3.49.0.tgz",
+      "integrity": "sha512-VQXt1jr9cBz03b331DFDCCP90b3fanciLkgiOoy8SBHy06gNf+vQ1A3WFLqG7I8TipYIKeYK9wxd0tUrvHcOZA==",
       "license": "MIT",
       "dependencies": {
         "browserslist": "^4.28.1"
@@ -9801,17 +9846,6 @@
         "url": "https://opencollective.com/core-js"
       }
     },
-    "node_modules/core-js-pure": {
-      "version": "3.48.0",
-      "resolved": "https://registry.npmjs.org/core-js-pure/-/core-js-pure-3.48.0.tgz",
-      "integrity": "sha512-1slJgk89tWC51HQ1AEqG+s2VuwpTRr8ocu4n20QUcH1v9lAN0RXen0Q0AABa/DK1I7RrNWLucplOHMx8hfTGTw==",
-      "hasInstallScript": true,
-      "license": "MIT",
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/core-js"
-      }
-    },
     "node_modules/core-util-is": {
       "version": "1.0.3",
       "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz",
@@ -9997,9 +10031,9 @@
       }
     },
     "node_modules/css-declaration-sorter": {
-      "version": "7.3.1",
-      "resolved": "https://registry.npmjs.org/css-declaration-sorter/-/css-declaration-sorter-7.3.1.tgz",
-      "integrity": "sha512-gz6x+KkgNCjxq3Var03pRYLhyNfwhkKF1g/yoLgDNtFvVu0/fOLV9C8fFEZRjACp/XQLumjAYo7JVjzH3wLbxA==",
+      "version": "7.4.0",
+      "resolved": "https://registry.npmjs.org/css-declaration-sorter/-/css-declaration-sorter-7.4.0.tgz",
+      "integrity": "sha512-LTuzjPoyA2vMGKKcaOqKSp7Ub2eGrNfKiZH4LpezxpNrsICGCSFvsQOI29psISxNZtaXibkC2CXzrQ5enMeGGw==",
       "license": "ISC",
       "engines": {
         "node": "^14 || ^16 || >=18"
@@ -10212,9 +10246,9 @@
       }
     },
     "node_modules/cssdb": {
-      "version": "8.7.1",
-      "resolved": "https://registry.npmjs.org/cssdb/-/cssdb-8.7.1.tgz",
-      "integrity": "sha512-+F6LKx48RrdGOtE4DT5jz7Uo+VeyKXpK797FAevIkzjV8bMHz6xTO5F7gNDcRCHmPgD5jj2g6QCsY9zmVrh38A==",
+      "version": "8.8.0",
+      "resolved": "https://registry.npmjs.org/cssdb/-/cssdb-8.8.0.tgz",
+      "integrity": "sha512-QbLeyz2Bgso1iRlh7IpWk6OKa3lLNGXsujVjDMPl9rOZpxKeiG69icLpbLCFxeURwmcdIfZqQyhlooKJYM4f8Q==",
       "funding": [
         {
           "type": "opencollective",
@@ -11240,9 +11274,10 @@
       }
     },
     "node_modules/dompurify": {
-      "version": "3.2.6",
-      "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.2.6.tgz",
-      "integrity": "sha512-/2GogDQlohXPZe6D6NOgQvXLPSYBqIWMnZ8zzOhn09REE4eyAzb+Hed3jhoM9OkuaJ8P6ZGTTVWQKAi8ieIzfQ==",
+      "version": "3.4.1",
+      "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.4.1.tgz",
+      "integrity": "sha512-JahakDAIg1gyOm7dlgWSDjV4n7Ip2PKR55NIT6jrMfIgLFgWo81vdr1/QGqWtFNRqXP9UV71oVePtjqS2ebnPw==",
+      "license": "(MPL-2.0 OR Apache-2.0)",
       "optionalDependencies": {
         "@types/trusted-types": "^2.0.7"
       }
@@ -11322,9 +11357,9 @@
       "license": "MIT"
     },
     "node_modules/electron-to-chromium": {
-      "version": "1.5.302",
-      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.302.tgz",
-      "integrity": "sha512-sM6HAN2LyK82IyPBpznDRqlTQAtuSaO+ShzFiWTvoMJLHyZ+Y39r8VMfHzwbU8MVBzQ4Wdn85+wlZl2TLGIlwg==",
+      "version": "1.5.344",
+      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.344.tgz",
+      "integrity": "sha512-4MxfbmNDm+KPh066EZy+eUnkcDPcZ35wNmOWzFuh/ijvHsve6kbLTLURy88uCNK5FbpN+yk2nQY6BYh1GEt+wg==",
       "license": "ISC"
     },
     "node_modules/elliptic": {
@@ -11858,9 +11893,9 @@
       "license": "MIT"
     },
     "node_modules/express/node_modules/path-to-regexp": {
-      "version": "0.1.12",
-      "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.12.tgz",
-      "integrity": "sha512-RA1GjUVMnvYFxuqovrEqZoxxW5NUZqbwKtYz/Tt7nXerk0LbLblQmrsgdeOxV5SFHf0UDggjS/bSeOZwt1pmEQ==",
+      "version": "0.1.13",
+      "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.13.tgz",
+      "integrity": "sha512-A/AGNMFN3c8bOlvV9RreMdrv7jsmF9XIfDeCd87+I8RNg6s78BhJxMu69NEMHBSJFxKidViTEdruRwEk/WIKqA==",
       "license": "MIT"
     },
     "node_modules/express/node_modules/range-parser": {
@@ -12022,9 +12057,9 @@
       }
     },
     "node_modules/file-loader/node_modules/ajv": {
-      "version": "6.14.0",
-      "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.14.0.tgz",
-      "integrity": "sha512-IWrosm/yrn43eiKqkfkHis7QioDleaXQHdDVPKg0FSwwd/DuvyX79TZnFOnYpB7dcsFAMmtFztZuXPDvSePkFw==",
+      "version": "6.15.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.15.0.tgz",
+      "integrity": "sha512-fgFx7Hfoq60ytK2c7DhnF8jIvzYgOMxfugjLOSMHjLIPgenqa7S7oaagATUq99mV6IYvN2tRmC0wnTYX6iPbMw==",
       "license": "MIT",
       "dependencies": {
         "fast-deep-equal": "^3.1.1",
@@ -13755,7 +13790,8 @@
     "node_modules/isarray": {
       "version": "0.0.1",
       "resolved": "https://registry.npmjs.org/isarray/-/isarray-0.0.1.tgz",
-      "integrity": "sha512-D2S+3GLxWH+uhrNEcoh/fnmYeP8E8/zHl644d/jdA0g2uyXvy3sb0qxotE+ne0LtccHknQzWwZEzhak7oJ0COQ=="
+      "integrity": "sha512-D2S+3GLxWH+uhrNEcoh/fnmYeP8E8/zHl644d/jdA0g2uyXvy3sb0qxotE+ne0LtccHknQzWwZEzhak7oJ0COQ==",
+      "license": "MIT"
     },
     "node_modules/isexe": {
       "version": "2.0.0",
@@ -16526,9 +16562,9 @@
       }
     },
     "node_modules/mini-css-extract-plugin": {
-      "version": "2.10.0",
-      "resolved": "https://registry.npmjs.org/mini-css-extract-plugin/-/mini-css-extract-plugin-2.10.0.tgz",
-      "integrity": "sha512-540P2c5dYnJlyJxTaSloliZexv8rji6rY8FhQN+WF/82iHQfA23j/xtJx97L+mXOML27EqksSek/g4eK7jaL3g==",
+      "version": "2.10.2",
+      "resolved": "https://registry.npmjs.org/mini-css-extract-plugin/-/mini-css-extract-plugin-2.10.2.tgz",
+      "integrity": "sha512-AOSS0IdEB95ayVkxn5oGzNQwqAi2J0Jb/kKm43t7H73s8+f5873g0yuj0PNvK4dO75mu5DHg4nlgp4k6Kga8eg==",
       "license": "MIT",
       "dependencies": {
         "schema-utils": "^4.0.0",
@@ -16557,9 +16593,10 @@
       "dev": true
     },
     "node_modules/minimatch": {
-      "version": "3.1.2",
-      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
-      "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+      "version": "3.1.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz",
+      "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==",
+      "license": "ISC",
       "dependencies": {
         "brace-expansion": "^1.1.7"
       },
@@ -16752,9 +16789,9 @@
       }
     },
     "node_modules/node-releases": {
-      "version": "2.0.27",
-      "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.27.tgz",
-      "integrity": "sha512-nmh3lCkYZ3grZvqcCH+fjmQ7X+H0OeZgP40OierEaAptX4XofMh5kwNbWh7lBduUzCcV/8kZ+NDLCwm2iorIlA==",
+      "version": "2.0.38",
+      "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.38.tgz",
+      "integrity": "sha512-3qT/88Y3FbH/Kx4szpQQ4HzUbVrHPKTLVpVocKiLfoYvw9XSGOX2FmD2d6DrXbVYyAQTF2HeF6My8jmzx7/CRw==",
       "license": "MIT"
     },
     "node_modules/normalize-path": {
@@ -16837,9 +16874,9 @@
       }
     },
     "node_modules/null-loader/node_modules/ajv": {
-      "version": "6.14.0",
-      "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.14.0.tgz",
-      "integrity": "sha512-IWrosm/yrn43eiKqkfkHis7QioDleaXQHdDVPKg0FSwwd/DuvyX79TZnFOnYpB7dcsFAMmtFztZuXPDvSePkFw==",
+      "version": "6.15.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.15.0.tgz",
+      "integrity": "sha512-fgFx7Hfoq60ytK2c7DhnF8jIvzYgOMxfugjLOSMHjLIPgenqa7S7oaagATUq99mV6IYvN2tRmC0wnTYX6iPbMw==",
       "license": "MIT",
       "dependencies": {
         "fast-deep-equal": "^3.1.1",
@@ -17362,7 +17399,8 @@
     "node_modules/path-is-inside": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/path-is-inside/-/path-is-inside-1.0.2.tgz",
-      "integrity": "sha512-DUWJr3+ULp4zXmol/SZkFf3JGsS9/SIv+Y3Rt93/UjPpDpklB5f1er4O3POIbUuUJ3FXgqte2Q7SrU6zAqwk8w=="
+      "integrity": "sha512-DUWJr3+ULp4zXmol/SZkFf3JGsS9/SIv+Y3Rt93/UjPpDpklB5f1er4O3POIbUuUJ3FXgqte2Q7SrU6zAqwk8w==",
+      "license": "(WTFPL OR MIT)"
     },
     "node_modules/path-key": {
       "version": "3.1.1",
@@ -17378,14 +17416,6 @@
       "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==",
       "license": "MIT"
     },
-    "node_modules/path-to-regexp": {
-      "version": "1.9.0",
-      "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-1.9.0.tgz",
-      "integrity": "sha512-xIp7/apCFJuUHdDLWe8O1HIkb0kQrOMb/0u6FXQjemHn/ii5LrIzU6bdECnsiTF/GjZkMEKg1xdiZwNqDYlZ6g==",
-      "dependencies": {
-        "isarray": "0.0.1"
-      }
-    },
     "node_modules/path-type": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/path-type/-/path-type-4.0.0.tgz",
@@ -17438,9 +17468,9 @@
       "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="
     },
     "node_modules/picomatch": {
-      "version": "2.3.1",
-      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
-      "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
+      "version": "2.3.2",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz",
+      "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==",
       "license": "MIT",
       "engines": {
         "node": ">=8.6"
@@ -17516,9 +17546,9 @@
       }
     },
     "node_modules/postcss": {
-      "version": "8.5.6",
-      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.6.tgz",
-      "integrity": "sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg==",
+      "version": "8.5.12",
+      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.12.tgz",
+      "integrity": "sha512-W62t/Se6rA0Az3DfCL0AqJwXuKwBeYg6nOaIgzP+xZ7N5BFCI7DYi1qs6ygUYT6rvfi6t9k65UMLJC+PHZpDAA==",
       "funding": [
         {
           "type": "opencollective",
@@ -19212,6 +19242,7 @@
       "version": "2.1.0",
       "resolved": "https://registry.npmjs.org/randombytes/-/randombytes-2.1.0.tgz",
       "integrity": "sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ==",
+      "dev": true,
       "dependencies": {
         "safe-buffer": "^5.1.0"
       }
@@ -19230,6 +19261,7 @@
       "version": "1.2.0",
       "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.0.tgz",
       "integrity": "sha512-kA5WQoNVo4t9lNx2kQNFCxKeBl5IbbSNBl1M/tLkw9WCn+hxNBAW5Qh8gdhs63CJnhjJ2zQWFoqPJP2sK1AV5A==",
+      "license": "MIT",
       "engines": {
         "node": ">= 0.6"
       }
@@ -19398,9 +19430,10 @@
       }
     },
     "node_modules/react-loadable-ssr-addon-v5-slorber": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/react-loadable-ssr-addon-v5-slorber/-/react-loadable-ssr-addon-v5-slorber-1.0.1.tgz",
-      "integrity": "sha512-lq3Lyw1lGku8zUEJPDxsNm1AfYHBrO9Y1+olAYwpUJ2IGFBskM0DMKok97A6LWUpHm+o7IvQBOWu9MLenp9Z+A==",
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/react-loadable-ssr-addon-v5-slorber/-/react-loadable-ssr-addon-v5-slorber-1.0.3.tgz",
+      "integrity": "sha512-GXfh9VLwB5ERaCsU6RULh7tkemeX15aNh6wuMEBtfdyMa7fFG8TXrhXlx1SoEK2Ty/l6XIkzzYIQmyaWW3JgdQ==",
+      "license": "MIT",
       "dependencies": {
         "@babel/runtime": "^7.10.3"
       },
@@ -19530,6 +19563,15 @@
         "react": ">=15"
       }
     },
+    "node_modules/react-router/node_modules/path-to-regexp": {
+      "version": "1.9.0",
+      "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-1.9.0.tgz",
+      "integrity": "sha512-xIp7/apCFJuUHdDLWe8O1HIkb0kQrOMb/0u6FXQjemHn/ii5LrIzU6bdECnsiTF/GjZkMEKg1xdiZwNqDYlZ6g==",
+      "license": "MIT",
+      "dependencies": {
+        "isarray": "0.0.1"
+      }
+    },
     "node_modules/react-style-singleton": {
       "version": "2.2.3",
       "resolved": "https://registry.npmjs.org/react-style-singleton/-/react-style-singleton-2.2.3.tgz",
@@ -19747,9 +19789,9 @@
       "license": "MIT"
     },
     "node_modules/regjsparser": {
-      "version": "0.13.0",
-      "resolved": "https://registry.npmjs.org/regjsparser/-/regjsparser-0.13.0.tgz",
-      "integrity": "sha512-NZQZdC5wOE/H3UT28fVGL+ikOZcEzfMGk/c3iN9UGxzWHMa1op7274oyiUVrAG4B2EuFhus8SvkaYnhvW92p9Q==",
+      "version": "0.13.1",
+      "resolved": "https://registry.npmjs.org/regjsparser/-/regjsparser-0.13.1.tgz",
+      "integrity": "sha512-dLsljMd9sqwRkby8zhO1gSg3PnJIBFid8f4CQj/sXx+7cKx+E7u0PKhZ+U4wmhx7EfmtvnA318oVaIkAB1lRJw==",
       "license": "BSD-2-Clause",
       "dependencies": {
         "jsesc": "~3.1.0"
@@ -20044,11 +20086,12 @@
       "license": "MIT"
     },
     "node_modules/resolve": {
-      "version": "1.22.11",
-      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.11.tgz",
-      "integrity": "sha512-RfqAvLnMl313r7c9oclB1HhUEAezcpLjz95wFH4LVuhk9JF/r22qmVP9AMmOU4vMX7Q8pN8jwNg/CSpdFnMjTQ==",
+      "version": "1.22.12",
+      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.12.tgz",
+      "integrity": "sha512-TyeJ1zif53BPfHootBGwPRYT1RUt6oGWsaQr8UyZW/eAm9bKoijtvruSDEmZHm92CwS9nj7/fWttqPCgzep8CA==",
       "license": "MIT",
       "dependencies": {
+        "es-errors": "^1.3.0",
         "is-core-module": "^2.16.1",
         "path-parse": "^1.0.7",
         "supports-preserve-symlinks-flag": "^1.0.0"
@@ -20310,9 +20353,9 @@
       "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg=="
     },
     "node_modules/sax": {
-      "version": "1.5.0",
-      "resolved": "https://registry.npmjs.org/sax/-/sax-1.5.0.tgz",
-      "integrity": "sha512-21IYA3Q5cQf089Z6tgaUTr7lDAyzoTPx5HRtbhsME8Udispad8dC/+sziTNugOEx54ilvatQ9YCzl4KQLPcRHA==",
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/sax/-/sax-1.6.0.tgz",
+      "integrity": "sha512-6R3J5M4AcbtLUdZmRv2SygeVaM7IhrLXu9BmnOGmmACak8fiUtOsYNWUS4uK7upbmHIBbLBeFeI//477BKLBzA==",
       "license": "BlueOak-1.0.0",
       "engines": {
         "node": ">=11.0.0"
@@ -20464,22 +20507,24 @@
       }
     },
     "node_modules/serialize-javascript": {
-      "version": "6.0.2",
-      "resolved": "https://registry.npmjs.org/serialize-javascript/-/serialize-javascript-6.0.2.tgz",
-      "integrity": "sha512-Saa1xPByTTq2gdeFZYLLo+RFE35NHZkAbqZeWNd3BpzppeVisAqpDjcp8dyf6uIvEqJRd46jemmyA4iFIeVk8g==",
-      "dependencies": {
-        "randombytes": "^2.1.0"
+      "version": "7.0.5",
+      "resolved": "https://registry.npmjs.org/serialize-javascript/-/serialize-javascript-7.0.5.tgz",
+      "integrity": "sha512-F4LcB0UqUl1zErq+1nYEEzSHJnIwb3AF2XWB94b+afhrekOUijwooAYqFyRbjYkm2PAKBabx6oYv/xDxNi8IBw==",
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=20.0.0"
       }
     },
     "node_modules/serve-handler": {
-      "version": "6.1.6",
-      "resolved": "https://registry.npmjs.org/serve-handler/-/serve-handler-6.1.6.tgz",
-      "integrity": "sha512-x5RL9Y2p5+Sh3D38Fh9i/iQ5ZK+e4xuXRd/pGbM4D13tgo/MGwbttUk8emytcr1YYzBYs+apnUngBDFYfpjPuQ==",
+      "version": "6.1.7",
+      "resolved": "https://registry.npmjs.org/serve-handler/-/serve-handler-6.1.7.tgz",
+      "integrity": "sha512-CinAq1xWb0vR3twAv9evEU8cNWkXCb9kd5ePAHUKJBkOsUpR1wt/CvGdeca7vqumL1U5cSaeVQ6zZMxiJ3yWsg==",
+      "license": "MIT",
       "dependencies": {
         "bytes": "3.0.0",
         "content-disposition": "0.5.2",
         "mime-types": "2.1.18",
-        "minimatch": "3.1.2",
+        "minimatch": "3.1.5",
         "path-is-inside": "1.0.2",
         "path-to-regexp": "3.3.0",
         "range-parser": "1.2.0"
@@ -20489,6 +20534,7 @@
       "version": "1.33.0",
       "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.33.0.tgz",
       "integrity": "sha512-BHJ/EKruNIqJf/QahvxwQZXKygOQ256myeN/Ew+THcAa5q+PjyTTMMeNQC4DZw5AwfvelsUrA6B67NKMqXDbzQ==",
+      "license": "MIT",
       "engines": {
         "node": ">= 0.6"
       }
@@ -20497,6 +20543,7 @@
       "version": "2.1.18",
       "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.18.tgz",
       "integrity": "sha512-lc/aahn+t4/SWV/qcmumYjymLsWfN3ELhpmVuUFjgsORruuZPVSwAQryq+HHGvO/SI2KVX26bx+En+zhM8g8hQ==",
+      "license": "MIT",
       "dependencies": {
         "mime-db": "~1.33.0"
       },
@@ -20507,7 +20554,8 @@
     "node_modules/serve-handler/node_modules/path-to-regexp": {
       "version": "3.3.0",
       "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-3.3.0.tgz",
-      "integrity": "sha512-qyCH421YQPS2WFDxDjftfc1ZR5WKQzVzqsp4n9M2kQhVOo/ByahFoUNJfl58kOcEGfQ//7weFTDhm+ss8Ecxgw=="
+      "integrity": "sha512-qyCH421YQPS2WFDxDjftfc1ZR5WKQzVzqsp4n9M2kQhVOo/ByahFoUNJfl58kOcEGfQ//7weFTDhm+ss8Ecxgw==",
+      "license": "MIT"
     },
     "node_modules/serve-index": {
       "version": "1.9.2",
@@ -20782,9 +20830,9 @@
       "integrity": "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg=="
     },
     "node_modules/sitemap": {
-      "version": "7.1.2",
-      "resolved": "https://registry.npmjs.org/sitemap/-/sitemap-7.1.2.tgz",
-      "integrity": "sha512-ARCqzHJ0p4gWt+j7NlU5eDlIO9+Rkr/JhPFZKKQ1l5GCus7rJH4UdrlVAh0xC/gDS/Qir2UMxqYNHtsKr2rpCw==",
+      "version": "7.1.3",
+      "resolved": "https://registry.npmjs.org/sitemap/-/sitemap-7.1.3.tgz",
+      "integrity": "sha512-tAjEd+wt/YwnEbfNB2ht51ybBJxbEWwe5ki/Z//Wh0rpBFTCUSj46GnxUKEWzhfuJTsee8x3lybHxFgUMig2hw==",
       "license": "MIT",
       "dependencies": {
         "@types/node": "^17.0.5",
@@ -21901,9 +21949,9 @@
       }
     },
     "node_modules/url-loader/node_modules/ajv": {
-      "version": "6.14.0",
-      "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.14.0.tgz",
-      "integrity": "sha512-IWrosm/yrn43eiKqkfkHis7QioDleaXQHdDVPKg0FSwwd/DuvyX79TZnFOnYpB7dcsFAMmtFztZuXPDvSePkFw==",
+      "version": "6.15.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.15.0.tgz",
+      "integrity": "sha512-fgFx7Hfoq60ytK2c7DhnF8jIvzYgOMxfugjLOSMHjLIPgenqa7S7oaagATUq99mV6IYvN2tRmC0wnTYX6iPbMw==",
       "license": "MIT",
       "dependencies": {
         "fast-deep-equal": "^3.1.1",
diff --git a/package.json b/package.json
index 30959316..c796f9a8 100644
--- a/package.json
+++ b/package.json
@@ -17,11 +17,11 @@
     "typecheck": "tsc"
   },
   "dependencies": {
-    "@docusaurus/core": "^3.9.2",
-    "@docusaurus/plugin-google-tag-manager": "^3.9.2",
-    "@docusaurus/preset-classic": "^3.9.2",
-    "@docusaurus/remark-plugin-npm2yarn": "^3.9.2",
-    "@docusaurus/theme-mermaid": "^3.9.2",
+    "@docusaurus/core": "^3.10.0",
+    "@docusaurus/plugin-google-tag-manager": "^3.10.0",
+    "@docusaurus/preset-classic": "^3.10.0",
+    "@docusaurus/remark-plugin-npm2yarn": "^3.10.0",
+    "@docusaurus/theme-mermaid": "^3.10.0",
     "@inkeep/cxkit-docusaurus": "^0.5.20",
     "@mdx-js/react": "^3.0.0",
     "@monaco-editor/react": "^4.4.6",
@@ -31,9 +31,9 @@
     "react-dom": "^18.2.0"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "^3.9.2",
-    "@docusaurus/tsconfig": "^3.9.2",
-    "@docusaurus/types": "^3.9.2",
+    "@docusaurus/module-type-aliases": "^3.10.0",
+    "@docusaurus/tsconfig": "^3.10.0",
+    "@docusaurus/types": "^3.10.0",
     "docusaurus-node-polyfills": "^1.0.0",
     "typescript": "^5.3.3"
   },
@@ -51,5 +51,10 @@
   },
   "engines": {
     "node": ">=18.0"
+  },
+  "overrides": {
+    "dompurify": "^3.4.0",
+    "serialize-javascript": "^7.0.5",
+    "picomatch": "^2.3.2"
   }
 }
diff --git a/plugins/remark/replace-variables/index.ts b/plugins/remark/replace-variables/index.ts
index 4b57c27a..60fe7865 100644
--- a/plugins/remark/replace-variables/index.ts
+++ b/plugins/remark/replace-variables/index.ts
@@ -1,25 +1,47 @@
 import { visit } from 'unist-util-visit';
 
-const plugin = (options) => {
+type Variable = { name: string; value: string };
 
-    const transformer = async (ast) => {
-        visit(ast, ["text", "code", "link"], (node) => {
-            if (node.type === "link") {
-                node.url = getValue(node.url, options);
-            } else {
-                node.value = getValue(node.value, options);
-            }            
-        });
-    };
-    return transformer;
+type Options = {
+    variables?: Variable[];
+    variablesByVersion?: Record;
 };
 
 const pattern = /\[var:([^[\]]+)\]/g;
-const getValue = (value, options) => {
+
+const versionFromPath = (filePath: string): string => {
+    if (!filePath) return 'current';
+    const normalized = filePath.replace(/\\/g, '/');
+    const match = normalized.match(/\/versioned_docs\/version-([^/]+)\//)
+        ?? normalized.match(/\/docusaurus-plugin-content-docs\/version-([^/]+)\//);
+    return match ? match[1] : 'current';
+};
+
+const getValue = (value: string, variables: Variable[]) => {
     return value.replace(pattern, (match, variableName) => {
-        const variable = options.variables.find(varObj => varObj.name === variableName);
+        const variable = variables.find(v => v.name === variableName);
         return variable ? variable.value : match;
     });
 };
 
-export default plugin;
\ No newline at end of file
+const plugin = (options: Options) => {
+    return async (ast: any, file: any) => {
+        const filePath: string = file?.path ?? file?.history?.[0] ?? '';
+        const version = versionFromPath(filePath);
+        const variables =
+            options.variablesByVersion?.[version]
+            ?? options.variablesByVersion?.current
+            ?? options.variables
+            ?? [];
+
+        visit(ast, ['text', 'code', 'link'], (node: any) => {
+            if (node.type === 'link') {
+                node.url = getValue(node.url, variables);
+            } else {
+                node.value = getValue(node.value, variables);
+            }
+        });
+    };
+};
+
+export default plugin;
diff --git a/sidebars.ts b/sidebars.ts
index 3d078541..131db184 100644
--- a/sidebars.ts
+++ b/sidebars.ts
@@ -38,6 +38,7 @@ const sidebars: SidebarsConfig = {
     /* -------------------- General -------------------- */
     {
       type: "category", label: "General", collapsed: false, collapsible: false, className: "sidebar__header", items: [
+        { type: "doc", label: "Accessibility", id: "web/accessibility" },
         { type: "doc", label: "Beta Features", id: "web/beta-features" },
         { type: "doc", label: "Caching", id: "web/caching" },
         { type: "doc", label: "Logging", id: "web/logging" },
@@ -112,7 +113,7 @@ const sidebars: SidebarsConfig = {
       type: "category", label: "Release Information", collapsed: false, collapsible: false, className: "sidebar__header", items: [
         {
           type: "category", label: "Release Notes", link: { type: "doc", id: "web/release-notes" }, items: [
-            { type: "doc", label: "1.6.0 Upgrade Guide", id: "web/upgrade-guide-v1.6.0" },
+            { type: "doc", label: "2.0.0 Upgrade Guide", id: "web/upgrade-guide-v2.0.0" },
           ]
         },
         { type: "doc", label: "Known Issues", id: "web/known-issues" },
@@ -121,7 +122,7 @@ const sidebars: SidebarsConfig = {
       ]
     },
 
-    /* -------------------- Web Component Wrappers  -------------------- */
+    /* -------------------- Web Component Wrappers  -------------------- 
     {
       type: "category", label: "Web Component Wrappers", collapsed: false, collapsible: false, className: "sidebar__header", items: [
         { type: "doc", label: "Overview", key: "web-component-wrappers-overview", id: "web/web-component-wrappers/index" },
@@ -144,6 +145,7 @@ const sidebars: SidebarsConfig = {
         },
       ]
     },
+    */
 
   ],
   
diff --git a/src/components/AiSpotlight/index.tsx b/src/components/AiSpotlight/index.tsx
index a94a8fad..b5c4d333 100644
--- a/src/components/AiSpotlight/index.tsx
+++ b/src/components/AiSpotlight/index.tsx
@@ -12,7 +12,7 @@ const codeSnippet = `const insight = await client.ai.insights.get({
 console.log(insight.explanation);
 // "Sales revenue reached $2.4M in Q4 2024..."`;
 
-export default function AiSpotlight(): JSX.Element {
+export default function AiSpotlight(): React.JSX.Element {
   return (
     

       

diff --git a/src/components/CodePreview/index.tsx b/src/components/CodePreview/index.tsx
index c57efa8d..d28ba72a 100644
--- a/src/components/CodePreview/index.tsx
+++ b/src/components/CodePreview/index.tsx
@@ -2,6 +2,7 @@ import React, { ReactNode, useEffect, useRef, useState } from "react";
 import CodeBlock from '@theme/CodeBlock';
 import './code-preview.css';
 import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
+import { useDocsVersionFromPath } from '@site/src/utils/useDocsVersionFromPath';
 
 interface CodeSnippetProps {
     children: ReactNode;
@@ -28,7 +29,7 @@ const extractCodeBlocks = (children: ReactNode) => {
         if (typeof child === 'string') {
             return;
         } else if (React.isValidElement(child)) {
-            const preElement = child.props.children;
+            const preElement = (child.props as { children?: ReactNode }).children;
             const codeElement: any = React.Children.toArray(preElement).find((c: any) => c && c.props && c.props.className);
 
             if (codeElement) {
@@ -102,7 +103,9 @@ const CodeSnippet = ({ language, code }: { language: string, code: string }) =>
 
 const CodePreview: React.FC = ({ children, previewHeight = 150, sourceOpen = false }) => {
     const { siteConfig } = useDocusaurusContext();
-    const sdkVersion = siteConfig.customFields.sdkVersion;
+    const version = useDocsVersionFromPath();
+    const sdkVersions = siteConfig.customFields.sdkVersions as Record | undefined;
+    const sdkVersion = sdkVersions?.[version] ?? siteConfig.customFields.sdkVersion;
 
     const [currentTab, setCurrentTab] = useState(LANGUAGES.HTML);
     const [showSource, setShowSource] = useState(sourceOpen);
diff --git a/src/components/DataSourcesTable/data-sources.ts b/src/components/DataSourcesTable/data-sources.ts
new file mode 100644
index 00000000..749928a5
--- /dev/null
+++ b/src/components/DataSourcesTable/data-sources.ts
@@ -0,0 +1,67 @@
+export type DataSourceItem = {
+    title: string;
+    topic?: string;
+    nuget?: string;
+    maven?: string;
+    npm?: string;
+};
+
+// Frozen snapshot for the 1.8.4 docs. Do not edit unless a 1.x patch
+// genuinely changes the supported set of data sources.
+export const dataSourcesV1: DataSourceItem[] = [
+    { title: "Amazon Athena", topic: "../adding-data-sources/amazon-athena", nuget: "Reveal.Sdk.Data.Amazon.Athena" },
+    { title: "Amazon Redshift", topic: "", nuget: "Reveal.Sdk.Data.Amazon.Redshift" },
+    { title: "Amazon S3", topic: "../adding-data-sources/amazon-s3", nuget: "Reveal.Sdk.Data.Amazon.S3" },
+    { title: "CSV (Comma Separated Values)", topic: "../adding-data-sources/csv" },
+    { title: "Databricks", topic: "../adding-data-sources/databricks", nuget: "Reveal.Sdk.Data.Databricks" },
+    { title: "Elasticsearch", topic: "../adding-data-sources/elasticsearch", nuget: "Reveal.Sdk.Data.Elasticsearch", maven: "" },
+    { title: "Google BigQuery", topic: "../adding-data-sources/google-big-query", nuget: "Reveal.Sdk.Data.Google.BigQuery" },
+    { title: "Google Sheets", topic: "../adding-data-sources/google-sheets", nuget: "Reveal.Sdk.Data.Google.Drive" },
+    { title: "In-Memory Data", topic: "../adding-data-sources/in-memory-data" },
+    { title: "JSON", topic: "../adding-data-sources/json" },
+    { title: "MariaDB", topic: "../adding-data-sources/mariadb", nuget: "Reveal.Sdk.Data.MariaDB" },
+    { title: "Microsoft Analysis Services", topic: "", nuget: "Reveal.Sdk.Data.Microsoft.AnalysisServices" },
+    { title: "Microsoft Azure Analysis Services", topic: "", nuget: "Reveal.Sdk.Data.Microsoft.AnalysisServices" },
+    { title: "Microsoft Azure SQL Database", topic: "", nuget: "Reveal.Sdk.Data.Microsoft.SqlServer" },
+    { title: "Microsoft Azure Synapse Analytics", topic: "", nuget: "Reveal.Sdk.Data.Microsoft.SynapseAnalytics" },
+    { title: "Microsoft Excel", topic: "../adding-data-sources/excel-file" },
+    { title: "Microsoft SQL Server", topic: "../adding-data-sources/ms-sql-server", nuget: "Reveal.Sdk.Data.Microsoft.SqlServer" },
+    { title: "MongoDB", topic: "../adding-data-sources/mongodb", nuget: "Reveal.Sdk.Data.MongoDb", maven: "" },
+    { title: "MySQL", topic: "../adding-data-sources/mysql", nuget: "Reveal.Sdk.Data.MySql" },
+    { title: "OData Feed", topic: "" },
+    { title: "Oracle", topic: "../adding-data-sources/oracle", nuget: "Reveal.Sdk.Data.Oracle" },
+    { title: "PostgreSQL", topic: "../adding-data-sources/postgres", nuget: "Reveal.Sdk.Data.PostgreSQL" },
+    { title: "REST", topic: "../adding-data-sources/rest" },
+    { title: "Snowflake", topic: "../adding-data-sources/snowflake", nuget: "Reveal.Sdk.Data.Snowflake" },
+    { title: "TSV (Tab Separated Values)", topic: "" },
+];
+
+// Active list used by the unreleased / current docs (2.x).
+// Edit this list as the supported data sources for 2.x evolve.
+export const dataSourcesCurrent: DataSourceItem[] = [
+    { title: "Amazon Athena", topic: "../adding-data-sources/amazon-athena", nuget: "Reveal.Sdk.Data.Amazon.Athena" },
+    { title: "Amazon Redshift", topic: "", nuget: "Reveal.Sdk.Data.Amazon.Redshift" },
+    { title: "Amazon S3", topic: "../adding-data-sources/amazon-s3", nuget: "Reveal.Sdk.Data.Amazon.S3" },
+    { title: "CSV (Comma Separated Values)", topic: "../adding-data-sources/csv" },
+    { title: "Databricks", topic: "../adding-data-sources/databricks", nuget: "Reveal.Sdk.Data.Databricks" },
+    { title: "Elasticsearch", topic: "../adding-data-sources/elasticsearch", nuget: "Reveal.Sdk.Data.Elasticsearch", maven: "" },
+    { title: "Google BigQuery", topic: "../adding-data-sources/google-big-query", nuget: "Reveal.Sdk.Data.Google.BigQuery" },
+    { title: "Google Sheets", topic: "../adding-data-sources/google-sheets", nuget: "Reveal.Sdk.Data.Google.Drive" },
+    { title: "In-Memory Data", topic: "../adding-data-sources/in-memory-data" },
+    { title: "JSON", topic: "../adding-data-sources/json" },
+    { title: "MariaDB", topic: "../adding-data-sources/mariadb", nuget: "Reveal.Sdk.Data.MariaDB" },
+    { title: "Microsoft Analysis Services", topic: "", nuget: "Reveal.Sdk.Data.Microsoft.AnalysisServices" },
+    { title: "Microsoft Azure Analysis Services", topic: "", nuget: "Reveal.Sdk.Data.Microsoft.AnalysisServices" },
+    { title: "Microsoft Azure SQL Database", topic: "", nuget: "Reveal.Sdk.Data.Microsoft.SqlServer" },
+    { title: "Microsoft Azure Synapse Analytics", topic: "", nuget: "Reveal.Sdk.Data.Microsoft.SynapseAnalytics" },
+    { title: "Microsoft Excel", topic: "../adding-data-sources/excel-file" },
+    { title: "Microsoft SQL Server", topic: "../adding-data-sources/ms-sql-server", nuget: "Reveal.Sdk.Data.Microsoft.SqlServer" },
+    { title: "MongoDB", topic: "../adding-data-sources/mongodb", nuget: "Reveal.Sdk.Data.MongoDb", maven: "" },
+    { title: "MySQL", topic: "../adding-data-sources/mysql", nuget: "Reveal.Sdk.Data.MySql" },
+    { title: "OData Feed", topic: "" },
+    { title: "Oracle", topic: "../adding-data-sources/oracle", nuget: "Reveal.Sdk.Data.Oracle" },
+    { title: "PostgreSQL", topic: "../adding-data-sources/postgres", nuget: "Reveal.Sdk.Data.PostgreSQL" },
+    { title: "REST", topic: "../adding-data-sources/rest" },
+    { title: "Snowflake", topic: "../adding-data-sources/snowflake", nuget: "Reveal.Sdk.Data.Snowflake" },
+    { title: "TSV (Tab Separated Values)", topic: "" },
+];
diff --git a/src/components/DataSourcesTable/index.tsx b/src/components/DataSourcesTable/index.tsx
index 325143a6..62561728 100644
--- a/src/components/DataSourcesTable/index.tsx
+++ b/src/components/DataSourcesTable/index.tsx
@@ -1,55 +1,14 @@
 import React from 'react';
+import { useDocsVersionFromPath } from '@site/src/utils/useDocsVersionFromPath';
+import { DataSourceItem, dataSourcesCurrent, dataSourcesV1 } from './data-sources';
 
-type DataSourceItem = {
-    title: string;
-    topic?: string;
-    nuget?: string;
-    maven?: string;
-    npm?: string;
+const DATA_SOURCES_BY_VERSION: Record = {
+    current: dataSourcesCurrent,
+    '1.8.4': dataSourcesV1,
 };
 
-const DataSources: DataSourceItem[] = [
-    { title: "Amazon Athena", topic: "../adding-data-sources/amazon-athena", nuget: "Reveal.Sdk.Data.Amazon.Athena" },
-    { title: "Amazon Redshift", topic: "", nuget: "Reveal.Sdk.Data.Amazon.Redshift" },
-    { title: "Amazon S3", topic: "../adding-data-sources/amazon-s3", nuget: "Reveal.Sdk.Data.Amazon.S3" },
-    // { title: "Box", topic: "", nuget: "Reveal.Sdk.Data.Box" }, do not advertise
-    { title: "CSV (Comma Separated Values)", topic: "../adding-data-sources/csv" },
-    // { title: "Dropbox", topic: "", nuget: "Reveal.Sdk.Data.Dropbox" }, do not advertise
-    { title: "Databricks", topic: "../adding-data-sources/databricks", nuget: "Reveal.Sdk.Data.Databricks" },
-    { title: "Elasticsearch", topic: "../adding-data-sources/elasticsearch", nuget: "Reveal.Sdk.Data.Elasticsearch", maven: "" },
-    // { title: "Google Analytics 4", topic: "", nuget: "Reveal.Sdk.Data.Google.Analytics4" }, do not advertise
-    { title: "Google BigQuery", topic: "../adding-data-sources/google-big-query", nuget: "Reveal.Sdk.Data.Google.BigQuery" },
-    // { title: "Google Drive", topic: "../adding-data-sources/google-drive", nuget: "Reveal.Sdk.Data.Google.Drive" }, do not advertise
-    { title: "Google Sheets", topic: "../adding-data-sources/google-sheets", nuget: "Reveal.Sdk.Data.Google.Drive" },
-    // { title: "Hubspot", topic: "", nuget: "Reveal.Sdk.Data.HubSpot" }, do not advertise
-    { title: "In-Memory Data", topic: "../adding-data-sources/in-memory-data" },
-    { title: "JSON", topic: "../adding-data-sources/json" },
-    // { title: "Marketo", topic: "", nuget: "Reveal.Sdk.Data.Marketo" }, do not advertise
-    { title: "MariaDB", topic: "../adding-data-sources/mariadb", nuget: "Reveal.Sdk.Data.MariaDB" },
-    { title: "Microsoft Analysis Services", topic: "", nuget: "Reveal.Sdk.Data.Microsoft.AnalysisServices" },
-    { title: "Microsoft Azure Analysis Services", topic: "", nuget: "Reveal.Sdk.Data.Microsoft.AnalysisServices" },
-    { title: "Microsoft Azure SQL Database", topic: "", nuget: "Reveal.Sdk.Data.Microsoft.SqlServer" },
-    { title: "Microsoft Azure Synapse Analytics", topic: "", nuget: "Reveal.Sdk.Data.Microsoft.SynapseAnalytics" },
-    // { title: "Microsoft Dynamics CRM", topic: "", nuget: "Reveal.Sdk.Data.Microsoft.Dynamics" }, do not advertise
-    { title: "Microsoft Excel", topic: "../adding-data-sources/excel-file" },
-    // { title: "Microsoft OneDrive", topic: "", nuget: "Reveal.Sdk.Data.Microsoft.OneDrive" }, do not advertise
-    // { title: "Microsoft Reporting Services (SSRS)", topic: "", nuget: "Reveal.Sdk.Data.Microsoft.ReportingServices" }, do not advertise
-    // { title: "Microsoft SharePoint", topic: "", nuget: "Reveal.Sdk.Data.Microsoft.SharePoint" }, do not advertise
-    { title: "Microsoft SQL Server", topic: "../adding-data-sources/ms-sql-server", nuget: "Reveal.Sdk.Data.Microsoft.SqlServer" },
-    { title: "MongoDB", topic: "../adding-data-sources/mongodb", nuget: "Reveal.Sdk.Data.MongoDb", maven: "" },
-    { title: "MySQL", topic: "../adding-data-sources/mysql", nuget: "Reveal.Sdk.Data.MySql" },
-    { title: "OData Feed", topic: "" },
-    { title: "Oracle", topic: "../adding-data-sources/oracle", nuget: "Reveal.Sdk.Data.Oracle" },
-    { title: "PostgreSQL", topic: "../adding-data-sources/postgres", nuget: "Reveal.Sdk.Data.PostgreSQL" },
-    // { title: "Quickbooks", topic: "", nuget: "Reveal.Sdk.Data.Quickbooks" }, do not advertise
-    { title: "REST", topic: "../adding-data-sources/rest" },
-    { title: "Snowflake", topic: "../adding-data-sources/snowflake", nuget: "Reveal.Sdk.Data.Snowflake" },
-    // { title: "Sybase", topic: "", nuget: "Reveal.Sdk.Data.Sybase" }, do not advertise
-    { title: "TSV (Tab Separated Values)", topic: "" },
-]
-
 function createHyperLink({ title, topic }: DataSourceItem) {
-    if (topic) return ( {title});        
+    if (topic) return ( {title});
     return ({title});
 }
 
@@ -82,6 +41,9 @@ function createNpmLink({ title, npm }: DataSourceItem) {
 }
 
 export default function DataSourcesTable({ isWpf = false }: { isWpf?: boolean }): React.JSX.Element {
+    const version = useDocsVersionFromPath();
+    const sources = DATA_SOURCES_BY_VERSION[version] ?? dataSourcesCurrent;
+
     return (
         
@@ -99,14 +61,14 @@ export default function DataSourcesTable({ isWpf = false }: { isWpf?: boolean })
                 
-                {DataSources.map((props, idx) => (
+                {sources.map((props, idx) => (
                     
                         {!isWpf ? (
                             <>
@@ -122,4 +84,4 @@ export default function DataSourcesTable({ isWpf = false }: { isWpf?: boolean })
             

             
             
             

                         
                             {isWpf ? (
                                 {props.title}
                             ) : (
                                 createHyperLink(props)
-                            )}                            
+                            )}
                         

         

     );
-}
\ No newline at end of file
+}
diff --git a/src/components/FrameworkPicker/index.tsx b/src/components/FrameworkPicker/index.tsx
index c306ad4d..30b97dca 100644
--- a/src/components/FrameworkPicker/index.tsx
+++ b/src/components/FrameworkPicker/index.tsx
@@ -3,7 +3,7 @@ import Translate from '@docusaurus/Translate';
 import styles from './styles.module.css';
 
 type FrameworkItem = {
-  label: JSX.Element;
+  label: React.JSX.Element;
   link: string;
   badge?: string;
 };
@@ -38,7 +38,7 @@ const frameworks: FrameworkItem[] = [
   },
 ];
 
-export default function FrameworkPicker(): JSX.Element {
+export default function FrameworkPicker(): React.JSX.Element {
   return (
     

       

diff --git a/src/components/HomepageFeatures/index.tsx b/src/components/HomepageFeatures/index.tsx
index b71107de..ca0ae2e4 100644
--- a/src/components/HomepageFeatures/index.tsx
+++ b/src/components/HomepageFeatures/index.tsx
@@ -21,7 +21,7 @@ function SparkleIcon() {
 }
 
 type QuickLink = {
-  label: JSX.Element;
+  label: React.JSX.Element;
   href: string;
 };
 
@@ -62,7 +62,7 @@ function Labels({ items }: { items: string[] }) {
   );
 }
 
-export default function HomepageFeatures(): JSX.Element {
+export default function HomepageFeatures(): React.JSX.Element {
   return (
     

       

diff --git a/src/components/PageSideBar/index.tsx b/src/components/PageSideBar/index.tsx
index 8cbabc40..cf41eac4 100644
--- a/src/components/PageSideBar/index.tsx
+++ b/src/components/PageSideBar/index.tsx
@@ -12,7 +12,7 @@ interface PageSidebarProps {
     onItemClick: (item: any) => void;
 }
 
-export default function PageSideBar({ items, onItemClick }: PageSidebarProps): JSX.Element {
+export default function PageSideBar({ items, onItemClick }: PageSidebarProps): React.JSX.Element {
 
     return (