SuperAPI AI 工具集

migrate-tableau-workbook

通用与其它

查看项目

更新于 10-15 21:51

技能介绍

用途:把 Tableau 工作簿、仪表板、工作表、报告和视图按用户意图导入或迁移为 nao 图表或故事,同时保留分析含义与数值,对不支持的布局与样式做显式近似说明。

主要能力:以 nao CLI 作为 Tableau 内容的唯一来源,负责认证、工作簿发现、下载、工作表 CSV 导出与图像导出;使用 nao MCP 创建图表或故事。单个工作表或视图生成一个图表;仪表板、工作簿、报告或需保留布局的一组工作表生成一个故事。可用 nao migrate tableau 命令导出迁移元数据与资产:nao migrate tableau "<workbook-name>" --output "<temporary-migration-json-path>",必要时加 --project 或 --dashboard。

用法要点:迁移前须已为 Tableau 配置访问;未配置时停止并提示用户在项目根目录运行 nao migrate tableau configure。应读取生成的 JSON(要求 version 为 1、success 为 true),依据 workbook.dashboards、worksheet_visualizations、interactions.controls、worksheet_mappings 和 worksheet_assets 构建,不得凭名称猜测。需读取每个工作表的 image_path 做视觉预检,并以导出的 CSV 校验数据库查询;每条 SQL 输出列应使用小写下划线别名。仪表板控件仅在可验证其数据库表达式与 Tableau 行为时迁移,分类控件用 type="multi_select"。

适用场景:将已发布到 Tableau Cloud 或 Tableau Server 的工作簿迁移到 nao,按仪表板或工作表组织为故事标签页。

限制:本地 .twb/.twbx 文件无法提供所需的渲染 CSV 与图像资产,需先发布到 Tableau Cloud 或 Server;不要读取、打印或索要 Tableau 凭据或 nao_config.yaml 内容。migrate-tableau-workbook 的工作簿包含仪表板时按解析器返回的成员关系组织标签页,未成功导出的工作表应跳过并报告错误,不得用无关数据替代。display_chart 目前不接受 tooltip_label_key 或 tooltip_keys 输入,Tableau 的 Detail、Color 和工具提示字段可保留在查询输出中,但无法在散点图工具提示中展示。计算字段、上下文过滤器、LOD 表达式、集、组、分箱、标记和格式等,在缺少更丰富解析器时不应声称已从 XML 复现;参数仅在其定义、允许值、目标工作表和查询行为均保留时才可说已复现。其余未能验证的部分应列为不支持或近似。官方资料未提供收费、价格、平台支持或具体效果信息。