Публикация проекта из Altium Designer

Поскольку суть совместной работы заключается в том, что несколько людей работают вместе для достижения общего результата, одним из ключевых факторов коллаборации является возможность предоставлять и управлять доступом к этому общему элементу — в данном случае к проекту разработки и связанным с ним данным. Workspace предоставляет эту возможность за счет контролируемого, основанного на разрешениях, совместного доступа к проекту — либо в его текущем состоянии «в работе» (WIP), либо в виде фиксированного снимка (snapshot) проекта на конкретный момент времени.

Обратите внимание: вновь созданный проект или проект, опубликованный в Workspace, по умолчанию предоставляется в общий доступ следующим пользователям:

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

В Altium Designer поддерживаются следующие уровни общего доступа:

• Sharing of a live design – сам проект в состоянии «в работе» (WIP), которым можно делиться:
  • С другими участниками команды вашего Workspace — для редактирования и/или просмотра. Приглашенный участник команды может просматривать проект через Altium Designer или через Workspace команды. Редактирование выполняется только через Altium Designer. Приглашенный участник должен быть зарегистрирован в AltiumLive и иметь активную подписку на лицензию Altium Designer.
  • С людьми вне команды вашего Workspace — для просмотра или редактирования по приглашению по email. Эта возможность доступна только при подключении к Altium 365 Workspace. Такой тип общего доступа позволяет приглашенным заинтересованным сторонам просматривать/редактировать (в зависимости от прав) «живой» проект в состоянии WIP, не получая доступа ко всему вашему Workspace или ко всем данным разработки. Приглашенный человек должен быть зарегистрирован в AltiumLive и может получить доступ к общему проекту из своего Altium 365 Personal Space (или из Workspace своей организации, если он доступен) либо открыть проект в Altium Designer.

  Если предоставлен только доступ на просмотр, приглашенная сторона может просматривать и комментировать проект из Altium Designer или через интерфейс Altium 365 Workspace. По мере того как пользователи с правами редактирования вносят изменения в проект и выполняют commit, эти изменения могут просматриваться «вживую» внешними пользователями. Чтобы просматривать общий проект через браузерный интерфейс из любого места, достаточно регистрации в AltiumLive для получения доступа.

  Если приглашенной стороне предоставлены права редактирования, она может открыть проект и редактировать его в Altium Designer — идеально для внешних подрядчиков.

  Обратите внимание: делиться «живыми» WIP-проектами с людьми вне команды вашего Workspace можно при подключении к Altium 365 Workspace, но не при использовании Enterprise Server Workspace. Однако вы можете поделиться снимком (Snapshot) проекта для просмотра и скачивания с человеком вне команды вашего Workspace (см. ниже).

  Altium Designer также предоставляет дополнительные функции, дополняющие совместную работу через общий доступ к проектам Workspace, включая Document Commenting и Collaborators Conflict Prevention.

  При подключении к Altium 365 Workspace, обновленному до новой системы наследования разрешений (learn more), обратите внимание: становится невозможно уменьшить или удалить разрешения для проекта, если эти разрешения наследуются от родительской папки. При попытке сделать это появляется сообщение об ошибке (). Параметр проекта Inherit permissions from parent необходимо отключить в браузерном интерфейсе Workspace, чтобы намеренно разорвать наследование разрешений от родительской папки.

• Sharing of a design 'snapshot' – статический снимок (snapshot) проекта на определенный момент времени, которым можно делиться:

  • По ссылке — доступно любому через браузер. Доступ к общему проекту на этом уровне не требует ни активной подписки для лицензии Altium Designer, ни регистрации в AltiumLive. Получатель общей ссылки открывает Standalone Altium 365 Viewer для просмотра (но без возможности комментирования) проекта. Для просмотра не требуется регистрация в AltiumLive, а ссылка доступна в течение 48 часов.

  • С конкретными людьми — доступно указанным людям по приглашению по email. Доступ к общему проекту на этом уровне требует регистрации в AltiumLive, но не требует активной подписки на лицензию Altium Designer. Получатель получает доступ к снимку проекта через интерфейс Workspace платформы Altium 365 Web Viewer из письма-приглашения. Для просмотра требуется регистрация в AltiumLive, но сам снимок доступен постоянно. Комментирование проекта также доступно.

  Обратите внимание: снимок (Snapshot) проекта, опубликованный таким образом, по сути является доступным только для чтения. Его можно скачать или просматривать в Altium 365 Workspace, но, в отличие от общего WIP-проекта, его нельзя открыть для просмотра/редактирования в Altium Designer.

  Если получатель проекта (или снимка проекта), которым с ним поделились через платформу Altium 365, не имеет учетной записи AltiumLive, ему сначала потребуется зарегистрироваться — ссылка предоставляется на странице Altium 365 Sign In.

Доступ к элементам управления общим доступом

Элементы управления для предоставления доступа к проекту из Altium Designer находятся в диалоговом окне Share, которое можно открыть следующими способами:

• Для активного проекта — нажатием кнопки в правом верхнем углу главного окна приложения или выбором команды Project » Share в главном меню.
• Для проекта, находящегося в фокусе на панели Projects panel, — щелкните правой кнопкой по записи проекта и выберите команду Share в контекстном меню.
• При комментировании документа проекта — путем публикации комментария с упоминанием пользователя, у которого нет доступа к текущему проекту.

Открытие диалогового окна Share — центральной команды для предоставления доступа к проекту из Altium Designer.

Совместный доступ к Live Design

Если проект разработки зарегистрирован в (сделан доступным для) Workspace Altium 365, вы можете поделиться этим проектом с другими людьми. Это могут быть как другие участники вашей команды Workspace, так и люди вне команды. Чтобы поделиться таким образом, щелкните и выберите пункт в левой части диалога Share.

Доступ к элементам управления для предоставления совместного доступа к live/WIP‑проекту. Обратите внимание: на изображении показан случай, когда проект уже доступен в подключенном Workspace.

Используйте элемент управления Copy Link, чтобы скопировать прямую ссылку на проект — ее могут использовать те, у кого уже есть доступ к проекту, чтобы открыть его в Web Viewer Workspace.

Предоставление доступа новым людям

После завершения подготовки, выбора проекта и подключения целевого Workspace можно указать, с каким человеком (или людьми) нужно поделиться проектом. Чтобы проверить, у кого уже есть доступ к проекту, нажмите элемент управления Shared with. Область развернется и покажет, с кем проектом поделились и есть ли у них права на редактирование (Can Edit) либо они могут только просматривать и комментировать проект (Can View).

Проверьте, с кем сейчас поделились проектом, щелкнув поле Share with. Наведите курсор на изображение, чтобы увидеть результат.

Вы можете поделиться проектом с кем угодно — с другими пользователями AltiumLive из вашей организации, с пользователями AltiumLive из других организаций и с пользователями без AltiumLive (которым затем потребуется зарегистрировать учетные записи AltiumLive). Обратите внимание: при подключении к Workspace Enterprise Server вы можете поделиться WIP‑проектом только с зарегистрированными пользователями этого Workspace — для внешнего предоставления доступа см. Sharing a Design Snapshot или подход к предоставлению доступа, доступный в вашем Altium 365 Personal Space.

Чтобы добавить запись, начните вводить нужное имя/электронную почту/роль в поле, чтобы затем выбрать соответствующего пользователя/роль из динамического списка — он будет содержать только отфильтрованных пользователей из вашей команды Workspace или вашей организации, а также существующие роли, определенные для Workspace. Можно выбрать нескольких пользователей/ролей. Чтобы удалить введенного пользователя/роль, нажмите элемент управления , связанный с этой записью.

Задайте права доступа для добавленных людей/ролей в соответствующем раскрывающемся меню, выбрав Can View () или Can Edit (), при этом второй вариант по умолчанию включает возможность просмотра. Настройка изначально применяется ко всем записям (людям/ролям), добавленным в поле. Используйте необязательное поле примечания, чтобы добавить информацию, относящуюся к условиям предоставления доступа к этому проекту.

Дополнительные разрешения на совместный доступ доступны администраторам и владельцу проекта в диалоге Share. Используйте параметры Advanced Settings, чтобы указать права на повторное предоставление доступа и скачивание для пользователей, с которыми будет поделена разработка.

Только те пользователи, которым предоставлен доступ с правами Edit, могут повторно делиться проектом с другими. Дополнительное управление этим доступом доступно в параметрах Who can share the project диалога Sharing Settings:

• Editors in the Workspace – разрешить участникам команды Workspace, имеющим права Edit для общей разработки, повторно делиться ею с другими.
• Editors outside the Workspace – разрешить пользователям вне команды Workspace, имеющим права Edit для общей разработки, повторно делиться ею с другими.

Все пользователи, которым предоставлен доступ с правами Edit, могут скачивать файлы проекта. Для пользователей с правами совместного доступа View (только чтение) возможность скачивания файлов задается параметрами Who can download files диалога:

• Viewers in the Workspace – разрешить участникам команды Workspace, имеющим права View для общей разработки, скачивать файлы разработки.
• Viewers outside the Workspace – разрешить пользователям вне команды Workspace, имеющим права View для общего проекта, скачивать файлы разработки.

При подключении к Workspace Enterprise Server диалог Sharing Settings включает параметры, определяющие права на повторное предоставление доступа и скачивание только для участников Workspace:

• Editors can share – разрешить участникам команды Workspace, имеющим права Edit для общей разработки, повторно делиться ею с другими.
• Viewers can download – разрешить участникам команды Workspace, имеющим права View для общей разработки, скачивать файлы разработки.

После определения получателя(ей) и задания прав доступа нажмите кнопку , чтобы выполнить предоставление доступа к проекту. Диалог покажет сообщение об успешном предоставлении доступа. Далее вы можете нажать элемент управления Who has access, чтобы вернуться к списку пользователей, имеющих доступ к проекту, нажать кнопку  для копирования прямой ссылки на проект или просто закрыть диалог, нажав OK.

Предоставление доступа пользователю вне команды

Если вы попытаетесь поделиться проектом Workspace Altium 365 с человеком вне команды, появится диалог Confirm с предупреждением о том, что пользователь получит доступ к исходным документам передаваемого проекта, оставленным комментариям и пакетам релизов. Нажмите OK , чтобы продолжить предоставление доступа к проекту.

Вы можете поделиться проектом с любым человеком вне команды Workspace — для редактирования или просмотра.

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

Если вы делитесь локальным проектом (не находящимся под внешней VCS), проект станет доступен в текущем подключенном Workspace в момент, когда вы поделитесь проектом с указанными людьми. Что именно произойдет, зависит от того, делитесь ли вы для просмотра или для редактирования:

• При предоставлении доступа только для просмотра (и при подключении к Workspace Altium 365) — проект становится доступен через Simple Sync. В этом режиме проект разработки может редактировать только один человек (владелец проекта). Сильная сторона Simple Sync проявляется, когда вы не хотите, чтобы кто-либо еще редактировал вашу разработку, но при этом хотите воспользоваться парадигмой Global Sharing Altium 365 и иметь возможность делиться этой разработкой с несколькими людьми для просмотра и комментирования. Подробнее об этой функциональности см. Mirroring a Project in the Workspace Using Simple Sync.
• При предоставлении доступа для редактирования — проект необходимо добавить в Git‑репозиторий проектов разработки Workspace Versioned Storage. В этом режиме проектом можно поделиться с несколькими людьми для редактирования, а также использовать поддержку Global Sharing в Altium 365 для совместного просмотра и комментирования. Появится диалог, который уведомит вас об этом и предложит вариант Use Altium 365 VCS выполнить добавление. Нажмите Learn More , чтобы перейти на страницу Sharing, которая поможет пройти процесс предоставления доступа к проекту.

При предоставлении доступа к локальному проекту (не под VCS) человеку для редактирования проект нужно будет перевести под контроль версий, добавив его в Git‑репозиторий проектов разработки Workspace Versioned Storage.

Результат предоставления доступа

Дальнейшие действия зависят от типа приглашаемого пользователя:

• Пользователь, который уже входит в вашу команду Workspace, будет напрямую добавлен в список доступа к проекту и получит email‑уведомление о том, что проект ему предоставлен. Он сможет открыть проект в Altium Designer или получить к нему доступ через интерфейс Workspace (со страницы Projects ).
• Если добавляется существующая роль Workspace, она появится в списке доступа к проекту, а все участники этой роли получат email‑уведомление о том, что проект им предоставлен. Они смогут открыть проект в Altium Designer или получить к нему доступ через интерфейс Workspace (со страницы Projects ).

• При использовании Workspace Altium 365 для предоставления доступа человеку вне команды Workspace он будет добавлен в список предоставления доступа и получит email‑уведомление о том, что проект ему предоставлен. Он сможет открыть проект в Altium Designer через опцию Shared with Me option или получить к нему доступ через свой Altium 365 Platform Personal Space Interface (со страницы Shared with Me ). Полученное письмо предоставляет прямой доступ к проекту через Altium 365. После нажатия кнопки в письме пользователь будет перенаправлен на страницу Altium 365 Sign In (если он уже не вошел в платформу или в свою учетную запись AltiumLive). После входа он будет сразу перенаправлен в Web Viewer с загруженным общим проектом.

  Нельзя предоставить доступ к WIP‑проекту вне команды (внешним пользователям) при подключении к Workspace на базе Enterprise Server. Однако:

  • Для внешнего предоставления доступа из Workspace на базе Enterprise Server см. Sharing a Design Snapshot.
  • Также вы можете upload a design для предоставления доступа в свой Altium 365 Personal Space. После предоставления доступа другому пользователю с учетной записью AltiumLive он сможет получить доступ к проекту как через Altium Designer (Shared with Me), так и через Web Viewer, доступный в его собственном Personal Space.

Доступ к общему live‑проекту из email‑приглашения, полученного пользователем, который не является участником команды Workspace.

Изменение прав доступа для уже добавленных пользователей

В любой момент администратор (или участник команды Workspace с правами редактирования) может изменить существующие разрешения доступа к проекту. Чтобы открыть список уже добавленных людей и ролей для проекта, нажмите пункт слева в диалоге Share , затем раскройте поле Shared with справа.

Открытие списка людей и ролей, которые в данный момент имеют общий доступ к проекту.

Что важно учитывать:

• С точки зрения разрешений человек/роль получает полный доступ на редактирование проекта, когда выбрана опция Can Edit (). В противном случае у него доступ только на просмотр ().
• Роли Owner и Administrators всегда имеют полный доступ на редактирование (Can Edit).

• За исключением ролей Owner и Administrators, разрешения для всех включенных людей/ролей можно задавать индивидуально как Can View или Can Edit, либо полностью удалять права доступа. Также владение проектом можно передать другому пользователю (см. ниже). Нажмите на текущее состояние разрешений, чтобы открыть элементы управления.

  

• Проект можно явно предоставить конкретным людям и/или ролям либо просто предоставить всем участникам команды Workspace. Для второго варианта задайте требуемый доступ для записи Workspace Members . Чтобы не предоставлять проект всей команде, установите для этой записи значение None.

Внесите необходимые изменения в разрешения доступа. Каждая измененная сущность подсвечивается в списке более темным фоном.

Пример изменений разрешений для двух существующих пользователей, которым в данный момент предоставлен доступ к проекту.

Чтобы применить изменения, нажмите кнопку . Изменения будут применены, а подтверждение отобразится в диалоге. Чтобы увидеть обновленный список общего доступа, нажмите ссылку Who has access.

После сохранения изменений разрешений вы можете просмотреть обновленный результат прямо в диалоге Share.

Передача владения проектом

Администраторы и владельцы могут передать владение другому пользователю, используя опцию Owner  в выпадающем списке текущего состояния разрешений. Опцию может использовать текущий владелец проекта или администратор Workspace.

При выборе для пользователя опции Owner откроется диалог Transfer Ownership. Нажмите Yes, чтобы выполнить операцию.

Изменения разрешений для текущего владельца и получателя владения будут отражены в диалоге. Нажмите Save, чтобы продолжить применение изменений.

Пользователь, которому передано владение, получит email‑уведомление.

Доступ к общему live‑проекту

Доступ к проекту, которым поделились с пользователем, зависит от того, является ли этот пользователь участником команды Workspace или находится вне команды Workspace.

Участник команды Workspace

Для участника команды Workspace доступ к общему проекту возможен через Altium Designer или через страницу Projects в интерфейсе Workspace. Обратите внимание: редактирование проекта — при наличии прав редактирования — возможно только через Altium Designer.

В Altium Designer откройте доступ к проекту с помощью команды File » Open Project или кнопки с многоточием, связанной с записью Workspace в панели Projects panel. Появится диалог Open Project dialog, где можно выбрать, какой проект Workspace открыть из подключенного Workspace — при подключении Workspace он будет отображаться в области Locations диалога, отличаясь значком и отображаясь с именем, заданным для Workspace. В списке будут показаны только те проекты Workspace, которые были предоставлены вам (и к которым у вас есть права доступа).

После открытия проект появится под записью Workspace в панели Projects panel.

Выберите, какой проект Workspace открыть из подключенного Workspace в Altium Designer, из тех, к которым вам сейчас предоставлен доступ.

Вы можете открыть проект в путь checkout по умолчанию или использовать выпадающее меню , чтобы указать пользовательский путь. Путь checkout по умолчанию берется из поля Document Path на странице System – Default Locations page диалога Preferences.

При просмотре проекта через панель Explorer panel в Altium Designer — настроенную в режиме по умолчанию Project View, а не Classic View — нажмите кнопку в правом верхнем углу панели, чтобы открыть проект в Altium Designer (добавив его в панель Projects). Используйте кнопку , чтобы открыть проект для просмотра в браузерном интерфейсе подключенных Workspaces.

Приглашенный участник вне команды Workspace

Для человека вне команды Workspace Altium 365, которому предоставлен доступ к проекту, доступ возможен через Altium Designer или через интерфейс платформы Altium 365 (со страницы Shared with Me page). Чтобы открыть проект, выберите плитку проекта и нажмите имя проекта или выберите опцию Open в меню с многоточием на плитке. Либо дважды щелкните по плитке. Обратите внимание: редактирование проекта — при наличии прав редактирования — возможно только через Altium Designer.

В Altium Designer получите доступ к проекту с помощью команды File » Open Project. Появится диалог Open Project dialog, где можно выбрать, какой проект Workspace открыть из расположения Shared With Me.

После открытия проект появится в разделе Shared with me на панели Projects panel. То, что вы сможете делать с проектом, зависит от предоставленных вам прав доступа. Если вам назначены права на редактирование, вы сможете редактировать проект как обычно — что, как правило, и бывает в случае внешнего подрядчика: поскольку проект расшаривается из Workspace, изменения в проекте синхронизируются в обоих направлениях. Если же у вас только права на просмотр, вы всё равно сможете оставлять комментарии к WIP‑версии проекта.

Выберите, какой проект Workspace открыть в Altium Designer, из тех, которые в данный момент расшарены вам как внешнему участнику. Обратите внимание: доступ к таким проектам предоставляется без доступа к самому Workspace.

У вас есть возможность открыть проект в путь checkout по умолчанию или использовать раскрывающееся меню , чтобы указать пользовательский путь. Путь checkout по умолчанию берётся из поля Document Path на странице System – Default Locations page диалога Preferences.

Публикация снимка проекта (Design Snapshot)

Создание снимка проекта в режиме «только чтение» позволяет быстро поделиться проектом — в конкретный момент времени в ходе разработки — для более широкого взаимодействия с другими через Web. Это может быть полезно для оперативного ревью проекта, публикации определённой вехи разработки или даже для стимулирования контекстного обсуждения. Чтобы поделиться таким образом, щёлкните, чтобы выбрать пункт в левой части диалога Share.

Доступ к элементам управления для публикации снимка проекта.

Публикация по ссылке

По умолчанию в диалоге выбран режим Share By Link, то есть любой, кому вы передадите ссылку, сможет просматривать снимок проекта в браузере в течение ограниченного времени — 48 часов. Комментирование проекта при таком уровне публикации недоступно.

Нажмите кнопку , чтобы сгенерировать ссылку на снимок проекта. В фоновом режиме сам проект упаковывается в Zip‑архив с помощью Project Packager в Altium Designer. Когда ссылка будет готова, нажмите кнопку , чтобы скопировать её, а затем при необходимости отправьте нужным людям.

Генерация ограниченной по времени ссылки, которой можно поделиться с кем угодно и где угодно.

Когда получатель откроет ссылку в браузере, он попадёт в экземпляр Altium 365 Viewer — на основном сайте altium.com site — где проект будет обработан и загружен.

Используя общую ссылку, получатель может просматривать снимок проекта в Altium 365 Viewer, загруженном на основном сайте altium.com. Здесь показана схема — наведите курсор на изображение, чтобы увидеть PCB.

Публикация для конкретных людей

Нажатие элемента управления Share with specific people переключит режим публикации (для снимка проекта), позволяя поделиться им с одним или несколькими конкретными людьми — через приглашение по email. Получатели смогут просматривать, делиться или скачивать снимок проекта через браузерный интерфейс Altium 365 Platform Interface. Такой снимок проекта доступен на платформе постоянно, и при этом уровне публикации возможно комментирование проекта.

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

Введите полный email человека, с которым вы хотите поделиться снимком, и нажмите Enter. При необходимости таким образом можно указать нескольких людей. Также можно добавить необязательное примечание — чтобы сообщить им любую важную информацию об этом конкретном публикуемом снимке.

Пример публикации снимка проекта для конкретного человека по email.

Когда всё готово, нажмите кнопку . Сам проект упаковывается в Zip‑архив с помощью Project Packager в Altium Designer, затем загружается на платформу Altium 365. После завершения процесса будет показано подтверждение загрузки.

Опубликованный снимок упаковывается и затем загружается на платформу Altium 365, где доступен на постоянной основе.

Человек, с которым вы поделились загруженным снимком проекта, получит email‑приглашение для доступа к этому снимку через Altium 365. После нажатия кнопки в письме он будет перенаправлен на страницу Altium 365 Sign In (если он ещё не вошёл на платформу или в свой аккаунт AltiumLive). После входа он попадёт в Web Viewer с загруженным общим снимком проекта.

Доступ к снимку проекта из email‑приглашения, полученного пользователем, с которым поделились снимком.

Доступ к опубликованному снимку проекта

Помимо перехода по ссылке из email‑приглашения, человек, с которым был расшарен постоянный снимок проекта, сможет в любое время получить доступ (открыть, поделиться и просмотреть) к этому снимку со страницы Shared with Me в Altium 365 Platform Interface. Снимок проекта обозначается значком на его плитке.

Чтобы открыть во встроенном Viewer, выберите плитку проекта и щёлкните по имени проекта или выберите пункт Open в меню многоточия на плитке. Либо дважды щёлкните непосредственно по плитке. Обратите внимание: общий снимок проекта нельзя редактировать, поэтому он недоступен в Altium Designer через раздел Shared With Me в диалоге Open Project dialog — однако его можно скачать, если он был расшарен с включённым разрешением на скачивание.

Доступ к снимку проекта со страницы Shared with Me в Altium 365 Platform Interface. В этом примере в общем проекте размещён комментарий.

Отключение публикации

Чтобы полностью отключить публикацию, снимите флажок Altium Cloud на странице System – Network Activity page диалога Preferences. Если вы попытаетесь поделиться проектом через диалог Share — в режиме live или как снимком — появится диалог предупреждения, сообщающий, что эта опция отключена.

Отключение подключения к Altium Cloud предотвратит публикацию проектных данных.

Поддержка Design Reviews

Диалог Share позволяет просмотреть список экземпляров design review для проекта.

Выберите соответствующий пункт в левой части диалога Share. Когда выбран пункт , в правой части диалога отображаются экземпляры design review проекта, находящиеся в состоянии In Progress. Каждый экземпляр представлен следующими данными:

• Имя экземпляра. Щёлкните ссылку, чтобы открыть экземпляр в браузерном интерфейсе Altium 365.

• Описание.

• Временная метка commit/release, для которой создан экземпляр design review.

• Инициатор и временная метка создания экземпляра.

Если у проекта нет экземпляров в состоянии In Progress, в правом нижнем углу диалога доступна кнопка . Нажмите её, чтобы закрыть диалог и открыть в браузере страницу для нового экземпляра design review.