@seafteam/seaf-archtool-core-plugin-suite 2026.30.0 → 2026.32.0-rc.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/documentation/docs/manual/backend/api.yaml +240 -41
- package/documentation/docs/manual/docs/docs.md +1 -0
- package/documentation/docs/manual/docs/drawio_intro.md +29 -8
- package/documentation/docs/manual/docs/editable_table/step_0_base/table.yaml +11 -3
- package/documentation/docs/manual/docs/editable_table/step_0_base/template.md +11 -2
- package/documentation/docs/manual/docs/editable_table/step_3_headers/template.md +33 -0
- package/documentation/docs/manual/docs/examples/wizard.yaml +18 -0
- package/documentation/docs/manual/docs/gigachat/agents/aigena/menu.yaml +1 -1
- package/documentation/docs/manual/docs/gigachat/agents/root.yaml +0 -1
- package/documentation/docs/manual/docs/gigachat/agents/template.md +0 -5
- package/documentation/docs/manual/docs/gigachat/template.md +1 -1
- package/documentation/docs/manual/docs/markaper.md +6 -0
- package/documentation/docs/manual/docs/root.yaml +12 -0
- package/documentation/docs/manual/docs/seaf2drawio/examples/diff.yaml +0 -96
- package/documentation/docs/manual/docs/seaf2drawio/seaf2drawio.md +129 -7
- package/documentation/docs/manual/docs/wizard.md +34 -0
- package/documentation/docs/manual/plugins/introduction.md +53 -8
- package/documentation/docs/manual/root-cluster-import.md +117 -0
- package/package.json +1 -1
- package/plugin.html +4 -1953
- package/documentation/docs/manual/docs/gigachat/agents/react/gigachat.yaml +0 -59
- package/documentation/docs/manual/docs/gigachat/agents/react/menu.yaml +0 -5
- package/documentation/docs/manual/docs/gigachat/agents/react/root.yaml +0 -3
- package/documentation/docs/manual/docs/gigachat/agents/react/template.md +0 -138
|
@@ -66,6 +66,55 @@ tags:
|
|
|
66
66
|
- name: HealthInfo
|
|
67
67
|
description: "API для получения расширенной служебной информации о состоянии портала. ⚠️ Данный метод доступен только при работе SEAF.ArchTool в кластерном режиме."
|
|
68
68
|
paths:
|
|
69
|
+
/seaf-core/api/core/storage/jsonata/{query}:
|
|
70
|
+
get:
|
|
71
|
+
tags:
|
|
72
|
+
- DataLake
|
|
73
|
+
summary: Выполняет произвольный запрос JSONata к данным архитектуры
|
|
74
|
+
description: >
|
|
75
|
+
Устаревший GET-контракт (до ERA-2872). Сохранён для обратной совместимости.
|
|
76
|
+
Предпочтительный способ — POST /seaf-core/api/core/storage/jsonata.
|
|
77
|
+
parameters:
|
|
78
|
+
- in: path
|
|
79
|
+
name: query
|
|
80
|
+
description: JSONata запрос в скобках "([запрос])" или идентификатор DataSet без скобок
|
|
81
|
+
required: true
|
|
82
|
+
schema:
|
|
83
|
+
$ref: '#/components/schemas/JSONataQuery'
|
|
84
|
+
example: >
|
|
85
|
+
({"id": $params.id, "limit": $params.limit, "type": $self.type, "template": $self.template})
|
|
86
|
+
- in: query
|
|
87
|
+
name: params
|
|
88
|
+
description: >
|
|
89
|
+
JSON структура с параметрами передающаяся в запрос.
|
|
90
|
+
Будет доступна в переменной $params.
|
|
91
|
+
required: false
|
|
92
|
+
schema:
|
|
93
|
+
type: string
|
|
94
|
+
example: '{"id":"sber.rdwsoft","limit":8}'
|
|
95
|
+
- in: query
|
|
96
|
+
name: subject
|
|
97
|
+
description: >
|
|
98
|
+
JSON структура с профилем объекта, который выполняет запрос.
|
|
99
|
+
Будет доступна в переменной $self.
|
|
100
|
+
required: false
|
|
101
|
+
schema:
|
|
102
|
+
type: string
|
|
103
|
+
example: '{"type":"markdown","template":"template.md"}'
|
|
104
|
+
- in: query
|
|
105
|
+
name: envelope
|
|
106
|
+
description: Если "true", ответ упаковывается в envelope-формат
|
|
107
|
+
required: false
|
|
108
|
+
schema:
|
|
109
|
+
type: string
|
|
110
|
+
enum: ["true", "false"]
|
|
111
|
+
responses:
|
|
112
|
+
"200":
|
|
113
|
+
description: "Результат выполнения запроса"
|
|
114
|
+
content:
|
|
115
|
+
application/json:
|
|
116
|
+
schema:
|
|
117
|
+
$ref: '#/components/schemas/JSONataResult'
|
|
69
118
|
/seaf-core/api/core/storage/jsonata:
|
|
70
119
|
post:
|
|
71
120
|
tags:
|
|
@@ -95,22 +144,75 @@ paths:
|
|
|
95
144
|
schema:
|
|
96
145
|
$ref: '#/components/schemas/JSONataResult'
|
|
97
146
|
/seaf-core/api/core/storage/reload:
|
|
147
|
+
put:
|
|
148
|
+
tags:
|
|
149
|
+
- DataLake
|
|
150
|
+
summary: Перезагрузка манифеста (режим backend)
|
|
151
|
+
description: |
|
|
152
|
+
Перезагружает манифест в режиме backend. Дополнительные параметры не нужны и не учитываются в обработке, необходимо передать только secret.
|
|
153
|
+
|
|
154
|
+
В случае возникновения ошибки, можно поискать в логах по значению 'trace-id-123' из ответа с ошибкой
|
|
155
|
+
operationId: reloadBackendStorage
|
|
156
|
+
parameters:
|
|
157
|
+
- name: secret
|
|
158
|
+
in: query
|
|
159
|
+
description: secret для доступа к запросу. Указывается в .env переменной VUE_APP_DOCHUB_RELOAD_SECRET
|
|
160
|
+
required: true
|
|
161
|
+
schema:
|
|
162
|
+
type: string
|
|
163
|
+
example: "your-reload-secret-key"
|
|
164
|
+
|
|
165
|
+
responses:
|
|
166
|
+
'200':
|
|
167
|
+
description: Запрос успешно обработан
|
|
168
|
+
content:
|
|
169
|
+
application/json:
|
|
170
|
+
schema:
|
|
171
|
+
type: object
|
|
172
|
+
properties:
|
|
173
|
+
message:
|
|
174
|
+
type: string
|
|
175
|
+
example: "success"
|
|
176
|
+
example: {
|
|
177
|
+
"message": "success"
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
'400':
|
|
181
|
+
description: Ошибка при перезагрузке манифеста
|
|
182
|
+
content:
|
|
183
|
+
application/json:
|
|
184
|
+
schema:
|
|
185
|
+
type: object
|
|
186
|
+
properties:
|
|
187
|
+
error:
|
|
188
|
+
type: string
|
|
189
|
+
example: "trace-id-123: Error when reload"
|
|
190
|
+
|
|
191
|
+
'403':
|
|
192
|
+
description: Неверный секретный ключ
|
|
193
|
+
content:
|
|
194
|
+
application/json:
|
|
195
|
+
schema:
|
|
196
|
+
type: object
|
|
197
|
+
properties:
|
|
198
|
+
error:
|
|
199
|
+
type: string
|
|
200
|
+
example: "trace-id-123: Error reload secret is not valid [wrong-secret]"
|
|
201
|
+
|
|
202
|
+
/seaf-core/internal/core/storage/reload:
|
|
98
203
|
put:
|
|
99
204
|
tags:
|
|
100
205
|
- DataLake
|
|
101
206
|
summary: Перезагрузка манифестов в кластере
|
|
102
207
|
description: |
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
-
|
|
108
|
-
- перезагружать выбранные манифесты
|
|
109
|
-
- перезагружать все манифесты
|
|
110
|
-
- обнаруживать ссылки на новые манифесты в root манифесте
|
|
208
|
+
Внутренний context path для вызовов сервисами (не пользователями). Работает только в режиме cluster.
|
|
209
|
+
Умеет:
|
|
210
|
+
- перезагружать выбранные манифесты
|
|
211
|
+
- перезагружать все манифесты
|
|
212
|
+
- обнаруживать ссылки на новые манифесты в root манифесте
|
|
111
213
|
Перезагружает указанные манифесты или все манифесты в кластере.
|
|
112
214
|
Может использоваться для принудительного обновления кэша.
|
|
113
|
-
|
|
215
|
+
|
|
114
216
|
В случае возникновения ошибки, можно поискать в логах по значению 'trace-id-123' из ответа с ошибкой
|
|
115
217
|
operationId: reloadClusterStorage
|
|
116
218
|
parameters:
|
|
@@ -125,7 +227,7 @@ paths:
|
|
|
125
227
|
- name: reloadRoot
|
|
126
228
|
in: query
|
|
127
229
|
description: |
|
|
128
|
-
Если true - запускает перезагрузку манифестов для подтягивания изменений из root манифеста.
|
|
230
|
+
Если true - запускает перезагрузку манифестов для подтягивания изменений из root манифеста.
|
|
129
231
|
Перезагрузка может запуститься если ранее она уже была запрошена (другим запросом) и не успела обработаться
|
|
130
232
|
При этом параметры alias и mode игнорируются если переданы.
|
|
131
233
|
schema:
|
|
@@ -150,16 +252,16 @@ paths:
|
|
|
150
252
|
in: query
|
|
151
253
|
description: |
|
|
152
254
|
Имена манифестов для перезагрузки.
|
|
153
|
-
|
|
255
|
+
|
|
154
256
|
**Формат передачи:**
|
|
155
257
|
- Для одного значения: `?alias=manifest1`
|
|
156
258
|
- Для нескольких значений: `?alias=manifest1&alias=manifest2&alias=manifest3`
|
|
157
|
-
|
|
259
|
+
|
|
158
260
|
Если параметр не указан - перезагружаются все доступные манифесты.
|
|
159
|
-
|
|
261
|
+
|
|
160
262
|
**Важно:** При `mode=permission` этот параметр содержит имена разрешений,
|
|
161
263
|
а не имена манифестов.
|
|
162
|
-
|
|
264
|
+
|
|
163
265
|
**Формат при `mode=permission` не отличается, но в alias ожидаются значения permission :**
|
|
164
266
|
- Для одного значения: `?alias=permission1`
|
|
165
267
|
- Для нескольких значений: `?alias=permission1&alias=permission2&alias=permission3`
|
|
@@ -187,9 +289,7 @@ paths:
|
|
|
187
289
|
}
|
|
188
290
|
|
|
189
291
|
'400':
|
|
190
|
-
description:
|
|
191
|
-
Неверные параметры запроса
|
|
192
|
-
В режиме backend если что-то пошло не так, тоже возвращается 400
|
|
292
|
+
description: Неверные параметры запроса
|
|
193
293
|
content:
|
|
194
294
|
application/json:
|
|
195
295
|
schema:
|
|
@@ -471,6 +571,114 @@ paths:
|
|
|
471
571
|
title:
|
|
472
572
|
type: string
|
|
473
573
|
example: ООО "Березка"
|
|
574
|
+
/seaf-core/api/core/about-alias:
|
|
575
|
+
get:
|
|
576
|
+
tags:
|
|
577
|
+
- DataLake
|
|
578
|
+
summary: Получение импорта по alias (недоступно в режиме backend)
|
|
579
|
+
description: |
|
|
580
|
+
Концепция about-alias актуальна только для кластера, поэтому в режиме backend запрос всегда возвращает ошибку.
|
|
581
|
+
Действующая реализация доступна только в режиме cluster по адресу /seaf-core/internal/core/about-alias.
|
|
582
|
+
operationId: aboutAliasBackend
|
|
583
|
+
responses:
|
|
584
|
+
"500":
|
|
585
|
+
description: Запрос недоступен в режиме backend
|
|
586
|
+
content:
|
|
587
|
+
application/json:
|
|
588
|
+
schema:
|
|
589
|
+
type: object
|
|
590
|
+
properties:
|
|
591
|
+
error:
|
|
592
|
+
type: string
|
|
593
|
+
example: "in backend mode url 'about-alias' not allow"
|
|
594
|
+
/seaf-core/internal/core/about-alias:
|
|
595
|
+
get:
|
|
596
|
+
tags:
|
|
597
|
+
- DataLake
|
|
598
|
+
summary: Получение импорта из root-манифеста по alias
|
|
599
|
+
description: |
|
|
600
|
+
Внутренний context path для вызовов сервисами (не пользователями). Работает только в режиме cluster.
|
|
601
|
+
Возвращает объект импорта из root-манифеста по его alias, если у вызывающего в JWT есть право (permission),
|
|
602
|
+
совпадающее с permission этого импорта.
|
|
603
|
+
operationId: aboutAliasCluster
|
|
604
|
+
security:
|
|
605
|
+
- idpAuth: []
|
|
606
|
+
parameters:
|
|
607
|
+
- name: alias
|
|
608
|
+
in: query
|
|
609
|
+
description: Alias импорта из root-манифеста, для которого нужно получить данные
|
|
610
|
+
required: true
|
|
611
|
+
schema:
|
|
612
|
+
type: string
|
|
613
|
+
example: "berezka"
|
|
614
|
+
responses:
|
|
615
|
+
"200":
|
|
616
|
+
description: |
|
|
617
|
+
Данные импорта возвращаются как есть из root-манифеста, поэтому набор полей зависит от конкретного манифеста.
|
|
618
|
+
Обязательные по схеме валидации root-манифеста поля - root, permission, alias.
|
|
619
|
+
content:
|
|
620
|
+
application/json:
|
|
621
|
+
schema:
|
|
622
|
+
type: object
|
|
623
|
+
required:
|
|
624
|
+
- root
|
|
625
|
+
- permission
|
|
626
|
+
- alias
|
|
627
|
+
properties:
|
|
628
|
+
root:
|
|
629
|
+
type: string
|
|
630
|
+
description: Путь/URI до root-манифеста домена
|
|
631
|
+
permission:
|
|
632
|
+
type: string
|
|
633
|
+
description: Право доступа, ассоциированное с импортом (приводится к нижнему регистру при загрузке)
|
|
634
|
+
example: "berezka:permission"
|
|
635
|
+
alias:
|
|
636
|
+
type: string
|
|
637
|
+
description: Alias манифеста
|
|
638
|
+
example: "berezka"
|
|
639
|
+
title:
|
|
640
|
+
type: string
|
|
641
|
+
description: Отображаемое имя (опционально)
|
|
642
|
+
example: "ООО \"Березка\""
|
|
643
|
+
repos:
|
|
644
|
+
type: array
|
|
645
|
+
description: Список репозиториев (опционально)
|
|
646
|
+
items:
|
|
647
|
+
type: object
|
|
648
|
+
required:
|
|
649
|
+
- type
|
|
650
|
+
- url
|
|
651
|
+
properties:
|
|
652
|
+
type:
|
|
653
|
+
type: string
|
|
654
|
+
url:
|
|
655
|
+
type: string
|
|
656
|
+
warmupNeeded:
|
|
657
|
+
type: boolean
|
|
658
|
+
description: Признак необходимости прогрева датасета/меню при загрузке манифеста
|
|
659
|
+
default: false
|
|
660
|
+
additionalProperties: true
|
|
661
|
+
"400":
|
|
662
|
+
description: |
|
|
663
|
+
Параметр alias не передан, либо импорт по alias не найден, либо у вызывающего нет права на этот импорт
|
|
664
|
+
content:
|
|
665
|
+
application/json:
|
|
666
|
+
schema:
|
|
667
|
+
type: object
|
|
668
|
+
properties:
|
|
669
|
+
error:
|
|
670
|
+
type: string
|
|
671
|
+
example: "data by alias not found or not permitted (np)"
|
|
672
|
+
"500":
|
|
673
|
+
description: Внутренняя ошибка сервера при обработке запроса
|
|
674
|
+
content:
|
|
675
|
+
application/json:
|
|
676
|
+
schema:
|
|
677
|
+
type: object
|
|
678
|
+
properties:
|
|
679
|
+
error:
|
|
680
|
+
type: string
|
|
681
|
+
example: "error when process request"
|
|
474
682
|
/health/info:
|
|
475
683
|
get:
|
|
476
684
|
tags:
|
|
@@ -630,28 +838,19 @@ components:
|
|
|
630
838
|
type: array
|
|
631
839
|
title: Вход на портал
|
|
632
840
|
items:
|
|
633
|
-
|
|
634
|
-
|
|
635
|
-
|
|
636
|
-
|
|
637
|
-
|
|
638
|
-
|
|
639
|
-
|
|
640
|
-
|
|
641
|
-
|
|
642
|
-
- type: object
|
|
643
|
-
properties:
|
|
644
|
-
incoming:
|
|
645
|
-
type: string
|
|
646
|
-
outgoing:
|
|
647
|
-
type: string
|
|
648
|
-
required:
|
|
649
|
-
- incoming
|
|
650
|
-
- outgoing
|
|
841
|
+
type: object
|
|
842
|
+
properties:
|
|
843
|
+
incoming:
|
|
844
|
+
type: string
|
|
845
|
+
outgoing:
|
|
846
|
+
type: string
|
|
847
|
+
required:
|
|
848
|
+
- incoming
|
|
849
|
+
- outgoing
|
|
651
850
|
sequenceFlow:
|
|
652
851
|
type: array
|
|
653
852
|
items:
|
|
654
|
-
|
|
853
|
+
type: string
|
|
655
854
|
exclusiveGateway:
|
|
656
855
|
type: object
|
|
657
856
|
title: Информация о существующей архитектуре
|
|
@@ -677,8 +876,8 @@ components:
|
|
|
677
876
|
description: Сообщение об ошибке формирования logout URL
|
|
678
877
|
example: '2025-06-05T05:58:26.604Z: [ERROR] Unknown OIDC issuer "https://iss.example". No logout configuration found'
|
|
679
878
|
nullable: true
|
|
680
|
-
|
|
681
|
-
|
|
682
|
-
|
|
683
|
-
|
|
684
|
-
|
|
879
|
+
securitySchemes:
|
|
880
|
+
idpAuth:
|
|
881
|
+
type: http
|
|
882
|
+
scheme: bearer
|
|
883
|
+
bearerFormat: JWT
|
|
@@ -14,6 +14,7 @@
|
|
|
14
14
|
* **[Диаграммы](/docs/archtool.charts)** - включает разные типы графиков для наглядного сравнения и анализа данных.
|
|
15
15
|
* **[Markdown](/docs/archtool.markdown)** - облегчённый язык разметки, созданный с целью обозначения форматирования в простом тексте. [Подробнее](https://ru.wikipedia.org/wiki/Markdown).
|
|
16
16
|
* **[Компоновщик (markaper)](/docs/archtool.markaper)** - компонент для организации интерфейса, позволяющий создавать табы выпадающие списки и другие элементы управления на странице.
|
|
17
|
+
* **[Мастер (wizard)](/docs/archtool.wizard)** - пошаговый мастер для последовательного показа вложенных документов.
|
|
17
18
|
* **[HTML](/docs/archtool.plugins.example)** - язык разметки для структурирования и отображения контента. [Подробнее](https://ru.wikipedia.org/wiki/HTML).
|
|
18
19
|
* **[SVG](/docs/archtool.plugins.svg_inline)** - язык разметки для создания масштабируемой векторной графики. [Подробнее](https://ru.wikipedia.org/wiki/SVG).
|
|
19
20
|
* **[Таблица](/docs/archtool.tables)** - документ для представления данных в табличной форме.
|
|
@@ -18,7 +18,8 @@
|
|
|
18
18
|
|
|
19
19
|
| Параметр | Описание | Значение по умолчанию
|
|
20
20
|
| --- | --- | -- |
|
|
21
|
-
| VUE_APP_DOCHUB_PLUGIN_DRAWIO_SERVER_URI |
|
|
21
|
+
| VUE_APP_DOCHUB_PLUGIN_DRAWIO_SERVER_URI | Базовый адрес сервера DRAWIO (только host и path, без query) | https://embed.diagrams.net/ |
|
|
22
|
+
| VUE_APP_DOCHUB_PLUGIN_DRAWIO_URL_PARAMS | Глобальные query-параметры iframe DRAWIO (`key=value` через `&`) | _(пусто)_ |
|
|
22
23
|
| VUE_APP_DOCHUB_PLUGIN_DRAWIO_LOAD_CUSTOM_HANDLERS | Разрешать ли загрузку дополнительных обработчиков XML из манифеста (см ниже) | false |
|
|
23
24
|
|
|
24
25
|
|
|
@@ -34,17 +35,37 @@
|
|
|
34
35
|
docker run -it --rm --name="draw" -p 8080:8080 -p 8443:8443 jgraph/drawio
|
|
35
36
|
```
|
|
36
37
|
|
|
37
|
-
|
|
38
|
+
В переменной `VUE_APP_DOCHUB_PLUGIN_DRAWIO_SERVER_URI` нужно указать только host и path (например `http://127.0.0.1:8080/` или `https://embed.diagrams.net/`). Query и hash из этой переменной **игнорируются**.
|
|
39
|
+
Если значение невалидно или пусто — используется `https://embed.diagrams.net/`.
|
|
38
40
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
+
В переменной `VUE_APP_DOCHUB_PLUGIN_DRAWIO_URL_PARAMS` можно указать query-параметры для iframe drawio. Строка в формате query string (как в URL), без `?`.
|
|
42
|
+
```bash
|
|
43
|
+
VUE_APP_DOCHUB_PLUGIN_DRAWIO_URL_PARAMS=chrome=0&lightbox=1
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
Параметры iframe собираются кодом в таком порядке (более поздний слой перекрывает предыдущий):
|
|
47
|
+
|
|
48
|
+
1. Базовые параметры по умолчанию (`embed`, `ui=atlas`, `spin`, `modified`, `saveAndExit`, `noSaveBtn`, `noExitBtn`, `proto` и т.д.)
|
|
49
|
+
2. глобальные `VUE_APP_DOCHUB_PLUGIN_DRAWIO_URL_PARAMS`
|
|
50
|
+
3. параметры документа `drawio_url_params` в YAML-профиле документа
|
|
51
|
+
4. обязательные параметры плагина (например, `embed=1`, `proto=json` для drawio)
|
|
41
52
|
|
|
42
|
-
|
|
53
|
+
В профиле документа можно задать map (или строку query):
|
|
43
54
|
|
|
44
|
-
|
|
55
|
+
```yaml
|
|
56
|
+
archtool.plugins.drawio.view_only:
|
|
57
|
+
location: SEAF.ArchTool/Руководство/Документы/Drawio/Только просмотр
|
|
58
|
+
type: drawio
|
|
59
|
+
template: templates/example.drawio
|
|
60
|
+
drawio_url_params:
|
|
61
|
+
chrome: 0
|
|
62
|
+
lightbox: 1
|
|
63
|
+
```
|
|
64
|
+
**Режим только просмотра:** у Draw.io read-only viewer включается параметром `chrome=0` (chromeless).
|
|
65
|
+
Опционально добавьте `lightbox=1` (lightbox внутри chromeless: крупнее zoom, без page chrome).
|
|
66
|
+
См. [Supported URL parameters](https://www.drawio.com/docs/reference/supported-url-parameters/).
|
|
45
67
|
|
|
46
|
-
|
|
47
|
-
При самостоятельном формировании адреса ссылки необходимо обязательно указывать параметр proto=json
|
|
68
|
+
Подробнее об embed mode: [тут](https://www.drawio.com/doc/faq/embed-mode).
|
|
48
69
|
|
|
49
70
|
## Параметризация drawio диаграмм
|
|
50
71
|
Плагин поддерживает параметризацию drawio файла перед отображением.
|
|
@@ -93,6 +93,14 @@ docs:
|
|
|
93
93
|
# direction - Направление таблицы
|
|
94
94
|
# Дефолтное значение: ltr
|
|
95
95
|
# Допустимые значения: ltr (left to right) / ttb (top to bottom)
|
|
96
|
+
freeze:
|
|
97
|
+
rows: 1
|
|
98
|
+
# rows - Количество верхних визуальных строк, закрепляемых при вертикальной прокрутке.
|
|
99
|
+
# Для ltr значение 1 закрепляет строку заголовков.
|
|
100
|
+
columns: 2
|
|
101
|
+
# columns - Количество левых визуальных колонок, закрепляемых при горизонтальной прокрутке.
|
|
102
|
+
# Служебная колонка выбора, если selection: true, входит в этот счётчик.
|
|
103
|
+
# Дефолтное значение для rows и columns: 0
|
|
96
104
|
excel_export: false
|
|
97
105
|
# excel_export - Флаг позволяющий отключить выгрузку таблицы в excel
|
|
98
106
|
# Дефолтное значение: true
|
|
@@ -174,7 +182,7 @@ docs:
|
|
|
174
182
|
# Обязательное
|
|
175
183
|
width: 50px
|
|
176
184
|
# width - Ширина колонки (px)
|
|
177
|
-
# Обязательное значение при
|
|
185
|
+
# Обязательное значение при использовании legacy-настройки "pinned: true"
|
|
178
186
|
filterable: false
|
|
179
187
|
# filterable - Флаг, позволяет отключить фильтрацию в колонке
|
|
180
188
|
# Дефолтное значение: true
|
|
@@ -199,7 +207,8 @@ docs:
|
|
|
199
207
|
# text - Отображаемый заголовок
|
|
200
208
|
# Дефолтное значение: подставляется из значения value
|
|
201
209
|
pinned: true
|
|
202
|
-
# pinned -
|
|
210
|
+
# pinned - Legacy-настройка, закрепляющая колонку при горизонтальном скроле.
|
|
211
|
+
# Для новых документов используйте document-level настройку freeze.columns.
|
|
203
212
|
# Дефолтное значение: false
|
|
204
213
|
# Допустимые значения: true / false
|
|
205
214
|
# При "pinned: true" необходимо явно установить значение для "width"
|
|
@@ -393,4 +402,3 @@ docs:
|
|
|
393
402
|
(
|
|
394
403
|
{ "body": body }
|
|
395
404
|
)
|
|
396
|
-
|
|
@@ -96,6 +96,14 @@ docs:
|
|
|
96
96
|
# direction - Направление таблицы
|
|
97
97
|
# Дефолтное значение: ltr
|
|
98
98
|
# Допустимые значения: ltr (left to right) / ttb (top to bottom)
|
|
99
|
+
freeze:
|
|
100
|
+
rows: 1
|
|
101
|
+
# rows - Количество верхних визуальных строк, закрепляемых при вертикальной прокрутке.
|
|
102
|
+
# Для ltr значение 1 закрепляет строку заголовков.
|
|
103
|
+
columns: 2
|
|
104
|
+
# columns - Количество левых визуальных колонок, закрепляемых при горизонтальной прокрутке.
|
|
105
|
+
# Служебная колонка выбора, если selection: true, входит в этот счётчик.
|
|
106
|
+
# Дефолтное значение для rows и columns: 0
|
|
99
107
|
excel_export: false
|
|
100
108
|
# excel_export - Флаг позволяющий отключить выгрузку таблицы в excel
|
|
101
109
|
# Дефолтное значение: true
|
|
@@ -177,7 +185,7 @@ docs:
|
|
|
177
185
|
# Обязательное
|
|
178
186
|
width: 50px
|
|
179
187
|
# width - Ширина колонки (px)
|
|
180
|
-
# Обязательное значение при
|
|
188
|
+
# Обязательное значение при использовании legacy-настройки "pinned: true"
|
|
181
189
|
filterable: false
|
|
182
190
|
# filterable - Флаг, позволяет отключить фильтрацию в колонке
|
|
183
191
|
# Дефолтное значение: true
|
|
@@ -202,7 +210,8 @@ docs:
|
|
|
202
210
|
# text - Отображаемый заголовок
|
|
203
211
|
# Дефолтное значение: подставляется из значения value
|
|
204
212
|
pinned: true
|
|
205
|
-
# pinned -
|
|
213
|
+
# pinned - Legacy-настройка, закрепляющая колонку при горизонтальном скроле.
|
|
214
|
+
# Для новых документов используйте document-level настройку freeze.columns.
|
|
206
215
|
# Дефолтное значение: false
|
|
207
216
|
# Допустимые значения: true / false
|
|
208
217
|
# При "pinned: true" необходимо явно установить значение для "width"
|
|
@@ -26,6 +26,37 @@
|
|
|
26
26
|
- false
|
|
27
27
|
- Прочие приводимые значения
|
|
28
28
|
|
|
29
|
+
# Markdown в текстовых ячейках
|
|
30
|
+
|
|
31
|
+
Текстовую колонку можно показывать как Markdown, не меняя сохраняемое значение.
|
|
32
|
+
Возможность включается только для заголовка с `type: text`:
|
|
33
|
+
|
|
34
|
+
```yaml
|
|
35
|
+
headers:
|
|
36
|
+
- value: evidence
|
|
37
|
+
text: Обоснование
|
|
38
|
+
type: text
|
|
39
|
+
render: markdown
|
|
40
|
+
editable: true
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Без `render: markdown` Markdown-синтаксис отображается как обычный текст. Поддерживаются
|
|
44
|
+
обычное форматирование и ссылки, таблицы, изображения, а также fenced-блоки `mermaid`
|
|
45
|
+
и `plantuml`. Произвольный HTML не исполняется.
|
|
46
|
+
|
|
47
|
+
Markdown хранится в ячейке как обычная строка и сохраняется тем же способом, что и
|
|
48
|
+
обычный `text`; проверенный save payload сохраняет и соседнее поле строки. Относительные пути изображений вычисляются от файла презентации
|
|
49
|
+
editable-table; они не зависят от `save.path` конкретной колонки. Mermaid строится в
|
|
50
|
+
браузере, а PlantUML требует настроенный сервер или обработчик IDEA-плагина.
|
|
51
|
+
|
|
52
|
+
Режим исходного текста открывается кнопкой редактирования, двойным кликом, `Enter` или
|
|
53
|
+
`F2` на выбранной ячейке. `Escape`, `Ctrl/Cmd+Enter` или переход фокуса завершают
|
|
54
|
+
редактирование и возвращают предпросмотр.
|
|
55
|
+
|
|
56
|
+
SVG, в которых подписи находятся внутри `foreignObject` (например, экспортированные из
|
|
57
|
+
draw.io или Excalidraw), браузер может показать без текста: такие изображения выводятся
|
|
58
|
+
в `<img>`.
|
|
59
|
+
|
|
29
60
|
# link
|
|
30
61
|
|
|
31
62
|
## Описание
|
|
@@ -161,6 +192,8 @@ headers:
|
|
|
161
192
|
# type - Тип вывода ячеек для указанной колонки
|
|
162
193
|
# Дефолтное значение: text
|
|
163
194
|
# Допустимые значения: text / select / multiple-select / checkbox / link / fn
|
|
195
|
+
# render - дополнительный режим отображения текстовой ячейки
|
|
196
|
+
# Допустимое значение: markdown (только вместе с type: text)
|
|
164
197
|
|
|
165
198
|
- value: name
|
|
166
199
|
text: Имя
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
docs:
|
|
2
|
+
archtool.example.wizard:
|
|
3
|
+
type: wizard
|
|
4
|
+
title: Пример мастера
|
|
5
|
+
wizardConfig:
|
|
6
|
+
showProgress: true
|
|
7
|
+
navigationRules:
|
|
8
|
+
restricted: true
|
|
9
|
+
source:
|
|
10
|
+
- id: table
|
|
11
|
+
title: Таблица
|
|
12
|
+
src: "@document/archtool.table.preset"
|
|
13
|
+
- id: mermaid
|
|
14
|
+
title: Mermaid
|
|
15
|
+
src: "@document/archtool.example.mermaid"
|
|
16
|
+
- id: plantuml
|
|
17
|
+
title: PlantUML
|
|
18
|
+
src: "@document/archtool.example.pml"
|
|
@@ -51,11 +51,6 @@ archtool.plugins.gigachat.example:
|
|
|
51
51
|
Взаимодействует c API GigaChat.
|
|
52
52
|
Позволяет описать промпт и добавить в него результат выполнения JSONata-выражения в качестве контекста.
|
|
53
53
|
|
|
54
|
-
## [`react`](/entities/docs/blank?dh-doc-id=archtool.plugins.gigachat.agents.react.menu)
|
|
55
|
-
|
|
56
|
-
Взаимодействует c API GigaChat.
|
|
57
|
-
Позволяет использовать тулы (function-calling инструменты) для предоставления ответа.
|
|
58
|
-
|
|
59
54
|
## [`aigena`](/entities/docs/blank?dh-doc-id=archtool.plugins.gigachat.agents.aigena.menu)
|
|
60
55
|
|
|
61
56
|
Взаимодействует с API AiGenA.
|
|
@@ -84,6 +84,12 @@ entities:
|
|
|
84
84
|
|
|
85
85
|

|
|
86
86
|
|
|
87
|
+
### Сохранение выбранной вкладки
|
|
88
|
+
|
|
89
|
+
После перезагрузки страницы, в том числе после сохранения редактируемой таблицы,
|
|
90
|
+
`mkr-tabs` восстанавливает выбранную вкладку. Если она больше недоступна,
|
|
91
|
+
выбирается вкладка с `selected: true`, а при её отсутствии — первая вкладка.
|
|
92
|
+
|
|
87
93
|
## Пример использования в архитектурном коде документа с типом mkr-grid:
|
|
88
94
|
|
|
89
95
|
```yaml
|
|
@@ -34,6 +34,7 @@
|
|
|
34
34
|
|
|
35
35
|
imports:
|
|
36
36
|
- examples/table.yaml
|
|
37
|
+
- examples/wizard.yaml
|
|
37
38
|
- examples/charts.yaml
|
|
38
39
|
- examples/inlinemeta.md
|
|
39
40
|
- examples/markaper.yaml
|
|
@@ -628,6 +629,17 @@ docs:
|
|
|
628
629
|
type: markdown
|
|
629
630
|
source: markaper.md
|
|
630
631
|
|
|
632
|
+
archtool.wizard:
|
|
633
|
+
location: SEAF.ArchTool/Руководство/Документы/Мастер (wizard)
|
|
634
|
+
description: Мастер (wizard)
|
|
635
|
+
type: markdown
|
|
636
|
+
subjects:
|
|
637
|
+
- archtool.front
|
|
638
|
+
- archtool.front.spa
|
|
639
|
+
- archtool.front.spa.blank
|
|
640
|
+
- archtool.front.spa.blank.doc
|
|
641
|
+
source: wizard.md
|
|
642
|
+
|
|
631
643
|
archtool.tables:
|
|
632
644
|
location: SEAF.ArchTool/Руководство/Документы/Таблица
|
|
633
645
|
description: Таблицы
|