Repository navigation
importing-your-data.mdx 只写了 API 那条路，没提 Console 列表视图上真实存在的导入向导——而向导正是靠该页三个映射工作的 #799
Description
Activity
[PM 认领 · R24] session_01VHrPAGEgFDoHjphqYG4BMa · 分支
claude/issue-799-import-wizard-path· 文件面:content/docs/guides/importing-your-data.mdx×3 + changeset裁定与边界(按 issue 自带建议执行):
- 开头加岔路口 + 一节简短界面路线:一句话说明列表视图上有导入向导(Upload / Mapping / Preview 三步、已保存映射会出现在向导里),链到
guides/import-and-export(PR docs(guides): import-and-export 按实测改写——导入向导在列表视图而非 Setup → Data，Salesforce 迁移标注未落地 (#763) #797 已写全向导步骤)——不把向导步骤在两页各写一遍(同一缺陷类：guides/import-and-export.mdx 声称随箱提供 Salesforce 迁移向导与「Setup → Data → Import Wizard」，两者都不存在 #763 教训,分工:import-and-export 讲界面与导出全景,本页讲 API 细节与已知限制)。 - API 路线保持现状(runAutomations:false、逐行错误码、undo 5000 行上限等界面上看不到的内容,价值不重复)。
- 实测为据:向导与三个 mapping(
crm_account_import等)的服务端同源关系(issue 已给链路:listImportMappings→meta.getItems('mapping')→ 按 targetObject 过滤),复核后按需引用;不新增能力断言。 ⚠️ 基线取最新 main;⛔ 不动import-and-export.mdx(docs(guides): import-and-export 按实测改写——导入向导在列表视图而非 Setup → Data，Salesforce 迁移标注未落地 (#763) #797 刚落);⛔ 不动src/**、releases/;不加守卫;三语同步。
⛔ 不升级 @objectstack/*;changeset 站内路径反引号(本单链接多,尤其注意);控制字节自扫;JSON 报告按标准 schema。
Generated by Claude Code
- 开头加岔路口 + 一节简短界面路线:一句话说明列表视图上有导入向导(Upload / Mapping / Preview 三步、已保存映射会出现在向导里),链到
[PM 验收] PR #888 ACCEPT — 已转 ready 并挂 auto-merge(session_01VHrPAGEgFDoHjphqYG4BMa)
复核结论:
- 前提逐项复核无漂移,向导存在性与服务端同源链路(
listImportMappings→meta.getItems('mapping')→ 按 targetObject 过滤)从 console 产物逐字复测——「已保存的映射会出现在向导里」这句用户可见承诺是测出来的,不是转述 issue。 - 同一缺陷类：guides/import-and-export.mdx 声称随箱提供 Salesforce 迁移向导与「Setup → Data → Import Wizard」，两者都不存在 #763 分工双向守住:新节 12 行纯指路,零操作细节(拖放/模板/置信度/写入模式/Match on 全部只在 import-and-export);API 侧独有内容(runAutomations、逐行错误码、两个上限)一字未动;
import-and-export.mdx三语零字节改动。这正是「两页各说各话」的反面教材写法。 - 岔路口的「各自适合谁」写得准:向导=一次性/先过目/免令牌,API=脚本化+严格试运行+撤销调用——差异化价值而非重复。
import-mappings守卫的「docs describe what ships」断言组在纯新增下全过——原文本零移动的旁证。- 报告交付时如实记录 Playwright/Analyze 未落定而非声称全绿——PM 侧已复核,现 8/8 绿(head 7967c6f)。文件面 4 个与申报一致。
无越界发现。
Generated by Claude Code
- 前提逐项复核无漂移,向导存在性与服务端同源链路(
- added a commit that references this issue
on Aug 10, 2026
发现于 #763 / PR #797（改写
guides/import-and-export.mdx时对账同目录的importing-your-data.mdx）。该页是本单的对账基准、被明确划在 PR #797 的文件面之外，故单独记录。实测
content/docs/guides/importing-your-data.mdx（zh-Hans / zh-Hant 同）从头到尾只有一条路：curl + JS SDK。:48起POST /api/v1/data/crm_account/import（dryRun）:92起POST /api/v1/data/crm_account/import/jobs:105轮询、:129undo:120"From the JavaScript SDK the same three calls are …"页面没有任何一处提到界面。但界面是存在的：
@objectstack/console的objectViewi18n 带import: "Import"/importTitle: "Import from CSV"，按钮打开plugin-grid懒加载导出的ImportWizard；Upload / Mapping / Preview，覆盖该页描述的全部动作：拖放 CSV/Excel（或从表格粘贴）、按表头自动匹配、Validate data（"Check every row against the server before importing." = 试运行）、大文件转后台作业并显示Importing {{processed}} of {{total}} rows、History 列出最近作业、Undo import（"Records it created will be deleted and records it updated will be restored to their previous values." = 该页 Step 4）。而且两者不是并列的两套东西，是同一条服务端通路的两端：向导通过
dataSource.listImportMappings(object)→client.meta.getItems('mapping')取元数据里的全部mapping项，再按targetObject等于当前对象过滤。也就是说该页:17-22那张表里的crm_account_import/crm_contact_import/crm_lead_import，会作为「已保存的映射」直接出现在 Accounts / Contacts / Leads 列表视图的导入向导里——选中后重命名、值转换与类型强制转换都在服务端跑，列映射转为只读。影响
这不是「写少了一点」。该页的定位是「评估 HotCRM 的人把自己的数据装进来」，而它给这个人的唯一指引是去写 curl —— 一个本可以在列表视图上点三下完成的动作。页面开头写的 "no column-by-column mapping"（无需逐列映射）恰恰是向导里 Saved mapping 那一栏的卖点，却只在 API 语境里出现。
建议
在该页加一节（或在开头给一个岔路口）：界面路线一句话带过并链到
guides/import-and-export（PR #797 已把向导的完整步骤写在那里，并已从该页三个方向链回来），API 路线保持现状——它讲的runAutomations: false、逐行错误码、undo 的 5,000 行上限等，都是界面上看不到的东西，价值不重复。三语同改。import-and-export讲界面与导出全景，importing-your-data讲 API 细节与已知限制，互相链接。关联
import-and-export，并保留了本页原有的回链（:225「Where to go next」）。