/sap-sac-scripting

name: sap-sac-scripting
description: |
  Comprehensive SAC scripting skill for SAP Analytics Cloud Analytics Designer and Optimized Story Experience. This skill should be used when the user asks to "create SAC script", "debug Analytics Designer", "optimize SAC performance", "planning operations in SAC", "filter data in SAC", "use DataSource API", "chart scripting", "table manipulation", "SAC event handlers", "version management", "data locking", "Optimized Story Experience API", "OSE scripting", "OSE widget API", "OSE DataSource", "story scripting API", "OSE planning API", "OSE method", "optimized story", "SAC story scripting", "story script", "SAC scripting", "debug SAC runtime in Microsoft Edge via CDP", or works with SAC widgets, planning models, or analytics applications.
license: GPL-3.0
metadata:
  maintainer: "Eduard Jiglau"
  maintainer_email: "hello@sap-ai-skills.com"
  website: "https://sap-ai-skills.com"
  version: "2.4.1"
  last_verified: 2026-06-11
  sac_version: "Q2 2026 (2026.8)"
  api_reference_version: "2025.20 (OSE Q2 2026)"
  documentation_source: https://help.sap.com/docs/SAP_ANALYTICS_CLOUD
  reference_files: 66
  template_patterns: 56
  agents: 4
  commands: 4
  status: docs_audited_runtime_pending
  known_issues:
    - Live SAC story/runtime checks require tenant evidence before claiming production validation.

SAP Analytics Cloud Scripting

Related Skills

• **sap-dependency-security**: Use when securing dependency, SDK/tooling, and source-pinned SAC MCP upgrades used in story automation pipelines
• **sap-browser-automation**: Use for in-app manual authentication, consent-gated Edge profile reuse, fresh Edge/CDP startup, auth-state bootstrap, and browser recovery

When to Use This Skill

Use this skill when writing or debugging SAC Analytics Designer scripts, Optimized Story Experience scripts, widget APIs, data-source filtering/selection logic, planning/version scripts, export/navigation handlers, performance-sensitive story logic, or SAC MCP-assisted automation.

Comprehensive skill for scripting in SAP Analytics Cloud (SAC) Analytics Designer and Optimized Story Experience.

For authenticated SAC browser runtime inspection, use `sap-browser-automation` for manual in-app authentication, consent-gated Edge profile reuse, fresh Edge/CDP startup, auth-state bootstrap, and recovery. Load local `references/edge-cdp-control.md` for SAC scripting-specific boundaries. Use CDP for local runtime triage, widget-state checks, and approved screenshots; do not touch unrelated tabs.

Getting Started

When the user invokes this skill with no specific task (e.g. "help with SAC scripting", "use SAC scripting skill", or no follow-up question), respond with this structured orientation:

> Welcome! I can help you with SAP Analytics Cloud scripting. > > First, which environment are you working in? > 1. **Analytics Designer** — application-based scripting, full API > 2. **Optimized Story Experience** — story-based scripting, OSE API (v2025.20) > > Then, what do you need help with? > - Write a new script (filter, planning, navigation, export...) > - Debug an existing script > - Optimize performance > - Find the right API method > - Planning operations (version management, data locking...)

Plugin Components

This plugin provides specialized tools for SAC development:

**Agents** (use via Task tool):

• `sac-script-debugger` - Debug script errors, trace issues
• `sac-performance-optimizer` - Analyze and fix performance bottlenecks
• `sac-planning-assistant` - Guide planning operations and version management
• `sac-api-helper` - Find correct APIs and provide code examples

**Commands** (use via /command):

• `/sac-script-template` - Generate script templates (filter, planning, export, etc.)
• `/sac-debug` - Interactive debugging guidance
• `/sac-optimize` - Performance analysis and recommendations
• `/sac-planning` - Planning operation templates

**Hooks**:

• Automatic validation on SAC script writes for common issues

MCP Setup

This plugin ships with a `.mcp.json` that connects to the trusted `secondsky/sap_analytics_cloud_mcp` server, exposing 90 SAC REST API tools across 11 service areas (Content, Data Export, Data Import, Multi Actions, Calendar, Content Transport, User Management, Monitoring, Schedule & Publication, Translation, Smart Query).

The SAC MCP is source-installed, not npm-installed. Use **sap-dependency-security** before changing the trusted fork or commit pin because this server receives SAC OAuth credentials and exposes tenant API tools.

**Before using MCP tools**, check if the server is already installed:

• Look for `.claude/sac-mcp.local.md` in the project
• Or check if `SAC_MCP_PATH` is set in the environment

If not installed, ask the user once: **"Would you like help setting up the SAC MCP server?"**

**If yes**, guide them through:

1. Clone and build:

   git clone https://github.com/secondsky/sap_analytics_cloud_mcp
   cd sap_analytics_cloud_mcp
   git checkout 2020235505d98111c2889598ab2217c1619b6943
   npm ci --ignore-scripts
   npm run build

2. Configure environment variables:

• `SAC_MCP_PATH` — absolute path to the cloned repo (e.g. `/home/user/sap_analytics_cloud_mcp`)
• `SAC_MCP_COMMIT` — `2020235505d98111c2889598ab2217c1619b6943`
• `SAC_BASE_URL` — SAC tenant root URL (e.g. `https://mytenant.eu10.hanacloudservices.cloud.sap`)
• `SAC_TOKEN_URL` — OAuth token endpoint
• `SAC_CLIENT_ID` / `SAC_CLIENT_SECRET` — from SAC OAuth client configuration

3. After successful install, write `.claude/sac-mcp.local.md` (gitignored) with:

   # SAC MCP Installation Record
   - Installed: [date]
   - Repository: https://github.com/secondsky/sap_analytics_cloud_mcp
   - Commit: 2020235505d98111c2889598ab2217c1619b6943
   - Path: [absolute path to build/index.js]
   - Build command: npm ci --ignore-scripts && npm run build
   - Env vars configured: SAC_MCP_PATH, SAC_MCP_COMMIT, SAC_BASE_URL, SAC_TOKEN_