Skip to content

forcedotcom/sf-skills / skills/tableau-next-asset-create

tableau-next-asset-create

Verified

Build and edit Tableau Next semantic models (SDMs), vizzes, and dashboards via MCP. TRIGGER when: building a semantic model or dashboard from CSV/Excel files; ingesting a flat file/database into DLO/DMO; profiling a dataset (grain, measures, dimensions; large/wide files via `infer_object_schema`); adding a dimension, measure, AI-ready metric, join, or logical view; running a semantic query, interpreting a breakdown, analyzing account/customer engagement, or pulling counts/totals from existing Tableau Next data (even unnamed/read-only); creating/editing a viz (filter, forecast, sort, shelf, mark encoding, reference line), widget, or dashboard layout. Also: Data Cloud SQL transforms; show a dashboard; share/revoke access; reuse prod or promote Personal Org assets; provision users/licenses; data alerts ('alert me when'); list/classify verified questions or score agent SQL. DO NOT TRIGGER for: rewriting prose descriptions, layout-only dashboard review, debugging MCP, or writing app code.

FileKindSize
SKILL.mdskill md23.9 KB
references/admin-users.mdmarkdown5.9 KB
references/ai-readiness.mdmarkdown17.5 KB
references/alerts.mdmarkdown3.9 KB
references/build-workflow.mdmarkdown41.4 KB
references/dashboard-authoring.mdmarkdown15.5 KB
references/dashboard-design-principles.mdmarkdown18.6 KB
references/data-transform-gotchas.mdmarkdown9.5 KB
references/data-understanding.mdmarkdown26.8 KB
references/deep-reference-index.mdmarkdown4.8 KB
references/destructive-operations.mdmarkdown3.9 KB
references/edit-dashboard.mdmarkdown19.8 KB
references/edit-visualization.mdmarkdown41.5 KB
references/empty-source-handling.mdmarkdown4.9 KB
references/ingest-and-metric-gotchas.mdmarkdown35.4 KB
references/insight-bundle.mdmarkdown2.7 KB
references/large-flat-file-handling.mdmarkdown19.1 KB
references/schemas/edit-dashboard/_envelope.jsonconfig3.1 KB
references/schemas/edit-dashboard/_shared-widget-fields.jsonconfig7.0 KB
references/schemas/edit-dashboard/add_page.jsonconfig1.1 KB
references/schemas/edit-dashboard/delete_page.jsonconfig947 B
references/schemas/edit-dashboard/discard_dashboard.jsonconfig482 B
references/schemas/edit-dashboard/move_widget.jsonconfig1.4 KB
references/schemas/edit-dashboard/move_widget_to_page.jsonconfig1.4 KB
references/schemas/edit-dashboard/place_widget_on_page.jsonconfig1.4 KB
references/schemas/edit-dashboard/remove_widget_from_dashboard.jsonconfig864 B
references/schemas/edit-dashboard/remove_widget_from_page.jsonconfig1.1 KB
references/schemas/edit-dashboard/rename_page.jsonconfig1.0 KB
references/schemas/edit-dashboard/save_dashboard.jsonconfig775 B
references/schemas/edit-dashboard/undo.jsonconfig421 B
references/schemas/edit-dashboard/upsert_button_widget.jsonconfig3.3 KB
references/schemas/edit-dashboard/upsert_container_widget.jsonconfig4.2 KB
references/schemas/edit-dashboard/upsert_filter_widget.jsonconfig8.8 KB
references/schemas/edit-dashboard/upsert_metric_widget.jsonconfig3.8 KB
references/schemas/edit-dashboard/upsert_navigation_widget.jsonconfig4.4 KB
references/schemas/edit-dashboard/upsert_parameter_widget.jsonconfig9.9 KB
references/schemas/edit-dashboard/upsert_text_widget.jsonconfig5.5 KB
references/schemas/edit-dashboard/upsert_visualization_widget.jsonconfig3.4 KB
references/sdm-tool-reference.mdmarkdown33.1 KB
references/semantic-query-and-enrichment.mdmarkdown16.3 KB
references/shared-gates.mdmarkdown17.6 KB
references/sharing-and-promotion.mdmarkdown14.4 KB
references/tasks/ai-readiness-audit.mdmarkdown3.0 KB
references/tasks/analyze-data.mdmarkdown2.5 KB
references/tasks/build-dashboard.mdmarkdown3.7 KB
references/tasks/build-end-to-end.mdmarkdown4.4 KB
references/tasks/create-data-transform.mdmarkdown2.8 KB
references/tasks/create-viz.mdmarkdown3.6 KB
references/tasks/edit-dashboard.mdmarkdown5.0 KB
references/tasks/edit-sdm.mdmarkdown6.5 KB
references/tasks/edit-viz.mdmarkdown2.4 KB
references/tasks/enrich-model.mdmarkdown4.0 KB
references/tasks/ingest-flat-file.mdmarkdown3.9 KB
references/tasks/manage-alert.mdmarkdown1.6 KB
references/tasks/profile-dataset.mdmarkdown2.7 KB
references/tasks/promote-or-reuse.mdmarkdown2.3 KB
references/tasks/provision-user.mdmarkdown1.8 KB
references/tasks/query-model.mdmarkdown5.3 KB
references/tasks/review-verified-questions.mdmarkdown1.9 KB
references/tasks/share-asset.mdmarkdown1.8 KB
references/verified-questions.mdmarkdown4.6 KB
references/viz-authoring.mdmarkdown41.3 KB

references/tasks/ingest-flat-file.md

View on GitHub
# Task: Ingest a file or existing connection → DLO → DMO

Ingest local CSV/Excel **or** a table from an existing Data Cloud connection
into Data Lake Objects and Data Model Objects — the front half that the SDM
build assumes already exists. Entry point 1. (Entry point 3 — probing a
large/cryptic file *before* ingesting — is diagnostic and lives in
`profile-dataset.md` / `../large-flat-file-handling.md`; this guide's G6 bullet
below just points there.)

## Gates (assert before any tool call) → `../shared-gates.md`

Required: **G1, G2, G5-light** · Conditional: **G6** (◐, for a large/cryptic file)

- **G1** (router-asserted): a `mcp__tableau-next-*__` tool must be connected.
- **Tool names are written bare** — invoke each under your client's name for that `tableau-next-*` server tool (`shared-gates.md`).
- **G6** (◐): if the file is large/wide/cryptic, use `infer_object_schema`
  FIRST, decode the column-naming grammar, then verify one known number with
  `run_query` after ingest (`../large-flat-file-handling.md`). Do not slurp the
  whole file into context or add a local parsing step.
- **G2 (post-ingest):** `run_data_stream` is mandatory; then wait until the DLO
  is Active and the DMO is Ready. Mapping **query** readiness is `run_query`
  against `<dmo>__dlm` (`42P01` keep polling; `COUNT = 0` is READY).
  `get_dlo_to_dmo_mapping_status` `ACTIVE` is metadata only — not that gate
  (`shared-gates.md` G2). For a self-created mapped DMO, do not refuse SDM
  create because `COUNT = 0`; do not proceed while the table is missing.
- **G5-light:** file-upload DLOs **and** DMOs require `category: "Other"` (never
  `"Engagement"`); DLO→DMO mapping field dev names carry a literal `__c` on both
  sides — copy them from the materialized table, not from `get_data_stream`.
  Full AI-readiness metadata lands later when objects/fields are added.
- **Schema confirmation:** after `infer_object_schema`, present the fields and
  **wait for the user to explicitly confirm** or adjust types / primary key /
  skipped columns. Do not call `create_data_stream` until they approve or say
  to proceed.

## Steps

The fixed, ordered ingestion chain with verified payloads is in
**`../ingest-and-metric-gotchas.md`**:

**File CSV / Excel — §A:**
`get_upload_connection` → `generate_presigned_credential` (per file; PUT with
decoded URL + optional `headers`; opaque `parentDirectory` /
`importDirectory`; re-call if `expiryTime` passed) → Excel: `list_data_connection_objects` for sheets →
`infer_object_schema` → **confirm schema** → `create_data_stream` (`*__dll`
DLO, including `mappings` / `refreshConfig` / `advancedAttributes`) →
**`run_data_stream` + wait until Active** → SCHEMA REALITY CHECK
(materialized DLO, not `get_data_stream`) + real Primary Key read-back →
`create_data_model_object` (unsuffixed name — `Orders`, not
`Orders__dlm`; the platform adds `__dlm`) → **wait until Ready** →
`create_dlo_to_dmo_mapping` → inspect mapping
(`get_dlo_to_dmo_mapping_status` for `ERROR`) → **poll `run_query` until
`<dmo>__dlm` exists** (`COUNT = 0` is READY).

**Existing database / lakehouse connection — §C:**
`list_connections` (exact `connectorType` casing) → optional
`test_existing_connection` (once; `9cg` id) → `list_data_connection_objects`
→ `infer_object_schema` (table `resourceName`; uppercase `SCHEMA`/`DATABASE`)
→ **confirm schema** → `create_data_stream` with `dataAccessMode:
"Direct_Access"` and the connection **developer name** → `run_data_stream`
`interactive: false` → then the same SCHEMA REALITY CHECK → DMO → mapping
tail as §A.

After `run_query` succeeds on the `__dlm` table, continue with `edit-sdm.md`
(build the model) or `build-end-to-end.md` Step 4. `COUNT = 0` on that
successful query is READY for these self-created DMOs (G2); `42P01` is not.
Ingestion gotchas (status waits, SCHEMA REALITY CHECK, `category:"Other"`,
universal-`__c`, stream payload traps) are in
`../ingest-and-metric-gotchas.md` §A / §C.
deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall