Releasing to a Workspace

W widoku Release w Online Mode proces wydania ma postać etapowego przepływu, a wpisy po lewej stronie widoku pokazują na pierwszy rzut oka, na którym etapie aktualnie się znajdujesz:

1. Configure Server Release – na tym etapie procesu wydania określasz typ(y) danych, które chcesz wygenerować: Source Data (zawsze generowane), Fabrication Data, Assembly Data (dla projektu bazowego oraz dla każdego wykrytego wariantu).

2. Validate Project – ten kolejny etap procesu wydania uruchamia się automatycznie, gdy w przypisanych plikach OutJob zostanie wykryty co najmniej jeden raport typu Validation. Uruchamiane są wszystkie zdefiniowane generatory wyjść walidacyjnych, zdefiniowane w pliku Output Job przypisanym do wydawanego elementu danych.

3. Generate Data – ten kolejny etap procesu wydania uruchamia się automatycznie. W tym miejscu uruchamiane są wszystkie pozostałe wyjścia – zdefiniowane w plikach OutJob przypisanych do uwzględnionych Data Items – aby wygenerować dane, które zostaną wydane do odpowiednich elementów docelowych w Workspace.

4. Review Data – po przejściu wszystkich kontroli walidacyjnych i wygenerowaniu danych wyjściowych, ten etap procesu wydania umożliwia przegląd wygenerowanych danych.

   Jeśli zdecydujesz się użyć poleceń Prepare & Release lub Prepare & Release & Publish to PLM (z menu powiązanego z przyciskiem ), Project Releaser nie zatrzyma się na etapie Review Data.

5. Upload Data – po potwierdzeniu wydania na poprzednim etapie, ten kolejny etap jest uruchamiany automatycznie. Po prostu prezentuje postęp przesyłania danych do rewizji odpowiednich Data Items w docelowym Workspace.

6. Execution Report – to końcowy etap procesu, zawierający podsumowanie wydania. Udostępnione są łącza nawigacyjne umożliwiające szybkie przejście do wygenerowanych rewizji elementów w panelu Explorer panel. Jeśli uzyskałeś dostęp do Project Releaser w ramach procesu wydania i publikacji do PLM, zostanie wyświetlony przycisk . Kliknij go, aby kontynuować bazowy workflow procesu i opublikować do PLM.

   Jeśli zdecydujesz się użyć polecenia Prepare & Release & Publish to PLM (z menu powiązanego z przyciskiem ), Project Releaser nie zatrzyma się na etapie Execution Report i nie zostanie wyświetlony przycisk .

7. Publish to PLM – ten etap jest obecny tylko podczas uruchamiania wydania w ramach odpowiedniego aktywowanego procesu (wydanie, a następnie publikacja do PLM). Etap ten jest uruchamiany automatycznie po kliknięciu przycisku na poprzednim etapie (lub uruchamiany bezpośrednio, jeśli użyto polecenia Prepare & Release & Publish to PLM z menu powiązanego z przyciskiem ). Zostanie wyświetlone okno dialogowe Login Credentials. Wprowadź Username i Password dla swojej instancji PLM oraz wybierz szablon PLM, którego chcesz użyć (pojawia się w formularzu <PLMInstance>:<PublishingTemplate>).

   Pamiętaj, że dane logowania do instancji PLM są wymagane tylko przy pierwszej publikacji do tej instancji. Następnie zostaną zapisane w Workspace. Po tym każda publikacja tego projektu do tej samej instancji PLM będzie przebiegać bezpośrednio, zgodnie ze zdefiniowanym workflow i wybranym szablonem publikacji.
   Jeśli publikujesz po raz pierwszy i numery części (po stronie PLM) nie są jeszcze powiązane z projektem w Workspace, numery te zostaną utworzone w PLM i powiązane z projektem w ramach tej pierwszej publikacji. Masz również możliwość zdefiniowania wpisów komponentów dla komponentów Workspace w instancji PLM w ramach operacji publikacji – aby uzyskać BOM komponentów w PLM (opcjonalnie, zależnie od zdefiniowanego i użytego szablonu publikacji podczas publikowania projektu do instancji PLM).

Online Stage 1 – Configure Server Release

Ten etap procesu wydania to miejsce, w którym określasz typ(y) danych, które chcesz wygenerować. Data Items, które można wydać, to:

• Source Data – migawka projektu źródłowego.
• Fabrication Data – dane wymagane przez wytwórnię (Fabrication House) do wykonania gołej płytki.
• Assembly Data for the Base Design (no variations) – dane wymagane przez montownię (Assembly House) do pełnego obsadzenia gołej płytki zgodnie z Bill of Materials, dla bazowego projektu bez wariantów.
• Assembly Data for Design Variant n – dane wymagane przez montownię (Assembly House) do obsadzenia gołej płytki zgodnie z Bill of Materials, dla Variant n projektu bazowego.

Liczba zestawów danych montażowych będzie odpowiadać projektowi bazowemu (bez wariantów) oraz wszystkim wykrytym wariantom zdefiniowanym dla tego projektu.

Etap 1 procesu wydania projektu – konfiguracja tego, co ma zostać uwzględnione w wydaniu (jakie dane wygenerować).

Element Source Data jest zawsze uwzględniany w wydaniu. Pozostałe elementy danych mogą być dołączane opcjonalnie.

Setting Workspace Item Naming Schemes

Podczas pierwszego wydania projektu do docelowego Workspace możesz zdefiniować, w jaki sposób będą nazywane docelowe elementy danych w tym Workspace (których rewizje otrzymują wygenerowane dane). Robi się to na karcie Item Naming w oknie dialogowym Project Release Options, do którego uzyskuje się dostęp, naciskając przycisk w lewym dolnym rogu widoku (lub klikając łącze Target Revision dla zestawu danych do wydania i wybierając Edit z menu kontekstowego). Użyj tej karty, aby:

• Zdefiniować nazwę projektu. Domyślnie pole to zostanie wypełnione rzeczywistą nazwą projektu.
• Zdefiniować domyślne schematy nazewnictwa dla różnych elementów danych, które mogą być generowane w ramach wydania. Kliknij w polu w kolumnie Item ID, a następnie kliknij przycisk po prawej stronie pola, aby otworzyć okno dialogowe Choose Item (odmianę panelu Explorer), które umożliwia wskazanie istniejącego Item w aktywnie połączonym Workspace.

Element Project nie jest elementem tworzonym do odbioru danych wydania, lecz encją używaną jako punkt zakotwiczenia do prezentacji ogólnego widoku projektu wydanych elementów danych oraz tego, jak są one ze sobą powiązane podczas przeglądania projektu w panelu Explorer panel. Więcej informacji znajdziesz w sekcji Viewing the Released Project .

Aby zmienić dowolny schemat nazewnictwa, kliknij przycisk Settings, aby otworzyć okno dialogowe Naming Template Settings.

Ustaw nazwę projektu i zdefiniuj nazewnictwo dla generowanych elementów danych w docelowym Workspace. Tutaj pola są edytowalne, ponieważ projekt nie został jeszcze wydany.

W szablonie nazewnictwa obsługiwane są następujące formaty makr:

• Parameter-based – obsługa użycia parametrów ujętych w nawiasy kwadratowe (np. [ProjectName], [VariantName], [ProjectParameter]).
• Numeric-based – obsługa użycia kwantyfikatorów liczbowych ujętych w nawiasy klamrowe (np. {0000}, {9000}).

Z karty Item Naming w oknie dialogowym Project Release Options możesz kliknąć bezpośrednio wpis schematu nazewnictwa i zmienić nazewnictwo zgodnie z potrzebą. Alternatywnie kliknij przycisk po prawej stronie pola, aby otworzyć okno dialogowe Choose Item (odmiana panelu Explorer), które pozwala wskazać istniejący element (Item) w aktualnie połączonym Workspace.

Nazewnictwo elementów (Item) można zmieniać w dowolnym momencie podczas pierwszego etapu widoku Release, podczas konfigurowania danych, które mają zostać wydane (released) do aktualnie połączonego Workspace. Po kliknięciu nie można już zmienić powiązanego nazewnictwa, ponieważ dla każdego włączonego zestawu danych ujętego w wydaniu zostaną utworzone planowane elementy o tym nazewnictwie – a te są powiązane z projektem. Dlatego nawet jeśli nie przeprowadzisz wydania danych do tych elementów, nadal będą one istnieć w stanie gotowości, a odpowiadające im wpisy szablonu nazewnictwa zostaną wyszarzone. Możesz usunąć te planowane elementy albo użyć polecenia Browse (kliknij wpis Target Revision, aby uzyskać dostęp do menu) i w każdym przypadku utworzyć nowy docelowy element (Item) z pożądanym nazewnictwem.

Po skonfigurowaniu elementów danych, które mają zostać utworzone w ramach wydania, zgodnie z wymaganiami, kliknij przycisk w prawym dolnym rogu widoku, aby przejść dalej.

Przycisk ma dwa stany. Kliknięcie go uruchomi standardowe polecenie Prepare. Spowoduje to przeprowadzenie wydania do etapu Review Data – umożliwiając w praktyce ponowne sprawdzenie, czy wszystko jest w porządku, zanim zatwierdzisz wydanie danych. Jeśli nie chcesz zatrzymywać się na przegląd, użyj menu rozwijanego powiązanego z przyciskiem i wybierz polecenie Prepare & Release.

W ramach przygotowania wykonywanych jest kilka kontroli przed wydaniem, w tym:

• Upewnienie się, że projekt i wszystkie pliki zostały zapisane.
• Upewnienie się, że projekt i wszystkie istotne pliki zostały zatwierdzone (committed) do VCS, jeśli dotyczy.
• Upewnienie się, że każdy włączony element danych otrzymał nazwę.
• Sprawdzenie, czy użytkownik ma uprawnienia do utworzenia elementu docelowego (oraz rewizji).
• Utworzenie wymaganych docelowych elementów (Items) (oraz planowanych rewizji) w Workspace, jeśli obecnie nie istnieją, oraz zapewnienie użycia następnej rewizji dla tych elementów, które już istnieją.

Jeśli zostaną wykryte problemy, otrzymasz propozycje rozwiązań umożliwiających ich usunięcie (np. zapisanie lokalnie zmodyfikowanych plików i zatwierdzenie do VCS).

W tym momencie generowany jest element Source Data – wraz ze zrzutem (snapshot) źródłowych plików projektu projektowego wydanych do docelowej rewizji elementu.

Etap online 2 – Walidacja projektu

Po zakończeniu etapu 1 bez problemów, ten kolejny etap procesu wydania jest uruchamiany automatycznie, gdy w przypisanych plikach OutJob zostanie wykryty co najmniej jeden raport typu Validation. Uruchamiane są wszystkie zdefiniowane generatory wyjść walidacyjnych, zdefiniowane w pliku Output Job przypisanym do wydawanego elementu danych. Obejmuje to uruchomienie dowolnych z poniższych:

• Differences Report – użycie komparatora w celu określenia, czy dokumenty źródłowe i dokumenty projektu PCB są poprawnie zsynchronizowane.
• Electrical Rules Check – sprawdzenie poprawności elektrycznej/rysunkowej przechwyconego projektu źródłowego.
• Design Rules Check – sprawdzenie poprawności dokumentu PCB w odniesieniu do określonych ograniczeń projektowych na poziomie płytki.
• BOM Checks – sprawdzenie możliwych naruszeń związanych z Design Items lub Part Choices w źródłowym dokumencie BOM (*.BomDoc), jeśli dostępne.
• Footprint Comparison Report – porównanie footprintów na płytce z ich biblioteką źródłową, aby upewnić się, że są aktualne i zgodne.
• Component State Checking – sprawdzenie komponentów znajdujących się w stanach ograniczonych. W ramach konfiguracji określasz działanie, jakie ma zostać podjęte dla każdego aktualnie zdefiniowanego stanu, dla każdej aktualnie zdefiniowanej definicji cyklu życia (Lifecycle Definition) w docelowym Workspace: brak działania, ostrzeżenie lub wygenerowanie błędu. Ta ostatnia opcja uniemożliwi wydanie projektu. Dodatkowo uruchomienie kontroli wygeneruje przydatny raport oparty na HTML, pozwalający na szybkie sprawdzenie, które komponenty projektu nie znajdują się w prawidłowych stanach.
• Environment Configuration Compliance Check – sprawdzenie, czy używane są wyłącznie elementy danych dozwolone przez konfigurację środowiska dostępną dla przypisanej roli (jeśli dotyczy). Ta kontrola może również zapewnić, że wszystkie elementy projektu pochodzą z Workspace.

Jeśli walidacja zakończy się powodzeniem, wyświetlana jest ikona wraz z tekstem Passed. Jeśli nie, zostanie wyświetlona ikona z tekstem Failed.

Kliknięcie w prawym dolnym rogu widoku zatrzyma proces wydania.

Etap online 3 – Generowanie danych

Po zakończeniu etapu 2 bez problemów, ten kolejny etap procesu wydania jest uruchamiany automatycznie. W tym miejscu uruchamiane są wszystkie pozostałe wyjścia – zdefiniowane w plikach OutJob przypisanych do uwzględnionych elementów danych (Data Items) – aby wygenerować dane, które mają zostać wydane do odpowiednich elementów docelowych w Workspace.

Podobnie jak w innych etapach, ale bardziej zauważalnie w tym etapie (ponieważ trwa dłużej), do prezentacji postępu generowania używane są ikony:

– jeszcze nie uruchomiono/nie wygenerowano.

– w trakcie uruchamiania/generowania.

– wygenerowano pomyślnie.

– generowanie nie powiodło się.

Kliknięcie w prawym dolnym rogu widoku zatrzyma proces wydania.

Etap online 4 – Przegląd danych

Po przejściu wszystkich kontroli walidacji i wygenerowaniu danych wyjściowych, ten etap procesu wydania umożliwia przegląd wygenerowanych danych.

Przed zatwierdzeniem wydania i przesłaniem danych do Workspace przejrzyj wygenerowane dane, upewniając się, że wszystko jest tak, jak powinno.

Domyślnie strona prezentuje prosty (kompaktowy) widok wygenerowanych danych. Przełącz się na bardziej szczegółowy widok, klikając kontrolkę Details powiązaną z interesującą sekcją.

Kliknij kontrolkę Details, aby przełączyć się z widoku prostego na szczegółowy widok wygenerowanych danych dla powiązanej sekcji. Aby wrócić, kliknij kontrolkę Hide Details.

W widoku kompaktowym wygenerowanych danych kliknij łącze View, aby otworzyć powiązany plik danych lub zestaw plików — albo w odpowiednim edytorze w Altium Designer (np. edytor CAM dla plików Gerber lub skompresowanych/nieskompresowanych plików ODB++), albo w odpowiedniej aplikacji zewnętrznej (np. Microsoft Excel dla zestawienia materiałowego). W widoku szczegółowym dwukrotnie kliknij wpis, aby wyświetlić tylko ten plik.

Powszechnym testem gotowości do wydania, stosowanym przez wielu projektantów, jest porównanie plików Gerber wygenerowanych dla bieżącego wydania z plikami Gerber z poprzedniego wydania. Kliknij łącze Compare Gerber obok wyjścia Gerber i wybierz poprzednie wydanie z listy rozwijanej, aby porównać przygotowane dane Gerber z danymi z wybranego wydania. Zostanie otwarta domyślna przeglądarka, która uruchomi Company Workspace i wyświetli wyniki.

Dostęp do funkcji porównywania Gerber z poziomu Project Releaser, przed wydaniem danych do Workspace.

► Dowiedz się więcej o funkcji Gerber Comparison (Altium 365 Workspace, Enterprise Server Workspace).

Jeśli po przejrzeniu danych uznasz, że musisz wprowadzić modyfikacje, kliknij przycisk w prawym dolnym rogu widoku. Pojawi się okno potwierdzenia informujące, że wszystkie wygenerowane dane zostaną utracone — kliknięcie OK anuluje wydanie i spowoduje powrót do Etapu 1 procesu.

Jeśli wszystkie wygenerowane dane wyglądają poprawnie, kontynuuj wydanie, klikając przycisk (również w prawym dolnym rogu widoku). Pojawi się okno dialogowe Confirm Release, podsumowujące konfiguracje projektu, które zostaną wydane do Workspace. Masz tu także możliwość dodania Name (domyślnie wpisem jest [ProjectName]), Description oraz dodania odpowiednich uwag do wydania.

Potwierdzenie tego, co zostanie wydane — w zakresie wygenerowanych Item-Revisions — oraz możliwość zmiany nazwy/opisu i dodania uwag do wydania.

Etap online 5 – Prześlij dane

Po potwierdzeniu wydania na poprzednim etapie ten kolejny etap jest uruchamiany automatycznie. Prezentuje on jedynie postęp przesyłania danych do rewizji odpowiednich elementów danych (Items) w Workspace.

Ten etap odzwierciedla wyłącznie postęp przesyłania wygenerowanych danych do powiązanych Item-Revisions w Workspace.

Etap online 6 – Raport wykonania

To końcowy etap procesu, zawierający podsumowanie wydania.

Końcowy raport dla wydania.

Użyj łączy nawigacyjnych, aby szybko przejść do powiązanej rewizji elementu (Item Revision) zawierającej wydane dane (dane produkcyjne, dane montażowe oraz wszelkie niestandardowe zestawy danych) w panelu Explorer — Twoim portalu do Workspace.

Wyświetlanie wydanych danych projektu bezpośrednio w Workspace dzięki panelowi Explorer.

Viewing the Released Project

Dla projektu w Workspace, po zakończeniu wydania dostępna jest dodatkowa funkcjonalność. Klikając łącze Project Page — ostatnie z łączy nawigacyjnych u góry strony Execution Report — otworzysz panel Explorer, prezentujący projekt w Project View — dostępne tylko dla projektów w Workspace.

Jeśli wcześniej przeglądałeś projekt w Classic View, może być konieczne ręczne przełączenie na Project View — polecenia są dostępne z menu powiązanego z przyciskiem w prawym górnym rogu panelu Explorer.

Możesz przeglądać projekt w Workspace bardziej szczegółowo w panelu Explorer, dzięki Project View.

Obszar Releases (w lewym dolnym rogu widoku) wyświetli zestawienie wydań projektu powiązanych z projektem, zawierające podsumowanie każdego wydania i jego pakietów składowych. Kliknij przycisk w tym obszarze, aby otworzyć okno dialogowe Batch state change dialog, którego możesz użyć do jednoczesnej zmiany stanu cyklu życia wielu elementów powiązanych z tym samym wydaniem, w ramach jednego procesu wsadowego.

Dalszy dostęp do informacji o wydaniach projektu jest dostępny w Web Viewer docelowego Workspace, otwieranym przez przycisk w panelu Explorer. W Web Viewer Workspace wszystkie wydania powiązane z projektem są dostępne w widoku Releases — lub w widoku Manufacture dla Workspace udostępnianego przez serwer lokalny. Strona zawiera listę wszystkich wydań projektu, z najnowszym wpisem na górze; pojedyncze wydanie można otworzyć w Manufacturing Portal Workspace za pomocą przycisku otwierania (). Widok Manufacturing Portal dostarcza bardziej szczegółowych informacji o wybranym wydaniu, w tym plików pakietu wydania, pełnego zestawu dokumentów projektowych oraz danych producenta i dostawcy komponentów. Zwróć uwagę, że funkcja Send to Manufacturer jest dostępna wyłącznie w Altium 365 Workspace. ► Więcej informacji znajdziesz na stronie Altium 365 Workspace Releases View.

To wszystko — po wydaniu projektu możesz po prostu zamknąć widok Release (używając przycisku w prawym dolnym rogu widoku). A gdy w przyszłości będziesz potrzebować ponownie wydać ten sam projekt, Project Releaser umożliwi to szybko i łatwo oraz automatycznie zwiększy docelowe Item-Revisions.

Publikowanie do instancji PLM

Related pages: Integracja PLM (Altium 365 Workspace, Enterprise Server Workspace), Publikowanie do PLM

Masz możliwość opublikowania projektu do instancji PLM w ramach uruchamiania Project Releaser w Altium Designer. Operacja publikowania wykorzystuje szablon publikowania – zdefiniowany jako część konfiguracji integracji danej instancji PLM – aby kontrolować sposób propagowania danych do PLM. Ta funkcja jest dostępna poprzez odpowiednio skonfigurowany proces. Przykładowa definicja procesu jest dostarczana w ramach instalacji – Project Releaser with Publish – a jej bazowy workflow umożliwia publikowanie do zintegrowanej instancji PLM jako dodatkowy etap Project Releaser. Diagram workflow pokazano poniżej.

Diagram workflow domyślnej przykładowej definicji procesu Project Releaser with Publish

Po aktywacji proces publikowania do instancji PLM jako część Project Releaser jest dostępny w Altium Designer z podmenu Project » Project Releaser dla aktywnego projektu lub z menu kontekstowego Project Releaser, dostępnego po kliknięciu prawym przyciskiem myszy wpisu projektu w panelu Projects.

Dostęp do procesu publikowania do instancji PLM jako części Project Releaser

Project Releaser

The Project Releaser pojawi się z dodatkowym etapem – 7. Publish to PLM. Dodatkowo w menu powiązanym z przyciskiem dostępne jest polecenie – Prepare & Release & Publish to PLM – jeśli chcesz uruchomić Project Releaser bez zatrzymywania się w celu przejrzenia wygenerowanych danych i raportu wykonania.

Dodatkowe polecenie do uruchomienia Project Releaser bez zatrzymywania się w celu przejrzenia wygenerowanych danych i raportu wykonania

Jeśli uruchomisz Project Releaser standardowym poleceniem Prepare, po przejrzeniu i wydaniu danych na etapie Execution Report zostanie wyświetlony przycisk . Kliknij go, aby kontynuować bazowy workflow procesu i opublikować do PLM. Pojawi się okno dialogowe Login Credentials. Wprowadź Username i Password dla swojej instancji PLM oraz wybierz szablon PLM, którego chcesz użyć (wyświetlany w postaci <PLMInstance>:<PublishingTemplate>).

Jeśli wybierzesz polecenie Prepare & Release & Publish to PLM, ostatecznie zostanie wyświetlone bezpośrednio okno dialogowe Login Credentials. Project Releaser nie zatrzyma się na etapie Execution Report i nie zostanie pokazany przycisk .

Okno dialogowe Login Credentials dostępne podczas pierwszej publikacji do instancji PLM.

Kliknij kartę Diagram, aby zobaczyć bazowy workflow procesu.

Karta Diagram w oknie dialogowym Login Credentials

Kliknij przycisk , aby kontynuować proces publikowania zgodnie z tym workflow.

Sprawdzaj status procesu publikowania do PLM w interfejsie przeglądarkowym Workspace, w widoku Activities na stronie szczegółowego zarządzania projektem. Strona szczegółowego zarządzania projektem jest otwierana przez wybranie wymaganego projektu na stronie Projects w interfejsie przeglądarkowym Workspace, kliknięcie kontrolki nad listą projektów i wybranie pozycji Open z powiązanego menu. Alternatywnie możesz dwukrotnie kliknąć bezpośrednio wymagany wpis projektu na liście. Strona otworzy się w nowej karcie przeglądarki. Zawsze będziesz mieć możliwość sprawdzenia, co dokładnie zostało utworzone, np. numery części w instancji PLM, w ramach historii workflow procesu (karta History).