Working with Items

W połączonym Workspace każda jednostka projektowa, którą można przechowywać, zarządzać nią i używać ponownie, jest reprezentowana jako określony typ elementu Item. Aby umożliwić aktualizowanie Item w czasie, w Workspace faktycznie przechowywana jest seria rewizji Item (Item Revisions) — są to konkretne rewizje danego Item, których nazwa opiera się na wybranym schemacie nazewnictwa rewizji (Revision Naming Scheme). Każdy nowy Item jest tworzony w folderze, a po zdefiniowaniu wymaganych folderów w Workspace można tworzyć nowe Items w wybranym folderze w obszarze Item panelu Explorer.

Obsługiwane typy zawartości

Różne Items są używane do przechowywania i reprezentowania różnych typów danych. Jeden Item może reprezentować symbol schematu, inny model komponentu PCB, a jeszcze inny może zawierać wygenerowane dane produkcyjne z wydanego projektu płytki. Aby określić typ zawartości, jaki 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 zawiera listę różnych typów zawartości (typów Item), które użytkownik może utworzyć ręcznie w połączonym Workspace, wraz z ich:

• Associated Folder Type – dedykowanym typem folderu, jeśli jest dostępny, w którym można przechowywać zawartość tego typu. Nie ma to wpływu na zawartość folderu. Zapewnia jedynie wizualną „wskazówkę” dotyczącą tego, 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 identyfikatora do utworzonego Item tego typu zawartości, gdy schemat nazewnictwa Item folderu nadrzędnego używa wpisu $CONTENT_TYPE_CODE.

• Folder Type Code – kodem używanym podczas przypisywania unikalnego identyfikatora do utworzonego Item tego typu zawartości, gdy schemat nazewnictwa Item folderu nadrzędnego używa wpisu $FOLDER_TYPE_CODE.

Rewizje Item

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

Pełny identyfikator 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 — zależnie od tego, ile razy dane tego Item zostały zapisane/przesłane/wydane. Ważną kwestią jest to, że do określonego Item-Revision można wydać dane tylko raz. Jeśli nastąpi zmiana, trzeba utworzyć nowy Item-Revision. Zapewnia to najwyższą integralność, ponieważ danych zawartych w danej rewizji nigdy nie można nadpisać przez ponowne wydanie do tej samej rewizji. Aby wydać ponownie, należy użyć nowego Item-Revision.

Najprostszym sposobem na zrozumienie pojęcia Itemu i jego rewizji jest wyobrażenie sobie „pudełka”, w którym przechowywane są wszystkie dane dla danej rewizji danego Itemu. Gdy Item zostaje zwolniony, dane trafiają do pudełka, a pudełko zostaje zamknięte. Item ID i Revision ID stają się etykietami na boku tego pudełka — pozwalają od razu rozpoznać, do czego służy jego zawartość. Jeśli dane trzeba zaktualizować i ponownie zwolnić, Revision ID zostaje zwiększony, co powoduje utworzenie nowego pudełka.

„Pudełko” Item-Revision — oznaczone etykietami Item ID i Revision ID. Zawartość stanowią dane wymagane do zbudowania lub reprezentowania tej rewizji danego Itemu. Czynność zwolnienia zamyka pudełko, uniemożliwiając w przyszłości zwolnienie jakichkolwiek innych danych do tej rewizji. Pełny Item-Revision ID w tym przypadku miałby postać: D-820-1001-01.A.1.

Format ID rewizji jest określany przez Revision Naming Scheme zastosowany dla nadrzędnego Itemu. Konkretny format używany w schemacie jest konfigurowalny i zależy od potrzeb danej organizacji.

Notatki zmian stanu i notatki wydania

W celu usprawnienia ścieżki audytu zawartości w Workspace, Altium Designer umożliwia wprowadzanie notatek podczas zmiany stanu cyklu życia Item-Revision oraz, dla wielu typów zawartości, podczas zwalniania danych źródłowych do planowanych rewizji w Workspace.

Notatki zmian stanu

Podczas zmiany stanu cyklu życia dla Item-Revision w Workspace użyj obszaru State change note w kolejnym oknie dialogowym zmiany stanu, aby wprowadzić odpowiednią notatkę dla tej zmiany.

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

Notatki wydania

Podczas zwalniania danych źródłowych do nowej planowanej rewizji Itemu w Workspace użyj obszaru Release notes w kolejnym oknie dialogowym Create Revision, aby wprowadzić odpowiednią notatkę dla tego wydania. Ta funkcja jest dostępna podczas ponownego zwalniania dowolnego typu Itemu, który obsługuje paradygmat Direct Editing.

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

Wyświetlanie notatek powiązanych z rewizjami Itemu

Notatki dodane do dowolnej rewizji Itemu 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 się na kartę widoku aspektu Lifecycle dla wybranego Item-Revision. Dla każdego stanu w cyklu życia rewizji odpowiednia notatka (jeśli została dodana) jest widoczna w graficznej prezentacji cyklu życia rewizji. Dodatkowo można wyświetlić powiązaną notatkę wydania oraz notatkę ostatniej zmiany stanu rewizji w kolumnie Note w głównym obszarze Item panelu (może być konieczne włączenie wyświetlania tej kolumny).

Wyświetlanie notatek powiązanych z rewizjami komponentu.

Ogólne polecenia Itemu

Oprócz opcji widoku obszar opcji panelu Explorer zawiera również przycisk polecenia Add <item>, który odnosi się do aktualnie wybranego typu folderu.

To polecenie powoduje utworzenie nowego elementu Workspace wybranego typu. Gdy w panelu wybrany jest na przykład typ folderu komponentów, dostępny jest przycisk . Spowoduje to otwarcie nowo utworzonego komponentu tego typu w Component Editor. Podobnie przycisk jest wyświetlany po wybraniu folderu typu Output Job itd. Przycisk pojawi się po wyszukaniu 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 Itemów Workspace w projekcie PCB w Altium Designer zostało usprawnione dzięki możliwości przeciągania i upuszczania rewizji tych typów Itemów bezpośrednio z panelu Explorer na aktywny (i odpowiedni) dokument. Obsługiwane jest przeciąganie:

• Rewizji Component Item na aktywny dokument schematu (lub dokument PCB). Odpowiedni model dla wybranej domeny pojawi się odpowiednio „przyklejony” do kursora.
• Rewizji Managed Schematic Sheet Item na aktywny dokument schematu. Symbol arkusza odwołujący się do tego arkusza będzie podążał za kursorem.
• Rewizji 3D Model Item na dokument PCB lub PCB Library, tworząc obiekt 3D Body, który odwołuje się do tej rewizji Itemu.

Przeglądaj Workspace, aby znaleźć wymagany Item do umieszczenia. Umieszczanie dotyczy konkretnej rewizji tego Itemu, dlatego pamiętaj, aby rozwinąć główny wpis Itemu, by wyświetlić listę wszystkich dostępnych rewizji (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 projektu.

Ponadto Altium Designer umożliwia dostęp do komponentów z panelu Components panel oraz ich umieszczanie.

Pobieranie danych zawartości

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

Typ zawartości Binary File

Altium Designer, we współpracy z podłączonym Workspace, umożliwia przechowywanie dowolnych plików w specjalnym typie zawartości — Itemie Binary File. Takie Itemy można tworzyć w celu przechowywania jednego lub większej liczby 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, razem w jednej jednostce. Aby usprawnić przepływ plików danych, udostępniono dwukierunkową funkcję przeciągania i upuszczania, która umożliwia szybkie przenoszenie plików między folderami w Workspace a folderami w Eksploratorze Windows.

• Utwórz Item typu zawartości Binary File w Workspace. Nową rewizję Binary File Item można utworzyć przez przesłanie odpowiednich plików. Można to zrobić na kilka sposobów — więcej informacji znajdziesz w  Przesyłanie danych do nowej rewizji Itemu.
• Jeśli chcesz zmienić plik lub pliki przechowywane w Binary File Item, prześlij wymagane nowe pliki do tego Itemu — nowe pliki zostaną zapisane w kolejnej rewizji tego Itemu.
• Aby otworzyć plik przechowywany w rewizji Binary File Item, wybierz ten plik — na karcie widoku aspektu Details dla rewizji — a 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, jeśli będzie 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. Odbywa 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. Dlatego musisz 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 połączonego Workspace, możesz wyszukać plik binarny, a wpis w preferencjach zostanie odpowiednio uzupełniony.

Pomyślne użycie pliku OutputJob jako domyślnego nowego dokumentu za pośrednictwem pliku binarnego, który go zawiera.