Working with Publishing Destinations

Пункты назначения публикации (Publishing Destinations) дают возможность публиковать данные релиза для ревизии элемента данных изготовления печатной платы (PCB Fabrication Data Item), элемента данных сборки печатной платы (PCB Assembly Data Item) или элемента проектирования PCB (PCB Project Design Item) напрямую из Workspace либо из Output Job в хранилище — например, Box.com, Amazon S3, FTP‑сервер или просто папку в общей сетевой локации. Это позволяет безопасно размещать сгенерированные данные релиза и при этом предоставлять к ним доступ в глобальном масштабе. От производственной площадки в Китае до команд разработчиков в Киеве, Стэнстед-Эбботтс и Сан-Диего, и до руководителя проекта, который постоянно летает между всеми ними, географически распределённая «Product Team», совместно отвечающая за превращение идеи в физический продукт, получает общий (и контролируемый) доступ для просмотра, обсуждения и использования данных, необходимых для изготовления элемента.

Определение пунктов назначения публикации

Прежде чем рассматривать, как фактически публикуются данные релиза для ревизии поддерживаемого типа элемента, сначала нужно определить параметры — то есть настроить, где эти данные будут храниться. Это выполняется на странице Data Management – Publishing Destinations page в диалоге Preferences (нажмите элемент управления в правом верхнем углу основного окна проектирования).

Пункты назначения публикации задаются в настройках Altium Designer.

Для каждого определённого пункта назначения публикации отображается следующая информация:

• Name – понятное имя пункта назначения. Оно может, например, отражать данные, которые будут публиковаться в этот пункт назначения.

• Type – тип пункта назначения публикации. Можно определить следующие типы:

  • Amazon S3 – Simple Storage Services, размещённые в Amazon AWS.
  • Box.com – пункт назначения публикации, размещённый в Box.com.
  • Folder – простая структура папок, например в общей сетевой папке.
  • FTP – для выгрузки на FTP‑сервер хранения или в расположение на вашем веб‑сайте.
• Status – успешность соединения между Altium Designer и пунктом назначения публикации () или его отсутствие (). Если соединение не установлено, будет показан комментарий с указанием проблемы.

Добавление нового пункта назначения публикации Amazon S3

Чтобы добавить новый пункт назначения публикации, размещённый в Amazon Simple Storage Services (S3), нажмите кнопку и выберите Amazon S3 в соответствующем меню — появится диалог Add Amazon S3 Publishing Destination.

Настройте подключение к пункту назначения публикации Amazon S3.

Задайте пункт назначения следующим образом:

1. Укажите для пункта назначения понятное Name.
2. Введите учётные данные вашей учётной записи Amazon Web Services. Вам потребуется существующая учётная запись Amazon Web Services. Если её ещё нет, зарегистрируйтесь на aws.amazon.com. В процессе настройки учётной записи вы создадите 20‑символьный Access Key ID (или публичный ключ) и соответствующий 40‑символьный Secret Access Key (или приватный ключ). У вас может быть несколько таких пар ключей. Как следует из названия, Secret Access Key должен храниться в безопасности и быть известен только вам и Amazon Web Services.
3. Укажите имя bucket’а, в котором будут храниться опубликованные файлы. Bucket’ы можно создавать с помощью таких инструментов, как AWS Management Console. При необходимости можно указать подпапку внутри bucket’а для хранения файлов. Введите путь в поле Key Prefix или нажмите кнопку , чтобы просмотреть и выбрать папку.
4. При необходимости задайте additional publishing options.
5. Чтобы вручную проверить соединение, нажмите кнопку . Однако это не обязательно, поскольку соединение будет автоматически проверено, когда вы нажмёте OK.
6. Нажмите OK.

Будет установлено соединение из Altium Designer, и для него появится запись в списке пунктов назначения публикации на странице Data Management – Publishing Destinations page диалога Preferences.

Добавление нового пункта назначения публикации Box.com

Чтобы добавить новый пункт назначения публикации, структура папок которого будет находиться в вашем облачном Box (размещённом на Box.com), нажмите кнопку и выберите Box.com в соответствующем меню — появится диалог Add Box.com Publishing Destination.

Настройте подключение к пункту назначения публикации Box.com.

Задайте пункт назначения следующим образом:

1. Укажите для пункта назначения понятное Name.

2. Активируйте вашу учётную запись Box.com. Этот процесс позволяет Altium Designer получить доступ к вашему Box. Чтобы активировать учётную запись Box.com в первый раз:

   1. Нажмите кнопку в области Box.com Account диалога. Появится диалог Activate Box.com Account, предлагающий войти в учётную запись.

      
      Войдите в вашу учётную запись Box.com в диалоге Activate Box.com Account

   2. Введите учётные данные Box.com, затем нажмите Authorize.

   3. После успешного входа в Box нажмите кнопку Grant access to Box, чтобы разрешить приложению AltiumBoxApplication доступ к Box на чтение/запись.

      
      После входа предоставьте AltiumBoxApplication доступ к Box

   4. Вы автоматически вернётесь в диалог Add Box.com Publishing Destination. Теперь диалог будет показывать, что ваша учётная запись активирована.

      
      Диалог Add Box.com Publishing Destination, отображающий учётную запись Box.com как активированную

      Если учётная запись Box.com уже активировалась ранее, можно просто ввести ключ активации (если вы скопировали его при первой активации). Для этого нажмите кнопку и введите код активации в появившемся диалоге Box.com Activation Key dialog. Если вы потеряли исходный ключ активации, не знаете его или хотите получить новый ключ, можно просто выполнить активацию повторно. Учётная запись будет активирована с новым ключом, а старый ключ станет недействительным.
      Если вам нужно получать доступ к вашей учётной записи Box с нескольких компьютеров или требуется подключаться к нескольким папкам публикации в рамках одной и той же учётной записи Box, это можно сделать, скопировав и используя ключ активации Box.com. Для этого нажмите кнопку и скопируйте ключ из появившегося диалога Box.com Activation Key .

3. Укажите место хранения опубликованных данных — существующую или новую папку в вашем Box — с помощью поля Folder в области Location диалога. Используйте кнопку , чтобы открыть диалог Choose the Destination Root Folder, где можно просмотреть все текущие папки в Box, либо нажмите , чтобы создать новую. Выберите нужную папку и нажмите OK.

   

4. При необходимости задайте additional publishing options.
5. Нажмите OK.

Будет установлено соединение из Altium Designer с указанной папкой, и для него появится запись в списке пунктов назначения публикации на странице Data Management – Publishing Destinations page диалога Preferences.

Добавление нового пункта назначения публикации «Папка»

Чтобы добавить новый пункт назначения публикации на основе локальной папки, нажмите кнопку и выберите Folder в соответствующем меню — появится диалог Add Folder Publishing Destination.

Настройте подключение к пункту назначения публикации «папка».

Задайте пункт назначения следующим образом:

1. Укажите для пункта назначения понятное Name.
2. Укажите расположение корневой папки. Либо введите путь к папке напрямую в поле Folder, либо нажмите значок , чтобы открыть диалог Browse For Folder, где можно выбрать существующую локальную или сетевую папку либо создать новую — при необходимости.
3. При необходимости задайте additional publishing options.
4. Нажмите OK.

Будет установлено соединение из Altium Designer с указанной папкой, и для него появится запись в списке пунктов назначения публикации на странице Data Management – Publishing Destinations page диалога Preferences.

Добавление нового пункта назначения публикации FTP

Чтобы добавить новый пункт назначения публикации, размещённый на FTP‑сервере, нажмите кнопку и выберите FTP в соответствующем меню — появится диалог Add FTP Publishing Destination.

Настройте подключение к FTP‑серверу.

Задайте пункт назначения следующим образом:

1. Введите учётные данные вашей FTP‑учётной записи.

   1. Введите Server Name — это может быть IP‑адрес (например, 123.45.1.1), доменное имя (например, myserver.com) или имя хоста, если сервер находится в вашей локальной сети (например, myserver).
   2. Введите User Name и Password, чтобы войти на FTP‑сервер.
2. Укажите для пункта назначения понятное Name.
3. При необходимости укажите каталог на вашем FTP-сервере для хранения опубликованных данных. Введите путь напрямую в поле Directory или нажмите кнопку , чтобы найти и выбрать папку.
4. При необходимости задайте дополнительные параметры публикации.
5. Чтобы вручную проверить соединение, нажмите кнопку . Однако это не обязательно, поскольку соединение будет автоматически проверено, когда вы нажмете OK.
6. Нажмите OK.

Будет установлено соединение с указанной папкой из Altium Designer, и для нее появится запись в списке назначений публикации на странице Data Management – Publishing Destinations page диалогового окна Preferences.

Редактирование подключения к назначению публикации

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

Удаление назначения публикации

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

Дополнительные параметры публикации

При определении назначения публикации доступны следующие дополнительные параметры (где применимо):

• Zip Contents — включите этот параметр, чтобы перед публикацией сжать данные в zip-архив. При необходимости zip-архив также можно защитить паролем. Этот параметр доступен для всех типов назначений публикации.
• Present Contents in a HTML page — включите этот параметр, чтобы сформировать HTML-страницу индекса со списком содержимого опубликованных данных и упростить навигацию по файлам в веб-браузере. Этот параметр доступен для типов назначений публикации Amazon S3, Folder и FTP.

Пример HTML-страницы со списком содержимого опубликованных данных.

Публикация данных

После того как назначения публикации определены должным образом, вы можете публиковать данные релиза для проекта платы либо из подробного представления Item view, либо из панели Explorer panel, либо из файла OutputJob file:

• В представлении Item выберите конкретную ревизию элемента (Item), для которой вы хотите опубликовать документы. Команды публикации доступны в контекстном меню (правый щелчок) для области Released Documents. Хотя вы можете опубликовать just Released Documents, также доступна команда для публикации всех документов (выпущенных плюс System BOM) одним действием.

  Чтобы открыть представление Item, найдите нужный Item в панели Explorer, щелкните по нему правой кнопкой мыши и выберите History в контекстном меню.

  Подменю публикации перечисляет все доступные назначения публикации по имени, как они определены на странице Data Management – Publishing Destinations page диалогового окна Preferences.

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

• В панели Explorer переключитесь на представление Classic проекта ( – Classic View), выберите конкретную ревизию PCB Fabrication Data, PCB Assembly Data или PCB Project Design Item, для которой вы хотите опубликовать документы, и убедитесь, что активна вкладка представления аспектов Preview. Команды публикации доступны в контекстном меню (правый щелчок) для области Released Documents. Аналогично, хотя вы можете опубликовать just Released Documents, также доступна команда для публикации всех документов (выпущенных плюс System BOM) одним действием.

  Подменю публикации перечисляет все доступные назначения публикации по имени, как они определены на странице Data Management – Publishing Destinations page диалогового окна Preferences.

  
  Доступ к командам, связанным с публикацией, для конкретной ревизии Item из панели Explorer.

• В файле Output Job нажмите элемент управления Generate and publish для нужного Output Container, чтобы получить доступ к командам публикации.

  Хотя публикация в заданное назначение публикации возможна напрямую из файла Output Job Configuration, рекомендуется публиковать данные только после их выпуска (release) на управляемый сервер контента, тем самым используя данные, целостность которых гарантирована, поскольку они прошли строгую проверку и защиту процесса выпуска проекта.

  
  Доступ к командам публикации из файла OutJob.

В каждом случае используйте последующее диалоговое окно Publish to, чтобы задать требуемую подпапку назначения, в которой будут храниться данные. Для назначения публикации Box, если вы делитесь опубликованными данными с другими, вы также можете ввести их адреса электронной почты, разделяя запятыми, в соответствующее текстовое поле диалогового окна Publish to Box.

Четыре варианта диалогового окна Publish to Folder

После публикации при необходимости (и если это еще не сделано) задайте права доступа для папки, FTP-сайта или области Amazon S3, затем сообщите нужным людям о доступности данных. Для назначения публикации Box определите — по электронной почте — с кем поделиться опубликованными данными, в момент публикации (в диалоговом окне Publish to).

Глобальный обмен данными производственного пакета

Ключевой аспект проектов, хранящихся в Workspace Altium 365, — возможность создать релиз Build Package и поделиться им с другими. При прямом предоставлении вашему производителю это можно рассматривать как Manufacturing Package, поскольку именно этот пакет производитель может просматривать, скачивать и использовать для изготовления и сборки платы.

Для поддержки возможности делиться таким пакетом с другими и с вашим производителем (который обычно находится вне вашей организации) платформа Altium 365 предоставляет специализированный Manufacturing Package Viewer — элемент поддержки Global Sharing платформы — который позволяет другим просматривать производственный пакет из любого веб-браузера — в любой точке мира — но вне вашего Workspace, чтобы сами проекты и другая ценная интеллектуальная собственность оставались недоступными.

Каждый пользователь, с которым вы поделились, получит приглашение по электронной почте со ссылкой для просмотра производственного пакета через Manufacturing Package Viewer. Общие производственные пакеты представлены на странице Shared with Me в браузерном интерфейсе платформы Altium 365.

Manufacturing Package Viewer позволяет ключевым участникам — и прежде всего производственному персоналу — видеть сводный обзор проекта с ключевыми данными платы, а также просматривать структуру исходных данных, данных для изготовления и сборки (и при необходимости скачивать любой отдельный файл). Также предусмотрены подстраницы просмотра для данных Fabrication, Assembly и BOM; при этом на странице Fabrication доступен Gerber Viewer и возможность добавлять комментарии всеми пользователями, которым был предоставлен доступ к пакету.

В итоге производственный персонал может скачать Build Package просмотренного релиза — с любой страницы Viewer — чтобы реализовать эту ревизию платы физически.

Производственный пакет, которым с вами поделились, доступен на странице Shared with Me. Человек, с которым вы поделились производственным пакетом, получит приглашение по электронной почте для доступа к этому пакету через Altium 365. После нажатия кнопки в письме он будет перенаправлен на страницу Altium 365 Sign In (если он уже не вошел в платформу или в свою учетную запись AltiumLive). После входа он попадет в Manufacturing Package Viewer с загруженным пакетом. Если у человека нет учетной записи AltiumLive, ему сначала нужно будет зарегистрировать ее — ссылка доступна на странице Altium 365 Sign In.