SuperAPI AI 工具集

archimate-modeling

通用与其它

查看项目

更新于 10-16 06:43

技能介绍

用途:通过 archicli 命令行工具对 ArchiMate 企业架构模型进行创建、修改、查询、校验与可视化,适合在 Archi 中批量维护模型、生成视图与导出图表的场景。

前置条件:运行 Archi(5.7+)并安装 jArchi 插件;打开含至少一个活动视图的 ArchiMate 模型;从 Scripts 菜单启动 Model API Server;默认地址为 http://127.0.0.1:8765,可用 ARCHI_BASE_URL 覆盖。

启动检查:先运行 archicli doctor、archicli health,以及 archicli model query --limit 20 --show-views --show-relationships。

核心流程:查询模型状态(model query、model search、model element、view list、view get、folder list);编写 BOM(JSON,含 version、description、changes,操作用 createElement 等);用 archicli verify <file> --semantic 校验;用 archicli batch apply <file> --layout 应用,自动生成 <file>.ids.json;用 archicli ids lookup 复用 ID;最后 archicli model save 保存。

执行规则:每次批量应用前先 verify --semantic;不要给 batch apply 传 --poll(默认已启用轮询);仅在自行用 ops status 管理操作 ID 时用 --no-poll;默认保持原子模式(chunk-size 1);创建或大幅编辑视图时用 --layout;--resolve-names 仅用于未解析的概念 ID,不能解析视觉 ID;空 BOM 需 --allow-empty;声明的 idFiles 默认强制校验,除非 --allow-incomplete-idfiles;--fast 仅在吞吐优先于连接交叉校验时使用。

BOM 编写:先创建概念(createElement、createRelationship、createFolder、createView),再丰富(updateElement、setProperty、moveToFolder),然后放置视觉对象(addToView、nestInView、addConnectionToView),最后细化视觉(moveViewObject、styleViewObject、createNote 等)。创建操作分配 tempId,保持稳定并跨文件复用;可用 idFiles 串联多个 BOM。注意 createElement 生成概念 ID,addToView 生成视觉 ID,addConnectionToView 消费视觉 ID。

视图与导出:archicli view create "Application Landscape" --viewpoint application_cooperation;archicli view layout <view-id> --rankdir LR;archicli view export <view-id> --format PNG --scale 2;archicli view export --all --dir ./exports。

错误恢复:archicli ops list、ops status <operation-id>;容错运行用 --continue-on-error,幂等重跑用 --skip-existing。

限制:需本地 Archi 与插件环境;--fast 会覆盖 chunk-size 为 20 并禁用连接交叉校验与提交节流;--resolve-names 无法重建缺失的视觉 ID。更多细节见 references/bom-reference.md 与 references/archimate-best-practices.md。