用途:通过 Omni CLI 的 v2 documents API 以编程方式创建、读取、修改和发布 Omni 文档、仪表板与应用,覆盖文档生命周期、草稿、工作簿模型、筛选器、控件和仪表板内容。
主要能力:文档创建与编辑走 v2 草稿→发布流程(v2-create、v2-get、v2-get-draft、v2-patch-draft、v2-publish-draft);文档状态由 queryPresentations、controls、containers、settings 四部分组成。瓦片存于 queryPresentations.data,键必须为数字字符串;控件 id 可为任意字符串;布局由 containers 树决定,瓦片仅在容器引用处渲染。补丁按键合并,仅 containers 与 order 数组为整体替换;删除瓦片需将键设为 null 并从 order 移除。
使用方式:先确认已安装 Omni CLI 并支持 v2 命令,用 omni config show / use 选择配置,omni whoami whoami 确认认证。创建用 documents v2-create,编辑用 v2-patch-draft,发布用 v2-publish-draft,放弃草稿用 documents discard-draft。部分管理操作(list、delete、move、duplicate、下载等)无 v2 形式,使用对应命令。
限制:瓦片查询不要携带 modelId;每个查询至少包含一个度量;query.filters 需用对象形式;工作簿模型 ID 每次草稿与发布都会变化,不可缓存;非主题瓦片对 Viewer 与 Restricted Querier 不可见,需显式确认后才可考虑 Access Boost;补丁校验失败最多修正重试一次。资料未提供具体收费、价格与平台信息。