Funkcja Data Acquisition w Workspace zapewnia usprawnione narzędzie, które pozwala w praktyce kopiować dane pomiędzy dwoma Workspace’ami (zobacz informacje o zgodności). Narzędziem, za pomocą którego jest to realizowane – czyli Twoim interfejsem do usługi Data Acquisition Service – jest Content Cart. To centrum sterowania służące do zdefiniowania, co ma zostać pobrane ze źródłowego Workspace i przeniesione do wskazanego docelowego Workspace – niezawodna furgonetka przeprowadzkowa, która „przewozi” wybrane dane pomiędzy istniejącymi „adresami” Workspace.
Nie ma lepszego sposobu na zilustrowanie działania funkcji niż przykład. Dlatego, aby pokazać szczegóły działania Content Cart oraz jego użycie do pozyskiwania danych, w tym artykule przyjrzymy się pozyskaniu wybranych komponentów pomiędzy następującymi Workspace’ami:
-
Source Server – Workspace o nazwie
Company Workspace.
-
Target Server – drugi Workspace o nazwie
Secondary Company Workspace.
Uzyskiwanie dostępu do Cart
Dostęp do okna dialogowego Content Cart uzyskuje się z poziomu panelu Explorer. Podczas przeglądania źródłowego Workspace, z którego chcesz pobrać dane, kliknij prawym przyciskiem myszy rewizję elementu (Item Revision), którą chcesz pozyskać, i wybierz polecenie Operations » Add to Content Cart z menu kontekstowego. Możesz dodać jedną lub więcej zaznaczonych rewizji elementów, a nawet folder elementów. Pierwsze otwarcie Cart ładuje do niego rewizję(e) elementu(ów) zaznaczone w źródłowym Workspace w momencie otwarcia:
-
Pojedyncza, konkretna rewizja elementu.
-
Wiele konkretnych rewizji tego samego elementu.
-
Najnowsze rewizje wielu elementów.
-
Najnowsze rewizje wszystkich elementów w wybranym folderze (oraz w jego strukturze podrzędnej). Pozwala to załadować do Cart cały folder z zachowaniem jego struktury. Aby pozyskać folder (wraz z jego strukturą podrzędną), zaznacz go w obszarze Server Folders źródłowego Workspace (w panelu Explorer ), następnie kliknij prawym przyciskiem myszy i wybierz polecenie Operations » Add to Content Cart z menu kontekstowego.
Zaznaczenie wpisu najwyższego poziomu dla elementu spowoduje załadowanie do Cart najnowszej rewizji tego elementu.
Do Content Cart można też uzyskać dostęp z różnych widoków aspektów w panelu Explorer , w tym z widoków aspektów Where-used oraz Children. Dostęp jest również możliwy z okna Search Results.
Przykład uzyskania dostępu do Content Cart.
Items That Can Be Acquired
Następujące typy elementów (Item) można pozyskać ze źródłowego Workspace do docelowego Workspace przy użyciu funkcji Data Acquisition:
-
Model 3D
-
Preferencje Altium Designer
-
Komponent (w tym powiązane Part Choices)
-
Szablon komponentu
-
Datasheet
-
Footprint
-
Managed Schematic Sheet
-
Outputjob
-
Szablon schematu
-
Skrypt
-
Model symulacyjny
-
Symbol
Ponadto, podczas pozyskiwania folderu elementów ze źródłowego Workspace obsługiwane są następujące typy folderów:
-
Components
-
Generic Folder
Acquisition Considerations
Rzeczy, które należy wziąć pod uwagę podczas pozyskiwania danych:
Zwróć uwagę, że parametr Component Type nie jest przenoszony podczas procesu pozyskiwania, więc przeniesione komponenty będą widoczne w lokalizacji Uncategorized w docelowym środowisku zarówno w panelu Components panel w Altium Designer, jak i na stronie Components page w Workspace. Możesz zastosować żądany Component Type do pojedynczego lub wielu wpisów komponentów, używając operacji Change Component Type operation w panelu Explorer w Altium Designer.
-
Managed Schematic Sheet Item – odpowiednie rewizje następujących powiązanych obiektów podrzędnych: Component Item(s), Symbol Item(s), Footprint Item(s), 3D Model Item(s), Simulation Model Item(s), Component Template Item(s), Datasheet Item(s), Schematic Template Item.
-
Cykl życia pozyskanej rewizji elementu źródłowego przyjmie początkowy stan „po wydaniu” (post-release), zgodnie z przypisaną definicją cyklu życia dla elementu docelowego. Jakakolwiek historia cyklu życia rewizji elementu źródłowego zostanie po prostu zignorowana.
-
Jeśli element podrzędny wybranego elementu Component/Managed Schematic Sheet nie może – z jakiegokolwiek powodu – zostać pozyskany, wówczas pozyskiwanie tego wybranego elementu Component/Managed Schematic Sheet nie zostanie przeprowadzone.
Rewizja elementu podrzędnego używana przez wiele elementów nadrzędnych – na przykład współdzielony Symbol Item lub Footprint Item – jest pozyskiwana tylko raz, a nie dla każdej pozyskiwanej rewizji elementu nadrzędnego.
Acquiring Data Process - Summary
Użyj Content Cart, aby pozyskać całą potrzebną zawartość danych. Proces pozyskiwania elementów danych ze źródłowego serwera jest prosty i można go podsumować w następujących krokach:
-
Serwer źródłowy jest automatycznie określany jako aktualnie aktywny serwer, ale można go zmienić na inny połączony serwer z menu wyboru dostępnego w lewym górnym rogu panelu Explorer.
-
Użyj listy rozwijanej nazwy serwera docelowego w Content Cart (podświetlonej na niebiesko), aby wybrać alternatywny serwer docelowy z listy, która jest wypełniana aktualnie połączonymi serwerami – wybierz opcję Server Administration, aby włączyć/wyłączyć połączenia z serwerami. Dla komponentów cel może być również wskazany jako plik Integrated Library (IntLib) zapisany lokalnie.
-
Oryginalna rewizja elementu jest wyświetlana w głównej siatce. Do Cart można dodać dowolną liczbę dodatkowych rewizji elementów. Aby to zrobić, kliknij kontrolkę Add More Items w prawym górnym rogu okna dialogowego i wybierz pozycję Select, aby otworzyć okno dialogowe Choose Item (odmiana panelu Explorer). Stąd możesz przeglądać serwer źródłowy w poszukiwaniu kolejnych elementów, dodając je pojedynczo lub wsadowo, korzystając ze standardowych narzędzi wielokrotnego zaznaczania. Alternatywnie wybierz pozycję Add manually, aby otworzyć okno Add new items dialog. To okno umożliwia wklejenie zewnętrznej listy wymaganych elementów (jeden element na linię), które następnie mogą zostać wyszukane na serwerze źródłowym według wybranego kryterium wyszukiwania (GUID, Item ID, Name lub MPN). Zaznacz i usuń rewizje elementów z listy (kliknij przycisk 
), jeśli zdecydujesz, że jednak nie mają zostać pozyskane.
-
Kliknij kontrolkę Change Settings w prawym dolnym rogu okna dialogowego Content Cart, aby otworzyć okno Content Cart Structure dialog. Tutaj możesz zdefiniować domyślne opcje dla każdego z typów elementów danych obsługiwanych przez funkcję pozyskiwania. Obejmuje to wskazanie domyślnego folderu na serwerze docelowym, a także domyślnej definicji cyklu życia (Lifecycle Definition), schematów nazewnictwa elementów i rewizji oraz indeksu początkowego. Masz też możliwość dodania notatki, która może dostarczyć innym przydatnych informacji o pozyskaniu podczas przeglądania pozyskanej zawartości.
-
Po wybraniu żądanych elementów źródłowych kliknij przycisk 
. Spowoduje to przygotowanie serwera docelowego do pozyskania: sprawdzenie statusu wybranych rewizji elementów (na wypadek, gdyby zostały już wcześniej pozyskane), powiązań nadrzędny–podrzędny oraz zaproponowanie wymaganej akcji, która dla nowych pozyskań będzie Transfer new revision and item. Podczas tej fazy przygotowania stosowane są wcześniej określone domyślne opcje pozyskiwania, jednak właściwości proponowanych elementów docelowych można modyfikować indywidualnie – w razie potrzeby. Aby to zrobić, zaznacz element na liście i kliknij przycisk 
.
-
Po zakończeniu przygotowania kliknięcie przycisku 
spowoduje rozpoczęcie pozyskiwania. Pojawi się początkowe okno potwierdzenia – kliknij Yes, aby kontynuować transfer zawartości pomiędzy serwerami źródłowym i docelowym. Drugie okno potwierdzenia potwierdzi wynik pozyskania – przeglądaj pozyskane elementy na serwerze docelowym w panelu Explorer.
Użyj opcji w oknie dialogowym Content Cart Structure, aby zmodyfikować domyślne ustawienia pozyskiwania zgodnie ze schematami stosowanymi (i preferowanymi!) dla tych typów elementów na serwerze docelowym. Domyślnie ustawienia te są zdefiniowane tak, aby pozyskiwać każdy typ elementu do osobnego folderu pod folderem głównym, określanym nazwą Content Cart. Domyślna nazwa ma format Content Cart – <Current Date> – <Current Time> i jest odzwierciedlona w oknie dialogowym Content Cart.
Można ją zmienić na bardziej znaczącą nazwę, jeśli jest to wymagane. Alternatywnie możesz wybrać folder na serwerze docelowym, do którego ma zostać dostarczona zawartość z Cart. Może to być folder istniejący lub całkowicie nowy, utworzony „w locie”. Ustawienia pozyskiwania w oknie dialogowym Content Cart Structure są domyślnymi ustawieniami na poziomie ogólnym – w razie potrzeby można zdefiniować właściwości na poziomie pojedynczego elementu, uzyskując bardziej szczegółową kontrolę.
Jeśli rewizja elementu została już pozyskana, a element źródłowy nie został ponownie wydany (re-released) od czasu tego pozyskania, jego
Status zostanie
Already Exists, aby to odzwierciedlić. Ponieważ nie ma żadnej akcji do wykonania, pole
Action będzie wyświetlane jako
Nothing to do. Zwróć uwagę, że rewizje elementów w
Trash są wykrywane jako pozyskane (
Already Exist).
Pozyskane punkty danych z powrotem do ich pierwotnego źródła. Te informacje o powiązaniu „przodka” można zobaczyć, zmieniając kartę widoku aspektu dla docelowej rewizji elementu na jej kartę widoku aspektu Origin.
Określanie źródłowych i docelowych Workspace’ów
Dwa Workspace’y biorące udział w pozyskaniu danych są wskazywane w górnej części okna dialogowego Content Cart. Źródłowy Workspace jest określany automatycznie na podstawie miejsca przechowywania rewizji elementu (Item Revision/Item Revision(s)), które wskazałeś do pozyskania — zazwyczaj jest to Workspace, do którego jesteś aktualnie zalogowany (Company Workspace w tym przykładzie). Jeśli masz połączenie z wieloma Workspace’ami, kliknij nazwę docelowego Workspace’a albo kontrolkę 
po jej prawej stronie, aby otworzyć listę rozwijaną aktualnie podłączonych Workspace’ów. Przełącz Workspace’y zgodnie z potrzebą.
-
Chociaż możesz być połączony z więcej niż jednym Workspace’em, pamiętaj, że w danym momencie możesz być zalogowany tylko do jednego Workspace’a — będzie to Twój Active Server.
-
Menu rozwijane powiązane z docelowym Workspace’em zapewnia także szybki dostęp do strony Data Management – Servers page w oknie dialogowym Preferences, poprzez pozycję Server Administration. Może to być przydatne, jeśli nie połączyłeś się jeszcze / nie zalogowałeś do zamierzonego docelowego Workspace’a.
Określenie źródłowego i docelowego Workspace’a biorących udział w pozyskaniu danych.
Nadawanie nazwy koszykowi
Pozyskane dane ze źródłowego Workspace’a zostaną skopiowane do nowych rewizji elementów w docelowym Workspace’ie. Domyślnie elementy te będą umieszczone w zdefiniowanej i nowo utworzonej strukturze folderów w docelowym Workspace’ie. Folder najwyższego poziomu dla tej pozyskanej zawartości jest nazywany na podstawie nazwy samego koszyka. Domyślna nazwa ma format Content Cart - <Current Date> - <Current Time> i jest ustalana w momencie uzyskania dostępu do koszyka. Można ją zmienić na bardziej znaczącą, klikając kontrolkę Change po prawej stronie nazwy koszyka.
Użyj kolejnego okna dialogowego Content Cart Name Selection, aby bezpośrednio wprowadzić preferowaną nazwę koszyka. Alternatywnie możesz wybrać folder w docelowym Workspace’ie, do którego ma zostać dostarczona zawartość z koszyka. Może to być folder istniejący albo zupełnie nowy, utworzony „w locie”. Przejdź do istniejącego folderu i wybierz go dla koszyka, korzystając z okna dialogowego Choose Folder — dostępnego po kliknięciu przycisku 
po skrajnej prawej stronie pola Content Cart Name. Albo utwórz nowy folder w strukturze folderów, używając poleceń z menu kontekstowego (prawy przycisk myszy).
Content Cart można nazwać zgodnie z potrzebą. Zmień nazwę koszyka (który zostanie dostarczony do folderu najwyższego poziomu o tej nazwie) albo zdecyduj się zdeponować zawartość koszyka w konkretnym folderze.
Podczas pozyskiwania danych do docelowego Workspace’a można utworzyć dowolną liczbę „folderów” Content Cart, co zapewnia maksymalną elastyczność w zakresie miejsca przechowywania pozyskanej zawartości. Pamiętaj, że niezależnie od tego, gdzie w strukturze folderów docelowego Workspace’a pozyskane dane zostaną początkowo zapisane, możesz swobodnie przenosić elementy i foldery według potrzeb.
Określanie elementów do pozyskania
Główna część okna dialogowego Content Cart prezentuje „siatkę pozyskiwania” (acquisition grid) — listę wszystkich rewizji elementów (Item Revisions), które wybrałeś do pozyskania ze źródłowego Workspace’a. Dowolną liczbę rewizji elementów danych (Data Item Revisions) można „załadować” do Content Cart w celu pozyskania ze źródłowego Workspace’a. Pierwsze wejście do koszyka ładuje do niego rewizje elementów, które były zaznaczone w źródłowym Workspace’ie w momencie uzyskania dostępu, ale można doładować dowolną liczbę dodatkowych elementów. Aby to zrobić, kliknij kontrolkę Add More Items w prawym górnym rogu okna dialogowego i wybierz pozycję Select, aby otworzyć okno dialogowe Choose Item (to „okrojona” wersja panelu Explorer panel). Stąd możesz przeglądać źródłowy Workspace w poszukiwaniu kolejnych elementów. Pamiętaj, że możesz dodać:
-
Pojedynczą, konkretną rewizję elementu.
-
Wiele konkretnych rewizji tego samego elementu.
-
Najnowsze rewizje wielu elementów.
-
Najnowsze rewizje wszystkich elementów w wybranym folderze (i jego strukturze podrzędnej).
Alternatywnie wybierz pozycję Add manually, aby otworzyć okno dialogowe Add new items. To okno pozwala wkleić zewnętrzną listę wymaganych elementów (jeden element na linię), które następnie można wyszukać w źródłowym Workspace’ie, używając wybranego kryterium wyszukiwania (GUID, Item ID, Name lub MPN).
Główna siatka pozyskiwania, zawierająca listę wszystkich rewizji elementów wybranych do pozyskania ze źródłowego Workspace’a.
Dowolną rewizję elementu można usunąć z listy, zaznaczając ją i klikając przycisk
.
Przygotowanie koszyka
Po wybraniu źródłowych rewizji elementów, Content Cart musi zostać „przygotowany do dostarczenia” do docelowego Workspace’a. Aby to zrobić, kliknij przycisk 
. Spowoduje to przygotowanie docelowego Workspace’a do pozyskania — sprawdzenie statusu wybranych rewizji elementów (na wypadek, gdyby były już wcześniej pozyskane), powiązań nadrzędny–podrzędny oraz zaproponowanie działania do wykonania. Wyniki tej fazy przygotowania są prezentowane w głównej siatce pozyskiwania.
Przykładowy Content Cart, przygotowany i gotowy do dostarczenia do docelowego Workspace’a.
Dla każdej rewizji elementu biorącej udział w pozyskaniu, obszar Source siatki rozwija się, aby pokazać wszystkie mające zastosowanie rewizje elementów podrzędnych oraz — opcjonalnie — folder, w którym się znajdują w źródłowym Workspace’ie. Dla każdej rewizji elementu (zarówno nadrzędnej, jak i podrzędnej) w obszarze Target siatki mogą być prezentowane następujące informacje:
Zwróć uwagę, że proces pozyskiwania wykryje również element znajdujący się w docelowym
Workspace Trash, który jest traktowany jako pozyskany i ustawiany na status
Already Exists. Opróżnij Kosz i uruchom proces pozyskiwania ponownie, jeśli chcesz ponownie pozyskać ten element.
Kliknij nagłówek kolumny, aby sortować dane w tej kolumnie rosnąco. Kliknij ponownie, aby sortować malejąco. Przeciągnij nagłówek kolumny, aby zmienić kolejność samych kolumn — prawidłowe miejsca są oznaczane pionowymi strzałkami pozycjonującymi. Kliknij prawym przyciskiem myszy, aby uzyskać dostęp do kontrolek przełączania wyświetlania kolumn danych zarówno w obszarach Source, jak i Target (niektóre z wymienionych powyżej kolumn mogą być domyślnie wyłączone).
Struktura koszyka
W ramach fazy przygotowania koszyk używa ustawień domyślnych zdefiniowanych dla każdego typu elementu, który może zostać pozyskany. Ustawienia te są zdefiniowane w oknie dialogowym Content Cart Structure, do którego można przejść, klikając kontrolkę Change Settings w prawym dolnym rogu okna dialogowego Content Cart.
Domyślne ustawienia pozyskiwania są zdefiniowane w oknie dialogowym Content Cart Structure.
Ustawienia te służą do określenia właściwości nowo utworzonych rewizji elementów w docelowym Workspace’ie — tworzonych jako gotowe i w stanie planowanym (planned), aby przyjąć dane z oryginalnych rewizji elementów w źródłowym Workspace’ie. Obejmują one domyślny folder w docelowym Workspace’ie, a także domyślną definicję cyklu życia, schematy nazewnictwa elementów i rewizji oraz indeks początkowy. Zdefiniowana jest również domyślna notatka w formacie Acquired from <SourceWorkspaceName>.
Jeśli chodzi o foldery docelowe w docelowym Workspace’ie, każdy typ elementu będzie pozyskiwany do odrębnego folderu w ramach:
-
Nadrzędnego folderu najwyższego poziomu, nazwanego od Content Cart
-
Istniejącego folderu, zdefiniowanego poprzez okno dialogowe wyboru nazwy Content Cart Name selection dialog.
Zmień te domyślne ustawienia pozyskiwania tak, aby były zgodne ze schematami stosowanymi (i preferowanymi!) dla tych typów elementów w Twoim docelowym Workspace’ie. Kliknij komórkę, aby uzyskać dostęp do kontrolek edycji.
-
Zwróć uwagę, że Part Choices powiązane z komponentem są automatycznie propagowane do docelowego Workspace’a. Pozycja Part Choice List w oknie dialogowym Content Cart structure dotyczy wyłącznie starszego Altium Vault oraz wcześniejszych wersji Altium Designer.
-
Przywróć ustawienia struktury do wartości domyślnych, klikając przycisk
.
Ustawienia akwizycji w oknie dialogowym Content Cart Structure są domyślnymi ustawieniami na poziomie ogólnym. Dla elementów (Items), które nigdy wcześniej nie były pozyskiwane – czyli gdy nadrzędny Item i początkowa rewizja są tworzone od nowa (Action ma wartość Transfer new revision and item) – w razie potrzeby można zdefiniować właściwości na poziomie pojedynczego Itemu, co zapewnia bardziej szczegółową kontrolę. Aby to zrobić, wybierz rewizję elementu (Item Revision) w głównej siatce akwizycji i kliknij przycisk 
. Uzyskasz dostęp do okna dialogowego Edit Item, w którym możesz modyfikować właściwości Itemu zgodnie z potrzebami – nadpisując ustawienia domyślne.
Aby uzyskać większą kontrolę, możesz definiować właściwości na poziomie pojedynczego Itemu.
Wszelkie zmiany nazwy koszyka, jego domyślnych ustawień struktury lub samych pojedynczych Itemów wymagają ponownego wykonania przygotowania – aby zaktualizować siatkę akwizycji o te zmiany.
Dostarczenie koszyka
Po zakończeniu przygotowania kliknij przycisk 
, aby przejść do akwizycji. Pojawi się okno potwierdzenia informujące, że Content Cart ma zostać przeniesiony z źródłowego do docelowego Workspace – kliknij Yes, aby kontynuować. Drugie okno potwierdzenia potwierdzi wynik akwizycji, a pozyskane Itemy będą dostępne do przeglądania w docelowym Workspace w panelu Explorer.
Jeśli przed zamknięciem okna dialogowego
Content Cart uruchomisz przygotowanie ponownie – klikając
– pola
Status i
Action zaktualizują się, aby odzwierciedlić wynik – wyświetlając odpowiednio
Already Exists i
Nothing to do.
Pozyskane dane wskazują z powrotem na swoje pierwotne źródło. Informacje o tym powiązaniu przodków można zobaczyć, przełączając się na kartę widoku aspektu
Origin dla docelowej rewizji Itemu. Aby szybko przejść do pierwotnej źródłowej rewizji Itemu, kliknij przycisk
.
Pozyskiwanie danych w formacie IntLib
Masz również możliwość pozyskiwania komponentów z Workspace do biblioteki zintegrowanej (*.IntLib). A podczas umieszczania komponentów z takiej biblioteki zintegrowanej rzeczywiste odnośniki prowadzą z powrotem do komponentów w Workspace. Daje to możliwość efektywnego korzystania z komponentów firmowych z Workspace w trybie offline, przy jednoczesnym zapewnieniu, że projekt nadal zachowuje rzeczywiste połączenie z tymi komponentami w źródłowym Workspace.
Akwizycja do IntLib
Z okna dialogowego Content Cart proces pozyskiwania do IntLib wygląda następująco:
-
Kliknij łącze Select target server i wybierz IntLib file z menu.
Ustaw cel Content Cart jako plik IntLib.
-
Określ nazwę i lokalizację dla generowanego pliku IntLib. Domyślnie plik będzie nazwany w formacie Integrated_Library - <Date> - <Time>.IntLib i wygenerowany w lokalizacji \Users\Public\Documents\Altium\AD<Version>\Library\ExportCmpLib. Zmień to w razie potrzeby w oknie dialogowym Save As – dostępnym po kliknięciu łącza Change .
Zaakceptuj domyślny folder docelowy i nazwę pliku lub zmień je według potrzeb.
-
Jeśli musisz pozyskać dodatkowe komponenty do tego samego IntLib, kliknij łącze Add More Items i wybierz pozycję Select, aby otworzyć okno dialogowe Choose Item (wersja „okrojona” panelu Explorer panel). Stąd możesz przeglądać źródłowy Workspace w poszukiwaniu kolejnych Itemów. Alternatywnie wybierz pozycję Add manually, aby otworzyć okno dialogowe Add new items. To okno umożliwia wklejenie zewnętrznej listy wymaganych elementów (jeden element na linię), które następnie można wyszukać w źródłowym Workspace, używając wybranego kryterium wyszukiwania (GUID, Item ID, Name lub MPN).
-
Gdy wszystko jest gotowe, kliknij przycisk , aby rozpocząć generowanie IntLib. Zostanie utworzony tymczasowy pakiet Integrated Library Package (*.LibPkg), do którego zostaną wygenerowane i dodane pliki źródłowe SchLib (z symbolami, parametrami i łączami do modeli) oraz PcbLib (z modelami footprintów). Następnie pakiet zostanie skompilowany w celu utworzenia pliku IntLib, który zostanie wygenerowany w określonym folderze. Okno informacyjne potwierdzi pomyślne wygenerowanie pliku.
Dostarcz koszyk do folderu docelowego, który będzie zawierał wymagany plik biblioteki zintegrowanej.
Użycie IntLib
Po wygenerowaniu IntLib można dodać jako jedną z dostępnych bibliotek nie-Workspace dla oprogramowania (przez kartę Installed w oknie dialogowym Available File-based Libraries dialog). Następnie będzie dostępna do użycia z panelu Components panel. Umieszczaj komponenty z IntLib w projekcie według potrzeb. Mimo że pracujesz z komponentami „offline”, łącza do oryginalnych komponentów w Workspace zapewniają ciągłość, gdy wrócisz do pracy „online” bezpośrednio z Workspace.
Tłumaczenie SI