Проекты рабочего пространства

Altium Designer в сочетании с Enterprise Server Workspace обеспечивает поддержку Workspace Projects. Проекты Workspace ориентированы на этап разработки в жизненном цикле проекта, упрощая создание и дальнейшую работу с проектами под управлением контроля версий. Централизованное хранение под управлением Workspace также позволяет использовать эту возможность как основу для других совместных сервисов.

Некоторые ключевые преимущества использования проектов Workspace:

• Упрощённое хранение. Не нужно принимать решения о местах хранения. Резервное копирование и другие базовые сервисы уже обеспечены.

• Основа для совместных функций.

• Принудительный контроль версий.

• Преимущества выделенной системы комментирования.

• Уведомления и статус. Статус документа, включая локальные изменения, виден всей команде разработчиков.

• Параллельная разработка PCB работает без какой-либо сложной настройки.

• Возможность поделиться интерактивным представлением проекта в браузере в режиме «только чтение» с другими пользователями через Web Viewer.

• Набор расширенных функций контроля версий, например интерактивное Project History view.

С технической точки зрения проект Workspace — это сочетание метаинформации, хранящейся в Enterprise Server Workspace, и тесной интеграции с собственной службой контроля версий Workspace. Типовой рабочий процесс выглядит так:

1. Пользователь создаёт новый проект Workspace через диалог Create Project в Altium Designer, путём преобразования существующего локального проекта через диалог Make Available On Server или из браузерного интерфейса Workspace (подробно ниже). При создании пользователь задаёт имя и описание проекта.

2. Доступ к проекту определяется и управляется в браузерном интерфейсе Workspace либо непосредственно в Altium Designer.

3. Все участники выбирают проект для открытия (либо в Altium Designer, либо в браузерном интерфейсе Workspace), после чего он автоматически извлекается (check out) как набор проектных файлов.

В этом документе рассматривается работа с проектами через браузерный интерфейс Enterprise Server Workspace. Сведения о работе с проектами в вашей САПР см. в разделе Getting Familiar with the Altium Design Environment.

Создание нового проекта Workspace

Существует несколько способов создать проект Workspace:

• Создание нового проекта из браузерного интерфейса Workspace или непосредственно из Altium Designer.
• Предоставление существующего проекта (локального проекта или локального проекта, уже находящегося под внешним контролем версий) в Workspace из Altium Designer — то есть преобразование локального проекта в проект Workspace. Подробнее см. на странице Making an Existing Project Available in the Workspace.
• Клонирование существующего проекта Workspace через браузерный интерфейс Workspace или путём клонирования проекта с панели Projects panel в Altium Designer.
• Загрузка локального проекта из браузерного интерфейса Workspace.

Чтобы создать проект Workspace напрямую через браузерный интерфейс Workspace:

1. Войдите в интерфейс и выберите пункт меню Projects, чтобы перейти на страницу Designs . Здесь будут перечислены все ранее созданные проекты.

2. Нажмите кнопку в верхней части страницы, затем выберите пункт меню Create Project, чтобы открыть окно Create Project .

   Если для темы процесса Project Creations доступны какие-либо активные process definitions — определённые на вкладке Project Creations страницы Processes в браузерном интерфейсе Workspace — то меню кнопки предложит эти процессы в качестве вариантов вместо пункта Create Project. Выберите нужный пункт, чтобы запустить соответствующий рабочий процесс.

3. Окно изначально будет показано в упрощённом виде. Введите желаемое имя проекта, описание (при необходимости) и выберите подходящий Project Template из выпадающего меню Templates.

   Имя проекта должно начинаться с символов A-Z, a-z или 0-9 и может содержать эти символы. Разрешены подчёркивания, дефисы и пробелы, но пробелы можно использовать только в середине имени (начальные и конечные пробелы будут игнорироваться). Нельзя использовать следующие слова: AUX, COM1-COM9, LPT1-LPT9, CON, NUL и PRN. Кроме того, имя не может содержать следующие символы: \ . / ? % * : | " < >.

4. Нажмите кнопку ​, чтобы получить доступ к полю Parent Folder. Используйте его, чтобы указать, где в структуре папок Workspace должен быть создан проект. Это будет текущая открытая папка либо (по умолчанию) Projects. Обратите внимание: путь папки по умолчанию для новых проектов задаётся на странице Admin – Settings – Projects  в браузерном интерфейсе Workspace. В окне Create Project  нажмите Change ссылку справа от поля, чтобы открыть структуру папок Workspace и выбрать альтернативную папку для хранения проекта.

   Если папка по умолчанию (например Projects) недоступна, Workspace создаст иерархию Personal Folder  для хранения ваших проектов. Она отображается как приватная папка верхнего уровня с именем вашего пользователя и подпапкой My Projects  для хранения созданных или загруженных проектов. Новые проекты будут сохраняться в папке My Projects  или, если в данный момент открыта другая доступная папка, новый проект будет сохранён в ней.

   • Обратите внимание: доступ пользователя к папкам Workspace, включая папку Projects , определяется разрешениями на совместный доступ к папкам, настроенными на странице Explorer page (Admin – Explorer). Подробнее см. Managing Project Creation Permissions.

   • При желании вы можете организовать проекты в иерархию подпапок. Подробнее см. раздел Working with Workspace Folders.

Определение нового проекта Workspace напрямую через браузерный интерфейс Workspace.

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

Дополнительный проект Workspace, созданный через браузерный интерфейс.

Просмотр проектов Workspace

Список проектов на странице Projects в браузерном интерфейсе Workspace включает все проекты, к которым вам предоставлен доступ, и предлагает набор элементов управления для доступа к функциям управления проектами. Используйте кнопку  , чтобы переключить страницу в режим предварительного просмотра проектов (графические плитки), и кнопку , чтобы переключить страницу в режим подробного списка.

Страница Projects  в браузерном интерфейсе Workspace — центральный пункт управления для работы с вашими проектами Workspace. Здесь показан режим подробного списка. Наведите курсор на изображение, чтобы увидеть режим предварительного просмотра проектов.

Записи проектов в представлении автоматически сортируются по дате Last modified, при этом самый недавно изменённый проект отображается первым в списке. Нажмите кнопку , чтобы переключиться на сортировку по имени проекта (Name), и нажмите ещё раз, чтобы переключаться между сортировкой по возрастанию и по убыванию.

Представление в режиме списка () можно сортировать по Name, Author или Date, используя заголовок соответствующего столбца. Нажмите один раз для сортировки по возрастанию, нажмите ещё раз — по убыванию. Стрелки справа от названия столбца показывают текущее направление сортировки.

Представление Projects предоставляет данные Properties и Activities, относящиеся к выбранному проекту, доступные в правой боковой панели представления.

Информация в боковой панели включает: Propertiesвкладка: Project – сводка высокого уровня о состоянии проекта, включая его предварительный просмотр (3D-вид платы, изображение документа многоплатной схемы или изображение документа жгутовой проводки). Child Projects (только для Multi-board projects) – список плат (PCB) подпроектов, включённых в Multi-board project и связанных с ним – показать изображение. Щёлкните по ссылке подпроекта, чтобы открыть этот PCB‑проект в Web Viewer как обычно. Shared With – пользователи и/или группы, у которых есть доступ к проекту. Наведите курсор на запись, чтобы увидеть полное имя пользователя/группы. Reports – проверки электрических правил и правил проектирования (ERC и DRC), сформированные для текущего выбранного проекта, включая количество ошибок/нарушений в каждом отчёте. Выберите запись ERC или DRC, чтобы открыть и просмотреть детали отчёта в рамках проекта. Подробнее об отчётах DRC и ERC см. на странице Web Viewer. Parameters – подробные метаданные, извлечённые или вычисленные на основе самого проекта. Нажмите элемент управления Show More, чтобы развернуть полный список. Where Used – список других проектов, например Multi-board projects, которые включают содержимое данного проекта. Щёлкните по записи, чтобы открыть и просмотреть этот проект в новой вкладке браузера. Releases – список релизов проекта в хронологическом порядке. Щёлкните по записи, чтобы открыть соответствующий релиз в Manufacturing Portal рабочего пространства. Activity вкладка – хронологический список событий проекта, таких как Commit, Release или завершённый процессный workflow, связанный с проектом.

Для каждого проекта также доступны следующие операции через кнопки в верхней части представления (и подробно описаны в связанных ниже разделах):

• Share – элементы управления доступом для настройки прав доступа к проекту.
• Functions – доступ к меню функций проекта. Также доступно из кнопки выбранного проекта в режиме Preview:
  • Open – открыть проект в его подробном CAD-ориентированном представлении. Эквивалентно щелчку (в режиме Preview) или двойному щелчку (в режиме List) по записи имени проекта.
  • Move – переместить проект в другую родительскую папку в структуре папок рабочего пространства.
  • Edit – редактировать проект с точки зрения его Name, Description и Workspace Parameters.
  • Clone – создать идентичную копию проекта с новым именем.
  • Watch/Unwatch – подписаться/отписаться от активности проекта, получая соответствующие уведомления (обновления, релизы и т. п.) на вкладке проекта Activitiy, а также по электронной почте, если включены Email Notifications.
  • Delete – удалить запись проекта, переместив его структуру и данные в Workspace Trash, откуда их можно окончательно удалить из рабочего пространства или восстановить в прежнее состояние.

Также предусмотрена функция Search поиска по проектам, которая может фильтровать список проектов по ряду свойств, таких как Name, Author, Description и т. д. Введите любую часть строки поиска в поле в верхней части интерфейса браузера. Список обновится и будет включать только те записи проектов, чьи атрибуты содержат строку поиска.

Чтобы очистить фильтрацию поиска, либо щёлкните по основной записи страницы Projects в левой панели навигации, либо очистите поле поиска и нажмите Enter.

Пример использования функции поиска — в данном случае поиск проекта по его Description.

Работа с папками Workspace

Workspace также предоставляет возможность создавать и управлять папками проектов в структуре рабочего пространства. Затем проекты можно создавать в любой папке или перемещать в любую папку в получившейся иерархии.

Чтобы создать новую папку под (по умолчанию) папкой верхнего уровня Project, выберите опцию Create Folder в меню кнопки . В следующем окне Create Folder укажите имя новой папки, её родительскую папку и необязательное описание. Новая папка всегда создаётся внутри текущей выбранной папки, которая становится её родительской папкой.

Откройте созданную папку, выбрав её заголовок, и перемещайтесь обратно вверх по иерархии с помощью «хлебных крошек» сверху.

Используйте пункты меню , чтобы изменить сведения о папке (Edit), переместить папку под другую родительскую папку (Move) или удалить папку из структуры папок рабочего пространства (Delete). При перемещении папки выберите новую родительскую папку в дереве иерархии в окне Move folder <folder> to.

Загрузка проекта

В Altium Designer команда Make Available on Server загрузит локальный проект в Workspace, где он станет проектом Workspace под управлением его системы контроля версий. Аналогичный процесс можно выполнить в интерфейсе браузера Workspace с помощью опции Upload Project, доступной в меню кнопки . Перейдите к папке-хосту локального проекта и выберите её, чтобы загрузить проект по умолчанию в текущую выбранную папку Workspace, либо используйте опцию Change в списке окна Upload Project Parent Folder, чтобы выбрать альтернативное расположение в иерархии папок.

Любые существующие ссылки на систему контроля версий в локальном проекте игнорируются, и загруженный проект становится полностью версионируемым проектом Workspace – исходный локальный проект при этом никак не изменяется.

Загрузка набора файлов Gerber или ODB++

Workspace также принимает наборы сгенерированных производственных файлов Gerber/ODB++ в архивном формате, которые можно загрузить через опции Upload Gerber или Upload ODB++, доступные в меню кнопки . Процесс загрузки по сути такой же, как и процесс загрузки проекта, описанный выше.

❯ ❮ Javascript ID: AES_GerberODBupload_7_0.png

Выберите опцию New – Upload Gerber, чтобы перейти к архивированному набору файлов Gerber и выбрать его в файловом браузере Windows. В окне Upload Gerber при необходимости отредактируйте предлагаемое Name проекта (оно берётся из имени архива Gerber) и добавьте Description. Вы можете использовать опцию Change, чтобы указать место хранения проекта, отличающееся от папки хранения проектов по умолчанию. Загруженный набор файлов будет обработан и добавлен в коллекцию проектов Workspace с первоначальным значком Gerber, а затем — сгенерированным изображением предварительного просмотра после обновления или просмотра. Выберите опцию New – Upload ODB++, чтобы перейти к архиву ODB++ и выбрать его в файловом браузере Windows. В окне Upload ODB++ при необходимости отредактируйте предлагаемое Name проекта (оно берётся из имени архива ODB++) и добавьте Description. Вы можете использовать опцию Change, чтобы указать место хранения проекта, отличающееся от папки хранения проектов по умолчанию. Загруженный набор файлов будет обработан и добавлен в коллекцию проектов Workspace с первоначальным значком ODB++, а затем — сгенерированным изображением предварительного просмотра после обновления или просмотра.

Щёлкните по имени проекта Gerber/ODB++ или используйте опцию Open в связанном меню, чтобы загрузить набор файлов в специализированный просмотрщик Workspace. Он предоставляет композитный вид всех включённых файлов/слоёв, позволяет скрывать слои или отображать их по одному, предлагает функцию измерения «точка‑точка» и поддерживает размещаемые комментарии.

Перемещение проекта

Чтобы переместить проект в другую папку Workspace, выберите опцию Move в выпадающем меню и укажите новое расположение в иерархии папок в окне Move project <project> to. После подтверждения кнопкой выбранный проект будет размещён в новой указанной родительской папке.

Предоставление доступа к проекту Workspace

После того как проект находится в Workspace, нужно определить, какие пользователи действительно могут получить к нему доступ. Это делается путём предоставления доступа к проекту, точнее — настройкой его прав доступа.

Проект Workspace по умолчанию расшарен для следующих:

• Владелец проекта, обычно это разработчик, который его создал (или сделал доступным в Workspace): полные права доступа (Read/Write).
• Группа Administrators: полные права доступа (Read/Write).
• Все участники Workspace: доступ только для просмотра.

Права по умолчанию для новых проектов можно задать/изменить на странице Admin – Settings – Projects в интерфейсе браузера Workspace. Обратите внимание: владелец проекта по своей природе получает право доступа к нему и поэтому не отображается в списке.

Настройку прав доступа можно выполнять через интерфейс браузера Workspace, а также directly from within Altium Designer.

Чтобы настроить доступ к проекту из интерфейса браузера Workspace, выберите запись проекта на странице Designs  (Projects в главном меню) и нажмите кнопку , чтобы открыть окно Share:<project> — либо выберите опцию Share в меню , связанном с записью проекта. Здесь доступны все элементы управления, необходимые для предоставления доступа к проекту другим пользователям или группам.

При централизованном управлении проектами в Workspace предоставление доступа другим сводится к управлению правами каждого проекта.

В окне Share <project>:

• Пользователь/группа имеет доступ на чтение/запись, когда включена опция Can Edit. Если эта опция отключена, доступ будет только на чтение.
• Проект можно предоставить всем участникам Workspace с доступом только на чтение (Can View) или на чтение/запись (Can Edit) с помощью раскрывающегося меню записи Workspace Members в области Shared With.
• Чтобы удалить существующего пользователя/группу из списка имеющих общий доступ к проекту, нажмите опцию Remove в соответствующем раскрывающемся меню.

На что следует обратить внимание:

• По умолчанию все пользователи Workspace смогут видеть проект. Если вы хотите ограничить доступ определённым набором пользователей и/или групп, сначала необходимо выбрать No access в раскрывающемся меню записи Workspace Members.
• Владелец проекта имеет постоянный доступ на чтение/запись.
• Также можно поделиться прямой ссылкой на проект. Ссылка получается нажатием элемента управления Copy Link в нижней части окна Sharing. Ссылка копируется в буфер обмена. При использовании она предоставляет соответствующему пользователю — при наличии разрешений — доступ к странице детального управления проектом, обзор которой представлен в следующем разделе.

Действия с проектами Workspace

Workspace предоставляет уникальную возможность применять настраиваемые Process Workflows к проектам Workspace для выполнения специализированных задач, таких как проведение дизайн-ревью и создание новых проектов. Процессы и лежащие в их основе Workflows создаются и настраиваются администратором Workspace и, будучи включёнными, становятся доступными пользователям как Altium Designer, так и браузерного интерфейса Workspace.

► См. Creating & Managing Processes для получения дополнительной информации.
► См. Performing Design Reviews для информации об этих процессах в Altium Designer.

С точки зрения пользователя Process Workflows и присущие им шаги рассматриваются как Activities. Доступные действия могут запускаться пользователями, а шаги workflow выполняться назначенными пользователями как последовательность задач — доступных через страницу Tasks page.

Выберите меню на странице Designs (Projects) и выберите один из доступных Processes, чтобы инициировать действие для текущего выбранного проекта. Заполните необходимые поля и параметры в последующих окнах форм процесса, а затем запустите процесс (). В зависимости от того, какой Process Workflow был запущен, может потребоваться отправить следующий шаг (), чтобы подготовить данные к проверке.

Затем создаются задачи Workflow для пользователя или пользователей, назначенных на это действие. Задача, относящаяся к вошедшему в систему пользователю, появится на странице Tasks page, где с ней можно работать, чтобы перевести Workflow на следующий этап.

Обратите внимание: если действие было назначено группе — Engineers например — соответствующая задача становится доступной всем участникам этой группы, а также любым отдельным пользователям, назначенным на действие. В таких случаях любой из этих пользователей может завершить шаг проверки и отправить результат ().

Функции проектов Workspace

Функциональные операции, связанные с проектами, доступны из меню на странице Designs  и включают возможность открыть, переместить, отредактировать, клонировать, отслеживать и удалить проект Workspace. Это меню также доступно из кнопки выбранной записи проекта:

Открыть проект

Выберите пункт Open в меню записи проекта или в верхнем меню , чтобы открыть проект в ориентированном на производство CAD-центричном представлении — либо, находясь в режиме Preview (), щёлкните по имени проекта. Представление предоставляет доступ к нескольким подпредставлениям, доступным из панели навигации:

• Design – переход и взаимодействие с проектной документацией, просмотр свойств объектов и размещение комментариев для ревью. Представление относится к текущей (последней) ревизии проекта и использует интерфейс Web Viewer.
• Simulation – загрузка файлов результатов моделирования в текущий проект; затем они будут доступны для просмотра или скачивания всем пользователям, имеющим доступ к проекту.
• Tasks – просмотр и взаимодействие с интерфейсом потокового типа, который отображает все Tasks (задания активностей), относящиеся к текущему проекту.
• Releases – просмотр сводной информации по всем Releases для текущего проекта; каждый из них можно открыть в представлении Manufacturing Portal . Оно, в свою очередь, предоставляет подпредставления для файлов пакета релиза, проектной документации и данных по снабжению в выбранном релизе.
• Activities – просмотр активных или закрытых Process workflow Activities, относящихся к текущему проекту.
• History – просмотр развёрнутой временной шкалы основных событий, связанных с проектом, включая его создание, коммиты, релизы и клоны. Каждый раз, когда происходит поддерживаемое событие, связанное с проектом, оно добавляется на шкалу времени в виде отдельной плитки с различными действиями (например, сравнение проектных данных), где это применимо.
• Assembly Assistant – предоставляет доступ к визуальному инструменту сборки платы, основанному на взаимодействии между позициями BOM и их графическими соответствиями. Можно запустить проверяемый пошаговый процесс, который помогает пройти этапы физической сборки PCB. Это даёт отслеживаемое представление прогресса сборки в одном месте и избавляет от сложных ручных или бумажных процедур контроля сборки.

► Подробнее см. Management of a Specific Project.

Редактировать проект

Чтобы отредактировать свойства существующего проекта в Workspace, выберите его запись на странице Designs  (Projects), затем выберите пункт Edit в его меню или в верхнем меню . В следующем окне Project Editing можно изменить Name проекта, Description и управлять записями Workspace Parameters.

Нажмите кнопку в окне Project Editing, чтобы открыть дополнительные данные свойств, полученные из проекта и хранящиеся вместе с ним. Выберите элемент управления Parameters, чтобы получить доступ и добавить (), отредактировать или удалить () пары параметров Имя/Значение. Они сохраняются в Workspace вместе с проектом и могут использоваться как Special Strings в Altium Designer — доступ через панель Properties при выбранном в рабочей области размещённом текстовом объекте. В отличие от этого, параметры типа Project сохраняются в файле проекта (*.PrjPcb) и могут редактироваться в Altium Designer.

Клонировать проект

Чтобы клонировать (дублировать) существующий проект Workspace, выберите его запись на странице Designs (Projects), затем выберите пункт Clone в его меню или в верхнем меню . Используйте окно Clone Project, чтобы задать имя и описание для клонированного проекта — по умолчанию будет использовано исходное имя проекта с суффиксом - Copy.

Нажмите кнопку , чтобы открыть информацию о целевой родительской папке. Настройка целевой папки автоматически будет соответствовать имени проекта, если не задана вручную, либо не назначена в другую существующую родительскую папку через опцию Change.

Проект можно клонировать в Altium Designer через пункт Clone в меню панели Explorer panel, либо щёлкнув правой кнопкой по имени проекта в панели Projects panel и выбрав пункт Clone в контекстном меню.

После задания необходимых полей нажмите кнопку для подтверждения. Исходный проект будет клонирован (дублирован) вместе с входящими в него файлами и данными и добавлен как новая запись проекта в список на странице Projects.

Отслеживать проект

Чтобы «отслеживать» (watch) — получать уведомления о — проекте в Workspace, выберите его запись на странице Designs (Projects), затем выберите пункт Watch в его меню или в верхнем меню .

Когда вы подписываетесь (watch) на проект, вы будете получать уведомления, связанные с проектом (например, сообщения о коммитах, релизах и изменениях свойств), на вкладке Activities в правой панели интерфейса. Создатель проекта автоматически будет подписан на этот проект. При включении команда изменится на Unwatch — выберите её, чтобы прекратить отслеживание проекта и перестать получать уведомления о событиях, связанных с ним.

Удалить проект Workspace

Чтобы удалить (remove) существующий проект Workspace, выберите его запись на странице Designs  (Projects), затем выберите пункт Delete в его меню или в верхнем меню . Действие фактически является «мягким удалением» (soft delete), при котором репозиторий проекта перемещается в область Trash Workspace. Проект можно удалить в Altium Designer, используя пункт Delete в меню панели Explorer panel.

Внутри этого представления (выберите Trash в главном меню) запись проекта можно удалить окончательно (Permanently Delete) или отменить действие (Restore). Обратите внимание: кнопка удалит все записи (где это возможно), которые хранятся в корзине Workspace.