Начало работы
Папки проектов
Группировка проектов во вложенных папках на странице «Проекты», в ваших собственных папках или в общем дереве папок организации, и перемещение проектов перетаскиванием, через меню или с клавиатуры.
На этой странице
Обзор
Папки держат проекты программы вместе: системный проект, проекты подсистем, тестовые проекты и модели поставщиков. Папки вкладываются в папки на глубину до восьми уровней. Страница Проекты (Управление проектами) показывает их в виде дерева рядом со списком проектов.
Есть два вида деревьев папок:
- Мои папки: ваши собственные папки. Их видите только вы. В них находятся ваши проекты, не входящие в организацию, членом которой вы являетесь, и проекты, к которым вам предоставили доступ другие люди.
- Папки организации: по одному дереву на каждую организацию, в которой вы состоите, одинаковому для всех участников. Его упорядочивают администраторы; администраторы и владельцы проекта размещают в нём проекты.
Папки есть на всех тарифах. Деревья папок организаций есть везде, где есть организации.
Понятия
В каком дереве находится проект
Для вас каждый проект находится ровно в одном дереве и не более чем в одной папке этого дерева.
| Проект | Его дерево для вас |
|---|---|
| Относится к организации, участником которой вы являетесь | Дерево этой организации |
| Любой другой проект, который вы можете открыть | Мои папки |
Проект на верхнем уровне дерева, не находящийся ни в одной папке, отображается, когда вы выбираете само дерево.
Кто что может делать
| Действие | Мои папки | Папки организации |
|---|---|---|
| Видеть папки | Вы | Каждый участник |
| Создавать, переименовывать, перемещать и удалять папки | Вы | Администраторы организации |
| Перемещать проект в папку или из неё | Вы — для любого проекта, который вы можете открыть | Администраторы организации и владельцы проекта |
| Записывается в журнал аудита организации | Нет | Да: каждая созданная, переименованная, перемещённая или удалённая папка и каждое перемещение проекта между папками |
Человек вне организации, которому предоставлен доступ к одному из её проектов, никогда не видит имена папок организации. Для него проект находится в его собственных Мои папки, на верхнем уровне, пока он не разместит его.
Проект переходит в другое дерево, только когда меняется его организация (Поделиться…). Тогда он оказывается на верхнем уровне нового дерева.
Как использовать
Когда и зачем
Создавайте папки, когда связываете проекты друг с другом: программа становится одной папкой с вложенной папкой для каждой подсистемы или поставщика. Тогда папка также служит областью для Карты программы, которая показывает, как связаны проекты в ней.
Создать папку
- Откройте Управление проектами.
- Выберите дерево или папку, в которую пойдёт новая папка.
- Нажмите Новая папка над списком.
- Введите имя и нажмите Enter.
Новая папка появится в дереве с числом 0 рядом. В меню ⋯ папки также есть Новая вложенная папка…, а ⌘K / Ctrl+K → Новая папка проектов… создаёт папку на верхнем уровне Мои папки.
Переместить проекты в папку
- Выберите папку, в которой находятся проекты, или Все проекты.
- Перетащите строку проекта на папку в дереве или на строку папки в списке.
Появится сообщение “Mars Rover перемещён в Avionics.” с кнопкой Отменить.
Чтобы переместить несколько проектов сразу:
- Отметьте флажок в начале каждой строки. Shift+щелчок отмечает все строки между последней отмеченной и текущей; флажок в заголовке отмечает весь список.
- Перетащите одну из отмеченных строк на папку или нажмите Переместить в папку… на панели над списком.
- В окне Переместить в папку выберите папку и нажмите Переместить.
Без перетаскивания используйте Переместить в папку… в меню ⋯ проекта или ⌘K / Ctrl+K → Переместить проект в папку…, когда проект открыт. Новая папка… в этом диалоге создаёт папку внутри выбранной.
Упорядочить папки
- Переименование: выберите папку в дереве и нажмите F2 или ⋯ → Переименовать….
- Перемещение: перетащите папку на другую папку того же дерева или ⋯ → Переместить папку…. Папку нельзя переместить в неё саму или в одну из её вложенных папок.
- Удаление: ⋯ → Удалить папку… или Delete в дереве. Её проекты и вложенные папки поднимаются в родительскую папку; ни один проект не удаляется. Поднятая вложенная папка, имя которой там уже занято, получает номер, например Power (2).
Каждое изменение показывает сообщение с кнопкой Отменить.
Найти проект в любой папке
Введите текст в поле Найти проект. Поиск идёт по всем папкам, что бы ни было выбрано, и сопоставляет имена, описания, идентификаторы проектов и пути папок. Столбец Папка показывает, где находится каждое совпадение.
Разобранный пример: программа CubeSat
- Создайте демо-проект CubeSat EO-1 (Файлы проектов ▾ → Новый демо-проект).
- Щёлкните Мои папки, затем Новая папка и назовите её EO-1 Program.
- Выбрав EO-1 Program, дважды нажмите Новая папка: Spacecraft и Ground Segment.
- Выберите Все проекты и перетащите CubeSat EO-1 на Spacecraft.
- Откройте ⋯ папки EO-1 Program → Открыть в карте программы. Карта показывает каждый проект в папке программы и её вложенных папках.
Советы и рекомендации
- Называйте папки по программам, системам и поставщикам, а не по людям: деревья папок переживают команды.
- Отводите общие папки организации под её программы. Личные эксперименты размещайте в Мои папки.
- Перед рецензированием используйте Открыть в карте программы для папки программы, чтобы увидеть, каких связей не хватает.
Типичные ошибки
- “Avionics — папка Acme. Сначала переместите … в Acme через «Поделиться…».” Вы бросили проект из другого дерева на папку организации. Измените организацию проекта в окне Поделиться… или разместите его в Мои папки.
- “Размещать … могут только владельцы проекта и администраторы …” В дереве организации участники, не являющиеся владельцами, не могут перемещать проекты. Обратитесь к владельцу или администратору.
- После поиска папка выглядит пустой. Список показывает совпадения поиска из всех папок. Очистите поле Найти проект.
Как это связано с остальным
- Карта программы: папка служит областью (меню Область или ⋯ папки → Открыть в карте программы).
- Связи с другими проектами: папки группируют проекты, которые ссылаются друг на друга.
- API и MCP: list_projects и
GET /api/v1/projectsвозвращают путьfolderкаждого проекта. - Импорт и экспорт: экспорт проекта записывает путь его папки; импорт заново создаёт её в Мои папки.
Страница «Проекты»
Дерево папок
| Элемент | Что он делает |
|---|---|
| Все проекты | Все проекты, которые вы можете открыть, в одном списке |
| Имя организации | Общее дерево этой организации: её проекты на верхнем уровне и её папки |
| Мои папки | Ваше собственное дерево |
| Папка | Показывает её вложенные папки и проекты, находящиеся непосредственно в ней |
| Число рядом с узлом | Проекты в ней и в её вложенных папках |
| ▸ / ▾ | Показывает или скрывает вложенные папки (запоминается в этом браузере) |
Щёлкните папку правой кнопкой мыши или нажмите Shift+F10, чтобы открыть её меню: Новая вложенная папка…, Переименовать…, Переместить папку…, Открыть в карте программы, Удалить папку…. В дереве организации участники, не являющиеся администраторами, видят только Открыть в карте программы.
Над списком
- Навигационная цепочка: путь выбранной папки, например Мои папки › EO-1 Program › Spacecraft. Щёлкните часть пути, чтобы подняться выше.
- Панель выделения: отображается, пока отмечены строки: выбрано проектов: n, Переместить в папку…, Снять выделение.
В списке
- Строки папок идут первыми: имя папки, число проектов и ⋯ для её меню. Щёлкните имя, чтобы открыть папку.
- Строки проектов начинаются с флажка. Перетаскивайте строку за любую часть, кроме ссылки, кнопки или флажка.
- Пустая папка сообщает “Эта папка пуста.” с кнопкой Новая вложенная папка, а в Мои папки — также + Новый проект. Новый проект попадает в выбранную папку Мои папки; другую папку выберите в поле Папка диалога Новый проект.
Параметры проекта
Поле Папка в Параметры проекта… перечисляет папки дерева проекта. Оно затенено там, где вы не можете размещать проект.
Клавиатура и программы чтения с экрана
Дерево папок — одна остановка клавиши Tab.
| Клавиша | Действие |
|---|---|
| ↑ / ↓ | Предыдущая или следующая папка |
| → | Показать вложенные папки или перейти к первой из них |
| ← | Скрыть вложенные папки или перейти к родительской папке |
| Home / End | Первая или последняя папка |
| Enter или Space | Показать папку в списке |
| F2 | Переименовать папку |
| Delete | Удалить папку (сначала спрашивает) |
| Shift+F10 | Меню папки |
| Буква | Следующая папка, имя которой начинается с неё |
Программы чтения с экрана сообщают имя и число проектов каждой папки, развёрнута ли она, а также каждое перемещение, переименование, удаление и отмену в момент выполнения.
Ограничения
| Ограничение | Значение |
|---|---|
| Имя папки | От 1 до 80 символов |
| Глубина папок | 8 уровней |
| Папок в дереве | 1,000 |
| Одинаковое имя | Не дважды в одной папке (регистр букв не учитывается) |
Сообщения
| Сообщение | Значение |
|---|---|
| Папка с именем «…» уже есть. Выберите другое имя. | В папке, куда вы даёте имя или перемещаете, уже есть папка с таким именем |
| Папки вкладываются не глубже 8 уровней. Выберите папку выше. | Новая или перемещаемая папка оказалась бы глубже 8 уровней |
| Папку нельзя переместить в неё саму или в одну из её вложенных папок. | Выберите папку вне той, которую перемещаете |
| Изменять папки этой организации может только её администратор. | Обратитесь к администратору организации |
| Выбранные проекты находятся в разных деревьях папок (…). Выберите проекты из одного дерева. | Перемещайте проекты каждого дерева отдельно |