Working with Publishing Destinations

Destynacje publikowania umożliwiają publikowanie danych wydania dla rewizji elementu PCB Fabrication Data Item, PCB Assembly Data Item lub PCB Project Design Item bezpośrednio z Workspace albo Output Job do przestrzeni magazynowej — takiej jak Box.com, Amazon S3, serwer FTP lub zwykły folder w sieci współdzielonej. Pozwala to bezpiecznie hostować wygenerowane dane wydania, a jednocześnie udostępniać je globalnie. Od zakładu produkcyjnego w Japonii, przez zespoły projektowe w Monachium, Cambridge i San Diego, aż po dyrektora projektu podróżującego między nimi wszystkimi — rozproszony geograficznie „Product Team”, wspólnie odpowiedzialny za przeprowadzenie produktu od pomysłu do fizycznej realizacji, ma współdzielony (i kontrolowany) dostęp do przeglądania, omawiania i wykorzystywania danych do zbudowania tego elementu.

Definiowanie destynacji publikowania

Zanim przyjrzymy się temu, jak faktycznie publikowane są dane wydania dla rewizji obsługiwanego typu elementu, należy najpierw zdefiniować opcje określające, gdzie te dane będą 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).

Destynacje publikowania są definiowane jako część preferencji Altium Designer.

Dla każdej zdefiniowanej destynacji publikowania prezentowane są następujące informacje:

• Name — znacząca nazwa destynacji. Może ona na przykład odzwierciedlać dane publikowane do tej destynacji.

• Type — typ destynacji publikowania. Można zdefiniować następujące typy destynacji:

  • Amazon S3 — usługi Simple Storage Services hostowane przez Amazon AWS.
  • Box.com — destynacja publikowania hostowana przez Box.com.
  • Folder — prosta struktura folderów, na przykład w sieci współdzielonej.
  • FTP — do przesyłania na serwer FTP lub do lokalizacji w Twojej witrynie internetowej.
• Status — czy połączenie między Altium Designer a destynacją publikowania zakończyło się powodzeniem () czy nie (). Jeśli połączenie się nie powiedzie, zostanie wyświetlony komentarz wskazujący problem.

Dodawanie nowej destynacji publikowania Amazon S3

Aby dodać nową destynację publikowania hostowaną 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 destynacją publikowania Amazon S3.

Zdefiniuj destynację w następujący sposób:

1. Nadaj destynacji znaczącą Name.
2. Wprowadź dane uwierzytelniające swojego konta Amazon Web Services. Będziesz potrzebować istniejącego konta Amazon Web Services. Jeśli jeszcze go nie masz, zarejestruj się na aws.amazon.com. Podczas konfigurowania 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 sama nazwa wskazuje, Secret Access Key należy przechowywać w bezpiecznym miejscu i powinien być znany tylko 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 określić podfolder w buckecie, w którym będą przechowywane 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 przetestowane automatycznie po kliknięciu OK.
6. Kliknij OK.

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

Dodawanie nowej destynacji publikowania Box.com

Aby dodać nową destynację publikowania, której 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 destynacją publikowania Box.com.

Zdefiniuj destynację w następujący sposób:

1. Nadaj destynacji 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, proszące o zalogowanie się do konta.

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

   2. Wprowadź dane logowania do konta 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 i 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 zostało aktywowane.

      
      Okno dialogowe Add Box.com Publishing Destination pokazujące, że konto Box.com jest aktywowane

      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 dialogowym 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 przeprowadzić aktywację ponownie. Konto zostanie aktywowane nowym kluczem, a stary klucz zostanie unieważniony.
      Jeśli musisz uzyskiwać dostęp do konta Box z wielu komputerów lub chcesz łączyć się z wieloma folderami publikowania w ramach tego samego konta Box, możesz to zrobić, kopiując i używając swojego klucza aktywacyjnego Box.com. Aby to zrobić, 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, z którego możesz przeglądać wszystkie aktualnie zdefiniowane foldery w swoim Box albo 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 Altium Designer, a wpis dla tej destynacji pojawi się na liście destynacji publikowania z powrotem na stronie Data Management – Publishing Destinations page w oknie dialogowym Preferences.

Dodawanie nowej destynacji publikowania folderu

Aby dodać nową lokalną destynację publikowania opartą na folderze, kliknij przycisk i wybierz Folder z powiązanego menu — pojawi się okno dialogowe Add Folder Publishing Destination.

Zdefiniuj połączenie z destynacją publikowania folderu.

Zdefiniuj destynację w następujący sposób:

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

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

Dodawanie nowej destynacji publikowania FTP

Aby dodać nową destynację publikowania hostowaną 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 destynację w następujący sposób:

1. Wprowadź dane uwierzytelniające swojego konta FTP.

   1. Wprowadź Server Name – może to być adres IP (taki jak 123.45.1.1), nazwa domeny (taka jak myserver.com) lub nazwa hosta, jeśli znajduje się on w sieci lokalnej (taka jak myserver).
   2. Wprowadź User Name oraz Password, aby zalogować się do serwera FTP.
2. Nadaj lokalizacji docelowej 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 dodatkowe opcje publikowania zgodnie z wymaganiami.
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 wybranym folderem z poziomu Altium Designer, a wpis dotyczący tego folderu pojawi się na liście miejsc docelowych publikowania 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żna edytować w dowolnym momencie, na przykład gdy zmieni się lokalizacja miejsca docelowego publikowania. Aby to zrobić, kliknij dwukrotnie wpis miejsca docelowego na liście lokalizacji albo zaznacz wpis i kliknij przycisk . Zostanie wyświetlone okno dialogowe, w którym można zmodyfikować właściwości połączenia.

Usuwanie miejsca docelowego publikowania

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

Dodatkowe opcje publikowania

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

• Zip Contents – włącz tę opcję, aby skompresować dane do archiwum zip przed publikacją. W razie potrzeby archiwum zip może być również chronione hasłem. 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świetli zawartość opublikowanych danych i ułatwi 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 wyświetlająca zawartość opublikowanych danych.

Publikowanie danych

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

• W widoku Item wybierz konkretną rewizję elementu, dla której chcesz opublikować dokumenty. Polecenia publikowania są dostępne w menu kontekstowym po kliknięciu prawym przyciskiem myszy obszaru Released Documents. Oprócz publikowania just Released Documents dostępne jest również polecenie umożliwiające opublikowanie wszystkich dokumentów (wydanych oraz System BOM) za jednym razem.

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

  Podmenu publikowania zawiera listę wszystkich dostępnych miejsc docelowych publikowania według nazw, zgodnie z definicją na stronie Data Management – Publishing Destinations page okna dialogowego Preferences.

  
  Uzyskiwanie dostępu do poleceń związanych z publikowaniem dla określonej rewizji elementu z poziomu szczegółowego widoku Item.

• W panelu Explorer przełącz się do widoku projektu Classic ( – 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 po kliknięciu prawym przyciskiem myszy obszaru Released Documents. Ponownie, oprócz publikowania just Released Documents, dostępne jest również polecenie umożliwiające opublikowanie wszystkich dokumentów (wydanych oraz System BOM) za jednym razem.

  Podmenu publikowania zawiera listę wszystkich dostępnych miejsc docelowych publikowania według nazw, zgodnie z definicją na stronie Data Management – Publishing Destinations page okna dialogowego Preferences.

  
  Uzyskiwanie dostępu do poleceń związanych z publikowaniem dla określonej rewizji elementu z poziomu panelu Explorer.

• Z poziomu pliku Output Job kliknij element sterujący 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 poziomu pliku konfiguracji Output Job, zaleca się publikowanie danych dopiero po ich wydaniu do serwera zarządzanej zawartości, co pozwala korzystać z danych o gwarantowanej integralności, które przeszły rygorystyczną weryfikację i zabezpieczenia procesu wydania projektu.

  
  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ą być przechowywane dane. W przypadku miejsca docelowego publikowania Box, jeśli udostępniasz dane publikowania innym osobom, możesz również wpisać ich adresy e-mail, oddzielone przecinkami, w odpowiednim polu tekstowym okna dialogowego Publish to Box.

Cztery warianty okna dialogowego Publish to Folder

Po opublikowaniu ustaw odpowiednie prawa dostępu do folderu, witryny FTP lub obszaru Amazon S3, jeśli jest to wymagane (i jeśli nie zostało to już zrobione), a następnie poinformuj odpowiednie osoby o dostępności danych. W przypadku miejsca docelowego publikowania Box określ – za pośrednictwem wiadomości e-mail – komu udostępnić opublikowane dane w momencie publikacji (w oknie dialogowym Publish to).

Globalne udostępnianie danych pakietu produkcyjnego

Kluczowym aspektem projektów przechowywanych w obszarze roboczym Altium 365 jest możliwość utworzenia i udostępnienia innym pakietu wydania Build Package. Gdy zostanie on udostępniony bezpośrednio producentowi, można go traktować jako Manufacturing Package, ponieważ jest to pakiet, który producent może przeglądać, pobierać i wykorzystywać do wykonania oraz montażu płytki.

Wspierając możliwość udostępniania takiego pakietu innym osobom oraz producentowi (który zwykle znajduje się poza Twoją organizacją), platforma Altium 365 zapewnia dedykowany Manufacturing Package Viewer – element obsługi Global Sharing platformy – który umożliwia innym przeglądanie pakietu produkcyjnego z dowolnej przeglądarki internetowej – z dowolnego miejsca na świecie – ale poza Twoim obszarem roboczym, dzięki czemu same projekty i inne cenne zasoby własności intelektualnej pozostają niedostępne.

Każdy użytkownik, któremu coś udostępniono, otrzyma zaproszenie e-mail z łączem do wyświetlenia pakietu produkcyjnego za pośrednictwem Manufacturing Package Viewer. Udostępnione pakiety produkcyjne są prezentowane na stronie Shared with Me przeglądarkowego interfejsu platformy Altium 365.

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

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

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