Holarch

Начало работы

Папки проектов

Группировка проектов во вложенных папках на странице «Проекты», в ваших собственных папках или в общем дереве папок организации, и перемещение проектов перетаскиванием, через меню или с клавиатуры.

Как использовать →

На этой странице
  1. Обзор
  2. Понятия
    1. В каком дереве находится проект
    2. Кто что может делать
  3. Как использовать
    1. Когда и зачем
    2. Создать папку
    3. Переместить проекты в папку
    4. Упорядочить папки
    5. Найти проект в любой папке
    6. Разобранный пример: программа CubeSat
    7. Советы и рекомендации
    8. Типичные ошибки
    9. Как это связано с остальным
  4. Страница «Проекты»
    1. Дерево папок
    2. Над списком
    3. В списке
    4. Параметры проекта
  5. Клавиатура и программы чтения с экрана
  6. Ограничения
  7. Сообщения
  8. Связанные материалы

Обзор

Папки держат проекты программы вместе: системный проект, проекты подсистем, тестовые проекты и модели поставщиков. Папки вкладываются в папки на глубину до восьми уровней. Страница Проекты (Управление проектами) показывает их в виде дерева рядом со списком проектов.

Есть два вида деревьев папок:

  • Мои папки: ваши собственные папки. Их видите только вы. В них находятся ваши проекты, не входящие в организацию, членом которой вы являетесь, и проекты, к которым вам предоставили доступ другие люди.
  • Папки организации: по одному дереву на каждую организацию, в которой вы состоите, одинаковому для всех участников. Его упорядочивают администраторы; администраторы и владельцы проекта размещают в нём проекты.

Папки есть на всех тарифах. Деревья папок организаций есть везде, где есть организации.

Понятия

В каком дереве находится проект

Для вас каждый проект находится ровно в одном дереве и не более чем в одной папке этого дерева.

ПроектЕго дерево для вас
Относится к организации, участником которой вы являетесьДерево этой организации
Любой другой проект, который вы можете открытьМои папки

Проект на верхнем уровне дерева, не находящийся ни в одной папке, отображается, когда вы выбираете само дерево.

Кто что может делать

ДействиеМои папкиПапки организации
Видеть папкиВыКаждый участник
Создавать, переименовывать, перемещать и удалять папкиВыАдминистраторы организации
Перемещать проект в папку или из неёВы — для любого проекта, который вы можете открытьАдминистраторы организации и владельцы проекта
Записывается в журнал аудита организацииНетДа: каждая созданная, переименованная, перемещённая или удалённая папка и каждое перемещение проекта между папками

Человек вне организации, которому предоставлен доступ к одному из её проектов, никогда не видит имена папок организации. Для него проект находится в его собственных Мои папки, на верхнем уровне, пока он не разместит его.

Проект переходит в другое дерево, только когда меняется его организация (Поделиться…). Тогда он оказывается на верхнем уровне нового дерева.

Как использовать

Когда и зачем

Создавайте папки, когда связываете проекты друг с другом: программа становится одной папкой с вложенной папкой для каждой подсистемы или поставщика. Тогда папка также служит областью для Карты программы, которая показывает, как связаны проекты в ней.

Создать папку

  1. Откройте Управление проектами.
  2. Выберите дерево или папку, в которую пойдёт новая папка.
  3. Нажмите Новая папка над списком.
  4. Введите имя и нажмите Enter.

Новая папка появится в дереве с числом 0 рядом. В меню ⋯ папки также есть Новая вложенная папка…, а ⌘K / Ctrl+K → Новая папка проектов… создаёт папку на верхнем уровне Мои папки.

Переместить проекты в папку

  1. Выберите папку, в которой находятся проекты, или Все проекты.
  2. Перетащите строку проекта на папку в дереве или на строку папки в списке.

Появится сообщение “Mars Rover перемещён в Avionics.” с кнопкой Отменить.

Чтобы переместить несколько проектов сразу:

  1. Отметьте флажок в начале каждой строки. Shift+щелчок отмечает все строки между последней отмеченной и текущей; флажок в заголовке отмечает весь список.
  2. Перетащите одну из отмеченных строк на папку или нажмите Переместить в папку… на панели над списком.
  3. В окне Переместить в папку выберите папку и нажмите Переместить.

Без перетаскивания используйте Переместить в папку… в меню ⋯ проекта или ⌘K / Ctrl+K → Переместить проект в папку…, когда проект открыт. Новая папка… в этом диалоге создаёт папку внутри выбранной.

Упорядочить папки

  • Переименование: выберите папку в дереве и нажмите F2 или ⋯ → Переименовать….
  • Перемещение: перетащите папку на другую папку того же дерева или ⋯ → Переместить папку…. Папку нельзя переместить в неё саму или в одну из её вложенных папок.
  • Удаление: ⋯ → Удалить папку… или Delete в дереве. Её проекты и вложенные папки поднимаются в родительскую папку; ни один проект не удаляется. Поднятая вложенная папка, имя которой там уже занято, получает номер, например Power (2).

Каждое изменение показывает сообщение с кнопкой Отменить.

Найти проект в любой папке

Введите текст в поле Найти проект. Поиск идёт по всем папкам, что бы ни было выбрано, и сопоставляет имена, описания, идентификаторы проектов и пути папок. Столбец Папка показывает, где находится каждое совпадение.

Разобранный пример: программа CubeSat

  1. Создайте демо-проект CubeSat EO-1 (Файлы проектов ▾ → Новый демо-проект).
  2. Щёлкните Мои папки, затем Новая папка и назовите её EO-1 Program.
  3. Выбрав EO-1 Program, дважды нажмите Новая папка: Spacecraft и Ground Segment.
  4. Выберите Все проекты и перетащите CubeSat EO-1 на Spacecraft.
  5. Откройте ⋯ папки 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 уровней
Папку нельзя переместить в неё саму или в одну из её вложенных папок.Выберите папку вне той, которую перемещаете
Изменять папки этой организации может только её администратор.Обратитесь к администратору организации
Выбранные проекты находятся в разных деревьях папок (…). Выберите проекты из одного дерева.Перемещайте проекты каждого дерева отдельно