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 zadania Output Job do przestrzeni magazynowej — takiej jak Box.com, Amazon S3, serwer FTP lub po prostu folder w lokalizacji sieci współdzielonej. Pozwala to bezpiecznie hostować wygenerowane dane wydania, a jednocześnie udostępniać do nich dostęp w skali globalnej. Od zakładu produkcyjnego w Japonii, przez zespoły projektowe w Monachium, Cambridge i San Diego, po kierownika projektu podróżującego między tymi lokalizacjami — 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 wytworzenia elementu.

Definiowanie destynacji publikowania

Zanim omówimy, jak faktycznie publikowane są dane wydania dla rewizji obsługiwanego typu elementu, należy najpierw zdefiniować opcje określające miejsce przechowywania tych danych. Wykonuje się to na stronie Data Management – Publishing Destinations page okna Preferences (kliknij kontrolkę w prawym górnym rogu głównego okna projektu).

Destynacje publikowania są określane 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 pamięci FTP lub do lokalizacji w Twojej witrynie internetowej.
• Status — informacja, czy połączenie między Altium Designer a destynacją publikowania jest poprawne () czy nie (). Jeśli połączenie nie powiedzie się, 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. Musisz mieć istniejące konto Amazon Web Services. Jeśli jeszcze go nie masz, zarejestruj się na stronie aws.amazon.com. W trakcie konfiguracji konta utworzony został 20-znakowy Access Key ID (czyli klucz publiczny) oraz odpowiadający mu 40-znakowy Secret Access Key (czyli klucz prywatny). Możesz mieć więcej niż jedną taką parę kluczy. Jak sama nazwa wskazuje, Secret Access Key powinien być przechowywany w bezpieczny sposób i znany tylko Tobie oraz Amazon Web Services.
3. Podaj nazwę bucketu, który będzie przechowywał opublikowane pliki. Buckety można tworzyć za pomocą narzędzi takich jak AWS Management Console. Opcjonalnie możesz określić podfolder w bucketcie, w którym będą przechowywane pliki. Wpisz ścieżkę w polu Key Prefix albo kliknij przycisk , aby przeglądać i wybrać folder.
4. Zdefiniuj dodatkowe opcje publikowania, jeśli są wymagane.
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, a wpis dla tej destynacji pojawi się na liście destynacji publikowania na stronie Data Management – Publishing Destinations page okna Preferences.

Dodawanie nowej destynacji publikowania Box.com

Aby dodać nową destynację publikowania, której struktura folderów będzie znajdować się w Twoim opartym na chmurze 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, w którym zostaniesz poproszony o zalogowanie się do swojego 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 się do Box kliknij przycisk Grant access to Box, aby zezwolić aplikacji AltiumBoxApplication na dostęp odczytu/zapisu do Box.

      
      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 konto Box.com jako aktywowane

      Jeśli konto Box.com zostało wcześniej aktywowane, możesz po prostu wprowadzić klucz aktywacyjny (jeśli został skopiowany przy 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 aktywować konto ponownie. Konto zostanie aktywowane nowym kluczem, a stary klucz zostanie unieważniony.
      Jeśli musisz uzyskiwać dostęp do swojego konta Box z wielu komputerów albo 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. 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 albo nowy folder w Twoim Box — za pomocą pola Folder w obszarze Location okna dialogowego. Użyj przycisku , aby otworzyć okno dialogowe Choose the Destination Root Folder, z poziomu którego 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, jeśli są wymagane.
5. Kliknij OK.

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

Dodawanie nowej destynacji publikowania typu Folder

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 typu folder.

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

1. Nadaj destynacji znaczącą Name.
2. Określ lokalizację folderu głównego. Możesz wpisać lokalizację folderu bezpośrednio w polu Folder albo kliknąć ikonę , aby otworzyć okno dialogowe Browse For Folder, z poziomu którego możesz wyszukać istniejący folder lokalny lub sieciowy albo utworzyć nowy, zależnie od potrzeb.
3. Zdefiniuj dodatkowe opcje publikowania, jeśli są wymagane.
4. Kliknij OK.

Zostanie nawiązane połączenie z wybranym folderem z poziomu Altium Designer, a wpis dla tej destynacji pojawi się na liście destynacji publikowania na stronie Data Management – Publishing Destinations page okna 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 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 destynacji znaczącą Name.
3. Opcjonalnie określ katalog na serwerze FTP, w którym będą przechowywane opublikowane dane. Wpisz ścieżkę bezpośrednio w polu Directory albo kliknij przycisk , aby przeglądać i wybrać folder.
4. Zdefiniuj dodatkowe opcje publikowania, jeśli są wymagane.
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 dla tej destynacji pojawi się na liście destynacji publikowania na stronie Data Management – Publishing Destinations page okna Preferences.

Edytowanie połączenia z destynacją publikowania

Połączenie z destynacją publikowania możesz edytować w dowolnym momencie, na przykład jeśli zmieni się lokalizacja tej destynacji. Aby to zrobić, kliknij dwukrotnie wpis destynacji na liście destynacji albo zaznacz wpis i kliknij przycisk . Pojawi się okno dialogowe, w którym możesz zmienić właściwości połączenia.

Usuwanie destynacji publikowania

Aby usunąć destynację publikowania, zaznacz jej wpis na liście destynacji, a następnie kliknij przycisk .

Dodatkowe opcje publikowania

Podczas definiowania destynacji publikowania dostępne są następujące dodatkowe opcje publikowania (tam, gdzie mają zastosowanie):

• 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 destynacji publikowania.
• Present Contents in a HTML page — włącz tę opcję, aby wygenerować stronę indeksową HTML, która wyświetli zawartość opublikowanych danych i ułatwi nawigację po plikach w przeglądarce internetowej. Ta opcja jest dostępna dla destynacji publikowania typu Amazon S3, Folder i FTP.

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

Publikowanie danych

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

• Z poziomu widoku Item wybierz konkretną rewizję elementu, dla której chcesz opublikować dokumenty. Polecenia publikowania są dostępne w menu kontekstowym obszaru Released Documents. Oprócz publikacji 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 destynacji publikowania według nazw zdefiniowanych na stronie Data Management – Publishing Destinations page okna Preferences.

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

• Z poziomu panelu Explorer przełącz się do widoku projektu Classic ( – Classic View), wybierz konkretną rewizję elementu 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 obszaru Released Documents. Ponownie, oprócz publikacji 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 destynacji publikowania według nazw zdefiniowanych na stronie Data Management – Publishing Destinations page okna Preferences.

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

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

  Chociaż publikowanie do zdefiniowanej destynacji publikowania jest możliwe bezpośrednio z pliku konfiguracji Output Job, zaleca się publikowanie danych dopiero po ich wydaniu do serwera zarządzanej zawartości, tak 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 destynacji 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 prawa dostępu do folderu, witryny FTP lub obszaru Amazon S3 zgodnie z potrzebami (jeśli nie zostało to już zrobione), a następnie poinformuj odpowiednie osoby o dostępności danych. W przypadku destynacji 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 Altium 365 Workspace jest możliwość utworzenia i udostępnienia innym pakietu wydania Build Package. Gdy taki pakiet zostanie 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 wytwarzania oraz montażu płytki.

W celu obsługi możliwości udostępniania takiego pakietu innym osobom, w tym producentowi (który zazwyczaj znajduje się poza Twoją organizacją), platforma Altium 365 zapewnia dedykowane Manufacturing Package Viewer — element wsparcia Global Sharing platformy — które umożliwia innym osobom przeglądanie pakietu produkcyjnego z poziomu dowolnej przeglądarki internetowej, z dowolnego miejsca na świecie, ale poza Workspace, dzięki czemu same projekty i inne cenne zasoby IP pozostają niedostępne.

Każdy użytkownik, któremu coś udostępniono, otrzyma zaproszenie e-mail z linkiem 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.

Samo Manufacturing Package Viewer umożliwia kluczowym interesariuszom — przede wszystkim personelowi produkcyjnemu — zobaczenie 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 umożliwia dodawanie komentarzy przez wszystkich użytkowników, którym pakiet został udostępniony.

Ostatecznie personel produkcyjny może pobrać Build Package przeglądanego wydania — z dowolnej strony przeglądarki — 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óra udostępniła Ci pakiet produkcyjny, otrzyma wiadomość e-mail z zaproszeniem 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 (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 ta osoba nie ma konta AltiumLive, najpierw będzie musiała je zarejestrować — odpowiedni link znajduje się na stronie Altium 365 Sign In.