Working with Publishing Destinations

Miejsca publikacji umożliwiają publikowanie danych wydania dla rewizji elementu danych produkcyjnych PCB (PCB Fabrication Data Item), elementu danych montażowych PCB (PCB Assembly Data Item) lub elementu projektu PCB (PCB Project Design Item) bezpośrednio z Workspace albo z Output Job do przestrzeni magazynowej – takiej jak Box.com, Amazon S3, serwer FTP lub po prostu lokalizacja folderu w sieci współdzielonej. Pozwala to bezpiecznie hostować wygenerowane dane wydania, zapewniając jednocześnie dostęp do nich w skali globalnej. Od zakładu produkcyjnego w Chinach, przez zespoły projektowe w Kijowie, Stanstead Abbotts i San Diego, aż po dyrektora projektu latającego między tymi miejscami – rozproszony geograficznie „Zespół Produktowy”, wspólnie odpowiedzialny za doprowadzenie produktu od pomysłu do fizycznej realizacji, ma współdzielony (i kontrolowany) dostęp do przeglądania, omawiania i wykorzystywania danych potrzebnych do zbudowania elementu.

Definiowanie miejsc publikacji

Zanim przyjrzymy się, jak faktycznie publikowane są dane wydania dla rewizji obsługiwanego typu elementu, należy najpierw zdefiniować opcje określające, gdzie te dane mają być przechowywane. Wykonuje się to na stronie Data Management – Publishing Destinations page w oknie dialogowym Preferences (kliknij kontrolkę w prawym górnym rogu głównego okna projektu).

Miejsca publikacji są określane jako część preferencji Altium Designer.

Dla każdego zdefiniowanego miejsca publikacji prezentowane są następujące informacje:

• Name – znacząca nazwa miejsca docelowego. Może ona na przykład odzwierciedlać dane, które będą publikowane do tego miejsca.

• Type – typ miejsca publikacji. Można zdefiniować następujące typy miejsc docelowych:

  • Amazon S3 – Simple Storage Services hostowane przez Amazon AWS.
  • Box.com – miejsce publikacji hostowane przez Box.com.
  • Folder – prosta struktura folderów, na przykład w sieci współdzielonej.
  • FTP – do wysyłania na serwer FTP lub do lokalizacji w Twojej witrynie internetowej.
• Status – informacja, czy połączenie między Altium Designer a miejscem publikacji jest poprawne () czy nie (). Jeśli połączenie jest nieudane, zostanie wyświetlony komentarz wskazujący problem.

Dodawanie nowego miejsca publikacji Amazon S3

Aby dodać nowe miejsce publikacji hostowane przez Amazon Simple Storage Services (S3), kliknij przycisk i wybierz Amazon S3 z powiązanego menu – pojawi się okno dialogowe Add Amazon S3 Publishing Destination.

Zdefiniuj połączenie z miejscem publikacji Amazon S3.

Zdefiniuj miejsce docelowe w następujący sposób:

1. Nadaj miejscu docelowemu znaczącą Name.
2. Wprowadź dane uwierzytelniające konta Amazon Web Services. Musisz mieć istniejące konto Amazon Web Services. Jeśli jeszcze go nie masz, zarejestruj się na aws.amazon.com. Podczas konfiguracji konta utworzysz 20-znakowy Access Key ID (klucz publiczny) oraz odpowiadający mu 40-znakowy Secret Access Key (klucz prywatny). Możesz mieć więcej niż jedną taką parę kluczy. Jak wskazuje nazwa, Secret Access Key powinien być przechowywany w bezpieczny sposób i znany wyłącznie Tobie oraz Amazon Web Services.
3. Podaj nazwę bucketu, w którym będą przechowywane opublikowane pliki. Buckety można tworzyć za pomocą narzędzi takich jak AWS Management Console. Opcjonalnie możesz wskazać podfolder w buckecie, w którym będą zapisywane pliki. Wpisz ścieżkę w polu Key Prefix lub kliknij przycisk , aby przeglądać i wybrać folder.
4. Zdefiniuj dodatkowe opcje publikowania zgodnie z potrzebami.
5. Aby ręcznie przetestować połączenie, kliknij przycisk . Nie jest to jednak wymagane, ponieważ połączenie zostanie automatycznie przetestowane po kliknięciu OK.
6. Kliknij OK.

Zostanie nawiązane połączenie z Altium Designer i pojawi się dla niego wpis na liście miejsc publikacji, z powrotem na stronie Data Management – Publishing Destinations page w oknie dialogowym Preferences.

Dodawanie nowego miejsca publikacji Box.com

Aby dodać nowe miejsce publikacji, którego struktura folderów będzie znajdować się w Twoim chmurowym Box (hostowanym przez Box.com), kliknij przycisk i wybierz Box.com z powiązanego menu – pojawi się okno dialogowe Add Box.com Publishing Destination.

Zdefiniuj połączenie z miejscem publikacji Box.com.

Zdefiniuj miejsce docelowe w następujący sposób:

1. Nadaj miejscu docelowemu znaczącą Name.

2. Aktywuj swoje konto Box.com. Ten proces umożliwia Altium Designer dostęp do Twojego Box. Aby aktywować konto Box.com po raz pierwszy:

   1. Kliknij przycisk w obszarze Box.com Account okna dialogowego. Pojawi się okno dialogowe Activate Box.com Account, które poprosi o zalogowanie się do konta.

      
      Zaloguj się do konta Box.com w oknie dialogowym Activate Box.com Account

   2. Wprowadź dane logowania do Box.com, a następnie kliknij Authorize.

   3. Po pomyślnym zalogowaniu do Box kliknij przycisk Grant access to Box, aby zezwolić aplikacji AltiumBoxApplication na dostęp do Box w trybie odczytu/zapisu.Po zalogowaniu przyznaj aplikacji AltiumBoxApplication dostęp do Box

   4. Zostaniesz automatycznie przeniesiony z powrotem do okna dialogowego Add Box.com Publishing Destination. Okno będzie teraz wskazywać, że Twoje konto jest aktywowane.

      
      Okno dialogowe Add Box.com Publishing Destination pokazujące aktywowane konto Box.com

      Jeśli konto Box.com było wcześniej aktywowane, możesz po prostu wprowadzić klucz aktywacyjny (jeśli skopiowałeś go podczas pierwszej aktywacji konta). Aby to zrobić, kliknij przycisk i wprowadź kod aktywacyjny w oknie Box.com Activation Key dialog, które się pojawi. Jeśli utraciłeś oryginalny klucz aktywacyjny, nie znasz go lub chcesz uzyskać nowy klucz, możesz po prostu aktywować ponownie. Konto zostanie aktywowane z nowym kluczem, a stary klucz zostanie unieważniony.
      Jeśli musisz uzyskać dostęp do konta Box z wielu komputerów lub chcesz łączyć się z wieloma folderami publikacji w ramach tego samego konta Box, możesz to zrobić, kopiując i używając klucza aktywacyjnego Box.com. W tym celu kliknij przycisk i skopiuj klucz z okna dialogowego Box.com Activation Key , które się pojawi.

3. Określ lokalizację przechowywania opublikowanych danych – istniejący lub nowy folder w Twoim Box – używając pola Folder w obszarze Location okna dialogowego. Użyj przycisku , aby otworzyć okno dialogowe Choose the Destination Root Folder, w którym możesz przeglądać wszystkie aktualnie zdefiniowane foldery w Box lub kliknąć , aby utworzyć nowy. Wybierz wymagany folder i kliknij OK.

   

4. Zdefiniuj dodatkowe opcje publikowania zgodnie z potrzebami.
5. Kliknij OK.

Zostanie nawiązane połączenie z wybranym folderem z poziomu Altium Designer i pojawi się dla niego wpis na liście miejsc publikacji, z powrotem na stronie Data Management – Publishing Destinations page w oknie dialogowym Preferences.

Dodawanie nowego miejsca publikacji Folder

Aby dodać nowe miejsce publikacji oparte na lokalnym folderze, kliknij przycisk i wybierz Folder z powiązanego menu – pojawi się okno dialogowe Add Folder Publishing Destination.

Zdefiniuj połączenie z miejscem publikacji typu folder.

Zdefiniuj miejsce docelowe w następujący sposób:

1. Nadaj miejscu docelowemu znaczącą Name.
2. Określ lokalizację folderu głównego. Wpisz lokalizację folderu bezpośrednio w polu Folder albo kliknij ikonę , aby otworzyć okno dialogowe Browse For Folder, w którym możesz wyszukać istniejący folder lokalny lub sieciowy albo utworzyć nowy – zgodnie z potrzebami.
3. Zdefiniuj dodatkowe opcje publikowania zgodnie z potrzebami.
4. Kliknij OK.

Zostanie nawiązane połączenie z wybranym folderem z poziomu Altium Designer i pojawi się dla niego wpis na liście miejsc publikacji, z powrotem na stronie Data Management – Publishing Destinations page w oknie dialogowym Preferences.

Dodawanie nowego miejsca publikacji FTP

Aby dodać nowe miejsce publikacji hostowane przez serwer FTP, kliknij przycisk i wybierz FTP z powiązanego menu – pojawi się okno dialogowe Add FTP Publishing Destination.

Zdefiniuj połączenie z serwerem FTP.

Zdefiniuj miejsce docelowe w następujący sposób:

1. Wprowadź dane uwierzytelniające konta FTP.

   1. Wprowadź Server Name – może to być adres IP (np. 123.45.1.1), nazwa domeny (np. myserver.com) lub nazwa hosta, jeśli serwer znajduje się w Twojej sieci lokalnej (np. myserver).
   2. Wprowadź User Name i Password, aby zalogować się do serwera FTP.
2. Nadaj miejscu docelowemu znaczącą Name.
3. Opcjonalnie określ katalog na serwerze FTP, w którym mają być przechowywane opublikowane dane. Wpisz ścieżkę bezpośrednio w polu Directory lub kliknij przycisk , aby przeglądać i wybrać folder.
4. Zdefiniuj w razie potrzeby dodatkowe opcje publikowania.
5. Aby ręcznie przetestować połączenie, kliknij przycisk . Nie jest to jednak wymagane, ponieważ połączenie zostanie automatycznie przetestowane po kliknięciu OK.
6. Kliknij OK.

Zostanie nawiązane połączenie z wskazanym folderem z poziomu Altium Designer, a wpis dla niego pojawi się na liście miejsc docelowych publikowania, z powrotem na stronie Data Management – Publishing Destinations page w oknie dialogowym Preferences.

Edycja połączenia z miejscem docelowym publikowania

Połączenie z miejscem docelowym publikowania możesz edytować w dowolnym momencie, na przykład gdy zmieni się lokalizacja miejsca docelowego. Aby to zrobić, kliknij dwukrotnie wpis miejsca docelowego na liście lub zaznacz wpis i kliknij przycisk . Pojawi się okno dialogowe, w którym możesz zmodyfikować właściwości połączenia.

Usuwanie miejsca docelowego publikowania

Aby usunąć miejsce docelowe publikowania, zaznacz jego wpis na liście miejsc docelowych, a następnie kliknij przycisk .

Dodatkowe opcje publikowania

Podczas definiowania miejsca docelowego publikowania dostępne są (tam, gdzie ma to zastosowanie) następujące dodatkowe opcje publikowania:

• Zip Contents – włącz tę opcję, aby przed publikacją skompresować dane do archiwum zip. Archiwum zip może być również zabezpieczone hasłem, jeśli jest to wymagane. Ta opcja jest dostępna dla wszystkich typów miejsc docelowych publikowania.
• Present Contents in a HTML page – włącz tę opcję, aby wygenerować stronę indeksu HTML, która wyświetla zawartość opublikowanych danych i ułatwia nawigację po plikach w przeglądarce internetowej. Ta opcja jest dostępna dla typów miejsc docelowych publikowania Amazon S3, Folder i FTP.

Przykładowa strona HTML z listą zawartości opublikowanych danych.

Publikowanie danych

Po zdefiniowaniu miejsc docelowych publikowania zgodnie z potrzebami możesz publikować dane wydania dla projektu płytki z poziomu szczegółowego widoku Item view, panelu Explorer panel lub z pliku OutputJob file:

• Z widoku Item wybierz konkretną rewizję elementu (Item), dla której chcesz opublikować dokumenty. Polecenia publikowania są dostępne w menu kontekstowym (prawy przycisk myszy) dla obszaru Released Documents. Oprócz publikowania just Released Documents dostępne jest także polecenie publikowania wszystkich dokumentów (wydanych plus System BOM) jednocześnie.

  Aby uzyskać dostęp do widoku Item, znajdź wymagany element (Item) w panelu Explorer, kliknij go prawym przyciskiem myszy, a następnie wybierz History z menu kontekstowego.

  Podmenu publikowania wyświetla wszystkie dostępne miejsca docelowe publikowania (Publishing Destinations) według nazwy, zdefiniowane na stronie Data Management – Publishing Destinations page w oknie dialogowym Preferences.

  
  Uzyskaj dostęp do poleceń związanych z publikowaniem dla konkretnej rewizji elementu (Item) z poziomu szczegółowego widoku Item.

• Z panelu Explorer przełącz się na widok Classic projektu ( – Classic View), wybierz konkretną rewizję PCB Fabrication Data, PCB Assembly Data lub PCB Project Design Item, dla której chcesz opublikować dokumenty, i upewnij się, że aktywna jest karta widoku aspektu Preview. Polecenia publikowania są dostępne w menu kontekstowym (prawy przycisk myszy) dla obszaru Released Documents. Ponownie: oprócz publikowania just Released Documents dostępne jest także polecenie publikowania wszystkich dokumentów (wydanych plus System BOM) jednocześnie.

  Podmenu publikowania wyświetla wszystkie dostępne miejsca docelowe publikowania (Publishing Destinations) według nazwy, zdefiniowane na stronie Data Management – Publishing Destinations page w oknie dialogowym Preferences.

  
  Uzyskaj dostęp do poleceń związanych z publikowaniem dla konkretnej rewizji elementu (Item) z poziomu panelu Explorer.

• Z pliku Output Job kliknij kontrolkę Generate and publish dla wymaganego Output Container, aby uzyskać dostęp do poleceń publikowania.

  Chociaż publikowanie do zdefiniowanego miejsca docelowego publikowania jest możliwe bezpośrednio z pliku Output Job Configuration, zaleca się publikowanie danych dopiero po ich wydaniu (release) na zarządzany serwer treści, aby korzystać z danych o gwarantowanej integralności, które przeszły rygorystyczną weryfikację i zabezpieczenia procesu wydania projektu.

  
  Uzyskaj dostęp do poleceń publikowania z poziomu pliku OutJob.

W każdym przypadku użyj kolejnego okna dialogowego Publish to, aby zdefiniować wymagany podfolder docelowy, w którym mają zostać zapisane dane. W przypadku miejsca docelowego publikowania Box, jeśli udostępniasz dane publikowania innym osobom, możesz także wpisać ich adresy e-mail, rozdzielone przecinkami, w odpowiednim polu tekstowym okna dialogowego Publish to Box.

Cztery warianty okna dialogowego Publish to Folder 

Po opublikowaniu ustaw wymagane prawa dostępu do folderu, witryny FTP lub obszaru Amazon S3 (jeśli nie zostały już ustawione), a następnie przekaż informację o dostępności danych odpowiednim osobom. W przypadku miejsca docelowego publikowania Box określ – poprzez e-mail – komu udostępnić opublikowane dane w momencie publikowania (w oknie dialogowym Publish to).

Globalne udostępnianie danych pakietu produkcyjnego

Kluczowym aspektem projektów przechowywanych w Altium 365 Workspace jest możliwość utworzenia i udostępnienia wydania Build Package innym osobom. Gdy udostępnisz je bezpośrednio producentowi, można je traktować jako Manufacturing Package, ponieważ jest to pakiet, który producent może przeglądać, pobrać i wykorzystać do wykonania oraz montażu płytki.

Aby wspierać możliwość udostępniania takiego pakietu innym osobom oraz producentowi (który zazwyczaj znajduje się poza Twoją organizacją), platforma Altium 365 udostępnia dedykowany Manufacturing Package Viewer – element wsparcia Global Sharing platformy – który pozwala innym osobom przeglądać pakiet produkcyjny w dowolnej przeglądarce internetowej – z dowolnego miejsca na świecie – ale poza Twoim Workspace, dzięki czemu same projekty oraz inne cenne IP pozostają niedostępne.

Każdy użytkownik, któremu udostępniono pakiet, otrzyma zaproszenie e-mail z linkiem do wyświetlenia pakietu produkcyjnego w Manufacturing Package Viewer. Udostępnione pakiety produkcyjne są prezentowane na stronie Shared with Me w przeglądarkowym interfejsie platformy Altium 365.

Manufacturing Package Viewer umożliwia kluczowym interesariuszom – a przede wszystkim personelowi produkcyjnemu – zobaczenie podsumowania projektu z kluczowymi danymi płytki, a także przeglądanie struktury danych źródłowych, produkcyjnych (fabrication) i montażowych (assembly) (oraz pobieranie w razie potrzeby dowolnego pojedynczego pliku). Dostępne są również podstrony przeglądarki dla danych Fabrication, Assembly i BOM; strona Fabrication udostępnia Gerber Viewer i pozwala dodawać komentarze wszystkim użytkownikom, którym pakiet został udostępniony.

Ostatecznie personel produkcyjny może pobrać Build Package dla oglądanego wydania – z dowolnej strony przeglądarki – aby zrealizować fizycznie tę rewizję płytki.

Pakiet produkcyjny udostępniony Tobie jest dostępny ze strony Shared with Me. Osoba, której udostępniłeś pakiet produkcyjny, otrzyma zaproszenie e-mail do uzyskania dostępu do tego pakietu przez Altium 365. Po kliknięciu przycisku w wiadomości e-mail zostanie przeniesiona na stronę Altium 365 Sign In (o ile nie jest już zalogowana do platformy lub do konta AltiumLive). Po zalogowaniu zostanie przeniesiona do Manufacturing Package Viewer, z załadowanym pakietem. Jeśli dana osoba nie ma konta AltiumLive, będzie musiała najpierw je zarejestrować – link jest dostępny na stronie Altium 365 Sign In.