Working with Publishing Destinations

Destynacje publikacji 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 z Output Job do przestrzeni magazynowej — takiej jak Box.com, Amazon S3, serwer FTP lub po prostu folder w 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, aż po dyrektora projektu podróżującego między tymi lokalizacjami — geograficznie rozproszony „zespół produktu”, wspólnie odpowiedzialny za przekształcenie pomysłu w fizyczny produkt, ma współdzielony (i kontrolowany) dostęp do przeglądania, omawiania i wykorzystywania danych potrzebnych do zbudowania tego elementu.

Definiowanie destynacji publikacji

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 dane mają być przechowywane. Odbywa 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 publikacji są określane w preferencjach Altium Designer.

Dla każdej zdefiniowanej destynacji publikacji 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 publikacji. Można zdefiniować następujące typy destynacji:

  • Amazon S3 – usługi Simple Storage Services hostowane przez Amazon AWS.
  • Box.com – destynacja publikacji 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 witrynie internetowej.
• Status – czy połączenie między Altium Designer a destynacją publikacji zostało nawiązane pomyślnie (), czy nie (). Jeśli połączenie się nie powiedzie, zostanie wyświetlony komentarz wskazujący problem.

Dodawanie nowej destynacji publikacji Amazon S3

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

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

1. Nadaj destynacji znaczącą Name.
2. Wprowadź poświadczenia swojego 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 tworzysz 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 powinien być przechowywany w bezpieczny sposób i znany wyłącznie Tobie oraz Amazon Web Services.
3. Określ nazwę bucketu, w którym będą przechowywane publikowane pliki. Buckety można tworzyć za pomocą narzędzi takich jak AWS Management Console. Opcjonalnie możesz wskazać podfolder w bucketcie, w którym mają być przechowywane pliki. Wpisz ścieżkę w polu Key Prefix lub kliknij przycisk , aby przeglądać i wybrać folder.
4. Zdefiniuj dodatkowe opcje publikacji, 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 publikacji na stronie Data Management – Publishing Destinations page w oknie dialogowym Preferences.

Dodawanie nowej destynacji publikacji Box.com

Aby dodać nową destynację publikacji, 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ą publikacji 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 konta Box. Aby aktywować swoje 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ąc 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 się do Box kliknij przycisk Grant access to Box, aby zezwolić aplikacji AltiumBoxApplication na dostęp do Box z uprawnieniami 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 zostało aktywowane.

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

      Jeśli konto Box.com zostało wcześniej aktywowane, możesz po prostu wprowadzić klucz aktywacyjny (jeśli został skopiowany podczas pierwszej aktywacji konta). Aby to zrobić, kliknij przycisk i wprowadź kod aktywacyjny w wyświetlonym oknie dialogowym Box.com Activation Key dialog. Jeśli utraciłeś oryginalny klucz aktywacyjny, nie znasz go lub chcesz uzyskać nowy klucz, możesz po prostu ponownie przeprowadzić aktywację. Konto zostanie aktywowane nowym kluczem, a stary klucz zostanie unieważniony.
      Jeśli potrzebujesz dostępu do konta Box z wielu komputerów albo 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 wyświetlonego okna dialogowego Box.com Activation Key .

3. Określ lokalizację przechowywania publikowanych danych — istniejący lub nowy folder w Box — za pomocą 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 publikacji, 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 publikacji na stronie Data Management – Publishing Destinations page w oknie dialogowym Preferences.

Dodawanie nowej destynacji publikacji Folder

Aby dodać nową lokalną destynację publikacji 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ą publikacji 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 lub 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, zgodnie z potrzebą.
3. Zdefiniuj dodatkowe opcje publikacji, 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 publikacji na stronie Data Management – Publishing Destinations page w oknie dialogowym Preferences.

Dodawanie nowej destynacji publikacji FTP

Aby dodać nową destynację publikacji 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ź poświadczenia swojego 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 sieci lokalnej (np. myserver).
   2. Wprowadź swoją User Name oraz Password, aby zalogować się do serwera FTP.
2. Nadaj destynacji znaczącą Name.
3. Opcjonalnie określ katalog na serwerze FTP, w którym mają być przechowywane publikowane dane. Wpisz ścieżkę bezpośrednio w polu Directory lub kliknij przycisk , aby przeglądać i wybrać folder.
4. Zdefiniuj dodatkowe opcje publikacji, 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 publikacji na stronie Data Management – Publishing Destinations page w oknie dialogowym Preferences.

Edycja połączenia z destynacją publikacji

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

Usuwanie destynacji publikacji

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

Dodatkowe opcje publikacji

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

• Zip Contents – włącz tę opcję, aby skompresować dane do archiwum ZIP przed publikacją. Archiwum ZIP może być także zabezpieczone hasłem, jeśli jest to wymagane. Ta opcja jest dostępna dla wszystkich typów destynacji publikacji.
• Present Contents in a HTML page – włącz tę opcję, aby wygenerować stronę indeksu HTML z listą zawartości opublikowanych danych i ułatwić nawigację po plikach w przeglądarce internetowej. Ta opcja jest dostępna dla typów destynacji publikacji Amazon S3, Folder i FTP.

Przykładowa strona HTML zawierająca listę zawartości opublikowanych danych.

Publikowanie danych

Po zdefiniowaniu destynacji publikacji zgodnie z potrzebami możesz publikować dane wydania projektu płytki z poziomu szczegółowego Item view, panelu Explorer lub pliku OutputJob file:

• Z poziomu widoku Item wybierz konkretną rewizję elementu, dla której chcesz opublikować dokumenty. Polecenia publikacji są dostępne w menu kontekstowym obszaru Released Documents. Oprócz możliwości publikacji just Released Documents dostępne jest także polecenie publikacji 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 publikacji zawiera listę wszystkich dostępnych destynacji publikacji według nazw zdefiniowanych na stronie Data Management – Publishing Destinations page w oknie dialogowym Preferences.

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

• Z panelu Explorer przełącz się do widoku 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 publikacji są dostępne w menu kontekstowym obszaru Released Documents. Ponownie, oprócz możliwości publikacji just Released Documents dostępne jest także polecenie publikacji wszystkich dokumentów (wydanych oraz System BOM) za jednym razem.

  Podmenu publikacji zawiera listę wszystkich dostępnych destynacji publikacji według nazw zdefiniowanych na stronie Data Management – Publishing Destinations page w oknie dialogowym Preferences.

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

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

  Chociaż publikowanie do zdefiniowanej destynacji publikacji jest możliwe bezpośrednio z pliku konfiguracji Output Job, zaleca się publikowanie danych dopiero po ich wydaniu do serwera zarządzanej zawartoś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ń publikacji 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 destynacji publikacji Box, jeśli udostępniasz dane publikacji innym osobom, możesz także 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 publikacji Box określ — za pośrednictwem e-maila — 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ść tworzenia i udostępniania innym pakietu wydania Build Package. Gdy jest on udostępniany 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 wytworzenia 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 udostępnia dedykowany Manufacturing Package Viewer — element obsługi Global Sharing tej platformy — który pozwala innym przeglądać pakiet produkcyjny z dowolnej przeglądarki internetowej, z dowolnego miejsca na świecie, ale poza Twoim 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 łą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 — zobaczenie podsumowania projektu z kluczowymi 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 zawiera przeglądarkę Gerber Viewer i pozwala wszystkim użytkownikom, którym udostępniono pakiet, dodawać komentarze.

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

Pakiet produkcyjny udostępniony Tobie można otworzyć 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 (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ć — odpowiednie łącze znajduje się na stronie Altium 365 Sign In.