Инструменты · Проекты
project_write
Создаёт новый проект в рабочей области EDT — расширение конфигурации, внешнюю обработку или внешний отчёт. Один вызов — один проект; создание идёт штатными сервисами EDT, как мастером «Новый проект».
Когда использовать
- Нужно доработать объект, закрытый поставщиком, — создайте расширение и заимствуйте объект (
metadata_actionс операциейadopt). - Нужна внешняя обработка или внешний отчёт — проект создаётся с пустым объектом внутри, дальше его наполняют
metadata_write,form_write,code_write. - Для импорта существующего проекта с диска нужен не этот инструмент, а
project_actionс операциейattach.
Соседние инструменты домена «Проекты»
project_action с операцией run_tests: список прогонов со статусами и полный отчёт по прогону. Пока отчёт не собран, отвечает 🔵 running — вызов можно просто повторить.Операции
| operation | Что делает | Нужно передать |
|---|---|---|
create_extension | Проект расширения поверх базовой конфигурации. Режим совместимости, вариант встроенного языка и язык наследуются от базовой; назначение — Дополнение, Адаптация или Исправление. | project_name, base_project (проект конфигурации); по желанию name, name_prefix, purpose, synonym, comment, runtime_version, compatibility_mode |
create_external_processing | Проект внешней обработки с пустой обработкой внутри; имя обработки совпадает с именем проекта. | project_name, base_project; по желанию synonym, comment, runtime_version |
create_external_report | Проект внешнего отчёта с пустым отчётом внутри. | project_name, base_project; по желанию synonym, comment, runtime_version |
Параметры
| Параметр и тип | Обязательный | Описание | По умолчанию |
|---|---|---|---|
operationстрока | да | Операция инструмента — значения и их смысл в таблице «Операции».значения: create_extension · create_external_processing · create_external_report | — |
project_nameстрока | для всех операций | Имя нового проекта рабочей области. Для внешней обработки и отчёта — это же имя объекта. Может содержать точки: УТ2020.<Расширение>. | — |
base_projectстрока | для create_extension | Идентификатор базового проекта конфигурации из project_read. Для расширения обязателен и должен быть проектом конфигурации. | — |
nameстрока | нет | Имя конфигурации расширения. По умолчанию — последний сегмент project_name после точки. | — |
name_prefixстрока | нет | Префикс собственных объектов расширения. По умолчанию — имя расширения и знак подчёркивания. | — |
purposeстрока | нет | Назначение расширения: AddOn / Дополнение (по умолчанию), Customization / Адаптация, Patch / Исправление. | — |
synonymстрока | нет | Синоним на основном языке базовой конфигурации. По умолчанию — имя. | — |
commentстрока | нет | Комментарий. | — |
runtime_versionстрока | нет | Версия платформы, например 8.5.1. По умолчанию — как у базового проекта. | — |
compatibility_modeстрока | нет | Режим совместимости расширения, например 8.3.14. По умолчанию наследуется от базовой конфигурации. | — |
titleстрока | нет | Необязательная подпись вызова до 40 символов: клиент показывает её в шапке карточки вызова. На результат не влияет. | — |
Таблица собрана из схемы инструмента, которую получает агент при подключении.
Адреса
Инструмент не принимает адрес fqn: новый проект задаётся именем project_name, базовый — идентификатором base_project из project_read.
Пример вызова и ответа
{
"operation": "create_extension",
"project_name": "УТ2020.<Расширение>",
"base_project": "УТ2020",
"name_prefix": "<Префикс>_",
"purpose": "Дополнение",
"synonym": "<Синоним расширения>"
}Пример ответа в подготовке Устройство ответа — на странице Формат ответов.
Отказы и ошибки
rolled_back · базовый проект не конфигурация
Для расширения base_project должен быть проектом конфигурации, а не другого расширения или внешнего объекта. Возьмите идентификатор из project_read.
failed · Unknown operation
Неизвестное значение operation. В ответе — fix_hint: supported: … со списком допустимых операций и секция Did you mean. Допустимо: create_extension, create_external_processing, create_external_report.
failed · лицензия
Без действующего ключа инструмент отвечает карточкой failed с сообщением лицензия: … и подсказкой, где ввести ключ; в секции Context — список инструментов, доступных без ключа. Подробнее — Лицензия и бесплатный доступ.
Ограничения
- Возможности записи узлов внешнего отчёта через
metadata_writeпока ограничены. - Сборка файлов
.cfe,.epf,.erf— штатными средствами EDT, Кванта их не выгружает.