Как пользоваться разделом «Диаграмма проекта»
Строит view из модели, настраивает viewpoint/layout/filter и сохраняет изменения в source, а не только картинке.
О чём этот раздел
Строит view из модели, настраивает viewpoint/layout/filter и сохраняет изменения в source, а не только картинке.
Перед началом
Нужны доступ к IAM.Solution / AGL, правильный tenant/workspace и право изменять эту конфигурацию. Подготовьте безопасное тестовое значение, например system-context-demo.
Кнопки и формы
| Элемент | За что отвечает |
|---|---|
| Viewpoint | Выполняет указанное в интерфейсе действие. Перед продолжением проверьте новый статус или сообщение. |
| Layout | Выполняет указанное в интерфейсе действие. Перед продолжением проверьте новый статус или сообщение. |
| Фильтры | Сужает видимый список и не изменяет серверные объекты. |
| Автораскладка | Выполняет указанное в интерфейсе действие. Перед продолжением проверьте новый статус или сообщение. |
| Сохранить | Проверяет видимую форму и сохраняет текущие значения. |
| Экспорт | Скачивает текущую выборку; активные фильтры обычно влияют на экспорт. |
Основной путь через интерфейс
- Откройте приложение по ссылке выше и войдите с минимально необходимой для раздела ролью.
- Выберите нужный tenant или workspace. Не продолжайте, если в шапке отображается другой контур.
- В навигации нажмите Диаграмма проекта. Ожидаемый адрес: https://app.iamsolution.ru/projects/project-id/visual.
- Нажмите Сохранить. Введите документированные безопасные значения:
system-context-demo. Production-секрет в текстовое поле не вставляйте. - Перед финальным действием Сохранить, Запустить, Опубликовать или Подтвердить перепроверьте все поля. Если есть preview или validation, сначала выполните его.
- Проверьте сообщение валидации или изменившуюся строку. Результат должен соответствовать назначению раздела: Строит view из модели, настраивает viewpoint/layout/filter и сохраняет изменения в source, а не только картинке.
- Только после этого переходите к зависимому разделу. Сохраните request/correlation ID, если интерфейс его показывает.
Второй путь: прямая ссылка и CLI/API
- Откройте прямую ссылку https://app.iamsolution.ru/projects/project-id/visual вместо перехода через sidebar.
- После загрузки ещё раз проверьте tenant/workspace: прямая ссылка не должна незаметно менять scope.
- Перед автоматизацией API-пути выполните продуктовую read-only команду или проверку. Она подтверждает доступность, но не обходит права приложения:
agl --help
agl validate ./architecture.agl
agl render ./architecture.agl --format svg --output ./out/architecture.svg
Как проверить результат
Повторный render из version даёт эквивалентную структуру и стабильные element IDs.
Если не получилось
| Симптом | Что делать |
|---|---|
| 401 / экран входа | Войдите заново и вернитесь на страницу. Не передавайте session token через URL. |
| 403 | Проверьте выбранный tenant и запросите указанную роль; повтор с той же ролью не поможет. |
| 404 | Проверьте точный path и включён ли функционал в этом окружении. |
| 409 | Найдите объект с именем system-context-demo; продолжите с ним либо выберите уникальное имя. |
| 422 / ошибка валидации | Исправьте только подсвеченные поля. Используйте lowercase identifiers, если форма явно не разрешает иное. |
| 429 | Дождитесь указанного retry interval либо уменьшите scope запроса; не запускайте параллельные повторы. |
| 5xx / timeout | После восстановления сервера обновите страницу один раз; не повторяйте опасное действие, пока его результат неизвестен. Сохраните correlation ID и время для поддержки. |