Working with Items

W ramach połączonego Workspace każda encja projektowa, którą można przechowywać, zarządzać nią i ponownie wykorzystywać, jest reprezentowana jako określony typ Item. Aby umożliwić aktualizowanie Item w czasie, w Workspace faktycznie przechowywana jest seria Item Revisions — konkretnych rewizji danego Item, których nazwa jest oparta na wybranym Revision Naming Scheme. Każdy nowy Item jest tworzony w folderze i po zdefiniowaniu wymaganych folderów w Workspace możesz tworzyć nowe Items w wybranym folderze w obszarze Item w panelu Explorer.

Obsługiwane typy zawartości

Różne Items służą do przechowywania i reprezentowania różnych typów danych. Jeden Item może reprezentować symbol schematowy, inny model komponentu PCB, a jeszcze inny może zawierać wygenerowane dane produkcyjne z wydanego projektu płytki. Aby zadeklarować typ zawartości, którą dany Item (a właściwie jego rewizje) będzie przechowywać, podczas tworzenia lub edycji tego Item należy określić jego właściwość Content Type. Innymi słowy, w istocie określasz Item Type.

Poniższa tabela przedstawia różne typy zawartości (typy Item), które użytkownik może tworzyć ręcznie w połączonym Workspace, wraz z:

• Associated Folder Type – dedykowanym typem folderu (jeśli dostępny), w którym można przechowywać zawartość tego typu. Nie ma to wpływu na zawartość folderu. Zapewnia jedynie wizualną „podpowiedź”, co jest przechowywane w folderze, i może być pomocne podczas przeglądania Workspace w poszukiwaniu określonej zawartości. Zawartość może być przechowywana w dowolnym typie folderu, w tym w Generic Folder.

• Content Type Code – kodem używanym podczas przypisywania unikalnego ID do utworzonego Item tego typu zawartości, a Item Naming Scheme folderu nadrzędnego używa wpisu $CONTENT_TYPE_CODE.

• Folder Type Code – kodem używanym podczas przypisywania unikalnego ID do utworzonego Item tego typu zawartości, a Item Naming Scheme folderu nadrzędnego używa wpisu $FOLDER_TYPE_CODE.

Item Revisions

Item może mieć dowolną liczbę rewizji, które są w istocie ewolucją tego Item w czasie. Wprowadzana jest zmiana, a nowa zawartość danych jest zapisywana/wysyłana (upload)/wydawana (release) do nowej rewizji, co zapewnia, że żadna istniejąca rewizja nigdy nie może zostać nadpisana, a tym samym gwarantuje najwyższą integralność. Dane przechowywane w każdej rewizji Item są więc zazwyczaj różne. Aby rozróżniać te różne rewizje Item, używany jest identyfikator rewizji (ID), który w połączeniu z Item ID tworzy unikalny identyfikator dla każdego wydania Item. Daje nam to Item-Revision.

Pełny Item-Revision ID po prostu identyfikuje konkretną rewizję nadrzędnego Item. Zawsze będzie istniała co najmniej jedna rewizja Item (pierwsze wydanie), ale może ich być wiele — w zależności od tego, ile razy dane dla tego Item zostały zapisane/wysłane (upload)/wydane (release). Ważna uwaga: do konkretnego Item-Revision można wykonać release tylko raz. Jeśli nastąpi zmiana, należy utworzyć nowe Item-Revision. Zapewnia to najwyższą integralność, ponieważ dane zawarte w danej rewizji nigdy nie mogą zostać nadpisane przez ponowne wydanie do tej samej rewizji. Aby wydać ponownie, trzeba użyć nowego Item-Revision.

Najprostszym sposobem zrozumienia koncepcji Item i jego rewizji jest wyobrażenie sobie „pudełka”, do którego trafiają wszystkie dane dla tej konkretnej rewizji tego konkretnego Item. Gdy Item zostaje wydany (release), dane są wkładane do pudełka, a pudełko zostaje zamknięte. Item ID i Revision ID stają się etykietami na boku pudełka — pozwalają natychmiast rozpoznać, do czego służy zawartość pudełka. Jeśli dane trzeba zaktualizować i wydać ponownie, Revision ID jest zwiększany, tworząc nowe pudełko.

„Pudełko” Item-Revision — oznaczone Item ID i Revision ID. Zawartością są dane wymagane do zbudowania lub reprezentowania tej rewizji danego Item. Czynność wydania (release) zamyka pudełko, uniemożliwiając wydanie jakichkolwiek innych danych do tej rewizji w przyszłości. Pełny Item-Revision ID w tym przypadku wynosiłby: D-820-1001-01.A.1.

Format ID rewizji jest określany przez Revision Naming Scheme zastosowany dla nadrzędnego Item. Konkretny format używany w schemacie jest konfigurowalny i będzie zależał od potrzeb każdej organizacji.

Zmiana stanu i notatki do wydania

Usprawniając ścieżkę audytu dla zawartości w Workspace, Altium Designer umożliwia wprowadzanie notatek podczas zmiany stanu cyklu życia rewizji elementu (Item-Revision) oraz – dla wielu typów zawartości – podczas wydawania danych źródłowych do planowanych rewizji w Workspace.

Notatki do zmiany stanu

Podczas zmiany stanu cyklu życia rewizji elementu (Item-Revision) w Workspace użyj obszaru State change note w wyświetlonym oknie dialogowym zmiany stanu, aby wprowadzić odpowiednią notatkę dotyczącą tej zmiany.

Dodawanie notatki wyjaśniającej zmianę stanu cyklu życia rewizji elementu (Item-Revision).

Notatki wydania

Podczas wydawania danych źródłowych do nowej planowanej rewizji elementu w Workspace użyj obszaru Release notes w wyświetlonym oknie dialogowym Create Revision, aby wprowadzić odpowiednią notatkę do tego wydania. Ta funkcja jest dostępna przy ponownym wydawaniu dowolnego typu elementu, który obsługuje paradygmat Direct Editing.

Przykład dodania notatki wydania podczas ponownego wydania stackupu warstw do docelowego Workspace.

Wyświetlanie notatek powiązanych z rewizjami elementu

Notatki dodane dla dowolnej rewizji elementu można wyświetlić w następujących miejscach:

• Detailed Item view – wyświetl powiązaną notatkę wydania oraz notatki zmian stanu rewizji w kolumnie Note w obszarze Timeline. Dla każdego stanu w cyklu życia rewizji odpowiednia notatka (jeśli została dodana) jest również widoczna w graficznym widoku cyklu życia rewizji.
• Explorer panel – przełącz na kartę widoku aspektu Lifecycle dla wybranej rewizji elementu (Item-Revision). Dla każdego stanu w cyklu życia rewizji odpowiednia notatka (jeśli została dodana) jest widoczna w graficznym przedstawieniu cyklu życia rewizji. Dodatkowo w kolumnie Note, w głównym obszarze Item panelu, można wyświetlić powiązaną notatkę wydania oraz notatkę dla ostatniej zmiany stanu rewizji (może być konieczne włączenie wyświetlania tej kolumny).

Wyświetlanie notatek powiązanych z rewizjami komponentu.

Ogólne polecenia elementów

Oprócz opcji widoku, obszar opcji panelu Explorer zawiera także przycisk polecenia Add <item>, który dotyczy aktualnie wybranego typu folderu.

To polecenie uruchamia tworzenie nowego elementu Workspace wybranego typu. Na przykład, gdy w panelu zostanie wybrany typ folderu komponentów, dostępny jest przycisk . Spowoduje to otwarcie nowo utworzonego komponentu tego typu w Component Editor. Podobnie przycisk jest wyświetlany, gdy wybrano folder typu Output Job, itd. Przycisk działa po wyszukiwaniu komponentu wprowadzonym w polu ścieżki komponentu u góry panelu, co tworzy aktywność Part Request odnoszącą się do komponentu wybranego w wynikach wyszukiwania.

Umieszczanie metodą przeciągnij i upuść

Umieszczanie niektórych elementów Workspace w projekcie PCB w Altium Designer jest uproszczone dzięki możliwości przeciągania i upuszczania rewizji tych typów elementów na aktywny (i właściwy) dokument bezpośrednio z panelu Explorer. Obsługiwane jest przeciąganie:

• Rewizji Component Item na aktywny dokument schematu (lub dokument PCB). Odpowiedni model dla wybranej dziedziny pojawi się jako obiekt „pływający” pod kursorem.
• Rewizji Managed Schematic Sheet Item na aktywny dokument schematu. Symbol arkusza odwołujący się do tego arkusza będzie „pływał” przyczepiony do kursora.
• Rewizji 3D Model Item na dokument PCB lub PCB Library, tworząc obiekt 3D Body odwołujący się do tej rewizji elementu.

Przeglądaj Workspace, aby znaleźć element do umieszczenia. Umieszczanie dotyczy konkretnej rewizji elementu, więc pamiętaj, aby rozwinąć główny wpis elementu i wyświetlić wszystkie dostępne rewizje (kliknij przycisk w prawym górnym rogu panelu i wyłącz opcję Show only latest, aby zobaczyć wszystkie wcześniejsze rewizje). Następnie kliknij wymaganą rewizję i przeciągnij jej instancję na dokument projektowy.

Ponadto Altium Designer obsługuje dostęp do komponentów oraz ich umieszczanie z panelu Components panel.

Pobieranie danych zawartości

Pobierz dane przechowywane w rewizji elementu, klikając prawym przyciskiem myszy tę rewizję i wybierając polecenie Operations » Download z menu kontekstowego. Powiązane dane zostaną pobrane do podfolderu w wybranym katalogu, nazwanego identyfikatorem rewizji elementu (Item Revision ID). Pliki można znaleźć w znajdującym się w nim folderze Released.

Typ zawartości pliku binarnego

Altium Designer, we współpracy z podłączonym Workspace, umożliwia przechowywanie dowolnych plików w specjalnym typie zawartości – Binary File Item. Takie elementy można tworzyć, aby pomieścić jeden lub więcej plików w dowolnym formacie. Pozwala to skutecznie wykorzystać bezpieczny charakter Workspace i podkreśla, że Workspace jest idealnym miejscem do przechowywania wszystkiego, w tym źródłowych plików binarnych zebranych w jednej encji. Aby ułatwić płynny przepływ plików danych, udostępniono dwukierunkową funkcję przeciągnij i upuść, umożliwiającą szybkie przenoszenie plików między folderami w Workspace a folderami w Eksploratorze Windows.

• Utwórz element typu zawartości Binary File w Workspace. Nową rewizję elementu Binary File można utworzyć, przesyłając odpowiedni(e) plik(i). Można to wykonać na kilka sposobów – więcej informacji znajdziesz w Uploading Data into a New Revision of an Item.
• Jeśli musisz zmienić plik(i) przechowywane w elemencie Binary File, prześlij do tego elementu wymagane nowe plik(i) – nowe plik(i) zostaną zapisane w kolejnej rewizji tego elementu.
• Aby otworzyć plik przechowywany w rewizji elementu Binary File, wybierz ten plik – na karcie widoku aspektu Details dla rewizji – następnie kliknij prawym przyciskiem myszy i wybierz polecenie Open z menu kontekstowego. Odpowiednia aplikacja (lub sam Altium Designer) zostanie użyta do wyświetlenia pliku, o ile jest to możliwe.

Używanie pliku binarnego z preferencjami szablonów

W ramach preferencji Altium Designer możesz zdefiniować domyślne dokumenty szablonów używane podczas tworzenia nowego dokumentu określonego typu. Wykonuje się to na karcie Defaults strony Data Management – Templates page w oknie dialogowym Preferences. Domyślny dokument szablonu może być oparty na pliku lub pochodzić z podłączonego Workspace.

Dla niektórych typów dokumentów (ActiveBOM Document, Out Job File, Multi-board Schematic i Multi-board Assembly) domyślny dokument szablonu oparty na Workspace może pochodzić wyłącznie z pliku binarnego. Musisz więc przesłać wymagany dokument szablonu do rewizji pliku binarnego, a następnie użyć go jako domyślnego dla nowego dokumentu.

Prześlij potrzebny dokument (na przykład plik OutputJob) do początkowej rewizji nowego pliku binarnego.

Teraz, gdy spróbujesz zdefiniować nowy domyślny dokument z podłączonego Workspace, możesz przeglądać w poszukiwaniu pliku binarnego, a wpis w preferencjach zostanie odpowiednio uzupełniony.

Pomyślne użycie OutputJob jako nowego domyślnego dokumentu poprzez plik binarny, który go zawiera.