create_view
Create an ArchiMate view (diagram) in the active model. Provide a name, and optionally set the viewpoint, folder path, or view ID.
Instructions
Create a new ArchiMate view (diagram) in the active model.
Views are containers for visual nodes and connections. Add nodes
with `add_node_to_view` and connections with
`add_connection_to_view` once both endpoint elements are visible.
Set a `viewpoint` so the view opens with the right Archi viewpoint
(e.g. `layered` for mixed-layer overviews, `capability` for
capability maps, `service_realization` for service views).
Args:
name: View name. Must be a non-empty string.
view_id: Optional stable view ID. When omitted a UUID is
generated.
folder_path: Optional folder path. The `Views` root is
normalized: `Views`, `/Views`, and `views` resolve to
`/Views`.
viewpoint: Optional viewpoint: any canonical Archi viewpoint id
(e.g. `layered`, `application_cooperation`) or pyArchimate
slug. Invalid values fail with the accepted catalogs in
`error.details`.
Returns:
Success envelope with `data` shaped like a `ViewDetail`:
`{id, name, nodes: [], connections: []}`.
Errors:
`INVALID_VIEW_NAME` when `name` is missing or blank.
`ModelNotFoundError` if no model is active.
`ModelOperationError` for a duplicate `view_id` or invalid
folder path.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| view_id | No | ||
| viewpoint | No | ||
| properties | No | ||
| description | No | ||
| folder_path | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||